前言¶
在 DeepSeek Harness（DSH）裏跑複雜需求時，常見做法是單會話裏堆指令、靠人工盯工具調用和進度。任務一多，就難以拆清依賴、並行執行，也缺少統一的驗收與返工閉環。卡片工坊（dsh-card-workbench）是社區維護的工作流類插件：把需求拆成多張可驗收的任務卡，在 Host 側派單、盯辦、處理卡頓並逐張覈對，也可選擇把已有工作對話接管成卡片組統一看進度。下面介紹它是什麼、能做什麼，以及如何安裝與使用。
這是什麼¶
卡片工坊面向「交辦整段工作」和「把 Harness 裏已有工作對話納入看板」兩類場景。維護者在 GitHub 上的倉庫爲 xiaoxue-car/dsh-card-workbench，上游開發倉庫在 Gitee（見 README）。插件分類爲工作流；簡介爲：Card-based task orchestration for DeepSeek Harness——拆卡、觀察執行、處理停滯、驗證結果，並可將工作對話納入編排。
實現上不引入第三方運行時、無需構建，只依賴 Harness Host 服務、Node 內置模塊與默認模型；同一份目錄可裝到任意 profile、任意工作區，支持 Windows / macOS / Linux。package.json 中聲明的 DSH 引擎範圍爲 >=0.2.1-rc.2 <0.3.0-0，許可證爲 MIT。
界面與啓用方式¶
啓用插件後，左側原生側邊欄會被隱藏，工作區切換爲全寬卡片工坊（任務卡、交辦區、管家設置、可接管對話列表）；禁用後原生布局立即恢復。頂部「卡片工坊」按鈕內嵌開關：勾選則插件運行，取消則關閉相關頁面與入口；若需再次啓用，可在 Harness「設置 → 插件」中重新打開 dsh-card-workbench。
打開面板：Ctrl/Cmd+Shift+B，或點擊輸入框右側的「卡片工坊」。
核心功能¶
交辦工作（默認模式）¶
- 用默認模型拆卡，一般拆出 2–6 張（上限由
maxCards控制，默認 6）。 - 每張卡開獨立執行會話，攜帶任務與驗收標準。
- Host 監聽執行會話；長時間無進展時可自動催辦、中斷、續跑（閾值與次數見配置）。
- 卡片結束後進入覈對隊列；不通過則退回返工。
- 全部完成後做整體終審，發現缺口可自動補卡。
工作目錄在交辦時必選；目錄樹懶加載，選中文件夾即定爲工作目錄。若目錄不在現有工作區，會自動註冊新工作區。全局併發由所有項目共享，按最久未派單優先輪轉。執行心跳在 Host 進程 lib/executor.js 中運行，不依賴頁面是否打開——關閉瀏覽器不會暫停已在跑的任務。
接管工作對話（默認關閉）¶
在「管家設置」中開啓「自動接管對話」後，會掃描已有與新建的工作對話，把每個 turn 變成卡片：同一輪多條用戶消息會合並；記錄請求、工具調用、執行結果與覈對結論；一輪結束後可自動覈對，缺口作爲覈對消息發回原對話。可按全部 / 交辦 / 對話組篩選，逐個暫停、繼續、催辦、覈對或移出管家。接管對話默認不提升權限（見下文 fullAccess）。
| 開關 | 默認 | 說明 |
|---|---|---|
| 自動接管對話 | 關 | 開啓後才掃描並接管 |
| 新對話自動跳轉 | 開 | 新對話被接管並收到首條工作請求時跳到卡片頁 |
| 對話完成自動覈對 | 開 | 每輪結束自動覈對，有問題回原對話補齊 |
| 卡頓自動催辦 | 開 | 長時間無進展時自動催辦/續跑 |
開關保存在看板數據中，重啓後保留。
看板與卡片¶
- 時間軸按時間倒序展示節點，可展開查看交付、缺口與對話；「打開對話」進入對應執行會話。
- 任務卡內可直接對話，無需單獨開會話窗口；對話組也有獨立輸入框，新問題會作爲新任務卡進入時間軸。
- 支持依賴 DAG、優先級、並行執行與獨立覈對隊列；看板只展示狀態，不支持拖拽繞過驗收。
- 失敗卡片可點「忽略」，狀態變爲「已忽略」，不再計入失敗數且不繼續重試。
- 可按工作區摺疊；超過 1 天無真實活動的區塊移入「歷史工作區」。
客戶端狀態在插件 apply 時啓動，對話頁、工坊頁、市場頁共享；全局熱路徑輪詢 /api/pulse，完整快照僅在工坊頁可見時加載。
安裝與啓用¶
官方 README 未給出 dsh plugin add 一類遠程一鍵命令，安裝方式爲本地目錄安裝：
- 將整個插件目錄（README 中寫作複製整個
dsh-butler目錄；倉庫名爲dsh-card-workbench）複製到目標機器，不需要node_modules，不需要構建。 - 打開 Harness「設置 → 插件」，選擇安裝本地目錄。
- 確認
dsh-card-workbench爲啓用狀態，安裝結果應爲application: applied。 - 刷新一次 Web 頁面。
- 用快捷鍵或「卡片工坊」入口打開面板。
安裝前建議閱讀倉庫源碼與 MIT 許可證；插件以當前 DSH 進程權限運行，顯式開啓最高權限時需自行評估風險。
典型用法¶
- 在「交辦工作」中粘貼完整需求，選擇工作目錄。
- 點擊「拆解開工」，或直接按
Enter（Shift+Enter換行）。 - 等待拆卡、派單、跟蹤與覈對；展開任務卡查看進度，需要時「打開對話」進入執行會話。
- 若希望把日常在 Harness 裏的工作對話也納入看板，在管家設置中打開「自動接管對話」，再按需篩選與管理各對話組。
參數可在卡片工坊右上角 ⚙ 參數設置 中修改中文項並保存，也可在「設置 → 插件 → 卡片工坊」配置頁修改同一表單。保存後立即作用於調度、拆卡、覈對、卡頓判斷和模型調用。
配置與數據位置¶
設置寫入：
$DSH_HOME/.dsh-butler/settings.json
未設置 DSH_HOME 時，看板數據默認在：
~/.dsh/.dsh-butler/board.json
Windows 爲 %USERPROFILE%\.dsh\.dsh-butler\board.json。看板只保存編排狀態；執行者的真實工作記錄在各自 Harness 會話中。Host 重啓後運行中的工作會暫停，點「繼續」可從原會話續跑；已接管對話在啓動後會重新掃描並恢復。
profile 插件行 config 可作爲初始值，設置頁保存的值會覆蓋對應字段。常用參數示例：
| 參數 | 默認 | 說明 |
|---|---|---|
maxCards |
6 | 拆卡上限 |
maxConcurrency |
4 | 全局執行槽位（硬上限 8） |
stallMs |
600000 | 無進展判定卡頓（10 分鐘） |
fullAccess |
false | 爲 true 時執行會話使用最高權限 |
provider / model |
默認模型 | 拆卡/覈對所用模型 |
dataDir |
$DSH_HOME/.dsh-butler |
看板數據目錄 |
默認 fullAccess: false 時保留會話原有權限；只有設爲 true 才切到最高權限，此時執行者可修改工作目錄之外的任何文件，請明確開啓後再用。
適用場景與注意¶
適合需要把大需求拆成可驗收步驟、希望 Host 側自動盯卡頓與覈對、或希望把多條工作對話統一納入看板的 DSH 用戶。不適合期望完全保留原生側欄佈局的使用方式——啓用期間側欄會被 CSS 持久隱藏，僅卸載或關閉插件後恢復。
DSH 生態理念是「一切皆插件」；社區目錄站點（如 SkillHub 插件頁）與 DeepSeek / 幻方無官方從屬關係，安裝與配置請以倉庫 README 爲準。
問題與建議可發郵件至 README 公佈的 2075638176@qq.com，標題建議帶上 dsh-card-workbench 或「卡片工坊」。
結尾¶
卡片工坊把 Harness 裏的「一整段活」變成可並行、可覈對、可接管的卡片工作流，執行與心跳落在 Host，頁面主要承擔觀察與交辦。若要查看分類與簡介，可打開 SkillHub 目錄頁；源碼與完整說明見 GitHub 倉庫。
