DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在 Web 客户端使用过程中，若要追踪会话与工作区的 Token 消耗、缓存命中情况以及折算费用，往往缺乏直观的入口。dsh-v-token-insight 插件通过直接在客户端侧展示数据面板，将上述信息转化为随时可见的统计与洞察。
插件定位¶
该插件由 victor10035445 维护，采用 MIT 许可证。它为 DeepSeek Harness Web 客户端提供 Token 统计与费用洞察能力，旨在将会话与工作区的 Token 消耗、缓存命中、折算费用与消耗节奏变成随时可见的数据面板。
核心功能¶
插件主要提供以下能力：
* Token 统计与费用洞察：提供跨会话总览、会话页统计及回复尾部的轻量显示。
* 跨会话总览：通过侧栏座位的「Token统计」入口，查看跨会话的 Token 消耗总览。
* 会话页统计：在任意会话页顶部第三页签「会话Token统计」中查看轮级明细与逐步调用。
* 回复尾部轻量显示：在回复尾部显示耗时、费用和 token 总量。
* fork 分支去重：自动识别并去重 fork 分支会话，仅在统计时排除，行保留可查。
* 本地逐步账本 v2：采用分片存储与账面计价方式记录数据，支持覆盖缺口自愈。
* 价目表与计划：支持维护价目表及设置每日/每月计划消耗。
安装与启用¶
插件支持通过 GitHub 地址直装。安装命令如下：
dsh plugin --profile web add "github:victor10035445/dsh-v-token-insight"
如需锁定版本，可在命令后添加 #<commit-sha>。安装完成后需重启 dsh web 并刷新页面生效。
典型用法¶
- 查看跨会话总览：点击侧栏底部的「Token统计」座位，进入跨会话总览页面。
- 查看单会话明细：打开任意会话页，点击顶部第三页签「会话Token统计」，查看当前会话的轮级明细与逐步调用。
- 设置消耗计划：在总览页的「计划」页签中，设置每日或每月的 Token 消耗计划。
- 维护价目表：在总览页的「价格表」页签中，维护价目表信息。
注意事项¶
- 宿主版本要求：插件依赖 DSH 0.1.2-rc.1 及以上版本。旧版宿主请勿升级。
- 纯客户端实现：插件为纯客户端插件，不替换、不禁用任何官方插件，不涉及内核改动。
- 数据来源：所有数据来自宿主既有投影、会话窗口与本地逐步账本。
- 账面计价：价格表费用为账面价。修改价目表仅影响此后新沉淀的账目，不会改写历史数据。
- 本地存储：账本数据沉淀在浏览器的
localStorage中。
总结¶
该插件为 DSH Web 用户提供了从宏观跨会话总览到微观单轮调用的完整 Token 消耗视图，配合本地账本与计划管理，有助于更精细地控制推理成本。更多细节可参考项目仓库。
