omdsh-dev/dsh-feishu-notify

dsh-feishu-notify

DSH 插件：agent 会话结束时通过飞书自定义机器人发送通知卡片。已适配 DSH 0.1.0-rc.7（@deepseek-ai/cordis / @deepseek-ai/schemastery 发行线）。

作用

| 时机 | 卡片 |
|------|------|
| 会话结束（agent 进入 idle） | ✅「dsh 会话结束」 |
| 模型调用 ask_user_question 等待输入 | 🔔「dsh 等待输入」 |

卡片含工作目录（末两段）与可选的「打开会话」按钮；subagent 会话不通知；webhook 发送失败只记日志，不影响 agent 主流程。

注意：由于 dsh-external/issues#397 目前不支持使用 sessionId + URL 跳转，现在的「打开会话」按钮只会跳转到 webui 中。

安装

前置：git、pnpm、运行中的 DSH（≥ 0.1.0-rc.7）。

方式 A：直接从 git 安装（推荐）

换成实际名字，GUI 部署一般是 web
dsh plugin --profile  add git+https://github.com/omdsh-dev/dsh-feishu-notify.git

- 包声明了 dsh.bundle（cordis.patch.yml 插入 feishu-notify 插件行），dsh plugin add 会自动挂载到 profile 的 bundle 层，无需手改 cordis.patch.yml。
- 编译产物 lib/ 已提交到仓库，git 安装无需构建（pnpm 的 allowBuilds 策略会拦截 prepare 脚本）。
- 更新：dsh plugin --profile  update dsh-feishu-notify。

方式 B：本地克隆构建后安装

git clone https://github.com/omdsh-dev/dsh-feishu-notify.git
cd dsh-feishu-notify
pnpm install && pnpm build
dsh plugin --profile  add /dsh-feishu-notify

配置（两种方式相同）

在 ~/.dsh/settings.yaml 末尾追加 feishu-notify: 段（字段说明见下），然后重启 DSH 进程。

配置（~/.dsh/settings.yaml）

feishu-notify:
enabled: true
webhookUrl:
webhookSecret: ""   # 仅开启「签名校验」时填，否则留空 ""
webUrl: ""          # 「打开会话」按钮跳转地址；留空则不显示按钮

- webhookUrl：飞书群 → 群设置 → 群机器人 → 添加机器人 → 自定义机器人 → 复制 Webhook 地址。它是私有 URL（等同密钥），不要泄露或提交到任何仓库；留空则不发送通知。
- webhookSecret：创建机器人时开启「签名校验」才需要，取机器人设置里的密钥。
- webUrl：你的 DSH 网页端地址。
- YAML 留空请写 ""；不写该行则回落默认值（secret 空、webUrl 为 http://127.0.0.1:3080）。
- settings.yaml 热重载，之后改配置无需重启。

配置优先级（与 rc.7 首方插件一致）：schema 默认值 → cordis.patch.yml 行内 config:（若配）→ settings.yaml 的 feishu-notify: 段。每次通知都会重读，改完即时生效。

验证

- 发一条消息，模型回复完成后飞书收到「会话结束」卡；模型调用 ask_user_question 时收到「等待输入」卡；subagent 结束不通知。
- 单独验证 webhook：DSH_NOTIFY_WEBHOOK_URL= pnpm send-test（可选加 DSH_NOTIFY_WEBHOOK_SECRET）。
- 单测：pnpm test（fetch 桩，不发真实消息）。

更新 / 卸载

- 更新：方式 A（git 安装）执行 dsh plugin --profile  update dsh-feishu-notify；方式 B 则 git pull && pnpm build 后重新 add。更新后重启 DSH。
- 卸载：删除 cordis.patch.yml 中的两行 → 重启 → profile 目录 pnpm remove dsh-feishu-notify。

与 DSH 0.1.0-rc.7 的适配说明

- 依赖迁移到 DSH 发行线使用的 fork：@deepseek-ai/cordis、@deepseek-ai/schemastery（替代上游 cordis / schemastery）。
- 事件负载改为直接使用已发布的 @deepseek-ai/dsh-agent / @deepseek-ai/dsh-session 类型，删除手写的结构类型。
- 修复：agent/status 的 subject 是 Agent，会话 id 字段为 agent.id（旧代码读 agent.sessionId 会得到 undefined，导致卡片链接失效）。
- settings 注册改用 @deepseek-ai/dsh-settings 的 settingsNamespace + register，并导出 Config schema 作为 feishu-notify: 配置段形状（rc.7 插件约定）。