前言¶
在使用 DeepSeek Harness（DSH）进行模型推理时，追踪 Token 消耗和成本是控制支出的关键。本插件通过读取本地会话日志，提供了一种本地化的用量统计方案，不依赖任何在线服务，直接在 DSH 环境内展示数据。
定位¶
dsh-token 是一个由 fufuf-c 维护的本地 Token 用量统计仪表盘插件，属于模型推理类别。它解决了“只回答花了多少钱、用了多少量”的单一问题，进一步提供“Token 从哪来、缓存省了多少、哪些会话在烧 Token”的详细视角。
核心能力¶
1. 四段 Token 构成与缓存省钱¶
插件将 Token 消耗拆分为四个维度：未命中、缓存命中、缓存写入和输出。通过区分这四段，不仅能看到总量，还能直观看到缓存命中带来的成本节省。
2. 全局筛选与会话下钻¶
- 全局筛选：支持按时间（今天/3天/7天/30天/自定义）、模型、会话、工作目录进行筛选，支持 URL 分享筛选条件。
- 会话下钻：在会话详情中提供四联统计、逐模型构成、逐请求明细以及上下文增长曲线。界面会标记异常激增的请求，并支持通过
?session=深链直接定位。
3. 成本与预算控制¶
- 内置价目：内置 DeepSeek 官方价目表，支持高峰/空闲分档和时段修改。
- 预算监控：提供月度预算环形进度条，支持设置 80% 和 100% 的阈值警报，并支持按模型或会话归因成本。
4. 数据安全与界面¶
- 零上传、无在线依赖：所有数据均来自本地
$DSH_HOME/sessions，经 DSH 官方sessionPersistence服务解码，不涉及任何数据上传。 - 界面设计：采用 Apple 风格的四 Tab 界面，包含多模型叠加趋势图、日/周/月粒度切换、24 桶小时直方图以及活跃度月历热力图。
安装与使用¶
通过插件目录或 GitHub 仓库安装。安装后，插件会在侧边栏、对话区域上方和设置页提供三个独立入口，分别对应全局面板、本会话面板和设置信息。
典型用法：
1. 打开仪表盘，默认展示全局 Token 用量趋势。
2. 使用全局筛选（如时间或模型）快速定位高消耗会话。
3. 点击会话进入详情，查看上下文增长曲线和缓存命中情况。
4. 在设置页配置月度预算，监控成本阈值。
注意事项¶
- 成本计算逻辑：对于无内置价且无自定义价的模型，其成本计为 0。此时估算成本显示为“已定价部分的成本 + 未定价 token 数”，而非完整账单。
- 数据持久化：持久化存储在
$DSH_HOME/dsh-token/下，包含元数据文件store.json和分片记录文件shards/。若store.json损坏，插件不会静默清零，而是将其重命名为store.json.corrupt-<时间戳>并进行备份。 - 兼容性与容错：插件支持跨 DSH 版本自适应，采用失败会话隔离机制，对冷却窗口内的老日志进行跳过处理，确保扫描稳定性。
- 运行权限：插件以 DSH 进程权限运行，安装前请检查源码与许可证（MIT）。
总结¶
dsh-token 专注于提供本地化的、细粒度的 Token 成本分析能力。通过四段式构成拆解和预算管理功能，帮助开发者更清晰地掌握推理成本，适合需要精细化控制 Token 消耗的 DSH 用户。
