前言¶

用 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。