dsh-opencodeproxy：DSH 插件：在設置頁管理本地 opencode-free-proxy 服務

dsh-opencodeproxy 是一個 DSH（dsh web）插件，用於在設置頁管理本地 opencode-free-proxy 服務。代理本身會自動從 OpenCode Zen API 獲取模型列表（big-pickle + 所有 -free 後綴模型），本插件負責服務的啓停與狀態展示。

基本信息¶

• 名稱：dsh-opencodeproxy
• 所有者：infexpense
• 分類：聯網工具
• 許可證：MIT

核心功能¶

1. 啓動/停止代理服務：通過設置頁開關控制代理進程。
2. 隨 DSH 啓動：若設置頁開關爲開啓狀態，dsh 啓動時會自動拉起代理服務。
3. 自動刷新模型列表：啓動成功後自動向代理請求一次上游模型刷新。
4. 手動刷新模型列表：手動觸發代理的刷新操作，並展示當前模型。
5. 連通性測試：依次測試 /health 與 /v1/models，顯示延遲與模型數量。
6. 接管現有進程：端口上已有代理在跑時打開開關，直接接管顯示，不重複啓動。

安裝與啓用¶

使用命令安裝插件：

dsh plugin --profile web add /path/to/dsh-opencodeproxy

典型用法¶

克隆倉庫後安裝：

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

行爲細節與注意事項¶

• 依賴處理：插件依賴 @deepseek-ai/schemastery。源碼目錄裏的 node_modules/@deepseek-ai/schemastery 是指向 profile 內真實包的目錄聯接（junction）。刪除它會導致 dsh 啓動時插件加載失敗。
• 外部代理管理：停止外部啓動的代理需要讀取代理目錄下 api-keys.json 的 admin key。
• 啓動延遲：代理進程啓動後需幾秒完成上游模型抓取，期間 /v1/models 返回回退列表，稍後自動更新爲實時列表。
• 自動重啓：可配置代理目錄（默認 D:\DevTime\gloal-workspace\opencode-free-proxy）與端口（默認 6446），修改配置會自動重啓服務。
• 代碼修改：修改 lib/index.js 後需重啓 dsh web。

相關資源¶

• 插件目錄
• GitHub 倉庫