前言¶

DeepSeek Harness（DSH）处于 developer preview，Web UI 默认不直接展示会话上下文占用和 token 使用历史。做会话调试时，经常要确认当前窗口由 system、tools、messages 各占多少，KV-cache 命中率如何，以及过去若干周的 token 消耗集中在哪些天。

dsh-scope 是一个面向 dsh Web UI 的插件，提供 Codex 风格 /context 会话上下文占用视图，以及 GitHub 贡献图风格的滚动 53 周 token 使用热力图。下面介绍它的核心功能、安装方式、典型用法和注意事项。

这是什么¶

dsh-scope 由 helloxkk 维护，许可证为 MIT，package.json 中声明客户端平台为 web。

它主要提供两个界面能力：

1、在 dsh Web UI 中显示当前会话的上下文窗口占用，并展示 system / tools / messages 的组成占比、各桶会话总量和 KV-cache 命中率。

2、在 sidebar footer 提供 GitHub 贡献图风格的滚动 53 周 token 使用热力图；点击某个日期，可查看四桶 token、cache 命中率、会话数与模型排名。

插件通过官方 token-meter session projections 读取数据，使用 useProjection，不使用 RPC 或自定义 wire protocol。宿主侧提供只读、loopback-only 的聚合端点 /api/dsh-scope/days。

核心功能¶

会话上下文视图¶

dsh-scope 在 dsh Web UI 中提供会话上下文占用视图，可查看：

• 当前会话的上下文窗口占用；
• system / tools / messages 的组成占比；
• 各桶会话总量；
• KV-cache 命中率。

这些数据通过官方 token-meter session projections 读取，并使用 useProjection 获取，不引入自定义 RPC 或 wire protocol。

53 周 token 使用热力图¶

插件在 sidebar footer 提供一个 GitHub 贡献图风格的滚动 53 周 token 使用热力图。

点击热力图中的某个日期后，可以看到当天的：

• 四桶 token；
• cache 命中率；
• 会话数；
• 模型排名。

本地聚合与主题适配¶

宿主端提供 /api/dsh-scope/days 端点，用于读取按天聚合的数据。该端点只读，且仅允许 loopback 调用者和 GET 方法。

聚合支持增量计算，状态会缓存到内存，并持久化到：

~/.dsh/storages/dsh-scope-cache.json

插件使用 dsh 的平台设计变量适配浅色/深色主题。

安装与启用¶

先确认本机已有 dsh >= 0.1.0-rc.6 在 PATH 中。然后安装插件到 web profile，再启动或重启 dsh web 加载插件：

dsh plugin --profile web add dsh-scope
dsh web

如果从源码安装，先构建，再安装到 web profile：

git clone https://github.com/helloxkk/dsh-scope.git
cd dsh-scope
npm install && npm run build
node scripts/install.mjs web
dsh web

其中 node scripts/install.mjs web 用于把插件装入 web profile，最后的 dsh web 用于重启 dsh 以加载插件。

典型用法¶

经过上面的安装步骤，打开 dsh Web UI 后可以看到：

1、在会话上下文中查看窗口占用、system / tools / messages 占比、各桶会话总量和 KV-cache 命中率。

2、在 sidebar footer 查看滚动 53 周 token 使用热力图。

3、点击热力图中的某个日期，查看四桶 token、cache 命中率、会话数和模型排名。

这些数据来自 dsh 已计算的 session projections，并通过插件提供的只读端点聚合返回。插件不读取 provider credentials，也不对外发送数据。

卸载与清理¶

移除 web profile 下的插件目录：

rm -rf ~/.dsh/profiles/web/node_modules/dsh-scope

然后打开 ~/.dsh/profiles/web/cordis.patch.yml，删除其中的 dsh-scope 块。

如果还想清掉聚合缓存，可执行：

rm -f ~/.dsh/storages/dsh-scope-cache.json

该文件保存 dsh-scope 的聚合状态，删除后只影响缓存，不再保留该聚合状态。

适用场景与注意¶

适合在 dsh Web UI 中查看上下文占用、token 历史、模型排名和 KV-cache 命中率的开发者或调试场景。需要注意：

• dsh-scope 要求 dsh >= 0.1.0-rc.6 在 PATH 中。
• DeepSeek Harness 处于 developer preview，后续可能有兼容性破坏变化。
• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 许可证为 MIT。
• /api/dsh-scope/days 仅允许 loopback 调用者和 GET 方法，不读取 provider credentials，不对外发送数据。
• 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应理解成官方应用商店。

链接¶

• GitHub：https://github.com/helloxkk/dsh-scope
• 目录页（插件线索提供）：https://www.skillhub.cn/plugins/helloxkk/dsh-scope