dsh-models-plus：DeepSeek Harness 本地迴環路由代理插件

在 DeepSeek Harness 的開發流程中，外部客戶端往往需要通過特定的 API 協議直接訪問本地模型。手動配置反向代理不僅繁瑣，還容易產生版本兼容問題。dsh-models-plus 插件旨在解決這一痛點，通過官方擴展插槽，爲 Harness 提供一個開箱即用的本地路由代理服務。

這是一個由用戶 gongstudent 維護的插件，隸屬於“聯網工具”類別。它利用 DSH 的官方擴展機制，在本地運行一個監聽迴環地址（127.0.0.1）的代理服務，負責將 OpenAI 和 Anthropic 格式的請求轉發給 Harness 內部配置的模型提供者。

核心功能¶

• 本地迴環路由代理：提供一個默認端口爲 8317 的本地代理服務，僅綁定 127.0.0.1，確保安全性。
• 雙向協議橋接：支持 OpenAI (/v1/chat/completions) 和 Anthropic (/v1/messages) 協議，允許外部客戶端（如 Cline、Claude Dev、Cursor、LibreChat）無縫連接。
• 零衝突 UI 擴展：通過官方 settings.models.footer 插槽集成，不替換核心包，避免版本更新導致的功能失效或界面空白。
• 健康檢查與路由發現：提供 /health 接口，用於檢測服務狀態及可用路由。

安裝與啓用¶

1. 安裝插件。根據當前使用的 Harness 檔案（Web 或 Desktop）選擇對應命令：

    dsh plugin --profile web add -w github:gongstudent/dsh-models-plus

或

    dsh plugin --profile desktop add -w github:gongstudent/dsh-models-plus

2. 啓動 Harness：運行 dsh web。
3. 在界面中導航至 Settings -> Models，插件提供的“Local Route Proxy”卡片將顯示在設置頁面的底部。

典型用法¶

啓動後，使用 curl 驗證服務是否正常：

curl http://127.0.0.1:8317/health

正常響應示例：

{"status":"ok","host":"127.0.0.1","routes":["deepseek","openai","anthropic"],"endpoints":["/v1/chat/completions","/v1/responses","/v1/messages"]}

適用場景與注意¶

• 適用場景：需要在本地運行模型，同時希望外部工具能像調用官方 API 一樣通過本地端口進行對話的開發者。
• 重要注意：
  • 該插件僅監聽本地迴環地址（127.0.0.1），無法從局域網內的其他機器訪問。
  • 插件不存儲密鑰，請求會直接使用 Harness 上游配置好的憑據。
  • 不包含任何遙測數據收集功能。
  • 兼容 Web 和 Desktop 檔案（v0.1.x / v0.2.x 及更高版本）。

dsh-models-plus 通過插件化的方式，讓本地路由代理變得輕量且穩定。關於更多細節，請查閱插件目錄或GitHub 倉庫。