DeepSeek Harness v0.2.1-rc.1:插件、上下文与迁移

作者
DeepSeekAgent.io 编辑部
发布
更新

DeepSeek Harness v0.2.1-rc.1 是 0.2.1 系列的第一个候选版本。它把此前多个 alpha 版本中的插件、模型、Session、工作区和上下文能力收束到一条可升级测试的版本线上。与单一功能更新相比,这一版更重要的是接口与行为开始定型。

版本状态与安装

npx @deepseek-ai/[email protected] web

发布时 npm latest 仍指向 0.2.0-rc.2。需要测试 0.2.1 候选版本时,应固定版本号或使用 next,不要把预发布环境与生产 Profile 混用。

插件体系进入完整工作流

0.2.1 系列支持自定义插件源、Agent 辅助创建插件、依赖同步和热重载。Minimal 模式可以加载可选插件,也加入了 Claude Code 与 Codex Bundle。实验性的 Claude Code Mods 兼容层为迁移现有扩展提供入口,但原生 DSH Plugin 仍拥有更完整的生命周期和能力边界。

插件兼容性以 engines.dsh 为主。团队内部插件需要补齐版本声明,并分别验证安装、启停、依赖安装、重载和卸载,不应只以“能出现在列表里”作为兼容标准。

模型、工具与上下文

自定义模型可以声明推理档位;动态工具和系统提示更新减少了长期 Session 中不必要的固定状态。Minimal 支持图片读取和自动上下文压缩,并提供 /compact 手动入口。Sub-agent 可以拥有独立 Preset,等待行为也得到调整。

这些变化直接影响长任务的 Token 曲线。升级后应记录压缩前后上下文大小、工具列表变化、父子 Session 用量,以及模型供应商返回的实际计费数据。

工作区、远程与 SDK

候选版补充工作目录工具与 SDK、SSH Helper Runtime、Git Worktree 支持,以及更完整的 Session 状态 API。AGENTS.md 共享位置也发生变化。SDK 恢复 Session 的调用方式、Remote 连接和 Headless 参数都应纳入迁移测试。

Web 部署新增或强化了 --public-url、IPv4/IPv6 与 TLS 场景。反向代理部署需要同时核对公开地址、路径前缀、WebSocket、Cookie 和可信 Host,不能只确认首页可以打开。

需要注意的迁移变化

  • Web 与 Desktop 保存的凭据,和 Headless 使用的环境变量或 .env,属于不同配置路径。
  • 旧 invariant 导出被移除,依赖内部接口的插件需要修改。
  • 插件子路径元数据与 engines.dsh 成为兼容性重点。
  • 统计被拆分为 activity 与 usage;读取旧统计结构的代码要适配。
  • Agent Team Inbox 接口发生变化。
  • Python PTC 使用新的沙箱边界,旧 both 模式被移除。
  • Azure Provider 命名调整,现有配置需要核对。
  • SDK Session 恢复、公开 URL 与网络监听参数需要重新验证。

谁适合升级

正在开发插件、使用 Remote/Headless、依赖长 Session 压缩或测试多 Agent 的团队,可以在隔离 Profile 中升级。只需要稳定 Web UI 的用户,可以继续使用 npm latest,等待 0.2.1 进入稳定通道。

参考资料