前言¶
在 DeepSeek Harness（DSH）裏跑多輪對話、切換模型、開多個 session 之後，用量往往分散在會話快照和 provider 回報裏，很難一眼看清「今天用了多少、哪個模型佔大頭、某次請求具體喫了多少 token」。自己寫腳本掃目錄既容易漏字段，也和 Harness 的會話查詢接口對不齊。
@asun-labs/dsh-plugin-token-dashboard 是 asun-labs 維護的 客戶端 bundle 插件：讀取宿主已校驗的實時與持久化 session 語料，在當前工作區寫出一個 單文件、可離線打開 的 HTML 看板，不依賴外網腳本或遙測。下面介紹它的能力邊界、安裝方式與典型用法。
這是什麼¶
- 定位：DeepSeek Harness 插件，通過工具
token_dashboard生成自包含的 token 用量儀表盤（token-dashboard.html）。 - 維護者：asun-labs（GitHub：asun-labs/dsh-plugin-token-dashboard）。
- npm 包名：
@asun-labs/dsh-plugin-token-dashboard（資料中版本0.1.0）。 - 解決的問題：把 provider 上報的 input / output / cache-read / cache-write 等計數彙總成可交互的本地頁面，支持按工作區、session、請求下鑽。
產品思路受 fuyi-git/token-dashboard 啓發；本倉庫爲獨立 TypeScript 實現，MIT 許可證，未複製其 Python 或 HTML 源碼。
核心功能¶
以下能力均來自項目 README，安裝前可對照 GitHub 覈對：
- 計量口徑：使用 provider 上報的 input、output、cache-read、cache-write token 統計。
- 視圖：日用量、24 小時活動、模型佔比、KPI；支持 1 / 7 / 30 天及全歷史窗口切換。
- 下鑽：工作區 → session → 單次請求。
- 主題：明 / 暗色，僅保存在瀏覽器本地。
- 交付物：單個本地 HTML，無外部腳本、字體、網絡請求或遙測。
- Fork 場景：統計會排除繼承事件前綴，避免 fork 會話重複計賬。
數據讀取通過公開的 sessionQuery 服務完成，不掃描存儲內部、不上傳日誌、不發起額外網絡請求；生成的 HTML 仍含用量元數據、工作區路徑、session 標題與模型名，分享前需自行審閱。
環境與依賴¶
- Node.js：
^22.19.0或>=24.0.0。 - DeepSeek Harness：0.1.7 prerelease 線（README 要求）。
安裝與啓用¶
插件以 npm 包形式安裝到指定 Harness profile。資料中的示例使用 profile 名 token-dashboard，命令爲 PowerShell 形式；若你使用 bash，需按本機 DSH 文檔調整管道寫法，但 add 子命令與包名應保持一致。
若 profile 尚不存在，先初始化一次：
dsh --profile token-dashboard --from-default-profile web --dump-config | Out-Null
安裝插件並啓動（不自動打開瀏覽器時可加 --no-open）：
dsh plugin --profile token-dashboard add @asun-labs/dsh-plugin-token-dashboard
dsh --profile token-dashboard --dump-config
dsh --profile token-dashboard --no-open
安裝後可用 dsh --profile token-dashboard --dump-config 確認 bundle 是否載入。
典型用法¶
在 Web UI 中讓智能體調用插件工具即可生成看板。README 給出的提示示例：
Use the token_dashboard tool to generate my token usage dashboard.
工具會在 當前 session 的工作區 寫入 token-dashboard.html，並返回該文件的絕對路徑。用瀏覽器打開即可離線查看。
配置項¶
可在 Cordis patch 或插件 config 中設置（字段以 README 爲準）：
config:
fileName: token-dashboard.html
readConcurrency: 4
fileName：必須是純.html文件名；插件 不會 寫到活動工作區之外。readConcurrency：整數，範圍 1–32，控制讀取會話快照時的併發度。
開發者在 Harness 源碼樹裏做本地 checkout 驗證或 overlay 迭代時，README 還提供了 corepack pnpm 與 local.cordis.patch.yml 示例；日常使用者以 npm 安裝 + Web UI 調工具爲主即可。
適用場景與注意¶
適合誰
- 已在 DSH 0.1.7 prerelease 線上使用、希望用本地 HTML 復盤 token 用量的開發者。
- 需要按 workspace / session / 請求排查模型成本、cache 讀寫佔比的場景。
使用前請確認
- 插件在 當前 dsh 進程權限 下運行，能讀到的 session 範圍與宿主一致；安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證。
- 社區目錄頁 skillhub.cn 插件條目 與 GitHub 爲獨立信息源；目錄站點與 DeepSeek / 幻方無官方從屬關係，版本與星標以你安裝時 npm / GitHub 爲準（資料抓取時 GitHub 星標爲 0）。
- 生成物含路徑與會話標題等敏感元數據，勿將 HTML 直接發到不可信環境。
小結¶
經過上面的步驟，你可以在不動外部服務的前提下，從 Harness 已持久化的會話里拉出 provider 級 token 賬目，並在工作區得到一份可下鑽、可切換時間窗口的離線看板。進一步細節與 issue 見 GitHub，插件索引見 SkillHub 目錄頁。
