前言¶

在 DeepSeek Harness 裏，人可以在界面裏推進任務，模型會話可以通過工具讀寫狀態，可選的 DS Bot 也會參與同一套工作流。若任務只記在對話裏或各自維護一份列表，負責人、下一步和完成摘要很難對齊，多會話協作時還容易互相覆蓋。

DS Kanban（yulong-me/ds-kanban）是社區維護的工作流類 DSH 插件，把看板數據放在本地 SQLite 中，讓人、DS Bot 與普通 DSH 會話讀寫同一份任務卡，並保留創建者、負責人、實際操作者與來源會話。當前 0.3.0-beta.1 爲 M1 測試版，面向單個 DSH 安裝者及其本地會話；普通會話無需安裝 DS Bot。項目只參考 Kan 的功能需求，未引入 Kan 的源碼或界面。

這是什麼¶

維護者 yulong-me，倉庫 github.com/yulong-me/ds-kanban，社區目錄頁 skillhub.cn/plugins/yulong-me/ds-kanban。插件簡介爲：Human, DS Bot and ordinary-session collaborative kanban plugin for DeepSeek Harness——即面向 DSH 的人機協作看板。

數據默認落在 ~/.dsh/kanban（若設置了 DSH_HOME，配置與數據在該目錄下）。API 依賴 DSH 的所有者認證，不宜將插件單獨掛到無認證的 HTTP 服務上使用。

核心功能¶

下面介紹 README 中已列出的能力；檢查清單、標籤、搜索、附件、討論、提醒、任務執行調度與多用戶遠程服務不在此版本範圍內。

看板與任務¶

• 多看板，自定義列、列排序、歸檔和恢復。
• 任務字段：標題、目標、負責人、下一步、等待對象、完成摘要；支持編輯、移動、排序、歸檔和恢復。
• 明確完成才改變進度；暫停、退出、空閒、重啓不會自動完成；指派負責人不啓動執行。

身份與權限¶

人、Bot、普通會話讀寫同一份數據。看板級角色包括查看者、協作者、管理員：查看者只讀；協作者可維護別人創建的卡；管理員還可管理列、看板和成員。會話身份由 DSH 提供，工具參數不能冒充身份。安裝者保留管理權；新建看板的人或會話爲管理員。

數據與併發¶

• SQLite 事務保存、版本衝突檢查、請求去重、舊版遷移、在線備份和導出。
• 五個工具：kanban_list、kanban_create、kanban_update、kanban_move、kanban_manage。修改時需帶 baseRevision 與唯一 requestId；同一網絡重試須複用原請求，衝突後讀取最新內容再提交。
• 轉到完成列須提交 completion；轉到等待列須填 waitingFor 與 waitingReason；從完成列重開須填 nextStep。歸檔卡仍佔用所在列，避免刪列時丟掉歷史任務。

兼容要求¶

已驗證環境：DeepSeek Harness 0.2.1-rc.5，Node 22.23.2，macOS arm64。Node 要求 >=22.13.0，使用內置 node:sqlite。DS Bot 爲可選插件，已聯調 0.1.4。peerDependencies 含 @deepseek-ai/cordis 與 @deepseek-ai/dsh-tools（與上述 DSH 版本線一致）。

安裝與啓用¶

測試版從 Releases 下載預構建 ds-kanban-0.3.0-beta.1.tgz，並覈對同頁 SHA256。下列命令將本地 tgz 加入 profile（Web 使用時把 desktop 改爲 web）：

dsh plugin --profile desktop add /absolute/path/ds-kanban-0.3.0-beta.1.tgz

安裝器會識別包內 bundle 聲明並啓用插件。重啓 DSH 後，在左側打開「看板」。若採用 link: 開發安裝或舊配置導致入口未出現，可檢查 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 是否包含 "ds-kanban"，保留已有項並避免重複添加。

首次體驗建議用獨立的 DSH_HOME，避免直接升級日常數據；該目錄不會自動複製常用 profile 的模型憑證。

典型用法¶

讓人或 Bot 會話參與同一看板¶

1. 讓目標會話調用 kanban_list。它會登記真實身份，未授權時返回空看板。
2. 在界面「成員」中選中該會話或 Bot，添加爲「協作者」。
3. 再讓其讀取看板、創建或修改任務；界面輪詢會顯示結果。

Bot 的不同對話分段及羣會話共用同一 Bot 身份，變更記錄另保留來源會話 ID。授權給 Bot 即該 Bot 相關會話共享此權限；撤銷成員後，舊成功請求重放也不能再返回該看板內容。

備份與切換數據目錄¶

包內 scripts/data.mjs 亦可通過 ds-kanban-data 調用。示例使用絕對路徑，避免依賴 PATH：

node /path/to/ds-kanban/scripts/data.mjs backup --home "$HOME/.dsh/kanban" --out /path/to/backup.sqlite
node /path/to/ds-kanban/scripts/data.mjs export --home "$HOME/.dsh/kanban" --out /path/to/export.json
node /path/to/ds-kanban/scripts/data.mjs restore --from /path/to/backup.sqlite --to /path/to/restored-kanban

備份支持運行中的數據庫；輸出文件必須不存在。恢復只創建全新目錄，拒絕覆蓋現用數據庫。切換恢復副本前應先備份、導出當前數據並退出 DSH，在 profile 的 cordis.patch.yml 中合併：

- id: kanban
  config:
    home: /absolute/path/to/restored-kanban

重啓後覈對卡片再決定是否使用恢復副本。此版本沒有兩份數據的自動合併功能。

從 v1 board.json 升級¶

升級前退出舊版宿主並保留完整 ~/.dsh/kanban 目錄副本。首次打開時插件將 v1 board.json 導入 kanban-v2.sqlite：原始文件不修改，歷史卡進入「歷史看板 · 舊版導入」；不默認把歷史來源會話授權爲成員，需管理員重新授權。損壞或 ID 異常會中止遷移，原文件保持不變。

適用場景與注意¶

適合在單機 DSH 安裝下，用看板統一跟蹤「誰負責、下一步是什麼、是否在等待、完成摘要是什麼」，並讓人與多個模型會話在同一份數據上協作，而不是各寫各的 todo 列表。

插件以當前 DSH 進程權限運行，安裝前應閱讀源碼與 MIT License，自行評估是否滿足環境與安全要求。回退到 0.2.4 不會讀取 SQLite；回退前須備份、導出 v2 數據，不要把舊界面缺卡誤認爲刪除成功。

DeepSeek Harness 生態強調「一切皆插件」；社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文介紹的是社區插件而非官方應用商店條目。

結尾¶

DS Kanban 把本地看板、會話級權限與樂觀併發控制接到 DSH 工具鏈上，讓人、DS Bot 與普通會話在同一張卡上協作。若要安裝細節、遷移與驗收說明，以倉庫 README 與 VALIDATION.md 爲準。

• 目錄頁：https://www.skillhub.cn/plugins/yulong-me/ds-kanban
• GitHub：https://github.com/yulong-me/ds-kanban