docs(minimal): explain editor opt-in configuration

This commit is contained in:
fz
2026-09-07 19:33:48 +08:00
parent 71a291cbc4
commit d3281d0218
6 changed files with 42 additions and 8 deletions
+17
View File
@@ -129,6 +129,23 @@ The first command initializes the shipped standalone profile. The second forward
Another `profile` is valid when it includes `@deepseek-ai/dsh-sdk-app` or another JSON-RPC server row. Missing server rows, unresolved plugins, and invalid patches fail during startup instead of falling back to another composition.
<a id="opt-in-to-str_replace_editor"></a>
### Opt in to `str_replace_editor`
The bundled runtime includes `str_replace_editor`, but `sdk-minimal` omits it from the default Cordis tree. To use it, save this configuration as `editor.patch.yml`; `insert` adds both the editor and the filesystem provider that the minimal profile lacks:
```yaml
- insert:
- id: fs-local
name: '@deepseek-ai/dsh-fs-local'
config:
cwd: !!js process.cwd()
- id: tool-str-replace-editor
name: '@deepseek-ai/dsh-tool-str-replace-editor'
```
Pass `patches=("/absolute/path/to/editor.patch.yml",)` when constructing `DeepSeekHarness(profile="sdk-minimal", ...)`, or put the patch in `$DSH_HOME/profiles/sdk-minimal/cordis.patch.yml` for persistent configuration. On the next runtime launch, model requests include `str_replace_editor` beside the persistent shell. The local filesystem provider uses the runtime working directory for relative paths; like the minimal shell, it does not confine access to that directory. For the standard `sdk` profile, insert only the editor row so it uses the existing filesystem provider and policies.
## Understand the minimal profile
| Property | Value |