前言¶
用 DeepSeek Harness（dsh）做日常开发时，token 消耗和费用往往分散在各个客户端里，要对照 tokens.ci 上的公开榜单，还得单独打开浏览器。若希望在不离开 Harness 的前提下看到每日用量、费用构成、模型占比和排名，需要在设置面板里有一块专门的可视化页面。
下面介绍社区插件 dsh-tokens-ci（维护者 winniesi）：它在 DSH 的 设置 → Tokens.ci 挂载一页仪表盘，数据来自 tokens.ci 公开 API，与 周榜 同源。插件归类为客户端，在 SkillHub 插件目录 可查到条目；目录站为社区生态站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-tokens-ci 在 DSH 设置面板增加 Tokens.ci 一页，展示你账号在 tokens.ci 上的公开统计：每日 token 与费用、token 构成、各模型份额、上报客户端占比，以及榜单名次与全站占比等。
宿主端代理请求 tokens.ci（浏览器端无 CORS，不能直接拉 API）；客户端用 React 注册到 settings.section，样式跟随 DSH 的 --dsw-* 主题。要求 dsh 版本 >= 0.2.0-rc.1 且 < 0.3.0-0，Node >= 18。许可证 MIT，当前包版本 1.0.0。
使用前：先把用量提交到 tokens.ci¶
这一页显示的是 tokens.ci 上你 GitHub 账号的公开数据。若那边尚无记录，页面会是空的。需先用 Tokens CLI 在本机汇总各 AI 编程客户端用量（含 DeepSeek Harness，官方文档称支持约 55 个客户端），只提交汇总数字（token、模型名、时间戳；不传 prompt、补全与文件内容）。
macOS（Homebrew）：
brew install owo-network/brew/tokens
Linux（预编译二进制）：
curl -fsSL https://tokens.ci/install.sh | sh
装完后建议依次执行：
tokens login # 用 GitHub 登录
tokens status # 查看已提交内容
tokens serve # 后台持续提交
macOS 可用 brew services start tokens 代替 tokens serve。提交后服务端有缓存，需稍等再在 DSH 里刷新查看。
安装与启用¶
客户端半边声明 platform: web，与 dsh 自带设置页相同，桌面端与 Web 端均适用。安装前请自行阅读 GitHub 仓库 源码与 MIT 许可证；插件随当前 dsh 进程权限 运行，并会读取本机 Git 配置、gh 等以推断 GitHub 用户名。
桌面端（Desktop app）¶
不要用全局 CLI 的 dsh plugin --profile desktop（该 profile 由 Electron 应用独占）。在应用内：
设置 → 插件（英文界面为 Built-in plugins）→ Add plugin：
- Git repository：
github:winniesi/dsh-tokens-ci；或 - Local directory：本机仓库绝对路径（本地开发时用，改完重载页面即可）
安装提示 “Installed; it loads at the next start.” 后重启应用。
命令行（web 及其他 profile）¶
# 从 GitHub 安装（会钉在当前 push 的 commit）
dsh plugin --profile web add github:winniesi/dsh-tokens-ci
# 本地目录安装（开发时用）
dsh plugin --profile web add /path/to/dsh-tokens-ci
装完重载浏览器页面。卸载：
dsh plugin --profile web remove dsh-tokens-ci
页面能力与典型用法¶
安装并重启（或重载）后，在 DSH 中打开 设置 → Tokens.ci。
| 区块 | 内容 |
|---|---|
| 身份行 | 头像、GitHub 名、统计窗口日期、今日数字、周期 Week / Month / All time、刷新 |
| 每日用量 | 窗口内每日柱状图；可切换 Token / 费用；键盘 ← → Home End 逐日查看 |
| 汇总数字 | Token 总量、费用、活跃天数、消息数等 |
| 榜单 | 名次、领先比例、占全站 token 比例 |
| Token 构成 | 缓存读/写、输入、输出、推理等占比 |
| 模型 | 按费用或按 Token 排序（两种占比可能差异很大） |
| 客户端 | 上报工具（如 zcode、dsh、pi 等）份额 |
首次若无可用账号，页面提供 GitHub 用户名输入框；也可在页脚 更换账号。用户名保存在 $DSH_HOME/dsh-tokens-ci/settings.json（权限 0600）。
可选：固定账号或默认周期¶
编辑 $DSH_HOME/profiles/web/cordis.patch.yml（勿改 bundle 自带文件），例如：
- id: tokens-ci
config:
username: your-github-handle # 固定账号；设置后页面不再显示输入框
period: month # 打开默认周期：week | month | all
改完需重启 dsh。账号解析优先级：config.username → 页面保存名 → Git [github] user → gh api user → Git [user] name。
适用场景与注意¶
适合：已在或计划使用 tokens.ci 与 Tokens CLI 汇总用量，并希望在 DSH 设置里一站式查看趋势、模型与榜单，而不频繁切浏览器。
注意：
- 数据依赖 tokens.ci 公开 API 与你账号的上报；未登录 CLI 或未
tokens serve时页面为空或滞后。 - 榜单的
month为自然月，个人主页的month为滚动 30 天；插件在窗口不一致时会标注「榜单按自然月统计」。 modelUsage[].percentage在上游表示费用占比，插件同时计算 token 占比供排序。- 宿主端改动（如
index.js）需重启 dsh；仅改client.js重载页面即可。 - 认证勾需在 GitHub 个人资料 Social accounts 填至少两个社交链接，tokens.ci 每日 03:20 UTC 刷新，与排名无关。
结尾¶
dsh-tokens-ci 把 tokens.ci 的用量与榜单搬进 DSH 设置页，前提是你已用 Tokens CLI 向 tokens.ci 提交汇总数据。安装方式以 README 为准：桌面端用内置插件管理器添加 github:winniesi/dsh-tokens-ci 并重启；Web profile 用 dsh plugin --profile web add github:winniesi/dsh-tokens-ci 后重载页面。
