DeepSeek Harness 專注於會話和聊天交互，擅長思考，但在長期維護操作真相方面較弱。dsh-codex-kanban 插件爲 Harness 提供了一個持久化的可視化看板。它不構建獨立的聊天界面，而是通過原生工具讓 Harness 聊天讀取和更新卡片，同時集成 Codex 作爲官方子代理。
插件概況¶
- 名稱：dsh-codex-kanban
- 作者：sonozaki7
- 類別：工作流
- 許可證：MIT
該插件將卡片存儲在本地 JSON 文件中，而非瀏覽器存儲。它集成了 Codex 官方子代理，提供工具化操作接口，支持狀態流轉、證據追蹤以及本地運行與安全綁定。
安裝與前置條件¶
安裝前請確保滿足以下環境要求：
* Node.js 版本 >= 22.19
* 已認證的 Codex CLI
* DeepSeek Harness 環境
僅管理員需要執行一次安裝命令。安裝完成後，需重啓 DSH web 配置文件。
dsh plugin --profile web add github:sonozaki7/dsh-codex-kanban
核心功能¶
狀態流轉管理¶
插件明確定義了任務狀態流轉路徑：
* backlog：值得記住但未準備好開始。
* ready：上下文和驗收標準足夠。
* running：有人或代理正在積極工作。
* review：工作已完成但未驗收（需證據證明）。
* done：標準已滿足且有證據。
* blocked：存在具體阻礙，進入此狀態並附帶原因。
工具化操作¶
插件向 DeepSeek 代理註冊了以下工具：
* kanban：支持 list, create, update, move, evidence, delete。
* kanban_codex：將現有任務委託給 Codex 子代理執行。
重要字段包括 project, status, owner, acceptance_criteria, blocked_by, evidence_text, evidence_url。
證據與安全性¶
- 證據追蹤：驗收標準、阻礙項、執行報告和驗證證據都保存在卡片上。
- 本地運行：儀表板綁定到
127.0.0.1:4317，數據寫入本地文件~/.dsh/codex-kanban/board.json。 - 權限控制：數據文件僅允許所有者寫入，拒絕來自外部瀏覽器的未授權修改。
使用流程¶
安裝完成後，日常使用主要爲可視化操作：
- 打開工作臺：在瀏覽器訪問
http://127.0.0.1:4317。 - 創建卡片：選擇“Create my first card”，描述預期結果和驗收標準。
- 準備工作：將卡片移動到
Ready狀態。 - 轉發任務：點擊卡片上的“Open in Harness”按鈕。插件會複製卡片的結構化任務消息並打開官方 Harness UI。
- 執行任務：在 Harness 中粘貼併發送準備好的消息。DeepSeek 可以更新同一張卡片，並在適當時候使用 Codex 內部執行代碼。
注意事項¶
- Codex 執行結果：Codex 工作完成後默認進入
review狀態，而非done。必須有人工或代理檢查並附加證據後，狀態才能流轉至done。 - 依賴項：插件依賴
@deepseek-ai/dsh-subagent-codex和@deepseek-ai/schemastery。 - 操作模式：在桌面端支持拖拽卡片，在移動端或鍵盤操作下使用卡片底部的狀態菜單。
生態背景¶
DeepSeek Harness 理念爲「一切皆插件」。本插件在本地運行，不依賴雲任務服務暴露項目上下文，適合需要在多個倉庫和 AI 聊天間切換、並希望 DeepSeek 協調而 Codex 處理邊界代碼工作的場景。
