forked from xhgit/webup-cloud
36 lines
3.8 KiB
Markdown
36 lines
3.8 KiB
Markdown
# AI 自动核算与管理员报告
|
|
|
|
费用核算和独立代码验收已分别实现。代码验收读取实际源码,在独立隔离副本运行检查 / 构建 / 测试,再由独立 AI 会话生成报告;详见 [独立代码验收](CODE-REVIEWS.md)。本文件描述费用流程。
|
|
|
|
## 用户体验
|
|
|
|
用户开发页面自动读取项目文件,项目切换时清除旧文件树和编辑内容;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 思考模式文档](https://api-docs.deepseek.com/guides/thinking_mode/)。
|
|
|
|
生产部署由启用 `app.worker-enabled` 的 Worker 自动运行独立的报告调度线程。预览使用相同真实流程,不依赖手工点击核算。
|