概览

dsh-spill-local

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

BUILT-IN / ATOMIC

已随 DSH 提供，无需单独安装

这是 Harness 已内置的原子模块，不是可独立激活的 Profile 层。

能力

它贡献了什么

HostCordis loadable可配置

Client / UIHost only0 contributions

Model tools0None declared

Profile stateenabledbase, headless, web

README / ZH

插件文档

@deepseek-ai/dsh-spill-local

English | 中文

存储布局

文件存放在 <root>/session-<hash>/<random>-<safeName>：

root：使用配置中的 root（解析为绝对路径）；如果省略，则在操作系统临时目录下延迟创建每进程私有（0700）目录。可预测且任何用户均可读取的根目录会让其他本地用户读取 spill 工具输出，或在其中预置符号链接。
session-<hash>：截短的 sha256(sessionId) 前缀，用于将同一会话的 spill 文件归在一起，以便未来的清理操作可按会话删除。
<random>-<safeName>：不可预测的十六进制前缀（防止在共享根目录中预置符号链接），加上经过清理的调用方 suggestedName，使其成为单个安全路径段（防路径遍历；与 JSONL 持久化后端的 encodeSegment 一致）。写入操作采用排他方式，且权限仅限所有者（open(path, 'wx', 0o600)）：如果路径已经存在，无论是否为符号链接，操作都会失败，因此预置的目标无法重定向写入。

配置

键	默认值	含义
`root`	私有 0700 临时目录	spill 文件的根目录。设置后可将这些文件保存在已知位置。

saveText 在发生真实存储故障（权限、ENOSPC）时返回拒绝；spill 策略会按尽力而为原则处理该拒绝，并保留内联结果。词汇见 seam README，设计见工具输出 spill Agent Note。

模型体验

通过渲染本地路径以及 read/grep 取回指引的 spill 消费方间接影响模型。

KV Cache 影响

不会直接导致 KV Cache 失效；请求前缀变更由上述消费方负责。

已知限制与暂缓事项

本地 spill 文件会持续存在，直到外部清理为止：该后端不提供会话生命周期删除或按时间保留的策略，因为已持久化、已恢复和 fork 后的会话可能仍在引用某个路径。
定位信息需要与其位于同一文件系统的消费方：远程或虚拟部署需要另一个 SpillStore 后端，其定位信息和取回指引在该环境中有明确含义。

LIMITATIONS

已知限制

- **本地 spill 文件会持续存在，直到外部清理为止**：该后端不提供会话生命周期删除或按时间保留的策略，因为已持久化、已恢复和 fork 后的会话可能仍在引用某个路径。 - **定位信息需要与其位于同一文件系统的消费方**：远程或虚拟部署需要另一个 `SpillStore` 后端，其定位信息和取回指引在该环境中有明确含义。