DeepSeek Harness Desktop 用配置文件切换本地与远程模型部署环境

DeepSeek Harness Desktop 在开发时通常要接本地模型做快速验证，部署或联调又要切到远程模型地址。来回改配置文件里的 base_url 和密钥，改完还要确认是否真生效，操作成本不高但容易错。处理方向是：把配置按环境拆成 local 和 remote 两组，用环境变量或启动参数选择当前组，切换后通过日志确认实际加载的地址。

适用场景：桌面端需要在本机模型与远程 API 间反复切换，且不想每次手改文件。操作动作：把 base_url、密钥及模型名按 local/remote 拆到配置块，用环境变量 DEEPSEEK_MODE 或 `--config` 参数指向对应文件。验证方式：启动后核对日志中打印的服务地址。风险边界：远程服务商地址和密钥需按实际接入填写；本地配置若暴露在共享目录，注意权限。

拆分本地与远程两套配置内容

先区分哪些字段必须跟着环境变，哪些可以共用。以常见的 OpenAI 兼容接口配置为例，base_url、api_key、model 三个字段在本地和远程几乎一定不同：本地通常是 127.0.0.1 加端口，不用真实密钥；远程则是服务商地址和专属密钥。而 temperature、max_tokens、timeout 这类推理参数，以及系统提示词模板，可以固定为同一套。

# local.yaml
base_url: http://127.0.0.1:11434/v1
api_key: sk-local
model: deepseek-coder
temperature: 0.7
max_tokens: 2048

# remote.yaml
base_url: https://api.example.com/v1
api_key: sk-remote-xxxx
model: deepseek-chat
temperature: 0.7
max_tokens: 2048

两个区块的差异集中在 base_url、api_key 和 model，其余字段保持一致。实际接入时，把 remote 的地址和密钥替换成服务商提供的值，不要照抄示例。

定义环境变量来区分运行模式

不想维护两份文件时，可以用一个模式变量让同一份配置读到不同的内容。常见做法是定义 DEEPSEEK_MODE，取值为 local 或 remote。配置文件里写成模板，启动前由程序或 dotenv 展开：

# config.yaml
mode: ${DEEPSEEK_MODE}
endpoints:
  local:
    base_url: http://127.0.0.1:11434/v1
    api_key: ${LOCAL_API_KEY}
  remote:
    base_url: ${REMOTE_BASE_URL}
    api_key: ${REMOTE_API_KEY}

程序加载时先读 mode，再从 endpoints.local 或 endpoints.remote 取连接信息。也有的配置器直接支持字段级别占位符，比如 base_url: ${DEEPSEEK_BASE_URL}；这种情况下可以不使用 mode，直接给 local 和 remote 分别设置不同环境变量即可。

DeepSeek Harness Desktop 用配置文件切换本地与远程模型部署环境

环境变量模板方式的前提是 Desktop 的配置加载逻辑支持环境变量插值或条件块选择。如果不支持，就不能把配置写成这种模板，只能退回多文件方案。

用启动参数指定配置文件的路径

当 local 和 remote 已经拆成两个独立文件时，切换环境最直接的方式是启动参数指定文件路径。大部分桌面工具会提供 `--config` 或等价参数。可以先在终端里确认一下帮助信息：

deepseek-harness-desktop `--help`

如果支持 `--config`，启动命令可以这样写：

deepseek-harness-desktop `--config` ./profiles/local.yaml
deepseek-harness-desktop `--config` ./profiles/remote.yaml

也可以把文件路径封装成脚本或快捷方式，避免每次敲长路径。如果工具只认一个固定配置文件位置，可以用软链接切换：先创建一个 current.yaml，让它指向实际要用的配置。例如在 Linux 或 macOS 下：

ln -sf ./profiles/remote.yaml ./current.yaml
deepseek-harness-desktop `--config` ./current.yaml

软链接的好处是切换时只需要改链接目标，不需要改文件内容。

切换后检查日志中的实际生效地址

切换配置以后，最怕程序没读新文件，或者读到了缓存里的旧配置。确认方法不是打开配置文件再看一眼，而是看启动日志中打印的服务地址。典型日志行类似：

Using model endpoint: http://127.0.0.1:11434/v1

或

Base URL: https://api.example.com/v1

注意这个地址应该出现在启动早期，通常在加载配置后、建立连接前。启动顺序一般是：解析命令行参数 -> 读取配置文件 -> 展开环境变量 -> 拼接出最终地址 -> 打印日志 -> 建立连接。如果日志里还是旧地址，优先检查三处：一是启动参数里的路径是否指向了正确的文件；二是环境变量是否覆盖了配置中的值；三是程序是否有缓存或默认配置覆盖了用户配置。处理时可以先清掉相关环境变量，用绝对路径启动，排除干扰。

在切换环境前，最好先完全退出旧进程再启动新进程，避免旧进程的端口或连接缓存造成“看起来还连着旧服务”的假象。