前言¶
DeepSeek Harness(dsh)的核心理念是「一切皆插件」:模型、工具、技能、會話都可以換成社區包。智能體很擅長一次性給出完整計劃,但對執行功能喫力的人來說,計劃本身經常變成負擔——清單越長,啓動越難。
dsh-adhd-copilot 就是衝着這件事做的。它不要求你先自律、再完成全部,而是掃描「拖着 / 過載 / 自責」這類狀態,路由到對應模塊,每次只給 1 到 3 個能帶走的最小動作。本文按社區目錄頁、GitHub 倉庫 README、SKILL.md 和源碼交叉覈對後整理:它是什麼、裝怎麼裝、實際怎麼用。
社區插件目錄 https://deepseek-harness-plugin.com/ 是獨立站點,和 DeepSeek / 幻方沒有官方從屬關係,不要把它當成官方應用商店。
這是什麼¶
dsh-adhd-copilot 是一款面向 DeepSeek Harness 的技能插件,由 zimai233 維護,倉庫在 GitHub:zimai233/dsh-adhd-copilot。許可證爲 MIT,package.json 版本號爲 0.1.0,主要語言是 JavaScript。截至 2026-08-18,目錄頁和 GitHub 都顯示 3 星。
目錄頁上的定位是:面向 ADHD 的行爲教練技能,用溫和、可執行的結構幫你推進任務。倉庫 README 寫得更具體:把用戶從「想做但動不了」帶到「帶走一個最小行動」。
它解決的不是「幫你寫一份週報大綱」,而是這類卡住的時刻:
- 想開始但動不了(啓動困難)
- 事情太多,不知道先做哪個(過載)
- 容易分心、坐不住
- 低估任務耗時
- 沒勁、無聊、沒動力
- 因沒完成而自責
- 不知道這個任務該怎麼下手
運行時它只向智能體註冊一個工具:adhd_breakdown。源碼註釋寫明:參考 agent 裏沒有確認可用的 skills 服務,因此插件只註冊工具,更穩妥;完整教練方法論仍以 skills/adhd-copilot/SKILL.md 和 11 份 references/*.md 原樣打進 npm 包的 files 字段,作爲可獨立閱讀的交付物。
核心功能¶
三條原則¶
SKILL.md 和 README 共用三條驅動理念:
- 永遠只推動下一步,不要求完成全部。
- 可帶走行動:每條回覆給出用戶能獨立執行的最小動作,不需要回到聊天框;反饋循環全部可選。
- 質量地板:內容質量高於格式;規則和好答案衝突時,規則讓路。
references/core-workflow.md 還列出五條認知事實,用來解釋爲什麼步驟必須短、估時必須落到分鐘:工作記憶很小、知道不等於做到、啓動最難、時間感失真、可見進度纔有意義。
一個工具,八個模塊¶
智能體調用 adhd_breakdown 時,會掃描 task 和 context 裏的狀態信號,按優先級 情緒 > 結構 > 啓動 路由到模塊。源碼裏的順序是:自責(F)和沒勁(E)先處理,再清理過載(B),最後才啓動(A)。
| 狀態 | 典型信號 | 模塊 | 一句話規則 |
|---|---|---|---|
| A 啓動困難 | 做不了 / 拖着 | M1 任務破碎機 | 一次 1-3 步,每步小於 60 秒 |
| B 事情太多 | 好多事情 / 腦子亂 | M2 外部大腦 | 現在區只留 1 件事 + 唯一 Next Action |
| C 容易分心 | 坐不住 / 看手機 | M4 起跑與迴歸儀式 | 給自足啓動指令,檢查點可選 |
| D 時間誤估 | 怎麼花這麼久 | M6 時間審計員 | 預計 vs 現實:準備 / 執行 / 中斷緩衝 |
| E 沒動力 | 太無聊 / 不想做 | M3 多巴胺建築師 | 先問電量,再配開胃菜 / 主菜 / 配菜 |
| F 自責 | 又失敗了 | M7 失敗重啓 | 停止評價 → 縮小目標 → 一個 30 秒動作 |
| G 不知道怎麼做 | 該怎麼做 / 怎麼選 | M8 選路器 | 2-3 個框架 → 標陷阱 → 收斂到 1 個行動 |
M5「興趣遊戲化」不走默認路由,只有用戶明確要求(opt-in)時纔會包裝成 RPG / 認真 / 極簡敘事。
工具返回的結構化字段在 README 裏寫得很清楚:module / moduleName、nextAction(30 秒內能做)、whyNow、timeboxEstimate(具體分鐘,不用「一會兒」)、energyRequired、steps(1-3 步)。可選參數包括:battery(M3 電量:10 / 30 / 60 / 90)、narrative(M5)、estimatedMinutes(M6)、parked / dropped(M2 的稍後 / 廢棄清單)。
Pre-flight 門和輸出紀律¶
不是每句話都會套教練流程:
- 無任務信號(閒聊)→ 靜默,零干擾
- 請求很小(一句話提問)→ 直接回答,不套流程
- 信號模糊 → 給出 A-G 自助菜單,讓用戶自己選,減少誤判
- 信號明確 → 直接進對應模塊
輸出紀律寫在 references/output-discipline.md:首行就是下一步行動;編號步驟一次不超過 3 步;結尾再給一個 30 秒內能做的動作;表揚必須綁到具體勝利,禁止「加油你能行」;AI 無法在執行期間主動出現,因此絕不假裝有計時器。
實現上是純 ESM,零構建、零運行時依賴。package.json 通過 "dsh": { "bundle": { "patch": "./cordis.patch.yml" } } 聲明 Cordis 層,補丁文件把插件以 id: adhd-copilot 插入當前 profile。
安裝與啓用¶
社區目錄頁給出的安裝命令如下,在已經裝好 dsh CLI 的終端裏運行即可:
dsh plugin add github:zimai233/dsh-adhd-copilot
官方 CLI 習慣帶上 profile。倉庫 README 的寫法是:
dsh plugin --profile myprofile add github:zimai233/dsh-adhd-copilot
需要可復現安裝時,把 commit 哈希釘死。目錄頁的格式是 github:zimai233/dsh-adhd-copilot#commit。截至 2026-08-18,倉庫 master 最新提交爲 6527cb64b11b7265ba576e195bd008a5aa066be5:
dsh plugin add github:zimai233/dsh-adhd-copilot#6527cb64b11b7265ba576e195bd008a5aa066be5
README 還寫了 dsh plugin --profile myprofile add dsh-adhd-copilot(按 npm 包名安裝)。覈對 npm 註冊表時,dsh-adhd-copilot 返回 404,當前應以 GitHub 源爲準,不要默認走 npm。
目錄頁和 dsh 文檔都提醒:插件以當前 dsh 進程的權限運行,安裝時可能執行代碼。安裝前請檢查源代碼倉庫和許可證。
典型用法¶
裝好後,用自然語言對 agent 說話即可,不必手寫工具調用。README 給了三句觸發語:
「我拖着不寫週報,兩週了,幫我開始。」
「好多事情堆着,腦子亂成一團,不知道先做哪個。」
「我又沒做完,我怎麼這麼差。」
第一句會命中 M1。README 裏的結構化拆解示例是:
{
"module": "M1",
"moduleName": "任務破碎機 (Task Breaker)",
"nextAction": "打開與「週報」相關的文件或頁面(30 秒內)",
"whyNow": "啓動最難:第一個動作必須明顯、微小、現在就能做。一次只給 1-3 步,每步 <60 秒,跑完再要。",
"timeboxEstimate": "第一步 <60 秒;本輪 2 步,跑完再要下一步",
"energyRequired": "低(僅需打開文件)",
"steps": ["打開與「週報」相關的文件或頁面(30 秒內)", "寫下這一行標題:「週報」"]
}
渲染成教練回覆後,大致是:
週報,先別想完成。只做第一步:
1. 打開與「週報」相關的文件或頁面(30 秒內)
2. 寫下這一行標題:「週報」每步 <60 秒。做完回覆「完成」(可選,不阻塞)。你開始了,這一步就成了。
第三句會命中 M7(失敗重啓)。SKILL.md 裏的對應回覆是:先停評價,再給一個 30 秒動作——打開相關文件即可,不要求把任務做完。
倉庫自帶 npm test(node --test),覆蓋狀態掃描、Pre-flight 靜默、模糊菜單、以及技能文件是否齊全。需要覈對拆解邏輯時,可以直接跑測試,不必先接上真實對話。
適用場景與注意事項¶
適合已經在用 DeepSeek Harness、執行時經常卡在「啓動 / 過載 / 自責」的人。它不是待辦應用,也不會替你盯着番茄鍾。倉庫「Honest by design」一節寫得很直白:
- 沒有計時器:AI 無法在執行期間出現,中途檢查點全部可選。
- 不承諾跨會話記憶:只有平臺本身提供長期記憶時纔會持久化。
- 零打擾:沒有任務信號時完全靜默。
- 安全邊界:這是執行輔助,不是醫療診斷或治療工具。用戶表現出情緒危機或自傷信號時,應溫和建議尋求專業幫助,而不是繼續推任務。
SKILL.md 還列出幾條反模式,安裝後如果智能體仍在一次甩出完整清單、給二十個選項讓你自己挑、或說「你應該自律」,就說明沒有按這套紀律在走。
插件以當前 dsh 進程權限運行。安裝前請打開 https://github.com/zimai233/dsh-adhd-copilot 查看源碼和 MIT 許可證;需要可復現環境時固定 commit,不要只裝浮動的默認分支。
結尾¶
dsh-adhd-copilot 把一套 ADHD 教練流程收成 DeepSeek Harness 裏的一個工具:先辨認狀態,再只推下一步。完整方法論在 skills/adhd-copilot/ 裏,可以當文檔讀,也可以隨插件一起加載。
目錄頁:https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-adhd-copilot/
GitHub:https://github.com/zimai233/dsh-adhd-copilot