文件系统

这是 @deepseek-ai/dsh-attachment 的私有本地实现。对象存放在 <DSH_HOME>/attachments/v1/objects/<sha256-prefix>/<sha256>，并通过不透明的 sha256: 标识符寻址。每个进程都会通过将每个祖先目录项逐级同步到文件系统根目录，为某个 home 一次性证明其持久性，因此绝不会把另一个进程已经创建但尚未同步的目录误认为安全边界。随后，写入过程使用私有暂存目录、仅所有者可访问的文件、经过同步的临时文件、原子且排他的硬链接发布，并对发布路径…

fs-observation-policy 插件：它记录观测到的存在或缺失状态，并在 ctx.fs 提供方约定（@deepseek-ai/dsh-fs）之上增加编辑前读取和带防护的写入/编辑；它通过 fs/* 事件门禁参与，不是通过方法服务。该插件不注册 ctx.fsPolicy 服务，也没有公开的 read/write/edit/resolve 方法。它是文件系统栈的政策层：不是可替换 seam，而是不应位于 FileSystem 提供方基类上的政策。

@deepseek-ai/dsh-spill 存储 seam 的本地文件系统实现。它注册为 ctx.spillStore，将工具产生的过大文本持久化到私有的会话级文件；定位信息是文件路径，取回指引会告诉模型对该路径使用 read 或 grep。

工具结果 spill 策略：一个 tools/post-execute 转换器，用于防止过大的纯文本工具结果进入模型上下文。当最终结果超过 maxInlineBytes 时，它会通过 ctx.spillStore 保存完整文本，并将面向模型的结果替换为有界的首尾预览、后端定位信息与取回指引。

非会话数据的存储中心（ctx.storage）：具名后端注册表加已挂载的数据形式设施。中心自身不执行 IO：后端拥有介质，数据形式拥有语义。存储家族概述列出了这些包；领域 KV 存储 Agent Note记录了设计理由。

DeepSeek Harness 存储中心的领域数据形式：在所有已配置的后端注册后，公开可注入的 ctx.storageDomain 服务及对应的 ctx.storage.domain 投影。一个领域通过 defineDomain（zod 记录 schema、从 z.infer 派生的类型）声明一次，通过 DomainFacility.open 打开，并由具有最终决定权的内存状态提供服务：读取同步执行；写入在每个领域各自的一条链上串行化，先在已路由后端达到持久状态，再更新内存并发出 domain/changed。打…

存储中心的 JSON 后端：配置根目录下每个单元使用一个人类可读的 <unit>.json 文件，注册为后端 json。设计见领域 KV 存储 Agent Note。

面向模型的文件系统发现工具（glob、grep）由 打包的 ripgrep 二进制（@vscode/ripgrep）支持，而不是由 ctx.fs 提供方方法或系统 rg 安装支持。注册是无条件的：二进制随 NPM 依赖一起交付，因此没有加载期可用性探针。每次调用都通过 ctx.subprocess seam 以固定 argv 向量 spawn 该二进制（前缀 --no-config，使宿主的 RIPGREP_CONFIG_PATH 无法向不受约束的 spawn 注入 --pre 预处理器；模型控制的值是普通 arg…