fix

docs/walletman对接文档.md

@@ -1,4 +1,40 @@
-# WalletMan 对接文档索引
+# WalletMan 对接文档
 
-- [后端对接](./walletman后端对接.md) — HTTP / WS / FCM 下发、服务端配置与调试
-- [前端对接](./walletman前端对接.md) — rnwalletman 集成、Android 配置、JS API
+Android 宿主 App 通过 **HTTP + WebSocket + FCM** 连接 walletman 服务端，完成钱包绑定、TCP 代理出网、token 过期静默重绑。
+
+## 文档索引
+
+| 文档 | 读者 | 内容 |
+|------|------|------|
+| [后端对接](./walletman后端对接.md) | 服务端 / 联调 | HTTP / WS / FCM 协议、接口、触发条件 |
+| [前端对接](./walletman前端对接.md) | Android / RN 开发 | rnwalletman 集成、Manifest、JS API、绑钱包 |
+
+## 快速概念
+
+- **clientId**：设备唯一 ID，与 App 侧 `DeviceInfo.getUniqueIdSync()` 一致，用于 WS 注册和 FCM 投递。
+- **walletId**：`{walletType}_{phone}`，如 `paytm_9876543210`。
+- **Token 绑钱包**：魔改 ipay 包 AIDL 读 token → `POST /register`。
+- **OTP 绑钱包**：`POST /request-otp` → `POST /verify-otp`。
+- **FCM 重绑**：服务端检测 inactive → 下发 `rebind_wallet` → 客户端静默 AIDL → `POST /register`；失败再弹本地通知。
+
+## 本地联调
+
+```bash
+# 服务端（默认 :16000）
+cd servers/walletman/cmd/server
+go run . -tls android
+
+# 测试页
+open http://localhost:16000/test/index.html
+```
+
+生产环境通常由 Nginx 反代 HTTP/WS（如 `https://domain/ws`），端口不必暴露 16000。
+
+## 仓库参考
+
+| 路径 | 说明 |
+|------|------|
+| `servers/walletman/` | Go 服务端 |
+| `libs/rnwalletman/` | RN 库（Proxy + Bind 组件） |
+| `android/app/.../RnpayProxyService.java` | rnpay 宿主 registerWallet 示例 |
+| `screens/HomeScreen.tsx` | rnpay Proxy / 绑钱包 / 通知点击示例 |