DeepSeek Harness 接入 飞书 / Lark：dsh-im 教程

快速开始

如果你已经安装好 DSH，直接从第 1 步开始。整个流程的结果应该是：平台消息进入本机 DSH，DSH 完成任务，再把回复发回原平台。

1. 安装 dsh-im。
2. 重启 dsh web，打开「设置 → IM机器人」。
3. 选择 飞书 / Lark，完成扫码或凭据绑定。
4. 发送 /status，再发送一条只读任务。

第 1 步 — 安装 dsh-im

在安装了 DSH 的同一台电脑上运行。作者推荐 npm 已发布稳定版。

dsh plugin --profile web add -w @xmanrui/dsh-im

安装完成后，重启 Web Profile：

dsh web

如果终端提示没有 dsh 命令，可以把命令前缀换成 npx @deepseek-ai/dsh。不要把下面的 GitHub 源安装当成默认方案；只有要试用最新未发布代码时才用它：

npx -y github:xmanrui/dsh-im install

然后刷新浏览器，进入「设置 → IM机器人」。完整原文：dsh-im README。

第 2 步 — 绑定 飞书 / Lark

飞书主线使用 dsh-im 的扫码或 App ID/App Secret 绑定。需要更少平台的独立插件时，再看 dsh-lark。

1. 打开 DSH「设置 → IM机器人 → 飞书」，选择扫码创建，或选择手动绑定。
2. 手动创建应用时，启用机器人能力、订阅 im.message.receive_v1，并选择长连接接收事件。
3. 完成应用发布/安装后，把 App ID 和 App Secret 填回 DSH，确认卡片在线。
4. 群聊先要求 @机器人；单聊先用一个测试账号验证。

平台文档：飞书事件订阅。备选插件：dsh-lark。

第 3 步 — 发第一条任务

在 飞书与机器人的单聊 依次发送下面三条消息。第一条检查连接，第二条清掉旧会话，第三条才做真正的只读任务。

/status
/new
只读任务：列出当前工作区根目录的文件名，不要修改任何文件。

1. `/status` 应返回当前机器人与 DSH 的连接状态。
2. 第三条消息应收到最终回复，同时在 DSH Web 中出现新的 Session。
3. 再用未授权账号测试一次，确认它不会触发任务。

飞书 / Lark 常见问题

安全提醒

• Token、App Secret、二维码会话和 WhatsApp 认证目录都是凭据，不要提交 Git 或发到公开聊天。
• 先用没有生产密钥的测试工作区，并保持最小访问范围。IM 消息可能触发本机文件、命令和工具。
• dsh-im 是社区插件。升级前重新看作者 README 和变更记录，不要把社区方案当作平台官方集成。