Mingxi2077/dsh-plugin-review

DSH 审查模式（plugin-review）

把 DeepSeek Harness 变成一个自带代码质量审查纪律的工作台：对项目/代码做多维度健康评分（程序化指标 + 雷达图可视化），支持手动触发、对话指令触发，以及 AI 在模块/任务完成后主动触发审查。

review license version

特性

- 🔍 审查模式开关：输入框 + 号旁的「审查」按钮，开启后输入项目路径或粘贴代码即审
- 🤖 AI 主动审查：注入系统守则——AI 在完成一个任务/模块/一轮修复后主动调用 review_audit，发现 error 级问题或低于及格线时主动修复并复查
- 📊 8 维健康评分（程序化指标，非纯主观）：结构 / 可维护性 / 一致性 / 健壮性 / 测试 / 文档 / 性能 / 安全
- 📈 程序生成雷达图：对话内审查结果卡 + 审查历史弹窗，SVG 雷达图实时渲染
- 🗂 审查历史：分类（时间 / 项目 / 成绩）、分页、删除、回收站（默认保留 7 天，可配置，过期自动清除）
- 📤 导出 CSV / 项目统计 / 一键重审
- ⚙️ 设置页配置：维度开关、及格线、扫描上限/深度、忽略目录、回收站天数

兼容性

- DeepSeek Harness 0.1.0-rc.6+（Cordis 注入规范 + 客户端 __ModuleLoader__ 注册规范）
- 平台：Windows / macOS / Linux（扫描逻辑跨平台；USERPROFILE 路径回退适配 Windows 无 HOME 的场景）
- 扫描会读取目标项目文件（前 40KB/文件）做统计，不修改目标项目任何内容

安装

方式一：GitHub 源（推荐）

dsh plugin --profile web add "github:Mingxi2077/dsh-plugin-review#main"
重启 dsh web，刷新页面

方式二：本地目录

在有源码时
dsh plugin --profile web add /path/to/plugin-review
或手动：把目录放入 profile 的 node_modules，并在 web profile 的
dsh.profile.bundles 加入 "plugin-review"，然后重启 dsh web

卸载

dsh plugin --profile web remove plugin-review
或从 web profile 的 bundles 移除对应条目，重启

快速开始

1. 重启 dsh web 后，输入框左下出现 「审查」 按钮
2. 点击开启审查模式（输入框上方出现横幅）
3. 输入要审查的目标，例如：审查 /path/to/project 或直接粘贴代码
4. 发送后模型调用 review_audit → 对话中出现雷达图评分卡 + 审查报告
5. 不点按钮也行：AI 会在模块完成时主动触发；或对话里说"审查/评测"也会触发

配置

设置页 设置 → 审查 可配置（持久化到 $DSH_HOME/review-config.json）：

| 配置项 | 说明 | 默认 |
|---|---|---|
| 评分维度 | 参与评分的 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（仅存 ID，不存内容）。

常见问题

- 雷达图/历史不显示：确认已重启 dsh web 并硬刷新（Ctrl+F5）；历史记录在 $DSH_HOME/review-history.json，删除该文件会清空历史。
- 审查报"路径不存在"：review_audit 需要绝对路径；审查单文件请用 text 参数（粘贴代码）。
- 设置保存无效：Windows 下需确保 $DSH_HOME 可写；保存后设置页会回显新值。
- 回收站记录消失：超过保留天数会被自动彻底删除（读取时惰性清理）。

开发

plugin-review/
├── package.json          # bundle 插件声明（dsh.bundle）
├── cordis.patch.yml      # 组合插入行（id: plugin-review）
└── lib/
├── index.mjs         # Node half：review_audit 工具 + 扫描评分 + API（/api/review/*）
└── index.js          # Browser half：审查按钮/横幅/设置页/雷达图/历史/回收站

- Node half 遵循 rc.6 注入规范（inject: ['webServer','tools','systemPrompt']，服务用 ctx.get 安全读取）
- Browser half 使用 window.__ModuleLoader__.load({ id, factory }) 注册外壳（require 获取 React）
- 本地修改后：lib/ 两个文件同步到 profile 的 node_modules//lib/ 并重启生效
- 雷达图为纯 SVG 程序生成（RadarChart 组件），无外部图表依赖

路线图
- [ ] 审查报告导出为 Markdown/JSON
- [ ] 按项目平均分趋势图
- [ ] 重审结果对比视图（旧分 vs 新分）

许可证

MIT License。见 LICENSE。

与 DeepSeek 官方无关联；插件名称、描述仅供社区分发使用。