前言¶
在 DSH 中調用 DeepSeek API 時，經常會需要看幾類信息：賬戶餘額還剩多少、今日實際消費了多少、Token 構成是什麼、最近一週或本月的費用趨勢是否異常。這些信息如果都要切到外部平臺頁面查看，會打斷當前工作。
dsh-codex-meter 把這些用量信息接到 DSH 的 Settings → Usage 頁面裏：餘額、今日消費、Token 分析、費用趨勢、即時 API 活動都可以在本地頁面查看。它是按 DSH 插件方式接入的，不是獨立站點，也不是官方應用商店入口。
這是什麼¶
dsh-codex-meter 是 ChrisZhangWG 維護的 DSH 插件，許可證爲 MIT。它面向 DSH web 客戶端，按 DSH 標準 bundle 插件設計，使用 dsh.bundle.patch 和 dsh.client 接入。
它主要解決以下問題：
- 在 DSH 內查看 DeepSeek API 餘額；
- 在 DSH 內查看今日消費和 Token 構成；
- 在 DSH 內查看
7D/Month費用趨勢； - 在 DSH 內查看當前 API 調用是否處於
Active/Idle狀態。
該插件界面全部爲英文。
核心功能¶
Settings → Usage 頁面¶
dsh-codex-meter 提供原生 Settings → Usage 頁面，展示與 DeepSeek API 用量相關的數據。
頁面會顯示以下數據項：
Account balance：DeepSeek API 餘額；Today：今日消費；Last balance change：最近一次餘額變動。
如果配置了 DEEPSEEK_PLATFORM_TOKEN，Today 相關數據可以來自官方接口；如果未配置或 token 失效，頁面會退回本地估算。
Today’s token analysis¶
Today's token analysis 展示今日官方分析信息，包括：
- 請求數；
- 今日費用；
Cache efficiency區間尺；Context size區間尺。
它用於判斷今日請求規模、緩存效率和上下文佔用情況。
Official cost trend¶
Official cost trend 提供兩個視圖：
7D
Month
每個每日費用點會顯示數據標籤，並統計週期內的：
Total
Daily avg
Peak
這個視圖適合查看一週或本月費用變化。
API activity¶
API activity 展示即時狀態：
Active
Idle
其中：
Active表示有模型 API 請求正在運行；Idle表示當前沒有模型 API 請求。
工具執行、權限等待等狀態不會被計入活躍 API 調用。
API activity 不緩存，始終來自即時活動接口：
GET /api/codex-meter/api-activity
緩存行爲¶
插件的用量緩存存活時間爲 7 天。
打開 Settings → Usage 時，頁面會先顯示最近一次成功獲取的統計數據，同時繼續拉取最新數據。刷新期間會顯示：
Showing saved data · refreshing…
如果刷新失敗，插件會保留已有數據，不會把已有統計直接清掉。
密鑰邊界¶
插件只緩存展示型統計數據，例如餘額、今日消費、官方 Token 分析、趨勢數據等。
插件不緩存以下類型信息：
DEEPSEEK_PLATFORM_TOKEN
API Key
憑據
瀏覽器只訪問宿主本地路由。倉庫中不存儲任何密鑰值，也不會把密鑰發送給瀏覽器。
安裝與啓用¶
常規安裝¶
推薦使用 DSH 插件命令安裝到指定 profile：
dsh plugin --profile <name> add dsh-codex-meter
如果要從 GitHub 倉庫安裝，可以使用：
dsh plugin --profile <name> add github:ChrisZhangWG/dsh-codex-meter
如果 profile 名稱是 web，可以使用：
dsh plugin --profile web add dsh-codex-meter
桌面版手動接線¶
桌面版需要手動接線時，先複製插件包到 profile 的 node_modules：
PROFILE=~/.dsh/profiles/desktop
mkdir -p "$PROFILE/node_modules"
cp -R dsh-codex-meter "$PROFILE/node_modules/"
然後軟鏈宿主依賴：
mkdir -p "$PROFILE/node_modules/@deepseek-ai"
ln -sfn "/Applications/DSH Desktop.app/Contents/Resources/app.asar.unpacked/node_modules/@deepseek-ai/dsh-credentials" \
"$PROFILE/node_modules/@deepseek-ai/dsh-credentials"
在 $PROFILE/cordis.patch.yml 中追加 loader 條目：
- insert:
- id: codex-meter
name: dsh-codex-meter
完全重啓 DSH Desktop 後，進入：
Settings → Usage
查看插件頁面。
插件的宿主依賴版本約束爲：
@deepseek-ai/dsh-credentials >=0.1.0-rc.6 <0.2.0-0
典型用法¶
讀取餘額¶
餘額讀取使用：
DEEPSEEK_API_KEY
配置後，Settings → Usage 中的 Account balance 可以顯示 DeepSeek API 餘額。
獲取官方數據¶
官方數據需要使用：
DEEPSEEK_PLATFORM_TOKEN
獲取方式如下：
- 登錄
platform.deepseek.com； - 打開瀏覽器 DevTools Console；
- 執行下面的表達式：
JSON.parse(localStorage.getItem('userToken')).value
把得到的 token 存到：
~/.dsh/.credentials.yaml
示例：
DEEPSEEK_PLATFORM_TOKEN: <token>
配置後，今日官方消費、趨勢圖和逐日相關數據來自官方接口。
注意，DEEPSEEK_PLATFORM_TOKEN 會隨平臺會話過期。失效時，Today 行會顯示：
Today (refresh needed)
並自動退回本地估算。重新獲取 token 後，可以恢復官方數據。
本地測試¶
如果需要運行測試：
npm test
宿主路由¶
插件使用以下宿主路由：
GET /api/codex-meter/balance
GET /api/codex-meter/api-activity
GET /api/codex-meter/session-cost
其中：
GET /api/codex-meter/balance用於餘額、官方數據、今日分析、餘額變動等；GET /api/codex-meter/api-activity用於即時Active/Idle狀態；GET /api/codex-meter/session-cost是本地估算，不是官方賬戶扣費記錄，Settings → Usage頁面不使用它。
適用場景與注意¶
dsh-codex-meter 適合以下使用場景：
- 希望在 DSH 內查看 DeepSeek API 餘額；
- 希望把今日消費、Token 構成和費用趨勢放進
Settings → Usage； - 希望區分
Active/Idle，判斷當前是否有模型 API 請求； - 希望減少在 DSH 和平臺頁面之間來回切換。
使用前需要注意：
- 插件作爲 DSH 插件運行，使用當前 DSH 進程的權限和本機憑據；
- 安裝前應檢查源碼、依賴和許可證；
- 官方數據依賴
DEEPSEEK_PLATFORM_TOKEN，該 token 可能隨平臺會話過期； API activity只表示模型 API 調用狀態，工具執行和權限等待不計入活躍調用；- 本地估算數據不是官方賬戶扣費記錄。
許可證方面，dsh-codex-meter 爲 MIT。價格引擎移植自 bpc-oss/dsh-web-billing，宿主邏輯參考 dsh-deepseek-quota，兩者均爲 MIT。
結尾¶
dsh-codex-meter 的價值在於：把 DeepSeek API 的餘額、今日消費、Token 構成、費用趨勢和即時 API 活動集中到 DSH 的 Settings → Usage 頁面中。它不改變 DeepSeek 平臺的計費規則，也不把密鑰暴露到瀏覽器；它提供的是一個本地可查、可緩存展示型統計、保留即時 API 狀態的用量視圖。
GitHub 倉庫：
https://github.com/ChrisZhangWG/dsh-codex-meter
DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。本次已覈實資料未給出該插件的目錄頁 URL，因此不寫具體目錄鏈接；如需查找，可按插件名 dsh-codex-meter 在 DSH 社區目錄中檢索。
