前言¶
用 DeepSeek Harness（DSH）做智能体开发时，会话会不断产生 provider 用量，但默认界面里往往缺少一页集中汇总：累计吃了多少 Token、哪几天用量高、常用工具和技能分别是什么。若你习惯 Codex 设置里的「用量」页，会在 DSH 里感到缺了一块。
下面介绍社区插件 dsh-codex-usage-board（维护者 skystart233-code，分类：客户端）。它在 DSH 设置 → 用量 增加一页看板，数据全部从本机会话日志折叠而来，不联网、不埋点、不上传。
这是什么¶
dsh-codex-usage-board 是面向 DSH Web 客户端的插件（当前 package 版本 1.2.1，MIT 许可证）。定位可以概括为：在设置页展示头像、五个累计指标、跨整年的 Token 热力图、常用工具与技能洞察，以及近 30 天按模型 / 按会话的明细——相当于把 DSH 的设置体验补成「Codex 用量页」那种形状，但统计对象仍是 DSH 自己的会话日志。
Host 侧提供只读工具 usage_board_report 与资料读写路由；浏览器半通过 settings.section 注册 codex-usage 页。星标与社区目录以 SkillHub 插件页 与 GitHub 仓库 为准（目录抓取时为 0）。
核心功能¶
看板布局¶
打开 设置 → 用量 后，页面大致包含：
- 顶部可编辑资料区：头像、名字、
@账号。 - 五个累计数字：累计 Token、使用峰值、最长任务、最长连续天数、当前连续天数。
- Token 活动：53 周热力图，支持「每天」「每周」「累计总量」切换；格子可点击查看当天（或当周 / 累计到当天）用量；窄屏时热力图保持格子尺寸、横向滚动，默认停在当前周。
- 常用工具：按调用次数排序的 chip。
- 洞察：例如最常用推理强度分布、已探索技能数、技能调用总数、工具调用总数。
- 近 30 天：按模型与用量最高会话两列展示。
资料与个性化¶
首次打开会有简短操作提示（仅一次）。无需进单独设置页即可：
- 头像：悬停后出现相机图标，选择 PNG / JPEG / WebP / GIF / SVG（≤ 256 KB）。
- 名字 / 账号：悬停出现输入框，就地编辑，回车或失焦保存，Esc 取消。
- 名字为空时显示「我的用量」；头像为空时退回首字圆标。
资料保存在 ~/.dsh/usage-board/profile.json（或 $DSH_HOME/usage-board/profile.json）；删除该文件即恢复默认。提示状态同样本地记录，点「知道了」或 Esc 后不再弹出。
统计口径（摘自仓库说明）¶
| 展示项 | 计算方式 |
|---|---|
| 累计 Token | 所有 assistant/message 的 usage，input + output |
| Token 使用峰值 | 单日 input + output 的最大值 |
| 最长任务用时 | turn/start → turn/end 的最长墙钟时间 |
| 最长 / 当前连续天数 | 有 usage 的日历日连续段 |
| 推理强度 | request/header 的 config.reasoningEffort 分布 |
| 技能数 / 技能调用 | tool/call 中 skill 的 arguments.name 去重与计数 |
| 工具调用 / 常用工具 | 所有 tool/call 的 name 计数 |
| 按模型 / Top 会话 | 近 30 天窗口内汇总 |
补充约定：日期按浏览器本地日历日切分；fork / seeded 会话继承前缀会跳过以免重复记账；每个会话汇总按日志 revision 缓存；一次最多扫描最新 500 个会话，页面底部会说明是否截断。热力图固定 53 周，更早日期不画格，但累计数字仍包含它们。仅统计写入会话日志的 provider 用量；无 usage 上报的请求不计入 Token。老会话若无 session/title，标题退化为第一条用户消息首行。
隐私与边界¶
- 只读本机会话日志并在本机聚合，无出网请求。
- 名字、账号、头像仅写入
$DSH_HOME/usage-board/profile.json，不进会话日志。 - 插件不算费用、不做排名或打卡、不展示他人用量。
安装与启用¶
DSH 生态采用「一切皆插件」；SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系。安装前建议浏览仓库源码与 MIT 许可证；插件以当前 dsh 进程权限运行，需自行评估是否信任维护者代码。
插件页（推荐）
- 侧边栏 插件 → 添加插件
- 填写仓库地址：
https://github.com/skystart233-code/dsh-codex-usage-board - 打开 设置 → 用量 查看数据
命令行
dsh plugin --profile <你的 profile 名> add https://github.com/skystart233-code/dsh-codex-usage-board
插件市场索引
在 插件 → 发现 的索引源中加入：
https://raw.githubusercontent.com/skystart233-code/dsh-codex-usage-board/main/index.json
然后搜索「用量看板」安装。
典型用法¶
- 按上文任一方式安装并启用插件（客户端配置为
immediately: true，依赖@deepseek-ai/dsh-client-locale与@deepseek-ai/dsh-client-ui-settings）。 - 进入 设置 → 用量，等待 Host 通过
GET /api/codex-usage.dashboard聚合本机日志；需要更新展示时可使用页面上的刷新能力（与 Codex 用量页同行的交互）。 - 按需编辑头像与显示名，便于区分本机多个 profile 的看板资料（各 profile 的
$DSH_HOME相互独立）。 - 在热力图上切换「每天 / 每周 / 累计总量」，点击格子核对某段时间 Token；在下方的近 30 天列表里对照模型与会话标题，定位高用量任务。
若你维护插件或二次开发，仓库 README 给出本地测试命令（聚合、资料、路由与可选 React 渲染测试），入口文件为 Host 半 index.js 与浏览器半 client.js。
适用场景与注意¶
适合谁
- 长期在 DSH 里跑会话、希望像 Codex 一样在设置里一眼看到 Token 与工具/技能分布的开发者。
- 需要在单机内做用量复盘、又不想把统计数据发到第三方的团队或个人。
使用前注意
- 看板质量取决于会话日志是否完整写入 usage；失败或未上报 usage 的请求不会出现在 Token 统计里。
- 会话数量超过扫描上限时，近端汇总可能截断，以页面底部提示为准。
- 社区插件由维护者独立发布，版本与行为以 GitHub 仓库为准；安装即授予插件读取会话日志与写入
usage-board/profile.json的能力，请自行审阅index.js、client.js与cordis.patch.yml。
结尾¶
dsh-codex-usage-board 用本机会话日志补全 DSH 设置页的用量视图：热力图、累计指标、工具与技能洞察、近 30 天明细，资料可本地编辑且不离开机器。若你需要这类「镜子式」统计而非计费或排行，可按官方 README 安装后从 设置 → 用量 开始查看。
