Token 用量与观测

wesgine 提供细粒度的 Token 用量查询和 Run 追踪能力。

Token 用量查询

多维查询

GET /cells/{id}/observe/token-usage

支持的查询维度：

参数	说明
`GroupBy`	model / agent / session / day / tag:actor
`Tags`	按标签过滤
`Model`	按模型过滤
`Session`	按会话过滤
`From` / `To`	时间范围

聚合摘要

GET /cells/{id}/observe/token-summary

返回 Cell 级别的 Token 用量聚合数据。

按维度聚合

GET /cells/{id}/observe/token-usage/aggregate?agent=&group_by=day&days=

按 Agent 或按天聚合统计。

Run 追踪

Run 列表

GET /cells/{id}/observe/runs?agent=&session=&limit=&offset=

Run 详情

GET /cells/{id}/observe/runs/{runID}

Run 工具调用追踪

GET /cells/{id}/observe/runs/{runID}/tools

返回 Run 中所有工具调用的详细追踪信息。

Actor 边界（INV-OBS-08/09/10）

观测数据遵循 Actor 边界：

行为	规则
查询自己的数据	`?actor=` 或从 token 提取
管理视图	admin token + 空 actor
别人的 Run	与不存在返回相同结果
无主 Run	隐藏（不是公共）

三个判据点

位置	判据
SQL 谓词	`actorClause`（`internal/observe/actor.go`）
内存事件环	`RunEventBuffer` owner 判断
聚合器	`observe.RunVisible` 单点

证据链

GET /cells/{id}/observe/evidence

JSONL 流，逐 Run hash chain。

注意：证据链和审计端点抬到 cell:admin 作用域，不做 Actor 过滤——证据链切片后缺环无法校验。

Cell 统计

GET /cells/{id}/observe/stats

返回 Cell 运行时统计信息。

崩溃日志

GET /cells/{id}/observe/crash-log

跨 Cell 观测（Admin）

Hypervisor 级别的观测：

GET /admin/observe/snapshot           # Hypervisor 快照
GET /admin/observe/per-cell-stats     # 各 Cell 统计
GET /admin/observe/provider-latency   # Provider 延迟
GET /admin/observe/runs               # 跨 Cell Run 列表
GET /admin/observe/crash-log          # 崩溃日志

审计导出

GET /cells/{id}/audit/export?format=jsonl|csv&from=&to=
GET /cells/{id}/audit/summary