快速判断

安装前先看这几项

配置资料: 配置资料部分完整
配置难度: 未知，待补配置
适合新手: 建议具备相关经验
兼容状态: 声明兼容，尚未实测
验证状态: 源码已审阅，未标记运行实测

配置资料部分完整

本站已整理安装目标，但尚未补齐该插件的全部专属配置。完成配置前需要核对固定来源。

仍需核对：插件专属配置项、成功验证结果、首次使用示例、数据清理方法。

中文教程

按照固定来源完成安装、配置与验证

教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。

查看 TokenLedger 安装与配置教程 →

功能

这个插件能做什么

按会话、项目、模型和中转站归因 DSH Token 用量，自动发现已配置的 Relay Base URL，并展示价格、配额、订阅和使用报告。

适合谁

希望改善 DSH 界面、终端或日常交互体验的用户。

使用门槛

该插件涉及较高配置难度或敏感权限，不建议在生产工作区直接试装。

准备

安装前准备

本站尚未核验该插件的专属前置条件。请先准备独立 Web Profile、测试工作区，并核对固定来源中的运行时、外部服务和账号要求。

安装

如何安装 TokenLedger

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到: web Profile
DSH 基线: 0.1.1-rc.2
安装来源: GitHub 源码（锁定提交）
固定目标: github:zh667/TokenLedger#63091bbf2ab0

01
检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：
环境检查
```
node --version && pnpm --version
```
02
安装到 Web Profile
这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。
GitHub 源码（锁定提交）
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:zh667/TokenLedger#63091bbf2ab0
```
03
如遇构建脚本拦截
GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建；只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yaml 中 allowBuilds，审阅脚本后再重复上一步，不要使用全局放行。
04
确认 Bundle 已进入配置
安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 dsh-tokenledger或对应 Bundle 层。
检查配置
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
```
05
启动并完成最小验证
启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Web
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 web
```

卸载与回退

测试不通过时先停止 DSH，再从同一 Profile 移除插件。移除后重新运行配置检查，确认对应 Bundle 层已经消失；插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除

npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove dsh-tokenledger

阅读 DSH 插件安装基础指南核对项目 README

配置

插件专属配置

专属配置路径和字段尚未完成核验，请不要根据同类插件猜测参数名。

验证

配置检查与成功结果

本站尚未获得插件专属的验证命令和期望结果。安装后只能确认 Bundle 是否进入组合配置，不能据此宣称插件功能已经运行通过。

使用

第一次使用建议这样验证

以下步骤是根据插件类别提供的安全验证顺序，不是作者仓库的专用命令。具体入口和参数仍以固定提交对应的 README 为准。

启用插件后检查 DSH 页面是否出现新的界面入口
用一个临时会话验证交互是否符合预期
关闭插件并确认原界面可以正常恢复

权限

它可能接触哪些数据和能力

使用服务凭据读取本地文件访问外部网络

读取 DSH Provider 的已解析设置以发现 Base URL，但明确拒绝携带 apiKey/token 字段；向已经配置或用户显式添加的 Relay 站点探测用量、配额和项目接口，并在本机保存归因账本

数据存储：尚未完成独立核验，测试前应确认插件是否写入工作区、用户目录、数据库或外部服务。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

排查

故障排查与数据清理

本站尚未整理插件专属故障模式。遇到问题时先停止 DSH、保存日志、核对固定提交对应的 README，不要反复扩大权限重试。

清理边界待核对：从 Profile 移除插件通常不会自动删除插件创建的数据、外部账号或凭据。

证据

兼容性与审阅记录

兼容性说明

插件版本 0.1.0，采用 DSH Bundle/Web Client 格式并声明可选 Host 服务；本站完成固定提交静态审阅，未连接真实中转站或核对各站点用量接口

数据流

DSH 会话与模型用量 → 本机 TokenLedger 账本 → 项目/模型/站点报表；Provider 设置中的 Base URL → Relay 发现与指纹适配器 → Relay 用量/配额端点 → 汇总结果返回本机 Web 面板。

源码审阅结论

已审阅固定提交的插件入口、Provider 发现、Relay 指纹、HTTP 客户端、用量/配额适配、项目归因、存储和 Web 路由。发现逻辑只读取地址和凭据引用，不读取密钥值，符合“零额外凭据”定位；但它会主动访问用户配置的 Relay Origin，兼容启发式可能误判，且 Relay 返回数据的真实性取决于运营方。应只配置可信站点，并把账本视为本机使用记录。

来源与维护信息

本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后，请重新核对作者说明。

精确来源: GitHub：zh667/TokenLedger（外部链接，在新标签页打开）
来源登记表: Awesome DSH Plugin（外部链接，在新标签页打开）
来源快照: 5909d7aad5a4
固定提交: 63091bbf2ab0
许可证: MIT
主要语言: JavaScript
中文资料: 有中文专题说明

TokenLedger