方案说明与权限核对
名称:“周简报 / Weekly Brief”。每周一回顾上一完整自然周,默认建议用 UTC 周一 00:00 至下周一 00:00(不含)。每个工作空间独立出报,按收件时的角色确定范围。
| 收件人 | 费用与用量 | 费用异常 | 错误分布 |
|---|---|---|---|
| Team Admin | 全团队 | 全团队 | 全团队 |
| Personal | 本人空间 | 本人空间 | 本人空间 |
| Billing Manager | 全团队 | 全团队 | 省略 |
| Team Member | 仅本人 | 仅本人 | 仅本人 |
权限核对:现有代码中 Billing Manager 有团队用量与费用权限,Dashboard 也有 By Member;本次邮件按需求省略 By Member。其 Usage & Activity 可看汇总错误图,但没有请求日志权限,邮件仍不包含错误部分。统一按钮进入 Dashboard;Team Member 的 My models 支持按请求数 / 费用切换,各展示前 5 个。Personal 按 Admin 能力处理,但数据只来自自己的空间。
摘要与入口:邮件开头展示 Spend、Tokens、Error rate;Billing Manager 只展示前两项。Spend 末尾提供 View Dashboard → 文字链接;黑色 View Dashboard 按钮单独放在所有模块之后。
费用:Total Cost 是汇总值,正文只展开 Spend by Day 和 Top 5 Models;By Provider / By Member 留到 Dashboard。模型占比以本周全部费用为分母,剩余费用用一行“其他模型”补足。
费用异常:沿用 error mock 分支:单日费用严格大于本周日均费用 3 倍才标红;7 个自然日均参与日均,包含零消费日。无异常时显示一句平静的说明。
Token:Total = Prompt + Completion;Cache 包含在 Prompt,Reasoning 包含在 Completion。邮件图中分别注明 Prompt 排除缓存、Completion 排除推理,四段互不重叠;每日总量标在柱顶。
错误:周错误率 = 本周失败请求数 ÷ 本周总请求数。Top 5 按错误码聚合、按次数降序,占比以全部失败请求为分母,并补一行其他错误。沿用现有 5% 的红字强调,不新增“错误率高于 5% 的天数”、健康评分或建议清单。
发送建议:团队角色按团队上周是否有请求判断,Member 按本人、Personal 按个人空间;有请求但费用或 Token 为 0 仍可发送。没有请求则跳过。正式接入时遵循通知开关与实时权限,不在本 Mock 中发送邮件。发送时间与 UTC 周口径为本轮方案建议。
参考:角色权限与 Dashboard 分析
· Q4-09 邮件分支 b001bcde · error mock 分支
0448c810。所有数值均为合成示例。邮件链接打开共用同一快照的本地详情
Mock,固定角色、周期和选中维度;正式发信时替换为带工作空间上下文的产品链接。