dsh-token-ledger：DeepSeek Harness 的透明代幣賬本

前言¶

DeepSeek Harness (DSH) 維護會話日誌。在重啓或長時間運行後，如何確保代幣計數的準確性和可追溯性是一個具體的技術問題。現有的解決方案可能僅提供可視化展示，但在需要防禦數字準確性的場景下，僅看圖表是不夠的。

dsh-token-ledger 插件將 DSH 的持久會話日誌摺疊爲代幣總數，並允許你從原始日誌重新計算這些數字，與運行時的記錄進行比對。

這是什麼¶

這是一個賬本，不是儀表盤。它將持久的 DSH 會話日誌摺疊成代幣總數，保持重啓安全，並允許你從原始日誌重新計算相同的數字並與主機記錄的結果進行 diff。

核心功能¶

重啓安全賬本：將日誌持久化到代幣總數，重啓後狀態保持。
審計命令：CLI (dsh-token-ledger audit) 讀取原始日誌並 diff 結果，驗證數據一致性。
賬單生成：在設置頁面生成賬單，支持導出爲 CSV 或 JSON。
設置頁面：包含概覽、費率和賬單三個標籤頁。
輕量級：無運行時依賴，零安裝腳本，僅使用 node: 導入。

安裝與啓用¶

使用官方安裝命令添加插件：

dsh plugin --profile web add @chenmiao8563/dsh-token-ledger

重啓 DSH 後，檢查配置是否生效：

dsh --profile web --dump-config | grep token-ledger

典型用法¶

插件提供命令行接口和 DSH 內部指令：

# 在 DSH 會話中查詢
/tokens
/tokens export     # 導出 CSV + JSON 到 <DSH_HOME>/token-ledger/exports/
/tokens json       # 查看原始快照
/tokens path       # 查看賬本文件路徑

# 命令行審計
dsh-token-ledger audit

賬本文件默認位於 <DSH_HOME>/token-ledger/ledger.json。

適用場景與注意¶

該插件適用於需要驗證代幣計數、審計日誌以及生成可導出賬單的場景。

注意點：
* 零依賴：沒有運行時依賴，所有 peer 依賴都是可選的。
* 無模型接口：不註冊提示部分、消息或工具，不會干擾請求或緩存。
* 軟失敗：鉤子被保護，賬本故障僅記錄警告，不會中斷會話。
* 許可證：MIT。

結尾¶

當你需要驗證代幣統計的準確性時，這個插件比單純的圖表更有用。它通過重新計算原始日誌來驗證結果，確保賬本數據真實可靠。

插件目錄：https://www.skillhub.cn/plugins/chenmiao8563/dsh-token-ledger
源碼地址：https://github.com/chenmiao8563/dsh-token-ledger