前言¶

在 DeepSeek Harness（DSH）裏接 OpenRouter，常見做法是手寫 llm-pi-ai 配置：自己填 baseURL、模型列表和 API Key。OpenRouter 上游模型多、價格與上下文長度會變，維護一份靜態列表成本高；多把 Key（主備、不同預算）又需要多套路由，容易和平臺自帶的模型選擇器、憑證解析機制脫節。

下面介紹社區插件 dsh-openrouter-models（維護者 type53）。它在 DSH 裏提供一頁設置界面：拉取 OpenRouter 在線模型目錄，按名稱、價格等篩選，並把「一個命名賬戶 + 一把 Key + 所選模型子集」映射成一條原生 llm-pi-ai 路由，出現在對話底部的模型選擇器和 /model 中。

這是什麼¶

dsh-openrouter-models 屬於 DSH 社區插件目錄中的「模型推理」類擴展。源碼倉庫：github.com/type53/dsh-openrouter-models；目錄頁：skillhub.cn/plugins/type53/dsh-openrouter-models。

插件自述定位：OpenRouter 模型目錄與多 Key 路由器——在線目錄、價格過濾，且每個 API Key 對應一條 llm-pi-ai 路由。實現上刻意自包含：lib/ 下六個文件，無運行時依賴、無構建步驟，也不從 @deepseek-ai/* 導入。請求路徑上不自行處理流式響應或直連網絡，而是爲每個賬戶聲明一條普通 llm-pi-ai 路由，複用 Harness 已有的選擇器、默認模型、重試與憑證解析。

核心功能¶

在線模型目錄與篩選¶

在設置頁可瀏覽 OpenRouter 實時模型目錄（數量隨上游變化），支持按名稱 / id / 廠商搜索，按輸入或輸出價格（$/M tokens）過濾，勾選 僅免費，並按價格、上下文長度或名稱排序。

多賬戶與「一 Key 一路由」¶

可保存多把 OpenRouter API Key，各自命名爲賬戶（如 main、backup）。每個賬戶綁定自己挑選的模型子集後，生成一條原生路由，在界面中顯示爲 OpenRouter · <賬戶名>，路由 id 形如 openrouter-<account>。僅配置 Key、未綁定任何模型時，不會出現可用路由（llm-pi-ai 不接受空模型列表的手寫路由）。

與 Harness 配置的對應關係¶

每個賬戶在邏輯上對應一段 llm-pi-ai 提供方配置，例如賬戶 id 爲 main 時：

llm-pi-ai:
  providers:
    openrouter-main:
      displayName: OpenRouter · Main
      apiKeyEnv: OPENROUTER_KEY_MAIN
      api: openai-completions
      baseURL: https://openrouter.ai/api/v1
      compat: { supportsDeveloperRole: false, thinkingFormat: openrouter }
      models: [ ... ]

插件把派生路由寫入當前 profile 的 cordis.patch.yml（用戶設置層），下次請求即可生效；每次啓動時還會從賬戶文件重新同步。contextWindow、maxTokens、輸入模態、reasoningEfforts 等儘量從在線目錄填充；選型時也會存一份副本，以便目錄暫不可達時仍能正確聲明推理相關能力。刪除賬戶或清空其模型時，只移除本插件擁有的路由，不影響其他 llm-pi-ai 提供方。

數據與安全（摘要）¶

出站僅面向 openrouter.ai：公開目錄 /api/v1/models（不帶憑證），以及點擊 Verify key 時的 /api/v1/key。Key 爲只寫：頁面只回報是否已配置，校驗僅返回額度類元數據。主機路由掛在 Connection 已認證的 /api 通道上。許可證爲 MIT（見倉庫 package.json 與 README）。

安裝與啓用¶

環境要求（來自 README）：DeepSeek Harness 0.1.5-rc.2 或更新，Node.js 20+。

npm 包版本在 package.json 中爲 0.1.0；README 說明包發佈到 npm 後可在桌面端安裝，也可直接從 GitHub 或本地路徑安裝。

桌面端請先完全退出 DSH（含托盤），再執行下列命令之一。CLI 在應用運行時不會修改 desktop profile。

# 從 npm（包發佈後）
dsh plugin --profile desktop add dsh-openrouter-models

# 或直接從 GitHub
dsh plugin --profile desktop add github:type53/dsh-openrouter-models

# 或本地開發路徑
dsh plugin --profile desktop add link:/absolute/path/to/dsh-openrouter-models

若只使用 CLI profile（web、headless 或自定義名稱），將 --profile desktop 換成對應名稱即可。

安裝後需重啓 DSH——主機側插件在啓動時掛載。隨後在 Settings → OpenRouter 模型 打開配置頁（當前界面爲中文）。

社區目錄 skillhub.cn 與 DeepSeek / 幻方無官方從屬關係；安裝前建議自行查看倉庫源碼與 LICENSE，並知悉插件以當前 DSH 進程權限運行。

典型用法¶

按 README 推薦順序操作：

1. 創建賬戶並命名（建議 ASCII，純非 ASCII 名稱會回退爲 account id）。賬戶 id 會進入路由名。
2. 粘貼 Key 並保存。憑證只寫入 Harness 存儲，不進入插件 JSON，也不會回傳給頁面。需要時可點 Verify key 檢查額度。
3. 爲賬戶選型：在目錄中點選模型加入或移除；配合搜索、價格區間、僅免費與排序。
4. 在對話中使用：在會話底部模型選擇器裏，在 OpenRouter · <賬戶名> 下挑選已綁定模型。

適用場景與注意¶

適合：需要在 DSH 內快速瀏覽 OpenRouter 最新模型與價格、按賬戶拆分 Key 與模型集合，且希望走原生 llm-pi-ai 而非自寫流式適配器的開發者。

注意：

• 離開設置頁後，篩選條件不會持久化（README「Known limitations」）。
• 修改 lib/client.js 後刷新設置頁即可；修改主機側 lib/index.js 等需重啓 DSH。
• GitHub 倉庫當前星標爲 0（以目錄線索爲準）；功能與限制以 README 與 SECURITY.md 爲準。

結尾¶

dsh-openrouter-models 把 OpenRouter 的在線目錄和多 Key 管理收進一頁設置裏，用「每賬戶一條 llm-pi-ai 路由」對齊 DSH 既有推理棧。需要安裝入口與分類信息可看 SkillHub 目錄頁；實現細節與開發測試命令見 GitHub 倉庫。