DSH Web 界面默認顯示 Session 信息和 Token 用量。開發者常需要快速瞭解單次對話的成本。dsh-usage-dock 插件在輸入框下方的統計藥丸行中追加一顆僅顯示金額的藥丸，方便快速概覽。它由 aliensweety 維護，屬於聯網工具類別，採用 MIT 許可證。
核心功能¶
該插件主要提供以下能力：
- 追加成本藥丸：在官方 Session 信息與 Token 用量藥丸後面，並排追加一顆僅顯示金額的藥丸。三粒藥丸作爲一組居中顯示，樣式與官方藥丸保持一致。
- 雙檔位費用顯示：根據當前時段（高峯或空閒）自動計算並顯示費用。在展開面板中，會同時列出高峯價與空閒價兩檔費用。
- 基於投影計算：使用 DSH 內置的
tokenUsage投影進行計算。不讀取會話日誌文件，不髮網絡請求，不觸碰任何憑證。 - 特定路由與模型支持：只對
deepseek-official路由計價。自動識別deepseek-v4-pro與deepseek-v4.1-flash（含deepseek-flash）模型，按各自價目表計費。 - 點擊查看明細：點擊成本藥丸，會打開官方的 Token 用量卡片，其中追加顯示了高峯價、空閒價、緩存命中率等詳細信息。
安裝與啓用¶
從 GitHub 安裝（推薦鎖定版本）：
dsh plugin --profile web add github:aliensweety/dsh-usage-dock#v0.4.0
本地開發使用 link 安裝：
dsh plugin --profile web add D:\Ai\dsh\dsh-usage-dock
dsh plugin add 命令會將插件寫入 profile 的依賴與 bundles 配置。安裝後，通常 patchReload 爲 live，熱掛載即可生效；若未生效，重啓 dsh web 並強刷瀏覽器。
使用方法¶
安裝完成後，在 DSH Web 界面的輸入框下方，你會看到統計藥丸行變爲三粒一組：
[ Session 信息 ] [ Token 用量 ] [¥ 0.47]
點開金額藥丸，會展開官方的 Token 用量卡片，其中包含以下信息：
* 四個 Token 桶：未緩存輸入、緩存讀取、緩存寫入、輸出。
* 總計與費用明細。
* 緩存命中率。
* 高峯價與空閒價兩檔費用。
自定義價格：如果在 Web 控制台執行以下命令，可調整計費價格（對所有已計價模型生效，參數填寫高峯價）：
localStorage.setItem('dsh-usage-dock.pricing', JSON.stringify({ miss: 2, hit: 0.04, out: 8, write: 0 }))
刪除該 key 即恢復內置價格。
計價規則與技術細節¶
- 計價範圍：僅對
deepseek-official路由計價。如果lastUsed.provider爲其他路由，藥丸不渲染。 - 緩存寫入不計價：默認計費爲 0，因爲官方價格表未單獨定義緩存寫入價。
- 價格檔位：
- 高峯時段：工作日 9:00–12:00、14:00–18:00。
- 空閒時段：其餘時間（含夜間與週末），按高峯價的一半計。
deepseek-v4-pro：高峯輸入 9、緩存命中 0.30、輸出 27；空閒爲上述數值的一半。deepseek-v4.1-flash：高峯輸入 2、緩存命中 0.04、輸出 8；空閒爲上述數值的一半。
- 估算值：金額爲估算值。如果會話中途切換了模型，或跨過了高峯/空閒時段，真實費用介於面板中兩檔價格之間，藥丸僅按當前時刻顯示其中一檔。
- 技術實現：不依賴 React 打包，而是使用宿主注入的虛擬 React。通過
ReactDOM.createPortal將藥丸直接渲染進官方藥丸行的 DOM 中，確保自動對齊間距。如果找不到官方那一排藥丸，藥丸會退回到自己一行居中的狀態。
驗證與安全¶
驗證步驟：
1. 在已安裝插件的上裝瀏覽器中強刷界面（Ctrl+F5）。
2. 輸入框下方應出現三粒藥丸，右側爲金額藥丸（空白會話不渲染）。
3. 點開藥丸，檢查 Token 桶與費用明細。
4. 在 DevTools 的 Network 面板中，確認 /plugins/dsh-usage-dock/client.js 返回 200。
安全特性：
* 不讀取會話日誌文件。
* 不觸碰任何憑證。
* 失敗安全：如果投影缺失、路由不匹配或缺少必要數據，插件會靜默不渲染，不留空殼。
卸載¶
dsh plugin --profile web remove dsh-usage-dock
