概览
dsh-storage-domain
源码级技术说明DeepSeek Harness 存储中心的领域数据形式：在所有已配置的后端注册后，公开可注入的 ctx.storageDomain 服务及对应的 ctx.storage.domain 投影。一个领域通过 defineDomain（zod 记录 schema、从 z.infer 派生的类型）声明一次，通过 DomainFacility.open 打开，并由具有最终决定权的内存状态提供服务：读取同步执行；写入在每个领域各自的一条链上串行化，先在已路由后端达到持久状态，再更新内存并发出 domain/changed。打开领域的消费方负责管理句柄的生命周期，并通过 Domain.close() 释放它（幂等；通常作为其自身的 ctx.effect 资源释放函数）；插件卸载时，该设施会关闭仍处于打开状态的领域。收起技术说明
ctx.storageDomain 服务及对应的 ctx.storage.domain 投影。一个领域通过 defineDomain（zod 记录 schema、从 z.infer 派生的类型）声明一次，通过 DomainFacility.open 打开，并由具有最终决定权的内存状态提供服务：读取同步执行；写入在每个领域各自的一条链上串行化，先在已路由后端达到持久状态，再更新内存并发出 domain/changed。打开领域的消费方负责管理句柄的生命周期，并通过 Domain.close() 释放它（幂等；通常作为其自身的 ctx.effect 资源释放函数）；插件卸载时，该设施会关闭仍处于打开状态的领域。这是 Harness 已内置的原子模块，不是可独立激活的 Profile 层。
能力
它贡献了什么
README / ZH
插件文档
@deepseek-ai/dsh-storage-domain
English | 中文
DeepSeek Harness 存储中心的领域数据形式：在所有已配置的后端注册后，公开可注入的 ctx.storageDomain 服务及对应的 ctx.storage.domain 投影。一个领域通过 defineDomain（zod 记录 schema、从 z.infer 派生的类型）声明一次，通过 DomainFacility.open 打开，并由具有最终决定权的内存状态提供服务：读取同步执行；写入在每个领域各自的一条链上串行化，先在已路由后端达到持久状态，再更新内存并发出 domain/changed。打开领域的消费方负责管理句柄的生命周期，并通过 Domain.close() 释放它（幂等；通常作为其自身的 ctx.effect 资源释放函数）；插件卸载时，该设施会关闭仍处于打开状态的领域。
设计原理、打开语义和存储／领域分层见 Agent Note。
配置
| key | 含义 |
|---|---|
backend |
每个领域的默认后端名称（必填；不存在普遍适用的存储介质）。 |
routes |
逐领域覆盖：领域名称 → 后端名称。 |
模型体验
持久领域状态
模型看到的内容
无。该包不注册工具、不注入提示词，也不追加会话事件；它在 ctx.storageDomain 后面存储非会话数据（工作区记录、未来的会话伴随数据），只发出进程内 domain/changed 事件。只有 Consumer 包通过自身有文档说明的接口呈现该事件时，它才会到达模型。
Token 影响
为零。该包的文本不会进入任何模型请求。
KV Cache 影响
相互独立：领域读写绝不触碰请求前缀，因此这里没有任何内容能使提供方缓存复用失效。
已知限制与暂缓事项
- 变更只在单进程内可见：
domain/changed是进程内事件；在 Agent Note 暂缓的跨进程修订模式落地前，第二个主机进程或重新连接的 GUI 无法观察变更。 - 没有跨表事务、二级索引或多段键：每次写入只触碰一条记录；这些扩展的触发点和返工点列在 Agent Note 的暂缓工作清单中。
LIMITATIONS
已知限制
- **变更只在单进程内可见**：`domain/changed` 是进程内事件；在 Agent Note 暂缓的跨进程修订模式落地前，第二个主机进程或重新连接的 GUI 无法观察变更。 - **没有跨表事务、二级索引或多段键**：每次写入只触碰一条记录；这些扩展的触发点和返工点列在 Agent Note 的暂缓工作清单中。