前言¶
在 DeepSeek Harness(DSH)裏跑長任務時,頂層會話往往要等多輪推理才結束。人若盯着頁面或反覆刷新,既費注意力,也容易錯過「已經做完」的時機。常見做法是另寫腳本輪詢狀態,或接企業 IM 機器人,但和 DSH 的會話事件、Web 界面脫節,配置和降級也要自己管。
下面介紹社區插件 dsh-fishgirl-notify(完成提醒 / 肥魚娘):在 DSH 頂層會話完成一輪任務時,按配置向手機推送「做好啦」類通知,並在 Web 頁面內播放肥魚娘動效彈窗。多通道可插拔,單路失敗自動降級,且不會阻塞會話;子代理回合不觸發。維護者爲 newpage1,分類爲工作流,開源倉庫見 GitHub,社區目錄頁爲 skillhub.cn。許可證 MIT,當前 package 版本 1.0.1。
這是什麼¶
插件監聽 DSH 會話與事件管線,在頂層會話完成一輪任務時組裝通知並分發;同時在瀏覽器端注入客戶端,展示頁內「做好啦~」動效與設置入口。設計目標是「提醒到人 + 頁內反饋」,而不是替代 DSH 本身的任務執行。
核心功能¶
多通道推送(可插拔、失敗降級)¶
README 列出的通道如下(憑證與平臺限制以倉庫說明爲準):
| 通道 | 平臺側重 | 主要憑證 |
|---|---|---|
| feishu(羣機器人) | 全平臺,文檔標註鴻蒙首選 | 羣自定義機器人 webhook |
| feishu-app(自建應用) | 有飛書即可 | App ID / App Secret + 接收方 ID(open_id 或 chat_id) |
| ntfy | 鴻蒙(卓易通)/ 安卓等 | server 與 topic,可選 token |
| webpush | Android / 桌面 Chrome | VAPID(插件可生成)+ 瀏覽器訂閱 |
| inpage | Web 頁面 | 無;默認始終啓用(SSE 與回放) |
任一通道發送失敗不阻塞 DSH 會話;默認 channelOrder 爲 [feishu, ntfy, webpush],feishu-app 需自行加入順序。未知通道 id 會被 registry 跳過並記 debug。
頁內動效與設置¶
客戶端注入 Web 平臺,提供右下角肥魚娘入口與設置卡:可配置各通道密鑰、預覽「只在本頁測試」動效。頁內提醒默認開啓。
觸發範圍¶
僅頂層會話一輪任務完成時觸發;子代理回合不觸發。這與「等主會話整輪結束再提醒」的使用習慣一致。
安裝與啓用¶
宿主要求 DSH >= 0.2.1-rc.2(見 package.json 中 dsh.engines 與 peerDependencies)。
1、從 GitHub 安裝(官方 README 命令):
dsh plugin --profile web add github:newpage1/dsh-fishgirl-notify
2、若從本地目錄調試,使用絕對路徑:
dsh plugin --profile web add /absolute/path/to/dsh-fishgirl-notify
3、安裝後若頁面尚未出現肥魚娘按鈕,重啓一次 dsh web(宿主按包名緩存插件模塊)。
插件在 web profile 下掛載 bundle patch 與 client,無額外 npm 運行時依賴聲明。
配置¶
打開 DSH Web → 設置 → Web 插件 → 完成提醒,或點擊頁面右下角肥魚娘按鈕:
- 飛書羣機器人:填寫 webhook
- 飛書應用:填寫 App ID、App Secret、接收方 ID
- ntfy:填寫 server 與 topic
- Web Push:在支持的瀏覽器中點擊訂閱
- 頁內動效默認開啓;可用「只在本頁測試」預覽
各通道的申請步驟見倉庫內 docs/使用說明.md。配置除 patch 默認值外,可由數據目錄 config.json 覆蓋(README「與技術方案的偏差」一節說明了未導出 schemastery Config 時的路徑)。
典型用法¶
1、安裝插件並重啓 dsh web(若需要)。
2、在 Web 設置中至少啓用一種外發通道(或僅使用頁內動效)。
3、發起一次頂層會話任務,待該輪結束後檢查:手機或訂閱端是否收到通知,頁面是否彈出肥魚娘動效。
開發者自測(README 快速上手,無外網依賴):
node test/run-tests.mjs
倉庫說明該腳本包含 34 項斷言。手機端授權與鴻蒙 / Android / iOS 差異見 docs/使用說明.md。
適用場景與注意¶
適合誰:經常在 DSH Web 上跑長回合、希望任務結束時用手機或頁內得到明確反饋的開發者;已使用飛書、ntfy 或 Web Push 的團隊可按現有基建對接。
運行與信任邊界:插件隨當前 dsh 進程權限運行,會讀寫本地 secrets、VAPID、訂閱等(lib/store.js 等);安裝前宜瀏覽源碼與 MIT 許可證,勿在 webhook、topic 等字段填入不可信環境的外鏈憑證。
平臺限制(摘自 README):Web Push 在鴻蒙 / iOS 瀏覽器側不支持;ntfy 在鴻蒙需卓易通,且無系統級推送;feishu webhook 校驗對迴環地址有額外放行,便於本地網關測試。
生態說明:DSH 社區插件目錄(如 skillhub.cn)爲獨立站點,與 DeepSeek / 幻方無官方從屬關係;添加插件屬於本機擴展行爲,非「官方應用商店」分發。
結尾¶
dsh-fishgirl-notify 把「頂層會話一輪完成」這一事件接到飛書、ntfy、Web Push 與頁內 SSE 動效上,失敗降級且不卡會話,適合作爲工作流裏的完成提醒層。進一步瞭解可訪問 目錄頁 與 GitHub 倉庫。