DeepSeek Harness spill 文件占多少磁盘:产生时机、保留策略与清理顺序
spill 不是「临时文件」,而是「完整结果的正式存放点」:模型上下文只留摘要或定位符,全文在磁盘上。 官方把 spill 描述为超出模型可见上限时的完整内容存储,并返回定位符供后续读取(来源)。理解这一点,清理时就不会把仍在引用的内容删掉。
DeepSeek Harness 三个产生点
spill 通常在三种情况下产生,分别对应不同的容量曲线。 对照如下(来源):
| 产生点 | 触发条件 | 容量特征 |
|---|---|---|
| 工具输出超限 | 单个工具结果超过模型可见上限 | 与单次结果大小相关 |
| 子进程输出过大 | 命令输出超过缓冲或上下文上限 | 与命令日志量相关 |
| 会话引用截断 | 引用内容超过预算被截断 | 与会话历史与引用数相关 |
第一类最常见。例如 glob/grep 结果超过上限时,完整列表会写入 spill,模型只看到定位符与摘要。
第二类与长任务相关。构建日志、测试输出、调试日志都可能很大;如果全部塞进上下文,会挤掉真正有用的信息。
第三类与会话引用相关。引用内容被截断后,完整内容可能在 spill 里;删除它会影响后续引用读取。
三个产生点的共同点是「完整内容有价值,但不适合全部进模型上下文」。spill 是折中:上下文保留可操作的部分,全文留在磁盘。
DeepSeek Harness 文件落在哪
spill 文件的位置由存储后端决定,不在项目目录里。 常见位置是 Harness home 下的专用目录,具体路径以部署配置与后端实现为准。(来源)
三个判断方法:
- 看定位符 — 定位符通常包含后端标识与内容 id,可以据此找到文件;
- 看配置 — spill 后端与路径在 profile 或组合包配置里;
- 看磁盘增长 — 对比项目目录与 home 目录的增长,通常能定位到 spill 所在盘。
不要把 spill 当成项目构建产物。它不属于工作区,清理项目目录不会清掉它;反过来,删项目目录也不应影响 spill 的引用关系。
如果部署使用远程或对象存储后端,文件可能不在本机;清理前先确认后端类型,不要用本地 rm 处理远程内容。
DeepSeek Harness 保留与清理归属
保留与清理不是一个默认保证,而是部署责任。 官方文档描述 spill 的保存与定位符契约,但保留多久、何时回收取决于后端与配置(来源)。
三类归属:
- 后端负责物理存储 — 文件存在哪、如何压缩、是否远程;
- 会话/工具负责引用 — 定位符还在不在用、是否可重新生成;
- 部署负责策略 — 保留天数、容量上限、清理任务。
把三者混在一起,常见结果是「以为会自动清,结果堆满磁盘」或「清理脚本删掉了仍在引用的文件」。
一个实用做法:给 spill 单独设容量预算与监控,不要和会话日志、插件缓存共用同一个无限增长的分区。
DeepSeek Harness 直接删的后果
直接删除 spill 文件,可能让「已经成功」的结果打不开。 三种后果(来源):
- 工具结果不可读 — 定位符还在会话里,但文件没了,后续读取失败;
- 会话引用断裂 — 引用被截断后依赖 spill,删除后无法恢复全文;
- 诊断信息丢失 — 排障时想回看完整输出,发现已被删。
第一种最常见。模型看到的是摘要与定位符,用户点开详情时才发现内容不在;这时任务本身没有失败,但结果不可用。
第二种更隐蔽。会话引用可能只在需要时读取 spill,平时不报错;等到用户引用时才失败。
第三种是运维成本。删得太早,出问题时没有完整日志;删得太晚,磁盘被占满。需要按保留策略平衡。
DeepSeek Harness 清理顺序
安全清理按「确认引用 → 标记 → 删除 → 验证」四步走。 不要直接 rm -rf。(来源)
- 确认引用 — 列出仍被会话、工具结果或引用使用的定位符;
- 标记候选 — 按时间、大小与引用状态选出可删内容;
- 分批删除 — 先删无引用、最旧的一批,保留回滚窗口;
- 验证会话 — 打开相关会话,确认关键结果仍可读。
四步里最重要的是第一步。没有引用清单,删除就是赌博;有清单,至少能控制影响范围。
如果无法确认引用,优先保留最近一段时间的 spill,删除更早的;不要反过来。近期会话更可能仍在使用。
清理脚本要幂等、可 dry-run,并记录删除了哪些定位符。出问题时,日志比「我记得删过」有用。
DeepSeek Harness 容量与清理的四个观察点
验证容量与清理策略,用四个观察点。 四步(来源):
- 产生 — 跑一个超大输出工具,确认 spill 文件出现、定位符可读;
- 引用 — 在会话里引用该结果,确认能读全文;
- 清理 — 删除一个无引用文件,确认会话不受影响;
- 保留 — 按策略等待或触发清理,确认容量回到预算内。
四步都过,说明产生、引用、清理、保留四条链路一致。只过第一步,常见问题是引用断裂;只过前三步,常见问题是容量继续增长。
旧文 develop-spill-store-contract 讲保存与定位符契约,develop-token-meter-and-spill 讲计量与外溢,fix-subprocess-spill-short-write 讲短写;本篇补的是磁盘预算与清理顺序。先确认引用,再删文件。
常见问题
DeepSeek Harness 在工具输出、子进程输出或会话引用超过模型可见上限时,会把完整内容写到 spill 存储,并返回定位符供后续读取。
DeepSeek Harness 的 spill 保留与清理取决于存储后端与部署配置,不能假设一定自动回收。需要容量控制时,应显式配置保留策略或定期清理。
DeepSeek Harness 里,如果会话或工具结果仍引用该定位符,读取会失败,表现为「结果存在但内容打不开」。删除前应先确认引用,再按顺序清理。
DeepSeek Harness 里,调小上限会让更多内容进入 spill,反而可能增加磁盘占用;要控制占用,应同时调整输出保留、清理策略与工具结果大小。
相关术语
- spill 存储
- spill 存储是 DeepSeek Harness 用于保存超出模型可见上限的完整内容的存储层,返回定位符供后续读取。— DeepSeek Harness 官方文档 - Spill 存储
- 定位符
- 定位符是 DeepSeek Harness 指向 spill 内容的引用,工具与会话通过它读取完整结果,而不是把全文放进模型上下文。— DeepSeek Harness 官方文档 - Spill 存储
- 保留策略
- 保留策略决定 spill 内容保存多久、何时可清理;它由存储后端与部署配置决定,不是固定不变。— DeepSeek Harness 官方文档 - Spill 存储
- 容量预算
- 容量预算是为 spill 设定的磁盘上限与清理节奏,用于避免中间产物无限增长。— DeepSeek Harness 官方文档 - Spill 存储
来源
- DeepSeek Harness 官方文档 - Spill 存储· deepseek-harness
- DeepSeek Harness 官方文档 - Token 计量· deepseek-harness