ai-contract-platform/project-docs/V2-ai-platform-persistence-prompt-audit-2026-06-22.md

V2 AI Platform Persistence, Prompt, Knowledge, and Audit Closure

日期：2026-06-22

本轮目标

本轮继续推进 yuqei-ai-platform，把前一轮只停留在内存演示的模型配置、知识库检索和 AI 调用审计，补成可持久化、可由 SDK 调用、可由 OpenAPI 描述的 MVP 闭环。

已完成

1. 仓库层抽象

   • 新增 AiPlatformRepository 协议。
   • 保留 InMemoryAiPlatformRepository 作为本地和测试默认实现。
   • 新增 SqlAlchemyAiPlatformRepository，支持模型配置、Prompt 模板、知识文档、AI 调用审计落库。

2. 配置切换

   • 新增 AI_PLATFORM_REPOSITORY_BACKEND。
   • 可选值：memory、sqlalchemy。
   • 新增 AI_PLATFORM_DATABASE_AUTO_CREATE，MVP 阶段可自动建表，后续正式部署再切到 Alembic migration。

3. Prompt 模板闭环

   • 新增 PromptTemplateCreate、PromptTemplate。
   • 新增接口：
     • GET /api/v1/prompt-templates
     • POST /api/v1/prompt-templates
   • 法律问答审计会记录当前 legal_qa.default 的 prompt_template_id。

4. SDK 能力扩展

   • yuqei-ai-sdk-python 新增：
     • list_model_configs
     • upsert_model_config
     • list_prompt_templates
     • upsert_prompt_template
     • add_knowledge_document
     • search_knowledge_documents
     • list_ai_run_audits

5. OpenAPI 契约同步

   • 新增 Prompt 模板路径和 schema。
   • 修正 AI 审计列表参数为当前实现使用的 limit。
   • 补齐健康检查响应字段。

验证结果

已通过：

python -m pytest

结果：

16 passed

新增覆盖：

• Prompt 模板可热更新并列表读取。
• SQLite 持久化仓库可跨 repository 实例读取模型配置、Prompt、知识文档和审计记录。
• SDK 覆盖 AI 中台管理类接口。
• 法律问答审计可关联 Prompt 模板。

当前边界

本轮还没有做：

• Alembic migration 文件。
• PostgreSQL 真库部署演练。
• 向量检索和混合排序。
• 真实模型 provider 调用。
• token、费用、错误重试等更完整的调用审计字段。

下一轮建议

下一轮进入 AI Platform 的真实运行能力：

1. 建立 Alembic migration，并把自动建表降级为本地开发能力。
2. 加入 provider adapter 抽象，先实现 OpenAI-compatible / DeepSeek-compatible 调用。
3. 把法律问答从规则型回答升级为：知识检索 -> Prompt 模板渲染 -> Provider 调用 -> 引用与审计落库。
4. 为知识库增加导入批次、切分结果、检索命中分数和来源定位。