@dsh-usage-meter/usage-host

Host 侧用量记录器：把 session 事件流折叠成「模型 × 天」的 token 用量，持久化到 $DSH_HOME/usage-meter/usage.jsonl，并作为 usage-meter/summary Typert 远程服务暴露给 Web GUI。

服务

UsageMeterService extends TypertRemoteService（service key usageMeter）：

构造时订阅 session/event 事件流；request/header 记录当前路由（provider/model），assistant/message 带 usage 采样时产生一条调用记录。
启动时（Service.init）先加载持久化的 JSONL，再把 ctx.sessions.list() 里的存活会话回填一遍。
@Remote('summary')：返回完整聚合快照（累计 + 每日分模型桶）。
写盘通过 promise 尾串行化，插件卸载时 flush。

配置

字段	类型	默认	说明
`dir`	string	`''`	数据目录；空字符串解析为 `$DSH_HOME/usage-meter`
`timezone`	`'local' \| 'utc'`	`'local'`	按天分桶时区

数据

usage.jsonl 每行一条调用记录（见根 README「数据文件」）。usage-meter/summary 返回 UsageSummary：

interface UsageSummary {
  generatedAt: number          // 快照时间（epoch ms）
  timezone: 'local' | 'utc'
  models: string[]             // 出现过的模型，升序
  days: UsageDay[]             // 按日期升序
  totals: UsageBucket          // 全量累计
}

Model Experience

None：记录器只读 session 事件日志与聚合结果，不发起任何模型请求，也不修改模型可见的输入。

KV Cache effect

None：既不组装也不发送 provider 请求；cacheReadTokens/cacheWriteTokens 只是把适配器已上报的用量原样折叠。

配置

字段	类型	默认	说明
`dir`	string	`''`	数据目录；空字符串解析为 `$DSH_HOME/usage-meter`
`timezone`	`'local' \| 'utc'`	`'local'`	按天分桶时区

@dsh-usage-meter/usage-host

AI Analysis

Install

README

@dsh-usage-meter/usage-host

服务

配置

数据

Model Experience

KV Cache effect

配置