从技术能力到可使用产品AI Workload Platform 的前六个模块已经完成了工作流内核、可靠控制面、Agent Runtime、独立 Worker、可观测性和受限执行器。此时系统可以通过 CLI、JSON 和 HTTP API 工作但新用户仍然需要记住很多命令也看不到一条连续的产品流程。HTTP API 是通过 HTTP 请求访问服务能力的接口PostgreSQL 是保存这些业务状态的关系型数据库。模块 7要解决的不是新的调度算法而是“如何让一个没有读过源码的人完成一次受控的工作流运行”输入自然语言目标查看 Agent 生成的草稿确认后创建不可变 Workflow启动 Run在浏览器中观察 Task/Event、处理错误和取消并按需通过 API 查询 Attempt 详情。本文中的“真实场景”指真实可操作的产品使用流程不代表模型已经接入真实供应商。默认演示使用离线 Mock Model 和 Mock Executor真实模型兼容性本次不做外部调用只说明代码支持的协议边界。1. 为什么模块 7此时出现模块 6已经证明任务可以进入 Docker 或 Kubernetes 的受限环境但验证入口仍然偏向开发者需要启动多个终端、手工准备 JSON、复制 Run ID再用 curl 查询状态。这样的入口适合调试不适合作为产品演示也不能充分体现前后端整合能力。因此模块 7增加一个轻量 Web 控制台并保持三个边界Go 控制面和 PostgreSQL 仍是 Workflow、Run、Task、Attempt、Event 和 Worker 状态的唯一事实源浏览器不连接 PostgreSQL、Docker Engine 或 Kubernetes API不复制 DAG、重试、取消、租约和恢复逻辑Agent 草稿必须经过服务端校验、内容哈希确认和 operator操作员授权模型输出不能直接执行。这说明模块 7不是“把所有功能搬到前端”而是给已有可靠能力增加一个可操作入口。2. 一次完整的用户流程假设用户输入先读取 article.md再清洗内容最后生成摘要。控制台按下面的顺序工作步骤用户动作服务端动作是否产生业务事实1输入自然语言目标调用 Agent Runtime 生成WorkflowDraft否草稿只在请求和浏览器会话中存在2查看任务、事实、假设和问题展示结构化草稿否3点击校验检查 Action、Input、依赖、超时、权限和 DAG否4确认内容和哈希重新计算哈希确认草稿未被替换否5点击创建并运行通过已有 Workflow API 创建不可变版本再启动 Run是写入 PostgreSQL6查看详情查询 Run、Task、Attempt 和 Event只读7点击取消或等待完成调用控制面取消接口或继续轮询终态是状态由控制面决定Draft草稿是“尚未成为正式 Workflow 的中间对象”。它可以包含用户事实、Agent 假设、待回答问题和校验结果只有确认后的WorkflowDefinition才能进入模块 2的控制面。图 1脱敏的本地 Mock 演示总览。页面将运行摘要、在线 Worker 和观测入口放在同一个工作区数据均来自控制面 API。进入“创建草稿”页面后先输入自然语言目标。此时页面只收集目标不会创建 Workflow 或启动 Run。图 2创建草稿页。自然语言目标会发送给 Draft API由服务端生成待审核的结构化草稿。点击“生成草稿”和“校验草稿”后页面会展示任务、依赖、事实、假设、待确认问题和校验结果。校验通过仍然只是允许进入确认阶段。图 3草稿校验页。绿色校验结果表示草稿满足当前规则不表示任务已经执行。3. Draft API为什么需要服务端审核控制台新增三条版本化 HTTP APIPOST /api/v1/agent/drafts根据goal生成草稿POST /api/v1/agent/drafts/{draft-id}/validate重新校验草稿POST /api/v1/agent/drafts/{draft-id}/confirm提交草稿和原始content_hash确认后返回最终工作流定义。一个生成请求的最小形式是{goal:先读取 article.md再清洗内容最后生成摘要}返回的草稿包含definition、facts、assumptions、questions、validation和content_hash。前端可以展示这些字段但不能自行把它们拼接成数据库记录。确认时服务端会检查三件事路径中的 Draft ID 与 Body 中的 ID 一致草稿当前状态允许确认重新计算出的哈希与用户看到的哈希一致。浏览器修改任务、依赖、事实或假设后即使 JSON 仍然合法也会因为哈希不一致被拒绝。确认成功只代表得到一个可提交的WorkflowDefinition不代表 Workflow 已经写入数据库。控制台随后使用新的幂等 Key 调用已有 Workflow 创建接口再使用另一个幂等 Key 启动 Run。这样 Draft 审核和控制面持久化可以分别测试。4. 前后端边界控制台只调用公开的控制面 API浏览器 - Draft API生成、校验、确认 - Workflow API创建不可变版本 - Run API启动、查询、取消 - Worker/Observability 查询 API展示状态和指标 控制面 - Agent Runtime 和 Model Adapter - PostgreSQL - Worker、Docker 或 Kubernetes浏览器不直接调用 Worker 的注册、领取、心跳、完成或 drain 接口。Worker 协议属于内部执行边界前端绕过控制面会破坏租约、权限和状态审计。5. 为什么选择 React、TypeScript 和 ViteReact 是按组件组织用户界面的 JavaScript 库。页面可以拆成导航、表格、状态徽章、草稿审核和运行详情等组件局部状态变化不会要求重新加载整个页面。TypeScript 是带静态类型的 JavaScript。它可以在构建阶段发现 API 字段拼写错误、状态枚举不一致和组件属性缺失。对这个项目来说前端要展示的状态很多静态类型比完全依赖运行时观察更容易维护。Vite 是前端开发服务器和构建工具提供快速热更新和生产构建。开发环境通过代理把/api、/health和/metrics转发到 Go 控制面因此浏览器不需要额外配置跨域。没有选择 Next.js是因为当前不需要服务端渲染、后端路由或全栈部署没有引入大型状态管理库是因为页面共享状态只有会话、当前 Draft 和当前 Run组件状态与sessionStorage已足够。代价是以后如果页面数量、缓存关系或离线编辑显著增加需要重新评估路由和状态管理方案。控制台是 SPASingle-Page Application单页应用浏览器首次加载 HTML 和 JavaScript之后通过 API 更新数据不为每个页面重新请求一份 HTML。当前导航使用页面状态切换业务数据仍然来自控制面。6. 会话、角色和 TokenBearer Token 是放在 HTTPAuthorization头中的访问凭证。登录页让用户输入控制面地址、角色和 Token前端只把它们保存到当前标签页的sessionStorage刷新当前标签页后可以恢复会话关闭标签页后会清除 Token 和未提交草稿Token 不写入 URL、仓库、日志或数据库在新的本地环境中必须重新创建.env.local并生成新的本地 Token。viewer 角色只能查询operator 才能生成、校验、确认草稿、创建 Workflow、启动和取消 Run。前端会隐藏不适用的操作但真正的权限判断仍由服务端完成因此不能把按钮隐藏当成安全机制。控制台不保存模型 API Key。真实模型配置留在控制面进程的环境变量中浏览器只携带平台 Token。这样模型供应商凭证不会随页面请求进入客户端。7. 页面和状态设计7.1 草稿页面Create 页面只收集自然语言目标并调用 Draft API。Draft Review 页面展示用户事实和 Agent 假设未解决问题和校验警告每个任务的 key、Action、依赖和超时Input 与重试策略仍保存在 Draft JSON 和 API 响应中当前轻量表格没有逐项展开当前 Draft 状态和内容哈希。存在校验错误或未解决问题时确认按钮不可用。服务端返回draft_changed时页面要求重新校验而不是自动覆盖用户看到的草稿。图 4脱敏的本地 Mock 演示草稿确认页。用户可以在执行前查看事实、假设、任务依赖和校验结果。点击“确认并启动运行”后控制台会先确认 Draft再创建不可变 Workflow 版本并启动 Run。运行记录页会先显示新 Run 的状态和任务进度。图 5Run 创建后的运行记录页。此时请求已经被控制面接受任务是否完成仍以服务端状态为准。7.2 Run 详情页Run Detail 页面查询 Run 摘要、Task 列表和 Event 时间线并提供运行中的取消按钮。Attempt 记录可通过控制面 Task 详情 API 查询当前轻量页面没有把每条 Attempt 历史逐项展开。Run 进入succeeded、failed、canceled或其他终态后停止轮询。Task 和 Attempt 的状态由控制面返回前端不根据“请求已经发出”自行显示成功。没有 Worker 时Run 可以停留在ready或queued这属于真实系统状态页面不能伪造进度。图 6脱敏的本地 Mock 演示 Run/Task 详情页。状态、任务和事件时间线由控制面返回终态后停止轮询。7.3 Workers 和 ObservabilityWorkers 页面展示 Worker 会话、能力、并发和活动租约Observability 页面展示低基数 Prometheus 指标摘要和原文入口。两页只读查询不执行 Worker 生命周期操作。图 7Worker 状态页。active表示 Worker 会话仍在心跳mock表示当前演示使用模拟执行器并发和活动租约用于判断是否有执行槽位被占用。图 8观测指标页。页面展示控制面导出的低基数 Metrics 原文用于快速检查数据库连接、HTTP 请求和租约等运行信号。8. 轮询和错误处理轮询是客户端按固定间隔重复发送查询请求。当前选择轮询而不是 WebSocket 或 SSEServer-Sent Events服务器推送事件原因是本项目的数据量和实时性要求有限固定请求更容易部署、测试和排查。未来如果事件数量增加或延迟要求提高可以在已有 Event 模型之上评估推送。每次查询使用AbortController传递取消信号离开页面或切换 Run 时取消旧请求避免旧数据覆盖新页面。服务端返回终态后Hook 不再创建新的定时器。需要明确区分几类失败状态页面行为401提示 Token 无效保留 API 地址和用户输入403说明当前角色没有该操作权限404说明资源不存在或 Run ID 已失效409展示草稿哈希、Workflow 冲突或幂等冲突不自动重复写请求503展示控制面未就绪等待用户检查服务和数据库网络中断保留当前输入不重放结果不明确的写请求写请求不自动重试。因为创建 Workflow 或启动 Run 的请求可能已经在服务端提交成功盲目重试会产生重复版本或语义不清的结果用户可以根据返回的幂等 Key 和资源查询结果决定下一步。9. 测试分层前端测试使用 Vitest、React Testing Library 和 JSDOM模拟浏览器 DOM 的测试环境覆盖Token 保存、恢复、退出清除和角色边界Bearer Header、JSON Header、幂等 Header 和统一错误信封草稿生成、校验、哈希确认和篡改错误Workflow 创建、Run 启动、轮询、取消、完成和失败Task、Event、Worker 和 Metrics 的加载、空状态和错误状态Attempt 详情由后端 API 和独立查询测试覆盖npm run typecheck和npm run build。后端继续运行 Draft API、OpenAPI、Agent Runtime 和控制面测试。浏览器人工验收则验证一条完整闭环生成 Draft查看事实和假设确认并创建 Workflow启动 Run看到 Task 和 Event按需通过 API 查询 Attempt最后刷新页面确认状态来自 API 而不是前端内存。模块 7当前本地闭环使用 PostgreSQL、Mock Model 和 Mock Executor实际观察到三个任务成功。这个结果证明的是控制台和 API 集成不证明真实模型的规划质量、Kubernetes 网络隔离或生产容量。10. 本地运行与复现本节只保留理解项目所需的最短运行流程。完整的终端职责、Docker Desktop、PostgreSQL、迁移、控制面、Worker、Vite、Token、环境准备和故障排查步骤收录在项目仓库的docs/部署/本地开发与配置.md可从下文的 GitHub 仓库首页进入。最短流程是安装 Go、Node.js 24 LTS、npm、Docker Desktop 和jq克隆仓库复制.env.example为.env.local重新生成三个不同的本地 Token启动 PostgreSQL执行迁移启动控制面和至少一个 Worker在web/执行npm ci和npm run dev浏览器输入 operator Token按本文第 2节的目标完成闭环。Git 仓库只保存代码、迁移、Compose 配置、环境变量模板和示例。Docker 镜像缓存、容器、数据库卷、.env.local、Token、密码和日志属于本地环境需要在运行项目的环境中单独准备。项目源码、完整运行手册和每个模块的验证证据会随开源仓库持续更新AI Workload Platform GitHub 仓库。读者可以先阅读仓库首页再按照部署手册启动本地环境需要注意默认演示使用 Mock Model不要求购买模型服务。11. 开源发布和 CICIContinuous Integration持续集成是在每次提交时自动运行格式化、测试和构建。CDContinuous Delivery/Deployment持续交付/部署是把通过验证的产物交给发布流程本项目当前只建立 CI 门禁不自动部署生产环境。GitHub Actions 会运行 Go 测试、竞态检测、go vet、文档检查、Kubernetes 清单检查以及前端npm ci、测试、类型检查和构建。依赖版本由go.mod、go.sum和 npm lockfile 固定CI 不访问真实模型、本机数据库或付费服务。开源治理文件各有职责LICENSE说明代码授权条件CONTRIBUTING.md说明如何提交问题和变更SECURITY.md说明如何报告安全问题CODE_OF_CONDUCT.md说明协作行为边界CHANGELOG.md记录公开版本变化scripts/check-secrets.sh和依赖许可证检查降低误公开风险。这些文件不能替代安全审查。容器执行器仍有明确的输入、镜像、网络和权限边界不能宣传为绝对安全沙箱。12. 真实模型协议边界本次不执行项目已经有 OpenAI-compatible HTTP Model Adapter但默认关闭真实模型。本次不执行外部模型调用也不要求读者准备 API Key。适配器代码可以发送model、messages、工具定义和 JSON Schemaresponse_format并处理工具调用后的下一轮消息这只是协议实现不代表已经验证过某个供应商。模块 3 的自动化测试使用本机 HTTP 模拟服务验证请求格式、工具调用消息、结构化输出、429、非法响应和取消。未来如果需要验证具体供应商应单独记录供应商、模型、响应质量、错误边界和费用并确保凭证只存在本机配置中不能把未执行的兼容性实验写成项目已有能力。13. 结论和限制模块 7完成后项目拥有一条可演示的产品闭环自然语言目标进入 Draft服务端校验和哈希确认阻止未审核定义执行控制面创建不可变 Workflow 并启动 Run浏览器展示 Task、Event、Worker 和 MetricsAttempt 详情仍可通过控制面 API 查询。已经验证的是本地 PostgreSQL、Mock Model、Mock Executor、前端自动化测试、类型检查和生产构建。尚未验证的是某个真实模型供应商的规划质量、所有 OpenAI-compatible 接口的兼容性、生产容量和完整的 Kubernetes 安全隔离。控制台的价值是降低使用和演示门槛不是替代后端可靠性。即使浏览器关闭Workflow、Run、Task 和 Attempt 仍由控制面和 PostgreSQL 保存浏览器重新打开后可以重新查询服务端状态但未提交的 Draft 不会自动恢复。14. 参考资料React 文档TypeScript 文档Vite 文档Vitest 文档React Testing LibraryGitHub Actions 文档项目源码本文对应模块 7。完整源码、部署手册、验证报告和其他学习文章见 AI Workload Platform GitHub 仓库。
从 0 构建 AI Workload Platform（九）：真实场景、最小控制台与开源发布
从技术能力到可使用产品AI Workload Platform 的前六个模块已经完成了工作流内核、可靠控制面、Agent Runtime、独立 Worker、可观测性和受限执行器。此时系统可以通过 CLI、JSON 和 HTTP API 工作但新用户仍然需要记住很多命令也看不到一条连续的产品流程。HTTP API 是通过 HTTP 请求访问服务能力的接口PostgreSQL 是保存这些业务状态的关系型数据库。模块 7要解决的不是新的调度算法而是“如何让一个没有读过源码的人完成一次受控的工作流运行”输入自然语言目标查看 Agent 生成的草稿确认后创建不可变 Workflow启动 Run在浏览器中观察 Task/Event、处理错误和取消并按需通过 API 查询 Attempt 详情。本文中的“真实场景”指真实可操作的产品使用流程不代表模型已经接入真实供应商。默认演示使用离线 Mock Model 和 Mock Executor真实模型兼容性本次不做外部调用只说明代码支持的协议边界。1. 为什么模块 7此时出现模块 6已经证明任务可以进入 Docker 或 Kubernetes 的受限环境但验证入口仍然偏向开发者需要启动多个终端、手工准备 JSON、复制 Run ID再用 curl 查询状态。这样的入口适合调试不适合作为产品演示也不能充分体现前后端整合能力。因此模块 7增加一个轻量 Web 控制台并保持三个边界Go 控制面和 PostgreSQL 仍是 Workflow、Run、Task、Attempt、Event 和 Worker 状态的唯一事实源浏览器不连接 PostgreSQL、Docker Engine 或 Kubernetes API不复制 DAG、重试、取消、租约和恢复逻辑Agent 草稿必须经过服务端校验、内容哈希确认和 operator操作员授权模型输出不能直接执行。这说明模块 7不是“把所有功能搬到前端”而是给已有可靠能力增加一个可操作入口。2. 一次完整的用户流程假设用户输入先读取 article.md再清洗内容最后生成摘要。控制台按下面的顺序工作步骤用户动作服务端动作是否产生业务事实1输入自然语言目标调用 Agent Runtime 生成WorkflowDraft否草稿只在请求和浏览器会话中存在2查看任务、事实、假设和问题展示结构化草稿否3点击校验检查 Action、Input、依赖、超时、权限和 DAG否4确认内容和哈希重新计算哈希确认草稿未被替换否5点击创建并运行通过已有 Workflow API 创建不可变版本再启动 Run是写入 PostgreSQL6查看详情查询 Run、Task、Attempt 和 Event只读7点击取消或等待完成调用控制面取消接口或继续轮询终态是状态由控制面决定Draft草稿是“尚未成为正式 Workflow 的中间对象”。它可以包含用户事实、Agent 假设、待回答问题和校验结果只有确认后的WorkflowDefinition才能进入模块 2的控制面。图 1脱敏的本地 Mock 演示总览。页面将运行摘要、在线 Worker 和观测入口放在同一个工作区数据均来自控制面 API。进入“创建草稿”页面后先输入自然语言目标。此时页面只收集目标不会创建 Workflow 或启动 Run。图 2创建草稿页。自然语言目标会发送给 Draft API由服务端生成待审核的结构化草稿。点击“生成草稿”和“校验草稿”后页面会展示任务、依赖、事实、假设、待确认问题和校验结果。校验通过仍然只是允许进入确认阶段。图 3草稿校验页。绿色校验结果表示草稿满足当前规则不表示任务已经执行。3. Draft API为什么需要服务端审核控制台新增三条版本化 HTTP APIPOST /api/v1/agent/drafts根据goal生成草稿POST /api/v1/agent/drafts/{draft-id}/validate重新校验草稿POST /api/v1/agent/drafts/{draft-id}/confirm提交草稿和原始content_hash确认后返回最终工作流定义。一个生成请求的最小形式是{goal:先读取 article.md再清洗内容最后生成摘要}返回的草稿包含definition、facts、assumptions、questions、validation和content_hash。前端可以展示这些字段但不能自行把它们拼接成数据库记录。确认时服务端会检查三件事路径中的 Draft ID 与 Body 中的 ID 一致草稿当前状态允许确认重新计算出的哈希与用户看到的哈希一致。浏览器修改任务、依赖、事实或假设后即使 JSON 仍然合法也会因为哈希不一致被拒绝。确认成功只代表得到一个可提交的WorkflowDefinition不代表 Workflow 已经写入数据库。控制台随后使用新的幂等 Key 调用已有 Workflow 创建接口再使用另一个幂等 Key 启动 Run。这样 Draft 审核和控制面持久化可以分别测试。4. 前后端边界控制台只调用公开的控制面 API浏览器 - Draft API生成、校验、确认 - Workflow API创建不可变版本 - Run API启动、查询、取消 - Worker/Observability 查询 API展示状态和指标 控制面 - Agent Runtime 和 Model Adapter - PostgreSQL - Worker、Docker 或 Kubernetes浏览器不直接调用 Worker 的注册、领取、心跳、完成或 drain 接口。Worker 协议属于内部执行边界前端绕过控制面会破坏租约、权限和状态审计。5. 为什么选择 React、TypeScript 和 ViteReact 是按组件组织用户界面的 JavaScript 库。页面可以拆成导航、表格、状态徽章、草稿审核和运行详情等组件局部状态变化不会要求重新加载整个页面。TypeScript 是带静态类型的 JavaScript。它可以在构建阶段发现 API 字段拼写错误、状态枚举不一致和组件属性缺失。对这个项目来说前端要展示的状态很多静态类型比完全依赖运行时观察更容易维护。Vite 是前端开发服务器和构建工具提供快速热更新和生产构建。开发环境通过代理把/api、/health和/metrics转发到 Go 控制面因此浏览器不需要额外配置跨域。没有选择 Next.js是因为当前不需要服务端渲染、后端路由或全栈部署没有引入大型状态管理库是因为页面共享状态只有会话、当前 Draft 和当前 Run组件状态与sessionStorage已足够。代价是以后如果页面数量、缓存关系或离线编辑显著增加需要重新评估路由和状态管理方案。控制台是 SPASingle-Page Application单页应用浏览器首次加载 HTML 和 JavaScript之后通过 API 更新数据不为每个页面重新请求一份 HTML。当前导航使用页面状态切换业务数据仍然来自控制面。6. 会话、角色和 TokenBearer Token 是放在 HTTPAuthorization头中的访问凭证。登录页让用户输入控制面地址、角色和 Token前端只把它们保存到当前标签页的sessionStorage刷新当前标签页后可以恢复会话关闭标签页后会清除 Token 和未提交草稿Token 不写入 URL、仓库、日志或数据库在新的本地环境中必须重新创建.env.local并生成新的本地 Token。viewer 角色只能查询operator 才能生成、校验、确认草稿、创建 Workflow、启动和取消 Run。前端会隐藏不适用的操作但真正的权限判断仍由服务端完成因此不能把按钮隐藏当成安全机制。控制台不保存模型 API Key。真实模型配置留在控制面进程的环境变量中浏览器只携带平台 Token。这样模型供应商凭证不会随页面请求进入客户端。7. 页面和状态设计7.1 草稿页面Create 页面只收集自然语言目标并调用 Draft API。Draft Review 页面展示用户事实和 Agent 假设未解决问题和校验警告每个任务的 key、Action、依赖和超时Input 与重试策略仍保存在 Draft JSON 和 API 响应中当前轻量表格没有逐项展开当前 Draft 状态和内容哈希。存在校验错误或未解决问题时确认按钮不可用。服务端返回draft_changed时页面要求重新校验而不是自动覆盖用户看到的草稿。图 4脱敏的本地 Mock 演示草稿确认页。用户可以在执行前查看事实、假设、任务依赖和校验结果。点击“确认并启动运行”后控制台会先确认 Draft再创建不可变 Workflow 版本并启动 Run。运行记录页会先显示新 Run 的状态和任务进度。图 5Run 创建后的运行记录页。此时请求已经被控制面接受任务是否完成仍以服务端状态为准。7.2 Run 详情页Run Detail 页面查询 Run 摘要、Task 列表和 Event 时间线并提供运行中的取消按钮。Attempt 记录可通过控制面 Task 详情 API 查询当前轻量页面没有把每条 Attempt 历史逐项展开。Run 进入succeeded、failed、canceled或其他终态后停止轮询。Task 和 Attempt 的状态由控制面返回前端不根据“请求已经发出”自行显示成功。没有 Worker 时Run 可以停留在ready或queued这属于真实系统状态页面不能伪造进度。图 6脱敏的本地 Mock 演示 Run/Task 详情页。状态、任务和事件时间线由控制面返回终态后停止轮询。7.3 Workers 和 ObservabilityWorkers 页面展示 Worker 会话、能力、并发和活动租约Observability 页面展示低基数 Prometheus 指标摘要和原文入口。两页只读查询不执行 Worker 生命周期操作。图 7Worker 状态页。active表示 Worker 会话仍在心跳mock表示当前演示使用模拟执行器并发和活动租约用于判断是否有执行槽位被占用。图 8观测指标页。页面展示控制面导出的低基数 Metrics 原文用于快速检查数据库连接、HTTP 请求和租约等运行信号。8. 轮询和错误处理轮询是客户端按固定间隔重复发送查询请求。当前选择轮询而不是 WebSocket 或 SSEServer-Sent Events服务器推送事件原因是本项目的数据量和实时性要求有限固定请求更容易部署、测试和排查。未来如果事件数量增加或延迟要求提高可以在已有 Event 模型之上评估推送。每次查询使用AbortController传递取消信号离开页面或切换 Run 时取消旧请求避免旧数据覆盖新页面。服务端返回终态后Hook 不再创建新的定时器。需要明确区分几类失败状态页面行为401提示 Token 无效保留 API 地址和用户输入403说明当前角色没有该操作权限404说明资源不存在或 Run ID 已失效409展示草稿哈希、Workflow 冲突或幂等冲突不自动重复写请求503展示控制面未就绪等待用户检查服务和数据库网络中断保留当前输入不重放结果不明确的写请求写请求不自动重试。因为创建 Workflow 或启动 Run 的请求可能已经在服务端提交成功盲目重试会产生重复版本或语义不清的结果用户可以根据返回的幂等 Key 和资源查询结果决定下一步。9. 测试分层前端测试使用 Vitest、React Testing Library 和 JSDOM模拟浏览器 DOM 的测试环境覆盖Token 保存、恢复、退出清除和角色边界Bearer Header、JSON Header、幂等 Header 和统一错误信封草稿生成、校验、哈希确认和篡改错误Workflow 创建、Run 启动、轮询、取消、完成和失败Task、Event、Worker 和 Metrics 的加载、空状态和错误状态Attempt 详情由后端 API 和独立查询测试覆盖npm run typecheck和npm run build。后端继续运行 Draft API、OpenAPI、Agent Runtime 和控制面测试。浏览器人工验收则验证一条完整闭环生成 Draft查看事实和假设确认并创建 Workflow启动 Run看到 Task 和 Event按需通过 API 查询 Attempt最后刷新页面确认状态来自 API 而不是前端内存。模块 7当前本地闭环使用 PostgreSQL、Mock Model 和 Mock Executor实际观察到三个任务成功。这个结果证明的是控制台和 API 集成不证明真实模型的规划质量、Kubernetes 网络隔离或生产容量。10. 本地运行与复现本节只保留理解项目所需的最短运行流程。完整的终端职责、Docker Desktop、PostgreSQL、迁移、控制面、Worker、Vite、Token、环境准备和故障排查步骤收录在项目仓库的docs/部署/本地开发与配置.md可从下文的 GitHub 仓库首页进入。最短流程是安装 Go、Node.js 24 LTS、npm、Docker Desktop 和jq克隆仓库复制.env.example为.env.local重新生成三个不同的本地 Token启动 PostgreSQL执行迁移启动控制面和至少一个 Worker在web/执行npm ci和npm run dev浏览器输入 operator Token按本文第 2节的目标完成闭环。Git 仓库只保存代码、迁移、Compose 配置、环境变量模板和示例。Docker 镜像缓存、容器、数据库卷、.env.local、Token、密码和日志属于本地环境需要在运行项目的环境中单独准备。项目源码、完整运行手册和每个模块的验证证据会随开源仓库持续更新AI Workload Platform GitHub 仓库。读者可以先阅读仓库首页再按照部署手册启动本地环境需要注意默认演示使用 Mock Model不要求购买模型服务。11. 开源发布和 CICIContinuous Integration持续集成是在每次提交时自动运行格式化、测试和构建。CDContinuous Delivery/Deployment持续交付/部署是把通过验证的产物交给发布流程本项目当前只建立 CI 门禁不自动部署生产环境。GitHub Actions 会运行 Go 测试、竞态检测、go vet、文档检查、Kubernetes 清单检查以及前端npm ci、测试、类型检查和构建。依赖版本由go.mod、go.sum和 npm lockfile 固定CI 不访问真实模型、本机数据库或付费服务。开源治理文件各有职责LICENSE说明代码授权条件CONTRIBUTING.md说明如何提交问题和变更SECURITY.md说明如何报告安全问题CODE_OF_CONDUCT.md说明协作行为边界CHANGELOG.md记录公开版本变化scripts/check-secrets.sh和依赖许可证检查降低误公开风险。这些文件不能替代安全审查。容器执行器仍有明确的输入、镜像、网络和权限边界不能宣传为绝对安全沙箱。12. 真实模型协议边界本次不执行项目已经有 OpenAI-compatible HTTP Model Adapter但默认关闭真实模型。本次不执行外部模型调用也不要求读者准备 API Key。适配器代码可以发送model、messages、工具定义和 JSON Schemaresponse_format并处理工具调用后的下一轮消息这只是协议实现不代表已经验证过某个供应商。模块 3 的自动化测试使用本机 HTTP 模拟服务验证请求格式、工具调用消息、结构化输出、429、非法响应和取消。未来如果需要验证具体供应商应单独记录供应商、模型、响应质量、错误边界和费用并确保凭证只存在本机配置中不能把未执行的兼容性实验写成项目已有能力。13. 结论和限制模块 7完成后项目拥有一条可演示的产品闭环自然语言目标进入 Draft服务端校验和哈希确认阻止未审核定义执行控制面创建不可变 Workflow 并启动 Run浏览器展示 Task、Event、Worker 和 MetricsAttempt 详情仍可通过控制面 API 查询。已经验证的是本地 PostgreSQL、Mock Model、Mock Executor、前端自动化测试、类型检查和生产构建。尚未验证的是某个真实模型供应商的规划质量、所有 OpenAI-compatible 接口的兼容性、生产容量和完整的 Kubernetes 安全隔离。控制台的价值是降低使用和演示门槛不是替代后端可靠性。即使浏览器关闭Workflow、Run、Task 和 Attempt 仍由控制面和 PostgreSQL 保存浏览器重新打开后可以重新查询服务端状态但未提交的 Draft 不会自动恢复。14. 参考资料React 文档TypeScript 文档Vite 文档Vitest 文档React Testing LibraryGitHub Actions 文档项目源码本文对应模块 7。完整源码、部署手册、验证报告和其他学习文章见 AI Workload Platform GitHub 仓库。