前言¶
DSH 支持多種模型訂閱，每個提供商通常需要獨立的 OAuth 認證流程。管理這些不同的登錄平面會帶來額外的操作負擔。dsh-authmux 提供了一個統一的認證入口，將訂閱驅動的模型提供商整合到一個界面中。
插件介紹¶
這是一個由 Q-xuan 維護的 DSH 原生 OAuth 多路複用器插件。
它的核心價值在於：將訂閱驅動的模型提供商統一到一個緊湊的登錄平面，同時 DeepSeek Harness Core 繼續管理憑證、設置、模型路由和令牌刷新。
- 插件名稱：q-xuan/dsh-authmux
- 許可證：MIT
安裝與啓用¶
- 使用官方命令安裝插件：
dsh plugin --profile web add github:Q-xuan/dsh-authmux
- 啓動 DSH Web 界面：
dsh --profile web
核心功能¶
該插件通過以下機制實現統一的登錄平面：
- DSH 原生 OAuth 多路複用：在 Core 的
llm-pi-ai層面處理 OAuth 流程。 - 不使用私有的憑據存儲：授權憑證存儲在
dsh-credentials-local中，不存儲在插件本地。 - 不使用重複的模型適配器：模型請求直接保留在 Core 層面，不創建重複的適配器。
- Loopback RPC 通信：瀏覽器使用 loopback-fenced DSH Connection RPC 與服務通信。
- 憑證導入與路由：將有效憑證導入
llm-pi-ai/Core記錄，並啓用對應的模型路由。 - RPC 通道限制：AuthMux RPC 通道限制爲 loopback authority，僅限本地訪問。
使用方式¶
- 在 DSH Web 界面中，打開 Settings。
- 進入 AuthMux 選項。
- 完成登錄操作，從 DSH 的正常模型選擇器中選擇已啓用的模型。
遷移與兼容¶
插件啓動時會自動檢測 $DSH_HOME/simple-oauth.json。如果檢測到該文件，它會：
1. 將其中的有效憑證導入到 llm-pi-ai/Core 記錄中。
2. 啓用這些憑證對應的模型路由。
3. 將舊文件重命名爲 simple-oauth.json.migrated 作爲恢復備份。
安全與注意事項¶
- 數據隔離：OAuth 負載永遠不會進入瀏覽器。
- 刷新機制：令牌刷新在 Core 的序列化
modifyRecord()路徑中運行。 - 權限限制：模型工具無法調用授權表面。
- 網絡限制：RPC 通道嚴格限制爲 loopback authority。
- 合規提示：請根據每個提供商的條款和計費規則對待其訂閱。
結語¶
dsh-authmux 通過統一的登錄平面和 Core 層面的憑證管理，簡化了多模型訂閱的配置流程。插件本身不持有私鑰或存儲本地憑證，僅作爲 UI 交互橋接。
