DeepSeek Harness

先按准备 API Key设置 OPTIWAVES_API_KEY。这里配置的是 DeepSeek Harness 的通用 provider，模型使用 OptiWaves auto。

1. 找到 settings.yaml

系统	默认位置
macOS / Linux	`~/.dsh/settings.yaml`
Windows	`%USERPROFILE%\.dsh\settings.yaml`

如果设置了 DSH_HOME，编辑该目录下的 settings.yaml。以下配置要求安装的 Harness 包含 llm-pi-ai 适配器。

2. 配置连接与模型

settings.yaml

llm-pi-ai:
  providers:
    optiwaves:
      displayName: OptiWaves
      apiKeyEnv: OPTIWAVES_API_KEY
      api: openai-responses
      baseURL: https://api.optiwaves.app/v1
      models:
        - id: auto
          name: OptiWaves Auto
          contextWindow: 500000
          maxTokens: 65536
          input: [text, image]
          reasoningEfforts:
            off: null
            low: low
            medium: medium
            high: high

agent-default-model:
  provider: optiwaves
  model: auto
  reasoningEffort: medium

apiKeyEnv 是密钥引用名，真正的值由当前环境提供。不要在 settings.yaml 中填写完整密钥。

optiwaves 是这里设置的提供方名称，默认模型也应选择这个提供方。openai-responses 指定连接协议，input 设置允许发送文字和图片。

3. 启动并验证

在已设置密钥的终端中运行：

dsh web

打开终端显示的本机地址，在模型选择器中选择 OptiWaves / Auto，发送一个简短的文本问题。收到回答后即可继续提问。

4. 切换模型

新增模型时，在 llm-pi-ai.providers.optiwaves.models 中添加对应描述，再修改 agent-default-model.model 或在界面中选择。上下文、最大输出与图片能力应按模型与价格填写。

需要 Auto Fast 时，新增 id: auto-fast 的条目，使用 Auto 相同的窗口和输入设置，无需另设思考档位。

常见问题

情况	检查
找不到 `dsh`	先按 DeepSeek Harness 安装说明安装客户端
`MISSING_CREDENTIAL`	`apiKeyEnv` 名称对应的变量没有传入运行 Harness 的进程
模型未出现	检查 `llm-pi-ai` 是否已加载、YAML 缩进，以及默认提供方名称是否为 `optiwaves`
看图在客户端被拒绝	检查当前模型条目的 `input`，不要仅配置全局文字模型

参考 Harness provider 指南和 llm-pi-ai 配置参考。返回客户端选择。

本地记忆

API 接通后，可用 OptiWaves CLI 为这个客户端配置本地记忆：

optiwaves memory --client deepseek-harness

重启客户端后，用一次保存和一次新会话召回检查结果。具体路径与限制见本地记忆。