前言¶

DSH 的擴展方式是「一切皆插件」。這裏的插件目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應理解爲官方應用商店。

做智能體開發時，token 消耗通常分散在各項目會話中。如果只想快速查看「本機今天用了多少 token」「本週哪個星期用量更高」，直接翻 session logs 並不方便。下面介紹一個 DSH web GUI 插件：@apodemakeles/dsh-token-dashboard。

這是什麼¶

@apodemakeles/dsh-token-dashboard 是一個 DSH web GUI token-consumption heatmap 插件。它根據 session-log usage events 提供 daily / weekly total-token usage panel。

基本事實如下：

• 插件名：@apodemakeles/dsh-token-dashboard
• 維護者：apodemakeles
• 許可證：MIT
• 當前版本：v0.2.0
• 分發狀態：GitHub distribution is live；npm package 當前未發佈
• Node 要求：node >=22.5.0

核心功能¶

側邊欄與面板¶

插件會在 DSH web GUI 的 sidebar 註冊一個 Token 入口。點擊後打開 dedicated panel，裏面包含 weekly grid 和 daily view，用於查看本機所有項目的 token 用量。

數據投影¶

插件的數據鏈路分爲兩部分：

• Host half：監聽 live session/event，通過 DSH durability barrier flush，並向 persistent Worker 發送最小 usage deltas。
• Worker half：負責 SQLite 數據投影，並對外提供一個 consistent snapshot endpoint。

面板打開或刷新時調用的是 snapshot route：

GET /api/token-dashboard/snapshot

每次 open / refresh / page change 獲取一次 snapshot。

總 token 按下面這個公式計算：

inputTokens + outputTokens + cacheReadTokens

CLI 維護命令¶

插件提供本地維護命令：

dsh-token-dashboard status|verify|rebuild|backups|restore|cleanup

安裝與啓用¶

安裝步驟如下：

1、從 GitHub 安裝：

dsh plugin --profile web add github:apodemakeles/dsh-token-dashboard

2、重啓 DSH web：

restart dsh web

3、打開任意 project session，然後點擊 sidebar 中的 Token 入口。

數據與首次啓動¶

投影數據庫位於：

$DSH_HOME/data/token-dashboard/usage-v1.sqlite

默認 DSH_HOME 爲：

~/.dsh

首次啓動時，插件會在後臺初始化數據庫。面板會顯示 phase / progress，直到進入 ready。

投影範圍是 machine-local：它讀取本機存儲的 sessions。~/.dsh/sessions 是 authority，SQLite 是 rebuildable projection。

面板只會調用 snapshot route，不會觸發下面這些操作：

listSnapshots
inspect
readFrom
flush
backfill

開發安裝¶

如果從源碼構建，先克隆倉庫：

git clone https://github.com/apodemakeles/dsh-token-dashboard.git
cd dsh-token-dashboard

然後安裝依賴並構建：

pnpm install && pnpm build

最後以本地鏈接方式安裝：

dsh plugin --profile web add link:$(pwd)

Host / Worker 層面的變更需要重啓 DSH；client HMR 不覆蓋 persistent Worker。

適用場景與注意¶

適合這些情況：

• 使用 DSH web GUI，並且想在本機查看 daily / weekly token 用量。
• 希望把 usage facts 投影到本地 SQLite，而不是每次打開面板都掃日誌。
• 需要查看 inputTokens、outputTokens、cacheReadTokens 合併後的總 token。

注意事項：

• 插件以當前 DSH 進程權限運行。安裝前應檢查源碼與 MIT 許可證。
• npm package 當前未發佈，使用 GitHub 安裝方式。
• 投影數據是本機數據，不等同於跨機器彙總。
• Node 24 下 SQLite 處於實驗狀態（node:sqlite）。插件會在啓動時檢查 capability，並且不會全局隱藏 warning。
• 包聲明中 dsh.client.platform 爲 web，並注入以下運行時依賴：

@deepseek-ai/dsh-client-runtime
@deepseek-ai/dsh-client-ui-slots
@deepseek-ai/dsh-client-locale

dsh.bundle.patch 指向：

./cordis.patch.yml

結尾¶

這個插件把本機 DSH 會話中的 token 用量整理成 daily / weekly 熱力圖，適合需要快速判斷「今天 / 本週 token 花了多少」的開發者。

參考鏈接：

• 目錄頁：https://www.skillhub.cn/plugins/apodemakeles/dsh-token-dashboard
• GitHub：https://github.com/apodemakeles/dsh-token-dashboard