DeepSeek Harness v0.2.1-alpha.3

DeepSeek Harness v0.2.1-alpha.3：图片、压缩与子智能体预设

作者: DeepSeekAgent.io 编辑部
发布: 2026年10月15日
更新: 2026年10月15日

DeepSeek Harness v0.2.1-alpha.3 于 2026 年 10 月 14 日作为预发布版本上线。它没有改变 npm 默认安装通道：latest 与 next 仍指向 0.2.0-rc.2，只有明确安装 0.2.1-alpha.3 或使用 alpha 标签的用户会进入这一版本。

这次更新的重点不是增加一个孤立功能，而是把长任务运行中的几个断点连了起来：Minimal 模式可以读取图片和压缩长对话，Sub-agent 可以使用独立 Agent Preset，SDK 可以恢复已有会话，插件更新后也不再继续运行旧代码。与此同时，凭据读取顺序与 Azure Provider 名称发生了需要迁移的变化。

主要变化

范围	alpha.3 的变化
Minimal 模式	支持图片输入和长对话自动压缩
上下文管理	Web 与桌面端可用 `/compact` 手动压缩当前会话
Sub-agent	可为派生的子智能体指定独立 Agent Preset
SDK	TypeScript 与 Python SDK 支持恢复已保存的 Session
插件运行时	更新或重装后不再继续执行旧插件代码
凭据	Web/桌面优先读取已保存凭据；Headless 默认使用环境变量和 `.env`
Provider	Azure Provider ID 统一为 `azure`，旧名称需要迁移
PTC Mode	Node 执行环境增加可选的 in-memory 模式

Minimal 模式开始承担完整的模型评测输入

Minimal 模式原本强调尽可能小的工具面，用固定环境观察模型本身的 Agent 能力。alpha.3 为它补上图片读取能力，视觉模型不必切换到 Standard Profile 才能处理截图、图表或界面问题。模型仍需在目录中声明图片输入能力；仅仅把一个自定义模型 ID 填进设置页，不会自动获得视觉能力。

另一个变化是长对话自动压缩。模型评测经常需要连续运行多轮工具调用，完整历史持续进入请求会推高输入 Token，也可能让早期结果淹没当前任务。alpha.3 可以在上下文增长后自动生成压缩表示；Web 与桌面端还可以输入：

/compact

手动触发压缩。它适合任务已经完成一个阶段、即将进入下一阶段时使用。压缩不是删除磁盘上的 Session，也不是清空 Trajectory；它改变的是下一次模型调用使用的上下文表示。关键约束、尚未完成的目标和必须保留的数值，仍应在压缩前明确写入会话或工作文件。

Sub-agent 可以拥有独立 Agent Preset

此前创建 Sub-agent 时，角色说明、工具范围与运行环境经常需要由编排提示临时组合。alpha.3 支持为派生的 Sub-agent 选择独立 Agent Preset，把角色和工具配置放进一个可复用单元。

这使团队式工作流更容易稳定复现。例如主 Agent 负责拆解任务，可以分别派生：

只读仓库和运行测试的审查 Agent；
允许修改前端文件但不能发布的实现 Agent；
只访问研究资料、不接触项目凭据的资料 Agent。

Preset 解决的是可重复配置，不会替代权限边界。子智能体实际能使用什么，仍取决于启动后的插件、工作区授权和宿主环境。

alpha.3 还调整了委派与等待指引：达到委派深度上限前会提前提示；主 Agent 等待正在运行的子任务时，不再额外消耗新的目标执行轮次。这对大量并行任务尤为重要，可以减少“只是等待，却继续推进轮次计数”的情况。

SDK 的 resume 补上长任务恢复路径

TypeScript 与 Python SDK 新增 Session resume。恢复后继续沿用原来的 Session ID 和工作目录，因此调用方不必把一次长任务强行放在单个进程生命周期内。

典型用途包括：

