Files
webup-cloud/docs/AUTOMATIC-REPORTS.md
WebUp Cloud db82325ed7
Verify control plane / verify (push) Canceled after 0s
Initial import of WebUp Cloud
2026-11-07 13:31:14 +08:00

3.8 KiB

AI 自动核算与管理员报告

费用核算和独立代码验收已分别实现。代码验收读取实际源码,在独立隔离副本运行检查 / 构建 / 测试,再由独立 AI 会话生成报告;详见 独立代码验收。本文件描述费用流程。

用户体验

用户开发页面自动读取项目文件,项目切换时清除旧文件树和编辑内容;AI 执行中及任务变化时刷新目录,但不覆盖正在编辑的文件内容。目录为空会明确说明尚无源码,读取失败另行显示。任务有 Token 消耗,不代表代码已经生成。

模型结束开发前,Worker 从真实沙箱检查非空源码,忽略 .git、依赖、构建产物、环境文件与符号链接。没有源码时自动要求模型实际写入文件;连续两次仍无源码就暂停,不能标记完成。扫描不完整且未找到源码时也暂停,不能武断认定空目录。源码存在只证明文件已生成,不代表全部功能或浏览器验收成功。

自动核算

已确认 usage 仍按任务价格快照实时结算。异常任务进入 REVIEW_REQUIRED,界面显示“自动核算中”。距最后状态更新至少三分钟后,系统自动关闭异常任务并释放剩余预留,释放执行位;不会自动重放可能已执行的命令或模型请求。

未知 usage / 未确认的供应商费用由平台承担,AI 不得猜测金额追加扣用户钱包。原有人工核对记录和已结算金额保留,不被新报告改写。失败任务的代码不会被删除,可在同一项目重新发起开发。

核算事务与 AI 报告分开:即使报告模型超时或失败,已经完成的预算释放不会回滚,也不会自动重复付费请求。每个任务的每次执行(attempt)只创建一份报告,领取有事务锁,过期报告标记失败并保留凭据。

管理员记录与报告

管理员 /admin/tasks 选择“核算记录与报告”,查看:

  • 已确认用户费用、是否自动释放预算、原有人工结算凭据。
  • 实际 usage 记录与当前工作区检查时间、文件数量和大小;不把检查失败当成源码存在。
  • AI 对异常原因、已知事实、未知部分与处理建议的中文分析。
  • 报告自身模型 usage / 按价格快照计算的成本;这部分由平台承担,不写入用户消费账本。
  • 报告失败 / 截断信息和 JSON 下载。

GET /api/admin/tasks/{id}/reports 需要 tasks:manage、finance:write 或 audit:read。普通用户即使拥有任务也不能访问,用户任务事件接口过滤 AUTO_SETTLEMENT / MANUAL_SETTLEMENT 内部核算事件。用户仍可查看本人开发日志、已确认消费和任务最终状态。

报告模型使用该任务的供应商 / 模型配置快照,禁止工具调用,只读取核算凭据和文件元信息,不执行项目代码。每份最多 1536 输出 Token,调用超时最多 45 秒;每日最多为前 100 份记录调用 AI,单份预计成本不得超过平台配置价格计算的 1 元。超额只保留系统核算记录,不阻塞预算释放。AI 的文字不参与钱包金额决策。

DeepSeek 官方接口的 deepseek-flash / deepseek-v4-pro 在输出上限不超过 8192 Token 时显式发送 thinking.type=disabled,开发工具调用和报告请求均适用。真实联调曾出现 1536 个输出 Token 全为 reasoning_tokens、最终报告为空的情况;保留该失败记录,后续调用改为非思考模式,不显示内部思考代替最终报告。其他供应商不附加该字段。依据:DeepSeek 思考模式文档。

生产部署由启用 app.worker-enabled 的 Worker 自动运行独立的报告调度线程。预览使用相同真实流程,不依赖手工点击核算。