前言¶

用 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 用户名输入框；也可在页脚 更换账号。用户名保存在 $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 设置里一站式查看趋势、模型与榜单，而不频繁切浏览器。

注意：

1. 数据依赖 tokens.ci 公开 API 与你账号的上报；未登录 CLI 或未 tokens serve 时页面为空或滞后。
2. 榜单的 month 为自然月，个人主页的 month 为滚动 30 天；插件在窗口不一致时会标注「榜单按自然月统计」。
3. modelUsage[].percentage 在上游表示费用占比，插件同时计算 token 占比供排序。
4. 宿主端改动（如 index.js）需重启 dsh；仅改 client.js 重载页面即可。
5. 认证勾需在 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 后重载页面。

• 插件目录：https://www.skillhub.cn/plugins/winniesi/dsh-tokens-ci
• 源码与详细说明：https://github.com/winniesi/dsh-tokens-ci