dsh-opencode-go 0.1.0 → 0.1.1

package/README.md

@@ -1,26 +1,36 @@
 # dsh-opencode-go
 
-可独立构建、打包和安装的 DeepSeek Harness OpenCode Go 插件。包含模型适配器和 Web 设置页，无需修改 DSH 源码或重新构建 DSH。
+在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 中使用 OpenCode Go 订阅模型，支持流式回复、工具调用、图片输入和 Web 设置页。
 
-## 兼容版本
+插件自动添加 OpenCode Go 所需的会话请求头，并从网关获取可用模型目录。通过 DSH 插件命令安装，无需修改 DSH 源码。
 
-当前适配并验证 **DSH `0.1.6-alpha.1`**，依赖使用明确版本。npm 的 DSH `latest` 标签仍指向较旧版本，请勿省略版本号后假定兼容。未验证其他 DSH 版本、Desktop 或其他操作系统。
+## 安装与使用
 
-插件依赖 DSH 的公开服务接口；OpenCode Go 的请求头、模型目录和转换逻辑由本项目维护。无需安装或挂载 `dsh-llm-pi-ai` 才能使用本适配器；DSH 默认组合可以继续挂载它以服务其他提供方。
+已验证兼容 **DSH `0.1.6-alpha.1`**。其他版本尚未验证。
 
-## 安装
-
-在已经安装兼容版本 DSH 的环境执行：
+### Web
 
 ```sh
 dsh plugin --profile web add dsh-opencode-go
-dsh --profile web --dump-config
-dsh web
 ```
 
-配置树应出现 `dsh-opencode-go` 层和 `id: opencode-go`。Web 设置中打开 **OpenCode Go**，保存 API Key，再在模型选择器选择该提供方的模型。安装插件不会自动更改默认模型。
+安装后启动或重启 `dsh web`：
+
+1. 打开 **设置 → OpenCode Go**。
+2. 填入 OpenCode Go API Key 并保存。
+3. 在会话的模型选择器中选择 OpenCode Go 模型。
+
+API Key 来自你的 OpenCode Go 订阅。安装插件不会自动更改默认模型。
+
+### Headless
+
+安装到 Headless profile：
 
-Headless 用户先把以下内容保存为当前目录下的 `headless.patch.yml`，选择默认模型：
+```sh
+dsh plugin --profile headless add dsh-opencode-go
+```
+
+将以下内容保存为 `headless.patch.yml`，选择默认模型：
 
 ```yaml
 - id: agent-default-model
@@ -29,35 +39,31 @@ Headless 用户先把以下内容保存为当前目录下的 `headless.patch.yml
     model: deepseek-v4.1-flash
 ```
 
-再独立安装到 Headless profile：
+在 Bash 或 Zsh 中读取 API Key，然后运行任务：
 
 ```sh
-dsh plugin --profile headless add dsh-opencode-go
 read -s OPENCODE_API_KEY
 export OPENCODE_API_KEY
 dsh --profile headless --patch ./headless.patch.yml "你好"
 ```
 
-安装器若提示 pnpm 拦截依赖构建脚本，按提示在该 profile 的 `pnpm-workspace.yaml` 中逐项声明 `allowBuilds`。本次测试对 `@google/genai` 和 `protobufjs` 均设置为 `false`，未执行这些脚本；OpenCode Go 测试路径不需要它们。无需全局放开安装脚本。
+模型 ID 须在当前网关目录中可用。Web 和 Headless 使用各自的 profile，需要分别安装插件。
 
-### 从已有二次开发版本迁移
+## 订阅用量
 
-本插件使用配置行 `id: opencode-go`，设置命名空间仍是 `llm-opencode-go`，凭据引用仍是 `OPENCODE_API_KEY`。现有二次开发版内置行 `id: llm-opencode-go` 必须停用，避免两个适配器竞争同一个提供方路由。
+Web 中选择 `opencode-go` 提供方的模型后，模型名左侧显示 **Go · 5h 已用百分比 · 周已用百分比**。点击可查看 5 小时、每周、每月用量和本地时区的重置时间。
 
-把以下停用行合并进对应 profile 的 `cordis.patch.yml`，保留已有的其他配置行：
+数据通过 Host 使用已配置的 API Key 查询 `GET /zen/go/v1/usage`，每分钟刷新；浏览器不接收 API Key。切换到其他提供方后隐藏，页面不可见时暂停查询。接口失败或响应缺失时显示“暂不可用”，不会填成 0%。接口返回的是账号订阅额度，不是当前会话 token 数。
 
-```yaml
-- id: llm-opencode-go
-  disabled: true
-```
-
-无需删除原仓库代码；停用旧行后由外部安装包提供功能。
+这个接口可在 [OpenCode 官方源码](https://github.com/anomalyco/opencode/blob/dev/packages/console/app/src/routes/zen/go/v1/usage.ts) 中查到；当前返回 `rolling`、`weekly`、`monthly` 各窗口的 `status`、`percent` 和 `resetsAt`，不返回缓存命中率。
 
-如果通用 pi-ai 的配置也声明了 `opencode-go` 路由，请移除该路由配置。其他提供方可继续使用。
+底部的缓存命中率由每次模型响应的缓存 token 统计计算。插件支持 `prompt_tokens_details.cached_tokens`、`prompt_cache_hit_tokens` 和顶层 `cached_tokens`。上游未返回缓存统计时，当前 pi-ai / Harness 统计链路也可能显示 0；可在 OpenCode 控制台的使用历史中展开对应请求的输入明细进行核对。新会话首次请求出现 0 命中是可能的，同一会话后续有可复用的提示前缀才可能命中。
 
 ## 配置
 
-修改对应 profile 的 `cordis.patch.yml`：
+Web 用户可直接在 **设置 → OpenCode Go** 中修改配置。启用开关立即生效；保存其他配置后，后续请求使用新值。
+
+需要通过文件配置时，在对应 profile 的 `cordis.patch.yml` 中添加以下内容。所有字段均有默认值，通常只需配置 API Key。
 
 ```yaml
 - id: opencode-go
