2026 DeepSeek Harness 会话日志空间：先测再扩容

容量口径

先把总空间写成一个可填写的公式：

总预留空间
= 会话持久化增量
+ 工具结果增量
+ 持久图片附件
+ 工作区产物
+ 运行缓存
+ 在线数据对应的备份副本

其中，模型 Token 消耗不等于本地磁盘占用。Token 主要描述请求与响应的计量口径；磁盘则取决于事件是否落盘、工具结果是否完整保存、图片是否产生副本、工作区是否保留构建产物，以及备份策略是否复制了原始目录。

官方仓库目前将 DeepSeek Harness 描述为开源 Agent Harness，并提供 Web UI；通过 npx @deepseek-ai/dsh web 启动时，默认监听本机 http://127.0.0.1:3080。这个端口是访问入口，不代表会话日志一定存放在项目目录或某个固定路径。(DeepSeek Harness 官方 README)

因此，每次测量至少记录以下元数据：

• DeepSeek Harness 版本或提交号；
• 任务类型，例如代码修复、构建排错、图片分析或批量检索；
• MCP、ACP 与插件配置；
• 任务开始时间、结束时间和是否发生上下文压缩；
• 测量前后的目录大小；
• 是否执行过恢复、迁移或备份。

官方最新可见预发布版本为 v0.1.0-rc.7，发布日期为 2026 年 8 月 17 日；该版本的发布说明新增了 MCP 与 ACP 持久化图片附件能力。版本变化后，旧测量结果只能作为历史记录，不能直接套用到新环境。(DeepSeek Harness v0.1.0-rc.7 发布说明)

会话事件

持久化目录的定位方法

不能先入为主地写成某个固定目录。当前版本的实际位置，应从运行配置、用户数据目录、会话存储插件和源码中的持久化实现共同确认；开发者预览阶段的文件位置、格式兼容性和清理机制，都可能随版本变化。

在 Mac 上，可以先从进程、配置和最近修改文件三个方向定位：

ps aux | grep -i '[d]sh'

find "$HOME" -type f -mmin -30 2>/dev/null \
  | grep -Ei 'deepseek|dsh|session|event|attachment' \
  | head -100

找到候选目录后，不要只看单个文件，而要计算整个目录的实际大小：

du -sh "/path/to/candidate"

find "/path/to/candidate" -type f -print0 \
  | xargs -0 stat -f '%z %N' \
  | sort -nr \
  | head -30

会话增长通常不应只理解为“用户输入加模型回答”。需要把用户消息、模型输出、工具调用、工具返回、审批事件、上下文压缩、恢复检查点和插件产生的元数据分别看待。官方仓库将 DeepSeek Harness 的核心结构拆分为插件、运行时、工作区、工具和持久化相关模块；这意味着可见聊天内容只是持久化数据的一部分。(DeepSeek Harness 源码结构)

如果当前版本提供事件索引或 SessionEvent 记录，应统计事件类型，而不是简单统计消息数量：

单位任务增量
= 任务结束后会话目录大小
- 任务开始前会话目录大小

建议至少执行三次同类任务，并分别记录：

任务 A：纯文本问答
任务 B：读取文件 + 搜索代码 + 少量命令
任务 C：构建失败 + 完整错误输出 + 修复后再次构建

这里不应把三次结果直接平均后当成长期标准。若任务 B、C 的工具输出差异很大，平均值会掩盖长任务的尾部风险；采购时更应保存最大值、典型值和异常值三个字段。

工具结果与工作区

工具结果往往比普通聊天文本更快推高长会话的磁盘占用。构建日志、测试失败堆栈、依赖解析结果、命令输出、大段代码检索和子代理返回内容，都可能进入会话事件记录；另一方面，编译目录、缓存、截图、补丁文件和生成文档可能只留在工作区。

这两类数据必须分开测量：

会话日志增量 = 会话持久化目录结束大小 - 开始大小
工作区增量   = 工作区结束大小 - 开始大小

可以使用下面的命令在任务前后各保存一次结果：

TARGET_SESSION="/path/to/session-data"
TARGET_WORKSPACE="/path/to/workspace"

du -sk "$TARGET_SESSION" "$TARGET_WORKSPACE" \
  | tee "size-before-$(date +%Y%m%d-%H%M%S).txt"

任务完成后重复执行，并用 diff 比较：

du -sk "$TARGET_SESSION" "$TARGET_WORKSPACE" \
  | tee "size-after-$(date +%Y%m%d-%H%M%S).txt"

diff -u size-before-*.txt size-after-*.txt

长会话的磁盘增长边界