服务重启后继续用户尚未完成的任务；
把需要人工确认的任务暂停，收到回复后继续；
在队列工作进程之间交接长任务，同时保留 Trajectory；
重新进入同一工作区时延续上下文，而不是复制成一个没有历史关系的新会话。

恢复能力不等于任意版本之间都兼容。升级 alpha 版本前仍应备份 ~/.dsh，并先用非关键 Session 验证格式迁移和插件依赖。

插件更新终于能替换正在运行的旧代码

alpha.3 修复了插件更新或重新安装后仍运行旧代码的问题。支持热重载的插件会直接换成新版本；无法安全热重载的情况会明确提示重启。

这个修复影响的不只是开发插件时的体验。生产式长会话如果同时存在旧实例和新文件，界面显示的版本、配置和实际执行逻辑可能不一致。升级后应关注系统给出的重启提示，而不是默认“安装成功”就表示当前会话已经切换。

本次还修复了卸载 Session 存储插件时最后记录可能丢失的问题，并改善插件页在窄窗口下的布局。

两项升级前必须检查的配置变化

1. 凭据读取优先级

Web 与桌面端现在优先使用已经保存的凭据。Headless 则默认从环境变量和 .env 读取，不再读取保存于应用中的密钥。

因此同一台机器上“Web 能调用、Headless 报 MISSING_CREDENTIAL”不一定是模型配置丢失，而可能是两个入口采用了不同来源。自动化和 CI 应显式提供环境变量，不要依赖曾经在 Web 设置页保存过一次的 Key。

2. Azure Provider ID

Azure Provider 名称统一为 azure。使用旧 ID azure-openai-responses 的配置需要迁移。升级前搜索 Profile、机器补丁和自定义 Bundle 中的旧名称，并在副本上验证 Base URL、部署名、协议和凭据引用。

不要只修改界面显示名称。Provider ID 会参与模型引用和配置合并，残留旧 ID 可能表现为模型消失、默认选择失效或凭据无法匹配。

PTC Mode 的 in-memory Node 环境

PTC Mode 的 Node 执行环境增加了可选的 in-memory 模式。连续执行代码时可以复用变量、函数和已经导入的模块，不必让每次工具调用都从空进程重新构造状态。

它适合数据清洗、分阶段分析和需要复用客户端实例的任务。代价是执行之间存在状态：前一步修改过的对象、缓存或连接可能影响下一步。需要严格复现时，应明确初始化状态，或者继续使用隔离执行。

会话与界面修复

alpha.3 同时处理了一组直接影响日常使用的问题：

切换 Session、收起工作过程或发送后续消息时的大块空白和滚动跳动；
应用重启后部分 Session 无法继续；
切换到 DeepSeek 模型后旧历史消息导致请求失败；
远程 Web 在网络拥塞时被误判为断线；
刷新远程 Web 后语言、主题等偏好丢失；
应用意外退出后，未完成任务被错误显示成正常完成；
较旧 Git 版本无法创建 worktree；
macOS 工作区目录选择器不能粘贴路径或取消后仍添加目录。

会话意外中断后现在会明确显示“任务已停止”。这比把中断误认为完成更重要：用户可以据此决定恢复、重试还是检查已经产生的部分结果。

是否应该升级

普通用户继续使用 npm latest 的 0.2.0-rc.2。alpha.3 更适合需要以下能力的人：

在 Minimal 模式测试视觉模型；
使用 /compact 控制长会话上下文；
为 Sub-agent 配置独立 Preset；
通过 TypeScript 或 Python SDK 恢复 Session；
开发、更新和热重载插件；
验证新的凭据与 Azure Provider 配置。

测试时固定完整版本号：

npx @deepseek-ai/[email protected] web

升级前备份 Profile、Session 与插件配置。使用 Headless、Azure 或自定义 Provider 的用户，应先完成凭据来源和 Provider ID 检查，再把该版本用于长期任务。