feat: AI 修复预生成 + 审查面板 diff 预览两步确认 + SQLFluff 行号修复 + PMD 内置规则精简

- AI 修复预生成:静态/custom/AI 条目审查时预生成修复片段(originalText/newText),展开问题即显示行级 diff,无预生成时展示占位提示,匹配失败回退实时 LLM 生成

- 修复前 diff 预览:侧边新建编辑器组打开内置 diff,确认后写入(两步确认),不覆盖当前文件

- fix: sqlfluff 在 jinja 标签位于注释内时 JJ01 JSON 缺失 end_line_no/end_line_pos,适配器 Range 构造产生 NaN 被 VSCode 交换 start/end 导致行号 LNaN;新增 resolveSqlFluffRange 兜底 + 面板/report 行号 Number.isFinite 防御

- fix: 从 PMD 内置 ruleset 移除 5 条实际不可触发规则(AvoidAssertAsIdentifier、AvoidEnumAsIdentifier、AccessorClassGeneration、AccessorMethodGeneration、LoosePackageCoupling),内置配置 274→269 条全部可触发,同步 static-rules.json 与翻译脚本

- docs: README/DESIGN 更新
This commit is contained in:
范智鹏
2026-08-25 21:58:14 +08:00
parent 59e5fcde8c
commit 9c676e46e6
22 changed files with 445 additions and 86 deletions
+30
View File
@@ -1,7 +1,37 @@
# vscode-code-reviewer · 净码特工 (Code Purifier)
> **项目性质:新规**(从零开发的全新作品)
AI 驱动的代码审查与规范检查一体化 VS Code 插件。集成 ESLint、Stylelint、PMD、SQLFluff 等多种 linter,并支持 AI 辅助审查与自动修复。
## 项目概述
「净码特工 (Code Purifier)」是一款面向企业级多语言代码库的一体化代码审查与规范检查 VS Code 扩展。它将传统静态检查(ESLint、Stylelint、PMD、SQLFluff)与 AI 大模型审查深度融合,覆盖 JavaScript、TypeScript、Java、JSP、HTML、CSS、SQL、PL/SQL 八类语言,提供一键审查、方法级审查、AI 自动修复与修复预览、报告导出、自定义规则导入等能力,并内置 Webview 面板实现"配置—审查—修复—导出"的闭环体验。
## 效果总结(核心指标摘要)
> 待补充:请填写提效/效果类核心指标摘要(新规项目须提供对比数据证明价值),例如:单文件平均审查耗时、AI 修复准确率、缺陷检出率、规则覆盖率等基线 vs 提效后对比。
| 指标 | 基线 | 提效后 | 提升幅度 |
|------|------|--------|----------|
| (示例)单文件审查耗时 | 待填 | 待填 | 待填 |
| (示例)AI 修复采纳率 | — | 待填 | 待填 |
| (示例)规则检出覆盖率 | 待填 | 待填 | 待填 |
## 团队分工
> 待补充:请如实填写团队成员及分工。
| 成员 | 分工 |
|------|------|
| 待填 | 待填 |
## 规模与技术难度自我评估
- **代码规模**:源码约 65 个 TypeScript 文件、约 1.1 万行,按 17 个模块分层组织(`activation` / `adapters` / `ai` / `config` / `diagnostics` / `fix` / `i18n` / `jsp` / `merger` / `orchestrator` / `panel` / `rules` / `scope` / `services` / `types` / `utils` / `views`)。
- **技术难度**:(整体偏高)涉及多 linter 统一适配层抽象、多 AI 供应商动态注册(Provider 策略模式 + 运行期注册表)、AI 修复链路(生成—校验—预览—快照撤销)、Office 文档(Word/Excel/PPT)规则导入解析、PMD 的 Java 辅助类路径探测、SQLFluff 方言映射等跨语言、跨进程、跨服务的复杂工程问题。
- **可运行性**:依赖清单与锁文件(`package.json` / `package-lock.json`)随仓库提供,源码经 `npm install && npm run compile` 即可构建,按 `F5` 启动调试。
## 功能特性
- 一键运行代码审查