# V2 AI 质量改进项关联真实变更记录 - 2026-06-23

## 背景

上一轮已经完成 Prompt 发布/回滚闭环。本轮继续推进“AI 质量问题归因 -> 改进动作 -> 真实配置变更 -> 效果回看”的闭环，避免质量改进项只停留在文字状态。

## 本轮完成内容

1. 改进项增加真实关联字段
   - `linked_prompt_template_id`
   - `linked_prompt_template_version`
   - `linked_knowledge_base_id`
   - `linked_import_batch_id`

2. AI Platform 自动推断关联对象
   - Prompt 维度改进项会尝试关联对应 Prompt 模板和版本。
   - 知识库维度改进项会关联知识库 ID 和该知识库最新导入批次。
   - 创建接口仍支持前端或 SDK 显式传入关联字段。

3. 持久化兼容
   - SQLAlchemy 模型增加对应字段。
   - 自动兼容迁移会给已有 `ai_quality_improvement_actions` 表补列。
   - 内存仓库与 SQL 仓库均支持创建、更新、列表、看板返回关联字段。

4. OpenAPI 与 SDK 同步
   - `AiQualityImprovementActionCreate`、`AiQualityImprovementActionUpdate`、`AiQualityImprovementAction` 同步新增关联字段。
   - Python SDK 支持创建和更新改进项时传入关联字段。

5. 管理后台质量运营页增强
   - 页面加载 Prompt 模板和知识库导入批次候选。
   - 从 Prompt 归因生成改进项时，自动关联 Prompt 模板 ID 和版本。
   - 从知识库归因生成改进项时，自动关联知识库 ID 和最新导入批次。
   - 改进项卡片展示“关联变更”，并提供跳转 Prompt 中心入口。
   - 新增 `/api/ai-platform/knowledge-import-batches` 前端代理。

## 验证结果

- `python -m pytest yuqei-ai-platform/services/ai-platform-api/tests -q`
  - 26 passed
- `python -m pytest yuqei-ai-sdk-python/tests -q`
  - 2 passed
- `npm run web:typecheck`
  - passed
- `npm run web:build`
  - passed
- OpenAPI YAML 解析
  - passed

## 当前闭环价值

现在质量运营路径变成：

1. 质量看板发现某个模型、Prompt、知识库或标签异常集中。
2. 管理员从归因卡片生成改进项。
3. 改进项自动挂上相关 Prompt 版本或知识库导入批次。
4. 管理员去 Prompt 中心发布新版本，或补充知识库导入批次。
5. 后续 AI 调用继续进入质量看板，改进项显示处理后异常率、质量分、待处理标签变化。

这让“调整 Prompt”“补知识库”开始具备可追溯的配置变更记录。

## 下一步建议

下一步可以进入“改进动作执行页”：

- 对 `tune_prompt` 改进项，提供直接创建 Prompt 草稿的入口。
- 对 `improve_knowledge` 改进项，提供上传/导入知识文档入口。
- 改进项完成时自动要求填写“实际变更对象”，防止误标完成。