@@ -72,50 +78,64 @@ dsh --profile headless --patch ./headless.patch.yml "你好"
     requestImageMaxBytes: 1048576
 ```
 
-所有字段均有默认值。`apiKeyEnv` 是凭据引用名，不是密钥；存在 credentials 服务时使用该服务，否则读取进程环境。Web 设置可覆盖基础配置，后续请求读取新值。禁用开关或移除密钥会撤销路由，设置页仍可访问。
+`apiKeyEnv` 是凭据引用名，不是密钥。插件通过 DSH credentials 服务解析凭据；未挂载该服务时读取进程环境。Web 保存的设置可覆盖文件中的基础配置。
 
-## 请求与模型行为
+关闭插件开关或移除密钥会撤下提供方路由，设置页仍可访问。
 
-- 每次请求包含 Harness User-Agent 和 `x-opencode-session`；同一会话保持相同值，无会话 ID 的请求使用独立随机值。
-- 模型目录取 pi-ai 目录及本项目补充表与网关 `/models` 的交集。未知协议的模型不会猜测加入。
-- 实时目录获取失败时，请求目录可回退到本地表；显式模型发现会报告失败。
-- 保留流式输出、工具调用、历史回放及支持图片的模型转换；输入图片须有 DSH attachment 服务。
-- 模型看到会话内容和工具定义，不增加隐藏系统提示。会话请求头用于网关路由；图片编码和历史前缀影响缓存复用。
+## 常见问题
 
-## 从源码构建与打包
+### 安装提示依赖构建脚本被拦截
 
-需要 Node.js `^22.19.0 || >=24.0.0` 和 npm。所有依赖从 npm 获取，不使用 `workspace:`、本机路径或 DSH 源码别名。
+按安装器提示，在该 profile 的 `pnpm-workspace.yaml` 中逐项设置 `allowBuilds`。OpenCode Go 已验证的运行路径不需要执行 `@google/genai` 和 `protobufjs` 的安装脚本，可以将这两项设为 `false` 后重试。保留文件中的其他配置，无需全局放开安装脚本。
 
-```sh
-npm ci
-npm test
-npm pack
-```
+### 提示 `opencode-go` 路由已被占用
 
-`npm test` 先构建，再执行测试；`npm pack` 也会构建。产物是 `dsh-opencode-go-0.1.0.tgz`，包含 Host、Client、声明文件及 bundle 配置，不包含源码、测试或密钥。
+同一 profile 中只能有一个适配器提供 `opencode-go` 路由。如果已经通过其他插件或通用 pi-ai 配置接入 OpenCode Go，请先停用那一项配置。其他提供方可以继续使用。
 
-## 验证与维护
+### 没有出现预期的模型
 
-```sh
-npm run typecheck
-npm test
-npm run verify:installed -- /path/to/isolated-consumer
-npm run verify:headless -- /path/to/isolated-consumer
-```
+先确认插件已启用且 API Key 已配置，再刷新设置页中的模型列表。插件仅展示本地适配表与网关实时目录的交集；尚未适配协议的新模型不会自动加入。
+
+实时目录获取失败时，适配器可使用本地表继续处理请求；设置页中的模型发现会显示失败，便于重新尝试。
 
-后两项使用隔离目录中的已安装包。准备方式和实际验证记录见 [验证说明](docs/verification.md)。架构与代码来源见 [独立发布决策](docs/independent-package.md)和 [第三方声明](THIRD_PARTY_NOTICES.md)。
+## 功能说明
 
-测试使用本地模拟网关，不会发送真实 OpenCode Go API 请求。真实账号、额度和网关当前模型可用性须在配置自己的密钥后验证。
+- **会话请求头**：每次请求包含 Harness User-Agent 和 `x-opencode-session`。同一会话保持相同 ID，无会话 ID 的请求使用独立随机值。
+- **流式与历史**：支持流式输出、工具调用及历史回放，协议请求由 pi-ai 执行。
+- **图片输入**：支持目录中声明图片能力的模型，需要 DSH attachment 服务。
+- **提示与缓存**：插件不增加隐藏系统提示；会话 ID 用于网关路由，历史前缀及图片编码影响缓存复用。
 
 ## 卸载
 
+从对应 profile 移除插件，再重启应用：
+
 ```sh
 dsh plugin --profile web remove dsh-opencode-go
