前言¶
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 的开发者，这是一个实用的插件选择。
