前言¶
DeepSeek Harness（DSH）在單個會話裏已經能看 Token 用量，但項目一多、模型和子代理、分叉會話分散在各處，很難回答「這段時間一共燒了多少、哪幾個模型佔大頭、某次請求慢在哪」。社區插件 @shi-yangyang/dsh-token-dashboard（維護者 shi-YangYang，分類：客戶端）在本地把會話日誌聚合成原生看板，以 Token 用量爲主線，並可選做費用估算，不寫日誌、不改請求、不上傳會話。
這是什麼¶
dsh-token-dashboard 是一個本地優先的 Cordis 插件：Host 通過官方 sessionPersistence 讀會話日誌，用與 @deepseek-ai/dsh-token-meter 一致的四桶口徑摺疊數據；Client 通過 DSH Slot 註冊 main 面板和側邊欄 footer 入口，用宿主 React 與主題 Token 渲染。會話日誌始終是唯一事實來源。
- 包名：
@shi-yangyang/dsh-token-dashboard（npm 上無 scope 的dsh-token-dashboard是另一個項目，勿混用） - 許可證：MIT
- 已在 DSH Desktop
0.2.1-rc.3（Cordis4.0.5）驗證；構建需 Node.js 22.18+ 與pnpm
核心功能¶
下面介紹 README 中已列出的能力，均針對當前 profile 的本地會話。
全局與時間範圍
- 當前 profile 下所有會話的總量、未緩存輸入、輸出、緩存讀/寫、請求數、緩存命中率和會話數
- 時間範圍：今天、最近 7 / 30 / 90 天、全部或自定義；KPI 與 Usage 圖表同一範圍
模型、會話與請求
- 模型與會話：可搜索、篩選、排序的分頁表格，會話詳情抽屜
- 請求日誌：按每次計費請求展示時間、應用、供應商、模型、新增輸入、輸出、緩存命中、成本、速度和首字耗時（每頁最多 12 條，最新在前）
費用估算
- 內置 357 個 OpenRouter 模型快照與 DeepSeek 高峯價；可本地覆蓋單價，或從 OpenRouter 刷新
- 費用爲 USD 列表價估算，非 provider 賬單；內置快照日期 2026-10-30
界面與數據邊界
- DSH Slot、主題 Token、中英文界面；導出時自動去掉工作目錄
- HTTP 接口只讀、同源，不暴露 prompt、assistant 文本、工具參數、憑據或文件內容
統計口徑遵循公開 tokenUsage 規則：四個互斥 provider 桶、同一次 attempt 的最終樣本替換流式樣本、重試開新 attempt、分叉繼承前綴不計入總量（實現見倉庫 src/host/fold.ts）。
安裝與啓用¶
當前文檔說明需從源碼構建後作爲本地 bundle 安裝，資料中未給出 dsh plugin add github:... 一類命令。
1、構建（在插件源碼目錄）
先滿足 Node 22.18+ 與 pnpm。在目錄內執行：
pnpm install
pnpm install 會通過 prepare 自動構建 Host 與 Client，生成不入庫的 lib/ 與 client/。改源碼後可執行：
pnpm build
2、安裝到 DSH
在 DSH Plugins 界面選擇本地 bundle，目標指向該插件目錄；或在 DSH Agent 中執行：
plugin_manager(action: "install_bundle", target: "/absolute/path/to/dsh-token-dashboard")
若 profile 中 bundle 被禁用，需啓用後刷新 DSH Web 頁面。入口在側邊欄底部、Settings 上方的 Token 用量。
3、更新與重啓
更新 Host 代碼後需重啓 DSH；僅改 Client 時刷新頁面即可。
典型用法¶
打開 Token 用量 後，可按頁面分工查看：
| 頁面 | 內容 |
|---|---|
| 概覽 | 所選範圍內的全局 KPI 與 Usage 圖表 |
| 模型 | 按供應商/模型統計的 Token 分佈與請求數 |
| 會話 | 搜索、篩選、排序、分頁和會話詳情 |
| 請求日誌 | 逐條計費請求 |
| 費用 | 預估總費用、逐模型明細、單價覆蓋與在線價目刷新 |
頂部可切換語言、設置掃描間隔（5 / 10 / 30 / 60 秒）、點 立即同步 或導出。掃描間隔控制本地會話輪詢。
請求日誌中：成本按瀏覽器當前價目即時計算，未定價模型顯示 —；速度 = 輸出 Token / 實測請求窗口；首字 = step/start 到首個 stream record 的時間，無 stream 時間戳時爲 —。單價覆蓋與在線價目緩存在瀏覽器 localStorage。
Host 提供的只讀路由（同源）包括：GET /dsh-token-dashboard/stats（支持 ETag/304 與 ?refresh=1）、/requests（如 ?offset=0&limit=24）、/prices、/health、/verify。存在 Host Connection 時路由複用其鑑權。
適用場景與注意¶
適合誰
- 長期在 DSH 裏開多會話、多模型，需要跨會話彙總 Token 與趨勢的人
- 需要按模型/會話/單次請求排查用量或延遲，並做本地費用粗算的人
邊界與限制
- 只覆蓋當前 DSH profile 的本地會話；遠程、雲端和其他 profile 不包含
- 首次打開會掃描歷史進內存緩存；DSH 重啓後緩存清空，無持久化索引
- 會話跳轉依賴可選的
uiWorkspace.openSession宿主服務
安裝前
插件以當前 DSH 進程權限運行，安裝前應自行審閱源碼與 MIT 許可證。社區目錄 SkillHub 插件頁 與 GitHub 倉庫相互獨立，並非 DeepSeek / 幻方官方應用商店；DSH 生態強調「一切皆插件」，選用社區 bundle 需自行承擔信任與更新成本。
結尾¶
@shi-yangyang/dsh-token-dashboard 把分散在各會話裏的 Token 用量收成一塊原生看板，只讀本地日誌，可選費用估算，適合把「用了多少、花在哪、哪次請求慢」問清楚。詳情與構建說明見 GitHub：shi-YangYang/dsh-token-dashboard，目錄索引見 SkillHub。