长时间运行的代码 Agent，空间上限通常由工具返回、重复失败输出、工作区产物和恢复检查点共同决定，而不是由消息数量单独决定。官方发布说明还提到修复了“大历史消息分页栈溢出”和 max-token 截断后会话无法继续的问题，这说明历史消息规模与恢复路径本身就是需要持续验证的边界。(DeepSeek Harness Release Notes)

测量时应固定输出控制策略，再比较差异，而不是事后声称“截断输出一定节省某个百分比”。例如，可以分别测试：

• 命令只返回最后一段错误；
• 命令保存完整日志到工作区，会话只记录摘要；
• 搜索结果限制匹配文件和行数；
• 构建产物保留，但不把二进制内容写入会话；
• 子代理返回结构化状态，而不是整段终端输出。

若任务需要完整审计，就不能擅自删除原始工具结果；若任务只需要可恢复状态，则可以将大输出移到工作区，保留路径、哈希、时间和摘要。关键在于恢复时能否重新定位原始文件，而不是仅仅让目录变小。

图片附件

图片持久化的测量方式

截至 2026 年 8 月 18 日，官方 v0.1.0-rc.7 发布说明确认，MCP 与 ACP 已支持持久化图片附件，PTC 模式还支持嵌套图片转发。这里能确认的是能力已经出现在该版本说明中，不能据此推导每张图片固定占用多少空间。(DeepSeek Harness v0.1.0-rc.7 图片附件说明)

图片负载应单独建立测量项：

附件增量
= 原始图片大小
+ 转发副本大小
+ 会话恢复后新增副本
+ 缩略图、索引或中间文件大小

不要用“图片数量 × 典型图片大小”代替真实测量，因为同样是 1 张图片，原始格式、分辨率、编码方式、MCP 返回方式和是否经过 PTC 嵌套转发，都可能改变落盘结果。

可在任务前后检查附件目录和全部大文件：

find "$HOME" -type f \( \
  -iname '*.png' -o -iname '*.jpg' -o -iname '*.jpeg' \
  -o -iname '*.webp' -o -iname '*.gif' \
\) -print0 2>/dev/null \
  | xargs -0 stat -f '%z %N' \
  | sort -nr \
  | head -50

如果恢复一次会话后目录继续增长，应把“恢复增量”单列，而不是误认为新任务增量。敏感图片还要加入保留责任：会话审计要求保留，并不等于所有附件都应永久保留；删除前必须确认事件记录是否仍指向附件、恢复流程是否还能读取，以及团队是否有合规留存要求。

备份与恢复

在线工作空间和备份空间不能混成一个数字。至少要拆成：

在线数据       = 会话 + 附件 + 工作区
快照副本       = 在线数据 × 快照副本数
迁移副本       = 导出包或迁移目录
回退窗口       = 在保留期内仍需读取的历史副本

例如，团队决定保留 3 份副本，这只是一个待确认的运维策略，不是 DeepSeek Harness 的默认行为；最终应把实际副本数量填入公式。备份目录可以读取，也不代表新版本能够直接续跑。官方明确说明 DeepSeek Harness 仍在开发者预览阶段，并存在兼容性破坏变化，所以迁移前必须记录版本、配置和插件清单。(DeepSeek Harness 官方仓库说明)

建议按以下步骤完成一次可复现的恢复验证：

1. 记录当前版本、提交号、插件列表和会话标识。
2. 停止正在写入会话目录的进程，避免复制到半写入文件。
3. 复制会话目录、附件目录和工作区元数据。
4. 在隔离目录或另一台 Mac 上恢复副本。
5. 启动同版本 DeepSeek Harness，尝试打开、搜索和继续原会话。
6. 检查图片附件、工具结果和工作区文件是否仍可访问。
7. 再用目标版本执行一次恢复，记录是否需要迁移或出现兼容错误。

清理与扩容

可清理数据的判断边界

只有满足“不会影响审计、恢复和必要附件引用”的数据，才适合进入清理范围。一般可以优先检查：

• 已确认不再需要的临时构建目录；
• 可由源码重新生成的依赖缓存；
• 已导出并完成校验的重复迁移包；
• 明确属于失败重试的重复工具输出；
• 已过内部保留期限、且不承担审计责任的会话附件。

不应直接删除：

• 仍需恢复的活跃会话；
• 没有导出或校验的原始事件日志；
• 被会话事件引用的图片附件；
• 尚未完成验收的备份副本；
• 包含凭据、客户代码或敏感图片的目录。

清理动作建议先做演练：

du -sh "$TARGET_SESSION" "$TARGET_WORKSPACE"

# 先移动到隔离目录，不直接 rm
mkdir -p "$HOME/dsh-quarantine"
mv "/path/to/old-artifact" "$HOME/dsh-quarantine/"

# 验证会话仍可打开、附件仍可读取后，再清空隔离目录

