前言¶
DeepSeek Harness (DSH) 专注于智能体的路由管理与会话控制。在实际开发中，当通过 OpenRouter 等第三方中继提供商调用底层模型时，DSH 原生界面通常无法显示中继端的余额、配额窗口或具体的 Token 成本。dsh-quota 插件解决了这个问题，它将计费提供商与路由名称解耦，并提供一个可视化的仪表盘来追踪 Token 使用量、成本预算以及提供商状态。
核心功能¶
- 会话与成本追踪：插件跟随活动会话的路线、模型、推理强度以及官方
tokenUsage投影。它能在 DSH Host 存储中持久化去重后的每次调用使用日志，并追踪当前会话、每日及滚动 30 天的 Token 数量与预估 CNY 成本。 - 多提供商集成：支持显示提供商的余额、配额窗口、支出限制和提供商端使用量。本地核算集成支持 Moonshot、Zhipu、Alibaba Bailian、Volcengine Ark、Together AI 和 Fireworks AI 等平台，无需额外凭证即可统计使用量。
- 数据迁移与持久化：插件会自动迁移 v0.6 之前的浏览器聚合数据，避免升级后重复计数。它还支持导出 CSV，并允许在浏览器设置中编辑每个模型的 CNY-per-million-Token 价格。
- 可视化仪表盘：提供可拖动的悬浮小部件，支持图标模式、隐藏和位置重置。仪表盘包含无间隙的 7 天趋势图和 30 天细分，并支持桌面抽屉和移动端底部表单。
安装与启用¶
插件以预构建存档形式提供，无需本地 TypeScript 构建。安装命令如下：
dsh plugin --profile web add "https://github.com/Lottle7/dsh-quota/releases/download/v0.8.0/dsh-quota.tgz"
dsh web
配置与使用¶
Host 设置命名空间为 dsh-quota。主要配置项包括 enabled、refreshIntervalMs、warningBalanceBelow（余额低于此值警告）和 usageRetentionDays（数据保留天数，范围 30-3650）。
本地核算与自定义提供程序¶
对于本地核算，无需提供额外凭证，插件根据配置的价格表报告 DSH 投供的 Token 投影。对于自定义提供程序，可以使用 kind: local（无远程请求）或 kind: http-json（映射公共 HTTPS JSON 结算端点）。
路线映射¶
当自定义路线名称无法被自动识别时，可以通过配置 routeMappings 来明确指定路由与计费提供商的对应关系。
注意事项¶
- 本地核算集成不会捏造余额，仅报告 Token 投影和用户配置的价格。
- 安装预构建存档后，无需执行本地构建步骤。
- 插件提供无凭据的诊断报告，用于检查路由解析和缓存状态。
总结¶
dsh-quota 为 DSH 用户提供了从路由层到计费层的完整视图。通过持久化日志、预算管理、趋势分析以及 CSV 导出功能，它帮助开发者更清晰地掌握多提供商环境下的资源消耗与成本。
