dsh-opencode-gateway
DeepSeek Harness 的 OpenCode 网关提供商：一个路由指向本地 opencode-api-plugin 网关，另一个路由指向内联的 opencode2api 本地代理（Zen 免费层），并提供精选模型注册表和模型管理器设置页面
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:EDDY597/dsh-opencode-gateway#7267fb2dbf4dae5e8acd45b57b5535d89042f9ffOpencode Gateway 以 dsh-opencode-gateway 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
A DeepSeek Harness (DSH) plugin that wires the local opencode ecosystem into DSH's model menu with two provider routes:
| Route | Endpoint | What it carries |
|---|---|---|
opencode-gateway | http://127.0.0.1:8787/v1 (the local opencode-api-plugin gateway) | Everything the gateway aggregates: the OpenCode Go subscription (reading the machine's local opencode login state), OpenCode Zen, and any custom upstreams in gateway.config.json |
opencode-free | in-process loopback proxy (default http://127.0.0.1:10102/v1) | The inlined opencode2api port driving the machine's own opencode serve backend for the Zen free tier — no gateway process needed |
By design this plugin ships no usage panel; quota display lives in the gateway's /api/usage and the tray.
off and refuses none; grok/muse serve /responses only, which the gateway converts transparently).opencode serve when absent (first init ~10–20 s) and reclaims only a backend it spawned; one reused from the gateway stays with the gateway.opencode auth login is recommended (better model list and limits, anonymous works too)start-gateway.cmd, start-tray-hidden.vbs or the tray)Open the app, choose Plugins in the sidebar, click Add plugin and paste a local path:
D:/Agent/dsh-opencode-gateway
or a Git spec (once published):
github:<owner>/dsh-opencode-gateway#v0.1.0
Click Install, wait for pnpm, then click Enable now.
pnpm dsh plugin --profile web add "D:/Agent/dsh-opencode-gateway"
The installer runs a full compatibility sandbox install, which can take many minutes on this machine; hand-composing the profile is faster — see the Chinese README.
The plugin installs no settings UI; configuration lives in the composition layer (the profile's cordis.patch.yml, ~/.dsh/profiles/desktop/ on the desktop app) and takes effect on restart:
- id: opencode-gateway
name: dsh-opencode-gateway
config:
gateway:
provider: opencode-gateway
displayName: OpenCode Go
baseURL: http://127.0.0.1:8787/v1
apiKeyEnv: OPENCODE_GATEWAY_KEY
hiddenModels: ["free/"]
models: []
free:
provider: opencode-free
serverUrl: http://127.0.0.1:10001
proxyPort: 10102
opencodePath: opencode
manageBackend: true
zenApiKeyEnv: OPENCODE_ZEN_API_KEY
disableTools: true
internalAllowedTools: [webfetch, bash, websearch]
DSH settings gain an OpenCode Gateway section (plugin v0.2.0+): one card per route (OpenCode Go / OpenCode Free) managing that route's model menu.
/v1/models, OpenCode Free via the inlined proxy's backend listing).models — the menu falls back to the shipped list (or the composition models, when configured).Precedence: saved settings models (even an empty array) > composition cordis.patch.yml models > shipped defaults. Saved entries that carry only id/name/context are enriched by the host from the measured registry (missing effort vocabulary and vision flags; an explicit reasoningEfforts: false is never touched). Backend-structural fields (serverUrl / proxyPort / opencodePath …) ask for a restart when changed on the page; the model menu applies live.
~/.dsh/.env)| Variable | Meaning |
|---|---|
OPENCODE_GATEWAY_KEY | The gateway's Bearer token; any non-empty value works while the gateway runs without a token (a missing credential fails before network I/O with MISSING_CREDENTIAL) |
OPENCODE_ZEN_API_KEY | Passed to the backend as OPENCODE_API_KEY to unlock paid models; falls back to the local opencode login state (v0.1 reads the process environment only, not the credentials seam) |
models[] entries| Field | Meaning |
|---|---|
id | The model id the endpoint accepts, forwarded verbatim |
name | Selector label |
contextWindow / maxTokens | Capacities; maxTokens also becomes that model's per-request default output cap |
reasoningEfforts | false declares a non-reasoning model; a dict {level: wire spelling}, where only off may be empty (send nothing) |
input | ["text","image"] declares image input |
PiAiAdapter reads the current profiles snapshot once per operation; changed discovery facts atomically replace the registration — no restart, no disturbed in-flight stream.Request; responses stream back out. A mid-stream drop after the headers are flushed destroys the socket instead of throwing ERR_HTTP_HEADERS_SENT into the server callback.retryPolicy defaults to normal/maxRetries 0 — retries belong to the gateway (subscription routes) or the inlined proxy (free route), never both.reasoning_content, reasoning + reasoning_details, and inline think tags all flow through pi-ai's delta parser into DSH's reasoning-delta collapse (the gateway strips Go routes' inline tags server-side)./api/usage + the tray.zenApiKeyEnv reads the process environment only; stored credential references are not resolved yet.pnpm install
pnpm run build # tsdown → lib/index.js (Host, ESM); tsc -b → lib/types
pnpm run test # vitest
The lib/ build output is committed alongside the sources (git installs need no build) — run pnpm run build before committing code changes.
MIT © 2026 — contains the embedded opencode2api implementation ported from opencode-api-plugin (itself ported from TiaraBasori/opencode2api, MIT; license copy at assets/LICENSE.md), and the OpenCode Go registry measurements from dsh-protocom-api (MIT).