前言¶
在 DeepSeek Harness（DSH）里写代码、改文件时，主会话里的智能体往往已经带着上下文在干活；若再让同一条对话「顺便 code review」，审查意见容易和实现步骤缠在一起，也不利于你单独决定是否采纳。社区插件 dsh-code-review（维护者 SeanTolstoyevski，GitHub 仓库 SeanTolstoyevski/dsh-code-review）的定位是：在 Harness 会话里用 /review 触发一次独立审查，由 reviewer 模型审计工作区未提交改动，并把报告以卡片形式出现在对话中——默认不告知主 agent、不读入其上下文、也不自动改代码。
这是什么¶
一句话：On-demand code review for DeepSeek Harness——按需代码审查。分类上常归在「模型推理」：审查本身由配置的 reviewer 模型完成。包名为 @local/dsh-code-review，当前资料中的版本为 1.5.0，许可证 MIT；纯 JavaScript bundle，无额外 npm 依赖。
核心功能¶
审查命令与范围¶
在目标会话中输入 /review，默认对仓库相对 HEAD 的全部未提交改动运行，内置模式为 cr（针对变更行）。可选 arc，从变更「形状」做架构向审查；还可在设置文件的 modes 下自定义模式（角色、finding 字段、严重级别词汇、运行预设等）。
命令支持多种参数，例如限定本会话改动的文件、指定模式与模型、忽略路径、附加 focus 消息等。reviewer 不会读取会话 transcript；focus 消息是你写给 reviewer 的唯一自定义文本。
两种内置模式与可扩展 modes¶
| 模式 id | 含义（资料原文） |
|---|---|
cr |
reviews the changed lines |
arc |
reviews the shape of the change |
未解析的 mode=、reasoningEffort= 等会在调用模型前被拒绝，并列出可用名称。
中断仍可用的审查结果¶
reviewer 在每条 finding 落定后立即记录。流中断、超时、取消或模型未跑完时，已记录内容仍会交付，并标记为 incomplete，而不是整份丢失。
与主 agent 隔离（默认）¶
默认情况下：主 agent 不知道审查发生、审查内容不进入其上下文、也不会因审查自动改代码。例外：开启 projectAccess 时，reviewer 通过 Harness 自带工具读项目，Harness 会将这类访问计为主 agent 曾触碰相关文件，可能影响后续 instruction 文件——审查报告本身仍不会进入 agent。
报告卡片与证据校验¶
对话中出现一张卡片：标题随 mode，摘要与 verdict 芯片按模式词汇展示，每个 finding 按该 mode 声明的字段分块。Copy report 复制整份 Markdown；Copy 复制单条 finding。每条 finding 会引用证明它的代码行，并与 diff 及 reviewer 实际读过的文件核对；站不住脚的 claim 以 withheld 列出原因，而非直接发布。卡片仅展示与复制，没有会把内容发回 agent 的控制项。
尚未发送会话首条消息时，Harness 不绘制 transcript，/review 也不会开启新 turn，卡片先出现在 composer 上方，会话开始后再移入 transcript，并显示该会话最新一次 /review 的结果（含错误）。
安装与启用¶
插件是 DeepSeek Harness profile 的 bundle，安装时不编译、不拉依赖。
- 在会话中通过 bundle 安装器安装，或使用 Web UI 的 plugin manager 粘贴仓库 URL 安装。资料中的安装目标为：
plugin_manager
action: install_bundle
target: github:SeanTolstoyevski/dsh-code-review
若从本地目录安装，将 target 换为该目录的绝对路径即可（与 clone 后安装等价；本文不展开 clone 步骤）。
-
重启
dsh web。替换包后需重新生成模块才能加载 JavaScript；首次启动会写入DSH_HOME/code-review/config.json（含全部设置与两种内置模式的默认值）。 -
刷新页面（客户端半部分按页拉取一次）。
-
在需要被审查的会话里输入
/review。
安装与运行发生在本机 DSH 进程权限下；安装前请自行查看仓库源码与 MIT 许可证，确认符合你的安全与合规要求。
典型用法¶
完整命令形式（资料原文）：
/review [full|session] [mode=<id>] [provider=<id>] [model=<id>] [reasoningEffort=<id>]
[language=<code>] [gitRev=<rev>] [source=auto|git|session] [ignored=<pattern,…>]
[ignoreDefaults=<bool>] [respectGitIgnore=<bool>] [focus message]
常见示例：
| 示例 | 作用 |
|---|---|
/review |
相对 HEAD 的全部未提交改动，cr 模式 |
/review mode=arc |
同一变更集，架构向 arc 模式 |
/review session |
仅本会话写入或编辑的文件 |
/review ignored=fixtures/,!dist/ |
忽略 fixtures/，仍审查 dist/ |
/review reasoningEffort=max |
使用 provider 最高 thinking 档位 |
/review session Thoroughly review the a/b/c.go file. |
参数之后为 focus message |
更细的 modes、配置键、忽略规则、运行流程与 finding 语义见仓库内 docs/reference.md 各章节（Modes、Configuration、Ignored paths、How a run works、Findings、The card、Limits 等）。
适用场景与注意¶
适合谁：已在 DSH Web 里用 Harness 改代码、希望在同一界面拿到独立、可拷贝审查报告、且默认不想让主 agent 被审查结果「带跑」的开发者。
注意：
- 审查依赖你配置的 reviewer provider/model；无效名称会在跑模型前失败并提示可解析项。
- 插件以当前 dsh 进程权限运行；
projectAccess会改变 reviewer 读项目的方式及对 instruction 文件的间接影响，启用前请读配置文档。 - 社区目录 skillhub.cn 插件页 与 DeepSeek / 幻方无官方从属关系，DSH 生态强调「一切皆插件」，本文事实以 GitHub README 与 package 元数据为准。
结尾¶
经过上面的步骤，你可以在 Harness 会话里用 /review 对未提交改动做按需审查，在卡片里阅读经证据门控的报告并自行决定是否修改。仓库与说明：GitHub — SeanTolstoyevski/dsh-code-review；目录索引：skillhub.cn/plugins/SeanTolstoyevski/dsh-code-review。
