mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
1010291fe6
Confirmed and fixed, each with a regression test that failed first: - Concurrent writes to different namespaces lost whole sections on disk (each persist rendered the full document from a stale text): the local provider serializes render->write->rename->text-commit on one internal persist chain shared by every namespace queue. - One throwing settings/updated listener starved the rest (cordis emit stops at the first throw): commit fans out per listener via events.dispatch, contains individual failures, and rethrows the first INVARIANT-coded error only after every listener ran. - Write queues ignored fiber/service lifecycle: the base init now registers a teardown that refuses new writes and drains queued chains; queued tasks re-verify service liveness and namespace ownership before running and again before committing, so a registrant disposed mid-flight is never notified and a disposed service never commits. - Async watcher invocations could interleave (a slow stale call applied last): each watcher carries a serialized invocation chain — one call at a time, in commit order; JSDoc/doc pages state the async timing. - update/replace borrowed the caller's object until the queued task ran: inputs are structured-clone snapshotted at call time; non-cloneable plain objects reject with a typed error. - Composition guard now proves the documented fallback: the consumer uses the optional scoped-inject shape and boots both with the settings entry (hot publish) and without it (entry-config resolution, no scope). - core-data-structures index: settings.md row added to the sub-page table in core.md/core.zh.md. Both packages hold per-file 100% coverage across repeated runs.
2.6 KiB
2.6 KiB
@deepseek-ai/dsh-settings-local
English | 中文
文件 settings provider。一个 YAML 或 JSON 文档承载全部 namespace 分节；外部编辑经 ctx.settings 热发布，update() 原子写回，并保留用户的 YAML 注释以及当前未加载插件所拥有的分节。
配置
| 字段 | 含义 | 默认 |
|---|---|---|
path |
设置文档路径；扩展名决定格式（.yaml/.yml/.json） |
harness home 下的 settings.yaml |
dshHome |
path 省略时使用的 harness home |
$DSH_HOME 或 ~/.dsh |
watch |
监听文档并热发布外部编辑 | true |
debounceMs |
watcher 写入稳定窗口（毫秒） | 100 |
默认值解析是一步显式的 resolveSpec(config)；不支持的扩展名在加载时报错。
行为
- 启动报错响亮，重载保留最后可用值。 存在但非法的文档使插件加载失败；运行中不可读或不可解析的编辑只告警并保留最后可用分节。文档缺失时所有 namespace 按默认值与
base解析；删除文档发布同样的空状态。 - 写回原子、仅属主可读、抗符号链接。
persist以0600权限独占创建随机后缀临时同级文件（wx拒绝跟随预埋符号链接）后 rename 覆盖目标，失败时清理临时文件。YAML 写回在保留注释的文档里只修补目标 namespace；JSON 重新序列化。 - 跨 namespace 写入在同一文档上串行。 所有 namespace 共享一个文件，来自不同 namespace 队列的 persist 在内部串联；每次渲染都基于上一次写入提交后的文本。
- Dispose 保证静止。 卸载先停止接收 watcher 事件、关闭 watcher，再等完排队与进行中的重载，之后不再有任何发布。
- 按内容抑制自写。 provider 缓存最后可用文本；watcher 事件内容与缓存相同（含自己的写入）即为 no-op。
Model Experience
间接生效：本 provider 只存储并发布 namespace 分节，模型效果经由 ctx.settings 的消费插件产生，由各消费者自己的文档描述。
KV Cache effect
无直接失效；请求前缀的变更由消费插件拥有。
Known Limitations and Deferred Work
- 无跨进程写锁 — 并发写入者（例如同一 home 上的 TUI 与 web）靠原子替换加 watcher 重载收敛，后写胜出；lockfile 等真实冲突出现再做。
- 注释保留仅限 YAML — JSON 文档重新序列化，无注释（JSON 本身没有）且丢失手工排版。
- 无值间接引用 — 分节存字面值；面向密钥的
${env:VAR}式引用是 seam 层的延后特性。