DeepSeek Harness v0.1.7-rc.1
DeepSeek Harness v0.1.7-rc.1：首个候选版本与迁移清单
- 作者
- DeepSeekAgent.io 编辑部
- 发布
- 更新
DeepSeek 于 2026 年 9 月 23 日发布 dsh-v0.1.7-rc.1。这是 0.1.7 系列的首个候选版本，将终端、远程工作区、Headless、MCP Resource、浏览器与 Computer Use、插件管理、Agent Team、Session V4 等一整组变化带入 rc 阶段。
对普通用户来说，最直观的变化是 DSH 已经不只是一块聊天界面：终端、文件预览、改动审阅、网页、Sub-agent 会话和 Team 状态都能进入侧边栏。对插件与自动化开发者来说，更重要的是配置存储、Agent Preset、Session、PTC、Remote 和插件兼容检查都发生了迁移。
发布与安装
| 检查项 | 当前状态 |
|---|---|
| GitHub Release | dsh-v0.1.7-rc.1，Pre-release |
| npm 完整版本 | 0.1.7-rc.1 已发布 |
| 后续版本 | 0.1.7-rc.2 已发布，并成为 npm latest 与 next |
| 版本定位 | 0.1.7 系列首个候选版本 |
需要复现 rc.1 时应固定完整版本：
npx @deepseek-ai/[email protected] web
新安装直接使用不带版本号的命令时，npm 当前会安装 rc.2，而不是 rc.1。排查版本差异时应先记录 dsh 的实际版本。
从聊天界面扩展到完整工作台
rc.1 把多项此前分散在 alpha 版本中的功能汇总到候选版本：
- Web 侧边栏终端支持多标签、Shell 选择与刷新恢复；
- 文件改动可在卡片或侧边栏中审阅，支持逐行和左右分栏 Diff；
- Word、Excel、PowerPoint、CSV 与 TSV 可直接预览；
- 指定 URL、Sub-agent 会话与提交计划可以在侧边栏打开；
- 长命令和工作流可进入后台，任务完成后重新唤醒原会话；
- Agent Team 面板实时展示成员与任务，可从会话页头切换成员。
这组变化重新定义了 DSH 的使用方式。Agent 不再只是生成答案，而是在同一工作区中读取文件、运行命令、交付文件、展示差异并等待用户审阅。第一次测试 rc.1 时，应使用一个包含文件修改、后台命令和最终交付物的完整任务，而不是只验证模型能否回复。
远程工作区、Headless 与 MCP Resource
DSH 现在可以本地运行界面与 Agent，同时通过 SSH 使用远端工作区。文件、命令与 PTC 工具都针对这一执行边界进行了扩展。Headless 也支持从标准输入接收任务、通过 --session-id 继续会话，并用 --json 输出逐行 JSON 事件。
MCP 升级至官方 SDK v2，加入协议协商、工具分页、Resource 发现和读取以及 URI Template。一个 MCP Server 即使没有 Tool，也可以只提供 Resource。
远程使用时需要分别确认三件事：DSH 运行在哪台机器、工作区文件实际位于哪里、命令由哪个系统用户执行。Web 用户终端使用系统用户权限，不受 Agent 沙箱模式约束，因此终端权限与 Agent Tool 权限不能混为一谈。
DeepSeek V4.1 与视觉输入
rc.1 调整了图片缩放、Token 估算、默认请求尺寸和编码质量，以适配 DeepSeek V4.1。它同时修复 pi-ai 将视觉模型误判为纯文本模型的问题，并允许手动修改输入类型。
官方 DeepSeek Adapter 只使用 Messages API，并通过 Files API 复用已上传图片。仍依赖旧 protocol 配置或 Chat Completions 地址的自定义配置需要迁移。模型页会保留真实模型 ID；排查图片没有进入请求时，应检查 Provider、模型 ID 与输入类型声明，而不是只看界面显示名。
Session V4：升级前先理解数据边界
Session 日志升级到 V4，并提供面向开发者的批量迁移工具。客户端 Session 也支持多个实例共存。与此同时，同步读取历史的 snapshotEvents、eventAt 和 ownEvents 被弃用，只存在于自定义事件中的附件不再自动读取或导出。
升级前建议：
- 结束正在写入的任务；
- 备份 Harness 主目录与关键工作区；
- 固定原版本，确认仍可回退运行；
- 在副本上打开长会话、含附件会话和 Sub-agent 会话；
- 确认迁移后的轮次、附件、任务与最终交付物完整；
- 再让新版本写入正式数据。
回退不等于数据格式倒退。新版本已经写入的 Session 数据，旧版本未必能够读取。
Plugin、Preset 与设置存储迁移
Plugin Manager 支持安装、配置、启停和运行时卸载，并在安装与启动阶段检查插件和 DSH 版本兼容性。插件可以声明无需重载的配置字段，Bundle 也能按顺序加载多个 patch 文件。
Agent Preset 改由插件 Bundle 声明与安装。设置页仍可查看和选择 Preset，但旧的目录式 Preset 需要迁移。设置本身改为保存在当前 Profile 的插件配置中，旧 settings.yaml 只尝试导入一次。
插件作者应重点检查：
agent/session-start是否已迁移到异步串行的agent/created；- 旧 PTC 包名、服务名与
workflow-ptc是否已经替换； - 工作区读取是否从旧接口迁移到
readBytes； spill-policy.maxInlineBytes是否改为maxInlineTokens；- Agent Preset 是否已经打包为插件 Bundle；
- 声明的 DSH 兼容范围是否覆盖 rc.1。
Agent Team 与 Sub-agent 的边界
实验性 Team 模式统一使用 spawn_teammate，关闭 subagent 和 subagent_fork，默认队友上限增至 16。可继续对话的 Sub-agent 链则默认最多保留 8 个活跃子代理，委派深度为 1。
两套机制面向不同的协作方式：Team 强调具名成员、任务板和持续协作；Sub-agent 更适合一次性或树状委派。升级后不要只检查工具名称是否存在，还要验证旧 Prompt、Profile 或插件使用的是哪一种协作模型。
安全与可靠性修复
rc.1 修复了 Windows 沙箱可能删除授权目录外文件的问题，并阻止跨工作区删除。它还修复大型流式工具参数阻塞整个进程、Native Addon 并发首次加载失败、长连接持续保留已消费数据等问题。
实验性的 Auto review、Browser 后端和 Computer Use 已进入版本，但“实验性”意味着应该用清晰的权限边界测试。建议把只读浏览、工作区写入、系统命令和本机交互拆成不同测试场景，分别记录审批是否出现、命令以谁的权限运行，以及失败后是否能够安全恢复。
rc.1 升级检查表
| 范围 | 升级后要验证的内容 |
|---|---|
| Session | V4 历史、附件、长会话和多实例占用提示 |
| DeepSeek Provider | Messages API、Files API、模型 ID 与图片输入 |
| 设置 | Profile 插件配置已接管，旧 settings.yaml 导入结果正确 |
| Preset | 旧目录 Preset 已迁移为 Bundle |
| 插件 | 兼容范围、运行时卸载、热更新与失败恢复 |
| Remote | SSH 文件、命令、二进制预览和执行用户符合预期 |
| Agent Team | spawn_teammate、成员上限与任务板流程 |
| 安全 | Windows 删除边界、终端权限与审批流程 |
rc.1 是 0.1.7 架构进入候选阶段的分界点。普通用户可以把它理解为“DSH 工作台化”的版本；维护 Profile、插件或长期 Session 的用户，则应把它当作一次明确的数据与扩展接口迁移。
相关阅读
- DeepSeek Harness v0.1.7-alpha.2 更新
- DeepSeek Harness v0.1.7-rc.2 更新
- DeepSeek Harness 插件管理机制
- DeepSeek Harness 远程开发方案
参考资料
- DeepSeek Harness v0.1.7-rc.1 官方 Release
- v0.1.5-rc.3 至 v0.1.7-rc.1 完整变更
- npm 上的 @deepseek-ai/dsh 0.1.7-rc.1
常见问题
rc.1 现在还是 npm 默认版本吗？
不是。npm latest 和 next 已经更新到 0.1.7-rc.2。只有固定完整版本号时才会安装 rc.1。
普通用户最需要关注什么？
先备份 Session 和设置，再验证模型、图片、文件修改、后台任务与最终交付流程。若没有自定义插件或 Preset，不需要逐项处理开发接口。
rc.1 可以直接当稳定版使用吗？
它是候选版本，GitHub 仍标记为 Pre-release。长期任务和重要工作区应固定版本并保留可验证的备份。