前言¶
DeepSeek Harness（DSH）桌面版在「設置 → 賬號與餘額 → 查詢用量」裏默認打開內嵌的 platform.deepseek.com/usage 頁面。若你更希望在應用內直接看到餘額、累計消費與 Token、以及按日彙總的可視化，而不依賴該網頁，社區插件 Neko_02（npm 包名 dsh-usage-overview）會把同一入口換成可讀的面板，數據仍走 DSH 已有登錄會話，由 Host 側聚合 Platform API 後只把數字交給界面。
下面介紹它是什麼、能做什麼、如何安裝與使用時需要注意的點。
這是什麼¶
Neko_02 由維護者 nTillMeetu 發佈，歸類爲 客戶端 類 DSH 插件；在 SkillHub 目錄 與 GitHub 倉庫 均可找到。當前倉庫版本 1.0.1，許可證 MIT。README 明確說明：這不是 DeepSeek 官方產品，而是運行在 DSH 桌面 profile 內的社區插件，依賴 DSH 的擴展點（Host 註冊路由、Client 注入設置面板）。
核心功能¶
面板替換「查詢用量」內嵌頁，提供整賬號視角的用量概覽（README 與 package 描述已覈實）：
- 賬號彙總：餘額、累計消費、累計 Token 與請求次數。
- 單月日曆熱力圖：每一天顯示當日消費與 Token，顏色深淺表示當日花費高低；點擊某天彈出明細（消費、Token、API 請求數）。
- 月份導航：月份選擇器與月份方塊網格，點擊可跳轉到對應月份。
- 篩選與導出：按 API Key 過濾；將所選月份導出爲 CSV。
界面支持 DSH 的深色與淺色主題；README 截圖註明使用合成數據演示。
安裝與啓用¶
環境要求（來自 README）：
| 項 | 說明 |
|---|---|
| 應用 | DeepSeek Harness 桌面版（文檔寫明在 0.2.1-rc.5、Windows x64 上測試） |
| Node.js | 20+（安裝腳本用；DSH 自帶 runtime 可作後備） |
| 賬號 | 已在 DSH 中登錄（面板讀取現有會話） |
| 系統 | 目前主要在 Windows 上測試；安裝腳本僅用 Node API，其他平臺未充分驗證 |
這不是獨立 Web 應用，而是寫入 DSH profile 的 bundle：Host 增加一條路由，Client 在設置對話框中增加一塊麪板。
官方安裝步驟如下。腳本會定位 DSH profile（默認 ~/.dsh/profiles/desktop，可用 --profile 覆蓋），備份 package.json 與 pnpm-lock.yaml，添加 link: 依賴與 dsh.profile.bundles 條目，再用 DSH 內置 pnpm 安裝，並提示重啓。
git clone https://github.com/nTillMeetu/Neko_02.git
cd Neko_02
node install.mjs
裝完後 重啓 DeepSeek Harness，打開 設置 → 賬號與餘額 → 查詢用量。
常用參數：
node install.mjs --dry-run # 僅預覽將要修改的內容
node install.mjs --profile "C:/Users/you/.dsh/profiles/desktop"
node install.mjs --uninstall # 卸載
若手動改 profile，在 ~/.dsh/profiles/desktop/package.json 中加入 dsh-usage-overview 的 link: 依賴，並在 dsh.profile.bundles 中註冊 dsh-usage-overview，在該目錄執行 pnpm install 後重啓 DSH。示例結構見倉庫 README 的 Manual install 小節。
卸載：
node install.mjs --uninstall
然後重啓 DSH；手動安裝時需刪除依賴與 bundle 項並重新 pnpm install。
典型用法¶
安裝並重啓後，從設置進入「查詢用量」即可使用面板，無需額外配置項（資料中未列出獨立配置文件字段）。
可按 API Key 過濾查看；在月份選擇器或月份方塊中切換月份，在熱力圖上點選某一天查看當天明細；需要留存記錄時，導出當前所選月份 CSV。
若餘額或用量報錯，README 建議：確認 DSH 內已重新登錄，再打開面板並點擊 刷新。若僅 Client 熱重載而未重啓 DSH，Host 路由可能未註冊，會出現月度數據不全、月份選擇器被禁用等情況——完整安裝流程已包含重啓 Host。
工作原理與安全（簡要）¶
- Host（
lib/index.js）註冊/usage-overview/summary，使用 DSH 已有的賬號授權，調用 Platform/api/v0/usage/by_api_key/*（31 天對齊窗口，帶緩存），只返回數字。 - Client（
lib/client.js）在 DSH overlay 槽位渲染面板，向上述路由拉數據，不直接訪問platform.deepseek.com。
賬號 token 不離開 Host 進程、不下發到客戶端；插件 README 稱運行時無遙測、無第三方依賴（React 與 DSH UI 原語由 DSH 提供）。插件以當前 DSH 進程權限運行，安裝前建議自行查看源碼與 MIT 許可證。
適用場景與注意¶
適合：長期在 DSH 桌面版開發、調試 API，希望在同一應用內快速對照餘額、日消費與 Token，並按 Key 或月份導出 CSV 的用戶。
注意（均來自 README Caveats / Troubleshooting）：
- DSH 插件 API（如
shell.overlay、profile Web 路由、UI 原語）並非穩定公開契約，DSH 升級可能導致插件失效，大版本升級前可查看倉庫 Issue。 - Platform 單次查詢上限爲 31 個日曆對齊日，全時段與月度合計由連續窗口累加；月度合計可能與平臺 lifetime 合計有少量分位差異。
- 月份表從賬號首個 API Key 所在月份開始，更早月份在選擇器中不可用。
- 倉庫路徑變更後需重新運行
node install.mjs以刷新link:路徑。 - 面板不出現：檢查 profile 的
dsh.profile.bundles是否含dsh-usage-overview，並在 profile 目錄重新pnpm install；需 DSH 構建提供shell.overlay槽位。
SkillHub 與 GitHub 上的社區目錄獨立於 DeepSeek / 幻方，不等同於官方應用商店。
結尾¶
Neko_02 把 DSH 桌面版「查詢用量」從內嵌平臺頁換成應用內面板：餘額、累計指標、按月日曆熱力圖、按 Key 過濾與 CSV 導出，Host 聚合、Client 展示，適合需要在本機 DSH 裏一眼看清用量結構的開發者。
- 目錄頁：https://www.skillhub.cn/plugins/nTillMeetu/Neko_02
- 源碼與文檔：https://github.com/nTillMeetu/Neko_02
