前言¶

在 DeepSeek Harness（DSH）裏用官方 API 路由跑會話時，token 會按峯谷規則計費，賬戶裏還有多少餘額、當前算高峯還是低谷，往往要切到控制台或另開頁面查。會話進行中若還想估算本段對話花了多少錢，缺少和 Composer 綁在一起的入口會更不方便。

下面介紹社區插件 dsh-simple-usage-info（維護者 MarJose123），它把 DeepSeek API 餘額、當前計費窗口（Peak / Off-peak） 以及 本會話估算費用 嵌進 Web 界面的 Composer dock——即消息輸入框下方、上下文計量條之後的那一行 ambient 區域。點擊該條可展開明細。插件在 SkillHub 目錄中歸類爲「聯網工具」；生態上 DSH 奉行「一切皆插件」，SkillHub 插件目錄 爲獨立社區站點，與 DeepSeek / 幻方無官方從屬關係。

這是什麼¶

dsh-simple-usage-info 是一個 DeepSeek Harness 插件（npm 包名同插件 id，當前 README 對應版本 0.2.4，許可證 MIT）。它不替代模型路由，而是在已有 DEEPSEEK_API_KEY 憑證的前提下，在瀏覽器側展示餘額與計費狀態，並在有 token 消耗時給出會話級費用估算。

餘額查詢與 deepseek-official 模型路由解析的是同一套 DEEPSEEK_API_KEY 環境變量（默認配置項 apiKeyEnv 即爲 DEEPSEEK_API_KEY），無需爲插件單獨再配一把 Key。

核心功能¶

界面位置與交互¶

插件在 Composer 輸入區下方增加一條信息欄；截圖見倉庫 showcase。條上的 pill 顯示 Off-peak（綠色）或 Peak（紅色）。點擊後可查看完整 breakdown（餘額、窗口、定價等分項）。

峯谷窗口與節假日¶

計費窗口按 DeepSeek 已公佈的規則在瀏覽器本地時區下計算：低谷（Off-peak）半價；高峯（Peak） 爲 UTC 週一到週五的 01:00–04:00 與 06:00–10:00，並排除中國法定節假日。節假日列表從 NateScarlet/holiday-cn 拉取（每日同步國務院公告），以保持日期表更新。配置裏可改 peakWindows、peakDays、holidayURL，也可用 bundled 表作離線回退。

會話估算費用¶

當本會話存在非零 token 用量時，會出現 Estimated cost 區塊，按 cached input、uncached input、output 與當前峯谷單價，折算爲 USD 與 CNY。支持的模型爲 deepseek-flash（DeepSeek-V41-Flash）與 deepseek-v4-pro（DeepSeek-V4-Pro-0813），費率與會話所選模型一致。

服務端接口¶

插件提供餘額等數據的 HTTP 路由；服務啓動後可請求：

curl -s -H 'Host: 127.0.0.1:3080' http://127.0.0.1:3080/usage/balance

響應中的 pricing.holidayData 可區分節假日來源：remote（遠程拉取）、bundled（離線回退）或 none。

環境與依賴¶

安裝前請確認：

• DeepSeek Harness 0.2.0-rc.2 或更高版本
• Node 20+
• 已配置 DEEPSEEK_API_KEY（可在 DSH Models 頁寫入，或在啓動前 export）

安裝與啓用¶

DSH 插件管理器會轉發到 pnpm，若本機沒有 pnpm，先安裝：

bun add -g pnpm        # 或: corepack enable pnpm / npm i -g pnpm

推薦通過 profile web 安裝：

dsh plugin --profile web add dsh-simple-usage-info

上述命令會安裝 npm 包、寫入 profile 的 dependencies，並把包名追加到 dsh.profile.bundles。因包聲明瞭 dsh.bundle.patch，其自帶的 cordis.patch.yml 會注入 loader 行，一般無需手改 bundle 列表。安裝完成後重啓 Web 服務（dsh web）。

手動啓用（cordis.patch.yml）¶

若包已在 profile 可解析的路徑（本地 link、私有源等），可在 $DSH_HOME/profiles/web/cordis.patch.yml 追加：

- insert:
    - id: usage-info
      name: dsh-simple-usage-info

然後重啓 dsh web。不要同時使用推薦安裝產生的 bundles 條目與上述 insert 行，否則插件會加載兩次。

無 pnpm 時的拆分步驟¶

dsh plugin 僅通過 pnpm 安裝依賴。可先在 profile 目錄用任意包管理器安裝，或 symlink 本地 checkout 並在 package.json 的 dependencies 中聲明，再通過 cordis.patch.yml 的 insert 行或向 dsh.profile.bundles 追加 "dsh-simple-usage-info" 激活。細節見 GitHub README。

配置¶

在 profile 的 cordis.patch.yml 裏，於 usage-info 對應行下設置 config。常用項如下（完整表格以 README 爲準）：

示例：自定義高峯窗口並追加節假日：

- id: usage-info
  config:
    peakWindows:
      - '01:00-04:00'
      - '06:00-10:00'
    holidays:
      - 2027-01-01

若 peakWindows、星期或時鐘格式不合法，插件在加載階段會報錯並跳過該行，避免用錯誤窗口響應請求。

典型用法與驗證¶

1. 按上一節安裝並重啓 dsh web，確保 DEEPSEEK_API_KEY 可用。
2. 打開 Web Composer，在輸入框下方查看餘額與 Peak/Off-peak pill；有 token 消耗時可見估算費用。
3. 需要腳本側確認時，對運行中的服務執行：

curl -s -H 'Host: 127.0.0.1:3080' http://127.0.0.1:3080/usage/balance

4. 在不改動你現有 $DSH_HOME 的前提下，可在插件倉庫內執行 bun run verify:compose，檢查 profile 是否正確 compose 出 usage-info 行。

開發者在倉庫內還可運行 bun run preflight（離線斷言）、bun run preflight:live（真實餘額與節假日拉取）、bun run preview:panel（預覽 popover markup）。插件無單獨 build 步驟，lib/index.js 與 lib/client.js 爲可直接加載的 ESM。

適用場景與注意¶

適合誰： 長期在 DSH Web 裏用 DeepSeek 官方 API、希望在一屏內看到餘額、當前是否高峯、以及本會話大致花費的開發者。

運行權限： 插件隨當前 DSH 進程加載，會使用進程環境中的 API Key 並訪問配置的 API 與節假日 URL。安裝前建議閱讀 源碼與 LICENSE，確認符合你的安全與合規要求。

聯網： 餘額與（默認）節假日數據需要出站訪問；將 holidayURL 設爲空字符串可改爲離線策略，並依賴 useBundledHolidays 等選項。

結尾¶

dsh-simple-usage-info 把 DeepSeek 賬戶餘額、峯谷計費窗口和會話估算費用收進 Composer 輸入區下方，與現有 DEEPSEEK_API_KEY 共用憑證，適合日常在 DSH 裏控成本、避高峯的用戶。

• 目錄頁：https://www.skillhub.cn/plugins/MarJose123/dsh-simple-usage-info
• 源碼與安裝說明：https://github.com/MarJose123/dsh-simple-usage-info