若满足以下条件，则优先清理工作区缓存，而不是扩容：

• 会话日志增量稳定，主要增长来自可再生成产物；
• 历史附件已完成保留判断；
• 备份恢复验证成功；
• 清理后仍有足够的系统空闲空间。

若满足以下条件，则应先扩容或更换存储策略：

• 会话事件必须完整保留，不能压缩或删除；
• 工具输出包含审计所需的原始证据；
• 图片附件是任务核心输入，无法只保留缩略图；
• 多个任务并发写入同一台 Mac；
• 备份、迁移和回退副本与在线数据同时存在；
• 清理会破坏会话恢复或附件引用。

容量决策公式

日志空间的预留量不能脱离任务增量、并发量和保留周期单独回答。建议使用下面的公式，并把每个字段替换成测量值：

在线会话空间
= 单位任务会话增量
× 每周期任务数
× 保留周期
× 并发修正系数

附件空间
= 单位任务附件增量
× 每周期图片任务数
× 附件保留周期

工作区空间
= 单位任务工作区增量
× 并发任务数
+ 不可立即删除的产物

总预留空间
= 在线会话空间
+ 附件空间
+ 工作区空间
+ 运行缓存
+ 快照副本
+ 迁移副本
+ 回退空间

这里的“并发修正系数”不能凭经验随便填写。若任务是轮流执行，按峰值活跃任务数测量；若多个 Agent 同时写入同一环境，则需要在并发条件下重新跑基准任务。按日均任务量计算，可能低估交付高峰的瞬时空间需求。

采购团队可以按照下面的条件分支做结论：

• 若单位任务增量已经通过同类基准任务测得，且清理后能通过恢复验证，则先按公式规划租期与存储余量。
• 若工具结果是主要增长源，且大输出可移到工作区，则优先优化输出保留策略，再重新测量。
• 若图片附件或完整事件日志不可删除，则把附件与审计数据作为刚性容量，不用对话条数估算。
• 若并发任务会同时产生多个恢复副本，则按峰值并发量计算在线空间，而不是按日均任务数计算。
• 若当前版本升级后改变了持久化格式，则重新执行基准任务和恢复验证，旧数据只能作为对照。
• 若本地 Mac 的存储余量无法覆盖在线数据、备份和迁移副本，则改用可按租期调整的云端 Mac 方案，避免为了短期任务购买固定容量。

本周测量模板

本周可以直接复制下面的模板，不预设任何 GB 数字：

DeepSeek Harness 版本：
源码提交号：
Mac 存储位置：
任务类型：
观察周期：
并发任务数：

测量前：
  会话事件目录：
  工具结果目录：
  附件目录：
  工作区：
  缓存：
  备份：

测量后：
  会话事件目录：
  工具结果目录：
  附件目录：
  工作区：
  缓存：
  备份：

单位任务增量：
  会话日志：
  工具结果：
  图片附件：
  工作区产物：

容量公式：
  在线数据 = 单位任务增量 × 每周期任务数 × 保留周期
  总预留   = 在线数据 + 备份副本 + 迁移副本 + 回退空间

完成第一次测量后，建议在版本升级、插件变更、图片附件策略变化或会话压缩机制变化后重新执行。只有这样，历史数据才不会被误当成当前版本的固定存储规律。

对于云端 Mac，还需要把交付后的验收纳入容量规划：检查会话目录是否位于持久磁盘、重启后是否仍可读取、附件是否能恢复，以及备份副本是否独立于工作区。需要规划多台 Mac 或不同租期时，可以参考 Mac 云端算力订购指南，把日志保留空间、并发任务和恢复副本一起写进采购单。

如果团队还没有远程环境，先阅读 DeepSeek Harness 云端 Mac 使用方案，再结合实际地区选择 香港 Mac 云端算力 等节点页面；节点选择本身不能替代容量测量，但可以帮助团队把临时任务和长期运行拆开管理。

本地固定 Mac 的问题在于存储容量一旦不足，清理、迁移和备份往往同时争用同一块磁盘；长期运行时还会遇到无法快速扩容、闲置期间仍占用设备、多人共享边界不清等限制。相比之下，NodeMini 的云端 Mac 更适合已经测出单位任务增量、但只需要按租期承载测试、审计或阶段性 Agent 任务的团队；不过如果任务需要长期稳定重负载、专用物理接口或完全掌控硬件，也应如实评估自购 Mac 是否更合适。

容量规划的关键不是猜出一个看似精确的固定数字，而是把会话事件、工具结果、附件、工作区和副本分别测出来，再用实际保留周期计算。只要完成一次代表性任务测量，后续的清理、扩容和云端 Mac 租期选择就能从经验判断变成可复核的运维决策。