前言¶

在 DeepSeek Harness（DSH）里長時間跑對話或調試插件時，錢包餘額和當前是否處於高峯計價，往往要另開頁面或憑記憶估算。官方價目表又區分高峯與空閒時段，週末、節假日規則並不直觀。社區插件 dsh-sidebar-status（維護者 sunzphy，分類：聯網工具）把賬號充值餘額、贈金（若有）以及當前高峯/空閒時段固定在側邊欄底部，並提供一鍵跳轉官方充值頁，減少上下文切換。

這是什麼¶

dsh-sidebar-status 是面向 DSH Web 客戶端的瀏覽器側插件（MIT 許可，當前 package 版本 0.1.0）。它在側邊欄底部佔用一塊固定狀態區域，展示 DeepSeek 賬號錢包餘額（充值餘額 + 有贈金時的贈金餘額）和按中國大陸價目表口徑計算的高峯時段 / 空閒時段；餘額走 DSH 的 account 子系統，不讀取 DEEPSEEK_API_KEY，也不調用 api.deepseek.com/user/balance 那條 API Key 路線。

界面示意（來自項目 README）：

  餘額 ¥10.46  ⟳  ● 空閒時段            去充值

• 餘額：有數據時顯示；拿不到時靜默省略，不會顯示 0 或佔位符。
• ⟳：手動刷新余額。
• 時段：鼠標懸停可看下一段高峯或空閒何時開始；時段爲本地計算，與是否登錄無關，只要插件能算出就會顯示。
• 去充值：打開官方充值頁。

目錄頁：https://www.skillhub.cn/plugins/sunzphy/dsh-sidebar-status
源碼與說明：https://github.com/sunzphy/dsh-sidebar-status

核心功能¶

餘額¶

餘額僅在窗口聚焦和每輪迴答結束時各讀一次，沒有定時輪詢。數據來自已登錄 DeepSeek 賬號的錢包，依賴 DSH >= 0.1.7-rc.2 才具備的 account 子系統。

高峯 / 空閒時段¶

規則對齊 DeepSeek 中國大陸價目表：高峯爲北京時間週一至週五（不含中國法定節假日）9:00–12:00、14:00–18:00，單價爲空閒時段的兩倍；空閒爲其餘時間，含週末與法定節假日全天。

實現上：週末與元旦、勞動節、國慶等固定日期按規則判斷；清明用壽星公式；春節、端午、中秋用天文推算（Meeus 新月級數 + Intl 月份標籤），無需每年維護節日表。調休拼出的連休未建模——僅因調休而實際放假的工作日可能仍顯示爲高峯，誤差方向是「報價比實際貴」，不會報便宜。

插槽選擇、CSS 與天文算法細節見倉庫 lib/client.js 頂部註釋與各 #region 段落。

安裝與啓用¶

Web 側一條命令安裝，刷新頁面即可：

dsh plugin --profile web add github:sunzphy/dsh-sidebar-status

其它方式：

• 從 Releases 下載 .tgz，執行 dsh plugin --profile web add <文件路徑>。
• 桌面端（Electron）：--profile desktop 會被 CLI 拒絕。若手工安裝，需將包放入 ~/.dsh/profiles/desktop/node_modules/，並在 ~/.dsh/profiles/desktop/cordis.patch.yml 追加宿主條目（不要寫 inject:，本插件無宿主側行爲；誤寫不存在的服務名會導致插件無法啓動且界面無明顯報錯）：

- insert:
    - id: sidebar-status
      name: 'dsh-sidebar-status'

卸載 Web 安裝：

dsh plugin --profile web remove dsh-sidebar-status

手工安裝則刪除補丁中對應行並刪除包目錄。

環境要求與典型結果¶

DSH 版本通道¶

account 子系統在 0.1.7 才加入。npm 上 latest 仍爲 0.1.5-rc.3（無 account），npx @deepseek-ai/dsh web 默認只能看時段、拿不到餘額。需要餘額時請顯式使用 next：

npx @deepseek-ai/dsh@next web

DeepSeek Harness 桌面版自帶 0.1.7-rc.2，一般無需單獨切換通道。

登錄與 Web / 桌面¶

賬號登錄在官方實現裏是桌面版（Electron）渲染器專屬（未檢測到 dshDesktop 則不註冊賬號能力）。因此：

適用場景與注意¶

適合在 DSH 側邊欄常駐查看錢包與當前計價時段、並需要從同一位置跳轉充值的開發者。插件在當前 DSH 進程權限下運行，安裝前建議瀏覽倉庫源碼與 MIT 許可證，確認符合你的安全與合規要求。

社區目錄 SkillHub 與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」，本插件是其中一條可選擴展。

結尾¶

dsh-sidebar-status 把賬號餘額、峯谷時段和充值入口收到側邊欄底部：時段本地可算、不依賴登錄；餘額則綁定 DSH 0.1.7 的 account 與桌面登錄能力。安裝命令以 README 爲準，Web 用 --profile web add github:sunzphy/dsh-sidebar-status 即可。

• 目錄頁：https://www.skillhub.cn/plugins/sunzphy/dsh-sidebar-status
• GitHub：https://github.com/sunzphy/dsh-sidebar-status