前言¶
在使用 DeepSeek Harness (DSH) 進行本地模型推理時，記錄每日用量、統計成本以及保持打卡習慣是常見需求。dsh-daily-ledger 插件解決了這個問題。它是一個本地工具，不聯網，不上傳數據，安裝啓用後自動監聽 DSH 已提交的模型用量事件，進行本地記賬。
插件簡介¶
dsh-daily-ledger 是 DeepSeek Harness (DSH) 的本地每日打卡與 token/金額賬本。插件由 jijiz1 維護，採用 MIT 許可證。
核心功能¶
- 每日打卡：支持在聊天中打卡，可附 500 字以內備註。同日重複調用只會更新備註。
- Token 與成本統計：支持按 1-366 天統計，可按 provider/model 拆分查看。
- 用量狀態查看：快速查看今日打卡狀態、連續天數和今日用量。
- Web 漂浮窗：右下角顯示懸浮窗，可展開/收起和拖拽。包含“今日”、“統計”、“背景”三頁。
- Token 分類統計：支持未緩存輸入、緩存讀取、緩存寫入、輸出、推理（推理已包含在輸出中，不重複計費）的細項統計。
- 價格快照：每次模型調用保存當時的價格快照。沒有價格的模型顯示“未定價”，絕不按 0 元處理。
安裝與啓用¶
使用官方提供的安裝命令添加插件路徑：
dsh plugin --profile web add D:\DSH\dsh-daily-ledger
安裝完成後，重啓 dsh web 進程即可啓用。
典型用法¶
在聊天中發送以下指令即可使用：
- 今日打卡：在聊天中說“今日打卡”。
- 統計用量：在聊天中說“統計最近 7 天 token 和金額”。
- 模型消費：在聊天中說“按模型看本月消費”。
配置與數據¶
首次啓動後，數據默認位於以下位置：
$DSH_HOME/daily-ledger/ledger.json：打卡和用量賬本。$DSH_HOME/daily-ledger/pricing.json：價格表。
時區設置¶
默認時區爲 Asia/Shanghai。可通過環境變量 DSH_DAILY_LEDGER_TIME_ZONE 修改。
價格配置¶
默認價格來自 DeepSeek 官方中英文價格頁（單位：每百萬 token）。
其他 provider/model 可直接在 pricing.json 中添加。鍵必須寫成 provider/model 格式（例如 openrouter/deepseek/deepseek-v4-pro）。重啓後，新調用會保存新價格快照。
Web 漂浮窗¶
漂浮窗右下角顯示，支持以下操作：
- 頁面切換：包含“今日”、“統計”、“背景”三頁。
- 拖拽：展開時拖動標題欄，摺疊時拖動膠囊按鈕均可改變位置。
- 背景設置：
- 預設：深海、紫霞、森林、日落。
- 自定義：支持自定義純色、圖片網址或 2 MB 以內的本地圖片。本地圖片只轉成瀏覽器本地數據，不會上傳外網。
- 遮罩：可調整內容遮罩強度。
- 記憶：窗口位置、展開狀態和背景設置保存在瀏覽器本地；無數據變化時定時刷新不會重建窗口。
注意事項¶
- 數據統計範圍：自動統計從插件啓用後的模型調用開始，不導入歷史日誌，不會猜測或重複導入此前的壓縮會話日誌。
- 金額估算：金額爲基於 Token 和配置價格的估算，服務商賬單、稅費、匯率或時段價可能造成差異，以最終賬單爲準。
結語¶
dsh-daily-ledger 爲 DSH 用戶提供了本地化的成本追蹤與習慣管理能力。如需查看更多細節或獲取源碼，請訪問 GitHub 倉庫。
