OpenRouter 花费 RyabykinIlya/dsh-openrouter-spend

dsh-openrouter-spend

在 DeepSeek Harness 里查看 OpenRouter 的真实花费 ——数据来自 OpenRouter 自己的分析接口，是实际扣费金额，不是拿本地价目表估算的 token 数。

- 输入框下方有个实时花费小标签：显示今天的开销，点开弹出浮层可看最近 7 天和 30 天。
- 设置页里有每日柱状图、按模型拆分的表格、按 API key 汇总的总额，以及预付余额还剩多少。
- 每个刷新窗口只轮询一次并缓存：开多个标签页，对 OpenRouter 也只发一个请求。

环境要求

- DeepSeek Harness 带 Web GUI（无头配置档里插件不生效：它需要 credentials、webServer、connection 这三个服务）。
- OpenRouter 的管理 API key —— 在 OpenRouter 控制台里走 Settings → API keys → Management。普通的推理 key 读不了分析数据。

安装

从 npm 安装：

dsh plugin --profile demo add dsh-openrouter-spend

从 GitHub 安装（不需要构建步骤，所以也不用申请构建脚本权限）：

dsh plugin --profile demo add github:RyabykinIlya/dsh-openrouter-spend#v0.1.0

然后打开 GUI 里的 Settings → OpenRouter spend，把管理 key 存进去。搞定 —— 小标签开始有数据了。

配置

每个字段都能在配置档的 cordis.patch.yml 行里覆盖；schema 会在激活时校验这一行，并指出是哪个字段有问题。

| 字段 | 默认值 | 取值范围 | 含义 |
| credentialRef | OPENROUTER_MGMT_API_KEY | 非空字符串 | 存放管理 key 的凭据引用 |
| apiBase | https://openrouter.ai/api/v1 | https:// URL | OpenRouter REST API 根地址 |
| refreshSeconds | 60 | 10–3600，整数 | 两次 OpenRouter 刷新之间的秒数 |
| historyDays | 30 | 2–366，整数 | 汇总窗口覆盖多少天历史，含今天 |
| timeoutMs | 15000 | 1000–120000，整数 | 每次请求 OpenRouter 的超时时间 |

查看偏好（按 key 过滤、覆盖刷新间隔）只存在浏览器本地，不会离开你的机器。

工作原理

宿主端会查询 POST /api/v1/analytics/query（total_usage 和 request_count，按 API key 和模型拆分，以 UTC 天为单位）和 GET /api/v1/credits，把汇总结果缓存 refreshSeconds，再提供给浏览器端。刷新失败时，屏幕上保留上一次的正常数据，并显示失败原因，而不是显示空面板。

安全

- 管理密钥通过 Harness 凭据服务（credentials.set）存储，不放在本包的文件里，也绝不会回传给浏览器。
- 汇总路由和凭据路由都受连接信任检查保护。任何能通过该检查的人——默认是你本地 Harness 端口上的浏览器会话——都能读取你的消费数据。不要把 Harness 的 Web 端口公开暴露，除非它自带身份验证。

许可证

MIT。非官方插件；与 OpenRouter 或 DeepSeek 无关联。

По-русски

Плагин для DeepSeek Harness: под полем ввода показывает реальные расходы аккаунта OpenRouter за сегодня (данные из официальной аналитики OpenRouter), а в настройках — график по дням, разбивку по моделям и API-ключам и остаток предоплаченных кредитов. Установка: dsh plugin --profile demo add dsh-openrouter-spend, затем Settings → OpenRouter spend → ввести управляющий ключ (Management API key из кабинета OpenRouter).