前言¶
做 DeepSeek Harness 插件或智能体时，常见诉求不是再写一套聊天入口，而是让已有 Harness 会话能从飞书直接发起和继续：扫码创建机器人、多个机器人并存、飞书里多轮对话，同时少维护独立桥接服务。xmanrui/dsh-feishu 是围绕这个目标做的飞书接入插件。
这是什么¶
xmanrui/dsh-feishu 是一个 DeepSeek Harness 插件，owner 为 xmanrui，许可证为 MIT。它把一个或多个飞书机器人直接接入 DeepSeek Harness，并在 Harness「设置 → 插件 → 飞书」中扫码逐个创建机器人。
插件运行在 dsh web 的 Host 进程内，不需要再维护独立桥接服务。当前按 DeepSeek Harness 0.1.0-rc.6 的插件与 Connection RPC 接口开发。
README 开头写有“本项目不维护了”，并推荐替代插件 dsh-im。
核心功能¶
- 在 Harness「设置 → 插件 → 飞书」内反复扫码添加多个机器人，无需手动复制 App ID 或 App Secret。
- 每个机器人拥有独立凭据、飞书长连接、授权用户、会话映射和消息去重状态。
- 单个机器人断线、重连或移除，不会中断其他机器人。
- 扫码用户自动成为首位授权用户，创建后即可私聊机器人。
- 收到消息后先添加处理中 Reaction，成功或失败后再更新状态。
- 使用飞书 CardKit 原生流式卡片输出，失败时安全回退为普通文本。
- 每个飞书会话映射到持久的 Harness 会话，支持多轮上下文。
- 默认使用 Harness
standard智能体预设，包括网页搜索等工具能力。 - App Secret 仅保存在 DSH Host 的凭据存储中，不进入浏览器、二维码或插件配置文件。
安装与启用¶
先执行安装命令：
npx -y github:xmanrui/dsh-feishu install
安装后重启 dsh web。打开 Harness「设置 → 插件 → 飞书」，点击「添加机器人」，再用飞书扫码确认。
需要更多机器人时，再次点击「添加机器人」即可；扫码只会新增，不会覆盖现有机器人。连接成功后，在飞书中找到刚创建的机器人并发送消息即可。
每个机器人支持以下命令：
/new/status/help
本地开发¶
如果是从源码验证，可以先克隆仓库：
git clone https://github.com/xmanrui/dsh-feishu.git
进入仓库目录后，依次执行：
npm install
npm test
npm run build
node bin/dsh-feishu.mjs install --source .
这里先安装依赖、运行测试、构建插件，再用本地源码安装。仓库仍保留旧版独立桥接 src/index.mjs 与 .env.example；新安装优先使用 Harness 插件模式。
安全与默认行为¶
- RPC 仅允许本机 Harness 页面访问。
- 浏览器不能提交或读取 App Secret。
- 默认只接受扫码创建机器人的飞书用户消息。
- 机器人使用
standard工具集，但不会自动批准 Harness 的高风险操作。 - 移除某个机器人会只停止它自己的长连接，并清除它自己的插件凭据，不影响其他机器人。
- 重复扫码得到同一个飞书应用时，会复用原机器人记录，不会产生重复接入。
适用场景与注意¶
适合想把 Harness 会话接入飞书私聊、用扫码方式管理多个机器人、且不希望额外维护独立桥接服务的开发者。
安装前要注意：插件以当前 dsh 进程权限运行，安装前应检查源码与 MIT 许可证。App Secret 只保存在 DSH Host 的凭据存储中，非敏感配置保存在 $DSH_HOME/integrations/dsh-feishu/，各机器人的会话状态彼此隔离。
环境要求：package.json 声明 Node >=20，并依赖 @larksuiteoapi/node-sdk、dotenv、qrcode。更新 Harness 后，建议先运行测试，并验证设置页、扫码和消息收发闭环。
链接¶
- GitHub：https://github.com/xmanrui/dsh-feishu
- 插件目录页：https://www.skillhub.cn/plugins/xmanrui/dsh-feishu
