文档
接入与可选能力
选择 IM 接入和电脑、浏览器目标，了解版本、安装要求与权限范围。
先核对版本： npm 正式版当前为 deepseekbot v1.4.1（2026-10-20 发布），包含 Core、Client、Browser（@botharness/browser）、Computer（@botharness/computer）和已验证的 IM Provider 4.32.0-botharness.21（推荐 DSH 0.2.1-rc.2，也已验证 0.2.0-rc.2，声明安装范围 >=0.2.0-rc.2 <0.3.0-0）。下表列出可接入的平台；QQ 的实测版本范围见表后说明，用于标明真实群聊验收时的历史构建，不代表每个旧版本都有相同入口。
连接自己的 IM 身份
支持 QQ、飞书 / Lark、Slack、Discord 和个人微信。先在本地私聊确认 Bot 能使用模型回复，再连接应用；各平台接入的范围不同：
| 平台 | 当前接入范围 | 连接教程 |
|---|---|---|
| 官方 QQ 机器人应用；已验证绑定 PersonaBot、群内 @ 文字回复，以及 Host 重启后保留授权与绑定 | QQ：申请、配置与群聊验收 | |
| 飞书 / Lark | 应用机器人；已加入的群中提及，按平台及会话策略收件并回到来源会话 | 飞书 / Lark |
| Slack | 应用有权限访问的会话；频道提及回到原线程，私聊按私聊路径处理 | Slack |
| Discord | 绑定的 Bot 应用；接收范围受服务器、频道权限及消息内容权限影响，不承诺任意频道可读 | 身份绑定与会话管理 · Discord 接入验证 |
| 个人微信 | 扫码者与微信 Bot 的私聊；不包括微信群、其他联系人或企业微信 | 个人微信 |
QQ 已完成真实群聊验收。 当前 deepseekbot@1.4.1 运行在 DSH 0.2.1-rc.2 并随包携带 QQ Provider 4.32.0-botharness.21。已记录的真实群聊验收使用源码候选构建 1.2.1-vps.20261012.sha031a14db（提交 031a14db43af5b3bf52e76b01c30e27828e6e9c9）、DSH 0.2.0-rc.1 和 qualified QQ Provider 4.32.0-botharness.19，实测首次回复和重启后新消息回复（不同于历史 npm v1.2.1 所带的 .16 Provider）。按完整 QQ 教程核对官方应用资格、平台环境与 Provider，连接后绑定到目标 Bot。一个 App 只由一个 Host 接收；图片、全量群消息和任意主动推送不属于该次验收范围。
新版如何绑定应用
以下是新版绑定流程，旧版本的布局与接收策略可能不同；较早版本的 Profile 截图仅作为历史记录。查看已安装版本及发布记录，避免按新版说明寻找尚未发布的控件。
- 到 设置 → IM bots 连接平台应用，凭据仅保存在本机。QQ 已有应用走 QQ → 手动接入；个人微信在这里扫码配对。
- 打开目标 Bot 的私聊，展开侧栏 外部身份，点击 绑定应用。
- 选择已连接应用。一个应用只属于一个 Bot；已绑定其他 Bot 的应用不可重复选择。连接未就绪时先处理连接状态。
- 确认应用为 Ready / 就绪，从平台发送测试消息：QQ、飞书、Slack 在有权限的测试群或频道使用真正的 @ 提及应用，微信使用扫码者私聊，Discord 使用应用有权读取的测试会话。检查 Bot 收件箱和原平台实际显示的回复。
- 新会话按 自动接收 或 先询问 策略处理。先询问时，允许后再发一条新消息；不回补先前消息。可按会话静音、设置规则或屏蔽。
无需把所有群先保存为发送目标，也无需逐群在旧 Profile 中手工授权。绑定仍受平台权限及应用连接状态约束；外部消息不会自动镜像到本地私聊。
选择电脑或浏览器目标
在 deepseekbot v1.4.1 中，@botharness/computer 与 @botharness/browser 已随公共 npm 正式包一起发布（在历史版本 v1.2.1 及已记录的源码版本 636a5a6c 中它们曾是仅源码可选组件，且当时本机 Computer 仅限 macOS）。Computer Access 与 Browser Access 默认关闭，按 Bot 分开启用；默认每个 Session 的首次操作需要批准。日常浏览器还需要用户显式连接并授予相应页面或 Profile 的访问。
| 目标 | 能做什么 | 要求与范围 |
|---|---|---|
| 本机 Computer | 观察与操作本机桌面 | @botharness/computer（已包含在 deepseekbot@1.4.1）；支持 macOS、Windows 和 Linux，需要系统授予对应权限，不需 Docker（在历史提交 636a5a6c 时仅限 macOS） |
| 日常浏览器：只读分享 | 读取明确分享的一个文档 | @botharness/browser + 源码扩展；Chrome / Edge，只读，不能点击、输入或导航；真实验证使用 Chrome |
| 日常 Chrome：当前文档控制 | 观察、点击和输入当前授权文档 | Browser 组件 + 官方 Playwright 扩展；不提供任意导航或受管浏览器完整工具集；导航 / 重载结束当前授权 |
| 日常 Chrome：Profile 控制 | 列出与选择标签页、导航、观察、点击和输入 | Browser 组件 + BotHarness Profile 扩展；需明确授权更大的范围；不等于受管浏览器全部工具，验证使用 Chrome |
| 受管 Bot Browser | 在独立浏览器中导航及执行已支持的网页操作 | Browser 组件；可在本机或 Docker 中运行，使用独立浏览器资料，不默认访问你的日常浏览器 |
| Docker Bot Computer | 操作容器桌面，可实时观看 | Computer 组件 + Docker；与宿主机本机桌面隔离的容器桌面 |
安装可选组件
npm deepseekbot@1.4.1 已包含 @botharness/browser 和 @botharness/computer（早期 deepseekbot@1.2.1 等版本未随包内置）。安装 deepseekbot@1.4.1 后，在对应 Bot 设置中开启 Browser Access 或 Computer Access 并选择目标即可。容器目标仍需要安装 Docker；日常浏览器模式仍需从仓库源码加载未打包浏览器扩展（见日常浏览器教程）。独立可选插件（如 VRM 伴侣 @botharness/vrm-companion@0.2.0）通过 dsh plugin --profile <your-profile> add @botharness/vrm-companion@0.2.0 单独安装。
如需从源码运行或在隔离 Profile 中调试本地组件，可按源码 README 的开发启动步骤（历史快照：636a5a6c）开始：安装 Node ≥22 和 pnpm 12.4.2，获取仓库，安装依赖并构建，用开发启动器启动全新的隔离 Profile；再按 Bot 开启对应 Access、选择目标并按教程连接扩展。配置可用模型后，批准一次受限测试操作。