前言¶
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
