前言¶
用 DeepSeek Harness（DSH）写智能体或长对话时，账户余额和当前会话的 Token 消耗往往要切到设置页或外部控制台才能看到。会话一多，上下文占用、输入输出与缓存读写也分散在别处，不利于边写边控成本。
Pixel Usage Desk 是面向 DSH Web 客户端的 overlay 插件：在同一窗口右上角以复古像素 CRT 风格展示 DeepSeek 余额、本会话 Token、上下文条与累计用量。同一仓库还提供 macOS 独立桌面小部件，视觉一致，可拖到屏幕任意位置；桌面应用不是插件市场安装项，需本地构建。
这是什么¶
维护者 wxfiveopps1102 在 GitHub 发布 pixel-usage-desk（npm 包名 dsh-pixel-usage-desk，当前版本 0.1.0，MIT 许可证）。SkillHub 分类为客户端。
仓库根目录是可安装的 DSH 插件 bundle（dsh.bundle + cordis.patch.yml）；desktop/ 为 Swift + WKWebView 的 macOS 13+ 独立应用，与插件分开安装。
核心功能¶
DSH overlay¶
overlay 通过 shell.overlay 挂在 Harness Web UI 全帧 overlay 层，右上角显示：
- 余额与预算表盘：钱包数值包含普通余额与 bonus；可本地设置预算（
SET）。 - 当前会话 Token：输入、输出、cache 读/写。
- 上下文占用：分段条显示
used / context window。 - 累计与速率：已加载会话的 Token 合计、实时 tokens/分钟、24 格活动条。
- 操作：
SYNC刷新余额，–折叠为紧凑条；拖拽PIXEL DESK标题在 Harness 窗口内移动。
界面使用像素字体（5×7 字形）、扫描线、硬阴影，并支持 reduced-motion。不发起模型调用：只读 DSH 会话投影与既有账户 remote，不消耗 Token。
macOS 桌面应用（同仓库）¶
透明、无边框、默认置顶；浅色暖 beige、深色绿色 CRT，可跟随系统。从顶栏整圈拖拽移动；× 仅隐藏窗口，可从 Dock 再开。SPENT 展示账户生命周期平台费用（非 Token 数）。读取与 overlay 相同的本地 DSH 数据；DSH 关闭后仍可运行，但 token 可能过期、缓存不再更新。
环境与依赖¶
- DSH overlay：DSH 0.2.1-rc.3 或更新（
package.json中engines.dsh为>=0.2.1-rc.3），需shell.overlay与会话控制器服务。 - 余额：须在 DSH 中登录 DeepSeek 账户；未登录时钱包显示
NO ACCOUNT/OFFLINE，Token 指标仍可本地工作。 - 桌面应用：macOS 13+ 与 Xcode Command Line Tools（
swiftc）；本地 ad-hoc 签名，非公证分发。
安装与启用¶
在 DSH 插件页将该仓库添加为插件源：
https://github.com/wxfiveopps1102/pixel-usage-desk
若 dsh CLI 已在 PATH 中：
dsh plugin --profile <profile> add git+https://github.com/wxfiveopps1102/pixel-usage-desk.git
安装后在 Plugins 页启用 Pixel Usage Desk，CRT 出现在 frame-wide overlay 右上角。若未出现，确认已启用并 reload DSH 页面，可在浏览器控制台搜索 pixel-usage-desk。
仓库根目录才是可安装 bundle；desktop 应用不会随插件安装，需单独构建。
社区目录方面，仓库已准备提交 awesome-dsh-plugin；合并后可从 format-1 市场（如 dsh-market）安装。DSH 生态强调「一切皆插件」；社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
典型用法¶
Overlay
- 在 Harness 内拖拽标题移动 widget。
SET编辑本地预算（供余额表盘使用）。SYNC强制刷新余额。–折叠；在 Plugins 页禁用插件即可移除。
桌面 widget（可选）
cd desktop
./build.sh
open PixelUsageDesk.app
控件、可选 LaunchAgent 与排错见仓库内 desktop/README.md。
数据从哪来¶
Overlay：钱包走 DSH 已有 ctx.remote.account.getBalance(...)（deepseek-account provider）；无 account 服务时 Token 仍可用、钱包为 OFFLINE。Token 来自 ctx.sessions.list 与 token-meter 投影（tokenUsage、contextPressure）。余额约每 30 s 刷新；用量随会话变化，速率约 5 s tick。
桌面应用：从 ~/.dsh/.credentials.yaml 只读账户 token，仅请求 https://platform.deepseek.com/api/v0/users/get_user_summary；Token 用量读 ~/.dsh/storages/session_projcache/sessions/*.json，当前会话取最近修改的缓存文件。余额 30 s、用量 2 s 刷新。
插件无遥测；overlay 不自行开网络连接。桌面应用不写入、不记录、不上传凭证到除 DeepSeek 余额接口以外的地址。
适用场景与注意¶
适合需要在编码或对话过程中一眼看到余额、会话 Token 与上下文压力的 DSH 用户；希望 widget 脱离浏览器窗口时，可在 macOS 上本地构建 desktop 应用。
限制与注意（摘自上游文档）：
- 「全部」用量是已加载投影会话之和，尚无按日/月拆分；投影在 DSH checkpoint 边界更新，界面可能略滞后于 live 请求。
- 桌面应用仅 macOS，未公证；Gatekeeper 可能需要确认或使用仓库提供的启动脚本。
- DSH 插件在当前 dsh 进程权限下运行；安装前请自行审阅 源码 与 MIT 许可证，勿分发含他人凭证的构建产物。
