diff --git a/.gitignore b/.gitignore index 1674678..383f235 100644 --- a/.gitignore +++ b/.gitignore @@ -21,6 +21,7 @@ frontend/vite.config.d.ts !.env.example *.log +celerybeat-schedule* logs/ tmp/ diff --git a/docs/development/ai-platform-demo-acceptance.md b/docs/development/ai-platform-demo-acceptance.md index 5d859a6..86b5e07 100644 --- a/docs/development/ai-platform-demo-acceptance.md +++ b/docs/development/ai-platform-demo-acceptance.md @@ -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;密钥和完整输入未写入验收记录 +``` diff --git a/docs/product/blueprint.md b/docs/product/blueprint.md index 7480e34..17bd917 100644 --- a/docs/product/blueprint.md +++ b/docs/product/blueprint.md @@ -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 平台。其后下一份实施文档必须是“可信建单闭环设计”。 diff --git a/docs/product/capability-status.md b/docs/product/capability-status.md index 783ea13..e10e23b 100644 --- a/docs/product/capability-status.md +++ b/docs/product/capability-status.md @@ -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 可交互,不视为真实能力。