@wenbin_wb/dsh-bridge 2.11.2 → 2.12.0

package/docs/wechat-usage.md

@@ -1,104 +0,0 @@
-# 微信 Bot 使用说明
-
-> dsh-bridge 的微信 Bot（ClawBot / iLink）让你**直接在微信里**与你的 DeepSeek Harness agent 对话、控制和审批——无需公网、无需隧道，走腾讯官方 iLink Bot API。
-
-扫码登录微信个人号后，发消息就能驱动 agent；`/` 开头的命令管理会话、切换工作区、审批权限。会话与工作区信息跨重启持久化，不会丢。
-
----
-
-## 一、快速开始
-
-1. 打开 DSH 设置页 → 「远程访问」→ 「IM 机器人」标签页 → 选中「微信」平台
-2. 点击「扫码登录」，用微信扫二维码并按提示确认
-3. 登录成功后，**向该微信 Bot 发送第一条消息，自动完成白名单授权**（一步到位）
-4. 之后就可以直接在微信里下命令、发消息了
-
-> 💡 登录后左侧「IM 机器人」标签会出现绿色圆点，表示微信 Bot 已连接。
-
----
-
-## 二、基本对话
-
-直接发送普通文本即可与当前活动的 agent 对话。支持发送**图片 / 文件 / 语音**（语音自动转文字），agent 也能在需要时把文件发回给你。
-
-- 长回复会自动**分多条发送**，并在消息间留出间隔，避免刷屏
-- 任务处理中会周期性发送「[处理中] 第 N 轮 | …」的心跳进度
-
----
-
-## 三、命令一览
-
-| 命令 | 说明 |
-|------|------|
-| *(普通文本)* | 发给当前活动 agent |
-| `/sessions` | 列出所有会话（按**工作区**分组，显示**会话标题**） |
-| `/use N` | 切换到会话 N |
-| `/rename <新标题>` | 重命名当前活动会话 |
-| `/workspaces` | 列出可用工作区 |
-| `/addworkspace <路径>` | 注册添加新的电脑工作区目录 |
-| `/new <提示词>` | 在**当前工作区**新建会话并开始 |
-| `/new <提示词> @N` | 在**编号 N 的工作区**新建会话 |
-| `/new <提示词> @路径` | 在**指定目录**新建会话 |
-| `/rename <新标题>` | 重命名当前活动会话 |
-| `/stop` | 停止当前任务 |
-| `/status` | 查看当前 agent 状态与会话摘要 |
-| `/yes` `/no`（或 `1`/`2`） | 回应权限审批请求 |
-| `/start` | 首次扫码后自动开始一个会话 |
-| `/help` | 查看全部命令 |
-
-### 例子
-
-```
-/new 帮我重构这个项目的路由                  # 默认工作区新建
-/new 继续上周的 ypbin 开发 @2                # 在 2 号工作区新建
-/sessions                                     # 按工作区分组列出所有会话（带标题）
-/use 3                                        # 切到 3 号会话继续聊
-```
-
----
-
-## 四、会话与工作区
-
-### 会话持久化
-
-- 会话数据保存到 DSH 的持久化存储，**重启 DSH 后会话不丢失**，下次直接发消息就能接着上次继续
-- `/sessions` 会按工作区（项目目录）分组展示，并为每个会话显示**标题**（DSH 自动生成），方便区分
-
-### 工作区（项目目录）
-
-- `/workspaces` 列出可用的工作区
-- 新建会话时用 `@N` 或 `@路径` 指定工作区，让 agent 在指定项目目录下工作
-- 不指定则使用默认工作区（当前启动目录）
-
----
-
-## 五、权限审批
-
-当 agent 需要执行敏感操作（改文件、跑命令、调用外部服务等）时，会在微信里给你发送一条审批问询：
-
-```
-[待确认] 1. agent 想要执行某个操作
-请回复 /yes（允许）或 /no（拒绝）
-```
-
-- 回复 `/yes` `/no`，或仅有一条待确认时直接回复 `1` / `2`
-- 默认 **10 分钟**内未回复则**自动拒绝**（可在设置页「高级设置」调整审批超时）
-
----
-
-## 六、安全说明
-
-- **强制白名单**：仅白名单内的微信用户能驱动 agent，其他人发的消息一律忽略、**绝不喂给模型**
-- **审批默认拒绝**：未及时回复的权限请求自动拒绝
-- **凭证加密存储**：经 DSH 凭证服务保存，不落配置明文
-- **建议专用微信号**：iLink 每个账号只允许一个 poller，与 hermes-agent / OpenClaw 并存会互相 403；为避免影响主号，**请用专用微信小号承载 Bot**
-
-> 声明：iLink 为腾讯官方开放通道，仍需遵守《微信 ClawBot 功能使用条款》，腾讯保留内容过滤和限速的权利。不建议用于核心业务。
-
----
-
-## 七、注意事项
-
-- **解绑账号**：设置页微信卡片里点「解绑账号」可清除登录凭证，下次需重新扫码
-- **高级设置**：设置页「高级设置」可调整心跳间隔、审批超时、每气泡字数、分块发送延迟
-- 发送媒体文件时请耐心等待上传/下载，大文件耗时较长