跳到正文
  • 首页
  • 插件说明
  • dsh-opencode-go-quota

GLFzr/dsh-opencode-go-quota

40最近提交 2026年8月15日

dsh-opencode-go-quota DSH 插件

该插件在聊天输入框模型选择器左侧显示一个 22px 的进度圆环，展示 OpenCode Go 额度使用情况（5小时/每周/每月）。根据用量颜色变化（绿/蓝/橙/红），≥80% 时闪烁，并会在 agent 请求时动态注入额度状态到 System Prompt，提醒用户注意限额。

ui-productivitydeveloper-tools

如何安装 dsh-opencode-go-quota DSH 插件

dsh plugin --profile web add github:GLFzr/dsh-opencode-go-quota

复制不会执行命令。安装 dsh-opencode-go-quota DSH 插件前请核对仓库和版本。

dsh-opencode-go-quota DSH 插件数据来源

dsh-opencode-go-quota DSH 插件快照日期：2026年8月16日

discovered

dsh-opencode-go-quota DSH 插件能做什么

  • 显示 22px 颜色编码的额度圆环（绿/蓝/橙/红），悬停显示百分比和重置倒计时。
  • 点击圆环可在 5小时、每周、每月三个窗口间切换。
  • 每 5 分钟自动刷新，切换窗口时若数据超过 1 分钟则强制刷新。
  • 动态按档位注入额度状态到 System Prompt，同一档位只注入一次，避免 Prompt 膨胀。
  • 可通过 cordis.yml 配置阈值（warnAt、criticalAt、escalateFrom、escalateStep、cacheTtl 等）。
  • 额度不可用时（无 key 或接口失败）显示灰色感叹号，悬停显示错误原因，宿主与浏览器控制台均有日志。

dsh-opencode-go-quota DSH 插件适合哪些场景

  • 在 DSH 聊天界面直接查看 OpenCode Go 额度用量，无需切换页面。
  • 当额度即将用尽时主动收到警告，帮助控制成本并避免中断。
  • 根据额度水平自动调整 agent 行为（例如接近限制时建议暂停）。
  • 与 dsh-token-ledger 配合使用，区分额度和实际 Token 用量进行详细分析。
  • 跟踪 5小时、每周、每月额度重置时间，合理规划使用。

dsh-opencode-go-quota DSH 插件适合谁

  • 依赖 OpenCode Go API 的 DSH Web 用户，需要监控额度使用情况。
  • 希望在编码环境中获得实时额度可见性和自动化成本管理的开发者与高级用户。

dsh-opencode-go-quota DSH 插件的限制

  • 需要 OpenCode Go 账号和 API Key（可通过 auth.json 或环境变量提供）。
  • 在 Windows 上，如果工作区根目录位于系统 TEMP 目录，DSH 沙箱策略可能阻止子进程执行，需要固定 workspaceRoot。
  • 额度数据依赖 OpenCode 官方接口的可用性，接口失败时显示灰色指示符且不注入 Prompt。
  • 该插件专为 DSH Web 设计，不适用于其他环境。

dsh-opencode-go-quota DSH 插件的仓库 README 摘录

以下文字摘自 dsh-opencode-go-quota DSH 插件的上游仓库 GLFzr/dsh-opencode-go-quota 的 README，版权归原作者，仅作引用。

OpenCode Go 额度圆环 —— DSH Web 的持久化插件。 在聊天输入框**模型选择器左侧**显示一个 22px 进度圆环： - 中央字母 **5 / W / M**，点击循环切换 5小时 / 每周 / 每月 用量窗口 - 悬停显示「5小时 已用 X% · 重置倒计时」 - 颜色按紧急程度：绿 &lt;30% / 蓝 30-60% / 橙 60-80% / 红 ≥80% - 每 5 分钟自动刷新，点击切换时若数据超过 1 分钟则强制刷新 - **额度告急（≥80%）时圆环红色脉冲闪烁**，悬停提示「⚠ 5小时额度即将用尽，建议暂停等重置」 ## 配合 dsh-token-ledger 使用 额度（钱）与 token 用量是两回事：本插件回答「还剩多少额度」， [dsh-token-ledger](https://github.com/GLFzr/dsh-token-ledger) 则逐请求记录 真实的**输入 / 输出 / 缓存命中 token 数**（会话顶部「用量」页，堆叠柱状图， 支持按请求/按小时/按天/按轮次查看）。两个插件可同时安装、互不依赖： 额度圆环在输入框左侧，token 用量在「用量」页。 ## 对话内额度提醒（Codex CLI 式） 每次 agent 请求时，插件会把**当前额度状态动态注入 system prompt**，**只在进入新档位时注入一次**（同档内后续请求不重复，prompt 前缀稳定、省 token、利于缓存命中）： | 5小时用量 | 行为 | |---|---| | <60%（warnAt） | **不注入**（零 prompt 成本） | | 60%-79% | 注入一次：注意档——建议在合适节点提醒用户、暂停待恢复 | | 80%-89% | 注入一次：告急档——主动提醒、任务边界暂停 | | 90% 起 | **每增长 2% 递进一档**（90/92/94/...），措辞紧急程度递增：严重 → 濒临耗尽 → 即将耗尽 → 几乎耗尽 → 近极限 → 已用尽（100%），每档只提醒一次 | 窗口重置回 60% 以下后，升档记忆自动清除，下次爬升会重新按档提醒。 阈值可通过 cordis.yml 配置（`warnAt` / `criticalAt` / `escalateFrom` / `escalateStep`，默认 60 / 80 / 90 / 2；`cacheTtl` 为用量缓存秒数，默认 60；`weeklyWarnAt` / `monthlyWarnAt` 为周/月圆环警示阈值，默认 90 / 95）： ```yaml - id: dsh-opencode-go-quota config: warnAt: 60 criticalAt: 80

阅读完整 README仓库许可: MIT

dsh-opencode-go-quota DSH 插件常见问题

如何安装 OpenCode Go 额度圆环插件？

可以通过 `dsh plugin --profile web add <插件本地路径>` 安装本地版本，或使用 `dsh plugin --profile web add github:GLFzr/dsh-opencode-go-quota` 从 GitHub 安装。安装后重启 DSH Web 即可生效。

圆环显示灰色感叹号是什么原因？

灰色感叹号表示额度数据不可用。常见原因是 OpenCode Go API Key 缺失或接口调用失败。请检查 `~/.local/share/opencode/auth.json` 中是否存在 key，或设置环境变量 `OPENCODE_GO_API_KEY`。另外，在 Windows 上可能因沙箱策略无法运行子进程，需要固定 workspace root。

没有 OpenCode Go 账号能用这个插件吗？

不行。该插件需要有效的 OpenCode Go API Key 来获取额度数据。你需要一个 OpenCode Go 账号并获取 key（通过 auth.json 或环境变量）。没有 key 的话，圆环会显示灰色感叹号，无法显示额度信息。

如何配置警告阈值？

可以在 cordis.yml 文件中配置插件参数，包括 `warnAt`（默认 60%）、`criticalAt`（80%）、`escalateFrom`（90%）、`escalateStep`（2）、`cacheTtl`（60秒）以及 `weeklyWarnAt`/`monthlyWarnAt`（90/95）。将这些参数添加到 profile 的 cordis.patch.yml 中即可。

这个插件会影响 Token 用量或 Prompt 大小吗？

插件仅在进入新档位时注入一次额度状态到 System Prompt，同一档位内不重复注入。当用量低于 60% 时不注入任何内容。这种设计最小化了 Prompt 大小并有利于缓存命中。该插件不记录 Token 用量，那由独立的 dsh-token-ledger 插件处理。