DeepSeek Harness 发布 v0.1.3-alpha.1：强化文件上传与会话持久化，但仍处于开发者预览
DeepSeek Harness 于 2026-09-04 发布 v0.1.3-alpha.1，带来通用文件上传、代理环境变量支持、Intel Mac Python runtime 与模型探测改进，并对 Session 持久化 API 做出破坏性调整。官方标注为预发布并警示存在性能回退，建议开发者在隔离环境中验证迁移与兼容性后再升级。
DeepSeek Harness 于 2026-09-04 发布 v0.1.3-alpha.1，带来通用文件上传、代理环境变量支持、Intel Mac Python runtime 与模型探测改进，并对 Session 持久化 API 做出破坏性调整。官方标注为预发布并警示存在性能回退，建议开发者在隔离环境中验证迁移与兼容性后再升级。
DeepSeek 官方开源项目 DeepSeek Harness 于 2026 年 9 月 4 日发布 v0.1.3-alpha.1。这是一次面向 Agent 运行时和开发工具的增量更新，重点涉及通用文件上传、网络代理配置、模型探测、Python SDK 运行时以及 Session 持久化 API。
不过，官方仍将该版本标记为 Pre-release，并明确提醒存在已知的性能回退。它不是新的基础模型发布，也不意味着 DeepSeek Harness 已经具备生产级稳定性或完成安全审计。
从图片输入扩展到通用文件工作流
此次更新最直观的变化，是 Web 端开始支持上传任意类型的通用文件。文件和图片可以在同一个预览区域混排，后台上传会显示进度，也支持取消；用户切换会话后，仍可以继续查看上传状态。
文件上传完成后，模型可以通过已保存的路径，按需调用现有文件工具读取内容。换句话说，更新并不是简单地把更多附件显示在聊天界面中，而是试图把文件的上传、保存、查看和工具读取纳入同一条 Agent 工作流。
对于需要处理代码、配置文件、日志或其他非图片材料的 Agent，这种变化可以减少用户在不同文件传输机制之间切换的需要。但发布说明没有提供文件大小限制、支持的具体文件类型、上传失败率或大文件处理性能等数据，因此目前只能确认功能边界发生了扩展，不能据此推断其已经适合高强度生产场景。
网络请求开始统一遵循代理环境变量
v0.1.3-alpha.1 还规定，所有出站网络请求都应遵循启动环境中的 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 和 NO_PROXY 配置。
这项变化对需要在企业网络、受限网络或带有统一出口策略的环境中运行 Agent 的开发者尤其重要。Agent 的实际工作通常不只包含模型调用，还可能涉及网页访问、软件包下载、工具服务和子代理通信。如果不同组件对代理设置的处理方式不一致，就可能出现部分请求无法连接、流量绕过审计或开发环境与生产环境行为不同等问题。
不过，“遵循代理环境变量”描述的是运行时行为，并不等同于完成了网络隔离、访问控制或安全审计。代理是否真正限制了哪些域名可以访问、哪些凭据可以被使用，仍取决于外部网络策略和具体插件配置。
Python SDK 增加 Intel Mac 运行时支持
Python SDK 新增 macOS x64 runtime wheel，使采用 Intel 架构处理器的 Mac 可以安装并运行随包提供的 runtime。这个改动扩大了本地开发环境的覆盖范围，但官方没有在本次说明中披露不同硬件上的性能数据，也没有表示该运行时已经覆盖所有平台组合。
此外，更新还调整了模型探测能力。自定义模型提供商的 models 对象和 Anthropic 原生模型列表现在可以被识别，系统也能够在需要时回填模型名称、上下文窗口和最大输出 token 等信息。
这类元数据补全有助于运行时在不同模型提供商之间建立更一致的模型目录。不过，模型探测成功并不意味着所有模型都具备相同的工具调用、上下文处理或输出控制能力。模型名称和窗口信息被识别出来后，实际兼容性仍需要由开发者逐一验证。
Session API 发生破坏性变化
本次版本最需要开发者关注的部分，可能不是界面功能，而是 Session 持久化 API 的调整。
官方表示，Session persistence API 现在由具有生命周期范围的 SessionHandle 持有；agentLoop.create() 改为异步调用，并新增 Session 锁，确保同一个 Session 同时最多由一个进程持有。这意味着依赖旧 API 的插件或集成代码，可能需要修改初始化、打开和并发访问逻辑。
Session 格式也升级至 v2。官方称，旧的 v0 和 v1 日志可以通过不可变的相邻 generation 迁移到当前格式；Assistant 流会按照 attempt 聚合为持久化 settlement，而 Web 界面仍保留实时增量显示。
DeepSeek Harness 的官方 Session 文档 将 Session 描述为一种追加写入的事件日志：模型消息历史由事件日志推导而来，而不是被单独存储。这样的设计有利于恢复、重放和检查 Agent 的完整运行轨迹，但也使日志格式、迁移规则和并发持有关系成为升级时必须考虑的工程问题。
AIFlux 此前报道的 DeepSeek Harness v0.1.2-alpha.3 更新已经把重点放在长会话导航、图片消息传递和持久化后端变化上。此次 alpha.1 则进一步触及 Session 的生命周期和数据格式，显示该项目仍在快速调整 Agent 运行时的基础接口。
已知性能回退使升级需要更谨慎
官方在发布说明中明确指出，v0.1.3-alpha.1 存在一项已知性能回退，可能影响部分历史 Session 的加载响应速度，并表示将在下一个版本中修复。
这项提醒与 Session v2 迁移结合起来看，意味着使用者需要把升级分成两个问题处理：一是新版本是否能够正确读取旧日志，二是读取旧日志时的响应速度是否满足实际工作需要。对于依赖长会话、持续子 Agent 或大量工具调用记录的开发环境，最好先在副本上验证迁移和恢复流程，再替换现有运行时。
这也说明，Agent 基础设施的可靠性并不只取决于模型本身。文件上传是否可追踪、网络出口是否符合预期、工具调用是否能在流式传输中恢复，以及 Session 是否可以稳定加载，都会影响一个 Agent 能否持续完成复杂任务。
DeepSeek Harness 仍不是稳定产品
DeepSeek 官方将 Harness 定位为面向全球 Agent harness 开发者的开发者预览项目。其官方介绍强调“Everything is a plugin”，模型、工具、技能、Session、沙箱、存储、循环、调度和用户界面都可以通过插件组合或替换。项目仓库同时提醒，项目仍在快速迭代，并且会出现兼容性破坏性变化。
这种插件化架构为开发者提供了较大的组合空间，也使不同运行模式、工具链和 Session 实现能够被放在同一个框架中测试。但它同时增加了部署时的判断成本：用户需要了解插件来源、文件权限、网络范围、凭据生命周期和数据迁移路径，而不能把“开源”或“可运行”直接等同于“安全”或“生产就绪”。
在其他 Agent 运行时事件中，研究人员也曾关注多个代理如何共享外部页面、网络出口或沙箱信息。AIFlux 对一起疑似代理越过受控环境边界事件的报道所反映的一个共同问题是，模型能力之外，工具权限、网络通信和运行生命周期同样构成安全边界。对 DeepSeek Harness 来说，新增代理环境变量支持和 Session 锁可以改善可控性，但不能替代完整的权限设计和独立安全评估。
截至目前，可以确认的是，v0.1.3-alpha.1 扩展了通用文件工作流，统一了部分网络代理行为，增加了 Intel Mac runtime，并对模型探测及 Session API 作出调整。尚不清楚的是，已知性能回退的具体触发条件、Session v2 在不同历史日志规模下的加载表现，以及这些改动何时会进入稳定版本。
对开发者而言，这次发布更像是一次基础设施演进中的预览节点，而不是可以无条件升级的正式版本。对于希望试用的团队，保留旧版本、备份 Session、检查插件兼容性，并在隔离环境中验证网络和文件权限，仍是必要的准备工作。
来源
不错过任何一条 AI 大事
订阅 AIFlux 早报，每天 3 分钟看懂产业动态。
