前言¶
在 DeepSeek Harness（DSH）裏跑智能體，會話一多，token 會分散在多次調用、子代理會話和不同工作區裏。平臺會持久化會話數據，但默認界面並不提供「累計用了多少、緩存命中如何、峯谷時段花了多少錢、哪個項目最費 token」這類彙總視圖。若只靠翻日誌或手工估算，很難在調模型、清上下文、換工作區時做有依據的決策。
下面介紹社區客戶端插件 dsh-token-panorama（維護者 jiuwu02）：從 DSH 自帶的會話持久化服務讀取全部會話日誌，在側邊欄打開一塊 Token Panorama 面板，把用量、緩存、成本估算和導出放在同一套時間篩選下；另在輸入區與 Composer 底部提供上下文清理/壓縮與提示詞優化工具。數據不爬外部日誌，也不依賴第三方服務。
這是什麼¶
dsh-token-panorama 是註冊在 DSH Web 客戶端側欄與主面板的 bundle（分類：客戶端）。它解決的核心問題是：把各會話的 token 用量匯成可篩選、可導出、可估價的「全景」，並附帶與上下文、提示詞相關的快捷操作。
- 目錄頁：https://www.skillhub.cn/plugins/jiuwu02/dsh-token-panorama（社區插件目錄，與 DeepSeek / 幻方無官方從屬關係）
- 源碼與說明：https://github.com/jiuwu02/dsh-token-panorama
- 許可證：MIT（見倉庫
package.json） - 環境要求：DSH
>= 0.2.1-rc.3；需使用帶 Web UI 的 profile，bundle 注入sidebar.panellist與main
核心功能¶
用量與緩存¶
- 累計總量：累計 token，並拆分 input / output / cache-read / cache-write 與調用次數。
- 緩存命中率：以 input 側 token 爲分母，展示 cache read 佔比及命中、未命中的絕對數量。
成本與時段¶
- 成本估算：按 DeepSeek 峯谷時段分別計價，各時段金額分開顯示。
- 共享時間範圍：篩選欄統一控制所有卡片（All / Today / Last 24 hours / This week / Last 7 days / This month / Last 30 days，以及 From / To 日期）。熱力圖、趨勢、成本、模型、會話、工作區等卡片在同一區間內重算。
- 分時軸：範圍收窄到 Today 或 Last 24 hours 時，趨勢卡切換到按小時粒度，並補齊空閒時段，避免折線跨過無數據的區間。
可視化與分佈¶
- 日曆熱力圖：GitHub 式周列或按月迷你日曆，通過
Week/Month切換。 - 趨勢曲線：Hour / Day / Week / Month / Year（
Hour僅在不足一天的範圍出現）；懸停可讀該點精確數值。 - 按模型彙總：各模型 token 與調用次數，按用量排序。
- 按工作區彙總：按會話頭記錄的工作目錄分組，便於看哪個項目成本最高。
- 會話用量樹：默認只列主會話；行首
▶展開所屬 subagent 會話，避免卡片隨子代理數量膨脹。可按 Session / Tokens / Calls / Created 排序；可隱藏已歸檔會話（選擇會記住）；表格 figures 跟隨當前日期範圍。 - 分頁：每頁 40 個會話組，大歷史不會一次渲染全部行。
導出與刷新¶
- Export：按日桶導出 CSV（UTF-8 BOM + CRLF）或 JSON；另有按會話 CSV，含工作區、父會話、成本等列。
- 增量刷新：按會話 revision token 決定重讀範圍，Refresh 時只解碼有變化的會話；面板打開時會自動刷新，大歷史首次之後約秒級完成後續刷新。
- 節假日：任意年份運行時拉取並緩存，新年無需重新發版。
上下文與提示詞工具¶
- Context actions：Composer 底部 Dock 提供 Clear（橙）與 Compact（綠），以及
/clear-context、/compact-context、/compact。Compact 可在對話中途執行：在摘要前固定切點，摘要期間新內容保留在摘要之後 verbatim；檢查點複用平臺「context compacted」標記及 item/token 計數。Clear 會替換整個表面，需空閒會話。 - Prompt optimization：輸入框工具欄 Optimize 將草稿發給可配置的優化模型，改寫結果寫回 Composer，附件不變；請求可攜帶會話上下文摘錄。指令、路由與是否帶上下文在設置窗 Prompt optimization 頁配置。
計費配置¶
計費參數均爲插件 config。面板頭 General settings 打開設置窗，保存後立即重算價格，無需重啓 DSH。設置窗按結構編輯（非純鍵值）：六個標籤頁分別爲 Models & prices、Peak schedules、Holidays、Context、Prompt optimization、General（時區與貨幣）。支持將計費配置導出/導入 JSON（導入僅填表，須點 Save 才生效）。模型價目表默認按日誌中實際出現的模型、按用量排序；未定價模型回退 defaultPrice，成本卡會明示而非靜默按零計費。四列分別對應 miss input、cache-hit input、cache write、output。
界面文案隨平臺 locale 中英文切換。
安裝與啓用¶
從包含 package.json 的插件包目錄本地安裝（Plugins 頁或插件管理器均可）：
plugin_manager install_bundle target="<absolute path to this directory>"
安裝後側邊欄出現 Token Panorama，點擊進入主面板。卸載時在 Plugins 頁移除 dsh-token-panorama bundle。
注意：插件以當前 DSH 進程權限運行，安裝前應自行審閱源碼與 MIT 許可證，確認符合你的安全與合規要求。
典型用法¶
- 在側邊欄選擇 Token Panorama。
- 在篩選欄選時間範圍，或填寫
From/To。 - 熱力圖在
Week/Month間切換；趨勢在 Hour / Day / Week / Month / Year 間切換（子日範圍纔出現 Hour）。 - 懸停趨勢點查看精確數值。
- 在 Session usage 樹中展開子會話、排序列、取消 Show archived 僅看在用會話；用 Export sessions CSV 導出當前表格。
- 大列表用 Previous / Next 翻頁（每頁 40 組）。
- Refresh 重掃；Export 導出日桶 CSV / JSON。
- General settings 調整時區、貨幣、峯谷窗口、節假日與價目表，保存後立即重價。
適用場景與注意¶
適合長期在 DSH Web UI 裏開發智能體、需要按項目/模型/時段復盤 token 與估算成本、並希望在同一界面做上下文壓縮或提示詞優化的開發者。
不適合期望「不讀本地會話持久化、純外部監控」的場景：本插件明確依賴平臺會話持久化服務，且爲客戶端 bundle，需滿足上述 DSH 版本與 Web profile 條件。社區目錄頁的星標與倉庫當前爲公開開源狀態；具體版本以倉庫 package.json（當前資料爲 1.0.0）爲準。
結尾¶
dsh-token-panorama 把 DSH 已有會話數據整理成可篩選的全景面板與導出，並把清上下文、壓縮與提示詞優化嵌進日常輸入流程，便於在「一切皆插件」的 DSH 生態裏做用量與成本上的可觀測性。