+# 或
 dsh plugin --profile headless remove dsh-opencode-go
 ```
 
-重启相应应用后移除插件；如默认模型仍指向 `opencode-go`，请选择其他提供方。凭据和历史会话由 DSH 管理。
+如果默认模型仍指向 `opencode-go`，请改选其他提供方。凭据和历史会话由 DSH 管理。
+
+## 开发
+
+需要 Node.js `^22.19.0 || >=24.0.0` 和 npm。
+
+```sh
+npm ci
+npm run typecheck
+npm test
+npm pack
+```
+
+`npm test` 会先构建再执行测试；`npm pack` 生成可安装的 `.tgz` 包。依赖均通过 npm 安装，不需要 DSH 源码仓库。
+
+- [验证说明](docs/verification.md)：测试范围、隔离安装与 Headless 验证方法。
+- [架构与依赖](docs/independent-package.md)：Host、Client 构建方式和转换代码的维护方式。
+- [第三方声明](THIRD_PARTY_NOTICES.md)：代码来源与许可。
+
+自动化测试使用本地模拟网关，不会发起付费模型请求。真实账号、Desktop 和其他操作系统尚未验证。
 
-## 发布
+## 许可证
 
-维护者在有发布权限的 npm 账号下执行 `npm publish --access public`。发布前执行 `npm run typecheck`、`npm test` 和 `npm publish --dry-run`；发布后检查 registry 版本并用包名验证安装。每次更新递增版本号，已发布的版本不可覆盖。构建脚本从 `package.json` 读取 Client 模块 ID。
+[MIT](LICENSE)

package/docs/verification.md

@@ -45,6 +45,12 @@ The tarball was installed into a separate Web profile in the same temporary Harn
 
 The browser-factory test additionally evaluates the distributed `lib/client.js` against the published React/store/UI module table, checks the package ID, mounts the settings section, and verifies CSS insertion.
 
-## Limits
+## Subscription usage verification (0.1.1)
+
+The usage tests invoke the actual published Typert Host gateway against a local HTTP fixture, checking the Bearer credential, credential changes, all three windows, and failure handling. Browser component tests check provider switching, polling cleanup, monthly details, and failed-refresh behavior. Adapter tests cover non-zero cached input in OpenAI, DeepSeek, and Kimi usage fields.
+
+The local Web profile was also checked against the real read-only OpenCode Go usage endpoint. The button renders immediately before the model selector, and its details show rolling, weekly, and monthly percentages and local reset times. This check sends no model-generation request. The manual Remote codec supports both the published DSH `schema` shape and the current source build's `create()` shape.
+
+## Remaining limits
 
 Real paid OpenCode Go completions, Desktop, non-macOS platforms, and other DSH releases are not verified. The automated gateway tests preserve the adapter's request and replay semantics but cannot establish account validity or live provider availability.

package/lib/client.js

@@ -32,7 +32,7 @@ var import_react = require("react");
 var import_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 
 // plugin-css:/Users/tanglei/Desktop/dsh-opencode-go/src/client/Section.module.css
-var id = "dsh-opencode-go/settings";
+var id = "dsh-opencode-go/Section.module.css";
 if (!document.querySelector("style[data-plugin-css=" + JSON.stringify(id) + "]")) {
   const style = document.createElement("style");
   style.dataset.plugin = "dsh-opencode-go";
@@ -40,7 +40,7 @@ if (!document.querySelector("style[data-plugin-css=" + JSON.stringify(id) + "]")
   style.textContent = ".BtKYva_field{flex-direction:column;gap:6px;padding:12px 0;display:flex}.BtKYva_field+.BtKYva_field{border-top:.5px solid var(--dsw-alias-border-l2)}.BtKYva_head{align-items:center;gap:8px;display:flex}.BtKYva_label{min-width:0;color:var(--dsw-alias-label-primary);flex:1;font-size:13px;font-weight:500;line-height:1.5}.BtKYva_badges{align-items:center;gap:8px;display:inline-flex}.BtKYva_reset{font:inherit;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;padding:0;font-size:12px;line-height:1.5}.BtKYva_reset:hover:not(:disabled){color:var(--dsw-alias-label-primary)}.BtKYva_reset:disabled{cursor:default}.BtKYva_input{border:.5px solid var(--dsw-alias-border-l4);background:var(--dsw-alias-bg-layer-3);height:34px;font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 12px;font-size:13px;line-height:1.5}.BtKYva_input:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}.BtKYva_input:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}.BtKYva_inputInvalid{border-color:var(--dsw-alias-label-error);}.BtKYva_invalid{color:var(--dsw-alias-label-error);margin:0;font-size:12px;line-height:1.5}.BtKYva_hint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:1.5}.BtKYva_intro{color:var(--dsw-alias-label-secondary);margin:0 0 8px;font-size:13px;line-height:1.5}.BtKYva_disclosure{font:inherit;text-align:left;cursor:pointer;background:0 0;border:none;align-items:center;gap:8px;margin:0;padding:0;display:flex}.BtKYva_disclosure:hover .BtKYva_label{color:var(--dsw-alias-brand-primary)}.BtKYva_chevron,.BtKYva_chevronOpen{color:var(--dsw-alias-label-tertiary);flex:none}.BtKYva_chevron{transform:rotate(-90deg)}.BtKYva_advanced{flex-direction:column;gap:4px;padding:4px 0 0 22px;display:flex}.BtKYva_advanced .BtKYva_field+.BtKYva_field{border-top:none}.BtKYva_chips{flex-wrap:wrap;gap:6px;display:flex}.BtKYva_actions{align-items:center;gap:8px;padding-top:12px;display:flex}.BtKYva_failedNote{color:var(--dsw-alias-label-error);margin:0;font-size:12px;line-height:1.5}";
   document.head.appendChild(style);
 }
-var Section_default = { "reset": "BtKYva_reset", "chevronOpen": "BtKYva_chevronOpen", "advanced": "BtKYva_advanced", "head": "BtKYva_head", "hint": "BtKYva_hint", "chevron": "BtKYva_chevron", "actions": "BtKYva_actions", "label": "BtKYva_label", "badges": "BtKYva_badges", "input": "BtKYva_input", "invalid": "BtKYva_invalid", "disclosure": "BtKYva_disclosure", "inputInvalid": "BtKYva_inputInvalid", "failedNote": "BtKYva_failedNote", "chips": "BtKYva_chips", "field": "BtKYva_field", "intro": "BtKYva_intro" };
+var Section_default = { "reset": "BtKYva_reset", "badges": "BtKYva_badges", "inputInvalid": "BtKYva_inputInvalid", "label": "BtKYva_label", "invalid": "BtKYva_invalid", "failedNote": "BtKYva_failedNote", "input": "BtKYva_input", "disclosure": "BtKYva_disclosure", "intro": "BtKYva_intro", "field": "BtKYva_field", "advanced": "BtKYva_advanced", "actions": "BtKYva_actions", "head": "BtKYva_head", "hint": "BtKYva_hint", "chevron": "BtKYva_chevron", "chevronOpen": "BtKYva_chevronOpen", "chips": "BtKYva_chips" };
 
 // src/client/Section.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
@@ -731,6 +731,16 @@ function refOf(snapshot) {
 
 // src/client/locales.ts
 var en = {
+  usageTitle: "OpenCode Go usage",
+  usageHint: "Account usage \xB7 used percentage \xB7 refreshes every minute",
+  usageWeekShort: "week",
+  usage_rolling: "5 hours",
+  usage_weekly: "Weekly",
+  usage_monthly: "Monthly",
+  usageResets: "Resets",
+  usageLimited: "Limit reached",
+  usageLoading: "Loading usage\u2026",
+  usageUnavailable: "Unavailable",
   nav: "OpenCode Go",
   title: "OpenCode Go",
   intro: "Use your OpenCode Go subscription in the harness. Paste the API key below and save; the models the gateway currently serves are listed underneath.",
@@ -776,6 +786,16 @@ var en = {
   unavailable: "The OpenCode Go settings are not served in this deployment."
 };
 var zh = {
+  usageTitle: "OpenCode Go \u7528\u91CF",
+  usageHint: "\u8D26\u53F7\u989D\u5EA6 \xB7 \u5DF2\u7528\u767E\u5206\u6BD4 \xB7 \u6BCF\u5206\u949F\u5237\u65B0",
+  usageWeekShort: "\u5468",
+  usage_rolling: "5 \u5C0F\u65F6",
+  usage_weekly: "\u6BCF\u5468",
+  usage_monthly: "\u6BCF\u6708",
+  usageResets: "\u91CD\u7F6E\u4E8E",
+  usageLimited: "\u5DF2\u8FBE\u9650\u989D",
+  usageLoading: "\u6B63\u5728\u8BFB\u53D6\u7528\u91CF\u2026",
+  usageUnavailable: "\u6682\u4E0D\u53EF\u7528",
   nav: "OpenCode Go",
   title: "OpenCode Go",
   intro: "\u5728 Harness \u4E2D\u4F7F\u7528\u4F60\u7684 OpenCode Go \u8BA2\u9605\u3002\u586B\u5165\u4E0B\u65B9 API key \u5E76\u4FDD\u5B58\u5373\u53EF\uFF1B\u7F51\u5173\u5F53\u524D\u63D0\u4F9B\u7684\u6A21\u578B\u5217\u5728\u4E0B\u9762\u3002",
@@ -821,11 +841,187 @@ var zh = {
   unavailable: "\u6B64\u90E8\u7F72\u672A\u63D0\u4F9B OpenCode Go \u8BBE\u7F6E\u3002"
 };
 
+// src/usage-contract.ts
+function parseGoUsage(value) {
+  if (!value || typeof value !== "object") throw new Error("Invalid OpenCode Go usage response");
+  const source = value;
+  const result = {};
+  for (const key of ["rolling", "weekly", "monthly"]) {
+    const row = source[key];
+    if (!row || row.status !== "ok" && row.status !== "rate-limited" || typeof row.percent !== "number" || !Number.isFinite(row.percent) || row.percent < 0 || typeof row.resetsAt !== "string" || !Number.isFinite(Date.parse(row.resetsAt))) {
+      throw new Error("Invalid OpenCode Go usage response");
+    }
+    result[key] = { status: row.status, percent: row.percent, resetsAt: row.resetsAt };
+  }
+  return result;
+}
+var usageCodec = {
+  mode: "strict",
+  typeSymbol: "dsh-opencode-go#GoUsage",
+  schema: { parse: parseGoUsage },
+  create: () => ({ parse: parseGoUsage })
+};
+var usageRemote = {
+  package: "dsh-opencode-go",
+  descriptors: [{
+    id: "dsh-opencode-go#opencodeGoUsage/read",
+    service: "opencodeGoUsage",
+    namespace: "opencodeGoUsage",
+    method: "read",
+    invocation: { kind: "direct" },
+    parameters: [],
+    result: usageCodec
+  }]
+};
+
+// src/client/UsagePill.tsx
+var import_react2 = require("react");
+
+// plugin-css:/Users/tanglei/Desktop/dsh-opencode-go/src/client/UsagePill.module.css
+var id2 = "dsh-opencode-go/UsagePill.module.css";
+if (!document.querySelector("style[data-plugin-css=" + JSON.stringify(id2) + "]")) {
+  const style = document.createElement("style");
+  style.dataset.plugin = "dsh-opencode-go";
+  style.dataset.pluginCss = id2;
+  style.textContent = ".dmPm3q_root{min-width:0;display:inline-flex;position:relative}.dmPm3q_trigger{color:inherit;opacity:.75;font:inherit;cursor:pointer;white-space:nowrap;background:0 0;border:0;border-radius:6px;padding:4px 6px;font-size:12px}.dmPm3q_trigger:hover,.dmPm3q_trigger:focus-visible{opacity:1;background:color-mix(in srgb, currentColor 8%, transparent)}.dmPm3q_panel{z-index:100;border:1px solid color-mix(in srgb, currentColor 18%, transparent);width:280px;max-width:calc(100vw - 32px);color:var(--dsw-alias-label-primary,CanvasText);background:var(--dsw-specific-menu,Canvas);border-radius:12px;padding:16px;font-size:12px;position:absolute;bottom:calc(100% + 12px);right:0;box-shadow:0 8px 30px #0002}.dmPm3q_hint{opacity:.65;font-size:11px;line-height:1.6}.dmPm3q_window{margin-top:14px}.dmPm3q_row{justify-content:space-between;margin-bottom:5px;display:flex}.dmPm3q_window progress{accent-color:#39a878;width:100%;height:5px;margin-bottom:5px;display:block}.dmPm3q_window progress::-webkit-progress-bar{background:color-mix(in srgb, currentColor 15%, transparent);border-radius:4px}.dmPm3q_window progress::-webkit-progress-value{background:#39a878;border-radius:4px}.dmPm3q_window progress::-moz-progress-bar{background:#39a878;border-radius:4px}";
+  document.head.appendChild(style);
+}
+var UsagePill_default = { "root": "dmPm3q_root", "window": "dmPm3q_window", "panel": "dmPm3q_panel", "row": "dmPm3q_row", "hint": "dmPm3q_hint", "trigger": "dmPm3q_trigger" };
+
+// src/client/UsagePill.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function UsagePill({ directory, ...props }) {
+  const state = (0, import_react2.useSyncExternalStore)(directory.subscribe, directory.getSnapshot, directory.getSnapshot);
+  return state.current?.provider === "opencode-go" ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(ActiveUsage, { ...props }) : null;
+}
+function ActiveUsage({ readUsage, t }) {
+  const [usage, setUsage] = (0, import_react2.useState)(null);
+  const [failed, setFailed] = (0, import_react2.useState)(false);
+  const [open, setOpen] = (0, import_react2.useState)(false);
+  const root = (0, import_react2.useRef)(null);
+  (0, import_react2.useEffect)(() => {
+    let alive = true;
+    let busy = false;
+    const refresh = async () => {
+      if (busy || document.visibilityState === "hidden") return;
+      busy = true;
+      try {
+        const value = await readUsage();
+        if (alive) {
+          setUsage(value);
+          setFailed(false);
+        }
+      } catch {
+        if (alive) {
+          setUsage(null);
+          setFailed(true);
+        }
+      } finally {
+        busy = false;
+      }
+    };
+    void refresh();
+    const timer = setInterval(() => {
+      void refresh();
+    }, 6e4);
+    const visible = () => {
+      void refresh();
+    };
+    document.addEventListener("visibilitychange", visible);
+    return () => {
+      alive = false;
+      clearInterval(timer);
+      document.removeEventListener("visibilitychange", visible);
+    };
+  }, [readUsage]);
+  (0, import_react2.useEffect)(() => {
+    if (!open) return;
+    const click = (event) => {
+      if (!root.current?.contains(event.target)) setOpen(false);
+    };
+    const key = (event) => {
+      if (event.key === "Escape") setOpen(false);
+    };
+    document.addEventListener("mousedown", click);
+    document.addEventListener("keydown", key);
+    return () => {
+      document.removeEventListener("mousedown", click);
+      document.removeEventListener("keydown", key);
+    };
+  }, [open]);
+  const label = usage ? `Go \xB7 5h ${usage.rolling.percent}% \xB7 ${t("usageWeekShort")} ${usage.weekly.percent}%` : `Go \xB7 ${failed ? t("usageUnavailable") : "\u2026"}`;
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { className: UsagePill_default.root, ref: root, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+      "button",
+      {
+        type: "button",
+        className: UsagePill_default.trigger,
+        "aria-expanded": open,
+        "aria-haspopup": "dialog",
+        "aria-label": `${t("usageTitle")}: ${label}`,
+        onClick: () => {
+          setOpen(!open);
+        },
+        children: label
+      }
+    ),
+    open && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: UsagePill_default.panel, role: "dialog", "aria-label": t("usageTitle"), children: [
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("strong", { children: t("usageTitle") }),
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: UsagePill_default.hint, children: t("usageHint") }),
+      usage ? ["rolling", "weekly", "monthly"].map((key) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: UsagePill_default.window, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: UsagePill_default.row, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { children: t(`usage_${key}`) }),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("strong", { children: [
+            usage[key].percent,
+            "%"
+          ] })
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("progress", { "aria-label": t(`usage_${key}`), max: 100, value: Math.min(100, usage[key].percent) }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: UsagePill_default.hint, children: [
+          t("usageResets"),
+          " ",
+          new Date(usage[key].resetsAt).toLocaleString()
+        ] }),
+        usage[key].status === "rate-limited" && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { children: t("usageLimited") })
+      ] }, key)) : /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { children: failed ? t("usageUnavailable") : t("usageLoading") })
+    ] })
+  ] });
+}
+
+// src/client/usage.ts
+function registerUsagePill(ctx) {
+  ctx.inject(["modelDirectories", "sessions", "remote.session"], (scope) => {
+    scope.effect(async () => {
+      const unmount = await scope.remote.$mount(usageRemote);
+      scope.inject(["remote.opencodeGoUsage"], (ready) => {
+        const readUsage = async () => {
+          const result = await ready.remote.opencodeGoUsage.read();
+          if (!result.ok) throw new Error("OpenCode Go usage unavailable");
+          return result.value;
+        };
+        const translate = ready.locale.bind("settings.opencode-go");
+        ready.slots.inject("conversation.input.right", () => ready.slots.register({
+          name: "conversation.input.right",
+          id: "opencode-go-usage",
+          order: 1e3,
+          inject: (sessionId) => ({
+            directory: ready.modelDirectories.directoryFor(sessionId).store,
+            readUsage,
+            t: (key) => translate(key)
+          })
+        }, UsagePill));
+      });
+      return unmount;
+    });
+  });
+}
+
 // src/client/index.ts
 var NS = "settings.opencode-go";
 var inject = ["slots", "locale", "remote", "remote.credentials", "remote.llm", "settingsScope"];
 function apply(ctx) {
   ctx.effect(() => ctx.locale.register(NS, { zh, en }), "llm-opencode-go: copy dictionaries");
+  registerUsagePill(ctx);
   const scope = ctx.settingsScope.bind({
     namespace: "llm-opencode-go",
     decode: (section) => typeof section === "object" && section !== null ? section : void 0

package/lib/index.js

@@ -1035,6 +1035,73 @@ var OpencodeGoAdapter = class extends LlmAdapter {
   }
 };
 
+// src/usage.ts
+import { TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
+import { attributionHeaders as attributionHeaders3 } from "@deepseek-ai/dsh-llm";
+
+// src/usage-contract.ts
+function parseGoUsage(value) {
+  if (!value || typeof value !== "object") throw new Error("Invalid OpenCode Go usage response");
+  const source = value;
+  const result = {};
+  for (const key of ["rolling", "weekly", "monthly"]) {
+    const row = source[key];
+    if (!row || row.status !== "ok" && row.status !== "rate-limited" || typeof row.percent !== "number" || !Number.isFinite(row.percent) || row.percent < 0 || typeof row.resetsAt !== "string" || !Number.isFinite(Date.parse(row.resetsAt))) {
+      throw new Error("Invalid OpenCode Go usage response");
+    }
+    result[key] = { status: row.status, percent: row.percent, resetsAt: row.resetsAt };
+  }
+  return result;
+}
+var usageCodec = {
+  mode: "strict",
+  typeSymbol: "dsh-opencode-go#GoUsage",
+  schema: { parse: parseGoUsage },
+  create: () => ({ parse: parseGoUsage })
+};
+var usageRemote = {
+  package: "dsh-opencode-go",
+  descriptors: [{
+    id: "dsh-opencode-go#opencodeGoUsage/read",
+    service: "opencodeGoUsage",
+    namespace: "opencodeGoUsage",
+    method: "read",
+    invocation: { kind: "direct" },
+    parameters: [],
+    result: usageCodec
+  }]
+};
+
+// src/usage.ts
+var GoUsageService = class extends TypertRemoteService {
+  constructor(ctx, options) {
+    super(ctx, "opencodeGoUsage");
+    this.options = options;
+    ctx.inject(["typert"], (scope) => {
+      scope.effect(() => scope.typert.register({
+        package: usageRemote.package,
+        face: "host",
+        schemas: [],
+        model: { services: [], events: [], objects: [] },
+        invocations: usageRemote.descriptors
+      }));
+    });
+  }
+  async read() {
+    const baseURL = assertBaseURL(this.options.baseURL()).replace(/\/$/, "");
+    const key = await this.options.resolveApiKey();
+    if (!key) throw new Error("OpenCode Go API key is not configured");
+    const response = await fetch(`${baseURL}/usage`, {
+      headers: { ...attributionHeaders3(), Authorization: `Bearer ${key}`, Accept: "application/json" },
+      signal: AbortSignal.timeout(1e4),
+      redirect: "error"
+    });
+    if (!response.ok) throw new Error(`OpenCode Go usage unavailable (HTTP ${response.status})`);
+    const body = await response.json();
+    return parseGoUsage(body && typeof body === "object" ? body.usage : void 0);
+  }
+};
+
 // src/index.ts
 var name = "llm-opencode-go";
 var inject = ["llm"];
@@ -1053,6 +1120,7 @@ function apply(ctx, raw) {
       "MISSING_CREDENTIAL"
     );
   };
+  ctx.plugin(GoUsageService, { baseURL: () => current().baseURL, resolveApiKey });
   const logger = {
     fallback: ({ error }) => {
       ctx.logger.warn(`llm-opencode-go: live model listing unreachable; serving the curated table until the next refresh (${String(error)})`);

package/lib/types/client/UsagePill.d.ts

@@ -0,0 +1,10 @@
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { ModelDirectoryState } from '@deepseek-ai/dsh-client-ui-model-selection/client';
+import type { GoUsage } from '../usage-contract.ts';
+export interface UsagePillProps {
+    directory: SnapshotStore<ModelDirectoryState>;
+    readUsage: () => Promise<GoUsage>;
+    t: (key: string) => string;
+}
+/** Only the selected Go provider mounts a poller, so other models send no usage traffic. */
+export declare function UsagePill({ directory, ...props }: UsagePillProps): import("react").JSX.Element | null;

package/lib/types/client/locales.d.ts

@@ -1,5 +1,15 @@
 /** Copy dictionaries for the OpenCode Go settings page. English is the key-set source of truth. */
 export declare const en: {
+    usageTitle: string;
+    usageHint: string;
+    usageWeekShort: string;
+    usage_rolling: string;
+    usage_weekly: string;
+    usage_monthly: string;
+    usageResets: string;
+    usageLimited: string;
+    usageLoading: string;
+    usageUnavailable: string;
     nav: string;
     title: string;
     intro: string;

package/lib/types/client/usage.d.ts

@@ -0,0 +1,2 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare function registerUsagePill(ctx: Context): void;

package/lib/types/usage-contract.d.ts

@@ -0,0 +1,21 @@
+import type { RemoteResult, TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
+export interface UsageWindow {
+    status: 'ok' | 'rate-limited';
+    percent: number;
+    resetsAt: string;
+}
+export interface GoUsage {
+    rolling: UsageWindow;
+    weekly: UsageWindow;
+    monthly: UsageWindow;
+}
+/** Reject missing statistics rather than turning unavailable data into zero. */
+export declare function parseGoUsage(value: unknown): GoUsage;
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface TypertRemoteNamespaceMap {
+        opencodeGoUsage: {
+            read(): Promise<RemoteResult<GoUsage>>;
+        };
+    }
+}
+export declare const usageRemote: TypertRemoteContribution;

package/lib/types/usage.d.ts

@@ -0,0 +1,14 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import { type GoUsage } from './usage-contract.ts';
+interface UsageOptions {
+    baseURL: () => string;
+    resolveApiKey: () => Promise<string | undefined>;
+}
+/** Account statistics are fetched on the Host; credentials never enter the browser. */
+export declare class GoUsageService extends TypertRemoteService {
+    private readonly options;
+    constructor(ctx: Context, options: UsageOptions);
+    read(): Promise<GoUsage>;
+}
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-opencode-go",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "OpenCode Go model provider and settings UI for DeepSeek Harness",
   "type": "module",
   "license": "MIT",
@@ -35,7 +35,8 @@
       "inject": [
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-api-remotes"
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-model-selection"
       ],
       "platform": "web"
     }
@@ -51,22 +52,25 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
+    "@deepseek-ai/dsh-api-gateway": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-api-remotes": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-api-settings-controller": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-attachment": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-store": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-model-selection": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-credentials": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-fs": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-launch-environment": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-llm": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-settings": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-timeout": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-api-remotes": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-api-gateway": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-api-settings-controller": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-store": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-locale": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.6-alpha.1"
+    "@deepseek-ai/dsh-typert-protocol": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-typert-registry": "0.1.6-alpha.1"
   },
   "dependencies": {
     "@deepseek-ai/dsh-brand": "0.1.6-alpha.1",
@@ -84,6 +88,8 @@
     "@deepseek-ai/dsh-brand": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-client-locale": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-client-store": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-model-selection": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-client-ui-primitives": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-client-ui-renderer": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-client-ui-settings": "0.1.6-alpha.1",
@@ -97,38 +103,39 @@
     "@deepseek-ai/dsh-settings-file": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-timeout": "0.1.6-alpha.1",
     "@deepseek-ai/dsh-typert-protocol": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-typert-registry": "0.1.6-alpha.1",
+    "@shikijs/langs": "^4.3.1",
     "@testing-library/react": "^16.3.2",
+    "@types/mdast": "^4.0.4",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
-    "esbuild": "^0.25.0",
-    "jsdom": "29.1.1",
-    "lightningcss": "^1.32.0",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "typescript": "6.0.3",
-    "vitest": "^4.1.8",
     "@types/react-dom": "~18.3.0",
+    "anser": "^2.3.5",
     "clsx": "^2.0.0",
     "diff": "^9.0.0",
-    "anser": "^2.3.5",
+    "esbuild": "^0.25.0",
+    "immer": "^10.1.1",
+    "jsdom": "29.1.1",
     "katex": "^0.16.47",
+    "lightningcss": "^1.32.0",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm": "^3.1.0",
+    "mdast-util-math": "^3.0.0",
     "micromark-core-commonmark": "^2.0.3",
+    "micromark-extension-gfm": "^3.0.0",
+    "micromark-extension-math": "^3.1.0",
+    "micromark-factory-space": "^2.0.1",
     "micromark-util-character": "^2.1.1",
     "micromark-util-classify-character": "^2.0.1",
+    "micromark-util-sanitize-uri": "^2.0.1",
     "micromark-util-symbol": "^2.0.1",
     "micromark-util-types": "^2.0.2",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
     "shiki": "^4.3.1",
-    "@shikijs/langs": "^4.3.1",
-    "@types/mdast": "^4.0.4",
-    "micromark-factory-space": "^2.0.1",
-    "micromark-extension-math": "^3.1.0",
-    "mdast-util-from-markdown": "^2.0.3",
-    "mdast-util-gfm": "^3.1.0",
-    "mdast-util-math": "^3.0.0",
-    "micromark-extension-gfm": "^3.0.0",
-    "micromark-util-sanitize-uri": "^2.0.1",
-    "zustand": "~4.4.7",
-    "immer": "^10.1.1"
+    "typescript": "6.0.3",
+    "vitest": "^4.1.8",
+    "zustand": "~4.4.7"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-api-remotes": {
@@ -155,7 +162,13 @@
     "@deepseek-ai/dsh-client-locale": {
       "optional": true
     },
-    "@deepseek-ai/dsh-typert-protocol": {
+    "@deepseek-ai/dsh-client-ui-model-selection": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-conversation": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-typert-registry": {
       "optional": true
     }
   },