docs: record real ai platform acceptance
This commit is contained in:
hailin
1
.gitignore
vendored
1
.gitignore
vendored
@@ -21,6 +21,7 @@ frontend/vite.config.d.ts
|
||||
!.env.example
|
||||
|
||||
*.log
|
||||
celerybeat-schedule*
|
||||
logs/
|
||||
tmp/
|
||||
|
||||
|
||||
@@ -10,9 +10,9 @@
|
||||
| 全新数据库迁移 | 已通过 | 测试配置下从空库应用全部迁移 |
|
||||
| 前端自动化 | 已通过 | 38 项 Vitest；覆盖异步轮询、失败态、发布、运行详情、取消、应用壳层、个人中心和本地 Agent 面板；ESLint、类型检查与生产构建通过 |
|
||||
| 本地界面人工验收 | 已通过 | 桌面端管理工作台由项目验收人确认正常 |
|
||||
| 真实模型三步运行 | 待执行 | 凭证仅允许管理员在本地录入，不进入仓库 |
|
||||
| 真实模型三步运行 | 已通过 | `openai / gpt-5.4-mini` 完成草稿沙箱和发布版本三步运行 |
|
||||
|
||||
真实模型三步运行通过前，本演示版只能描述为“实现完成、真实渠道验收待完成”。
|
||||
AI 平台配置演示版固定验收已完成。该结论只覆盖模型、Skill、Agent 配置与运行底座，不代表可信建单业务闭环已经完成。
|
||||
|
||||
## 前置条件
|
||||
|
||||
@@ -56,3 +56,25 @@
|
||||
结论：通过 / 不通过
|
||||
备注（禁止粘贴密钥和完整敏感输入）：
|
||||
```
|
||||
|
||||
## 2026-07-16 本地验收记录
|
||||
|
||||
```text
|
||||
日期：2026-07-16
|
||||
执行人：本地管理员 / Codex
|
||||
渠道名称 / 模型名：openai / gpt-5.4-mini
|
||||
模型测试 UUID：1eee4eb3-ace8-4bc5-9d92-81b8ed096412
|
||||
模型测试结果：成功；输入 13 Token；输出 61 Token；耗时 6031 ms；重试 0 次
|
||||
草稿运行 UUID：2c0cd282-adab-4efe-ab8e-c827ef85a267
|
||||
草稿运行结果：成功；3 步；输入 2678 Token；输出 3307 Token；耗时 70968 ms
|
||||
发布运行 UUID：d8ef43d4-27b5-44e8-b616-ac809e15a906
|
||||
发布运行结果：成功；3 步；输入 3250 Token；输出 3815 Token；耗时 75406 ms
|
||||
结构修复：三个步骤均触发一次结构修复并成功
|
||||
最终输出：等于最后一个 reply 步骤输出
|
||||
旧版本快照检查：通过；创建版本 2 草稿后，两次历史运行仍固定为版本 1
|
||||
回滚检查：通过；激活版本回滚到版本 1
|
||||
权限与审计检查：通过；无权限账号入口隐藏，四类 AI API 返回 403，抽查 31 条审计记录无完整敏感正文
|
||||
凭证检查：通过；API 不返回 api_key，已配置凭证只返回脱敏值
|
||||
结论：通过
|
||||
备注：宿主机 Celery worker 必须继承 AI_CREDENTIAL_ENCRYPTION_KEY；密钥和完整输入未写入验收记录
|
||||
```
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# AI 工单平台项目蓝图
|
||||
|
||||
更新日期：2026-07-14
|
||||
更新日期：2026-07-16
|
||||
状态：当前唯一主蓝图
|
||||
需求基线：[2026-06-30 AI 工单平台设计沟通记录](../communication/2026-06-30-ai-ticket-platform-discussion-log.md)
|
||||
|
||||
@@ -120,7 +120,7 @@ flowchart LR
|
||||
|
||||
## 6. 当前真实基线
|
||||
|
||||
截至 2026-07-14，仓库并非空白项目。重规划必须在已有实现上演进。
|
||||
截至 2026-07-16，仓库并非空白项目。重规划必须在已有实现上演进。
|
||||
|
||||
| 能力 | 当前状态 | 蓝图判断 |
|
||||
|---|---|---|
|
||||
@@ -130,9 +130,10 @@ flowchart LR
|
||||
| 工单 | 已有创建、列表、详情、编辑、分类流转、评论、附件元数据、导出 | 补真实文件上传、协作和业务一致性 |
|
||||
| 解决方案 | 已有维护、关联、采纳和工单处理结果 | 保留，统一权威数据来源 |
|
||||
| 知识库 | 已有知识库、条目、切片和检索 API | 当前是 JSON 向量和确定性哈希检索，不能视为真实向量能力 |
|
||||
| 模型、Agent、Skill、MCP | 前端存在类型和演示数据 | 尚无真实后端闭环 |
|
||||
| 模型、Agent、Skill | 已完成真实渠道、版本配置、Celery 有序运行和轨迹 | Demo Milestone 已通过真实三步验收 |
|
||||
| MCP | 尚无实现 | 按原蓝图推迟到可信业务闭环之后 |
|
||||
| Docker Compose | 有 PostgreSQL、Redis、MinIO、前后端和 worker 基础 | 补生产化配置、健康检查和恢复流程 |
|
||||
| 自动化验证 | 后端 43 项测试、前端 6 项测试当前通过；前端可类型检查和构建 | 覆盖面仍不足以证明端到端可用 |
|
||||
| 自动化验证 | 后端 79 项、前端 38 项测试通过；Ruff、迁移、Django、ESLint、类型检查和构建通过 | AI 配置底座已完成真实端到端验收，业务闭环仍待实施 |
|
||||
|
||||
当前需要正视的结构债务：
|
||||
|
||||
@@ -140,7 +141,7 @@ flowchart LR
|
||||
- `Ticket.resolution_summary` 与 `TicketResolution` 存在权威来源重叠，需要明确实例处理结果以 `TicketResolution` 为准。
|
||||
- `KnowledgeChunk.embedding` 使用 JSON，检索在应用内遍历并限制前 1000 条，只适合功能桩，不适合真实知识检索。
|
||||
- 附件 API 当前记录存储路径和元数据，但不等于已经完成 MinIO 上传、解析、病毒/类型校验和访问控制。
|
||||
- 原型和概念页面可以作为设计资产，但不计入真实产品完成度；默认业务导航不得让用户误认演示操作已经持久化。
|
||||
- `/concept` 设计实验室及其 Mock 数据已删除；全局 Agent 助手仍必须明确标注本地演示且不得写入业务数据。
|
||||
|
||||
## 7. 目标架构
|
||||
|
||||
@@ -319,7 +320,7 @@ Skill 是有版本的配置型专业能力，不是代码插件。每个 Skill
|
||||
- 同一确认请求具备幂等性，不会重复建单。
|
||||
- 正常、拒绝、人工修改、模型失败和超时路径均有自动化测试。
|
||||
|
||||
### Demo Milestone：AI 平台配置演示版
|
||||
### Demo Milestone：AI 平台配置演示版（已完成）
|
||||
|
||||
该里程碑位于 Phase 0 与 Phase 1 之间，是面向研发管理员的真实运行验证，不等同于业务试运行版本。它用于提前验证模型渠道、配置型 Skill、版本化 Agent 和异步执行轨迹能否形成稳定技术底座，完成后仍按 Phase 1 接入可信建单闭环。
|
||||
|
||||
@@ -490,15 +491,15 @@ AI 不单独占据主要工作流：建单辅助出现在创建工单页，支
|
||||
|
||||
## 16. 立即执行的下一迭代
|
||||
|
||||
当前迭代已完成 AI 平台配置演示版的代码与自动化检查，正在等待管理员在本地提供真实渠道凭证并执行固定端到端验收。该演示只包含模型、Agent 和 Skill，不启动 MCP，也不计为业务闭环完成。
|
||||
AI 平台配置演示版已于 2026-07-16 完成真实渠道固定端到端验收。草稿沙箱与发布版本均完成三步运行，版本快照、结构修复、权限拒绝、凭证脱敏和审计抽查通过。该演示只包含模型、Agent 和 Skill，不启动 MCP，也不计为业务闭环完成。
|
||||
|
||||
当前收尾与下一阶段任务顺序：
|
||||
|
||||
1. 使用本地真实凭证执行 AI 平台固定端到端验收，记录渠道、模型和运行编号，不记录密钥。
|
||||
2. 验证无 AI 权限账号的菜单隐藏、后端拒绝和审计脱敏。
|
||||
3. 真实验收通过后关闭 Demo Milestone，并为 Phase 1 编写“可信建单闭环设计”。
|
||||
4. 写出 `TicketResolution`、`AgentArtifact`、知识版本和引用快照的数据决策记录。
|
||||
5. 禁止新增代码读取或写入 `Ticket.ai_solution`，设计兼容迁移。
|
||||
1. 为 Phase 1 编写“可信建单闭环设计”，明确自然语言草稿、人工确认和幂等建单契约。
|
||||
2. 写出 `TicketResolution`、`AgentArtifact`、知识版本和引用快照的数据决策记录。
|
||||
3. 禁止新增代码读取或写入 `Ticket.ai_solution`，设计兼容迁移。
|
||||
4. 将已验证的 Agent 运行底座接入建单草稿，不允许模型直接写工单业务表。
|
||||
5. 完成草稿确认、人工修改、拒绝、模型失败和超时路径。
|
||||
6. 为工单创建、状态流转、方案采纳和知识检索补最小跨端回归。
|
||||
|
||||
AI 平台配置演示只验证真实运行底座，不建设通用 Agent 平台。其后下一份实施文档必须是“可信建单闭环设计”。
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
| 解决方案 | 维护、关联、采纳并关闭工单 | 真实 | 已有 API、事件和使用次数统计 |
|
||||
| 知识 | 知识库、条目、文档文本、切片和检索 | 真实 | 基础 CRUD 与检索 API 可运行 |
|
||||
| 知识 | 向量检索 | 演示 | 使用 JSON 哈希向量和应用内排序，不是 pgvector/真实 Embedding |
|
||||
| AI 平台 | 模型渠道和真实模型测试 | 真实 | OpenAI-compatible 适配器、凭证加密/脱敏、异步测试和一次瞬时重试已实现；真实渠道凭证验收待本地执行 |
|
||||
| AI 平台 | 模型渠道和真实模型测试 | 真实 | OpenAI-compatible 适配器、凭证加密/脱敏、异步测试和一次瞬时重试已实现；本地真实渠道验收通过 |
|
||||
| AI 平台 | Skill 草稿、发布、Schema 和回滚 | 真实 | 受限模板、JSON Schema、不可变发布版本、克隆草稿和按版本回滚已实现 |
|
||||
| AI 平台 | Agent 版本、有序执行和运行轨迹 | 真实 | 草稿沙箱、发布校验、Celery 有序执行、失败终止、结构修复、取消、快照和运行详情已实现 |
|
||||
| AI 平台 | MCP | 缺失 | 不在本次演示范围 |
|
||||
@@ -39,6 +39,7 @@
|
||||
- 前端已按路由懒加载拆包，生产主入口约 479.90 KB，无 Vite 体积告警。
|
||||
- `/concept` 设计实验室及其 Mock 数据已按产品决策删除；正式路由测试禁止重新引入概念页面。
|
||||
- 本地桌面端界面人工验收已通过。
|
||||
- 真实模型渠道的三步端到端脚本尚未执行，因为凭证必须由管理员在本地提供；在该步骤通过前，不声明演示里程碑验收完成。
|
||||
- 真实模型三步端到端脚本已通过：草稿沙箱与发布版本均成功，版本快照、结构修复、权限拒绝和审计脱敏符合约定。
|
||||
- AI 平台配置 Demo Milestone 已完成；下一阶段回到 Phase 1“可信建单闭环”。
|
||||
|
||||
能力状态只依据已验证代码更新。页面存在、类型定义存在或 Mock 可交互，不视为真实能力。
|
||||
|
||||
Reference in New Issue
Block a user