配置模型

在 Web UI 中配置 DeepSeek、目录提供方与自定义 OpenAI 兼容端点，并正确启用图片输入

模型配置在 设置 → 模型 中完成。保存后会在下一次模型请求生效，无需重启 Web 服务器；已经发起请求的会话会继续使用记录在自己日志里的模型。

配置 DeepSeek

打开 设置 → 模型，在 DeepSeek 卡片中填入 API 密钥并保存即可。

密钥不会回显

模型页保存后只会收到脱敏后的凭据描述，不会再次读取或显示原始密钥。凭据保存在 $DSH_HOME/.credentials.yaml，设置文件中只保存对它的引用；不要把任一文件或环境变量中的密钥提交到代码仓库。

添加其他提供方

选择 添加提供方，从目录中选择例如 Anthropic 或 OpenAI 的提供方，输入对应密钥并保存。目录提供方已带有端点、协议和模型列表。

有些提供方不使用普通 API key：例如 Bedrock 需要 AWS 凭据与区域、Vertex 需要 ADC 项目、Azure 需要 api-version，Codex 使用 OAuth。只填写 API key 并不等同于完成这些提供方的认证。

添加自定义 OpenAI 兼容端点

公司网关、自建服务或目录中没有的提供方，选择 添加自定义提供方。填写：

小写的 Provider ID；
显示名称、Base URL 与 API 协议；
凭据，以及至少一个模型。

Provider ID 会被请求记录、已保存会话、默认模型和凭据引用使用，因此创建后不可改名。若要改名，新增一个 Provider 再删除旧的。可编辑的则包括显示名称、Base URL、协议、凭据和模型。

若端点支持 OpenAI 风格的 GET /models，可以在表单里用 获取可用模型 查询后再选择；这只更新草稿，保存前不会写入配置。没有模型发现接口的端点则手动填写模型。

图片与视觉模型

上游近期增强了多模态能力：v0.1.1-rc.1 增加 DeepSeek-V4-Flash-Vision-Exp，v0.1.1-rc.2 则让 DeepSeek 适配器优先使用 Files API 上传并复用图片，同时按模型要求自动缩放、转换格式。完整版本背景见近期动态。

手动添加的模型默认被视为仅文本，因为 Harness 无法自动询问任意端点的模态能力。要为自定义视觉模型启用图片输入，在 $DSH_HOME/settings.yaml 的对应模型上声明：

llm-pi-ai:
  providers:
    my-gateway:
      apiKeyEnv: GATEWAY_API_KEY
      api: openai-completions
      baseURL: https://gateway.example/v1
      models:
        - id: vision-preview
          input: [text, image]

若同一路由下手填的每个模型都支持图片，可以改在 provider 上设置 defaultInput: [text, image]。这只是对端点能力的声明，不会检测服务端是否真的支持图片；声明错误时，请求仍会被提供方拒绝。

图片随会话日志保留

模型拒绝某张已附加图片后，先修正模型的 input 声明或换用支持图片的模型，再新建会话；原图片仍在旧会话日志里，继续该会话可能会再次带上同一附件。

CLI / headless / 自动化环境变量

命令行与自动化场景可从环境变量读取 DeepSeek 配置：

变量	作用
`DEEPSEEK_API_KEY`	DeepSeek API 密钥
`DEEPSEEK_BASE_URL`	可选：通过 OpenAI 兼容代理访问时的 Base URL

例如 headless 模式：

DEEPSEEK_API_KEY=sk-your-key dsh --profile headless "总结这个仓库并指出主要模块"

常见问题

模型不响应：检查密钥、网络和模型选择；自定义网关还要检查协议和请求兼容性。
模型列表拉取 401：检查密钥；不提供 GET /models 的端点可手动填写模型。
图片发送前被拒绝：当前模型没有声明 image 输入；给自定义模型添加 input: [text, image]，或选择已声明视觉能力的模型。
自定义网关所有请求都失败：它可能不完全兼容 OpenAI 请求格式。上游模型指南提供 compat.supportsDeveloperRole 与 compat.maxTokensField 等兼容项；先以官方模型配置文档为准。

下一步

首次启动后的完整操作，看 Web GUI 快速上手。
需要可复现部署或升级，先看近期动态的版本固定与验证建议。