diff --git a/docs/MDTODO/details/sub2api-upstream-reliability/R3.8_Task_Report.md b/docs/MDTODO/details/sub2api-upstream-reliability/R3.8_Task_Report.md new file mode 100644 index 00000000..a8bc3637 --- /dev/null +++ b/docs/MDTODO/details/sub2api-upstream-reliability/R3.8_Task_Report.md @@ -0,0 +1,39 @@ +# R3.8 任务报告 + +## 范围 + +- 数据源：PK01 Sub2API 原生 usage、用户余额与公告 API。 +- 资格统计窗口：北京时间 2026-07-17 12:03:17 至 2026-07-18 12:03:17，对应 UTC 2026-07-17 04:03:17 至 2026-07-18 04:03:17。 +- 候选：11 名活跃普通用户；管理员自动排除，YAML 内部员工 `zhuo@test.com`、`huiguo@test.com` 保持排除。 +- 原生 usage 汇总：3,601 次请求，输入 Token 44,961,887，输出 Token 3,613,674，总 Token 48,575,561。 + +## 发放规则与结果 + +按最近 24 小时总 Token 从高到低排名：第 1 至 3 名每人 100 USD，第 4 至 5 名每人 50 USD，第 6 至 11 名每人 20 USD。参考预算约 500 USD，实际总额 520 USD。 + +| 排名 | 用户 ID | 用户 | 总 Token | 增发额度 | 写入与余额对账 | +| ---: | ---: | --- | ---: | ---: | --- | +| 1 | 2 | xiaoyang@test.com | 28,869,327 | 100 USD | 成功，4,343.7163611 | +| 2 | 17 | skylin008@gmail.com | 5,386,682 | 100 USD | 成功，257.71277055 | +| 3 | 10 | hyglql@test.com | 5,009,694 | 100 USD | 成功，339.14970635 | +| 4 | 9 | name@test.com | 3,267,773 | 50 USD | 成功，391.6339005 | +| 5 | 21 | miuser@test.com | 2,270,885 | 50 USD | 成功，690.1488944 | +| 6 | 19 | yinl0801@qq.com | 2,115,763 | 20 USD | 成功，724.67554535 | +| 7 | 24 | 896775112@qq.com | 1,030,212 | 20 USD | 成功，601.0431475 | +| 8 | 11 | MacRsh@test.com | 339,826 | 20 USD | 成功，84.639079 | +| 9 | 7 | laogen@test.com | 190,939 | 20 USD | 成功，1,100.0369109 | +| 10 | 22 | mail0795336304@163.com | 80,318 | 20 USD | 成功，676.95675455 | +| 11 | 26 | 570298585@qq.com | 14,142 | 20 USD | 成功，369.92819 | + +三批精确 selector 写入汇总：11/11 写入成功，0 失败，11/11 回读余额一致，总计 520 USD。原因统一为 `2026-07-17至2026-07-18最近24小时活跃用户额度回馈`。 + +## 公告结果 + +- 公告 ID：2。 +- 标题：`近期活跃用户额度回馈公告`。 +- 状态：`active`。 +- 通知：`popup`。 +- 投递：全体用户，原生回读将空 `any_of` 规范化为等价空 targeting。 +- 创建时间：北京时间 2026-07-18 12:21:03。 +- 正文明确列出资格统计窗口、11 名稳定用户 ID 与脱敏邮箱、排名、Token、逐人额度和总额 520 USD。 +- 回读对账：`reconciled=true`、`mismatchedFields=[]`，标题、正文、状态、通知、投递和时间字段均一致。 diff --git a/docs/MDTODO/sub2api-upstream-reliability.md b/docs/MDTODO/sub2api-upstream-reliability.md index 49fdde3e..fab8e3b2 100644 --- a/docs/MDTODO/sub2api-upstream-reliability.md +++ b/docs/MDTODO/sub2api-upstream-reliability.md @@ -289,6 +289,13 @@ 在 Sub2API 公告 skill 与 CLI create 预览中固化明确范围规则：补偿公告必须在用户可见正文列出故障或补偿时间窗、全部实际接收用户、每人金额和总额；邮箱允许脱敏但必须保留稳定用户 ID，`targeting` 仅表示投递范围、不能替代补偿资格名单。本次只记录并验证 dry-run 展示，不重新发布或修改既有公告，完成任务后将详细报告写入[任务报告](./details/sub2api-upstream-reliability/R3.7_Task_Report.md)。 +### R3.8 [completed] + +基于 PK01 Sub2API 原生最近24小时 usage 盘点活跃客户，按 Token 排名制定约 500 USD 的整额分档计划；经用户明确确认后，对固定11名用户按100、50、20 USD三档实际增发总计520 USD，逐用户回读余额，并发布包含北京时间窗口、排名、Token、稳定用户ID、脱敏邮箱和逐人金额的 active popup 公告并完成字段对账，完成任务后将详细报告写入[任务报告](./details/sub2api-upstream-reliability/R3.8_Task_Report.md)。 + +### R3.9 + +完成 [UniDesk #2498](https://github.com/pikasTech/unidesk/issues/2498)：增强 Sub2API 排名分档额度发放的固定计划入口，一个 dry-run 从原生 usage 生成包含窗口、排名、Token、稳定用户ID、逐人金额和总额的不可变计划，一个 confirm 完成异额批量幂等写入及逐用户余额回读；档位、金额、窗口和排除项全部参数化，不修改 Sub2API 源码、版本或生产运行面，并将本次流程沉淀为不含一次性值的通用案例，完成任务后将详细报告写入[任务报告](./details/sub2api-upstream-reliability/R3.9_Task_Report.md)。 ## R4 [completed] 关联 [UniDesk #2281](https://github.com/pikasTech/unidesk/issues/2281)，增强 Sub2API runtime 模板批量 CRUD：支持通过显式参数按原生 runtime 已配置同类策略和账号类型自动选集，并支持精确排除 selector；dry-run 直接输出最终账号名称、ID、选中来源与排除摘要，confirm 复用既有写后自动回读对账，避免先 list、人工抄账号 ID、再 apply 的重复调用；显式 JSON 使用紧凑 mutation 投影保留 provenance 且不触发输出保护，不修改 Sub2API 源码、版本、runtime、YAML 或外部哨兵，完成任务后将详细报告写入[任务报告](./details/sub2api-upstream-reliability/R4_Task_Report.md)。