🐛 fix(jvm): 修正 AI 计划映射与页签定向应用

- 为 JVM AI 计划补充显式草稿映射，避免 payload 包装层直接透传到现有变更契约
- 将 updateValue 映射为当前 JVM 写入链路的 put，并限制为 JSON 对象 payload
- 为 AI 聊天消息绑定 JVM 来源上下文，按 tab/connection/provider/resource 定向应用计划
- 补充 JVM AI 计划解析、契约映射和目标页签解析单测
- 更新需求追踪并回填 go test、前端测试、构建与 wails build 验证结果

docs/需求追踪/需求进度追踪-JVM缓存可视化编辑-20260422.md

@@ -26,9 +26,9 @@
 - [x] 阶段 2（影响分析）：完成
 - [x] 阶段 3（方案设计）：完成（已形成正式设计文档）
 - [x] 阶段 4（实施计划）：完成（已形成正式实施计划）
-- [ ] 阶段 5（实现与自检）：进行中（Task 1 至 Task 5 已完成并通过回归，Task 6/7 待继续）
-- [ ] 阶段 6（评审与交付）：
-- [ ] 阶段 7（发布与观察）：
+- [x] 阶段 5（实现与自检）：完成（Task 1 至 Task 7 已完成，代码与构建回归通过）
+- [x] 阶段 6（评审与交付）：完成（已完成契约复核、上下文隔离修正、文档回填与交付检查）
+- [ ] 阶段 7（发布与观察）：未开始
 
 ## 4. 变更清单
 - 已完成：
@@ -45,10 +45,14 @@
   - 已完成 Task 3：JVM 连接表单、图标与展示文案接入
   - 已完成 Task 4：只读资源浏览与 JVM Tab
   - 已完成 Task 5：写入预览、Guard 和审计记录
-- 进行中：
-  - Task 6：AI 结构化变更计划
+  - 已完成 Task 6：AI 结构化变更计划
+  - 已完成 Task 7：全量回归、文档回填与交付检查
+  - 已完成 JVM AI 计划解析、资源定位解析、AI 计划到当前 JVM 变更草稿的显式映射，避免把 `payload.format/value` 包装层直接透传到现有 JVM 写入契约
+  - 已完成 AI 聊天面板 JVM 上下文注入、AI 气泡“应用到 JVM 预览”入口以及 JVM 资源页草稿回填闭环
+  - 已完成 JVM AI 计划来源上下文绑定：消息现在绑定生成时的 `tabId + connectionId + providerMode + resourcePath`，避免切换 JVM 页签后误投递到当前激活页
 - 待处理：
-  - Task 7：全量回归、文档回填与交付检查
+  - 真实 provider 的 `PreviewChange` / `ApplyChange` 端到端能力验证
+  - AI 参与信息写入 JVM 审计记录
 
 ## 5. 风险与阻塞
 - 风险：
@@ -59,18 +63,29 @@
   - 多接入模式会带来能力不一致问题，UI 与权限模型必须显式展示“当前模式支持什么/不支持什么”
   - 当前 JMX / Endpoint provider 的资源浏览与值读取仍是骨架实现，Task 4 已打通接口与 UI 链路，但真实资源展开会返回 `not implemented`
   - Task 5 已打通 Guard/Preview/Audit 主链路，但真实 provider 的 `PreviewChange` / `ApplyChange` 能力仍依赖后续 provider 细化实现
+  - 当前 AI 能力边界仍是“分析 + 生成结构化计划 + 回填预览草稿”，不直接执行 JVM 写入，真实执行仍取决于 Guard、人工确认和 provider 能力
+  - 当前 MVP 中 `updateValue` 会映射为现有 JVM 变更 contract 的 `put`，且 payload 仅接受 JSON 对象；非对象值、复杂二进制值和 provider 专有写法不在本期承诺范围
+  - AI 计划若只提供 `namespace + key`，当前仅按 `namespace/key` 推导资源 ID，属于 MVP 级资源定位约定，未承诺适配所有 provider 的资源 ID 规则
+  - JVM 审计记录当前未显式记录“AI 是否参与”，与理想审计模型仍有差距
+  - 历史旧 AI 消息不包含 JVM 来源上下文，若需要应用到预览，需在目标 JVM 资源页重新生成计划
 - 阻塞：
-  - 目标应用技术栈、缓存框架与接入约束尚未明确
+  - 当前开发收口阶段无新增阻塞
 - 缓解措施：
   - 优先收敛到标准接入面（JMX / Spring Actuator / Java Agent 三选一）
   - 首期只支持白名单对象类型与受控写操作
   - 要求变更审计、预览、确认与失败回滚路径
