# 微信 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 功能使用条款》，腾讯保留内容过滤和限速的权利。不建议用于核心业务。

---

## 七、注意事项

- **解绑账号**：设置页微信卡片里点「解绑账号」可清除登录凭证，下次需重新扫码
- **高级设置**：设置页「高级设置」可调整心跳间隔、审批超时、每气泡字数、分块发送延迟
- 发送媒体文件时请耐心等待上传/下载，大文件耗时较长