10 个关键问题 Q&A
Q1：DeepSeek Harness dsh-v0.1.6-alpha.1 是什么版本，能否直接上生产？A：预发布 Alpha 测试版，存在大量破坏性接口变更，仅用于本地实验、智能体能力评估，禁止直接用于生产。
Q2：本次最大的能力更新是什么？A：MCP 升级官方 SDK v2，新增实验性 Browser Use 浏览器操作、Computer Use 本机桌面操控，让 Agent 具备网页浏览与本机计算机操作能力。
Q3：MCP v2 带来哪些变化？A：支持协议协商、工具分页读取、资源发现与 URI 模板，兼容无工具的 MCP 服务，可在 Profile 配置后使用共享资源。
Q4：SSH 远端工作区功能怎么理解？A：DSH 本体在本地运行，但文件访问、命令、PTC 工具可通过 SSH 连接远端服务器，在远端工作区执行任务。
Q5：升级后 DeepSeek API 连接有什么 breaking 改动？A：默认切换 Messages 协议，支持 Files API 复用上传图片；旧自定义根地址需要删除或改为
https://api.deepseek.com/anthropic。Q6：PTC 相关有哪些需要迁移的改动？A：PTC 包名统一改为 ptc-runtime；工作流执行器改为 workflow-ptc，暂不支持 Python PTC；Node PTC 改用独立进程隔离。
Q7：Node PTC 独立进程执行有什么影响？A：进程环境
process.env为空，有输出与堆内存限制；依赖原有环境变量的自定义代码需要改造适配。Q8：Team 子代理模式改动是什么？A：废弃 subagent/subagent_fork，统一使用 spawn_teammate；队友创建上限从 8 提升至 16。
Q9：Headless 模式新增参数有什么用途？A：
--session-id继续已有会话，--json逐行输出 JSON 运行事件，stdin 接收任务，适合自动化批量评估脚本。Q10：配置热更新行为有什么变化？A：取消事务回滚；配置解析失败保留旧配置；插件激活失败可能部分生效，需要手动修正配置恢复。
-
附录 DeepSeek Harness dsh-v0.1.6-alpha.1 版本
DeepSeek Harness（简称 DSH）是 DeepSeek 开源的插件化 AI 智能体运行框架，核心思想：Agent = 大模型 + Harness，给模型提供文件、Shell、浏览器、桌面操作等执行能力，基于 Cordis 微内核，MIT 协议，当前处于开发者预览阶段，alpha 版本存在大量破坏性变更。本次版本：v0.1.6-alpha.1（Pre-release，预发布版），对比基线 dsh-v0.1.5-rc.2
一、新增能力（最大亮点）
- MCP 升级到官方 SDK v2
支持协议协商、工具分页、无工具的 MCP 服务；新增 MCP 资源发现 / 读取、URI 模板，配置 Profile 后可使用共享资源工具，MCP 生态兼容性大幅提升。 - 实验性 Browser Use（浏览器操控）
内置 Playwright MCP、Chrome DevTools MCP、Stagehand 三套浏览器后端，Agent 可直接驱动浏览器上网、操作页面。 - 实验性 Computer Use（本机电脑操作）
通过 Cua Driver MCP 或原生驱动，截图 + 操控本机桌面，是端侧计算机使用能力。 - Web 侧边栏内置终端
多标签、Shell 切换、页面刷新自动恢复终端会话，WebUI 内直接跑命令。 - Headless 无界面模式增强
支持 stdin 输入任务、 --session-id恢复历史会话、--json逐行输出事件流，适合自动化 / 批量评估。 - SSH 远端工作区
DSH 本地运行，但文件、命令、PTC 工具可以走 SSH 连接远端服务器工作区。 - 会话管理增强
设置页增加已归档会话列表，可查看、恢复归档会话；新增实验 Auto review 自动评审模式。 - Team 子代理模式升级
统一使用 spawn_teammate，废弃subagent/subagent_fork；队友创建上限从 8 提升至 16。
二、体验优化
-
文件、Skill 引用、交付文件链接默认侧边栏预览；图片 / PDF 自适应面板，文件树滚动位置保留。 -
Trajectory（执行轨迹）可展开复制 JSON，查看 PTC 代码与调用结果，推理块默认展开，恢复运行耗时统计。 -
适配 DeepSeek V4.1：上调图片默认尺寸、编码质量，优化图片 Token 估算。 -
Node PTC run_code支持单次超时配置：默认 120s，上限 600s。 -
Mermaid 图表支持全屏、缩放、平移；Web 终端文字 / 光标对比度提升。 -
输入框 UI 重构：加号菜单整合文件上传，移除独立附件按钮；区分自动 / 手动重连提示。
三、破坏性变更（⚠️升级必看，配置 / 插件需要迁移）
这是 alpha 版本重点，很多旧配置、自定义插件直接失效
- DeepSeek 模型默认切换为 Messages 协议
，复用 Files API 上传图片； 注意：如果你手动配置旧官方根地址，需要删掉，或改为
https://api.deepseek.com/anthropic -
默认关闭 Ralph，需要手动开启。 - 移除内置 E2B 执行后端
，使用 E2B 的自定义配置必须修改。 -
PTC 包名、服务统一改为 ptc-runtime系列，旧名称不再兼容。 -
工作流执行器重命名为 workflow-ptc，暂不支持 Python PTC。 -
Node PTC 改为独立进程隔离执行： process.env为空，依赖旧环境变量的代码要改造；增加输出、堆内存限制。 -
事件接口变更： agent/session-start替换为异步串行agent/created；弃用同步历史接口snapshotEvents / eventAt / ownEvents。 -
配置热更新取消事务回滚：配置解析失败保留旧配置；插件激活失败可能部分生效，不会整体回滚。 -
图片缓存路径迁移： DSH_HOME/cache/attachments/request-images，删除缓存目录可重建。
四、Bug 修复重点
-
修复会话排序、会话分叉时错误带入后续输入 / 设置的问题。 -
修复工具描述含双花括号 {{ }}时 PTC 提示词生成失败。 -
Linux 子进程退出清理、进程等待逻辑修复。 -
子代理通知只传递正文，解决推理块导致父会话 Messages 请求失败。 -
文件编辑卡片修正增删行数统计，大段替换改为整段展示。 -
Markdown 表格 hover / 聚焦页面跳动问题修复；Web 服务恢复后模块路由注册修复。
五、新增事件与可观测性
新增image offload会话事件，记录请求中省略的历史图片，会话分叉、恢复时保留图片省略记录；DeepSeek 官方 API 模式下，可实验性上报会话事件（可关闭）。
关键解读
- 定位
本次版本把 DSH 从「代码 Agent」推向通用计算机智能体，MCP v2 + Browser Use + Computer Use 是核心一步，对标 Claude Computer Use / OpenAI Computer Use。 - MCP v2
是整个版本的底层基石，打通资源读取、工具分页，让 DSH 可以无缝接入海量 MCP 生态。 - 兼容性风险极高
大量重命名、接口废弃、执行环境隔离变更，不要直接升级生产环境，仅适合本地实验、评估。 - 模型对齐
专门针对 DeepSeek V4.1 做多模态图片处理优化，同时切换 Messages 协议，更好对接 DeepSeek 官方 API。