DeepSeek Harness 0.1.3-alpha.1 更新：Session v2 与升级注意事项

先看版本与升级判断

DeepSeek Harness 0.1.3-alpha.1 是 2026-09-04 发布的预发布版，包含文件上传、代理、模型发现与 Session 持久化变化。截至 2026-09-05 复核时，npm latest 和 next 都是 0.1.2-rc.1，alpha.1 精确包尚未发布到 npm。 普通安装应参考rc.1 入门步骤，不能把 GitHub 的最新版本号直接拼成可用的 npx 命令。

本次最需要留意的是 Session format v2、SessionHandle 和异步创建接口，以及官方已知的部分历史会话加载性能回退。重要会话与插件环境应先保留旧程序、配置和数据副本，再决定是否隔离评估。52DSH 阅读了官方发布说明与固定提交，没有安装或运行该版本，也没有执行真实 Session 迁移。

rc.1 承接此前 0.1.2 预发布序列；alpha.5 的启动与标题修复仍保留历史解释。本文聚焦从 rc.1 到 alpha.1 的变化，不替代更新、回退与卸载指南。

文件上传：上传完成不等于模型已读完

官方 Release 增加 Web 通用文件上传，文件与图片可以在同一预览区域展示，并显示后台进度、取消与会话切换后的状态。模型通过保存后的路径及已有文件工具按需读取，不代表所有格式都能自动解析，也不代表文件全部内容已进入模型上下文。

固定上传服务将暂存凭证绑定到具体 Session。其传输层明确不支持失败或取消后的断点续传，重试从头开始；因此“切换会话仍能看到进度”不能写成“网络中断后续传”。首次使用选择不含敏感数据的小文件，确认目标 Session、上传状态、引用文件与最终回答相符。清理时还需核对保存文件和会话记录，取消上传不等于清除全部已存数据。

Session v2：打开旧日志也可能生成迁移文件

固定格式 catalog 的当前版本是 2，并包含 v0 → v1 → v2 的相邻迁移链。JSONL 后端选择数值最高的规范 generation，在受支持的旧格式旁发布新格式文件，保留源文件字节。新格式还调整 Assistant 流的持久化表达，不能用旧事件示例直接推断当前磁盘结构。

尤其需要区分两类操作：

保留旧 generation 不是自动降级保证。旧程序可能拒绝高版本格式；回退应恢复与旧程序相匹配的完整数据和配置副本。不要手动删除、改名或拼接 generation 来迫使程序读取旧文件。此前移除的 SQLite 权威持久化后端属于另一个历史边界，JSONL v0/v1 迁移不能被宣传成 SQLite 一键转换。

继续阅读 Session 使用与恢复指南，区分恢复、Fork、Compaction 与文件回滚。

插件接口：句柄、异步创建与单写者

新版持久化 create／open 返回 SessionHandle，日志读取、追加、flush 和 close 由句柄承担；agentLoop.create() 变为异步。JSONL 后端结合进程内所有权和平台锁约束写入者，读句柄也不能作为写句柄使用。

对直接操作 Session 的插件，必须重新核对创建、读取、归档、删除、恢复和关闭时机。没有作者证据或独立审阅时，应保留原适用版本，而不是给它贴上 alpha.1 兼容标签。遇到占用错误，先确认持有进程及正常退出路径，不能靠删除锁文件解除排他保护。

代理与模型发现有哪些限制

alpha.1 支持从启动环境读取 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 和 NO_PROXY。固定策略接受 HTTP(S) 代理，loopback 默认绕过；SOCKS、PAC 和 CIDR 绕过条目不能按普通 HTTP 代理配置理解。不受支持的值可能被跳过并导致直连，所以设置代理并不等于所有执行路径都不会直连。

模型发现增加自定义服务 models 对象与 Anthropic 原生列表的解析。返回的是供用户选择的候选信息，仍须保存并验证实际推理请求；已有 catalog 的路由可以不联网回答，不代表实时刷新整个模型目录。详见模型、Provider 与代理配置。

Agent Team 消息与普通子 Agent 分开理解

官方提到的 Agent Team send_message 调整涉及实验性团队实现：运行中成员按步骤边界接受 steer，空闲成员可开始后续工作，并在冷恢复投递中保留来源信息。固定包说明也明确其为实验性能力，不能据此声称 npm 默认 Web 已开放所有团队功能。

普通直属父子 Agent 与实验性团队虽然可能使用同名工具，关系边界和投递模型不同。现有 多 Agent 代码复核案例分别说明两者；不要外推成任意 Agent 通信或保证即时送达。

已知性能问题与评估清单

官方已注明部分历史 Session 加载可能变慢，并计划在后续版本修复。没有官方后续证据之前，不声称已经解决，也不把变慢等同于数据丢失。可参考Web UI 与会话异常分流。

评估前记录来源版本、目标版本、Profile、插件清单及可恢复的原始数据；在副本中分别核对列表、标题、旧会话内容、最小文本请求和必要插件。新增文件、格式错误、占用错误、加载时间异常应分别记录。失败时停止测试，保留证据与原环境，不把升级、清理日志和插件全量更新混在一起。

获取与下一步

本次查询未发现 alpha.1 精确 npm 包，因此本文不提供其 npm 安装命令。需要源码评估的维护者应从官方固定提交和对应构建文档确认环境与分发方式，本站尚未执行构建或运行验证。

• 第一次使用：按安装指南或完整入门使用锁定的 rc.1。
• 维护已有环境：先阅读更新与回退，保留旧环境的验证记录。
• 只想理解产品与版本：查看DeepSeek Harness 是什么。

版本分发可能继续变化，操作前重新查询官方 Release 和 npm。本文的日期、版本与证据等级描述的是本次固定来源审阅，不是对未来版本的承诺。