前言¶

在使用 DeepSeek Harness（dsh web）進行智能體開發或長期對話時，經常會遇到一個具體問題：無法直觀看到當前會話消耗了多少 token，也不知道不同供應商、不同時段的價格差異。這會導致成本控制不透明，甚至難以判斷是否需要切換模型或供應商。

這是什麼¶

dsh-token-fee 是爲 DeepSeek Harness 網頁端提供會話實時花費顯示的插件，由 lantiosity 維護。它會在輸入框下方展示費用膠囊，精確到分，並可按供應商、模型、緩存命中/未命中、輸出等維度展開明細。支持按供應商區分價格，以及峯谷分時定價。

核心功能¶

• 會話實時花費：輸入框下方顯示費用膠囊，默認以人民幣顯示當前會話花費，精確到分。支持切換展示幣種。
• 用量與費用明細：點擊膠囊展開面板，按供應商/模型分組，列出緩存未命中、緩存命中、緩存寫入、輸出四類 token 的數量與金額。
• 按供應商區分價格：同一個模型在不同供應商下可有不同單價。
• 峯谷分時定價：支持高峯/空閒兩檔單價，可自行設置時區、高峯星期、高峯時段。膠囊上實時顯示當前時段與到下一次切換的剩餘時間。
• 價格配置面板：插件設置中有獨立頁面，也能從費用面板直接打開。
• 價目表文件：價目表存儲在 <DSH_HOME>/token-fee.json，手工編輯後即時生效，無需重啓。
• 界面中英雙語。

安裝與啓用¶

裝完都重啓 dsh web，再硬刷新瀏覽器。

插件管理器（DSH 0.1.6-alpha.2 起）：

側欄 → 插件 → 添加插件，在「包名或地址」裏填下面任一種：

• npm 包名：@lantiosity/dsh-token-fee
• GitHub 簡寫：github:lantiosity/dsh-token-fee
• 倉庫地址：https://github.com/lantiosity/dsh-token-fee
• 本地檢出：本倉庫目錄的絕對路徑

點安裝：Host 會先讀出這個 spec 指向什麼，確認是帶 dsh.bundle.patch 的插件後纔開始裝；裝完點立即啓用。

命令行：

# 從 npm 安裝
dsh plugin --profile web add "@lantiosity/dsh-token-fee"

# 從 GitHub 安裝
dsh plugin --profile web add "github:lantiosity/dsh-token-fee"

# 或從本地檢出安裝（把路徑換成本倉庫所在目錄）
dsh plugin --profile web add "/path/to/dsh-token-fee"

備選安裝器（無法使用 dsh plugin 時）：

node scripts/install.mjs            # 複製文件並冪等寫入 profile patch
node scripts/install.mjs --dry-run  # 只打印將寫入的路徑
node scripts/install.mjs --check    # 校驗既有安裝

典型用法¶

安裝完成後，費用膠囊會出現在輸入框下方，與內置的「輪次 / 速度」和「token 用量」膠囊並排。默認顯示 ¥0.12 這樣的金額；會話中還有未配置價格的模型時，會額外標註未定價數量。

點擊膠囊展開面板，頂部是合計金額，下面按供應商分組；每個模型默認只顯示總 token 數與費用，點它展開纔是四個計費桶各自的 token 數與金額。區分峯谷的條目會標註「區分峯谷」。

在面板內的第二個標籤頁，或在 dsh 設置中打開「Token 費用」頁，可以配置價目表。

適用場景與注意¶

本插件適用於需要精細控制 token 成本、使用多供應商或需要區分峯谷定價的場景。插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證（MIT）。

已知限制包括：遠程訪問時端點不可用（價目表端點只接受迴環來源）；節假日數據需逐年更新；跨幣種需要手動配置匯率；倒計時的小時不進位到天。

短結尾¶

dsh-token-fee 爲 DeepSeek Harness 提供了透明的會話計費能力，適合需要精細成本控制的開發者。詳見：https://www.skillhub.cn/plugins/lantiosity/dsh-token-fee，https://github.com/lantiosity/dsh-token-fee