dsh-opencode-go 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# dsh-opencode-go
+
+可独立构建、打包和安装的 DeepSeek Harness OpenCode Go 插件。包含模型适配器和 Web 设置页，无需修改 DSH 源码或重新构建 DSH。
+
+## 兼容版本
+
+当前适配并验证 **DSH `0.1.6-alpha.1`**，依赖使用明确版本。npm 的 DSH `latest` 标签仍指向较旧版本，请勿省略版本号后假定兼容。未验证其他 DSH 版本、Desktop 或其他操作系统。
+
+插件依赖 DSH 的公开服务接口；OpenCode Go 的请求头、模型目录和转换逻辑由本项目维护。无需安装或挂载 `dsh-llm-pi-ai` 才能使用本适配器；DSH 默认组合可以继续挂载它以服务其他提供方。
+
+## 安装
+
+在已经安装兼容版本 DSH 的环境执行：
+
+```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，再在模型选择器选择该提供方的模型。安装插件不会自动更改默认模型。
+
+Headless 用户先把以下内容保存为当前目录下的 `headless.patch.yml`，选择默认模型：
+
+```yaml
+- id: agent-default-model
+  config:
+    provider: opencode-go
+    model: deepseek-v4.1-flash
+```
+
+再独立安装到 Headless profile：
+
+```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: opencode-go`，设置命名空间仍是 `llm-opencode-go`，凭据引用仍是 `OPENCODE_API_KEY`。现有二次开发版内置行 `id: llm-opencode-go` 必须停用，避免两个适配器竞争同一个提供方路由。
+
+把以下停用行合并进对应 profile 的 `cordis.patch.yml`，保留已有的其他配置行：
+
+```yaml
+- id: llm-opencode-go
+  disabled: true
+```
+
+无需删除原仓库代码；停用旧行后由外部安装包提供功能。
+
+如果通用 pi-ai 的配置也声明了 `opencode-go` 路由，请移除该路由配置。其他提供方可继续使用。
+
+## 配置
+
+修改对应 profile 的 `cordis.patch.yml`：
+
+```yaml
+- id: opencode-go
+  config:
+    enabled: true
+    apiKeyEnv: OPENCODE_API_KEY
+    baseURL: https://opencode.ai/zen/go/v1
+    refreshMinutes: 60
+    streamIdleTimeoutMs: 300000
+    maxRequestImageBytes: 20971520
+    requestImagePixelBudget: 4194304
+    requestImageMaxBytes: 1048576
+```
+
+所有字段均有默认值。`apiKeyEnv` 是凭据引用名，不是密钥；存在 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 源码别名。
+
+```sh
+npm ci
+npm test
+npm pack
+```
+
+`npm test` 先构建，再执行测试；`npm pack` 也会构建。产物是 `dsh-opencode-go-0.1.0.tgz`，包含 Host、Client、声明文件及 bundle 配置，不包含源码、测试或密钥。
+
+## 验证与维护
+
+```sh
+npm run typecheck
+npm test
+npm run verify:installed -- /path/to/isolated-consumer
+npm run verify:headless -- /path/to/isolated-consumer
+```
+
+后两项使用隔离目录中的已安装包。准备方式和实际验证记录见 [验证说明](docs/verification.md)。架构与代码来源见 [独立发布决策](docs/independent-package.md)和 [第三方声明](THIRD_PARTY_NOTICES.md)。
+
+测试使用本地模拟网关，不会发送真实 OpenCode Go API 请求。真实账号、额度和网关当前模型可用性须在配置自己的密钥后验证。
+
+## 卸载
+
+```sh
+dsh plugin --profile web remove dsh-opencode-go
+dsh plugin --profile headless remove dsh-opencode-go
+```
+
+重启相应应用后移除插件；如默认模型仍指向 `opencode-go`，请选择其他提供方。凭据和历史会话由 DSH 管理。
+
+## 发布
+
+维护者在有发布权限的 npm 账号下执行 `npm publish --access public`。发布前执行 `npm run typecheck`、`npm test` 和 `npm publish --dry-run`；发布后检查 registry 版本并用包名验证安装。每次更新递增版本号，已发布的版本不可覆盖。构建脚本从 `package.json` 读取 Client 模块 ID。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,3 @@
+# Third-party notices
+
+The adapter, settings UI, and `src/conversion/{context,stream,replay}.ts` derive from DeepSeek Harness, copyright (c) 2026 DeepSeek, under the MIT license included in LICENSE. The conversion modules are maintained in this package because the published DSH pi-ai package does not export its conversion helpers. Wire protocol implementations remain supplied by `@earendil-works/pi-ai`.

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: opencode-go
+      name: dsh-opencode-go

package/docs/independent-package.md

@@ -0,0 +1,13 @@
+# Independent package decision
+
+The plugin owns its Host adapter, Web settings entry, build, package manifest, activation layer, and tests. It consumes DSH through published npm exports. The source tree and build have no reference to a DSH checkout.
+
+The Host depends on DSH services through peer dependencies so Cordis service classes and LLM error identities remain shared with the application. The Client resolves React, the store, and UI primitives through the DSH module table. UI type packages are optional peers because headless installations do not mount those services; this project's development dependencies supply the types and test runtime libraries.
+
+The package's bundle inserts `id: opencode-go`. The original fork's `llm-opencode-go` row can be disabled by a profile patch. Plugin registration does not select the user's default model or replace another provider automatically.
+
+Published `@deepseek-ai/dsh-llm-pi-ai` versions `0.1.5-rc.2` and `0.1.6-alpha.1` do not export `./conversion`. This package therefore carries the request-history, stream, and replay conversion modules under `src/conversion`, with the upstream MIT license. It does not import unpublished files or bundle the whole adapter. Protocol transport remains implemented by pi-ai. Conversion maintenance is now this project's responsibility; a future public conversion library can replace these modules once published and tested.
+
+The build uses esbuild and lightningcss directly. Node imports stay external; the browser factory follows DSH's `window.__ModuleLoader__.load` format, embeds CSS Modules, and allows only the declared platform module imports. A package-level builder is sufficient for this single external plugin; extracting a general DSH build-tool package would require a separate release and is not a prerequisite for installation.
+
+The initial source derives from the user's working copy of DeepSeek Harness on branch `oh-my-dsh`, whose HEAD was `2c8555b323f3b49eac743bafd527f9f3238bf548`, including the uncommitted OpenCode Go settings changes present when this project was created. Runtime conversion modules retain their published behavior. The original checkout is unchanged by this extraction.

package/docs/verification.md

@@ -0,0 +1,50 @@
+# Verification
+
+Verified on macOS with Node.js 24.14.1 and npm-installed DSH 0.1.6-alpha.1. The plugin's dependencies came from npm, with no workspace aliases, symlinks into a checkout, or unpublished DSH exports.
+
+## Local checks
+
+- `npm run typecheck`: strict Host and Client programs against installed declarations.
+- `npm test`: builds both artifacts, then runs the adapter, catalog, configuration, settings, loader, image/history conversion, and browser-factory suites.
+- `npm pack`: builds a distributable tarball containing the bundle patch, Host ESM, browser module factory, type declarations, license, and documentation.
+
+The published UI primitives bundle references a missing source map. Vitest prints an upstream missing-map warning; it does not affect execution or assertions.
+
+## Isolated installed checks
+
+Create an empty temporary consumer directory and install the compatible CLI plus the tarball there:
+
+```sh
+npm init -y
+npm install --ignore-scripts @deepseek-ai/dsh@0.1.6-alpha.1 /absolute/path/to/dsh-opencode-go-0.1.0.tgz
+```
+
+Set `DSH_HOME` to that consumer's `home` directory before invoking its CLI. Install the bundle into the headless profile:
+
+```sh
+DSH_HOME="$PWD/home" ./node_modules/.bin/dsh plugin --profile headless add /absolute/path/to/dsh-opencode-go-0.1.0.tgz
+DSH_HOME="$PWD/home" ./node_modules/.bin/dsh --profile headless --dump-config
+```
+
+The tested pnpm installation initially stopped for dependency build-policy decisions. In the temporary profile's `pnpm-workspace.yaml`, set `allowBuilds` entries for `@google/genai` and `protobufjs` to `false`, preserving other generated fields, then repeat installation. This keeps those scripts disabled. The second installation completed and added the bundle to the profile manifest.
+
+From this plugin project, run:
+
+```sh
+npm run verify:installed -- /absolute/path/to/consumer
+npm run verify:headless -- /absolute/path/to/consumer
+```
+
+The installed smoke resolves the tarball's module and its shared DSH services from the consumer, mounts them through the actual Cordis Loader without an import mock, queries the catalog, streams three requests, checks session-header stability and isolation, checks authorization and User-Agent, and disposes the adapter to verify route removal. The fixture gateway binds an OS-allocated loopback port and closes it after the test.
+
+The headless smoke invokes the consumer's official `dsh --profile headless` launcher with a temporary profile overlay and a local gateway. It selects the OpenCode Go provider, completes a task with `standalone-ok`, checks the outgoing session header, and removes the temporary overlay. The test has a bounded child-process timeout and waits for teardown.
+
+## Browser verification
+
+The tarball was installed into a separate Web profile in the same temporary Harness home. The official `dsh web` server started on an OS-allocated port. Browser inspection confirmed the OpenCode Go settings entry, API-key field, advanced configuration, and a successful model-list response. Toggling the provider off and on updated the page through the Host settings service. No real API key was entered, and no real paid model completion was requested.
+
+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
+
+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/examples/headless.patch.yml

@@ -0,0 +1,4 @@
+- id: agent-default-model
+  config:
+    provider: opencode-go
+    model: deepseek-v4.1-flash

package/examples/migrate-from-fork.patch.yml

@@ -0,0 +1,3 @@
+# Disable the adapter bundled by the existing fork before enabling the external package.
+- id: llm-opencode-go
+  disabled: true

package/lib/build-info.json

@@ -0,0 +1,10 @@
+{
+  "clientExternals": [
+    "react",
+    "react/jsx-runtime",
+    "@deepseek-ai/cordis",
+    "@deepseek-ai/dsh-client-store",
+    "@deepseek-ai/dsh-client-ui-slots",
+    "@deepseek-ai/dsh-client-ui-primitives"
+  ]
+}