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 更新

_AI_USAGE_LOG.md

@@ -221,3 +221,8 @@
 | 2026-08-20 22:20 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 修复 custom/ai 修复不稳定（用户实测「有时能修有时不能」，排除聚焦因素后确认是 AI 链路稳定性问题）。根因三处：①fixPrompt.buildFixSystemPrompt 只要求「无法修复就输出空」，给了 AI 轻易放弃的空间（→ ai-no-fix）；②customFixEngine.verifyFixed 用 parsed.fixed === true 严格相等，AI 返回字符串 "true" 永不收敛（→ max-iterations）；③收敛失败整体回滚，一次不确定的 AI 重检否定已生成的有效修复。修复（按用户确认的 C1 方案）：①prompt 三语加硬性要求「必须输出修复片段，禁止输出空修复；即使无法完全消除也要给缓解/改善的最小片段」；②requestFix 对空修复/解析失败自动重试 1 次（customFixEngine 与 aiFixEngine 同步，前者重试后仍空才 null）；③verifyFixed 宽松判定 f===true || String(f)==='true'；④C1 收敛降级——循环结束未收敛时若 appliedFixes.length>0 则接受最后一次修复（返回 success+newText 走正常 diff 预览），仅从未生成出可匹配修复才失败；⑤每轮加 console.log('[code-reviewer] review-fix', ruleId, round, {ai-no-fix/ai-match-failed/no-change/applied/verify}) 诊断日志。测试：customFixEngine.test.ts 原 max-iterations 用例改为「accepts last fix when verify never passes」（断言 success=true+newText），新增「retries empty fix once then fails with ai-no-fix」用例（两次空响应）。npm test 111 passing / lint 0 error / compile 通过 | 中间产物：①TS2367 类型不重叠——parsed.fixed 类型 boolean|undefined 与 'true' 字符串比较报错，用 & { fixed?: unknown } 断言 + String(f) 收窄解决；②aiFixEngine 的 ai-no-fix 测试用例只给 1 次空响应，重试后取默认 '{}'（无 originalText）仍返回 ai-no-fix，无需改断言；③C1 实现位置纠结——先想在循环外统一处理，实际把降级分支写在 !converged 内并与 dryRun/apply 复用收尾 | src/fix/fixPrompt.ts src/fix/customFixEngine.ts src/fix/aiFixEngine.ts src/test/customFixEngine.test.ts | deepseek-v4-flash |
 | 2026-08-20 22:32 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 重写 README.md：补齐运行环境要求（VSCode 1.120+/Node/Java/sqlfluff）、安装步骤（VSIX 安装 + 源码构建）、运行方法（端用户命令表 + 开发者命令表）、前端 Webview 面板启动方式、API 密钥配置（SecretStorage + 配置项表 + 自定义供应商）、依赖清单（运行/开发依赖表）、其他配置项 | 无 | README.md | deepseek-v4-flash |
 | 2026-08-20 22:33 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 审查验证阶段修正 README：devDependencies 清单中移除不存在的 eslint 条目（eslint 仅存在于 dependencies） | 初版 README 依赖清单误列 eslint 于 dev 表 → 核对 package.json 后移除 | README.md | deepseek-v4-flash |
