前言¶
DeepSeek Harness（DSH）提倡「一切皆插件」。对智能体开发来说，插件不只是扩展功能，也可以把宿主流程中的关键状态暴露出来。
智能体运行时经常会进入等待状态：请求用户批准、等待用户回答 ask_user_question、等待确认 exit_plan_mode，以及一轮对话结束。如果使用者不在 Web 界面旁边，这些事件容易被错过。
dsh-feishu-notifier 解决的是这个问题：在 DeepSeek Harness 触发上述事件时，向飞书机器人发送文本通知。
这是什么¶
dsh-feishu-notifier 是一个 DeepSeek Harness Bundle，由 blooming-fang 维护，许可证为 MIT。
它的定位是：当智能体请求用户批准、等待用户回答问题或确认计划，以及一轮对话结束时，向飞书机器人发送文本通知。
使用要求：
- DeepSeek Harness
0.1.0-rc.5或兼容版本。 - Node.js
22.19+。 - 在 Web 设置中配置飞书自定义机器人 Webhook。
package.json中peerDependencies包含@deepseek-ai/cordis、@deepseek-ai/dsh-settings、@deepseek-ai/schemastery。
核心功能¶
dsh-feishu-notifier 提供以下已核实能力：
- 向飞书机器人发送文本通知。
- 在用户审批请求、
ask_user_question、exit_plan_mode和turn/end对话轮次结束事件时触发通知。 - 对
turn/end事件，将完成、错误、取消和中断原因转换为可读文本。 - 在 Web 设置中配置飞书自定义机器人 Webhook。
- 支持保存 Webhook 和发送测试消息。
- 通过插件自己的 Host API 将配置持久化到 DSH 的
settings.yaml。 - 提供 Node/Cordis Loader 入口
lib/index.js和 Web 浏览器插件入口lib/client.js。 - 支持从 npm 安装或从 GitHub 安装。
安装与启用¶
从 npm 安装到 web Profile¶
如果使用已安装的 DSH 命令，执行：
dsh plugin --profile web add dsh-feishu-notifier
dsh --profile web
第一条命令安装插件，第二条命令启动 web Profile 下的 DSH。
如果使用源码方式运行 DeepSeek Harness，将 dsh 替换为 pnpm dsh：
pnpm dsh plugin --profile web add dsh-feishu-notifier
pnpm dsh --profile web
从 GitHub 安装¶
README 中给出的 GitHub 安装示例是：
pnpm dsh plugin --profile demo add github:blooming-fang/dsh-feishu-notifier
这里使用的是 demo Profile，按项目实际需要执行。从 GitHub 安装时会执行 prepare 构建插件。只应安装可信仓库中的代码；pnpm 可能要求在 Profile 的 workspace 配置中加入 allowBuilds 授权。
本地开发¶
在仓库中运行本地开发命令：
pnpm install
pnpm run build
pnpm pack:check
构建会生成两个入口：
lib/index.js：Node/Cordis Loader 入口；lib/client.js：Web 浏览器插件入口。
典型用法¶
启动 DSH 后，打开：
设置 → 飞书通知
然后按下面步骤配置：
- 填写飞书机器人 Webhook。
- 点击「保存 Webhook」。
- 点击「发送测试消息」验证连接。
配置保存后，会通过插件自己的 Host API 持久化到 DSH 的 settings.yaml。资料中给出的路径通常为：
C:\Users\<用户名>\.dsh\settings.yaml
适用场景与注意¶
适合以下场景：
- 需要在 Web 界面外接收 DSH 智能体的关键交互提醒。
- 需要把用户审批、用户问题、计划确认、对话轮次结束等事件同步到飞书。
- 需要在本地 DSH Web 设置中管理飞书机器人 Webhook。
需要注意：
- Webhook 属于敏感设置，保存后不会返回给浏览器。
- 不要把真实 Webhook 地址提交到 GitHub 或发布到 npm。
- 真实 Webhook 不会包含在 npm 包中，每位用户都需要配置自己的地址。
- 从 GitHub 安装时会执行
prepare构建插件，只应安装可信仓库中的代码。 - pnpm 可能要求在 Profile 的 workspace 配置中加入
allowBuilds授权。 - 插件会以当前
dsh进程权限运行，安装前应检查源码与许可证。已核实资料中许可证为 MIT。
链接¶
本资料未提供目录页 URL，GitHub 仓库为：
https://github.com/blooming-fang/dsh-feishu-notifier
