dsh-token-panel

DSH Web GUI 右侧 Token 面板（双面插件，host + client）。

自 v0.2 起内置 Token Harbor 额度查询引擎，额度数据在 DSH 宿主进程内直接查询， 不再需要额外启动 127.0.0.1:4173 的独立 Token Harbor 服务。

• 上栏 · 额度剩余（GET /token-panel/quota）：内置引擎直查，只展示查询成功的 provider：
  • Kimi Coding（api.kimi.com/coding/v1/usages，支持多账号）
  • DeepSeek 官方余额
  • Codex Plus（读取 macOS Keychain Codex Auth 或 ~/.codex/auth.json 的 ChatGPT OAuth 登录态）
• 下栏 · Token 已使用（GET /token-panel/usage?range=today|7d|30d|all）：合并多路数据，按模型分类、按时间截取、无价格：
  • cc-switch ~/.cc-switch/cc-switch.db 中 data_source='proxy' 的真实代理流量；
  • Codex / Kimi Code / Pi 本地日志增量同步（lib/usage_tool.py，参考 cc-switch 的 codex_session 构建法）；
  • Hermes Agent ~/.hermes/state.db 的 session_model_usage 累计行差分同步（只读打开，WAL 下与运行中的 hermes 共存）；
  • DSH 自身用量实时记录（llm/stream 模型归属 + session/event 落盘）。

安装

dsh plugin --profile web add github:zhubaodian/dsh-token-panel

前置条件：本机有 python3（用量同步助手）、sqlite3（读取 cc-switch 库）和 zstd （解压 DSH 历史会话回填；macOS 需 brew install zstd，Linux 一般自带或用包管理器安装）。 运行环境需 Node.js ≥ 18（用到全局 fetch / structuredClone）。

安装后重启 DSH。面板注册在 shell.overlay，可收起为右侧边缘小标签。

配置（额度查询）

配置文件在 ~/.dsh/token-panel/config.json（用户数据目录，插件重装/升级不会丢失）， 首次启动自动播种默认配置。字段模板见 data/config.example.json。

• 填入各 provider 的 apiKey 并把 enabled 设为 true 即可；
• Kimi Coding 支持多账号（kimiCodings 数组）；
• Codex Plus 不需要 API Key，直接读本机 OAuth 登录态；
• 密钥也可以用环境变量提供（KIMI_CODING_API_KEY / DEEPSEEK_API_KEY）。

也可以通过接口管理配置（密钥回显为掩码，回传掩码不会覆盖真实值）：

curl http://127.0.0.1:3080/token-panel/config            # 读取（掩码）
curl -X POST http://127.0.0.1:3080/token-panel/config \
  -H 'content-type: application/json' -d '{"providers":{"deepseek":{"apiKey":"sk-...","enabled":true}}}'

数据文件

路径	内容
~/.dsh/token-panel/config.json	额度查询配置（含 API Key，勿提交）
~/.dsh/token-usage/records.jsonl	DSH 实时记录（每次模型调用一行）
~/.dsh/token-usage/codex-records.jsonl	Codex rollout 增量同步（token_count 差分）
~/.dsh/token-usage/kimi-records.jsonl	Kimi Code wire.jsonl 增量同步（usage.record）
~/.dsh/token-usage/pi-records.jsonl	Pi 会话转录增量同步（assistant usage 事件）
~/.dsh/token-usage/hermes-records.jsonl	Hermes session_model_usage 累计行差分同步
~/.dsh/token-usage/usage_tool.py	同步/聚合助手（随包携带，启动时自动更新）

命令行也可直接查账：python3 ~/.dsh/token-usage/usage_tool.py query 30d。

HTTP 接口（DSH web 端口，仅 loopback）

路由	说明
GET /token-panel/quota	面板额度数据（只含查询成功的 provider），白名单 CORS
GET /token-panel/usage?range=today|7d|30d|all	合并 token 用量，白名单 CORS
GET /token-panel/refresh	Tab Harbor 浏览器插件兼容端点（与旧 4173 /api/refresh 同形，返回全部 provider，不含 localUsage），白名单 CORS
GET /token-panel/config	读取配置（密钥掩码）
POST /token-panel/config	更新配置（要求 content-type: application/json，请求体上限 1 MB）

CORS 白名单：仅本机 loopback 页面和浏览器扩展（chrome-extension:// 等）的 Origin 会被允许跨源读取； 其他网站不会收到 CORS 头，浏览器层面读不到数据。额外的精确 Origin 可用环境变量 TOKEN_PANEL_ALLOWED_ORIGINS（逗号分隔）追加。

Tab Harbor 浏览器插件迁移

旧架构中 Tab Harbor 通过 http://127.0.0.1:4173/api/refresh 取额度。合并后只需把 token-quota.js 中的地址改为 DSH web 端口（默认 http://127.0.0.1:3080/token-panel/refresh）， 即可继续展示额度卡片；独立的 4173 服务可以退役。