前言¶
DeepSeek Harness 的插件生态允许开发者扩展 Web UI 的功能。对于同时使用 Claude Code 的用户，在 DSH 的 Web 界面中实时监控 Anthropic 的配额限制是一个常见需求。现有的 DSH UI 没有内置此功能，dsh-claude-usage 插件通过在设置行右侧添加一个使用环，解决了这一问题。
简介¶
该插件由 leonardoxr 维护，是一个为 DeepSeek Harness Web UI 提供的 Anthropic Claude 计划使用指标指示器。它保持了标准设置齿轮和标签的外观，并在右侧添加了一个上下文仪表盘风格的使用环。该环包含 Anthropic 标志，并在鼠标悬停或键盘聚焦时打开详细的配额面板。
核心功能¶
- 原生外观：使用与对话上下文仪表盘相同的 28px 几何形状和 DSH 设计令牌，确保视觉一致性。
- 完整配额详情：显示 Claude 计划限制的完整信息，包括 5 小时会话窗口、每周窗口、模型范围的每周限制、额外使用状态、计划层级和速率限制层级。
- 轮询与缓存策略：默认每 5 分钟轮询一次，可通过 bundle 行配置。支持 250ms 防抖的悬停刷新，一次只发送一个请求。插件尊重 Anthropic 的
Retry-After冷却机制，并在临时失败时回退到“最后良好”数据。 - 安全与隐私：插件通过 Loopback API 路由读取 OAuth 访问令牌，并进行严格规范化。它仅执行只读访问，从不存储、传输、记录或刷新令牌。
安装与启用¶
安装前请确保环境满足以下要求：
- Node.js 20 或更新版本
- pnpm 10
- DeepSeek Harness 0.1.1-rc.2 或兼容版本
- Claude Code CLI 已登录（claude login）
在插件目录下执行以下命令以添加到 Web 配置文件：
dsh plugin --profile web add .
安装后，在 DSH 的 Web UI 中导航至 Settings → Plugins → Claude usage 即可看到该插件已生效。
配置说明¶
在 Settings → Plugins → Claude usage 中，可以配置以下四个参数。这些更改在点击保存前仅本地生效，保存后通过 DSH 设置持久化，并即时应用到当前 Web 窗口。
| 配置项 | 默认值 | 说明 |
|---|---|---|
| refreshIntervalMs | 300000 | 后台轮询间隔，最小 60 秒。 |
| hoverRefreshMinAgeMs | 30000 | 悬停刷新的最小间隔，最小 5 秒。 |
| requestTimeoutMs | 15000 | 每个 Anthropic 使用请求的超时时间。 |
| credentialsFile | (空) | 可选的 Claude Code 凭据文件绝对路径，留空则使用系统默认位置。 |
工作原理¶
- Host 插件：注入 DSH 的 webServer 服务，并注册
GET /api/plugins/claude-usage路由。 - 凭证读取：每次请求时，Host 进程以只读方式查找 Claude Code 的 OAuth 访问令牌。
- 数据获取：调用 Anthropic 的 OAuth 使用端点（与 Claude Code 的
/usage命令后端相同），使用oauth-2025-04-20beta 头。 - 数据规范化：严格规范器仅返回配额相关数据（百分比、ISO 重置时间、额外使用标志）。
- 客户端渲染：浏览器注册独立动作，在设置行右侧预留空间，不干扰内置设置按钮。
适用场景与注意¶
- 操作系统：目前仅支持 Windows 或 Linux。macOS 的凭据存储在 Keychain 中，暂不支持。
- 权限要求：插件以当前 DSH 进程权限运行，读取
~/.claude/.credentials.json。请确保对源码和许可证保持关注。 - 只读安全：该插件仅用于查看配额，不会触发令牌刷新或破坏现有的登录状态。
总结¶
dsh-claude-usage 为 DeepSeek Harness 用户提供了原生的 Claude 配额监控能力。它通过精心的缓存策略和严格的 Loopback 机制，在不影响系统安全的前提下提供了实用的配额信息。更多细节请参考 GitHub 仓库 或 SkillHub 目录。
