feat: 自动修复重构与审查面板交互修复 + 静态分析 AI 翻译配对 + SQLFluff 方言显示

- 自动修复:废弃 AI 修复,改 linter 原生 fix 多轮收敛;CodeAction hover + 面板修复/全部修复 + 快照 diff 撤销;hover 修复不入「已修复」列表、重新审查清空;修复/撤销后自动保存;单条修复只修目标问题(区间重叠收敛,不再连带相邻同规则)
- 审查面板:内联 JS 外部化(reviewPanel.js)修复 CSP 屏蔽导致的修复按钮/行号跳转/tab 失效;面板操作不依赖文件焦点(resolveFixDocument);行号跳转定位已打开编辑器,不在面板列新开副本
- 静态分析:translatedDiagnostics 规则 ID 归一化配对 + 深度审查 prompt 强化,静态分析条目显示中文翻译与逐条 AI 建议
- 波浪线:诊断补 source/code,hover 显示快速修复链接
- SQLFluff:设置面板方言徽章(显式/全局/项目/内置来源配色)
This commit is contained in:
范智鹏
2026-08-18 21:41:51 +08:00
parent 3cf5c7165e
commit 3d8119d9c9
28 changed files with 1320 additions and 355 deletions
+10 -1
View File
@@ -202,4 +202,13 @@
| 2026-08-09 14:31 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 审查报告 #11 启动分析未捕获错误:核实属实且更严重——void analyzeOpenDocuments()/void runStaticAndApply()/scheduleAnalysis 定时器三处均为未捕获 Promise 拒绝路径,runStaticAndApply 内部无 try-catchmarkers.apply 无保护;纠正审查中「runStaticAnalysis 自身有 try-catch」的事实错误(orchestrator.ts 直接 await adapter.check(),无 try-catch,唯一防线是各适配器内部 catch)。经审批在 runStaticAndApply 包 try-catch + console.error 单点保护,覆盖三处调用。lint 0 error / compile / npm test 81 passing | 中间产物:无 | src/extension.ts | deepseek-v4-flash |
| 2026-08-09 14:34 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 版本升级 1.2.0 → 1.3.0package.json version 更新;CHANGELOG.md 由模板「Unreleased-Initial release」改为 1.3.0 正式条目(修复 6 项 + 清理 3 项);整合审查报告 #3-#11 全部修复作为本版本内容 | 中间产物:无 | package.json CHANGELOG.md | deepseek-v4-flash |
| 2026-08-12 22:31 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | Bug fix: JS 审查不出 no-octal / no-nonoctal-decimal-escape — 根因是 flat config 默认 sourceType=module(严格模式)下 `010``\8`/`\9` 属 JS 语法错误,eslint.ts:114 又丢弃 ruleId===null 的致命解析错误。A:致命解析错误改为产出 eslint:parse-error error 诊断(不再静默丢弃);Bts.configs.recommended 逐项补 files 守卫(其 base 无 files 会全局挂 TS parser 并误报 TS 规则到 JS),JS 回退 espree + js.configs.recommended,并新增 JS_FILES 独立 config 块加 ecmaFeatures.jsx 防 JSX 回归。本地被删的 eslint.config.mjs 已从 git 恢复以启用 lint。新增 3 个 adapter 测试(octal→parse-error、\8→parse-error、JSX 无 parse error),npm test 84 passing / lint 0 error(仅 jsp.ts 2 个既有 curly warning| 中间产物:①调试复现阶段 node -e 转义踩坑(PowerShell 单引号 + \8 报 Unterminated string constant),改用 String.fromCharCode 构造测试串;②ts.configs.recommended 类型试错——cfg.files 在 CompatibleConfig 上不存在致编译报错,改用 (cfg as { files?: string[] }).files 断言;③JSX 方案三选一——全局 jsx / .jsx 单独挂 TS parser / JS_FILES 独立 config 块,实测后者通过 | src/adapters/eslint.ts src/test/adapter.test.ts | deepseek-v4-flash |
| 2026-08-12 23:14 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | Bug fix: 设置面板 Stylelint 配置模式显示错误——项目根目录有 stylelint.config.mjs 时面板仍显示「内置配置」,根因是 setupView.ts 的 PROJECT_CONFIG_FILES.stylelint 清单(6 项)与 stylelint.ts 适配器 CONFIG_FILE_NAMES8 项)不一致,漏了 stylelint.config.mjs / stylelint.config.cjs。按方案 B 最小改动补齐两个文件名,实际审查本就走项目配置无问题。lint 0 error / compile 通过 | 中间产物:曾评估方案 A(抽共享常量消除 drift,含顺带统一 ESLint legacy 清单)被用户否决,仅执行方案 B | src/views/setupView.ts | deepseek-v4-flash |
| 2026-08-12 23:14 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | Bug fix: 设置面板 Stylelint 配置模式显示错误——项目根目录有 stylelint.config.mjs 时面板仍显示「内置配置」,根因是 setupView.ts 的 PROJECT_CONFIG_FILES.stylelint 清单(6 项)与 stylelint.ts 适配器 CONFIG_FILE_NAMES8 项)不一致,漏了 stylelint.config.mjs / stylelint.config.cjs。按方案 B 最小改动补齐两个文件名,实际审查本就走项目配置无问题。lint 0 error / compile 通过 | 中间产物:曾评估方案 A(抽共享常量消除 drift,含顺带统一 ESLint legacy 清单)被用户否决,仅执行方案 B | src/views/setupView.ts | deepseek-v4-flash |
| 2026-08-14 22:10 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 侧边栏设置面板 SQLFluff 卡片新增只读「当前生效方言」徽章(紧跟模式徽章、同 adapter-badge-info 样式):方言解析逻辑集中在 sqlfluff.ts——SUPPORTED_DIALECTS 改 export consthasProjectSqlfluffConfig 重构为 findProjectSqlFluffConfig(返回文件路径);新增 readDialectFromConfigFile(行扫描 [sqlfluff]/[tool.sqlfluff] 段 dialect,支持 = X 与 = "X",不引 TOML 依赖)与导出 resolveSqlFluffDialect(解析链:显式 sqlfluff.dialect > 全局 configFile > 项目配置 > 内置默认 oracle;有配置文件但无 dialect 键回退 sqlfluff 默认 ansi);setupView.ts AdapterConfigStatus 加 sqlfluffDialect 字段并在 collectAdapterStatus 填充、pushConfig i18n 注入 labelsetupView.js renderAdapters 对 sqlfluff 卡片追加方言徽章;messages.ts 新增 setup.adapter.sqlfluffDialectLabel 三语。npm test 84 passing / lint 0 error(仅 jsp.ts 2 个既有 curly warning) | 中间产物:设计初稿 v1 的「自动(默认 oracle)」占位文案方案在 Stage ④ 被用户否决(用户改口「展示的方言是现在生效的方言」)→ 澄清后改为完整解析链 v2;解析深度三选一(仅设置值→oracle / 设置值→项目配置→内置 / 含全局配置文件解析)用户选最完整的含全局解析 | src/adapters/sqlfluff.ts src/views/setupView.ts src/views/setupView.js src/i18n/messages.ts docs/superpowers/specs/2026-08-14-sqlfluff-dialect-display-design.md | deepseek-v4-flash |
| 2026-08-14 22:24 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 方言徽章配色随来源变化:resolveSqlFluffDialect 返回值从 string 改为 { dialect, source }source: explicit/global/project/builtin,导出 SqlFluffDialectSource/SqlFluffDialectInfo 类型);setupView.ts AdapterConfigStatus 加 sqlfluffDialectSource 字段、collectAdapterStatus 传解析信息、CSS 新增 .adapter-badge-explicit 蓝色(#388bfd)样式;setupView.js dialectBadgeClassMap 按 source 映射 classexplicit→蓝/global→黄 warn/project→绿 ok/builtin→紫 info),使方言徽章颜色表明控制它的配置范围。npm test 84 passing / lint 0 error / compile 通过;设计文档同步更新配色映射表 | 中间产物:显式设置徽章色三选一(同全局黄 / 独立蓝 / 按 inspect 实际作用域)用户选独立蓝 | src/adapters/sqlfluff.ts src/views/setupView.ts src/views/setupView.js docs/superpowers/specs/2026-08-14-sqlfluff-dialect-display-design.md | deepseek-v4-flash |
| 2026-08-14 23:28 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 自动修复功能重构(设计+实现):废弃 AI 修复(src/fixer/fixer.ts 删除),改为 linter 原生 --fix 单条 fix 对象(ESLint msg.fix / Stylelint w.fix)驱动。设计:多轮循环+内存模拟+单次提交、diff 反向撤销(任意顺序)、CodeAction hover 修复链接+面板修复按钮+一键修复全部、修复后重跑静态分析刷新(波浪线/CodeLens/面板已修复变绿+撤销按钮+无行号)、轮次上限默认 3 可配置、JSP/PMD/SQLFluff 一期不支持修复。实现:types.ts 增 LinterFix/LinterDiagnostic.fixeslint/stylelint 适配器提取 fixorchestrator 增分析结果缓存+getAdapter;新建 src/fix/fixEngine 多轮循环内存模拟+单次提交、fixSession 多片段合并撤销、codeActionProvider hover 修复链接);commands 实现 fixIssue/fixAll/undoFix+refreshAfterFixextension 注册 CodeAction+fixSessionwebview 修复状态渲染+AI/custom 修复按钮 bug 修复;merger 只标记带 fix 诊断可修复;config fixer.maxIterationsi18n 增 fix 系列 key;测试 95 passing / lint 0 error / compile 通过。自审查发现并修复:多轮同问题撤销只回退首片段(改多片段合并+倒序一次 applyEdit)、空 fix.text 撤销定位错误 | 中间产物:fixEngine 初版 findClosestFixable/issueStillExists 双函数逻辑简化;fixSession 初版单片段记录改多片段合并;撤销定位空字符串退化处理;merger fixable 断言调整 | src/types.ts src/utils/mockDocument.ts src/adapters/eslint.ts src/adapters/stylelint.ts src/adapters/jsp.ts src/orchestrator/orchestrator.ts src/fix/fixEngine.ts src/fix/fixSession.ts src/fix/codeActionProvider.ts src/activation/commands.ts src/extension.ts src/panel/webview.ts src/merger/merger.ts src/config/fixer.ts package.json src/i18n/messages.ts src/test/fixEngine.test.ts src/test/fixSession.test.ts src/test/config.test.ts src/test/merger.test.ts docs/superpowers/specs/2026-08-14-fixer-refactor-design.md | deepseek-v4-flash |
| 2026-08-17 20:05 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 修复波浪线 hover 不显示「快速修复」链接的 bugtoVscodeDiagnostics 生成的 vscode.Diagnostic 未设置 code/sourceVSCode 仅在诊断带 code 时渲染 hover 快速修复链接。补 diag.source='Code Purifier'、diag.code=ruleId。diagnostics.test.ts 补 source/code 断言。npm test 96 passing / lint 0 error / compile 通过;并用 demo-eslint/src/common.js 实测确认 13 条可修复项(no-var→let、prefer-template、no-array-constructor 等) | 中间产物:用临时 _fixcheck2.cjs 脚本实测 common.js 可修复项后删除 | src/diagnostics/diagnosticMarkers.ts src/test/diagnostics.test.ts | deepseek-v4-flash |
| 2026-08-18 19:15 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 修复「已修复」列表生命周期两处问题:①codeReviewer.fixIssue 增加 origin 字段区分来源——codeActionProvider hover 快速修复传 origin:'hover'(不写 fixSession,不入「已修复」列表);面板「修复」按钮在 webview handleMessage 传 { ...message, origin:'panel' }(照常记录可撤销);fixAll/命令面板默认记录不变。②codeReviewer.reviewCtrl+Shift+R)开头新增 fixSession.clear(document.uri),重新审查即清空该文件「已修复」列表,只保留本轮修复。webview PanelMessage 增加 origin 字段。npm test 96 passing / lint 0 error / compile 通过 | 中间产物:澄清阶段曾纠结「新审查清空已修复列表」与「hover 不入列表」二选一,用户先选 hover 不入列表、后又追加重新审查清空,两者合并实现 | src/activation/commands.ts src/fix/codeActionProvider.ts src/panel/webview.ts | deepseek-v4-flash |
| 2026-08-18 19:42 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 修复静态分析条目不显示 AI 中文翻译/建议:根因是 AI 返回的 translatedDiagnostics[].originalRuleId 常不带 eslint: 等前缀,merger 按 d.ruleId 精确匹配导致 0 命中,条目全部回退英文原文+原生 fix 文本兜底。改动:merger.ts 新增 normalizeRuleId(剥离命名空间前缀+取末段)+ findTranslation(先精确后归一化,顺序消费不重复),替换原 translationsByRule 精确 Mapengine.ts buildDeepReviewSystemPrompt 三语各追加 translatedDiagnostics 硬性要求(每一条诊断必须 1:1 翻译、originalRuleId 原样复制含前缀、translatedMessage/translatedSuggestion 必填、建议给具体可执行修复)。merger.test.ts 新增 3 用例(前缀缺失命中/slash 变体命中/精确优先)。npm test 99 passing / lint 0 error / compile 通过 | 中间产物:merger 匹配初版考虑「双 key 注册共享数组」方案因双 key 各持独立数组会导致重复消费,改为 findTranslation 扫描池+spliceeslint.config.mjs 本次会话中两次被 vsce 打包流程删除,均从 git 恢复;用户端已确认 AI 已配置连接成功且 AI tab 有内容(排除 AI 调用失败,锁定配对环节) | src/merger/merger.ts src/ai/engine.ts src/test/merger.test.ts | deepseek-v4-flash |
| 2026-08-18 20:28 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 修复审查面板点击「修复」无反应:根因是 webview.ts 审查面板用内联 <script>,被 VS Code 默认 CSP 屏蔽(与 setupView 2026-07-15 历史 bug 相同),send/switchTab/toggleItem 全部未定义——修复按钮点击到 this.textContent='⏳...' 后 send() 抛 ReferenceError 消息从未发到扩展;症状为按钮卡 ⏳、无弹窗、代码不变,且 L1 行号跳转/tab 切换同样失效(用户确认)。修复:新建 src/views/reviewPanel.js(提取 send/switchTab/toggleItemcurly 花括号写法过 lint);webview.ts 面板 options localResourceRoots 改 [extensionUri]、构造函数 asWebviewUri 计算 scriptUri 存字段、buildHtml 内联 script 改 <script src>copy-webview-js.mjs 与 build.mjs 的 webview 拷贝 files 数组加 reviewPanel.jscompile 与生产打包均拷到 out/webview/)。防御性改进:commands.ts fixIssue/fixAll 主体包 try/catch + console.error + showErrorMessage,静默 return 处补 console.log 便于排查。npm test 99 passing / lint 0 error / compile 通过,out/webview/reviewPanel.js 已生成 | 中间产物:根因排查多轮——先疑 fixDiagnostic 静默返回/挂起,再疑 fixSession 缓存缺失,最后用户确认「L1 跳转也失效」锁定 webview 内联 JS 被 CSP 屏蔽;reviewPanel.js 初版单行 if 无花括号会被 eslint curly 警告,改花括号 | src/views/reviewPanel.js(新建) src/panel/webview.ts src/activation/commands.ts scripts/copy-webview-js.mjs scripts/build.mjs | deepseek-v4-flash |
| 2026-08-18 20:58 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 修复面板点「修复」必须先聚焦文件才生效:根因是两层活动编辑器依赖——commands.ts fixIssue/fixAll/undoFix 用 vscode.window.activeTextEditor 取文档,面板有焦点时活动编辑器未必是审查文件;fixEngine.ts fixDiagnostic 应用修复前又强制校验 activeTextEditor 必须等于目标文档(no-active-editor 分支)。改动:commands.ts 新增 resolveFixDocument(report, active, origin)——hover 用活动编辑器、面板(panel/fixAll/undo)用 currentReport.filePath 在 vscode.workspace.textDocuments 中定位文档、无报告回退活动编辑器;fixIssue/fixAll/undoFix 全部改用它取 documentfixEngine.ts 删除 no-active-editor 强校验分支直接 applyEditWorkspaceEdit 对任何打开文档生效无需焦点);webview.ts handleMessage 改 asyncnavigate 用 currentReport 的 Uri 经 showTextDocument({preview:true}) 打开/跳转。npm test 99 passing / lint 0 error / compile 通过 | 中间产物:resolveFixDocument 面板分支初版带「报告文件未打开时回退活动编辑器」会被误修当前活动文件,改为面板来源仅用报告文件、找不到返回 undefined 记日志;fixEngine.test.ts 仍保留 no-active-editor 断言分支但该路径已不再产生(不影响) | src/activation/commands.ts src/fix/fixEngine.ts src/panel/webview.ts | deepseek-v4-flash |
| 2026-08-18 21:28 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 三个问题合并修复:①修复后不保存文件——commands.ts fixIssue 成功、fixAll 循环结束、undoFix 成功后各加 await document.save() 自动写盘。②点第一个修复连带修相邻同规则问题——根因 fixEngine.ts issueStillExists 用 ±2 行窗口把相邻实例误判为同一问题;改为按修复后文本区域重叠判断(重 lint 诊断的 fix.range 是否与被修复区间 [start, start+fix.text.length] 重叠),不重叠即另一处实例停止,只修被点击那一处;findClosestFixable/prevLine 保留用于定位目标。③并排窗口点行号在面板列新开文件副本——根因 webview.ts navigate 的 showTextDocument({preview:true}) 未指定列,默认在活动列(面板所在列)打开;改为先从 vscode.window.visibleTextEditors 找该文件已打开的编辑器取其 viewColumn 传入 showTextDocument,未打开才 preview:true 打开;修复 TS2531 用局部变量 report 收窄 currentReport。fixEngine.test.ts 新增用例(相邻两行 no-var 点第一个只产出 1 个 appliedFix)。npm test 100 passing / lint 0 error / compile 通过 | 中间产物:webview navigate 编译报 TS2531find 回调内 this.currentReport 未收窄)→ 局部变量 const report=this.currentReport 解决 | src/activation/commands.ts src/fix/fixEngine.ts src/panel/webview.ts src/test/fixEngine.test.ts | deepseek-v4-flash |