+  - 在交付说明中明确“AI 只生成草稿，不代表 provider 已具备真实写能力”
+  - 后续如进入真实接入阶段，优先补齐 provider 端到端验证与 AI 审计字段
 
 ## 6. 决策记录
 - 决策 1：先做可行性评估与方案设计，不直接进入实现
 - 决策 2：默认优先复用 GoNavi 现有 driver-agent 与前端编辑器能力，避免侵入式重构主流程
 - 决策 3：已按完整模式推进，后续方案将优先评估通用 Agent 路径是否成立
 - 决策 4：由于目标服务大概率不允许 agent/attach，后续推荐方向转为“多接入模式 + 能力协商”
+- 决策 5：AI 在 JVM 场景中只负责分析与生成结构化计划，不直接执行运行时写入
+- 决策 6：AI 计划应用入口只回填 JVM 预览草稿，后续仍必须经过 `JVMPreviewChange`、Guard 校验和人工确认
+- 决策 7：当前 MVP 中 `updateValue` 会映射到现有 JVM 变更 contract 的 `put`，且 payload 仅接受 JSON 对象
+- 决策 8：JVM AI 计划必须绑定生成时的 JVM 上下文，只允许投递到匹配的 `tabId + connectionId + providerMode + resourcePath`
 
 ## 7. 验证记录
 - 验证项：
@@ -80,6 +95,11 @@
   - JVM Connector 实施计划文档自检
   - Task 1：JVM 共享契约与配置归一化
   - Task 2：Provider 注册、连接测试与能力探测 API
+  - Task 6：AI 计划解析、资源定位解析、契约映射与页签上下文隔离
+  - Task 7：后端全量测试
+  - Task 7：前端全量测试
+  - Task 7：前端生产构建
+  - Task 7：Wails 生产构建
 - 结果：
   - 已确认存在可复用的连接桥接与编辑器基础设施
   - 已完成正式设计文档落盘与自检，未发现占位词和明显范围冲突
@@ -95,6 +115,13 @@
   - 已完成 Task 5：后端新增 `JVMPreviewChange` / `JVMApplyChange` / `JVMListAuditRecords`，补齐 Guard、审计 JSONL 落盘与审计读取能力
   - Task 5 已补齐只读拦截、`prod` 环境确认、provider preview 错误透出、审计写入失败显式回传、连接 `allowedModes` 约束和局部快照合并保底
   - 前端已完成 JVM 变更草稿区、预览弹窗、执行确认、审计记录页签与按 provider mode 的审计过滤
+  - 已完成 Task 6：AI 计划解析、资源定位解析、`updateValue -> put` 显式映射、JSON 对象 payload 约束和上下文绑定单测
+  - 已完成 Task 6：AI 聊天消息与 JVM 来源页签绑定，AI 气泡应用按钮不再依赖点击时的 `activeTabId`，避免跨 JVM 页签误投递
+  - `cd frontend && npm test -- --run src/utils/jvmAiPlan.test.ts` 通过（10 tests）
+  - `go test ./... -count=1` 通过
+  - `cd frontend && npm test -- --run` 通过（61 files，258 tests）
+  - `cd frontend && npm run build` 通过；构建中存在既有 chunk size / dynamic import 警告，但未阻塞产物生成
+  - `wails build -clean` 通过，成功生成 macOS 应用包
 - 证据（日志/截图/链接）：
   - `cmd/optional-driver-agent/main.go`
   - `internal/db/database.go`
@@ -160,7 +187,17 @@
   - `go test ./internal/jvm ./internal/app -run 'TestPreviewChangeBlocksReadOnlyConnection|TestPreviewChangeReturnsProviderPreviewErrorWhenWriteAllowed|TestPreviewChangeMarksProdWritesAsConfirmationRequired|TestPreviewChangeMergesProviderSnapshotsWithoutDroppingDefaults|TestJVMApplyChangeReturnsProviderPayload|TestJVMPreviewChangeRejectsModeOutsideAllowedModes|TestJVMListAuditRecordsReturnsLatestRecords|TestJVMApplyChangeSurfacesAuditWriteFailure' -count=1`
   - `go test ./internal/jvm ./internal/app -count=1`
   - `cd frontend && npm run build`
+  - `frontend/src/utils/jvmAiPlan.ts`
+  - `frontend/src/utils/jvmAiPlan.test.ts`
+  - `frontend/src/components/AIChatPanel.tsx`
+  - `frontend/src/components/ai/AIMessageBubble.tsx`
+  - `frontend/src/components/JVMResourceBrowser.tsx`
+  - `frontend/src/types.ts`
+  - `cd frontend && npm test -- --run src/utils/jvmAiPlan.test.ts`
+  - `go test ./... -count=1`
+  - `cd frontend && npm test -- --run`
+  - `wails build -clean`
 
 ## 8. 下一步
-- 下一步行动：进入 Task 6，接入 AI 结构化修改计划能力，并在 Task 7 做全量交付检查
+- 下一步行动：如进入真实接入阶段，优先补齐 provider 端到端写入验证、AI 参与审计字段和生产环境灰度验证
 - 负责人：Codex