在 DeepSeek Harness (DSH) 的开发流程中，实时监控上下文窗口使用情况和跟踪会话成本是常见需求。dsh-context-dashboard 侧边栏插件为此提供了一个轻量级解决方案，将关键指标整合到工作流界面中。
是什么¶
这是一个驻留在 DSH 侧边栏底部的仪表盘插件。它通过一个折叠式的面板，展示当前会话的上下文使用情况、花费统计以及账户余额。插件由 lcohvne-tomorin 维护，遵循 MIT 协议。
插件会根据当前配置的 LLM 渠道，自动切换按量付费和 Token 套餐两种计费模式的显示逻辑，并支持动态枚举渠道与模型。
核心功能¶
- 实时上下文环：在折叠态下显示上下文占用的百分比与具体数值（如 128K/1M），点击可展开为完整面板。
- 双模式支持：支持按量付费（paygo）和 Token 套餐两种计费模式，面板会根据当前渠道自动切换展示内容。
- 动态枚举：渠道与模型清单通过 DSH 的模型选择器动态获取，新增模型可直接录入。
- 价格目录集成：内置 DeepSeek 官方模型的价格目录，包含高峰/空闲逻辑；其他模型显示为估算。
- 本地历史存储：使用本地存储记录滚动、每周、每月的用量历史。
- 自定义覆盖：支持在设置中通过“价格覆盖表”自定义单位价格。
- 双语界面：UI 自动跟随主题，支持中英文切换。
安装与启用¶
安装此插件需要使用完整的 commit hash 版本。
pnpm dsh plugin --profile <profile> add github:lcohvne-tomorin/dsh-context-dashboard#4fdf5f4109132fe10496dc8785c15d7e31786c5e
使用方法¶
- 展开面板：点击侧边栏底部的“药丸”形状区域（包含环形指示和数字），即可展开完整的仪表盘面板。
- 模式切换：面板会根据当前选中的 LLM 渠道，自动在按量付费和 Token 套餐视图间切换。
- 刷新余额：面板右上角提供刷新按钮，可强制重新检查账户余额。
- 测试模拟：在环境变量中设置
DSH_CD_BALANCE_MOCK=1，可以驱动模拟余额数据进行测试。 - 自定义价格：在设置页面的“单价覆盖表”中，可以录入新模型的自定义单位价格。
注意事项¶
- 网络请求：插件仅对白名单内的渠道（如 api.deepseek.com, dashscope.aliyuncs.com）发起余额查询请求，不进行实时价格抓取。
- 文件访问：插件会写入
$DSH_HOME/storages/dsh-context-dashboard/目录（包含配置、历史记录和折叠状态文件）。 - 凭据安全：插件读取凭据仅用于生成 Authorization 头，不落盘、不记录日志、不显示在界面上。
- UI 注入：插件通过注入
sidebar.footer.action和settings.section槽位来显示界面，卸载时会自动移除。 - 数据隐私：所有用量历史均为本地存储，不向任何第三方上报。
- 依赖要求：需要 Node.js 版本大于等于 22。
总结¶
dsh-context-dashboard 是一个专注于本地数据统计与界面展示的插件，适合需要在开发过程中实时掌握上下文消耗和成本的 DSH 用户。其核心价值在于无需跳转页面即可获取会话状态与余额信息，同时保持了较高的数据隐私性。
