dsh-feishu-notifier
将 DeepSeek Harness 交互和轮次通知发送到飞书机器人
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-feishu-notifier@0.3.3
Feishu Notifier 以 dsh-feishu-notifier 发布，当前版本为 0.3.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个 DeepSeek Harness Bundle：当智能体请求用户批准、等待用户回答问题或确认计划，以及一轮对话结束时，向飞书机器人发送卡片通知。卡片使用飞书的 interactive 消息类型（卡片 JSON 2.0 的 markdown 组件），因此支持 Markdown；轮次结束时还会附带智能体的最终输出。
0.2.0-rc.1 或兼容版本。22.19+。pnpm install
pnpm run typecheck
pnpm run smoke
pnpm run build
pnpm pack:check
pnpm run smoke 会用桩上下文加载 lib/index.js 与 lib/client.js，校验通知分发、设置契约（volatile 字段与 secret 脱敏）、settings.section 注册，并复刻 dsh-app-boot 的插件版本校验、断言每个 dsh peer 范围都能接纳目标运行时版本 —— 升级 DSH 后应优先运行它，版本范围失配会在这里而非启动时报错。
构建会生成：
lib/index.js：Node/Cordis Loader 入口；lib/client.js：Web 浏览器插件入口。将插件发布到 npm 后，用户可以直接使用以下命令安装到 web Profile：
dsh plugin --profile web add dsh-feishu-notifier
dsh --profile web
如果使用源码方式运行 DeepSeek Harness，则将 dsh 替换为 pnpm dsh：
pnpm dsh plugin --profile web add dsh-feishu-notifier
pnpm dsh --profile web
启动后打开：
设置 → 飞书通知
填写飞书机器人 Webhook，点击“保存 Webhook”，然后点击“发送测试消息”验证连接。
配置通过 DSH 的 settings 服务写入当前 Profile 的补丁文件，通常是 ~/.dsh/profiles/<profile>/cordis.patch.yml。真实 Webhook 不会包含在 npm 包中，每位用户都需要配置自己的地址。
建议使用 release tag 或 commit SHA，确保安装内容可复现：
pnpm dsh plugin --profile demo add github:blooming-fang/dsh-feishu-notifier
从 GitHub 安装时会执行 prepare 构建插件。只应安装可信仓库中的代码；pnpm 可能要求在 Profile 的 workspace 配置中加入 allowBuilds 授权。
插件会发送以下通知：
用户审批请求（approval/request 瀑布事件）；
ask_user_question 用户问题请求；
exit_plan_mode 计划确认请求；
上面两项在两种会话形态下都会通知：普通会话记录为顶层 tool/call；PTC（程序化工具调用）会话的顶层调用是 run_code，嵌套调用记录为 tool/ptc-dispatch-start，插件在调用开始、提问弹出的那一刻发送通知。
turn/end 对话轮次结束事件，并将完成、错误、取消、分叉和中断原因转换为可读文本，同时附带本轮最后一段可见的助手输出（推理内容与工具调用不会进入通知，超过 3000 字会截断）。子代理（session.header.origin === 'subagent'）的轮次结束不会触发通知。
消息格式：标题栏使用 DSH（如「DSH 对话已结束」「DSH 需要你的操作」），正文由卡片 JSON 2.0 的 markdown 组件渲染，标题、列表、代码块与链接都按 Markdown 显示。
以下两种情况不会发送通知：
aborted（取消原因为 user）结束时保持静默，因为此时用户就在 DSH 界面旁，飞书推送只会形成干扰。由父代理、钩子或会话释放造成的取消不算用户主动停止，仍会照常通知。enabled: false）或 Webhook 为空时，所有通知都不发送。Webhook 属于敏感设置（Config 中声明为 role('secret')），保存后不会返回给浏览器。不要把真实 Webhook 地址提交到 GitHub 或发布到 npm。
ask_user_question / exit_plan_mode 借由 run_code 触发，会话日志里不会出现同名的顶层的 tool/call，因此此前完全不会发送「等待你回答/确认」的通知。现在同时识别 tool/call 与 tool/ptc-dispatch-start，两种会话形态都会通知。turn/end 的 aborted 原因归为 user）不再发送飞书通知；父代理、钩子与会话释放导致的取消仍照常通知。interactive 卡片（卡片 JSON 2.0 的 markdown 组件），支持 Markdown；轮次结束的通知会附带该轮智能体的最终输出（最长 3000 字，超出部分截断）。安装方式不变，重新执行 dsh plugin --profile <profile> add dsh-feishu-notifier（或指向新的 tgz 包）并重启 DSH 即可生效。
DSH 0.2.0-rc.1 新增了插件版本校验：启动导入插件前，dsh-app-boot 会读取插件 package.json 的 peerDependencies，把所有 @deepseek-ai/dsh 与 @deepseek-ai/dsh-* 声明与当前运行时版本逐一比对（含预发布版本）。任一范围不匹配即拒绝加载该插件并提示 Plugin ... is incompatible with dsh ...。
因此本次升级是必需的，而不是可选的：插件 0.2.2 声明的 @deepseek-ai/dsh-settings: ^0.1.7-alpha.1 无法满足 0.2.0-rc.1，会在启动时被直接拒绝。0.3.0 的改动：
@deepseek-ai/dsh-* 依赖与 peer 范围提升到 ^0.2.0-rc.1，@deepseek-ai/cordis 提升到 ^4.0.4，@deepseek-ai/schemastery 提升到 ^3.18.4；scripts/smoke.mjs 版本校验回归：用 semver 复刻 dsh-app-boot 的判定逻辑，断言每个 dsh peer 范围都能接纳目标运行时版本，避免下次再出现同类静默失败；lib/index.js 与 lib/client.js。插件使用的 settings、webServer、slots/configForms、session 事件与 __ModuleLoader__ 客户端契约在 0.2.0-rc.1 中均未发生破坏性变化，因此业务代码无需改动。
DSH 0.1.7-alpha.1 用 settings 服务的配置表单取代了旧的 ctx.settings.register scope API：
volatile 字段，设置服务就地更新，插件无需重新挂载即可读到最新值；ctx.configForms 读写命名空间 feishu-notifier，Webhook 仍为只写字段；POST /api/feishu-notifier/test 发送；@deepseek-ai/schemastery 改为直接依赖：.volatile() 需要 >=3.18.3，而 Profile 使用 nodeLinker: hoisted + autoInstallPeers: false，peer 依赖不会被安装。升级后如果旧的 ~/.dsh/settings.yaml 已迁移为 settings.yaml.imported，请打开“设置 → 飞书通知”重新填写一次 Webhook。