前言¶

用 DeepSeek Harness（DSH）做智能體開發時，需求往往散落在 Markdown 或聊天記錄裏，Git 提交、評審和工作樹又要在 IDE 與終端之間來回切。社區插件 dsh-devbench-plugin（維護者 CHAAAAA）把需求、項目文檔、提交、AI 提交信息、代碼評審、工作樹、後臺任務與週報收進一個側邊欄工作臺，並以 DSH workspace 作爲項目來源。下面介紹它是什麼、能做什麼，以及如何安裝與上手。

這是什麼¶

dsh-devbench-plugin 是 DSH 的客戶端類插件：在 Web 客戶端注入側邊欄與會話 UI，與宿主協同讀寫工作區數據。包名 dsh-devbench-plugin，當前資料中的版本爲 1.0.8，許可證 MIT，兼容 DSH >=0.2.1-rc.3 <0.3.0-0，需要 Node.js >=24.9.0（由插件引擎聲明，安裝時以你本機 DSH 環境爲準）。

插件目錄頁：https://www.skillhub.cn/plugins/CHAAAAA/dsh-devbench-plugin（社區目錄站點，與 DeepSeek / 幻方無官方從屬關係）。源碼：https://github.com/CHAAAAA/dsh-devbench-plugin。

核心功能¶

項目工作臺與會話側邊欄¶

主界面爲主從佈局：左側項目樹，右側詳情，頁籤包括概覽、需求、文檔、提交、工作樹、評審與任務，並提供麪包屑與視圖歷史。

在某個項目的會話裏，可通過會話頭部「打開需求」按鈕右側下拉選擇「打開 DevBench」，或在右側邊欄「開始」頁點擊 DevBench 卡片，在右側邊欄打開當前項目的工作臺內容（與會臺右側一致）。可隨時切回完整工作臺；右側邊欄佈局按會話記憶。無法映射到項目的會話（例如子代理會話、未歸入工作區的會話）會顯示明確空態。在 設置 → 界面 可開啓「在項目會話中自動展開 DevBench 側欄」（默認關閉，每個會話最多自動展開一次）。

需求與文檔¶

需求按工作區保存爲 Markdown，包含標題、狀態、正文、資料文件、關聯會話與關聯提交。列表支持「標題 / 全文」兩檔檢索；支持草稿恢復、離開攔截與保存衝突處理。「討論需求」可爲需求新建關聯會話，與 Agent 澄清並完善正文；討論提示詞可在設置頁調整。

項目「文檔」頁籤用於發佈流程、常用提示詞等，以 Markdown 保存在需求根目錄下該項目目錄的 .documents/ 中，不會進入項目 Git 倉庫。需求與文檔編輯均帶 Markdown 實時預覽（含 GFM 表格對齊）。

需求可星標收藏並用「僅收藏」篩選。從需求可一鍵創建會話併發送模板化提示詞，成功後自動關聯並打開會話；可爲需求啓用按需求 Git worktree（分支 devbench/<需求ID>）。

Git、AI 提交與評審¶

項目「概覽」展示未提交變更，支持手動提交、拉取（--ff-only）與推送（自動建立 upstream）。AI 提交由後臺 Agent 生成中文 Conventional Commit 信息，確認預覽後提交；不會自動 push，提交提示詞模板可在設置頁修改。

代碼評審可對任意提交發起（完整提交消息、變更文件樹與逐文件差異），也可評審當前未提交變更；評審文件寫入 .dsh-reviews/。

工作樹、任務、主頁與 MCP¶

工作樹列表爲三態（已創建 / 目錄缺失 / 已啓用未創建），支持創建、查看改動、AI 提交、推送、用 VS Code / 終端 / 文件管理器打開、複製路徑與分支、清理殘留註冊以及刪除（保留分支）。

任務中心查看提交、評審、需求相關後臺任務的狀態，支持取消、重試與打開會話。主頁聚合跨項目的最近任務與未完成任務、本地生成的週報，以及當前 DSH profile 的 MCP 服務概覽。

MCP 服務管理可查看、添加、修改、啓用/禁用或刪除當前 profile 的 MCP 條目；修改寫入該 profile 的 cordis.patch.yml 並自動備份，疑似密鑰以掩碼顯示。

插件啓動時會檢查 npm 上的最新版本；有新版本時插件頁右上角顯示升級按鈕，經當前 profile 的包管理器覆蓋安裝最新版，重啓 DSH 後生效。

會話關聯與 Agent 工具¶

會話頭部「打開需求」：已關聯則打開需求，未關聯則進入關聯選擇頁。下拉還提供「整理爲需求」（把當前會話內容整理爲新需求）與「打開 DevBench」。

宿主向 Agent 暴露 7 個工具：requirement_read/update/list/create、project_commit_propose/git_show/review_write，用於讀寫需求、從會話創建需求，以及處理提交信息與評審。

安裝與啓用¶

插件以當前 DSH 進程權限運行，安裝前建議瀏覽源碼與 LICENSE，確認符合你的安全與合規要求。

DSH 插件頁（推薦）¶

1. 打開 DSH 的「插件」頁（部分版本在「設置 → 插件」）。
2. 點「添加插件」。
3. 輸入包名與精確版本：dsh-devbench-plugin@1.0.8。
4. 等待安裝完成，點「立即啓用」。
5. 若提示需要重啓，完全退出並重新打開 DSH（不要只關窗口）。

CLI¶

dsh plugin --profile web add dsh-devbench-plugin@1.0.8

離線 tarball¶

dsh plugin --profile web add /絕對路徑/dsh-devbench-plugin-1.0.8.tgz

請保留 tarball 原文件：profile 依賴會記錄其 file: 絕對路徑。

典型用法（首次使用）¶

資料中的推薦順序如下。

1. 打開 設置 → 需求根目錄，選擇或新建用於保存需求與文檔數據的目錄。
2. 打開側邊欄 DevBench，添加本地 Git 倉庫作爲項目，在對應頁籤中使用概覽、需求、文檔等功能。
3. 之後在項目會話裏，用會話頭部下拉「打開 DevBench」，或右側邊欄 DevBench 卡片打開該項目工作臺；需要自動展開時，在 設置 → 界面 打開對應開關。

適用場景與注意¶

適合在 DSH 內長期維護多個本地 Git 項目、希望需求與會話、提交、評審在同一界面閉環的開發者。需求與 .documents/、.dsh-reviews/ 等數據路徑由「需求根目錄」與項目配置決定，與倉庫內容分離的部分不會隨 git push 上傳，需自行備份需求根目錄。

DSH 生態理念是「一切皆插件」；本插件爲社區維護的客戶端擴展，版本與星標以目錄頁與 GitHub 爲準（資料中 GitHub 星標爲 0）。升級、link 本地開發副本等行爲見 README「版本與升級」一節。

結尾¶

dsh-devbench-plugin 把項目工程管理收進 DSH 側邊欄與會話流，減少在聊天、Markdown 與 Git 工具之間切換的成本。進一步瞭解可訪問插件目錄頁 https://www.skillhub.cn/plugins/CHAAAAA/dsh-devbench-plugin 與倉庫 https://github.com/CHAAAAA/dsh-devbench-plugin。