DeepSeek Harness (DSH) 通过插件机制提供多种集成能力。对于钉钉用户，xmanrui/dsh-dingtalk 提供了一种将钉钉机器人接入 Harness 的方案。它通过二维码授权创建机器人，并使用钉钉 Stream 长连接在 Host 进程内处理消息，无需浏览器直接接触敏感凭据。
核心功能¶
- 扫码授权：通过一次性二维码在钉钉创建并授权机器人。
- Host 进程运行：插件运行在 Harness 的 Host 进程内，由 Host 通过钉钉 Stream 长连接收消息。
- 凭据管理：扫码获得的
client_secret直接写入 Harness 凭据服务，浏览器端不接收敏感信息。 - 消息处理：支持私聊文字消息及群聊明确 @ 机器人的文字消息。
- 会话与命令：支持连续对话，支持
/new（开启新会话）、/status（检查连接）、/help（显示帮助）命令。 - AI Card 渲染：AI Card 会持续更新并在生成失败时降级为普通文本。
- 不支持：不支持图片、文件、视频或语音消息。
安装与启用¶
前提条件¶
- DeepSeek Harness 版本
0.1.0-rc.6。 - Node.js 版本
>=22.19。 - 钉钉 App，扫码账号必须已加入企业/组织并有权创建机器人。
安装步骤¶
- 执行安装命令：
npx -y github:xmanrui/dsh-dingtalk install
- 重启
dsh web。 - 打开「设置 → 插件 → IM机器人 → 钉钉」。
- 点击「扫码接入钉钉」。
- 使用已加入企业/组织的钉钉账号扫描页面二维码。
- 在钉钉授权页点击「一键创建新机器人」。
- 等待页面自动显示机器人已连接。
- 在钉钉中私聊机器人，消息会直接进入 Harness。
使用说明¶
基本交互¶
- 私聊：直接发送文字消息，进入 Harness 进行对话。
- 群聊：仅处理明确 @ 机器人的文字消息。
- 命令：
/new：开启一个新的会话。/status：检查当前的连接状态。/help：显示帮助信息。
安全与访问控制¶
- 浏览器端不接收
client_secret、device_code或原始 staff ID。 - 入站访问权由钉钉机器人的可见范围决定，无需 Harness 本地二次批准。请在钉钉开放平台限制机器人可见范围为信任的组织、群或成员。
- 会话 Webhook 仅在内存中使用，不写入配置或日志。
注意事项¶
- 项目状态：本项目已不再维护，建议使用统一的插件
dsh-im（支持微信、飞书、钉钉、QQ、企微、Slack、Telegram、Discord、WhatsApp）。 - 删除机器人：在钉钉中删除机器人会停止连接，并删除对应的凭据、配置、去重记录和会话映射。
- 账号要求：扫码账号必须拥有创建机器人的权限，若提示“账号还未加入组织”，需重新登录或切换账号。
生态背景¶
DeepSeek Harness 的插件生态旨在实现功能模块化。本插件由社区开发者 xmanrui 维护，遵循 MIT 许可证。相关资源及目录可参考：GitHub | SkillHub 目录。
