feat: 用量归属支持 callerRef 透传
- POST /ai/tasks 接受顶层可选 callerRef(限 64 字符),不进入 params、不参与幂等键、不进 prompt - 结算时写进用量记录,lpt-be 据此做用户维度报表 - 复用已有任务时沿用原归属:那次 LLM 调用只发生一次,账算在原调用方头上
This commit is contained in:
@@ -64,9 +64,24 @@ lpt-ai/src/
|
||||
峰时窗口按 UTC 判定(`01:00-04:00`、`06:00-10:00`,周一至周五),谷时 = 峰时 × 0.5。
|
||||
计价结果在结算时**冻结进日志快照**,改价不会重算历史账。
|
||||
- `admin/reporter.ts`:把用量推给 lpt-be(长期账本)。上报失败先落本地 outbox 再重试,
|
||||
幂等靠 `record_id` 唯一索引。未配置 `LPT_AI_REPORT_URL` 时为空操作。
|
||||
幂等靠 `record_id` 唯一索引;4xx 属于确定性拒绝,丢弃这批并计数,不无限重试。
|
||||
未配置 `LPT_AI_REPORT_URL` 时为空操作。
|
||||
- **权威口径在 lpt-be 的 MySQL**;本地面板只是最近 500 条的调试视图。
|
||||
|
||||
### 用量归属(callerRef)
|
||||
|
||||
lpt-ai 不知道调用方是谁,所以归属标记由调用方带过来:`POST /ai/tasks` 接受顶层可选字段
|
||||
`callerRef`(lpt-be 传的是用户 id),结算时原样写进用量记录,lpt-be 据此做用户维度报表。
|
||||
|
||||
三条硬约束,改动时必须守住:
|
||||
|
||||
1. **不放进 `params`** —— 会污染 prompt 模板的输入;
|
||||
2. **不参与幂等键** —— 否则同一份输入会因为调用方不同而重复调 LLM;
|
||||
3. **不进入 prompt** —— 它只是记账标记。
|
||||
|
||||
复用已有任务时**沿用原任务的 `callerRef`**:那次 LLM 调用只发生了一次,账算在原调用方头上;
|
||||
复用方没有产生新的 token 消耗,也不会有新的用量记录。
|
||||
|
||||
> `/admin` 用 `?token=…` 首次打开时会换发 `HttpOnly` cookie,否则面板 HTML 与它内部的
|
||||
> `fetch` 是两个独立请求,内部请求会全部 401。详见 `roles/security-and-degradation.md`。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user