前言¶
用 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 許可證，勿分發含他人憑證的構建產物。
