DeepSeek Harness 插件

dsh-feishu-notify

DSH plugin: Feishu (飞书) custom-bot notifications when an agent session settles (idle) or asks for input (ask_user_question). Adapted for DSH 0.1.0-rc.7 (@deepseek-ai/cordis line).(英文原文)

跳到安装方式

来源信息

GitHub 仓库
omdsh-dev/dsh-feishu-notify
最近更新
2026年8月18日
分类
远程与移动
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/omdsh-dev/dsh-feishu-notify
插件名:dsh-feishu-notify
作者:omdsh-dev

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-feishu-notify

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

作用

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

<img width="1246" height="752" alt="image" src="https://github.com/user-attachments/assets/eaa2dda8-9e9d-431e-970c-3f0c18e59b98" />

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

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

安装

前置:git、pnpm、运行中的 DSH(≥ 0.1.0-rc.7)。

方式 A:直接从 git 安装(推荐)

# <profile> 换成实际名字,GUI 部署一般是 web
dsh plugin --profile <profile> add git+https://github.com/omdsh-dev/dsh-feishu-notify.git
  • 包声明了 dsh.bundlecordis.patch.yml 插入 feishu-notify 插件行),dsh plugin add 会自动挂载到 profile 的 bundle 层,无需手改 cordis.patch.yml
  • 编译产物 lib/ 已提交到仓库,git 安装无需构建(pnpm 的 allowBuilds 策略会拦截 prepare 脚本)。
  • 更新:dsh plugin --profile <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 <profile> add <路径>/dsh-feishu-notify

配置(两种方式相同)

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

配置(~/.dsh/settings.yaml)

feishu-notify:
  enabled: true
  webhookUrl: <你的飞书群自定义机器人 Webhook 地址>
  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.yamlfeishu-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 <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-settingssettingsNamespace + register,并导出 Config schema 作为 feishu-notify: 配置段形状(rc.7 插件约定)。