前言¶
在 DSH（DeepSeek Harness）中運行智能體時，成本通常分散在多個 session、模型調用、工具調用和緩存結果裏。只看總 token 很難判斷哪次會話、哪個模型、哪個工具最貴，也很難處理價格表變更。
dsh-analytics 是一個本地分析插件：它從 session events 收集 usage，寫入本地 SQLite ledger，再用 time-aware pricing table 計算成本，並通過 service、agent tool 和 JSON API 提供查詢。
這是什麼¶
dsh-analytics 的倉庫所有者是 hccccc01333，GitHub 地址爲：
https://github.com/hccccc01333/dsh-analytics
它的一句話定位是：Agent FinOps / token analytics for DeepSeek Harness。v1 scope 包括 Overview、Session drill-down、Cost Engine 和 Cache analytics。它面向已經發生的運行記錄做本地分析，並提供工具成本歸屬和預算查看。
核心功能¶
本地用量臺賬¶
插件會把 session 事件中的 usage 收集到本地 SQLite ledger。
數據存儲在本機，文檔說明數據不出本機，並且插件不會調用 provider API。
時間感知成本引擎¶
價格表被當作數據，而不是硬編碼在邏輯中。
dbPath 是必需配置。內置默認價格只是 seed data；當價格表爲空時纔會 seed，避免重啓覆蓋已有價格。
如需自定義價格，可使用 pricing 或 pricingFile；二者互斥。
查詢入口¶
ctx.analytics 提供以下 service 方法：
overviewsessionsessionsmodelstoolspricingbudget
Service 讀取爲分離快照，不觸碰 session store 或 agent loop。
插件還提供 analytics_query agent tool，可用 range_hours 限制窗口。
在 ctx.webServer 存在時，還會註冊只讀 JSON 路由：
/api/analytics/overview
/api/analytics/sessions
/api/analytics/models
/api/analytics/tools
/api/analytics/pricing
/api/analytics/budget
/api/analytics/session/<sessionId>
部分路由支持 ?hours= 查詢參數。
瀏覽器儀表盤¶
插件提供 self-contained dashboard，路徑爲：
/analytics
頁面包括 Overview、Sessions、Reasoning、Agents、Insights、Context Inflation、Token Flow / Models / Cost / Pricing。
範圍選擇器支持 6h / 24h / 7d / 30d / all，並提供 EN / 中文 toggle。
預算與工具歸屬¶
預算支持 daily、monthly 和 currency 配置，並給出 month-end spend projection。
工具成本採用 step-level attribution：一次模型調用的成本會分攤到該 step 中調用的工具，避免重複計算。
安裝與啓用¶
在 web profile 下安裝：
dsh plugin --profile web add dsh-analytics
如果已經拿到本地 checkout，也可以使用本地路徑：
dsh plugin --profile web add /path/to/dsh-analytics
本地開發時，可以掛載 source overlay：
dsh --profile web --patch ./cordis.yml
典型用法¶
配置¶
至少需要提供 dbPath，指向 SQLite 數據庫文件。
若要自定義價格表，選擇 pricing 或 pricingFile 其一，二者互斥。
Service 查詢¶
下面示例展示基本讀取方式：
await ctx.analytics.overview({ start, end })
await ctx.analytics.session(sessionId)
await ctx.analytics.budget()
按範圍查詢：
await ctx.analytics.sessions({ start, end })
await ctx.analytics.models({ start, end })
await ctx.analytics.tools({ start, end })
await ctx.analytics.pricing()
Agent tool 查詢¶
可以這樣調用：
analytics_query(query="overview", range_hours=24)
range_hours 限制以當前時間爲結尾的窗口；0 表示 all time，默認是 24。
JSON API¶
當 web server 可用時，可直接讀取上述 /api/analytics/* 路由。例如查看 overview 或某個 session：
/api/analytics/overview
/api/analytics/session/<sessionId>
儀表盤¶
打開：
/analytics
然後使用 6h / 24h / 7d / 30d / all 範圍選擇器查看不同頁面。
適用場景與注意¶
適合以下使用：
- 在 DSH 中運行多個 session 或 agent，需要查看成本、緩存、模型和工具佔比。
- 需要在代碼中讀取 overview、session、budget 等數據。
- 需要在瀏覽器中做 session 鑽取和成本查看。
注意：
- 插件以當前
dsh進程權限運行；安裝前應檢查源碼、依賴和許可證。 - 許可證信息未確認，安裝前請自行覈驗。
- Web JSON 路由只在
ctx.webServer存在時註冊。 - harness client 中的 shell-nav 集成被描述爲後續項，因爲當前沒有空閒的 plugin page slot。
- DSH 插件目錄是獨立社區站點，與 DeepSeek / 幻方無官方從屬關係，不應被理解爲官方應用商店。
結尾¶
dsh-analytics 將 DSH 運行中的 token、成本、緩存和工具使用整理成本地可查詢視圖。若你要在智能體開發中做 Agent FinOps，可以從它的 service、agent tool 和 /analytics 儀表盤開始。
GitHub：https://github.com/hccccc01333/dsh-analytics
目錄頁：在 DSH 插件目錄中按 dsh-analytics 查找；本文未附具體目錄 URL，因爲材料中沒有確認的目錄地址。
