dsh-opencode-go 0.1.7 → 0.1.8

package/README.en.md

@@ -4,18 +4,36 @@
 
 Use OpenCode Go subscription models in [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), with streaming replies, tool calls, and image input.
 
-The plugin adds the session headers required by OpenCode Go, reads the gateway model catalog, and displays subscription usage.
+The plugin automatically adds the session headers required by OpenCode Go, reads the gateway model catalog, and displays subscription usage. There is no need to configure model protocols, modalities, context windows, or maximum output tokens manually.
+
+## Features
+
+- **Session headers**: Every request includes the Harness User-Agent and `x-opencode-session`. A session keeps the same ID to maximize cache hits.
+- **Streaming and history**: Supports streaming output, tool calls, and history replay through pi-ai.
+- **Image input**: Supports models that advertise image capability in the catalog.
+- **Model capacity overrides**: Override the context window and maximum output per model, with blank values inheriting the online catalog.
+- **Prompt and caching**: The plugin does not add hidden system prompts; the session ID is used for gateway routing.
 
 ## Installation and usage
 
-Plugin `0.1.7` supports DSH `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.6-alpha.1`, `0.1.6-alpha.2`, and `0.1.7-alpha.1`.
+Supported DSH versions: `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.6-alpha.1`, `0.1.6-alpha.2`, and `0.1.7-alpha.1`.
+
+### Install from DSH (recommended)
+
+1. Open the **Plugins** page in DSH and click **Add plugin** in the top-right corner.
+2. Enter `dsh-opencode-go` and click **Install**.
+3. If prompted after installation, click **Enable now**.
+
+![Add, install, and enable dsh-opencode-go from DSH (Chinese UI)](docs/assets/install-via-dsh.gif)
 
-To build from source and install locally, use `npm ci --legacy-peer-deps`, `npm pack`, then `dsh plugin --profile web add ./dsh-opencode-go-0.1.7.tgz`. The development dependency tree intentionally includes multiple DSH generations.
+Then open **Settings → OpenCode Go**, enter and save your API key, and select an OpenCode Go model in a conversation.
 
-### Web
+If your DSH version does not have an **Add plugin** entry, use the command-line method below.
+
+### Command-line installation (alternative)
 
 ```sh
-dsh plugin --profile web add dsh-opencode-go@0.1.7
+dsh plugin --profile web add dsh-opencode-go@0.1.8
 ```
 
 Start or restart `dsh web`, then:
@@ -29,7 +47,7 @@ Start or restart `dsh web`, then:
 Install the plugin into the Headless profile:
 
 ```sh
-dsh plugin --profile headless add dsh-opencode-go@0.1.7
+dsh plugin --profile headless add dsh-opencode-go@0.1.8
 ```
 
 Save the following as `headless.patch.yml` to select a default model:
@@ -51,33 +69,15 @@ dsh --profile headless --patch ./headless.patch.yml "Hello"
 
 The model ID must be available in the current gateway catalog. Web and Headless use separate profiles, so install the plugin in each profile you use.
 
-## Model capacity settings
-
-In Web, open **Settings → OpenCode Go → Model capacities** to override capacities per model. The section is collapsed by default and lets you:
-
-- Search by model name or ID.
-- Set the **context window** and **maximum output**.
-- See the catalog-advertised capacities as a reference.
-- Click **Use catalog** for one model or clear all overrides.
-
-Blank fields inherit the catalog values. Positive integers are passed directly to the adapter; the plugin does not clamp them to the provider's actual capabilities, so values above the upstream limit may be rejected by the gateway. Changes use the settings page's **Save** / **Discard** flow and take effect on the next request or model read without a restart.
+To build from source and install a local package:
 
