前言¶

在 DeepSeek Harness（DSH）裏跑長任務時，Provider 會上報 Token，但界面裏往往看不到「這一通會話花了多少錢、緩存命中和未命中各多少」。自己翻日誌或手算 DeepSeek 峯時、谷時單價既費時，也容易和賬單口徑不一致。

下面介紹社區客戶端插件 dsh-codex-usage-meter（維護者 SimpsonJiang）：從 Host 半摺疊已有 Session 日誌做統計，按 DeepSeek 峯谷價計費，不產生模型請求、不聯網；界面參考 OpenAI Codex 官方用量統計佈局，並針對 DSH 與 DeepSeek 計價做了適配（與 OpenAI / Codex 無隸屬關係，也不包含其代碼）。

這是什麼¶

• 定位：Codex-style 的 Token 用量與費用計量插件，提供當前 Session 底部狀態欄和用量統計頁。
• 包名 / 插件 id：@local/dsh-usage-meter（dsh-usage-meter）；當前倉庫版本 1.5.1，許可證 MIT。
• 分類：客戶端（client.js 負責狀態欄、側欄入口與統計頁；index.js 負責 Host 側計費與接口）。
• 目錄與源碼：SkillHub 插件頁、GitHub 倉庫。

核心功能¶

底部狀態欄（shell.bottom）¶

只展示當前打開的 Session 的費用拆分：

總花費 | 輸入（緩存命中） | 輸入（緩存未命中） | 輸出，並帶實時峯時 / 谷時標識。

未打開會話或停留在其他面板時整條狀態欄隱藏；點擊狀態欄可進入用量統計頁。狀態欄數據可通過 GET /dsh-usage-meter/summary，可選 ?session=<id> 附帶該會話彙總。

用量統計頁¶

左側欄一級入口 + 中間整頁，打開時加載一次，提供手動「刷新」，不做輪詢。數據來自 GET /dsh-usage-meter/stats。

主要內容包括：

1. 6 張 KPI 卡：累計 Token、累計費用、Token 使用峯值、最長任務用時、最長連續天數、當前連續天數。
2. Token 活動圖（近 53 周）：可切換每天 / 每週 / 累計總量，以及 Token / 費用 兩種指標；懸停爲 Codex 風格的深色氣泡。
   - 每天：熱力圖，按用量漸變藍色。
   - 每週 / 累計總量：以熱力格繪製的柱狀圖，整列可懸停；無用量週會顯示對應提示文案。
3. 按模型拆分、歷史回填狀態與統計起點註腳。

計費與數據來源¶

計費與統計均基於 Host 半摺疊 Session 日誌裏已提交的 assistant/message、assistant/attempt 結算，以及 turn/start → turn/end 邊界，不發起模型調用。

默認價目來自 DeepSeek 官方列表價（元 / 百萬 token，README 註明價格頁更新於 2026-09-10），覆蓋 deepseek-flash、deepseek-v4-pro 的緩存命中 / 未命中 / 輸出，峯谷各一檔；谷時價爲峯時的一半。峯時窗口默認爲北京時間 09:00–12:00、14:00–18:00；默認 peakDays: daily（與 README 中 2026-11-08 賬單校準說明一致，亦可改爲 weekdays 並按 holidays 指定全天谷時）。金額以元計，保留兩位小數（末位捨去）；持久化與接口返回值口徑一致。

持久化路徑：<profile>/plugin-data/dsh-usage-meter/usage.json。計價簽名 pricingSignature 變化時會用會話日誌重算全部歷史，避免新舊價目混算。

安裝與啓用¶

README 給出的方式是：通過 Harness 插件管理器安裝本插件目錄——將 install_bundle 指向該目錄的絕對路徑，以鏈接方式裝入當前 profile 並啓用 bundle 的補丁行。Host 變更由 profile 重組（HMR）替換；瀏覽器半隨客戶端模塊 HMR 重載，必要時刷新頁面。

安裝前建議自行查看 倉庫源碼 與 MIT 許可證；插件以當前 DSH 進程權限運行，僅安裝你信任的代碼。

默認零配置即可用；需覆蓋價目、峯穀日歷、輪詢等時，在 profile 的 patch 層配置插件行，例如：

- id: dsh-usage-meter
  config:
    models:
      deepseek-flash:
        peak: { cacheHit: 0.04, cacheMiss: 2, output: 8 }
      deepseek-v4-pro:
        peak: { cacheHit: 0.3, cacheMiss: 9, output: 27 }
        off: { cacheHit: 0.15, cacheMiss: 4.5, output: 13.5 }
    aliases:
      deepseek-v4-flash: deepseek-flash
    fallbackModel: deepseek-flash
    peakDays: daily
    peakWindows: ['09:00-12:00', '14:00-18:00']
    holidays: ['2026-10-01', '2026-10-02']
    retainDays: 400
    pollMs: 5000
    flushMs: 2000
    backfill: true

典型用法¶

1. 安裝並啓用後，打開任意 Session，底部應出現當前會話費用拆分；若無 Session 或非會話面板，狀態欄不顯示。
2. 點擊狀態欄，或從側欄進入「用量統計」，查看 KPI、活動圖與按模型彙總；需要最新聚合時點「刷新」。
3. 若賬單與默認峯穀日歷不一致，在 patch 中調整 peakDays、peakWindows、holidays 或 models；保存後插件會按新口徑重算曆史（見 README「價格與峯谷規則」）。
4. 首次安裝會歷史回填已落盤會話；升級版本會按文檔說明補齊窗口並對賬。回填在後臺進行，超時可能標記 partial，註腳會說明狀態。

會話維度只統計該 Session 自身結算，fork / 子代理繼承的歷史不計入子會話。

適用場景與注意¶

適合：長期在 DSH 內開發、需要會話級費用透明度和 Codex 式全局用量視圖，且希望按 DeepSeek 峯谷價本地估算成本的開發者。

注意：

• 未知模型名會回退 deepseek-flash 並標記「估算」；舊模型名可通過 aliases 映射。
• 統計頁日序列至少保留 371 天（retainDays 下限），以支撐熱力圖。
• 問題與功能請求可到 GitHub Issues 反饋。

結尾¶

dsh-codex-usage-meter 在 DSH 插件體系裏補上了「看得見」的 Token 與費用：當前 Session 狀態欄 + Codex 風格統計頁，計價對齊 DeepSeek 峯谷規則且完全離線聚合日誌。進一步瞭解可從 SkillHub 目錄頁 進入，或直接閱讀 GitHub 倉庫 README。