返回目錄

dsh-usage-panel

精選清單收錄維護狀態: 活躍

alfredchaos/dsh-usage-panel

DeepSeek Harness 消耗統計外掛:設定頁 Token 用量 KPI、半年活躍熱力圖、按模型堆疊柱狀圖與模型環形圖(dsh-plugin)

前往 GitHub
$ dsh plugin --profile web add dsh-usage-panel

14

星數

2

Fork

TypeScript

語言

MIT

授權條款

2026-08-15

建立於

2026-09-15

最近推送

MIT 授權的 dsh bundle 外掛程式:從工作階段日誌做唯讀 token 計帳,含 fork 去重、UTC 日桶、10 分鐘新鮮度視窗與 JSON/CSV 匯出。

DSH 整合

原生執行環境

作者聲明

安全稽核

未稽核

最後核實

2026-11-10

授權條款

MIT

01它能幫你完成什麼?

  • 看清一套 DeepSeek Harness 實際用掉多少 token,並依模型、provider 與日期拆開看

    設定 → Usage 頁面:全期間總計、快取命中率、半年活躍熱力圖、每日堆疊柱、Top 工作階段、provider 長條圖、模型環圈圖,以及 JSON/CSV 匯出

    想掌握成本、又不想加代理或改動工作階段日誌的 DeepSeek Harness 使用者與團隊

  • 把用量資料匯出,用於結算、預算或試算表分析

    完整 JSON、依日 CSV、依模型 CSV——已做公式注入防護,遵循 RFC 4180,帶 UTF-8 BOM

    需要在 DSH 之外核對 token 開銷的人

02如何將外掛接入 DeepSeek Harness?

先決條件

  • 一個 `web` profile——頁面在 設定 → Usage 下
  • README 的實作說明:對照 DeepSeek Harness `0.1.5-rc.1` 開發

安裝步驟

  1. 01

    從 npm 安裝(建議):`dsh plugin --profile web add dsh-usage-panel`

    $ dsh plugin --profile web add dsh-usage-panel

  2. 02

    或從 GitHub 安裝:`dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel`

    $ dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel

  3. 03

    或從本機 checkout 安裝:`dsh plugin --profile web add ./dsh-usage-panel`

    $ dsh plugin --profile web add ./dsh-usage-panel

  4. 04

    重新啟動 `dsh --profile web`,開啟 設定 → Usage

    $ dsh --profile web

驗證整合成功

  • 首次載入時 Usage 頁面通常直接從快取渲染出 KPI 卡片與熱力圖
  • 重新整理按鈕會強制發起一次同步掃描

復原

  • `dsh plugin --profile web remove dsh-usage-panel`

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

原生 dsh bundle 外掛程式:`dsh plugin add` 會將它加入 profile 的 bundle 名單,patch 列啟用主機半;主機半在共用 `/api` 傳輸上提供 `/api/usage-stats/overview`,用戶端半則渲染 設定 → Usage 頁面。

  • 增量工作階段投影

    已提交的工作階段事件→四個互斥桶(未快取輸入、輸出、快取讀、快取寫),外加依模型、依 provider、依日(UTC)的對應

    檢查點持久化,重新啟動與 keep-warm 幾乎不需要重播外掛程式從不向工作階段日誌寫回任何內容
  • 計費口徑

    `request/header`、`request/context`、`assistant/message`、`llm/retry`、`compaction/summary` 事件→模型歸屬取 context 基準/header 覆寫,步驟用量取代串流暫引用量,重試計為次數而非 token,壓縮用量歸到自己的模型

    reasoning token 已包含在 output 內,不會重複相加
  • Fork 去重

    落在持久化 seed 前綴(`inheritedEventCount`)內的事件→fork 出來的工作階段不會把父工作階段的用量重複計一遍

    `session/end-seed` 標記只用來劃分 resume/fork 的計費紀元
  • 帶過期標記的快取載荷

    瀏覽器的載荷要求→10 分鐘內視為新鮮;更舊的立即回傳並帶 `stale` 標記,同時背景重掃更新快取

    keep-warm 計時器每 10 分鐘重掃一次瀏覽器另把最近一次成功載荷存進 localStorage,帶版本與結構驗證

04適合誰?何時不該用?

適合

  • 想掌握成本、又不想加代理或改動工作階段日誌的 DeepSeek Harness 使用者與團隊
  • 需要在 DSH 之外核對 token 開銷的人

不適合

  • README 說明外掛程式是對照 DeepSeek Harness `0.1.5-rc.1` 開發的;README 中沒有宣告相容性矩陣。

05相容性、維護與安全提醒

  • README 說明外掛程式是對照 DeepSeek Harness `0.1.5-rc.1` 開發的;README 中沒有宣告相容性矩陣。
  • 依日分桶與匯出使用 UTC 日曆日(`YYYY-MM-DD`),熱力圖副標題也會標明口徑(「last 6 months · UTC」)。
  • 投影服務不可用時,外掛程式會退回透過唯讀的 `sessionQuery` 服務重播全部工作階段日誌,比增量路徑慢。
  • 統計只涵蓋已持久化的工作階段日誌;README 並未宣稱這是帳單級準確資料,也不承諾與 provider 帳單對帳。
2026-08-152026-09-15v0.2.3

MIT · 持續維護(最新 release v0.2.3,2026-09-15)

06常見問題

外掛程式會改動我的工作階段日誌嗎?

不會。它透過工作階段投影(不可用時退回全量重掃)彙總已持久化的工作階段日誌,從不寫回,因此統計能跨重新啟動保留,也涵蓋外掛程式安裝之前的工作階段。

快取命中率怎麼算?

`cache read ÷ (uncached input + cache read + cache write)`,旁邊同時給出讀與寫的量級。

fork 出來的工作階段會重複計嗎?

不會。落在持久化 seed 前綴(`inheritedEventCount`)內的事件永不計入,所以 fork 工作階段不會把父工作階段的用量重複計一遍;`session/end-seed` 標記只用來劃分 resume/fork 的計費紀元。

為什麼有時數字顯示為過期?

載荷在 10 分鐘內算新鮮;更舊的會立即回傳並帶 `stale` 標記,同時在背景重掃更新快取。keep-warm 計時器每 10 分鐘重掃一次,重新整理按鈕則始終強制同步掃描。

每日分桶用的是哪個時區?

分桶與匯出都用 UTC 日曆日(`YYYY-MM-DD`);熱力圖副標題會標明口徑為 「last 6 months · UTC」。

08資料與來源

  • 作者聲明github.comf77e7f4a6f15…

    The plugin aggregates persisted session logs (incrementally, via the session-projection mechanism) and never writes anyt…

  • 作者聲明github.comf77e7f4a6f15…

    The plugin ships as a bundle: `dsh plugin add` appends it to the profile's bundle list

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-10。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。