ai-contract-platform/project-docs/V2-ai-config-change-detail-audit-pages-2026-06-23.md

V2 AI 配置变更详情与审计页闭环 - 2026-06-23

本轮目标

继续遵循《AI 合同平台 V2 重构版开发方案》推进 AI 中台闭环，补齐 Prompt 发布记录、模型参数发布记录、知识库导入批次的独立详情/审计页。合同系统前端只做管理后台展示和代理入口，不直接访问 AI 中台数据库，不把 Prompt、模型、知识库逻辑塞回合同业务系统。

完成内容

1. AI Platform Prompt 发布记录接口

   • 新增 GET /api/v1/prompt-templates/changes。
   • 支持按 prompt_template_id、name、version、limit 查询。
   • OpenAPI 契约同步新增该接口。
   • Python SDK 新增 list_prompt_template_changes。

2. 合同管理后台代理

   • 新增 /api/ai-platform/prompt-templates/changes。
   • 继续通过前端代理访问 AI Platform，保持合同系统与 AI 中台边界清晰。

3. 独立详情/审计页

   • /admin/ai-prompts/changes/[changeId]
     • 展示 Prompt 发布记录、发布前后快照、执行人、说明和触发质量改进项。
   • /admin/ai-models/changes/[changeId]
     • 展示模型参数发布记录、发布前后参数快照、执行人、说明和触发质量改进项。
   • /admin/ai-knowledge/batches/[batchId]
     • 展示知识库导入批次、文档、chunk、关联质量改进项，并保留重建索引入口。

4. 质量改进项详情页深链接升级

   • 模型参数执行记录跳转到模型参数发布记录详情页。
   • Prompt 执行记录跳转到 Prompt 发布记录详情页。
   • 知识库重建记录跳转到知识库导入批次详情页。

路线核查

• AI 中台继续承接 Prompt、模型配置、知识库和审计记录。
• 合同系统前端只展示管理后台和调用代理接口。
• OpenAPI 与 Python SDK 同步更新，避免只做前端临时接口。
• 没有恢复旧 shared-* 结构，也没有把 SDK 副本塞回合同系统。

验证

• python -m pytest yuqei-ai-platform\services\ai-platform-api\tests\test_platform_data.py -q
• python -m pytest yuqei-ai-sdk-python\tests\test_ai_platform.py -q
• npm --prefix yuqei-contract-platform/apps/contract-web run build
• python -c "import pathlib, yaml; yaml.safe_load(pathlib.Path('yuqei-ai-platform/packages/ai-openapi/openapi.yaml').read_text(encoding='utf-8')); print('openapi ok')"

下一步

• 在质量改进项详情页增加执行按钮：创建 Prompt 草稿、发起知识库导入、编辑模型参数。
• 给配置变更详情页补更完整的操作审计时间线。
• 将执行动作与后续 Trace 指标按时间线展示，形成可复盘的质量改进报告。