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