前言¶

DSH 的扩展方式是「一切皆插件」。这里的插件目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应理解为官方应用商店。

做智能体开发时，token 消耗通常分散在各项目会话中。如果只想快速查看「本机今天用了多少 token」「本周哪个星期用量更高」，直接翻 session logs 并不方便。下面介绍一个 DSH web GUI 插件：@apodemakeles/dsh-token-dashboard。

这是什么¶

@apodemakeles/dsh-token-dashboard 是一个 DSH web GUI token-consumption heatmap 插件。它根据 session-log usage events 提供 daily / weekly total-token usage panel。

基本事实如下：

• 插件名：@apodemakeles/dsh-token-dashboard
• 维护者：apodemakeles
• 许可证：MIT
• 当前版本：v0.2.0
• 分发状态：GitHub distribution is live；npm package 当前未发布
• Node 要求：node >=22.5.0

核心功能¶

侧边栏与面板¶

插件会在 DSH web GUI 的 sidebar 注册一个 Token 入口。点击后打开 dedicated panel，里面包含 weekly grid 和 daily view，用于查看本机所有项目的 token 用量。

数据投影¶

插件的数据链路分为两部分：

• Host half：监听 live session/event，通过 DSH durability barrier flush，并向 persistent Worker 发送最小 usage deltas。
• Worker half：负责 SQLite 数据投影，并对外提供一个 consistent snapshot endpoint。

面板打开或刷新时调用的是 snapshot route：

GET /api/token-dashboard/snapshot

每次 open / refresh / page change 获取一次 snapshot。

总 token 按下面这个公式计算：

inputTokens + outputTokens + cacheReadTokens

CLI 维护命令¶

插件提供本地维护命令：

dsh-token-dashboard status|verify|rebuild|backups|restore|cleanup

安装与启用¶

安装步骤如下：

1、从 GitHub 安装：

dsh plugin --profile web add github:apodemakeles/dsh-token-dashboard

2、重启 DSH web：

restart dsh web

3、打开任意 project session，然后点击 sidebar 中的 Token 入口。

数据与首次启动¶

投影数据库位于：

$DSH_HOME/data/token-dashboard/usage-v1.sqlite

默认 DSH_HOME 为：

~/.dsh

首次启动时，插件会在后台初始化数据库。面板会显示 phase / progress，直到进入 ready。

投影范围是 machine-local：它读取本机存储的 sessions。~/.dsh/sessions 是 authority，SQLite 是 rebuildable projection。

面板只会调用 snapshot route，不会触发下面这些操作：

listSnapshots
inspect
readFrom
flush
backfill

开发安装¶

如果从源码构建，先克隆仓库：

git clone https://github.com/apodemakeles/dsh-token-dashboard.git
cd dsh-token-dashboard

然后安装依赖并构建：

pnpm install && pnpm build

最后以本地链接方式安装：

dsh plugin --profile web add link:$(pwd)

Host / Worker 层面的变更需要重启 DSH；client HMR 不覆盖 persistent Worker。

适用场景与注意¶

适合这些情况：

• 使用 DSH web GUI，并且想在本机查看 daily / weekly token 用量。
• 希望把 usage facts 投影到本地 SQLite，而不是每次打开面板都扫日志。
• 需要查看 inputTokens、outputTokens、cacheReadTokens 合并后的总 token。

注意事项：

• 插件以当前 DSH 进程权限运行。安装前应检查源码与 MIT 许可证。
• npm package 当前未发布，使用 GitHub 安装方式。
• 投影数据是本机数据，不等同于跨机器汇总。
• Node 24 下 SQLite 处于实验状态（node:sqlite）。插件会在启动时检查 capability，并且不会全局隐藏 warning。
• 包声明中 dsh.client.platform 为 web，并注入以下运行时依赖：

@deepseek-ai/dsh-client-runtime
@deepseek-ai/dsh-client-ui-slots
@deepseek-ai/dsh-client-locale

dsh.bundle.patch 指向：

./cordis.patch.yml

结尾¶

这个插件把本机 DSH 会话中的 token 用量整理成 daily / weekly 热力图，适合需要快速判断「今天 / 本周 token 花了多少」的开发者。

参考链接：

• 目录页：https://www.skillhub.cn/plugins/apodemakeles/dsh-token-dashboard
• GitHub：https://github.com/apodemakeles/dsh-token-dashboard