feat: link ai quality actions to changes

project-docs/V2-ai-quality-improvement-linked-changes-2026-06-23.md

@@ -0,0 +1,67 @@
+# 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` 改进项，提供上传/导入知识文档入口。
+- 改进项完成时自动要求填写“实际变更对象”，防止误标完成。