前言¶
在 DeepSeek Harness（DSH）裏用智能體做多步工作時，任務往往散落在不同會話的對話裏：進度要自己記，結論要回去翻聊天記錄。若希望「一張卡對應一項工作、獨立會話執行、看板上盯住進度、做完再驗收歸檔」，單純靠會話列表並不順手。
dsh-task-board（npm 包名 dsh-color-task-board，倉庫 shlan28/dsh-task-board）是維護者 shlan28 發佈的 工作流 類 DSH 插件：在側欄提供四列任務看板，把卡片派發到獨立會話執行，實時折算進度，結束後把結果收到「待驗收」；也支持按小時 / 天 / 周定時重複執行。本文介紹其定位、能力與安裝用法，事實以倉庫 README 與 package 信息爲準。
這是什麼¶
插件在 Harness 裏注入側欄任務看板界面，並把 Host 側的 task_board 工具註冊給會話中的 agent 使用。
- 維護者：shlan28
- 分類：工作流（社區目錄 skillhub 插件頁）
- 許可證：MIT
- 當前 npm 版本（package.json）：0.1.6
- 運行要求：DSH
>=0.2.1-rc.5 <0.3.0，Node>=20
看板數據落在 $DSH_HOME/task-board/board.json；定時規則交給 DSH 自帶定時任務服務（$DSH_HOME/storages/schedule.json），與 Harness「自動化任務」頁聯動，不修改 profile 配置、不寫會話日誌。
核心功能¶
四列看板與拖拽¶
待辦、進行中、待驗收、已完成四列；卡片支持標籤、進度條和執行階段，拖拽可換列。
派發到會話與進度¶
點卡片上的 ▶ 或詳情裏的「開始執行」時，Harness 會新建或複用會話，把任務卡寫成提示詞派發進去。執行過程中的 turn/start、tool/call、assistant/message、turn/end 會實時折算成進度；卡片和詳情可跳轉到綁定會話。
工作區綁定¶
新建或改詳情時可指定工作區：▶ 與定時執行都會在對應目錄下建會話；不指定則跟隨宿主默認目錄。工作區從列表移除後，卡片仍使用已保存的路徑。
定時自動化¶
新建任務時可將「自動化」設爲「定時執行」：每小時、每天或每週（可多選星期幾）。到點由 DSH 定時任務把卡片派發進獨立會話；結果進「待驗收」，驗收後普通卡進「已完成」，自動化卡回到「待辦」等待下一輪（週期任務無終態）。卡片可顯示規則與下次執行時間，支持暫停、啓用、改規則或取消自動化。
結果回收與驗收¶
任務結束自動進入「待驗收」，最後一次助手回覆存爲「最新結果」。驗收時行爲見上；執行中的卡需先停止才能改工作區等字段。
會話內 task_board 工具¶
任意會話裏的 agent 可調用 task_board 加卡、查卡、改卡、派發或讀結果。動作包括：add、list、update、move、run（here: true 表示在當前會話執行）、result、remove。
add / update 可帶 automation 對象，例如：
{ frequency: 'daily' | 'weekly' | 'hourly' | 'none', time: 'HH:MM', weekdays: ['MO', …], timeZone, active, rrule }
以及 workspace：工作區 id、絕對路徑或標題（'' 清除；缺省爲當前/默認目標）。
界面與主題¶
文案跟隨 DSH locale；顏色使用 --dsw-alias-* 主題 token，明暗主題通用。
安裝與啓用¶
倉庫已包含構建產物 dist/client.js，從 npm 或 GitHub 安裝時不需要本地構建。
從 npm 安裝（推薦）¶
在 DSH「插件」頁安裝外部 bundle，包名填：
dsh-color-task-board
固定版本示例：
dsh-color-task-board@0.1.6
也可用 CLI 安裝到指定 profile：
dsh plugin --profile desktop add dsh-color-task-board
從 GitHub 安裝¶
在插件頁填寫 pnpm spec：
github:shlan28/dsh-task-board
或完整地址：
https://github.com/shlan28/dsh-task-board
安裝、更新、卸載與數據路徑的完整說明見倉庫 docs/deploy.md。
典型用法¶
- 點側欄看板圖標進入面板，右上角「新建任務」。
- 需要週期執行時，在新建面板把「自動化」切到「定時執行」，選頻率與時間（每週再選星期幾）後創建。
- 需要固定在某一項目目錄執行時，在「工作區」下拉選擇目標（默認 = 跟隨宿主）。
- 卡片上點 ▶ 開始執行；在詳情查看綁定會話、階段、最新結果，可停止、驗收、退回待辦或刪除。
- 詳情中可隨時更換工作區（執行中須先停）；「自動化」區塊可查看下次執行時間並暫停 / 啓用 / 改規則 / 取消。
- 在會話裏用自然語言描述需求，例如讓 agent「把 XX 加到看板」或「每天 9 點檢查部署」，由 agent 調用
task_board建卡並傳入automation、workspace。
適用場景與注意¶
適合：需要在 DSH 內把「待辦—執行—驗收」串成可見流水線、且希望每項任務在獨立會話裏跑、便於回看進度與最新結論的開發者；也適合需要按 schedule 重複派發同類檢查類任務的場景。
權限與安全：插件以當前 DSH 進程權限運行，派發會話內的 agent 可調用宿主已有工具。安裝前請閱讀 倉庫源碼 與 MIT 許可證，確認是否符合你的環境策略。社區插件目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
本地改代碼：若自行 clone 後本地 link 安裝，改 client/ 只需重新構建並刷新；改 src/（Host）需移除 bundle 再裝一次 Harness 纔會加載新 Host 代碼。詳見 README「開發」一節。
結尾¶
dsh-task-board 把側欄看板、會話派發、進度折算和驗收回收接在同一條工作流上，並用 DSH 定時任務承接週期執行。需要試用或貢獻時，可從社區目錄頁或 GitHub 倉庫進入：
- 目錄頁：https://www.skillhub.cn/plugins/shlan28/dsh-task-board
- GitHub：https://github.com/shlan28/dsh-task-board
