dsh-usage-and-glass

DeepSeek Harness · Token 用量看板 · 玻璃与鲸影

简体中文 · English

查看模型用量、趋势与估算费用，为界面添加玻璃效果和交互式粒子鲸鱼。

两个独立的社区插件，直接接入 DeepSeek Harness 设置面板，可单独安装。

功能预览 · 兼容范围 · 安装 · 使用说明

功能预览

Token 用量看板：比较模型用量，查看趋势与估算费用

• 直接比较模型：集中呈现输入、输出、缓存命中率与调用次数，模型名称和推理强度分开显示。
• 查看用量变化：通过每日趋势找到用量高点，再按日期、模型和强度筛选，展开会话明细。
• 区分估算与未知：按官方人民币价格估算；缺失字段和无法计价的调用显示为未知。支持将当前筛选结果导出为 CSV / JSON。

总 Token = 输入 + 输出；推理 Token 已计入输出，不重复相加。估算费用不等于平台账单。

玻璃与鲸影：玻璃外观与交互式粒子鲸鱼

• 三种模式，随时切换：关闭、纯净玻璃、星海鲸影；首次安装默认关闭。
• 鲸鱼由粒子组成：指针经过时推散光点，随后缓缓归位；亮度和互动均可调。
• 跟随系统与宿主设置：适配宿主浅色和深色主题，遵循系统“减少动态效果”设置，窗口失焦或隐藏时暂停动画。关闭后撤销外观覆盖。

玻璃效果由 CSS 半透明与背景模糊实现，不使用 macOS 原生 Liquid Glass API。

三张图片均为实际插件客户端在模拟宿主中的预览；看板使用合成数据，没有真实会话、用量或余额。图片不代表本版已经完成原生宿主验收。见截图说明。

兼容范围

0.2.4 / 0.1.3 修订了中文界面和文档表达，统一插件名称、统计说明与操作提示。测试范围见测试记录，图片来源见截图说明。两个版本均为预发布，尚未完成真实桌面客户端或 WebUI 的完整验收。

桌面客户端与 WebUI 共享部分前端机制，但 platform: "web" 本身不代表完整 WebUI 兼容。看板读取的是宿主所在机器的日志。两种运行方式的 profile、启动方式与访问限制见兼容说明。

语言

本页可在简体中文与 English 之间点击切换，这是文档语言切换。看板包含中英文字典并读取宿主语言，没有独立语言开关；运行中切换语言的完整行为待验证，切换后如有旧文案需重载界面。外观设置目前使用中文。文档翻译不表示所有插件界面都已完成翻译。

安装

以下步骤适用于 macOS 桌面客户端。首次使用先启动一次客户端完成初始化，然后完全退出客户端（⌘Q），再安装；不要同时运行其它插件安装操作。

1. 下载需要的插件及其校验文件

仓库和安装包均已公开，可以只下载并安装其中一个插件。

2. 在下载目录校验并安装

只安装一个插件时，只执行它对应的校验和安装命令。

shasum -a 256 -c dsh-token-dashboard-0.2.4.tgz.sha256
shasum -a 256 -c dsh-liquid-whale-0.1.3.tgz.sha256

确认校验结果为 OK 后再执行安装：

DSH='/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh'
"$DSH" plugin --profile desktop add ./dsh-token-dashboard-0.2.4.tgz
"$DSH" plugin --profile desktop add ./dsh-liquid-whale-0.1.3.tgz

使用桌面客户端自带的 CLI，它会安装依赖并自动登记插件，不需要手工修改 profile。

3. 重新打开客户端

在设置中打开“用量看板”或“玻璃与鲸影”。外观插件初始为关闭，选择一种模式即可启用。

"$DSH" plugin --profile desktop add "github:RockyQinn/dsh-usage-and-glass#path:plugins/dsh-token-dashboard"
"$DSH" plugin --profile desktop add "github:RockyQinn/dsh-usage-and-glass#path:plugins/dsh-liquid-whale"

更新与卸载：退出客户端后，用新版本包重复安装命令；卸载使用下面对应的一行，再重新打开客户端。仅需恢复原生外观时，在“玻璃与鲸影”中选择“关闭”即可。

"$DSH" plugin --profile desktop remove dsh-token-dashboard
"$DSH" plugin --profile desktop remove dsh-liquid-whale

数据与隐私

• 看板只读宿主机器上的 DSH 会话日志，不修改会话，也不上传用量统计。余额优先通过宿主账户服务查询；必要时使用宿主已有凭据查询 DeepSeek 官方余额接口。
• 费用是估算；未知模型、缺失字段和无法核实的计价区间保留未知，不用余额差额反推消耗。
• CSV / JSON 导出由你主动触发，可能包含会话标题和工作区路径，分享前请检查。
• 外观插件使用外观配置、主题与指针位置，不读取会话，不请求远程图片、字体或统计服务。

更多数据边界与安全问题报告方式见 SECURITY.md。

使用与开发

插件使用原生 ESM，客户端由宿主加载，无前端构建步骤。开发检查需要 Node 24+：

node scripts/test-all.mjs
node scripts/verify.mjs
node scripts/pack.mjs

许可与来源

社区项目，与 DeepSeek 官方无隶属关系。两个插件均采用 MIT 许可；鲸鱼轮廓来自 DeepSeek Harness 的 MIT 图标，归属与许可见 NOTICE.md。

DeepSeek Harness · DeepSeek 官方价格文档