+| 2026-08-22 14:11 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 审核时预生成修复 + 展开问题即显示 diff：types.ts 新增 AiFixSnippet/LinterFix.originalText/LinterDiagnostic.aiFix；schema.ts CustomRuleResult/AIFinding/TranslatedDiagnostic 加可选 fix；engine.ts 三语 prompt（customRuleResults/findings/translatedDiagnostics/方法审查）输出格式加 fix 字段及原文不含行号前缀说明（解析用 ...r 展开自动透传）；utils/diff.ts 新建行级 diff（LCS）；merger.ts MergeInput 加 code?，静态诊断从 code 按 fix.range 切片补 fix.originalText，customRuleDiagnostics 带 aiFix，翻译 fix 合并进 aiFix；fixPrompt.ts ReviewIssueInput 加 fix；customFixEngine/aiFixEngine 开头预生成片段 indexOf 匹配直接应用（dryRun 返回 newText/否则 applyEdit），匹配失败回退实时 LLM 循环；commands.ts mergeResults 三处传 code、refreshAfterFix 重建时保留 aiFix、findCustomIssue/findAIIssue/fixAll 带 fix、新增 enrichLinterDiagnostic 从 currentReport.linterDiagnostics 补 aiFix（fixIssue/fixAll linter 路径）；webview.ts buildIssueItem 增 fixDiffHtml 参数、展开区渲染行级 -/+ diff（.fix-diff/.diff-del/.diff-add CSS）、三列表按 aiFix/fix 计算 diff、suggestion 与 diff 并存；messages.ts 新增 report.fixPreview 三语；spec 文档 docs/superpowers/specs/2026-08-22-pregen-fix-design.md。lint 0 error（仅 mockDocument.ts 2 个既有 curly warning）/ compile 通过 / npm test 111 passing | 方案迭代：初版仅 custom+AI findings 预生成，用户确认扩展含 linter 无 autofix 诊断（translatedDiagnostics 带 fix）；merger 初版原地改 fix.originalText 会污染 orchestrator 缓存共享对象，改为 spread 新建副本；fixAll 策略用户采纳「预生成优先+失败回退实时、不做偏移修正」 | docs/superpowers/specs/2026-08-22-pregen-fix-design.md(新建) src/types.ts src/ai/schema.ts src/ai/engine.ts src/utils/diff.ts(新建) src/merger/merger.ts src/fix/fixPrompt.ts src/fix/customFixEngine.ts src/fix/aiFixEngine.ts src/activation/commands.ts src/panel/webview.ts src/i18n/messages.ts | deepseek-v4-flash |
+| 2026-08-22 14:50 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 无预生成 fix 的问题展开区显示占位提示（不再空白）：webview.ts buildIssueItem 新增 fixPlaceholder——(fixable||aiFixable) 且 fixDiffHtml 为空时渲染「无预生成修复，点击修复将实时生成」提示条（.detail-no-fix 虚线框样式），展开区渲染条件与分支扩展为 detailHtml/suggestion/fixDiffHtml/fixPlaceholder 四选；messages.ts 新增 report.fixUnavailable 三语 key。lint 0 error（仅既有 mockDocument.ts 2 warning）/ compile 通过 / npm test 111 passing | 无 | src/panel/webview.ts src/i18n/messages.ts | deepseek-v4-flash |
+| 2026-08-25 19:13 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | diff 预览改为在侧边新建编辑器组打开（不覆盖当前正在查看的文件）：fixPreview.ts openPreviewDiff 的 vscode.diff 调用补第 4 参数 { viewColumn: vscode.ViewColumn.Beside, preserveFocus: true }，4 个触发点（fixIssue/fixAll × linter/custom-AI）均走此函数全覆盖；closePreviewEditor 遍历所有 tabGroups 与分组位置无关无需改动。lint 0 error（仅既有 mockDocument.ts 2 warning）/ compile 通过 / npm test 111 passing | 澄清阶段「新建编辑器组/侧边标签页」vs「全新 VSCode 窗口实例」两分支，用户选前者（全新窗口扩展 API 不支持且 diff 内容在内存中不可行）；preserveFocus 加否为方案决策点，用户确认加（打开 diff 后焦点留在审查面板） | src/fix/fixPreview.ts | deepseek-v4-flash |
+| 2026-08-25 21:35 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 修复 sqlfluff 行号显示 LNaN：根因是 sqlfluff 4.x 对「jinja 标签位于注释内」的 JJ01 违规 JSON 缺失 end_line_no/end_line_pos，适配器 `v.end_line_no-1`=NaN → VSCode Range 构造时 start.isBefore(end) 对 NaN 恒 false 触发 start/end 交换 → range.start.line=NaN → 面板 L${line+1} 渲染 LNaN。修复：adapters/sqlfluff.ts 新增纯函数 resolveSqlFluffRange（缺失/null/NaN/非法值兜底：start 回退 1、end 回退 start；兼容旧版 line_no/line_pos key；start_line_pos=0 钳制 ≥1），check() 改用其构造 Range；SqlFluffViolation position 字段改可选；webview.ts buildIssueItem 与 utils/report.ts formatLine 加 Number.isFinite 防御（非法行号渲染 L?）；新增 src/test/sqlfluff-range.test.ts 6 用例。验证：lint 0 error（仅既有 mockDocument.ts 2 warning）/ compile 通过 / npm test 111 passing | 中间产物：①根因排查多轮——先后排除旧版 sqlfluff schema（line_no key）与「注释场景缺 end 字段只坏终点不坏起点」假设，最终结合 VSCode extHostTypes/range.ts 源码确认 NaN 使 isBefore 恒 false 触发 start/end 交换，链路闭合；②sanitizePosition 初版参数类型 number|undefined，测试用例传 null 触发 TS 类型错误，接口与函数签名扩为 number|null|undefined | src/adapters/sqlfluff.ts src/panel/webview.ts src/utils/report.ts src/test/sqlfluff-range.test.ts(新建) | deepseek-v4-flash |
+| 2026-08-25 21:54 | ① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证 | 从插件内置 PMD 配置移除 5 条实际不可触发的规则（AvoidAssertAsIdentifier/AvoidEnumAsIdentifier 语言版本上限 1.3/1.4、AccessorClassGeneration/AccessorMethodGeneration 上限 Java 10、LoosePackageCoupling 需显式 packages 配置），使内置配置=全部可触发，demo-pmd 覆盖率基线对齐 269+12=281 可达成 100%。改动：jars/pmd/pmd-java-ruleset.xml 三个分类 exclude 各追加（bestpractices 2 + design 1 + errorprone 2）并将 description 计数 274→269；src/rules/static-rules.json linterVersion.pmd 改 269、移除 5 条规则条目（pmd 295→290）；scripts/translations/pmd-1.mjs/pmd-2.mjs 同步删除 5 条翻译种子项。验证：PMD 实际跑内置 ruleset 无加载异常 / lint 0 error / compile 通过 / npm test 117 passing | 中间产物：static-rules.json 第一处编辑误保留 AccessorClassGeneration 块（只删了 AccessorMethodGeneration），复查 JSON 计数发现后补删 | jars/pmd/pmd-java-ruleset.xml src/rules/static-rules.json scripts/translations/pmd-1.mjs scripts/translations/pmd-2.mjs | deepseek-v4-flash |