前言¶
在 DeepSeek Harness（DSH）里跑多轮对话、切换模型、开多个 session 之后，用量往往分散在会话快照和 provider 回报里，很难一眼看清「今天用了多少、哪个模型占大头、某次请求具体吃了多少 token」。自己写脚本扫目录既容易漏字段，也和 Harness 的会话查询接口对不齐。
@asun-labs/dsh-plugin-token-dashboard 是 asun-labs 维护的 客户端 bundle 插件：读取宿主已校验的实时与持久化 session 语料，在当前工作区写出一个 单文件、可离线打开 的 HTML 看板，不依赖外网脚本或遥测。下面介绍它的能力边界、安装方式与典型用法。
这是什么¶
- 定位：DeepSeek Harness 插件，通过工具
token_dashboard生成自包含的 token 用量仪表盘（token-dashboard.html）。 - 维护者：asun-labs（GitHub：asun-labs/dsh-plugin-token-dashboard）。
- npm 包名：
@asun-labs/dsh-plugin-token-dashboard（资料中版本0.1.0）。 - 解决的问题：把 provider 上报的 input / output / cache-read / cache-write 等计数汇总成可交互的本地页面，支持按工作区、session、请求下钻。
产品思路受 fuyi-git/token-dashboard 启发；本仓库为独立 TypeScript 实现，MIT 许可证，未复制其 Python 或 HTML 源码。
核心功能¶
以下能力均来自项目 README，安装前可对照 GitHub 核对：
- 计量口径：使用 provider 上报的 input、output、cache-read、cache-write token 统计。
- 视图：日用量、24 小时活动、模型占比、KPI；支持 1 / 7 / 30 天及全历史窗口切换。
- 下钻：工作区 → session → 单次请求。
- 主题：明 / 暗色，仅保存在浏览器本地。
- 交付物：单个本地 HTML，无外部脚本、字体、网络请求或遥测。
- Fork 场景：统计会排除继承事件前缀，避免 fork 会话重复计账。
数据读取通过公开的 sessionQuery 服务完成，不扫描存储内部、不上传日志、不发起额外网络请求；生成的 HTML 仍含用量元数据、工作区路径、session 标题与模型名，分享前需自行审阅。
环境与依赖¶
- Node.js：
^22.19.0或>=24.0.0。 - DeepSeek Harness：0.1.7 prerelease 线（README 要求）。
安装与启用¶
插件以 npm 包形式安装到指定 Harness profile。资料中的示例使用 profile 名 token-dashboard，命令为 PowerShell 形式；若你使用 bash，需按本机 DSH 文档调整管道写法，但 add 子命令与包名应保持一致。
若 profile 尚不存在，先初始化一次：
dsh --profile token-dashboard --from-default-profile web --dump-config | Out-Null
安装插件并启动（不自动打开浏览器时可加 --no-open）：
dsh plugin --profile token-dashboard add @asun-labs/dsh-plugin-token-dashboard
dsh --profile token-dashboard --dump-config
dsh --profile token-dashboard --no-open
安装后可用 dsh --profile token-dashboard --dump-config 确认 bundle 是否载入。
典型用法¶
在 Web UI 中让智能体调用插件工具即可生成看板。README 给出的提示示例：
Use the token_dashboard tool to generate my token usage dashboard.
工具会在 当前 session 的工作区 写入 token-dashboard.html，并返回该文件的绝对路径。用浏览器打开即可离线查看。
配置项¶
可在 Cordis patch 或插件 config 中设置（字段以 README 为准）：
config:
fileName: token-dashboard.html
readConcurrency: 4
fileName：必须是纯.html文件名；插件 不会 写到活动工作区之外。readConcurrency：整数，范围 1–32，控制读取会话快照时的并发度。
开发者在 Harness 源码树里做本地 checkout 验证或 overlay 迭代时，README 还提供了 corepack pnpm 与 local.cordis.patch.yml 示例；日常使用者以 npm 安装 + Web UI 调工具为主即可。
适用场景与注意¶
适合谁
- 已在 DSH 0.1.7 prerelease 线上使用、希望用本地 HTML 复盘 token 用量的开发者。
- 需要按 workspace / session / 请求排查模型成本、cache 读写占比的场景。
使用前请确认
- 插件在 当前 dsh 进程权限 下运行，能读到的 session 范围与宿主一致；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证。
- 社区目录页 skillhub.cn 插件条目 与 GitHub 为独立信息源；目录站点与 DeepSeek / 幻方无官方从属关系，版本与星标以你安装时 npm / GitHub 为准（资料抓取时 GitHub 星标为 0）。
- 生成物含路径与会话标题等敏感元数据，勿将 HTML 直接发到不可信环境。
小结¶
经过上面的步骤，你可以在不动外部服务的前提下，从 Harness 已持久化的会话里拉出 provider 级 token 账目，并在工作区得到一份可下钻、可切换时间窗口的离线看板。进一步细节与 issue 见 GitHub，插件索引见 SkillHub 目录页。