-Headless or profile patches can also configure `modelLimits` directly:
-
-```yaml
-- id: opencode-go
-  config:
-    modelLimits:
-      deepseek-v4.1-flash:
-        contextWindow: 262144
-        maxTokens: 32768
+```sh
+npm ci --legacy-peer-deps
+npm pack
+dsh plugin --profile web add ./dsh-opencode-go-0.1.8.tgz
 ```
 
-Each model may set only one field. Omitted fields inherit existing configuration, falling back to the catalog when no override exists. `maxTokens` also caps explicit request budgets while preserving smaller budgets.
-
-Set a model entry or an individual field to `null` to explicitly select the catalog value even when a lower profile layer supplies an override. The Web reset and clear actions save this marker automatically. Changing limits preserves learned catalog metadata; the reference values always show the original catalog capacities.
-
-DSH `0.1.5` / `0.1.6` use the legacy settings interface; `0.1.7-alpha.1` uses profile configuration. Changes take effect without restarting on all five supported versions.
+The development dependencies include real test packages from multiple DSH generations, so installation requires `--legacy-peer-deps`. For Headless, replace `web` with `headless`.
 
 ## Updating the plugin
 
@@ -95,20 +95,6 @@ Restart `dsh web` and refresh the browser afterwards. For Headless, replace `web
 
 ## FAQ
 
-### Advanced settings after upgrading to DSH 0.1.7
-
-DSH `0.1.7` stores settings in the current profile’s `cordis.patch.yml`, using entry ID `opencode-go`. Older hosts use the `llm-opencode-go` section in `settings.yaml`. The upstream importer does not map these different names automatically. If advanced settings return to defaults, copy the relevant values from `settings.yaml.imported` (or `settings.yaml` before import) into the new settings page or the existing `opencode-go` profile entry. Preserve other profile entries and any custom `apiKeyEnv` value. API keys remain in the credentials service; Web and Headless configurations are now independent.
-
-### DSH 0.1.5 cannot start after installing the plugin
-
-Plugin versions `0.1.0`–`0.1.4` used an image API introduced in DSH `0.1.6`. On an older DSH version this could produce an `IMAGE_OFFLOAD_REQUIRED_CODE` startup error for a missing export. Upgrade to plugin `0.1.5` or newer and restart:
-
-```sh
-dsh plugin --profile web add dsh-opencode-go@0.1.7
-```
-
-For Headless, replace `web` with `headless`. The fix preserves both host behaviors: DSH `0.1.5` turns the oldest image into placeholder text when the request exceeds the image budget, while DSH `0.1.6` continues to record and handle image offloading through the host.
-
 ### The `opencode-go` route is already in use
 
 Only one adapter in a profile can provide the `opencode-go` route. If another plugin or a generic pi-ai configuration already connects OpenCode Go, disable that configuration first. Other providers can continue to run.
