前言¶
DeepSeek Harness（DSH）的核心设计理念是“一切皆插件”。通过在 DSH profile 中挂载不同的 bundle，开发者可以扩展命令行或 Web UI 的功能。dsh-command-code-review 是一个基于 DSH slash-command 的代码审查插件，它旨在为 Pull Request 和本地代码提供自动化的审查能力。
插件简介¶
该插件由 JasonFreeLab 维护，采用 MIT 许可证。它是一个独立的插件包，安装后会在 DSH profile 中注册 /code-review 命令。其核心价值在于将复杂的代码审查流程封装为可配置的透镜，并提供置信度与严重程度的评分机制，帮助开发者快速定位代码问题。
核心功能¶
-
双模式运行
- PR 模式：通过
/code-review 123或 PR URL 进行审查，结果会通过 GitHub CLI 自动回复到 Pull Request 中。 - 本地模式：通过
/code-review review src/auth或空参数审查当前代码库。
- PR 模式：通过
-
可配置审查透镜
- 默认包含 5 个透镜：
guidance（AGENTS.md/CLAUDE.md 合规性）、bugs（错误与正确性）、history（历史上下文）、security（安全性）、comments（注释合规性）。 - 支持启用可选的
perf（性能）透镜。
- 默认包含 5 个透镜：
-
评分机制
- 对发现的问题进行去重，并分别打分：置信度（区分误报）和严重程度（Blocker/Major/Minor/Nit）。
- 支持设置置信度阈值（默认 80），低于该分数的发现会被过滤掉。
-
报告输出
- 本地审查会生成结构化的 Markdown 报告。
- 伴随生成 JSON 格式的机器可读侧车文件。
- 支持自定义报告输出目录。
安装与前置条件¶
在安装前，请确保你的 DSH profile 基于 @deepseek-ai/dsh-base，并且已安装并认证了 GitHub CLI (gh)（仅 PR 模式需要）。
安装命令如下：
dsh plugin --profile web add dsh-command-code-review
安装完成后，需要重启或重新加载 profile 以使命令生效。
使用方法¶
在 DSH Web UI 的 composer 中输入 /code-review 即可使用。以下是几种典型的调用方式：
# 通过 PR 编号审查
/code-review 123
# 通过 PR URL 审查
/code-review https://github.com/owner/repo/pull/123
# 审查本地指定路径
/code-review review src/auth
# 审查整个项目
/code-review review the whole project
# 审查当前未提交的更改
/code-review
# 指定输出目录
/code-review review src/auth --out reports
/code-review --out docs review src/auth
空输入会首先探测当前分支的 Open PR，若没有则回退审查未提交更改。
配置项¶
插件支持在 profile 的 cordis.patch.yml 中进行配置。
- 置信度阈值
设置低于此分数的发现将被丢弃。
- id: command-code-review
config:
threshold: 90
- 报告输出目录
设置本地审查报告的默认保存位置（默认doc）。
- id: command-code-review
config:
outputDir: reports
- 审查透镜选择
选择启用的透镜集合。
- id: command-code-review
config:
lenses: [guidance, bugs, security]
- 自适应透镜
默认开启（autoLenses: true）。当审查范围涉及安全敏感文件时自动启用security透镜；涉及热路径时自动启用perf透镜。
注意事项¶
- 代码链接：GitHub 上的代码链接渲染需要完整的 Commit SHA 和行号范围（格式：
#L[start]-L[end]）。 - GitHub CLI：若未安装或未认证
gh，PR 模式无法自动回复评论。 - 文件命名：本地报告文件名在 Git 仓库中会包含当前 HEAD 的短 SHA（
code-review-<sha7>-<slug>.md）。
结语¶
dsh-command-code-review 为 DSH 生态提供了一个标准化的代码审查入口。通过配置透镜和阈值，它可以将 LLM 的分析能力转化为具体的开发工作流，适合需要严格把控代码质量的团队。更多细节可参考插件目录：https://www.skillhub.cn/plugins/JasonFreeLab/dsh-command-code-review 或源码：https://github.com/JasonFreeLab/dsh-command-code-review。
