DeepSeek Harness Python SDK 怎么改配置？profile patch 与 editor 补丁

DeepSeek Harness Python SDK 的配置不是一个文件，而是四层叠加：profile 决定基础树，profile 持久 patch 与 home patch 负责长期改动，构造时传入的 patches 元组只管这一次启动。 很多人改完配置“下次又没了”，就是把临时 patch 当成了持久配置。这篇按“层从哪来 → 写哪一层 → 怎么加回工具”讲清。

DeepSeek Harness：四层配置分别管什么

最终配置由 profile、profile 持久 patch、home patch 与 patches 元组依次叠加，后面的层覆盖前面的层。 对应到文件：（来源）

一个容易忽略的点：patch 会替换目标行的整个 config，不是深度合并。改一个字段时，要把同一行其他字段一起写全，否则会被覆盖掉。

from pathlib import Path
from deepseek_harness import DeepSeekHarness

workspace = Path("/srv/work/demo").resolve()
dsh_home = Path("/srv/dsh-home/demo").resolve()

with DeepSeekHarness(
    provider="deepseek-official",
    model="deepseek-v4-flash",
    max_tokens=49_152,
    cwd=str(workspace),
    dsh_home=str(dsh_home),
    profile="sdk-minimal",
    patches=("/srv/dsh-home/demo/patches/editor.patch.yml",),
) as harness:
    result = harness.run("Inspect the repository.", session_id="demo-001")

DeepSeek Harness：持久配置怎么写

要跨次启动保留，就把 patch 写进 $DSH_HOME/profiles/sdk-minimal/cordis.patch.yml。 步骤：（来源）

1. 先初始化 profile — 执行 dsh --profile sdk-minimal --dump-default-config >/dev/null。预期：profile 目录与默认组合生成完毕。
2. 编辑 cordis.patch.yml — 只写要增改的行，不要复制整棵树。预期：文件能被 YAML 解析。
3. 用 dump 核对 — dsh --profile sdk-minimal --dump-config。预期：输出里能看到你改的字段与来源文件。
4. 再跑 SDK — 重新构造 DeepSeekHarness。预期：新配置生效，且不依赖本次传入的 patches。

如果第 3 步没看到改动，先检查 DSH_HOME 是不是你以为的那个目录。SDK 只读显式传入的 home，不会静默读取 ~/.dsh。

DeepSeek Harness：单次启动怎么传 patch

只影响一次的改动，用 patches 元组传入，不要污染持久文件。 适合三类场景：（来源）

1. 临时提高超时 — 为一次长任务加一个超时 patch。预期：任务结束、进程退出后配置自动回到默认。
2. 临时挂工具 — 只在某次调试中启用 str_replace_editor。预期：其他任务看不到这个工具。
3. A/B 对比 — 同一 home 用两份不同 patch 跑两次。预期：两次结果可对比，且不互相污染。

传参时用绝对路径，顺序就是叠加顺序。后面的 patch 覆盖前面的同目标行。

DeepSeek Harness：启用 str_replace_editor 的完整写法

sdk-minimal 默认不挂载 str_replace_editor，要用一个 editor.patch.yml 把它插回去。 官方示例：（来源）

- insert:
    - id: tool-str-replace-editor
      name: '@deepseek-ai/dsh-tool-str-replace-editor'

两种启用方式：

1. 按次启用 — 保存为 /srv/dsh-home/demo/patches/editor.patch.yml，构造时传 patches=("/srv/dsh-home/demo/patches/editor.patch.yml",)。预期：下次运行时模型工具列表多出 str_replace_editor。
2. 持久启用 — 把同一段 insert 合并进 profiles/sdk-minimal/cordis.patch.yml。预期：之后每次启动都带这个工具。
3. 标准 sdk profile 也能用 — 同一个 patch 对 sdk profile 同样适用。预期：换成 profile="sdk" 后工具仍出现。

注意：本地文件系统后端以运行时工作目录解析相对路径，不会把访问限制在该目录内。启用编辑器后，权限边界要靠沙箱或一次性 checkout 控制。

DeepSeek Harness：patch 替换整个 config 的对照

官方规则是“patch 替换目标行的整个 config”，不是逐字段深合并。 原行有 apiKeyEnv、api、baseURL 三个字段时，patch 只写 api 会把另外两个字段一起删掉。正确做法是把原行完整抄下来再改；改完用 --dump-config 核对。（来源）

DeepSeek Harness：三种改配置方式的取舍

持久 patch、home patch、构造时 patches 各自解决不同问题，不要用一种方式包打天下。 对比如下：（来源）

1. profile 持久 patch — 适合“这个 SDK 应用长期就要这样”。代价：换 home 就丢失，需要重新写。
2. home patch — 适合“这台机器上所有 SDK profile 都要带”。代价：影响面大，调试时容易误伤其他任务。
3. 构造时 patches — 适合“只这一次”。代价：每次调用都要记得传，漏传就回到默认。

一个实用规则：先在构造时 patches 里验证，确认稳定后再搬进 profile 持久 patch。这样不会把实验配置写进长期环境。

DeepSeek Harness 常见问题

Q：改了 cordis.patch.yml 需要重启 SDK 吗？ 需要重新构造 DeepSeekHarness。持久 patch 在启动时读取；进程内的 harness 不会因为文件变化自动重载。

Q：patch 里只写一个字段，为什么其他字段没了？ 因为 patch 替换目标行的整个 config，不是逐字段合并。改之前先把原行完整抄下来，再改其中一项。

Q：profile 能不能指向自己新建的目录？ 可以，但该 profile 必须包含 @deepseek-ai/dsh-sdk-app 或另一个 JSON-RPC server 配置项。缺 server 配置会在启动时失败，不会回退。

一句话收束： SDK 配置的关键不是“写哪个文件”，而是先分清这层改动要活多久；一次性的进 patches，长期的进 cordis.patch.yml。