168 lines
17 KiB
Markdown
168 lines
17 KiB
Markdown
# AI 软件交付与持续服务平台模板与 AI 工作流
|
|
|
|
状态：版本 0.14，更新日期 2026-10-12，阶段 6 工作流草案。首期熟客年付套餐、有限自动 AI/包含用量及人工；实际调用含失败/重试均消耗权益，超额扣充值积分。退役仅代码/配置归档，测试赠送细则后置。具体工具和执行参数待阶段 4/6。
|
|
|
|
自动交付需要把应用模板、开发规范、运行要求和验收方式变成可执行契约。模板可以新建或经评估复用；AI 负责范围内定制，平台负责任务授权、成本、资源及交付验证。
|
|
|
|
支持目录面向各行业的已接入容器化应用。基础系统可以来自自有代码或 GitHub 等来源；应用上架须形成可重复的运行、初始化、定制、验证及维护契约，并区分已支持版本与候选评估。
|
|
|
|
## 首期与后续执行方式
|
|
|
|
| 类型 | 执行方式与阶段 | 费用归属 |
|
|
| --- | --- | --- |
|
|
| 简单固定运维 | 首期优先封装添加域名、添加邮箱等操作，由程序执行 | 按相应服务收费，无 AI 调用不产生 token 费 |
|
|
| 复杂定制开发 | 首期人工模式，内部设置金额，客户同意后执行并更新线上 | 人工费用另明示；项目 AI 调用照常计消耗，先抵扣包含用量，超额扣积分 |
|
|
| 自动 AI 定制 | 首期有限范围开放，内部判断、开发、检查并更新线上，需要人工则转换模式 | 先抵扣套餐包含用量，超额实际成本加价 20% 扣充值积分；失败/重试均记录真实消耗 |
|
|
| 供应商账号准备 | Cloudflare、Migadu 账号注册和池补充目前人工完成 | 按所购服务及采购规则处理，不假定自动注册 |
|
|
|
|
固定运维工作流先细化输入、项目与资源权限、实际供应商账号绑定、容量及前置条件、执行结果、重复请求和部分失败处理。已有账号操作、账号注册、域名购买和域名绑定需分开列步骤，不能用“添加域名”统称所有交易与运维行为。
|
|
|
|
可自动执行的操作清单后续逐项确认。封装为工作流不等于必须使用 AI，也不要求首期实现全部初始化、开发和数据流程；标准应用部署的自动执行范围另行确定。
|
|
|
|
## 模板的三层定义
|
|
|
|
系统模板决定有哪些功能和运行组件，例如展示站、带内容后台的网站或成熟开源应用。设计方案决定布局、风格和视觉规则。客户实例保存客户自己的内容、素材、功能配置和定制代码。
|
|
|
|
因此，不同视觉效果可以复用同一系统模板；更换系统模板可能涉及功能与数据迁移，不能等同于换主题。实际模板类型和覆盖范围待盘点。
|
|
|
|
## 模板契约草案
|
|
|
|
| 类别 | 需要明确的内容 |
|
|
| --- | --- |
|
|
| 身份与版本 | 模板标识、版本、仓库引用、维护人及授权条件 |
|
|
| 能力和限制 | 支持页面、后台能力、语言、可选功能、需人工处理的请求 |
|
|
| 开发规范 | 安装、构建、启动、验证命令及允许修改的区域 |
|
|
| 运行要求 | 端口、数据库、文件存储、环境变量、健康检查及资源档位 |
|
|
| 部署组成 | Web、worker、scheduler 等角色，启动方式、副本、依赖和允许覆盖的配置 |
|
|
| 必需与选配 | 由应用及版本声明必需组件、资源及可选服务；不套用所有应用统一数据库/PVC 清单 |
|
|
| 资源关联 | 代码来源、环境、namespace、数据库及存储的显式绑定，不依赖名称相等 |
|
|
| 数据与存储依赖 | 支持的引擎与版本、自建或托管数据库、卷访问模式与对象存储接口，不默认可互换 |
|
|
| 服务协作 | 跨项目 API、平台公共服务的接口、授权引用与依赖；同组不自动获得访问权限 |
|
|
| 交付标准 | 浏览器功能核对路径、响应式要求、内部检查和必需素材 |
|
|
| 发布策略 | CI/CD 接入、镜像规范、预览与生产发布约定 |
|
|
| 维护规则 | 数据迁移、备份、兼容性、依赖更新和升级方式 |
|
|
| 成本信息 | 预计步骤、用量区间、运行资源和人工风险项 |
|
|
|
|
推荐逻辑先按确定的功能和运行约束过滤，再由 AI 解释适配理由。没有能力依据的功能不能通过自然语言推荐变成套餐承诺。
|
|
|
|
模板缺少现成功能时，可推荐替代基础或人工评估。不同来源的模板，包括自有代码和成熟开源应用，记录已验证的扩展方式与技术约束，实际客户需求再逐单评估方案和工作范围。
|
|
|
|
上述契约用于说明系统和自动执行条件，不作为需求白名单。客户文字/附件自由提交，人工逐单评估方案和报价；首期有限 AI 则评估能否在已验证条件下自动完成，不适合则转换人工。
|
|
|
|
## 自动开发的工单评估
|
|
|
|
自动开发接收本次工单的文字和附件，结合当前应用、发起时版本、实际执行基准及授权范围内部判断。适合则自动开发并更新线上；判断需要人工则自动切换到原工单的人工模式，进入人工金额确认路径。沟通澄清走在线客服或 TG，不在工单添加评估对话、人工报价会话或每版客户验收。
|
|
|
|
原需求及附件保持可定位，新增/改变业务范围另建工单，客服聊天不扩大任务。失败后允许修订再试，建议固定需求修订和尝试编号，不覆盖旧输入、失败结果或费用。AI 和人工都以本次明确修订为执行依据，重试前重新核对运行版本与预算。
|
|
|
|
## 平台执行记录与第三方工作流：待评审建议
|
|
|
|
平台保存业务主记录，包括工单、需求修订、执行尝试、当前阶段、预算/费用、代码/产物与实际发布；内部执行器、Dify 等通过可替换适配器接入。是否使用第三方与是否记录可靠业务状态是两个问题，首期不需要先建完整可视化工作流编辑器。[Dify Workflow API](https://docs.dify.ai/en/api-reference/guides/workflow)
|
|
|
|
接入专题需要定义输入范围、附件提取结果、项目/APP 与基准引用、需求修订、工作流版本、授权及预算；外部执行 ID、阶段事件/查询、超时/停止能力、结果与成本来源；以及失败、转人工和发布成功的核验。按引擎实际能力接收事件或查询，不假定所有引擎有回调、断点恢复或代码操作能力。
|
|
|
|
重复或迟到事件不得重复扣款、重复发布或覆盖新尝试状态；失联先查实际进度，不能直接再次调用付费工作流。引擎成功不等于 Git 提交成功、构建成功或线上健康，平台核验后才更新客户结果。Git Issue 强制范围及同步协议阶段 4 讨论，多 APP 发布顺序及补偿恢复阶段 6 讨论。
|
|
|
|
附件允许清单与隔离处理见 02。解析输入不携带生产密钥，文档中的命令和网页不能自行改变执行授权。Word/PDF 图文提取、扫描与失败提示需有明确输出，具体工具未选。
|
|
|
|
执行完成回写需求对应的功能摘要、APP/版本和访问入口；技术明细可展开。失败回写原因、已保持/恢复的版本及下一操作；恢复失败转人工接管，不虚报回退成功。新增回执不改变客服/TG 独立沟通的边界。
|
|
|
|
自动判断依据应包含需求理解、依赖和开发环境、预计改动、数据结构影响、验证条件和预期效果。即使判断可自动处理，也需内部验证实际成果；无法收敛时保留原任务、代码与记录，转人工或进入明确失败处理，不让未完成的改动误标为已上线。
|
|
|
|
## AI 定制初版完整目标工作流草案
|
|
|
|
1. 校验执行资格：需求已达到可执行程度，订单权限、预算和权益满足条件。
|
|
2. 固定输入：保存本次需求、素材、模板版本、工作流版本和内部检查项。
|
|
3. 准备项目：按新领域模型和类型配置准备应用实例、工作负载、内部检查环境及代码来源。
|
|
4. 实例化模板：根据契约配置应用、CI/CD 和运行参数引用。
|
|
5. 制定开发计划：把需求转换为页面、内容及功能任务，检查是否超范围。
|
|
6. AI 开发：在隔离环境中修改代码，保存提交、日志和用量。
|
|
7. 执行检查：构建、类型检查、相关功能测试、浏览器操作和视觉检查。
|
|
8. 有限修复：对检查失败执行受预算和次数约束的修复，无法收敛时转等待或异常状态。
|
|
9. 构建部署：形成可追踪产物，检查后按明确绑定更新线上；旧链路是否复用另行评估。
|
|
10. 记录完成：保存线上访问方式、版本、检查及发布结果，客户直接查看更新效果，不等待客户验收预览。
|
|
|
|
任务中可以按阶段划分不同职责，但是否使用多个代理及具体模型策略尚未决定。AI 模型调用入口采用 OpenRouter，执行引擎与路由实现后定。先定义可靠流程和输入输出，再选择执行工具。
|
|
|
|
## AI 修改工作流草案
|
|
|
|
工单先固定基准版本和修改范围，进行复杂度与权益检查，再针对现有代码产生改动。验证应覆盖修改目标和受影响的已有功能，不能只确认页面能打开。
|
|
|
|
检查后直接更新线上，记录该工单对应的改动和有效版本。发布前核对线上版本是否改变，避免旧任务覆盖其他已完成成果。后续反馈走客服渠道，不把同一工单变成持续聊天与无限改动循环。
|
|
|
|
## 人工与自动处理共用的版本流程建议
|
|
|
|
1. 工单提交时关联目标应用、环境及当时的有效版本，保存需求与附件版本。
|
|
2. 接到执行任务后再次核对当前版本，固定实际开发基准；与提交时不同则处理依赖和冲突，保留两个基准。
|
|
3. 在隔离的工作分支或工作区执行改动，按需关联 Git Issue 和 PR，记录处理人员或工作流、提交及费用。
|
|
4. 各次执行和内部修复保留成果引用，记录构建、镜像或产物、配置及必要的数据迁移信息，不覆盖此前成果记录。
|
|
5. 内部验证后直接更新线上并记录结果；Issue 关闭和代码合并不能代替线上更新成功，不增加默认客户验收步骤。
|
|
6. 客户申请回到历史工单发起前版本时，选定对应目标，核对产物、配置、当前数据兼容及正在执行的工单，按确认的恢复范围执行。
|
|
7. 回退生成新的执行和部署记录；后续开发以恢复后的有效版本为依据，保留旧工单、成果、客服关联和账目。
|
|
|
|
这套关联能力适用于首期人工及有限自动定制。独立分支、PR 门禁及发布顺序仍是建议，具体工程工具与强制规则待定。
|
|
|
|
工单限单个项目，可涉及多个 APP；内部任务分别执行但形成明确项目发布组合，记录各 APP 的实际 Git 提交、产物、配置、结构版本及恢复点。未改变 APP 的当前版本也纳入组合核对；共享数据库变化需覆盖全部受影响组件。发布不是多个独立部署天然具有的原子事务，必须规划兼容顺序与部分失败恢复。
|
|
|
|
数据保护建议按风险执行：纯样式修改保留代码与产物；迁移结构、改写记录或卷内文件前建立可用恢复点。小数据可逻辑备份，高频/较大数据评估引擎日志与时间点恢复，卷使用受支持快照并配合集群外备份。备份与文件需协调一致性，恢复到隔离目标验证后切换；共享数据库实例不能整实例回退而伤及其他项目。具体工具与保留策略待设计，不视为现网配置已完成。
|
|
|
|
整版回退会使目标之后的应用改动不再生效；保留后续成果、仅撤销某张工单需评估依赖并形成新成果。数据恢复方式、产物保留期限和历史版本的长期重建能力尚未定案，不能将恢复操作简化为对仓库强制回退。
|
|
|
|
## 数据与持续服务工作流素材
|
|
|
|
阶段 2 补充的资源与协作目标需进入后续运行契约：Web 与 worker 的配置和依赖分别表达，共享资源显式绑定；数据库、卷和对象存储按真实能力接入。更换供应商需执行数据迁移、兼容验证和切换，不能只替换连接地址。API 使用授权与平台公共服务订阅分别校验。具体供应商适配和自动开通不作为本轮首期承诺，详见 03。
|
|
|
|
数据任务以源数据、目标应用、映射、批次和结果核对记录为输入输出，不要求形成代码版本。电商样本可参考“快照与字段映射、按源 ID 导入、图片同步、翻译、数字及结构校验、写入、结果核对”的组合；一次性迁移与增量同步应分别定义。
|
|
|
|
AI 判断和程序执行需分别表达。需求分析、映射建议及翻译可用 AI；数值与格式校验、去重、批量提交和进度保存由明确程序完成。人工在对话中做出的选择，需转换为可记录的规则或确认节点，不能假设全都可自动决策。
|
|
|
|
平台开发和运维任务与客户应用内部任务不同。Content Hub 的采集及分发属于被交付应用运行能力，平台管理其版本、资源与服务；不能把它与建站平台自身的交付队列混为一体。
|
|
|
|
## 检查层次
|
|
|
|
- 工程检查：安装和构建成功，类型及静态检查符合模板规范，没有密钥进入交付产物。
|
|
- 功能检查：按订单范围执行关键路径，如导航、表单、后台权限或语言切换。
|
|
- 浏览器检查：目标屏幕尺寸可使用，主要交互正常，没有阻断性的控制台异常。
|
|
- 视觉检查：检查明显溢出、缺图、布局及文字可读性；高级审美判断和客户满意度不能由构建成功替代。
|
|
- 发布检查：版本、镜像、线上实际状态和资产记录一致。
|
|
|
|
检查需依据本次明确需求，构建成功不代表业务效果必然满足。检查与上线结果属于执行记录，客户不满意可回退并通过客服反馈，不因此把验收确认设为自动工单的默认发布门槛。
|
|
|
|
## 直接线上更新与内部检查
|
|
|
|
工单处理目标是直接更新客户正在访问的线上应用。开发和检查可使用隔离环境、临时预览或测试数据，但不要求客户先查看该环境再批准发布。客户运行演示应用或使用默认域名的场景仍保留，不将其等同于每张工单的验收流程。
|
|
|
|
模板不能依赖在客户生产环境直接编辑源代码。CI 构建可追踪镜像，发布引用不可变版本或 digest，保留上一可用产物。当前部分部署沿用 `latest` 的方式需要评估适配，不能把此方案当作已实现能力。
|
|
|
|
数据库迁移需考虑新旧应用兼容。破坏性迁移、客户数据修改或恢复必须有专门计划；镜像回滚不承诺自动恢复数据库和上传文件。
|
|
|
|
默认建站域统一经预览保护入口访问，不作为客户正式公开网站。未来临时沙盒另有入口及有效期，默认隔离持续实例的可写数据和真实业务副作用。域名通过明确端点绑定分配，不依赖项目编号、仓库或 namespace 名称。
|
|
|
|
资源释放任务检查实际引用、归属、宽限期与进行中的操作；最后引用移除前提示客户，零引用不直接等同于立即执行 PVC/数据库删除。三天是用户举例的候选参数，备份保留及独立服务不套用 APP 引用自动清理。
|
|
|
|
发布顺序、失败恢复及内部检查标准后续制定；自动和人工处理完成均关联实际线上版本。
|
|
|
|
## 失败与人工接续
|
|
|
|
| 情况 | 建议处理 |
|
|
| --- | --- |
|
|
| 需求或素材不全 | 等待客户补充，保留当前任务产物 |
|
|
| 模板能力不匹配 | 回到方案确认或人工评估 |
|
|
| AI 检查无法通过 | 达到修复限制后停止，保留错误和代码 |
|
|
| 资源、仓库或 CI 故障 | 修复外部依赖后从已记录阶段恢复 |
|
|
| 成本或时长超限 | 停止后续执行，展示追加权益或人工路径 |
|
|
| 客户取消 | 停止未完成步骤，按保留策略处理临时资源 |
|
|
| 发布失败或新版不可运行 | 发布前保持原版本，发布后按恢复计划回退并核验；恢复异常转人工 |
|
|
|
|
失败后客户可修订需求再试，保留前次输入、执行与费用，回执指明有效线上版本。费用按 05 已明确规则：项目 AI 实际调用含失败/重试/转人工均消耗权益，超额扣充值积分，充值不足停止新调用。验收可触发有限修复，每次调用仍计消耗，预算/次数控制避免无限循环，不把未过验收当免费推理。
|
|
|
|
主动退役核对引用后停止/释放运行组件、数据库、文件和相关备份，仅存代码、依赖/构建说明和启动配置；再部署初始化新业务，不恢复原数据或按月退款。不必长期保留全部镜像，可从归档材料重建。到期未续费仍先停外部访问，业务数据最多保留一周，与主动退役不同；独立服务分别管理，执行顺序阶段 6 验证。
|
|
|
|
未来测试赠送实例只支持受保护预览，不得正式绑定域名；平台可撤销/销毁测试资源。测试权限与真实充值、正式年付包含用量分开校验，不能让免费权益执行正式资源采购。首期不实现新客赠送策略和完整试用转正式工作流。
|
|
|
|
人工接续材料包括需求版本、模板版本、基准提交、当前代码、预览、检查报告、用量及已尝试的修复。人工交付后将结果回写同一任务、工单和版本链路。
|
|
|
|
## 模板升级
|
|
|
|
客户实例固定模板来源和版本。模板更新不应直接覆盖所有已定制客户实例；通用缺陷、安全修复和功能升级需分别评估兼容性，生成升级任务并验证。
|