dsh-plugin-opencode-local:在 DeepSeek Harness 里使用本机 OpenCode 模型
mateenahmed737/dsh-plugin-opencode-local
为 DeepSeek Harness 接入本地 OpenCode CLI 的模型提供商,复用你已登录的全部 OpenCode 模型,凭据与流量均留在本机。
dsh-plugin-opencode-local 是一个 DSH plugin,为 DeepSeek Harness 增加「OpenCode (local)」模型提供方。它把请求全部交给本机已安装的 OpenCode 进程处理,因此你在 OpenCode 中登录过的每个提供方下的模型都能直接出现在模型选择器里,凭据始终留在 OpenCode 自己手中。插件会在首次请求时自动拉起本地服务并做健康检查,崩溃后重启,同时把 shell、文件编辑等受限工具纳入 DSH 的审批流程,适合希望统一管理本地模型来源的开发者。
如何安装
dsh plugin --profile <your-profile> add dsh-plugin-opencode-local--profile 换成你本机实际使用的 profile 名(ls ~/.dsh/profiles/ 可查看目录名):浏览器版通常是 web,桌面版通常是 desktop 或 desktop-NNN。
- 分类
- 模型与推理
- 平台
- DSH Plugin
- 作者
- mateenahmed737
- 分发方式
- 插件
dsh-plugin-opencode-local 核心特性
dsh-plugin-opencode-local 仓库简介
它是做什么的?
它是 DeepSeek Harness(DSH)的 OpenCode 本地模型接入插件(DSH plugin),在 DSH 里新增一个「OpenCode (local)」模型提供方。它解决的是「想用本机 OpenCode 里已登录的全部模型、却找不到对应 DSH 插件」的问题:所有请求都交给你自己安装的 OpenCode 进程处理,插件不读取、不复制、不转发任何凭据,也不访问 opencode.ai 或其他外部主机。核心能力是自动拉起本地 OpenCode 服务、按 provider/model 列出可用模型,并把受限工具调用接入 DSH 的审批流程。
核心功能
- 本地模型全量接入:列出你在 OpenCode 中已登录的每个提供方下的所有模型,外加 OpenCode 自带的免费模型,统一以 provider/model 形式出现在模型选择器中。
- 凭据零接触:插件从不读取或转发 auth.json 等凭据,登录状态完全由 OpenCode 自己维护。
- 共享本地服务:首次请求时自动以 127.0.0.1 启动一个 opencode serve 实例,等待监听就绪并做健康检查,崩溃后自动重启。
- 工具调用受控:shell、文件编辑、网页抓取等受限工具默认走 DSH 的审批提示,可配置为免询问放行或直接拒绝。
- 可调设置项:支持自定义可执行文件路径、复用已有服务地址与密码、会话工作目录、单轮超时、模型列表刷新间隔、是否显示工具活动等。
- 兼容性明确:适配 DSH 0.2.x 的桌面端与 CLI/headless 配置,要求 OpenCode 1.14.19 及以上(含 2.x),Windows 已端到端验证、Linux 走 CI。
怎么使用这个插件?
先在机器上装好 OpenCode 并确认能运行,付费提供方需完成登录,免费模型无需登录。随后在 DSH 桌面端的插件管理器或 CLI 配置中加入该插件,重启 DSH,打开模型选择器,在「OpenCode (local)」下挑一个模型即可开始对话。需要调整行为时,进入设置里的模型页编辑该提供方,或修改配置中的对应字段,例如指定 opencode 可执行文件路径、复用已运行的服务、设置会话工作目录或单轮超时。若找不到 opencode,首次请求会提示如何安装或在哪里配置路径。
报错怎么排查?
- 提示找不到 opencode:说明可执行文件不在 PATH 中,按提示安装 OpenCode,或在设置里把 binaryPath 指向实际可执行文件。
- 模型列表为空或过期:确认 OpenCode 中已登录相应提供方,必要时调小 modelRefreshSeconds 让列表更快重新读取。
- 受限工具被拒绝:检查 askForApproval 与 allowRestrictedTools 两项设置,前者关闭时受限工具会被直接拒绝。
- 想复用已有服务却连不上:确认 serverUrl 与对应版本的密码变量一致(1.x 与 2.x 的密码环境变量名不同)。
本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准:mateenahmed737/dsh-plugin-opencode-local。插件是安装时就在你机器上运行的第三方代码;收录不代表背书——安装前请自行审阅源码。
DSH Plugin 常见问题
