首次配置直接新增 xiurouter provider。已经存在同名 provider 时编辑原连接，不要创建重复项。模型由 DSH 从 /v1/models 获取，不需要先在 XiuRouter 页面预选。
选择配置方式
- 首次配置：在 Settings → Models 新增
xiurouter。 - 替换已有：编辑已有
xiurouter，或保留原 provider 后新增 XiuRouter。 - 对话协助：不提供。凭据和 provider 由 DSH 设置界面保存。
前置条件
- DSH Web UI 可以正常打开。
- 已创建一把 DSH 专用 XiuRouter API Key。
- 已为 DSH 选择明确的工作区和最小必要权限。
在界面中配置
- 打开 Settings → Models。
- 已有
xiurouter时打开它；没有时选择 Add a custom provider。 - Provider ID 使用
xiurouter。该 ID 会被会话和凭据引用，改名需要新建 provider。 - Base URL 填
https://router-api.xiu.ai/v1。 - API protocol 选择
OpenAI Chat Completions。 - 保存 XiuRouter API Key。
- 使用 Fetch available models 读取这把 Key 可访问的模型，并选择至少一个。
- 保存后，在模型选择器中选中 XiuRouter 模型并新建会话。
DSH 保存的 Key 是只写凭据，设置页不会再次返回明文。不要把 Key 写进工作区文件或插件配置。
验证
- 先发送一个短文本请求，确认会话使用
xiurouter和预期模型。 - 再让 DSH 只读取一个不含敏感信息的文件并总结，不允许修改。
- 确认 XiuRouter 控制台“检查实际请求”出现对应模型、接口和成功状态。
- 最后才扩大到文件修改、图片输入或更高工作区权限。
手动添加的模型默认按纯文本处理。只有目标模型和当前服务来源都已验证图片输入时，才在 DSH 中声明 input: [text, image]。
常见失败
| 现象 | 处理 |
|---|---|
Fetch available models 返回 401 |
检查保存的 Key；也可以先手动添加精确模型 ID |
UNKNOWN_MODEL |
在 xiurouter provider 中加入同一模型 ID，再新建会话 |
| 普通回复成功但工具失败 | 换用已验证工具调用的模型，并保持工作区权限不变排查 |
回滚
在 Settings → Models 切回原 provider 和模型。确认新会话恢复原路由后，删除 xiurouter provider，并撤销 DSH 专用 XiuRouter API Key。
来源与核对日期
内容核对于 2026-08-31。DeepSeek Harness 收到完整回复并出现对应使用记录后，基础接入才算完成；工具调用请在实际工作区使用目标模型验证。