dsh-opencode-free
精选清单收录维护状态: 活跃x5427876/dsh-opencode-free
在 DeepSeek Harness 中使用 OpenCode Zen 免费模型,支持匿名访问,也可选填 API key。适合需要低成本 LLM 或免费模型的 dsh 工作流。
$ dsh plugin add dsh-opencode-free9
星标
4
Fork
JavaScript
语言
MIT
许可证
2026-09-22
创建于
2026-11-09
最近推送
README
dsh-opencode-free
English | 繁體中文
Use free OpenCode Zen models in DeepSeek Harness (DSH), without installing OpenCode or running a separate server. Anonymous access is the default; a Zen API key is optional.
- Works on the anonymous tier. Zen's free tier decides by request content
(tool declarations, an
<env>block, the TLS cipher list), not only by headers. The plugin shapes anonymous requests to match; see what the free tier checks, with dated measurements. - No built-in model list. The picker follows Zen's official model list: chat models whose declared prices are all zero. Refreshes are lazy, and a failed refresh keeps the last good list. Hide individual models from the detail page.
- Native in DSH. Models appear under OpenCode Zen Free with streaming, reasoning, tool calls, usage, and cancellation.
- Availability checks. The detail page shows probe results and latency. Quota limits and gate refusals do not remove models.
- One release, one DSH. Each release supports exactly one DSH version.
[!WARNING] This is an unofficial plugin, not affiliated with OpenCode or DeepSeek. Anonymous access sends OpenCode CLI-format identity fields from this plugin, not the official CLI, and has no third-party access guarantee: upstream changes may break it without notice. Anonymous quota is shared by callers behind the same egress IP.
The plugin runs with DSH's privileges and wraps process-wide HTTP entry points for the Zen inference endpoint. Read Security and limitations and DSH's safety notice before installing.
Quick start
Requirements
| Requirement | Version |
|---|---|
| DeepSeek Harness | 0.2.2-rc.1 (exact) |
| Node.js | ^22.19.0 or >=24.0.0 |
Each release supports exactly one DSH version. Do not ignore peer dependency
warnings; all four runtime peers are required. For an older release, read its
GitHub Release or run
npm view dsh-opencode-free@<version> peerDependencies.
Install
Check your DSH version, then install the pinned package:
dsh --version
dsh plugin --profile web add dsh-opencode-free@0.6.0
Replace web with your target profile. If already installed, use the update
command below instead of adding it again.
Verify the package and composed configuration:
dsh plugin --profile web list dsh-opencode-free --depth 0
dsh --profile web --dump-config
The package and the opencode-free plugin entry should each appear once.
Restart DSH (or wait for HMR), then choose a model under OpenCode Zen Free.
Update or remove
dsh plugin --profile web update dsh-opencode-free
dsh plugin --profile web remove dsh-opencode-free
Usage
See the usage guide for refresh intervals, probe results, cache recovery, and key verification.
The model picker shows the current catalogue rather than a fixed model list. Context sizes, image support, and reasoning levels come from each model's published metadata. Failed refreshes preserve the cached list; without a cache, the plugin falls back to pi-ai's bundled models.
On the plugin detail page, enable or hide models and use Probe now to check availability. Reading the model list also triggers a check once per local day. Checks send real inference requests and consume quota, one enabled model at a time. Results persist across restarts.
Only catalogue withdrawal or explicit model unavailability removes a model; gate refusals, exhausted quota, invalid keys, and network failures are inconclusive. See the catalogue decision rules for refresh, removal, and cache behavior.
Optional API key
Key priority: plugin config.apiKey → OPENCODE_API_KEY environment variable →
anonymous public. There is no login flow, and the plugin never switches to a
paid model automatically. A key changes authentication and quota, not the model
list; it does not guarantee access to an unavailable model.
For Desktop, configure the key in your profile's cordis.patch.yml rather than
relying on a shell environment:
- id: opencode-free
name: dsh-opencode-free
config:
apiKey: <your Zen key>
Reload DSH after changing the configuration. Keep the key and configuration private; never include them in issue reports.
How it works
The implementation is based on the maintainer's analysis of the OpenCode CLI
source code and request verification. It registers the
opencode-zen-free provider through DSH's PiAiAdapter and uses pi-ai transports
to call https://opencode.ai/inference/v1 directly. Tool execution stays in DSH.
Anonymous requests carry OpenCode CLI identity headers, a time-encoded session
ID, streaming, and substantive read and bash tool declarations. The minimum
upstream admission rules are not fully verified and may change. See the
protocol notes for sources and evidence limits.
What changes in model requests
These adaptations apply only to anonymous requests; keyed requests retain their original tools and prompts.
更多「集成与分享」插件
dsh-notification
作者 omdsh-dev
DeepSeek Harness 桌面通知插件,任务完成时提醒,可按结果与关键词规则控制。
dsh-lark-bot
作者 plutokeating
DeepSeek Harness (dsh) 接入飞书/Lark bot,扫码即用:流式卡片、项目工作区、并行任务、多角色 Agent、跨会话通知、对话内模型/密钥管理与安全网守护(dsh 崩溃后飞书仍可自救)。A scan-to-connect bridge bot connecting DeepSeek Harness (dsh) into Feishu/Lark: streaming cards, workspaces, parallel tasks, multi-role agents, cross-session notify, in-chat model/key management, and a safety-net guardian.
dsh-session-notification
作者 dingyi222666
为 Deepseek Harness 提供会话完成等四种状态的通知响应,支持浏览器提示和提示词
dsh-chatgpt-web
作者 wlv-zedd
将标准 ChatGPT Web 直接桥接到 DeepSeek Harness 的 DSH ChatGPT Free 插件。
