前言¶

在 DeepSeek Harness（DSH）里写对话时，推理档位往往藏在模型或会话配置里，换模型还要重新找；不同 API 供应商的用量又各自在控制台或文档里查，和当前选中的 provider 对不上号。社区插件 dsh-usage-quota（维护者 s17765152890-gif）把 Codex 风格的思考强度（推理等级） 和 跟随当前供应商的额度查询 放到输入框与底栏附近，无需改 DSH 自带插件，两个控件都以新增条目注册进 Web UI 的既有插槽。分类为「模型推理」，仓库 s17765152890-gif/dsh-usage-quota，目录页见 SkillHub。

这是什么¶

一句话：DSH 插件，在 Composer 区域提供推理等级胶囊与 provider 感知的用量/额度展示。依赖 DSH 客户端的 modelDirectories 与插槽 conversation.composer.dock、conversation.input.right；宿主侧依赖 webServer、connection、credentials。要求 DSH 0.2.0-rc.2 或更高（Web / 桌面端），Node 20.3+（宿主仅用 Node 内置模块与 Web 标准 API）。当前 package 版本 1.0.1，许可证 MIT。

思考强度（Codex 风格）¶

模型选择器右侧新增一个小胶囊，直接显示当前推理等级。点开后是一张紧凑卡片：

1. 大字显示当前档位：Low / Medium / High / Extra High / Ultra。
2. 分档滑条与档位标签，松手即应用。
3. 右上角 ↺ 恢复模型默认强度。
4. 支持「关闭思考」的模型会多一个「关闭思考」按钮；不支持关闭的模型（例如要求自适应思考的 Claude 系列）按钮置灰并注明原因，而不是假装可用。

档位来自 DSH 模型目录中的 reasoningEfforts，跟随每个模型的能力，不做猜测。

额度查询（自动跟随当前供应商）¶

底栏显示当前模型供应商的额度；切换供应商会自动换卡片；没有额度接口的供应商直接不显示。

OpenCode Go（内置）：展示 5 小时 / 每周 / 每月三个窗口的剩余百分比；点开可见进度条，用量接近上限时数字变橙色，并显示「几小时后重置 / 几天后重置」。默认零配置即可使用：宿主从凭据服务读取 OPENCODE_GO_API_KEY（或同名环境变量）。

通用余额（需配置）：对任意返回 balance、remaining 或 quota.remaining 的兼容 HTTPS（或本机回环）接口，显示余额与当日消费。

密钥只由 DSH 宿主进程读取，绝不进入页面脚本；接口调用都发生在宿主侧。浏览器侧通过同源、经 DSH 连接鉴权的 GET /x-usage?provider=<id> 获取额度数字；未登录请求会被拒绝。插件不含遥测、上报或第三方统计。

安装与启用¶

要求 DSH 0.2.0-rc.2 或更高。

方式 A：作为 bundle 安装（推荐）¶

下面命令来自仓库 README，将 <本仓库的绝对路径或已发布的包名> 换成实际路径或包名：

plugin_manager action=install_bundle target=<本仓库的绝对路径或已发布的包名>

安装后会在当前 profile 里插入一行 usage-quota。这是标准 DSH bundle：package.json 声明 dsh.bundle.patch 与 dsh.client，并导出 locale/*.json（meta.title / meta.description）与 icon.svg，在「插件」页显示为 用量与思考强度 及对应图标，而不是裸路径行。

方式 B：手动加入 profile 的 cordis.patch.yml¶

- insert:
    - id: usage-quota
      name: file:///<本仓库绝对路径>/lib/index.js

路径中的空格与中文需按 URL 编码规则处理。改完无需重启，DSH 会热加载配置。

配置¶

除 OpenCode Go 默认可用外，可在插件自己的 cordis.patch.yml 对应行上追加 config：

- insert:
    - id: usage-quota
      name: dsh-usage-quota
      config:
        refreshSeconds: 60
        providers:
          my-relay:
            kind: balance
            label: My Relay
            endpoint: https://relay.example.com/v1/usage
            apiKeyRef: MY_RELAY_API_KEY

加载时会校验配置：未知 kind、缺少 endpoint、非 HTTPS 的远程地址、非法凭据引用名会直接报错，而不是运行期静默失败。刷新间隔偏好写在 $DSH_HOME/dsh-usage-quota.json，不写进安装包目录。

典型用法¶

1. 安装 bundle 或手动插入 profile 后，在 Web UI 打开对话 Composer。
2. 在模型选择器右侧点击推理等级胶囊，用滑条切换 Low～Ultra 或恢复默认；若模型支持，使用「关闭思考」。
3. 选用带额度能力的 provider（如 OpenCode Go 或已配置的 balance 接口）：底栏自动显示对应卡片，点击可查看进度与重置时间。
4. 需要自定义中转用量时，在 config.providers 里按 provider id 配置 kind: balance 与 endpoint、apiKeyRef。

适用场景与注意¶

适合经常在 DSH 里切换模型与供应商、希望在输入区附近统一控推理强度并一眼看剩余额度的开发者。插件以当前 DSH 进程权限运行，安装前应阅读 GitHub 源码 与 MIT 许可证，自行确认凭据引用与远程 endpoint 是否符合你的安全策略。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-usage-quota 把推理档位和 provider 额度收进 Composer dock，不改核心插件、默认即可对接 OpenCode Go，扩展余额接口也可配置。进一步了解与安装见 目录页 与 GitHub 仓库。