dsh-opencodeproxy

DSH（dsh web）插件：在设置页管理本地 opencode-free-proxy 服务。

代理本身会自动从 OpenCode Zen API 获取模型列表（big-pickle + 所有 -free 后缀模型），本插件负责服务的启停与状态展示。

设置页功能

功能	说明
切换开关	打开＝启动代理服务；关闭＝停止代理服务（外部启动的进程通过 /admin/shutdown 停止）
随 dsh 启动	dsh 启动时若开关为开启状态，自动拉起代理服务
切换启动时刷新	打开开关成功后自动向代理请求一次上游模型刷新
刷新模型列表	手动触发代理的 /admin/refresh-models，并展示当前模型
连通性测试	依次测 /health 与 /v1/models，显示延迟与模型数量

另有可配置项：代理目录（默认 D:\DevTime\gloal-workspace\opencode-free-proxy）与端口（默认 6446），运行中修改会自动重启服务。

安装

本插件通过 dsh plugin --profile web add <路径> 以 pnpm link:（符号链接）安装。源码目录里的 node_modules/@deepseek-ai/schemastery 是指向 profile 内真实包的目录联接（junction）。

从 GitHub 安装（克隆后指向本地路径）：

git clone https://github.com/infexpense/dsh-opencodeproxy.git
dsh plugin --profile web add /path/to/dsh-opencodeproxy
dsh web

本地开发时直接指向工作区路径亦可：

dsh plugin --profile web add D:\DevTime\gloal-workspace\dsh-opencodeproxy
dsh web

设置持久化在 ~/.dsh/settings.yaml 的 opencodeproxy: 段（enabled / autoStart / proxyDir / port）。

行为细节

• 端口上已有代理在跑（无论谁启动的）时打开开关：直接接管显示，不重复启动。
• dsh 退出时只清理本插件拉起的子进程；外部启动的代理不受影响。
• 停止外部代理需要读取代理目录下 api-keys.json 的 admin key。
• 代理进程启动后需要几秒完成上游模型抓取，期间 /v1/models 返回回退列表，稍后自动更新为实时列表。

本地开发说明

本包通过 dsh plugin --profile web add <路径> 以 pnpm link:（符号链接）安装。Node 按真实路径解析依赖， 因此源码目录里的 node_modules/@deepseek-ai/schemastery 是指向 profile 内真实包的目录联接（junction）， 删除它会导致 dsh 启动时插件加载失败（Cannot find package '@deepseek-ai/schemastery'）。 修改 lib/index.js 后需重启 dsh web；lib/client.js 由客户端加载。