docs(readme): 记账三态语义(created/accounted/failed)+出账前置(产品映射+ppid)+worker依赖appbase

This commit is contained in:
yumoqing 2026-09-05 18:53:51 +08:00
parent 0a5974e935
commit 7b6b74646d

View File

@ -60,10 +60,13 @@
- **限流用 Redis 分钟窗口原子计数**(db4,与会话 db3 隔离);Redis 故障时限流放行(fail-open),
余额仍由 DB 条件 UPDATE 守住。
- **429 → (账号,端点)对冷却 60s**;账号级冷却用 `*` 通配键。
- **记账分流(2026-09-04 起)**:模型表不存单价,成本/售价统一走 ppid 定价引擎;
调用时流水记 `usages`(非 token 计价因子:视频时长/分辨率等),异步出账循环
(accounting.py,独立进程)经产品层出三方账(客户付/商户营收/供应商成本)。
本机构模型流水 `na`;owner 模型跨机构调用流水 `pending` 待出账。
- **记账三态(2026-09-05 用户定夺)**:`accounting_status` 只有三个值——
`created`(已创建待记账)→ `accounted`(记账成功)/ `failed`(记账失败)。
所有成功调用统一 created 进出账队列;自用 vs 跨机构分流由产品层
`product_accounting_generic` 的 is_self_use 决定(自用只记 PAY* 采购成本,
跨机构另记 PAY 客户应付)。流水 `usages` 存非 token 计价因子(视频时长/
分辨率等),异步出账循环(独立进程,需 load_appbase 提供 get_business_date)
读入定价引擎。未挂 ppid 的模型出账置 failed 并写明原因(不静默)。
- **媒体转换铁律(2026-09-05)**:生成类模型适配模板 data 用
`b64media2url(request, xxx_file)`(上传转公网 URL)、response 用
`downloadfile2url(request, url)`(生成物落地本地,上游 URL 仅 24 小时);