🤖 BTSBots 智能钱包与去中心化客户端 - 用户使用手册

欢迎使用 BTSBots 生态系统！BTSBots 是基于比特股（BitShares）区块链打造的去中心化交易与智能钱包系统。它采用了零信任架构（Zero-Trust Architecture），兼顾了 Web 端极致流畅的用户体验与冷热分离级的密钥安全保护。

---

🛡️ 一、硬核安全防护机制详解

BTSBots 从架构设计层面彻底解决了传统 Web3 钱包易受钓鱼、私钥泄漏、恶意刷单和误操作等安全隐患：

1. Web 前端无私钥 (Zero-Key Web Architecture)

• 浏览器不接触 WIF 私钥：您的比特股 Active/Owner 物理私钥永远无需输入或存储在浏览器/手机 App 的 LocalStorage 中。
• 本地 WebCrypto 会话签名：Web 端在初始化时通过浏览器原生 window.crypto.subtle API 在 IndexedDB 中生成并锁定一对专用的 ECDSA (P-256) 临时会话公私钥。Web 端提交的所有交易（转账、限价下单、OAuth 授权）仅包含操作意图签名，必须经过您的 btsbots-service 本地守护桌面应用或 Python 客户端审核放行。

2. 桌面级守护中心：btsbots-service 客户端使用指南

btsbots-service 是基于 Tauri + React 19 开发的现代化图形化签名网关：

• 全隔离金库：私钥使用 PBKDF2 + AES-256-GCM 算法在本地高强度加密存储。
• 门禁化登录：未解锁口令前屏蔽一切敏感操作视图；输入口令解锁后自动建立安全 WebSocket 握手并自动开启签名网关。
• 多账号独立风控策略：不同账号拥有独立专属的风控配置文件，支持配置多资产单笔免密额度、交易所必填 Memo 限制以及离群值套利熔断保护。
• 一键生成 8 位登录 OTP：在 btsbots-service 中一键生成 8 位临时代码，在浏览器端输入即可秒级安全免密登录！
• 安全锁屏与 PIN 码：离开电脑时一键锁屏或 5 分钟闲置自动锁定，需输入 4-8 位 PIN 码解锁。

---

🚀 二、Python 客户端极速安装与使用

若您偏好在无图形界面的服务器或命令行运行，可使用 Python 签名守护端：

1. 安装 uv 工具

# Linux / macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionUrl https://astral.sh/uv/install.ps1

2. 克隆项目并初始化依赖

git clone https://github.com/pch957/btsbots.git
cd btsbots

# 使用 uv 一键安装依赖并同步环境
uv sync

3. 配置风控策略 security_rules.json

cp security_rules.json.example security_rules.json

4. 启动 Python 客户端

# 方式 1: 交互式启动
uv run python sign_bots.py

# 方式 2: 搭配 pass 密码管理器一键免密启动
uv run python sign_bots.py --pass bts/my_account

---

📱 三、Web 端与 Mobile App 配合使用指南

1. 8 位 OTP 免私钥快速登录

1. 在 btsbots-service 图形客户端的【⚡ 网页登录 OTP】面板中点击生成，或运行 uv run python get_otp.py --pass bts/my_account。
2. 在网页端登录界面输入您的比特股账号与该 8 位 OTP 即可直接安全登入！

2. 扫码支付与协议跳转

• 转账协议：btsbots://transfer?to=receiver&asset=BTS&amount=100&memo=inv_001
• OAuth 授权：btsbots://oauth?client_id=merchant&token=xxx&site=example.com&ip=1.2.3.4