dsh-token-ledger

Token 账本 —— 自动读取 DSH 现有供应商（provider）配置，监测多个 LLM 网关的 token 余额与用量，以简洁悬浮面板展示。

特性

• 零配置读取供应商：直接读取 DSH 设置里的 llm-pi-ai.providers，无需重复填写 baseURL / key。
• 多网关适配：自动按网关类型探测余额接口：
  • New API / One API（/api/user/self，quota → USD）
  • OpenAI 兼容（/dashboard/billing/subscription）
  • DeepSeek 官方（/user/balance，CNY）
  • 需账号登录的网关（HC / SupXH / Vyce，从 ~/.dsh/token-ledger.json 读取凭据）
• 网络容错：直连失败的网关（如被墙的 vyceai.com）自动走本地代理（127.0.0.1:7890）CONNECT 隧道重试。
• 登录缓存：60 秒轮询复用登录 session / token，避免频繁登录触发网关限流（429）。
• 容错展示：密钥缺失、凭证失效、网络不可达都会以状态点 + 原因清晰呈现，不影响其它供应商。
• 余额历史趋势：每张卡片内联余额 sparkline；点击展开完整大图（时间轴 + min/max 标尺 + 网格）与数值列表（时间/余额/单位），单位按网关正确显示（USD / CNY / 当日额度）。
• 界面简洁：右下角悬浮球 + 可折叠卡片面板，60 秒自动刷新。

安全：API 密钥与登录凭据仅在 Host（Node）进程内取用，不暴露给浏览器端；代码中不含任何明文密钥。

账号凭据配置（可选）

需账号登录的网关（HC / SupXH / Vyce）需要配置账号密码才能查询余额。
创建 ~/.dsh/token-ledger.json（独立于 settings.yaml，避免 cordis settings 未注册 namespace 的问题）：

{
  "hcnsec": { "username": "你的用户名", "password": "你的密码" },
  "vyce":   { "email": "你的邮箱", "password": "你的密码" },
  "supxh":  { "username": "你的用户名", "password": "你的密码" }
}

支持字段：username / email（三选一填写即可）+ password。凭据仅本地读取，不暴露给浏览器端。

支持网关

安装

# 从 GitHub 安装
dsh plugin --profile desktop add github:lelens0/dsh-token-ledger

安装后完全退出并重新打开 DSH Desktop 生效。

数据与安全

• API 密钥仅在 Host（Node 进程）内部通过 credentials.resolve() 取用，用于调用余额接口，不暴露给浏览器端。
• 余额快照与历史写入 ~/.dsh/.dsh-token-ledger.json。
• 登录 session 缓存在内存中，重启 DSH 后清除。

License

MIT License - Copyright (c) 2026 lelens0