61 lines
2.0 KiB
Markdown
61 lines
2.0 KiB
Markdown
# 283 CostBreakdown 费用分解
|
||
|
||
## 用途
|
||
|
||
按模型、工具或步骤汇总调用次数、token 与费用，表格可排序，底部显示合计。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
var state feedback.CostBreakdownState
|
||
items := []feedback.CostItem{
|
||
{Model: "opus", Tool: "search", InputTokens: 1000, OutputTokens: 200, Cost: 0.30},
|
||
{Model: "haiku", Tool: "search", InputTokens: 4000, OutputTokens: 500, Cost: 0.05},
|
||
}
|
||
view := func(c *ui.Context) {
|
||
core.Use(c, core.Settings{})
|
||
feedback.CostBreakdown(c, &state, items, feedback.CostBreakdownOptions{GroupBy: feedback.CostByModel}).Element.Height(260)
|
||
}
|
||
ui.Render(view, 400, 300, 1)
|
||
```
|
||
|
||
签名：`func CostBreakdown(c *ui.Context, s *CostBreakdownState, items []CostItem, opts CostBreakdownOptions) DataTableView`
|
||
|
||
## 参数
|
||
|
||
`CostItem`
|
||
|
||
| 字段 | 类型 | 默认值 | 含义 |
|
||
| --- | --- | --- | --- |
|
||
| Model, Tool, Step | string | "" | 分组依据；为空归入“（未命名）”。 |
|
||
| InputTokens, OutputTokens | int | 0 | token 数；为负 panic。 |
|
||
| Cost | float64 | 0 | 费用；为负或非有限值 panic。 |
|
||
|
||
`CostBreakdownOptions`
|
||
|
||
| 字段 | 类型 | 默认值 | 含义 |
|
||
| --- | --- | --- | --- |
|
||
| GroupBy | CostGroup | CostByModel | CostByModel、CostByTool、CostByStep。 |
|
||
| Currency | string | "$" | 金额前缀。 |
|
||
| Decimals | int | 0（即 2） | 金额小数位；为负 panic。 |
|
||
| Version | int | 0 | 原地修改数据时递增；新切片或长度变化自动刷新。 |
|
||
|
||
`CostBreakdownState.Table` 保存排序与选择。汇总只在 items 或分组方式变化时计算。给返回的 `Element` 一个高度。
|
||
|
||
## 状态
|
||
|
||
- 费用列含占比条与百分比，数字为等宽数字。
|
||
- 合计行为衬线“合计”、token 总数与加粗金额，朗读完整合计。
|
||
|
||
## 事件
|
||
|
||
- 同 DataTable：`Changed()`、`SortChanged()`。
|
||
|
||
## 键盘操作
|
||
|
||
- 同 DataTable：↑/↓ 选择行，列标题可用键盘排序。
|
||
|
||
## 限制
|
||
|
||
- 金额以浮点汇总并按小数位显示，不做货币舍入规则。
|