前言¶
在 DeepSeek Harness（DSH）中，会话与模型的用量信息分散在日志与事件流里，想要一个集中视图并不容易。本插件在左侧栏加入「模型用量」入口，打开一个按模型统计 Token 消耗与请求次数的面板，方便在开发或使用过程中评估各模型的调用成本与使用频率。
这是什么¶
dsh-model-usage 是一个 DSH 客户端插件，由 HitMargin 维护。它通过读取本地会话日志中的 assistant/message 事件，按模型聚合 Token 与请求数据，并以面板形式展示在 Web 界面中。统计范围仅限当前 DSH 进程的会话日志，不涉及其它设备或已删除会话。
核心功能¶
- 左侧栏入口：在
sidebar.panellist新增条形图图标；折叠时显示 Tooltip，展开时显示文字；按钮、焦点、aria 与选中态由 shell 管理，插件只提供图标与本地化标签。 - 整页面板：在
main注册同一 id，点击栏位切换到该页。 - 页面内容：显示当前模型（provider / model / 推理强度）、按模型的用量表（请求数、输入、输出、缓存读取、推理 Token、合计、最近使用时间）、统计进度（首次扫描历史会话时）、已配置的 provider / model 目录。
- 多语言：界面文案与元数据提供中文、英文两套。
安装与启用¶
本仓库是一个标准 DSH bundle（dsh.bundle.patch + dsh.client）。把本目录作为 bundle 装进当前 profile：
plugin_manager action=install_bundle target=<本目录绝对路径>
安装后刷新 DSH Web 页面即可看到左侧栏图标。升级 / 卸载：在插件页停用或移除 Model Usage，或对同一 bundle 执行 remove_bundle。
典型用法¶
- 安装后刷新页面，左侧栏会出现条形图图标。
- 点击图标展开/折叠，点击展开后的文字可进入模型用量面板。
- 首次打开会扫描全部历史会话（本机约 435 个会话 / 约 843MB 压缩日志，耗时约 1–2 分钟，带进度条），之后走缓存。
- 通过 Host 半提供的只读同源接口
GET /api/model-usage（?action=scan触发重扫）可手动重扫会话日志。 - 新的 turn 通过
session/event实时增量累加到缓存中，重启后只重读变更过的会话。
适用场景与注意¶
适合需要按模型评估成本与调用频率的开发者或使用者。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证（本项目基于 MIT 协议）。统计范围仅限本机会话日志，不含其它设备或已删除的会话。
结尾¶
dsh-model-usage 通过集中展示按模型的 Token 与请求统计，帮助你在使用 DSH 时更直观地掌握各模型的调用情况。
- 插件目录页：https://www.skillhub.cn/plugins/2228293026/dsh-model-usage
- GitHub 仓库：https://github.com/2228293026/dsh-model-usage
