前言¶
DeepSeek Harness（DSH）采用插件化架构，允许开发者在不修改核心代码的情况下扩展功能。在 Web 界面使用 OpenCode Go 进行开发时，开发者需要时刻关注 API 用量。常规做法通常是进入设置页面查看，或者依赖外部工具，这会打断工作流。本插件旨在解决这一问题，它将 OpenCode Go 的用量读数条直接挂载在输入框下方，与输入栏同宽，确保在编写代码时能随时看到用量状态。
插件定位¶
这是一个 DeepSeek Harness 的 Web GUI 插件，由用户 xv-chang 维护。它不依赖 OpenCode CLI 工具，完全基于 DSH 的运行时环境工作。该插件读取 OpenCode Go 的套餐用量数据，并将其可视化为三个维度的进度条常驻显示在聊天界面的输入框下方。
核心功能¶
- 常驻显示：插件注册在
conversation.composer.dock槽位（order 10），与 DSH 出厂的统计行并列，宽度严格对齐输入框。 - 三档用量窗口：分别显示滚动（5小时）、每周、每月三个维度的用量百分比及重置时间。
- 健康度指示：根据用量百分比显示不同颜色的圆点。绿色表示 <60%，黄色表示 60–85%，红色表示 ≥85%。
- 交互详情：鼠标悬停时，Tooltip 会显示当前窗口的名称、限额与重置时间。
- 手动刷新：提供小刷新按钮，允许用户手动触发一次用量数据的重新请求。
- 静默回退：当未配置 opencode-go 提供商或未找到 API Key 时，整条组件完全不渲染，避免界面噪音；仅在出现网络、HTTP 或解析错误时显示错误行和重试按钮。
- 国际化：支持中英双语，界面语言跟随 DSH 设置。
安装与启用¶
安装该插件需要使用 web profile。
dsh plugin --profile web add github:xv-chang/dsh-opencode-go-usage-dock
安装完成后，重启 dsh web 进程，使 Host 半与服务端的 client bundle 生效。该插件会在安装时自动尝试注册为 profile layer（需版本 0.1.2+）。
配置与典型用法¶
在使用前，需确保 DSH 中已配置好 OpenCode Go 的服务端点。
- 添加提供商：在 DSH 设置中找到“模型”选项，添加
opencode-go提供商。 - 配置 API Key：在凭据库中配置有效的 OpenCode Go API Key（格式通常为
sk-opencode-…）。 - 打开会话：插件槽位属于会话作用域，必须先打开任意一个聊天会话，用量条才会出现。
- 调整配置（可选）：如果默认接口地址或超时时间不满足需求，可在插件配置中修改。
- id: opencode-go-usage-dock
name: dsh-opencode-go-usage-dock
config:
baseUrl: https://opencode.ai/zen/go/v1/usage # 默认值
timeoutMs: 15000 # 默认值
注意事项¶
- pnpm 警告：安装时可能会出现 pnpm peer dependencies 警告（如缺少 react 或 @deepseek-ai/*），这属于正常现象，可以忽略。这些依赖由 DSH 运行时提供。
- 401 错误：如果提示 “API Key 无效或已过期 (401)”，说明 API Key 错误或已过期，需前往 OpenCode 后台重新签发并更新凭据。
- 限额参考性：Tooltip 中显示的限额数字跟随 OpenCode Go 套餐，仅供参考；接口响应本身不包含限额数据。
- 无 CLI 依赖：本插件是 DSH 特性，不读取任何 OpenCode CLI 的配置文件或本地凭据。
结语¶
该插件通过将用量监控下沉到输入栏下方，实现了对 OpenCode Go 套餐用量的即时掌控，减少了切换页面的操作成本。若需查看更多插件详情或源码，请访问其 GitHub 仓库。
