前言¶
DeepSeek Harness（DSH）以 Session 爲中心：一個 Session 對應一頁對話，側邊欄能看單個 Session 的狀態，卻沒有「整個工作區裏哪些在跑、哪些在等你、哪些已經做完」的全局視圖。如果你同時在多個工作區裏開多條長對話、又希望任務狀態和真實對話留在同一條 Session 裏，就需要在 Harness 之上加一層任務視圖。dsh-board 是社區維護者 lihuu 發佈的客戶端插件，在每個 workspace 上掛一塊可配置的 Kanban 看板，卡片綁定原生 Session，列表示任務狀態，角標表示 Session 的實時運行狀態。
這是什麼¶
dsh-board（包名 @lihuu/dsh-board）是面向 DeepSeek Harness 的 Kanban 任務板：卡片是任務，列是任務狀態，每個任務在一條長期存活的 native Session 裏執行。 它不改變 Harness 的 Session 存儲模型，只是在 Host 側持久化任務與列配置，在 Web UI 裏註冊面板與浮層入口。
與「每個任務新建一個 Session、在側邊欄來回點」相比，看板默認會讓新任務複用本看板上次使用的 Session，相關任務可以共享同一段長對話；任務列（待辦 / 進行中 / 完成）與 Session 生命週期（Idle / Running / Waiting for you / Done）分開展示，避免把「對話是否在跑」和「你心裏的任務進度」混爲一談。
核心功能¶
工作區即看板¶
頂欄按 workspace 切換標籤，每個 workspace 各自一塊板，只顯示該工作區下的任務。
可配置列¶
內置 待辦 / 進行中 / 完成 三列，可重命名；可增刪自定義列，任務可在任意列之間拖拽。刪除自定義列時，其中的任務回退到「待辦」。列配置持久化。
任務與 Session 綁定¶
創建任務時可選擇已有 Session，或新建 Session。默認情況下，新任務會複用本看板最近一次運行所用的 Session，便於同一主題的多步任務共用一條對話，而不是「一任務一 Session」。
實時狀態¶
卡片上的小角標來自 Session 列表與 Host 推送的狀態源（與側邊欄同源）：Idle、Running、Waiting for you、Done。列位置表示任務狀態，角標表示 Session 狀態。
自動流轉與計時¶
在卡片上按 Start：任務進入「進行中」；僅由該卡片觸發的運行結束後（Session 空閒且穩定約 2.5 秒），任務纔會被記爲完成並記錄耗時。在其他入口發起的運行不會擅自改動任務列狀態。
板內原生對話¶
點擊卡片後，詳情區渲染 Harness 自帶的 conversation.content 工廠，綁定對應 Session 引用——轉錄、輸入框、模型與權限控件、問題卡片等與主界面一致，不是插件重寫的聊天 UI。
快捷浮層與鍵盤¶
側邊欄底部的看板按鈕可在任意頁面上打開同一套任務的浮層（角標爲活躍任務數）。看板內：↑/↓ 移動焦點，Enter 打開，N 新建，Esc 關閉；對話視圖內 ↑/↓ 切換上/下一條任務，Esc 回到看板。
持久化¶
任務、列與當前選中項由 Host 寫入磁盤（見下文「數據與風險」），應用重啓後仍在；不僅依賴頁面刷新時的瀏覽器緩存。
安裝與啓用¶
DeepSeek Harness 版本需 ≥ 0.2.2（依賴帶 main、sidebar.panellist、shell.overlay、conversation.session.header.utilities 等插槽的 Web UI）。插件無構建步驟，客戶端爲直接提供的 JavaScript。
插件管理器（推薦）¶
dsh plugin add @lihuu/dsh-board
或在圖形界面：Settings → Plugins → install bundle，輸入 @lihuu/dsh-board。包內帶 cordis.patch.yml bundle 層，會寫入 Host 行。安裝後重啓應用一次（Host 半在啓動時加載）。
bundle 使用的 patch 行形如：
- insert:
- id: dsh-board
name: '@lihuu/dsh-board'
插件以當前 DSH 進程權限運行。安裝前建議在 GitHub 倉庫閱讀源碼與 MIT 許可證，確認符合你的安全與合規要求。
典型用法¶
- 安裝並重啓 Harness 後，打開某個 workspace 對應的看板面板（或通過側邊欄浮層進入）。
- 按 N 或界面操作新建任務：填寫卡片內容，選擇已有 Session 或新建；若連續做同一主題，可依賴默認「複用上次 Session」的行爲。
- 任務留在「待辦」列；需要執行時在卡片上 Start，任務進入「進行中」，Session 開始運行；角標會隨 Host 推送變爲 Running 或 Waiting for you 等。
- 點擊卡片，在詳情 pane 內直接與該 Session 的真實對話交互（補上下文、批准工具等）。
- 本次由該卡片啓動的運行結束後，任務自動進入「完成」並記錄時長；也可手動拖拽到其他列以反映你自己的任務劃分。
- 需要改列名或增加階段列時，在看板設置中調整；自定義列刪除後，該列任務回到「待辦」。
浮層入口適合在編輯代碼或瀏覽文檔時快速掃一眼「還有多少活躍任務」，再 Enter 跳進對應對話。
數據存儲與注意¶
| 層級 | 位置 | 作用 |
|---|---|---|
| 權威 | ~/.dsh/dsh-board/state.json |
任務、列、視圖選中、刪除墓碑 |
| 備份 | ~/.dsh/dsh-board/state.json.bak |
主文件損壞時回讀上一代 |
| 緩存 | 瀏覽器 localStorage |
僅同一次運行；Desktop 每次啓動隨機端口，不能跨重啓當備份 |
| 對話 | Harness Session 存儲 | 轉錄與運行狀態；任務只存 sessionId |
寫入在 Host 內串行、原子（tmp + rename），按任務 id 合併（較新的 updatedAt 優先）併合並刪除墓碑；客戶端約每 2.5 秒輪詢，寫前防抖 400 ms 會先 reconcile。風險： 僅一份主文件加一份備份，無版本歷史；請把 state.json 納入日常備份。刪除整個 ~/.dsh 會丟失看板數據，但不影響已有 Session 對話。
開發時：瀏覽器半可通過刷新重載；改 Host 半（src/index.js）需重啓應用。勿在生產環境盲目 git clone 替代正式 bundle 安裝，除非你在做插件開發並已按 README 說明鏈接到 profile。
適用場景¶
- 在同一 workspace 裏並行多條 Agent 任務，需要列狀視圖區分「還沒開始 / 正在跑 / 已完成」。
- 希望多條相關步驟共用一條長 Session，而不是任務一切就新開頁。
- 需要在不離開當前頁面的情況下，通過浮層和鍵盤快速切換任務與對話。
若你只偶爾單 Session 對話、不需要任務層與看板 UI，可以不裝；若你依賴 DSH 低於 0.2.2 的舊插槽佈局，需先升級 Harness 再安裝。
結尾¶
dsh-board 在 Session -centric 的 Harness 上補了一層 per-workspace 任務看板：列管任務、角標管 Session、詳情裏是原生對話。社區插件目錄與 DeepSeek / 幻方無官方從屬關係，安裝與升級以目錄頁與倉庫說明爲準。
- 目錄頁：https://www.skillhub.cn/plugins/lihuu/dsh-board
- GitHub：https://github.com/lihuu/dsh-board
- 維護者：lihuu · 許可證：MIT · 當前包版本：1.0.0
