Configure the plugin under the kv-persist key in the DSH profile. Only providers listed under providers are ever coordinated.

Option	Type	Default	Description
`enabled`	boolean	`true`	Master switch; `false` passes everything through.
`backend.baseURL`	string	`http://127.0.0.1:8080`	llama-server management endpoint.
`backend.apiKey`	string	`""`	Bearer key for the management API; never logged.
`backend.requestTimeoutMs`	number	`15000`	Bounded timeout per persistence call.
`providers`	string[]	`[]`	Managed provider routes; empty = plugin inert.
`mode`	`"single-slot"`	`"single-slot"`	v0.1 supports single-slot only.
`slotId`	number	`0`	Physical slot used in single-slot mode.
`runtimeKey`	string	`""`	Runtime identity escape hatch; changing it hides old snapshots (they are kept, not deleted).
`checkpoint.onSwitch`	boolean	`true`	Save a dirty slot before reassignment.
`checkpoint.onShutdown`	boolean	`true`	Final checkpoint on plugin disposal.
`checkpoint.onSessionFlush`	boolean	`true`	Checkpoint on the session flush event.
`checkpoint.idleMs`	number	`30000`	Idle checkpoint delay; `0` disables.
`checkpoint.onTurnEnd`	boolean	`false`	Checkpoint after every user turn.
`checkpoint.onStepEnd`	boolean	`false`	Reserved for per-step checkpoints.
`restore.enabled`	boolean	`true`	Restore compatible snapshots lazily.
`restore.verify`	boolean	`true`	Reject restores reporting `n_restored /cache/dsh-kv-persist`
`logging.level`	`"debug" \| "info" \| "off"`	`"info"`	Structured `kv.*` event verbosity.

Full configuration rationale: design doc §35.

@yadsh/dsh-kv-persist

安装