前言¶
用 DeepSeek Harness（DSH）这类智能体工作台写代码，模型完成任务的速度很快，问题在于改完之后质量如何：多数时候只能靠人工再开一遍编辑器，或者在系统提示词里写一段「请顺便检查代码」——结果是报告格式不固定、没有量化分数，审查记录也留不下来。
下面介绍的 Mingxi2077/dsh-plugin-review 把这件事做成了插件：对项目或代码做多维度健康评分，用程序生成的 SVG 雷达图展示结果，审查历史带分类、分页和回收站，并且支持 AI 在完成模块后主动触发审查。
这是什么¶
dsh-plugin-review 是一个 DSH 插件，运行在 dsh web 端（client platform 为 web），作者是 Mingxi2077，许可证为 MIT。它的定位一句话可以说清：把 DSH 变成一个自带代码质量审查纪律的工作台——评分是程序化指标，不依赖模型的主观描述。
插件需要 DeepSeek Harness 0.1.0-rc.6 及以上版本（依赖 Cordis 注入规范和客户端 __ModuleLoader__ 注册规范），支持 Windows / macOS / Linux，Windows 下无 HOME 环境变量时会回退到 USERPROFILE 路径。
核心功能¶
插件的能力分几块：
1、审查模式开关。输入框 + 号旁有一个「审查」按钮，开启后输入项目路径或直接粘贴代码即可审查。
2、AI 主动审查。插件会注入系统守则，AI 在完成一个任务、一个模块或一轮修复后，主动调用 review_audit 工具；发现 error 级问题或分数低于及格线时，会主动修复并复查。
3、8 维健康评分。结构、可维护性、一致性、健壮性、测试、文档、性能、安全，全部是程序化指标。
4、程序生成 SVG 雷达图。对话内的审查结果卡和审查历史弹窗都会实时渲染，雷达图由 RadarChart 组件纯 SVG 生成，没有外部图表依赖。
5、审查历史。支持按时间、项目、成绩分类，支持分页、删除，删除的记录先进回收站，默认保留 7 天，过期自动清除。
6、导出与统计。可以导出 CSV、查看项目统计、一键重审。
7、设置页配置。维度开关、及格线、扫描上限/深度、忽略目录、回收站天数都可以在「设置 → 审查」里调整。
安装与启用¶
推荐用 GitHub 源安装，执行下面这条命令，然后重启 dsh web 并刷新页面：
dsh plugin --profile web add "github:Mingxi2077/dsh-plugin-review#main"
如果本地有源码，也可以从目录安装：
dsh plugin --profile web add /path/to/plugin-review
卸载用对应的 remove 命令，或从 web profile 的 bundles 移除条目后重启：
dsh plugin --profile web remove plugin-review
典型用法¶
安装并重启 dsh web 之后，按下面的步骤走一遍：
1、输入框左下出现「审查」按钮，点击开启审查模式，输入框上方会出现横幅。
2、输入要审查的目标，例如 审查 /path/to/project，或者直接粘贴代码。
3、发送后模型调用 review_audit，对话中出现雷达图评分卡和审查报告。
4、不点按钮也行：AI 会在模块完成时主动触发审查；或者在对话里说「审查」「评测」也会触发。
有两点使用细节需要注意：review_audit 需要绝对路径，审查单文件时请用 text 参数粘贴代码；雷达图不显示时，先确认已重启 dsh web 并做了硬刷新（Ctrl+F5）。
配置与数据落盘¶
设置页可配置的项及默认值如下：
| 配置项 | 说明 | 默认 |
|---|---|---|
| 评分维度 | 参与评分的 8 个维度开关 | 全部开启 |
| 及格线 | 综合分 ≥ 此值视为通过 | 60 |
| 扫描文件上限 | 最多扫描的文件数 | 300 |
| 目录深度上限 | 递归扫描的最大深度 | 4 |
| 忽略目录 | 扫描时跳过的目录（逗号分隔） | node_modules, .git, dist 等 |
| 回收站保留天数 | 删除的审查记录可恢复天数（0 = 立即删除） | 7 |
配置和历史数据都落在 $DSH_HOME 下：review-config.json 存配置，review-history.json 存审查历史（最多 50 条，删除该文件会清空历史），review-trash.json 存回收站，按保留天数过期清除。
对目标项目，扫描只读取文件前 40KB 做统计，不写入、不修改任何内容；对话 URL 只存审查发生时的会话 ID，不存内容。
实现方式¶
插件分两部分：Node half（lib/index.mjs）实现 review_audit 工具、扫描评分逻辑和 /api/review/* 接口，遵循 rc.6 的注入规范，注入 webServer、tools、systemPrompt；Browser half（lib/index.js）通过 window.__ModuleLoader__.load({ id, factory }) 注册外壳，实现审查按钮、横幅、设置页、雷达图、历史和回收站界面。
路线图上还有几个未完成的计划：审查报告导出为 Markdown/JSON、按项目平均分的趋势图、重审结果的新旧分数对比视图。
适用场景与注意¶
这个插件适合把 DSH 当日常写码工作台、希望每次改动都有量化审查记录的开发者，尤其是想让 AI 在交付模块时自觉走一遍「审查—修复—复查」流程的场景。
安装前请注意：插件以当前 dsh 进程的权限运行，扫描会读取目标项目文件，安装前应检查源码与许可证。该项目使用 MIT License，与 DeepSeek 官方无关联，插件名称和描述仅供社区分发使用。
结尾¶
简单回顾：dsh-plugin-review 用程序化指标和雷达图把「代码质量」变成可量化、可留档、可复查的流程，补上了智能体写码工作台里容易缺的那一环。插件页面在社区目录 skillhub.cn：https://www.skillhub.cn/plugins/Mingxi2077/dsh-plugin-review ，源码在 GitHub：https://github.com/Mingxi2077/dsh-plugin-review 。
