dsh-web-search-opencode-go
中文说明
Fix DSH web_search when the search provider is routed through OpenCode Go / OpenCode Zen. The gateway rejects Anthropic Messages requests that do not carry x-opencode-session:
Error from provider (Console Go): Request is missing x-opencode-session and cannot be routed efficiently.
Please see https://opencode.ai/docs/go/#where-can-i-use-it
This repository is a drop-in patched fork of @deepseek-ai/dsh-web-search-deepseek for DeepSeek Harness. It automatically injects:
x-opencode-session — the current DSH agent session id (or a configured id / provider-wide UUID fallback), andx-opencode-client: dsh
so the built-in web_search tool works again without touching the official DSH installation.
TL;DR: store an OpenCode Go key in DSH → set web-search-deepseek.baseURL → run the installer → restart dsh web → use web_search as usual. Details: Usage.
What this changes
This is not a new CLI and not a new web_search command. After
installation and a dsh web restart:
- your existing
web-search-deepseek settings stay in place;
- every ordinary
web_search call from the agent goes through the patched provider;
- the patched provider adds the OpenCode Go / Zen routing headers automatically.
No profile patch, no extra tool, and no new prompt are needed.
The problem
DSH's built-in web search provider calls an Anthropic-compatible Messages endpoint:
POST {baseURL}/messages
If you point it at OpenCode Go:
web-search-deepseek:
baseURL: https://opencode.ai/zen/go/v1
the upstream provider sends only its normal headers (x-api-key, authorization, anthropic-version, …). OpenCode Go additionally requires a session-routing header and returns MissingSessionID / HTTP 400 without it. The native web_search_20250305 tool itself works on OpenCode Go; only the routing header was missing.
The fix
This fork keeps the official provider behavior and adds:
- automatic
x-opencode-session / x-opencode-client injection for opencode.ai endpoints;
- explicit
headers and sessionId config fields for other gateways;
- a safe installer that copies the patched package into the DSH web profile at the path the bundle already resolves:
~/.dsh/profiles/web/node_modules/@deepseek-ai/dsh-web-search-deepseek
The official package under your DSH installation (/opt/homebrew/..., npm -g, etc.) is never modified.
Quick start
Requires Node.js 20+ (or just a working dsh + pnpm) and an existing DSH web
profile. There are two install paths; Option A is the one the plugin market
uses.
Option A — install as a DSH bundle (recommended)
dsh plugin --profile web add github:leeyoung1/dsh-web-search-opencode-go
# restart dsh web
The package declares dsh.bundle, so dsh plugin automatically adds it to
dsh.profile.bundles. Its cordis.patch.yml disables the official
web-search-deepseek row and inserts this patched provider in its place.
After the npm package is published, the command gets shorter:
dsh plugin --profile web add dsh-web-search-opencode-go
# restart dsh web
Option B — drop-in copy (offline / no pnpm)
This copies the package into the profile's @deepseek-ai slot, shadowing the
official package. It needs no package manager and works on macOS, Linux, and
Windows.
macOS / Linux:
git clone https://github.com/leeyoung1/dsh-web-search-opencode-go.git
cd dsh-web-search-opencode-go
./mount.sh
# restart dsh web
Windows (PowerShell or cmd):
git clone https://github.com/leeyoung1/dsh-web-search-opencode-go.git
cd dsh-web-search-opencode-go
node .\bin\dsh-web-search-opencode-go.mjs
# restart dsh web
mount.sh is a POSIX convenience wrapper around the same Node installer.
Non-default profile or DSH home
macOS / Linux:
DSH_PROFILE_DIR=/path/to/profile ./mount.sh
# or: DSH_HOME=/path/to/dsh-home ./mount.sh
Windows:
$env:DSH_PROFILE_DIR = "C:\path\to\profile"
node .\bin\dsh-web-search-opencode-go.mjs
Useful flags (Option B)
--dry-run show what would change, without touching the profile
--uninstall move the patched copy aside and restore the previous entry
--help usage and environment variables
Then restart dsh web. The running process must be restarted because DSH loads plugins at boot.
Usage
1. Store the OpenCode Go API key in DSH
Open Settings → Models and store your OpenCode Go key under either:
DEEPSEEK_API_KEY (the provider default), orOPENCODE_GO_API_KEY (then set apiKeyEnv: OPENCODE_GO_API_KEY in the config below).
The key is resolved on every search, so rotating it does not require a restart.
2. Point the built-in web search provider at OpenCode Go
In ~/.dsh/settings.yaml:
web-search-deepseek:
baseURL: https://opencode.ai/zen/go/v1
apiKeyEnv: DEEPSEEK_API_KEY # default; OPENCODE_GO_API_KEY also works
model: deepseek-v4-flash # default
3. Install the patch and restart
Follow Quick start above, then restart dsh web.
4. Use it normally
There is no new command. Ask the agent in natural language:
搜索一下 DeepSeek Harness GitHub 的最新信息
or have it call the tool directly:
web_search: DeepSeek Harness GitHub
Expected: normal results; no MissingSessionID error. Each auxiliary search is
recorded in the DSH session log as web/deepseek-search-llm-request.
Configuration
Your existing settings continue to work:
web-search-deepseek:
baseURL: https://opencode.ai/zen/go/v1
apiKeyEnv: DEEPSEEK_API_KEY # default; OPENCODE_GO_API_KEY also works
model: deepseek-v4-flash # default
Optional new fields:
web-search-deepseek:
baseURL: https://opencode.ai/zen/go/v1
headers:
x-opencode-client: dsh # override any automatic header
sessionId: my-fixed-session # explicit OpenCode routing session
Header precedence:
- explicit
headers['x-opencode-session']
sessionId config- current DSH agent session id
- provider-wide UUID fallback (programmatic calls outside an agent turn)
x-opencode-client defaults to dsh and can also be overridden.
How installation works
There are two supported install paths:
- DSH bundle (Option A):
package.json declares
dsh.bundle.patch = ./cordis.patch.yml. dsh plugin add installs the package
and adds it to dsh.profile.bundles; the patch disables the official
web-search-deepseek row and inserts this provider under the same settings
namespace (web-search-deepseek) and provider id (deepseek-official).
- Drop-in copy (Option B): the Node installer copies this package to
<profile>/node_modules/@deepseek-ai/dsh-web-search-deepseek. Node resolves
that path before the shared profiles/node_modules, so the existing official
bundle row loads the patched provider instead.
Either way you keep your existing web-search-deepseek settings; no settings
rewrite is required.
For the drop-in copy, if the destination already exists it is moved aside to
dsh-web-search-deepseek.unpatched-<timestamp> instead of being deleted. After
a DSH upgrade or a pnpm/npm reinstall that restores the official package,
run the installer again and restart dsh web.
Uninstall / rollback
Use the cross-platform uninstaller on any OS:
npx dsh-web-search-opencode-go --uninstall
# or, from a clone:
node ./bin/dsh-web-search-opencode-go.mjs --uninstall
# restart dsh web
It moves the patched copy to dsh-web-search-deepseek.uninstalled-<timestamp>
and restores the most recent .unpatched-* entry when one exists. If no backup
exists, Node resolves the official package again.
Manual equivalent:
-
macOS / Linux:
rm -rf ~/.dsh/profiles/web/node_modules/@deepseek-ai/dsh-web-search-deepseek
# restart dsh web
-
Windows PowerShell:
Remove-Item -Recurse -Force "$env:USERPROFILE\.dsh\profiles\web\node_modules\@deepseek-ai\dsh-web-search-deepseek"
# restart dsh web
Compatibility
- DSH
0.1.x line (verified on 0.1.1-rc.2).
- The patched provider is API-compatible with
@deepseek-ai/dsh-web-search-deepseek@0.1.1-rc.2.
- OpenCode Go / OpenCode Zen Anthropic-compatible endpoint.
- Node.js 20+.
- macOS, Linux, and Windows. The installer copies files and uses no symlinks
or administrator-only APIs; CI runs the installer test on all three OSes.
Troubleshooting
| Symptom | Cause | Fix |
|---|
Still MissingSessionID after install | dsh web was not restarted | Restart dsh web. |
WEB_PROVIDER_CREDENTIAL_MISSING | No key stored for DEEPSEEK_API_KEY | Store it in DSH Settings → Models, or set apiKeyEnv: OPENCODE_GO_API_KEY. |
DeepSeek search request failed / HTTP 401/403 | Wrong key for the selected endpoint | Use an OpenCode Go key for opencode.ai, or point baseURL back at DeepSeek's official endpoint with a DeepSeek key. |
| Provider unavailable | Unparseable baseURL | Use the full base that includes /v1, e.g. https://opencode.ai/zen/go/v1. |
| Search broke after a DSH upgrade | The profile restored the official package | Re-run the installer (./mount.sh, npx dsh-web-search-opencode-go) and restart. |
EPERM / EBUSY while installing on Windows | dsh web is running and the profile files are locked | Stop dsh web, run the installer again, then restart. |
Development
npm test # header + cross-platform installer tests (dependency-free)
npm run link-deps # optional: link official packages for full-provider imports
node ./bin/dsh-web-search-opencode-go.mjs --dry-run
Tests only import lib/headers.js, which has no dependencies. link-deps is
only needed when importing the full lib/index.js provider in a clone; the
installed copy resolves the official packages through the profile's
node_modules parents.
Repository metadata (for search)
Suggested GitHub repository name, description, and topics:
- Name:
dsh-web-search-opencode-go
- Description:
Fix DSH web_search through OpenCode Go / Zen: auto-inject x-opencode-session. Drop-in patched fork of @deepseek-ai/dsh-web-search-deepseek.
- Topics:
dsh, deepseek-harness, deepseek, opencode, opencode-go, opencode-zen, web-search, websearch, dsh-plugin, x-opencode-session, MissingSessionID, cross-platform, windows, macos, linux
See docs/publishing.md for ready-to-run gh and npm commands.
License and attribution
MIT. The provider implementation is derived from
@deepseek-ai/dsh-web-search-deepseek
by DeepSeek, also MIT-licensed. The original license is preserved in LICENSE.
This is an unofficial community patch and is not affiliated with DeepSeek or OpenCode.