@@ -125,14 +111,6 @@ A reasoning-capable model without adjustable reasoning levels (for example, `uni
 
 If the online configuration is temporarily unavailable, the plugin prefers a configuration fetched successfully earlier in the process and falls back to pi-ai's built-in metadata. If the gateway catalog is unavailable, existing requests can use the last catalog; a Settings refresh reports the failure instead of presenting stale data as current. `refreshMinutes` controls the cache lifetime for ongoing model requests, but does not prevent an explicit model-list read from fetching fresh data.
 
-## Features
-
-- **Session headers**: Every request includes the Harness User-Agent and `x-opencode-session`. A session keeps one ID; requests without a session ID receive an independent random value.
-- **Streaming and history**: Supports streaming output, tool calls, and history replay through pi-ai.
-- **Image input**: Supports models that advertise image capability; the DSH attachment service is required.
-- **Model capacity overrides**: Override the context window and maximum output per model, with blank values inheriting the online catalog.
-- **Prompt and caching**: The plugin does not add hidden system prompts; the session ID is used for gateway routing.
-
 ## Uninstall
 
 Remove the plugin from the relevant profile and restart the application:

package/README.md

@@ -2,29 +2,39 @@
 
 [English](README.en.md)
 
-在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 中使用 OpenCode Go 订阅模型，支持流式回复、工具调用和图片输入。
+功能：让你在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 中完美使用 OpenCode Go 订阅模型，支持流式回复、工具调用和图片输入。
 
-插件会自动添加 OpenCode Go 所需的会话请求头、读取网关模型目录，并显示订阅用量。
+插件会自动添加 OpenCode Go 所需的会话请求头、读取网关模型目录，并显示订阅用量，无需给模型配置协议、模态、上下文长度、最大输出token
+
+## 功能说明
+
+- **会话请求头**：每次请求包含 Harness User-Agent 和 `x-opencode-session`。同一会话保持相同 ID，最佳缓存命中率。
+- **流式与历史**：支持流式输出、工具调用及历史回放，协议请求由 pi-ai 执行。
+- **图片输入**：支持目录中声明图片能力的模型。
+- **模型容量覆盖**：可按模型覆盖上下文窗口和最大输出，空值继承在线目录。
+- **提示与缓存**：插件不增加隐藏系统提示；会话 ID 用于网关路由。
 
 ## 安装与使用
 
-插件 `0.1.7` 兼容 DSH `0.1.5-rc.1`、`0.1.5-rc.2`、`0.1.6-alpha.1`、`0.1.6-alpha.2` 和 `0.1.7-alpha.1`，旧版 DSH 用户无需升级宿主。
+兼容清单：
+ `0.1.5-rc.1`、`0.1.5-rc.2`、`0.1.6-alpha.1`、`0.1.6-alpha.2` 和 `0.1.7-alpha.1`
 
-如需从源码构建并安装本地包：
+### 在 DSH 中安装（推荐）
 
-```sh
-npm ci --legacy-peer-deps
-npm pack
-dsh plugin --profile web add ./dsh-opencode-go-0.1.7.tgz
-```
+1. 打开 DSH 的 **插件** 页面，点击右上角 **添加插件**。
+2. 输入 `dsh-opencode-go`，点击 **安装**。
+3. 安装成功后，如果出现 **立即启用**，点击即可。
 
-开发依赖包含多代 DSH 的真实测试包，安装时需要 `--legacy-peer-deps`。Headless 用户将 `web` 换成 `headless`。
+![在 DSH 插件页添加、安装并启用 dsh-opencode-go](docs/assets/install-via-dsh.gif)
 
+然后打开 **设置 → OpenCode Go**，填入 API Key 并保存，即可在会话中选择 OpenCode Go 模型。
 
-### Web
+若当前 DSH 没有「添加插件」入口，可使用下面的命令行方式。
+
+### 命令行安装（备选）
 
 ```sh
-dsh plugin --profile web add dsh-opencode-go@0.1.7
+dsh plugin --profile web add dsh-opencode-go@0.1.8
 ```
 
 安装后启动或重启 `dsh web`，然后：
@@ -33,12 +43,12 @@ dsh plugin --profile web add dsh-opencode-go@0.1.7
 2. 填入 OpenCode Go API Key 并保存。
 3. 在会话的模型选择器中选择 OpenCode Go 模型。
 
-### Headless
+### 无头模式
 
 安装到 Headless profile：
 
 ```sh
-dsh plugin --profile headless add dsh-opencode-go@0.1.7
+dsh plugin --profile headless add dsh-opencode-go@0.1.8
 ```
 
 将以下内容保存为 `headless.patch.yml`，选择默认模型：
@@ -60,33 +70,15 @@ dsh --profile headless --patch ./headless.patch.yml "你好"
 
 模型 ID 须在当前网关目录中可用。Web 和 Headless 使用各自的 profile，需要分别安装插件。
 
-## 模型容量设置
-
-Web 用户可在 **设置 → OpenCode Go → 模型容量** 中按模型覆盖容量。该区域默认折叠，打开后可以：
-
-- 搜索模型名称或 ID。
-- 设置 **上下文窗口** 和 **最大输出**。
-- 查看目录公布的容量作为参考。
-- 对单个模型点击 **使用目录值**，或清除全部覆盖。
-
-留空的字段会继承目录值。填写的正整数会直接传给适配器，不会被插件自动限制到提供方能力以内；超过上游真实能力的值可能被网关拒绝。修改会跟随设置页的 **Save** / **Discard** 流程，并在下一次请求或模型读取时生效，无需重启。
-
-Headless 或 profile patch 也可以直接配置 `modelLimits`：
+如需从源码构建并安装本地包：
 
-```yaml
-- id: opencode-go
-  config:
-    modelLimits:
-      deepseek-v4.1-flash:
-        contextWindow: 262144
-        maxTokens: 32768
+```sh
+npm ci --legacy-peer-deps
+npm pack
+dsh plugin --profile web add ./dsh-opencode-go-0.1.8.tgz
 ```
 
-每个模型可以只设置其中一个字段；没有设置的字段沿用已有配置，无已有配置时使用目录值。`maxTokens` 同时约束显式请求的输出预算，较小的请求预算会保留。
-
-在分层配置中，将某个模型或字段设为 `null` 可明确恢复在线目录值，即使下层 profile 已有覆盖。Web 的清空和“使用目录值”操作会自动保存这个标记。容量修改保留已获取的原始目录缓存，目录参考值始终显示上游公布的容量。
-
-DSH `0.1.5` / `0.1.6` 通过旧设置接口保存；`0.1.7-alpha.1` 通过 profile 配置接口保存。五个受支持版本均无需重启即可生效。
+开发依赖包含多代 DSH 的真实测试包，安装时需要 `--legacy-peer-deps`。Headless 用户将 `web` 换成 `headless`。
 
 ## 升级插件
 
@@ -104,32 +96,6 @@ dsh plugin --profile web update dsh-opencode-go --latest
 
 ## 常见问题
 
-### 升级到 DSH 0.1.7 后的高级设置
-
-DSH `0.1.7` 将设置改存到当前 profile 的 `cordis.patch.yml`，本插件的条目 ID 为 `opencode-go`；旧宿主继续使用 `settings.yaml` 中的 `llm-opencode-go` 分区。API Key 仍由 credentials 服务保存。
-
-上游的一次性设置导入无法自动把第三方插件的旧分区名映射到不同的条目 ID。如果升级后高级配置恢复默认值，可从 DSH home 下的 `settings.yaml.imported`（尚未导入时为 `settings.yaml`）找到 `llm-opencode-go`，在新设置页重新保存其中的配置；也可以将这些字段合并到目标 profile 的已有条目中，保留其他配置：
-
-```yaml
-- id: opencode-go
-  config:
-    # 将旧 llm-opencode-go 分区中需要保留的字段放在这里
-    apiKeyEnv: OPENCODE_API_KEY
-    refreshMinutes: 60
-```
-
-如果使用了自定义 API Key 引用，须保留原来的 `apiKeyEnv` 值。Web 和 Headless 的配置现在各自独立。
-
-### DSH 0.1.5 安装插件后无法启动
-
-插件 `0.1.0`–`0.1.4` 使用了 DSH `0.1.6` 新增的图片接口，在旧版 DSH 上可能出现 `IMAGE_OFFLOAD_REQUIRED_CODE` 导出不存在的启动错误。升级插件到 `0.1.5` 或更新版本后重启即可：
-
-```sh
-dsh plugin --profile web add dsh-opencode-go@0.1.7
-```
-
-Headless 用户将 `web` 换成 `headless`。修复保留了两版宿主的图片处理方式：DSH `0.1.5` 在请求超过图片预算时将最旧图片转成占位文本，DSH `0.1.6` 继续由宿主记录并处理图片卸载。
-
 ### 提示 `opencode-go` 路由已被占用
 
 同一 profile 中只能有一个适配器提供 `opencode-go` 路由。如果已经通过其他插件或通用 pi-ai 配置接入 OpenCode Go，请先停用那一项配置。其他提供方可以继续使用。
@@ -146,14 +112,6 @@ Headless 用户将 `web` 换成 `headless`。修复保留了两版宿主的图
 
 在线配置暂时不可达时，优先复用本次运行中成功获取的配置，以 pi-ai 内置配置作为备用。网关目录不可达时，已有请求可以使用上次目录；设置页刷新会显示失败，避免把旧目录误认为最新结果。`refreshMinutes` 只控制已有模型请求的缓存时长，不阻止主动读取列表获取新模型。
 
-## 功能说明
-
-- **会话请求头**：每次请求包含 Harness User-Agent 和 `x-opencode-session`。同一会话保持相同 ID，无会话 ID 的请求使用独立随机值。
-- **流式与历史**：支持流式输出、工具调用及历史回放，协议请求由 pi-ai 执行。
-- **图片输入**：支持目录中声明图片能力的模型，需要 DSH attachment 服务。
-- **模型容量覆盖**：可按模型覆盖上下文窗口和最大输出，空值继承在线目录。
-- **提示与缓存**：插件不增加隐藏系统提示；会话 ID 用于网关路由。
-
 ## 卸载
 
 从对应 profile 移除插件，再重启应用：

package/docs/verification.md

@@ -1,5 +1,17 @@
 # Verification
 
+## Release 0.1.8 (2026-09-22)
+
+Host/client type checks, the build, and all **181 tests in 16 files** pass on macOS / Node.js 24.14.1. Coverage includes the five supported host versions, deprecated-model visibility, model remote injection, and CSS composition in the distributed client. The upstream UI primitives packages still emit missing-source-map warnings; all assertions pass. This release also synchronizes the English README with the simplified Chinese guide and updates installation examples to 0.1.8.
+
+## Model settings layout and deprecated visibility (2026-09-22)
+
+The settings page uses the selected list/detail layout, real gateway membership, models.dev release dates and deprecation flags, and a default-off `showDeprecatedModels` switch. Deprecated models stay configurable in settings; only conversation picker membership is filtered. Existing conversations can still call a hidden model that the gateway serves. Models found only in metadata or saved overrides are not displayed. Before any successful gateway response, a network failure does not advertise built-in models.
+
+Host/client type checks, the build, and all **181 tests in 16 files** passed. Added checks cover lifecycle date boundaries and ordering, gateway removals, deprecation during metadata outages, real model RPC serialization, immediate visibility changes and picker notifications on legacy settings and the 0.1.7 profile service, and failed toggle writes without discarding other edits. All five published host targets pass the compatibility fixture. Model and usage endpoints share one package contribution so 0.1.7's registry retains both.
+
+The actual React settings component was also rendered in a separate local preview with public live API data. Preview settings remain in memory, and credentials are not read or changed. This is a component/browser check, not a manual five-version host UI matrix. No paid completion or publication was performed.
+
 ## Per-model capacities on five hosts (2026-09-22)
 
 PR #3's capacity editor is integrated on main commit `b093842`, preserving both legacy settings and the `0.1.7` profile configuration bridge. Each operation applies its captured overrides to original catalog metadata. The catalog cache remains available during outages, discovery shows the original reference values, and configured output caps also constrain explicit request budgets. Null model entries or fields explicitly restore catalog values over inherited configuration.
@@ -160,3 +172,7 @@ All four requests returned HTTP 200 and `finish.kind: stop`. After inspecting ea
 | 0.1.6-alpha.2 | 8/8 passed | 4.759 s | 133 / 702 |
 
 Total: four additional live completion requests and 3,092 reported tokens, including reasoning output. No code corrections or retries were needed. This verifies ordinary text-only code generation and executable output; it does not exercise an agent's multi-turn tool-call workflow. Credential handling was identical to the live image checks above.
+
+The settings build was also loaded in the user's running local `0.1.7-alpha.1` Web profile. This exposed a missing `remote.opencodeGoModels` injection in the browser settings scope; both legacy and modern settings bindings now declare it, and the distributed-client regression checks exercise model loading under that injection requirement. After rebuilding and restarting the Host, the real settings page loaded 40 gateway models, including 3 recent releases and 8 deprecated entries, with the deprecated-model switch off. No completion request was sent during this check.
+
+Local Web layout checks also cover the settings panel's independent scroll body and reserved save/discard footer. The model panel now uses the settings container's available height and stacks at narrow container widths. At a 600×780 viewport, browser geometry confirmed no footer overlap or horizontal overflow and a visible action row. The client artifact test checks inherited disclosure styles because the CSS-module build previously omitted `composes` entries.