# V2 AI 配置变更反向追溯深链接闭环 - 2026-06-23

## 本轮目标

按照《AI 合同平台 V2 重构版开发方案》继续推进 AI 中台管理闭环：管理员不仅能在质量改进项详情里看到 Prompt、知识库、模型参数的执行记录，还能直接跳转到对应配置对象，并在配置页面反向看到哪些质量改进项触发了这些变更。

## 完成内容

1. 质量改进项详情页补齐精准跳转
   - Prompt 关联跳转携带 `templateId`、`version`、`changeId`。
   - 知识库关联跳转携带 `knowledgeBaseId`、`batchId`、`executionId`。
   - 模型配置关联跳转携带 `providerConfigId`、`changeId`、`model`。

2. Prompt 中心支持目标定位
   - 读取 URL 参数并自动选中对应 Prompt 名称和版本。
   - 命中的 Prompt 版本卡片高亮。
   - Prompt 版本继续展示触发它的质量改进项，并能回到改进项详情。

3. 知识库导入页支持目标定位
   - 读取 `knowledgeBaseId` 后自动筛选知识库。
   - 读取 `batchId` 后自动展开导入批次详情。
   - 命中的导入批次卡片高亮。

4. 模型配置页支持目标定位
   - 读取 `providerConfigId` 或 `model` 后高亮模型配置卡片。
   - 读取 `changeId` 后高亮对应参数发布记录。
   - 模型配置继续展示触发调参的质量改进项。

## 路线核查

本轮没有把模型调用、Prompt 拼装、知识库检索或 AI 审计逻辑放回合同业务系统。AI 中台仍负责配置、Prompt、知识库和质量审计；合同系统前端只承担管理后台展示和代理入口，符合 V2 重构边界。

## 验证

- `npm --prefix yuqei-contract-platform/apps/contract-web run build`

## 下一步

- 给 Prompt 发布记录和知识库导入记录补更完整的详情页。
- 在质量改进项详情页增加“下一步执行动作”按钮，例如直接创建 Prompt 草稿、发起知识库导入、编辑模型参数。
- 将配置变更和后续 Trace 质量变化做时间线聚合，形成更清晰的改进复盘。