原生 dsh 外掛程式：把鬧鐘排程提升到主機行程層級——`$DSH_HOME/proactive/` 下的持久化鬧鐘、冷卻工作階段喚醒、墓碑折疊式靜默收尾、免打擾與每日投遞預算，以及兩端 SSE 即時同步的面板。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-10
授權條款
作者未說明
01它能幫你完成什麼？
讓模型自行設定後續跟進，使任務在工作階段早已冷卻、頁面早已關閉之後仍能準時恢復
主機層級鬧鐘（once / every / cron / 檔案表）到點喚醒目標工作階段跑完一輪，跑完即釋放控制代碼
在 DeepSeek Harness 裡執行長週期或無人值守 agent、需要它自己回頭檢查的人
避免自主喚醒打擾使用者
`proactive_reclaim` 靜默收尾，把整輪喚醒折疊成約 70B 的墓碑；另有免打擾時段與每日投遞預算
想要主動型 agent、但不希望被意外通知打斷或汙染長期上下文的人
02如何將外掛接入 DeepSeek Harness？
先決條件
- dsh 0.2.0-rc.1 以上——在更早的 0.1.x 上會被 dsh 的 peer 檢查跳過、外掛程式根本不會載入
- 一個 `web` profile（README 用 `--profile web` 安裝）
安裝步驟
- 01
從 npm 安裝：`dsh plugin --profile web add dsh-proactive`
$ dsh plugin --profile web add dsh-proactive
- 02
或從 monorepo 子目錄安裝：`dsh plugin --profile web add github:john-walks-slow/dsh-proactive#path:/packages/dsh-proactive`——建議釘住 commit（`#<sha>&path:/packages/dsh-proactive`），首次 add 被 pnpm 攔截時把提示的套件名稱加入 `~/.dsh/profiles/web/pnpm-workspace.yaml` 的 `allowBuilds` 後重跑
$ dsh plugin --profile web add github:john-walks-slow/dsh-proactive#path:/packages/dsh-proactive
驗證整合成功
- 開啟工作階段頁的「主動喚醒」Tab 或設定頁控制中心——兩端都透過 `/api/dsh-proactive/events` 的 SSE 即時同步
- 對新鬧鐘按「立即觸發」按鈕，調測真實喚醒下的表現
03DSH 整合程度與能力邊界
原生主機層級 dsh 外掛程式：套件內建 `dsh.bundle.patch`，`dsh plugin add` 後 dsh loader 會自動掛載 `cordis.patch.yml`，不需手動改 profile。它為每個 root agent 註冊主機層級工具（`proactive_set`、`proactive_list`、`proactive_update`、`proactive_cancel`、`proactive_update_settings`、`proactive_reclaim`）。
主機層級鬧鐘排程
`proactive_set`，時間選擇器五選一：`at` / `after_seconds` / `every_seconds` / `cron` / `schedule_file`，另有抖動、免打擾與目標模式→落在 `$DSH_HOME/proactive/` 的持久化鬧鐘，服務重新啟動後自動復原
`every` 需 ≥300s，`cron` 相鄰觸發需 ≥300s`jitter_seconds` 在每次觸發時附加 `uniform(0, jitter)` 抖動，避免整點同時湧入靜默喚醒與墓碑折疊
模型判斷無事可報的喚醒回合→以 `proactive_reclaim` 作為唯一動作——不輸出可見文字，整輪折疊成約 70B 的單行墓碑，人類可讀日誌仍保留全部軌跡
該回合不消耗每日可見訊息額度檔案表鬧鐘控制代碼
指向單一絕對 JSON 路徑的 `schedule_file`→由檔案項目衍生的子鬧鐘——寫檔案即可增刪改，冪等且重新啟動後自癒
一個檔案只允許一個控制代碼；檔案是項目的唯一真源，刪檔案等於撤銷該計畫原子寫入是硬性契約：寫暫存檔再 rename，不要直接 delete 再 create以 SSE 為基礎的即時面板
`/api/dsh-proactive/events` 伺服器事件→工作階段頁「主動喚醒」Tab（清單、歷史稽核、新建／暫停／恢復／編輯／立即觸發）與設定頁的全主機控制中心
全域護欄集中在這裡：總開關、每日投遞上限、夜間免打擾時段、新建鬧鐘預設 prompt
04適合誰？何時不該用？
適合
- 在 DeepSeek Harness 裡執行長週期或無人值守 agent、需要它自己回頭檢查的人
- 想要主動型 agent、但不希望被意外通知打斷或汙染長期上下文的人
不適合
- 在 dsh 0.1.x 上裝本版本會被 peer 檢查跳過、外掛程式根本不會載入；那些部署請繼續使用 `dsh-proactive@0.2.3`。
- 從 0.2.x 升級：舊的 `config.scheduleFiles` 全域 glob 已移除，每個檔案必須各建一個控制代碼（停掉 dsh 後跑 `scripts/migrate-schedule-files.mjs`，或用 `proactive_set`／面板逐一建立），否則這些時間表檔案不再產生鬧鐘，舊機制留下的 `decl_*` 鬧鐘會被當孤兒清除。
- 控制代碼未給任何 `target_*` 時，只接受「檔案的祖父目錄恰好是一個已註冊 workspace」這項約定，否則直接報錯並要求明確傳入 `target_workspace_path` / `target_session_id`。
05相容性、維護與安全提醒
- 在 dsh 0.1.x 上裝本版本會被 peer 檢查跳過、外掛程式根本不會載入；那些部署請繼續使用 `dsh-proactive@0.2.3`。
- 從 0.2.x 升級：舊的 `config.scheduleFiles` 全域 glob 已移除，每個檔案必須各建一個控制代碼（停掉 dsh 後跑 `scripts/migrate-schedule-files.mjs`，或用 `proactive_set`／面板逐一建立），否則這些時間表檔案不再產生鬧鐘，舊機制留下的 `decl_*` 鬧鐘會被當孤兒清除。
- 控制代碼未給任何 `target_*` 時，只接受「檔案的祖父目錄恰好是一個已註冊 workspace」這項約定，否則直接報錯並要求明確傳入 `target_workspace_path` / `target_session_id`。
- 外掛程式本身絕不發起任何外部網路要求；面板依賴 `/api/dsh-proactive/*` 下的本機 dsh 服務，除檔案表控制代碼明確宣告的單一 JSON 路徑外，所有寫入都嚴格侷限於 `$DSH_HOME/proactive/`。
README 宣告 MIT（facts pack 的 license 欄位為空）· 未發布 GitHub Release（latest_release 為空）
06常見問題
它和工作階段內的計時器有什麼不同？
工作階段內計時器的生命週期綁定前端或工作階段控制代碼，工作階段冷卻、頁面關閉或行程回收就會失效。dsh-proactive 把排程提升到主機行程，資料持久化於 `$DSH_HOME/proactive/`，到點透過 `resume` 喚醒冷卻工作階段，跑完即釋放控制代碼，服務重新啟動後自癒。
支援哪些 dsh 版本？
目前版本針對 dsh 0.2.0-rc.1 以上。更早的 0.1.x 會被 dsh 的 peer 檢查跳過、外掛程式根本不會載入，那些部署請改用 `dsh-proactive@0.2.3`。
主動喚醒會不會一直跳訊息打擾我？
無事可報時模型可以把 `proactive_reclaim` 當作唯一動作：不輸出任何可見文字，整輪在模型可見上下文中折疊成一行約 70B 的墓碑。免打擾時段可直接跳過觸發，每日投遞預算也會限制可見訊息數量。
裝完還需要手動改 profile 嗎？
不需要。套件內建 `dsh.bundle.patch`，`dsh plugin add` 之後 dsh loader 會自動掛載 `cordis.patch.yml`。
檔案表鬧鐘是什麼？
它是單一絕對路徑 JSON 時間表檔案的控制代碼（`type: "file"`），本身永不觸發，而是把檔案內的項目同步成自己名下的子鬧鐘；子鬧鐘就是一般鬧鐘，走同一條排程、計費與重試路徑。
07相關的 DSH 工作流程
archify
作者 tt-a1i
为编码智能体生成美观可验证的架构图、时序图与数据流图，输出自包含 HTML，支持动效与清晰导出。
openviking
作者 volcengine
为 AI 智能体打造的自进化上下文数据库，统一智能体记忆、知识 RAG 与技能。
aitoearn
作者 yikart
面向抖音、快手、小红书和视频号的 AI 内容发布工作流，提供相关平台与 MCP 工具集成。
learn-harness-engineering
作者 walkinglabs
Harness 工程新手教程，从 0 到 1 系统学习智能体工作流框架。
08資料與來源
安装即生效：包内自带 `dsh.bundle.patch`，dsh loader 自动挂载 `cordis.patch.yml`，无需手工改 profile 配置。
插件为每个 root agent 注册以下 host 级工具（冷唤醒会话与普通日常会话均完全可用）：
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-11-10。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。