前言¶
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 交互桥接。
