yuqei
a3bb78e06b
Security Quality Gate / npm audit, Bandit, pip-audit, detect-secrets (pull_request) Failing after 16m35s
3.9 KiB
3.9 KiB
V2 AI 配置执行动作增强闭环 - 2026-06-23
本轮目标
继续遵循《AI 合同平台 V2 重构版开发方案》，把质量改进项详情页中的执行动作继续落到真实配置管理能力上：
- Prompt 草稿创建后能直达草稿并发布。
- 知识库支持真实文件上传、解析、入库、切分和索引状态展示。
- 模型参数发布记录支持对比，并能从发布前快照发起回滚。
本轮仍保持 V2 分层：AI Platform 负责 Prompt、知识库、模型配置和审计；Contract Web 只提供管理员操作入口和同源代理。
完成内容
-
Prompt 草稿直达发布
- 质量改进项详情页创建 Prompt 草稿后，返回带
publish=1的 Prompt 中心定位链接。 - Prompt 中心读取
templateId、version、publish=1后自动定位草稿版本。 - 目标草稿卡片展示发布提示，管理员审阅无误后可直接发布为运行版本。
- 已关联草稿的质量改进项详情页提供“进入草稿发布”入口。
- 质量改进项详情页创建 Prompt 草稿后，返回带
-
知识库真实文件上传
- AI Platform 新增
POST /api/v1/knowledge-bases/{knowledge_base_id}/documents。 - 支持
txt、md、csv、json、pdf、docx文件解析。 - 上传后自动创建导入批次、写入知识文档、切分 chunk，并返回解析状态。
- OpenAPI 新增
KnowledgeDocumentUploadResult。 - Python SDK 新增
upload_knowledge_document。 - Contract Web 新增同源代理：
/api/ai-platform/knowledge-bases/[knowledgeBaseId]/documents
- 知识库管理页新增“上传知识文件”面板，上传后自动展开新批次并展示文档/chunk 状态。
- AI Platform 新增
-
模型参数对比与回滚入口
- 模型参数发布记录详情页继续展示发布前/发布后快照。
- 当存在发布前快照时，详情页提供“回滚到发布前参数”入口。
- 模型配置页读取
rollbackFromChange参数后，把发布前快照预填到编辑表单。 - 管理员保存后生成一条新的模型参数发布记录，保证回滚动作也进入审计链。
- 模型配置列表中的发布记录增加“查看对比”入口。
路线核查
- 没有把模型 provider 调用、Prompt 拼装或知识库内部表操作塞回合同业务系统。
- 文件解析入口在 AI Platform 中实现，Contract Web 只转发
FormData。 - 模型回滚没有绕过审计，而是复用模型配置保存能力生成新的发布记录。
- Prompt 发布仍要求管理员在 Prompt 中心审阅后手动发布，避免质量改进项详情页越权直接改变运行版本。
- 当前文件解析是同步 MVP；大文件、OCR、失败重试和长流程状态后续应进入 worker/durable workflow。
验证结果
python -m pytest yuqei-ai-platform\services\ai-platform-api\tests\test_platform_data.py -q- 21 passed
python -m pytest yuqei-ai-sdk-python\tests\test_ai_platform.py -q- 2 passed
npm --prefix yuqei-contract-platform/apps/contract-web run build- passed
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')"- openapi ok
git diff --check- passed，仅有 Windows LF/CRLF 提示
当前闭环价值
现在质量运营链路进一步变成：
- Trace 或质量看板发现问题。
- 创建质量改进项。
- 在改进项详情页选择处理动作。
- Prompt 问题直达草稿并发布。
- 知识库问题可上传真实文件并看到解析/切片状态。
- 模型问题可查看参数版本对比，并从旧快照回滚生成新审计记录。
- 后续 Trace 继续用于回看质量是否改善。
下一步建议
- 知识库上传接入 worker 任务状态、失败重试和 OCR。
- Prompt 发布记录增加版本 diff 和回滚前影响提示。
- 模型参数回滚前增加风险确认和变更审批。
- 将 Prompt 发布、知识库上传、模型回滚统一纳入配置执行时间线。