前言¶
DSH Desktop（DeepSeek Harness）的生態設計強調插件的靈活性。對於開發者而言，接入 OpenRouter 上的第三方模型（如 stealth/ox-alpha）通常需要手動配置協議、上下文參數與推理格式。雖然 DSH 內置了 llm-pi-ai 適配器，但官方模型列表並不包含 Ox Alpha。
本插件通過官方的 settings seam 直接寫入配置，實現一鍵接入。在此基礎上，它擴展了一個輕量級的 Model Hub 工具集，支持自定義模型、Provider 接入、健康檢查與模型發現。
插件簡介¶
名稱：ox-alpha-dsh
作者：change979666
類別：模型推理
許可：MIT
這是一個 DSH Desktop 的第三方模型接入插件。它主要完成兩件事：一是通過安裝命令自動配置 Ox Alpha（stealth/ox-alpha，支持 1,048,576 token 上下文與工具調用）的 Provider 與模型定義；二是提供一套工具（如 model_import、model_status），讓用戶可以自定義模型 ID 與顯示名、管理 Provider，並進行模型健康檢查與目錄搜索。
核心功能¶
根據已覈實的事實，該插件包含以下能力：
- 內置 Ox Alpha 定義：模型參數對照 OpenRouter 公開 API 覈實，確保配置準確。
- 自定義模型與顯示名：徹底解耦 API 使用的 Model ID 與 DSH 界面顯示名稱。
- 模型別名：支持爲模型設置別名，系統會自動生成兄弟路由（如
openrouter-kimi），方便快捷調用。 - 自定義 Provider：支持 OpenAI-Compatible、OpenAI Responses、Anthropic Messages 協議，可接入任意兼容服務。
- 健康檢查：提供路由、密鑰、上下文、視覺、推理狀態等多維度的檢查工具。
- 模型發現：可搜索 OpenRouter 公開的
/models目錄，並標記免費模型。 - 冪等安裝與回滾：安裝過程不覆蓋用戶已有配置；支持精確移除或恢復特定路由。
- 中英雙語輸出：工具界面與日誌輸出支持中文與英文。
安裝與啓用¶
安裝前需確保已安裝 DSH Desktop（自帶 dsh CLI）。該插件依賴 harness 內置的 llm-pi-ai 適配器，無需額外依賴。
# 安裝到指定 profile
dsh plugin --profile <profile> add github:change979666/ox-alpha-dsh
安裝完成後，DSH 會自動在 llm-pi-ai.providers.openrouter 路由下寫入 Ox Alpha 的定義。
配置與使用¶
1. 配置 OpenRouter 密鑰¶
插件寫入的是官方的 OpenRouter Provider 配置路徑。你需要在 DSH Desktop 中完成密鑰設置：
- 打開 DSH Desktop → 設置 → 模型 → 找到 OpenRouter 行。
- 粘貼你在 openrouter.ai/keys 創建的 API Key（格式通常爲
sk-or-v1-...）。 - 保存配置。
或者，也可以通過環境變量 OPENROUTER_API_KEY 提供密鑰。
2. 使用 Ox Alpha¶
配置密鑰後，在會話的模型選擇器中，選擇 OpenRouter 下的 Ox Alpha 即可開始對話。
使用 model_status 工具可確認當前狀態：
✓ openrouter key=OPENROUTER_API_KEY models:
· Ox Alpha <stealth/ox-alpha> ctx=1048576 vision=✓ reasoning=✓ out=131072
3. 導入自定義模型¶
讓 Agent 調用 model_import 工具，傳入 JSON 定義。這允許你接入非 Ox Alpha 的其他模型。
{
"provider": "openrouter",
"id": "moonshotai/kimi-k2",
"name": "我的 Kimi",
"aliases": ["kimi"],
"reasoning": true,
"tools": true
}
id：實際發送給 API 的 Model ID。name：DSH 界面顯示名稱（與 id 無關，可自定義）。aliases：可選，用於生成兄弟路由別名。- 其他字段：如
contextWindow、maxTokens、input（僅支持text/image）等。
4. 導入自定義 Provider¶
如果需要接入非 OpenRouter 的兼容服務，需創建 Provider 定義。編輯 plugin/index.js 頂部的 OVERRIDES_DIR 指向該目錄，然後重跑安裝命令。
{
"kind": "provider",
"id": "my-gateway",
"displayName": "My Gateway",
"baseUrl": "https://api.example.com/v1",
"api": "openai-completions",
"apiKeyEnv": "MY_GATEWAY_API_KEY"
}
之後，通過 model_import 將模型指向該 Provider。
注意事項與限制¶
- 輸入模態限制：插件定義中僅支持
text和image輸入。Audio/Video 模態的處理取決於 harness 底層能力，定義中會被拒絕並說明。 - 隱私與安全：
- Ox Alpha 是 OpenRouter 上的匿名模型，其 stealth 條款聲明會保留 prompt 與 completion（當前聲明不用於訓練）。
- 嚴禁在對話中包含公司代碼、
.env、數據庫密碼等敏感內容。 - 插件代碼從不讀取、存儲或打印密鑰明文，僅通過引用名判斷配置狀態。
- 數據訪問：
- 僅寫入
settings.yaml的llm-pi-ai.providers.*分節。 - 不發送項目文件、對話內容或環境變量。
- 不執行與功能無關的命令，不動態下載執行代碼。
- 僅寫入
- 別名限制：別名以兄弟路由形式實現，同一路由內不允許重複模型 id。
總結¶
ox-alpha-dsh 解決了 DSH Desktop 接入 OpenRouter 第三方模型的配置痛點，同時提供了完整的模型管理工具鏈。對於需要統一管理多模型、多 Provider 的開發者，這是一個實用的插件選擇。
