小鲸鱼交卷DSH v0.2.2-rc.1：811 个 commit，移动端、多语言、插件管理全面升级就位

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}

DeepSeek Harness v0.2.2-rc.1：811 个 commit 的答卷，移动端、多语言、工作树全面就位

0.2.2 系列首个候选版，一次横跨数周的汇总

11 月 4 日，DeepSeek Harness 发布了 v0.2.2-rc.1。

这是 0.2.2 系列的首个候选版本，官方说明写得很清楚：

作为 0.2.2 系列的首个候选版本，本版本汇总了自 v0.2.1-rc.5 以来的主要用户和开发者相关变更。

发布说明里还有一行小字：811 commits to master since this release。八百多个 commit，横跨数周的高密度迭代，被一次性收拢成这个候选版本。

这一版没有单一“炸裂”的新功能，但它的广度和密度令人侧目：移动端适配、多语言大扩容、插件管理升级、实验性插件四连发、聊天引用与历史导出、WebSocket 压缩、Node.js 版本提升……几乎每一个维度都有实质性的推进。

下面我们分板块梳理。

在这里插入图片描述

一、移动端与平板：这次是认真适配了

完善手机和平板适配，优化软键盘交互、导航与窄屏布局，保持菜单和操作入口可用。

这是本版本最值得普通用户关注的变化之一。具体包括：

减少自动弹出软键盘，发送后收起键盘；
修正键盘平移页面时的光标滚动；
窄屏浏览器设置页采用全屏与横向导航，聚焦项自动完整滚入可见区；
触屏任务文本输入使用 16px 字号，避免 iOS 自动缩放；
触屏动作不再被悬停提示阻挡，工作区与归档结果操作直接可达；
宽 Markdown 表格在局部容器中滚动，不再撑破布局；
同名工作区在选择器中显示最短区分路径后缀，窄屏优先保留后缀。

这些改动看起来细碎，但放在一起，指向一个明确的目标：DSH 的 Web 端在手机上真正可用了。以前在手机上操作 DSH，软键盘乱弹、菜单点不到、表格撑破屏幕——现在这些问题被系统性地处理了。

二、多语言大扩容：一次加了六种语言

新增日语、西班牙语、法语、德语、俄语和巴西葡萄牙语文案与界面配置。

DSH 的国际化在这一版迈出了一大步。加上此前已有的中文和英文，界面语言覆盖范围大幅扩展。对于全球开发者社区来说，这是一个积极的信号——DSH 不再只是中英文用户的工具。

三、聊天体验：引用、导出、折叠、定位

聊天文本作为引用插入输入框

支持将聊天文本作为引用插入输入框，并在发送后显示紧凑预览。

以前引用一段聊天内容，可能需要手动复制粘贴。现在可以直接把聊天文本作为引用插入输入框，发送后显示紧凑预览。对话中的“引用回复”体验更自然了。

完整历史会话复制为 Markdown

支持将完整历史会话复制为 Markdown，包含可用的原始日志路径。

这是一个知识沉淀的实用功能。你可以把整段会话导出为 Markdown，包含原始日志路径，方便归档、分享或二次整理。

工作步骤收起后保留全部助手文字回复

工作步骤收起后保留全部助手文字回复，可切换为仅最终回答。

工作步骤收起后，助手的文字回复仍然保留，你可以选择查看全部回复，或切换为仅最终回答。对于长对话，这个开关很实用。

文件行号链接高亮定位

点击聊天中的文件行号链接后，代码和文本预览以短暂高亮标出目标行并淡出。

点击聊天里的文件行号链接，预览会短暂高亮目标行然后淡出。定位代码更方便。

四、插件管理：富文本详情、第三方更新、失败诊断

富文本详情与布局改善

插件管理页支持展示富文本详情，并改善页面布局和导航行为。

插件详情不再是纯文本，支持富文本展示，页面布局和导航也得到改善。

第三方插件包更新与回滚

插件管理支持更新第三方插件包；热更新失败时会尝试恢复旧版本。

第三方插件现在可以在管理页直接更新。更重要的是，热更新失败时会尝试恢复旧版本——这是一个安全网，避免更新失败导致插件不可用。

安装失败诊断

插件安装失败时显示完整诊断与 Host 日志入口，并区分安装失败和安装后启用失败。

安装失败时，不再只报一个模糊错误，而是显示完整诊断和 Host 日志入口，并区分“安装失败”和“安装后启用失败”。排查插件问题更容易了。

自定义插件索引

「自定义插件市场」更名为「自定义插件索引」，发现页读取用户添加的索引文件，索引生成器排除标记为 private 的版本、标签与默认分支包。

五、实验性插件四连发

这一版带来了四个实验性插件，覆盖不同场景：

subagent_oar：把任务交给本机 Codex 或 Claude CLI

新增实验性「subagent_oar 工具」插件，可将独立任务交给本机 Codex 或 Claude CLI。

这是一个跨工具协作的能力。你可以把独立任务交给本机安装的 Codex 或 Claude CLI 执行，让 DSH 成为多工具编排的入口。

个性化推荐

新增实验性「个性化推荐」插件，按需在回答下方提供官方插件启用卡片或个性化页面创建卡片。

根据使用场景，按需在回答下方推荐官方插件或个性化页面。不打扰，但需要时能发现新能力。

开发者工具 – 统计

新增实验性「开发者工具 – 统计」插件，按轮次和步骤查看上下文、缓存、模型与工具耗时等统计。

按轮次和步骤查看：

上下文用量
缓存命中
模型耗时
工具耗时

对于调优 Agent 行为、分析成本来说，这是一个很有价值的观测工具。

变更请求与工作树

新增实验性「变更请求与工作树」：在独立 Git 工作树中运行会话，通过可搜索文件树和逐文件导航查看本地及 PR 差异，将选中代码和评论交给 Agent，并跟踪检查与评审状态。

这是本版本最有分量的实验性能力。它把之前 alpha 阶段的 Git Worktrees 插件正式整合进来，并大幅增强：

在独立 Git 工作树中运行会话，不干扰主工作区；
可搜索文件树和逐文件导航查看本地及 PR 差异；
将选中代码和评论交给 Agent；
跟踪检查与评审状态。

这意味着 DSH 正在把 code review 和工作树隔离做成内置能力，而不只是外部插件。注意：此前启用独立 dsh-experimental-tool-worktree 插件的用户，需要手动从 profile 的 dsh.profile.bundles 中移除该插件。

六、体验优化精选

侧栏与导航

会话列表支持插件图标，并改善键盘与触屏操作。
侧栏会话悬浮卡显示工作目录，便于区分未分组或同名会话。
侧栏搜索支持不区分大小写的会话 ID 子串匹配。
悬浮侧栏面板拖过屏幕边缘时有阻力，松手后弹回可见区域。
支持中键关闭右侧栏标签，关闭后台标签不改变当前选中项。

输入与消息

消息在宿主确认接收后才显示并清空草稿；发送期间输入框只读，发送失败时保留草稿、引用和附件。
图片上传方式调整为进入输入框后立即上传，发送消息时复用已上传的图片；默认单张图片上限提高到 50 MiB。
运行状态位于当前工作轮次尾部、待处理插话之前，方便区分运行中和排队中的消息。

预览与轨迹

Trajectory 结果页新增实时工具返回值的原始 JSON 查看，并与渲染结果上下展示。
Trajectory 支持独立折叠子调用，保留父调用和摘要。
文本和 Markdown 文件预览在刷新后保留阅读位置，文件暂时变短时也保留原位置。

模型与搜索

模型选择器默认勾选已配置模型，可一次添加或移除候选并保留自定义值。
支持在 DeepSeek 与 pi-ai 提供商内拖动或用方向键排序模型。
Search 功能优先向模型提供 Search API 长摘要，默认每来源最多 800 字符；搜索卡片仍展示短摘录。

性能与网络

远程连接默认启用 WebSocket 压缩，减少大量历史消息的传输量；可通过 websocketCompression 关闭。
Web 静态资源支持 ETag 条件请求，未变化的资源返回 304。
加快带固定目录前缀的文件查找，跳过无关目录。
减少会话状态更新时的重复发布和目录处理开销，降低长回复流式组装的运行时成本。

macOS Computer Use 权限引导

改善 macOS Computer Use 的系统与应用权限引导，通过独立应用申请系统权限，提供系统设置与应用拖入引导，应用授权可跨重启保留。

七、问题修复精选

这一版的修复列表非常长，挑几个重点：

全局与项目 AGENTS.md 分别使用 maxBytes 预算，避免项目指令挤掉全局指令。
切换到较小上下文模型前先用原模型压缩历史；失败时停止切换并保留原请求头。
使用 Gemini 的 OpenAI 兼容 Chat Completions 接口时，工具调用会保留并带回所需的思考签名。
系统提示词未变化时，新一轮模型请求可继续复用已有上下文前缀缓存。
通过 pi-ai 接入的模型在会话图片超过请求数量上限时，自动省略最早的图片并继续请求。
缺少所需凭据时不向模型提供 Web 搜索工具。
修复关闭应用时 Auto 会话权限意外变成完全访问的问题，保留已保存的权限与审批策略。
修复 macOS 持久 Bash 工具中感叹号被历史展开改写或导致命令超时的问题。
修复一个技能根目录读取失败导致其他目录中的技能也不可用的问题，保留可用技能并提示不完整结果。
修复包含旧版子代理描述的历史会话无法打开，并导致会话搜索失败的问题。
修复加载更早的已压缩会话历史后，聊天记录停止加载和更新的问题。
本地文件工具将开头的 ~ 或 ~/ 正确展开为宿主主目录，路径中间的 ~ 保持字面含义。
聊天中的相对文件链接按点击时会话当前工作目录打开，进入 worktree 后不再误开原项目文件。
修复裸 URL 将后续中文标点及正文一并识别为链接的问题。
修复 Markdown 中 Windows 文件路径的反斜杠被转义删除的问题。
修复部分结构体代码高亮导致页面长时间卡死的问题。
修复以管理员权限运行 DSH 或在 Windows Sandbox 中使用时，受限沙箱命令无法启动的问题。
修复 macOS 原生目录选择框初次显示后灰显、目录无法点击的问题。

八、⚠️ 其他变更：开发者必须关注

Node.js 最低版本提高至 24.9

DSH 的最低 Node.js 版本提高至 24.9，使用旧版 Node.js 的用户需先升级运行时。这是一个硬性门槛。

pi-ai 升级至 1.3.0

同步模型目录、端点与推理回放规则；完整工具参数格式错误会在执行任何工具前终止该次响应。

未声明容量的自定义模型默认值调整

默认上下文与最大输出调整为十进制 1M/128K；较小端点应显式覆盖容量以避免延迟压缩。

Agent 模型选择规则调整

Agent 在提示词组装与 pre-step 前固定本步模型，重试保留同一选择；插件应通过 agent.model 选择模型，agent/request 不再允许改路由。

「自动化任务」改为统一的宿主级管理

支持手动创建、直接编辑和通过预填提示在会话中创建，保留编辑草稿并支持冲突复核，可选择复用或新建会话执行任务。

新增默认关闭的 apply_patch 工具

一次完成多文件新增、编辑、删除和移动，并在 Review 中查看变更。默认关闭，需要时手动启用。

文件修改的先读和外部修改防护默认关闭

沙箱限制和 Review 保持不变；需要原防护的 profile 可显式恢复观察策略。

PTC 相关变更

Node PTC 新增 VM Script 模式，支持顶层 await、动态导入和表达式结果。
原生与 PTC 工具执行拆为按 Agent 作用域选择的插件；PTC 通过配置 overlay 启用，旧 tools.mode 与 DSH_TOOLS_MODE 需迁移。
PTC Node 控制通道改用 birpc；自部署 bootstrap 与 SSH helper 必须同步升级，SSH 协议从 2 升为 3。
PTC Mode 中由调用方取消的 run_code 改为返回 ABORTED，SDK 和 Session 消费方需更新取消分类。

Web Fetch 不再拒绝非公网地址

可用于代理与内网，部署应自行限制网络访问。

Session API 与 Projection 变更

Session API 新增独立接口，可分别读取快照和持续订阅会话事件日志、运行状态及事件投影数据。
Session Projection 注册 API 调整为异步，需要插件启动时持有。

官方组合包列表导出位置变更

官方组合包列表改由 @deepseek-ai/dsh-official-bundles 导出；自定义集成需更新原 app-boot 的相关导入。

插件设置页面支持导航图标

插件可为自己的设置页面提供导航图标，卸载后恢复默认图标。

九、写在最后：811 个 commit，一次扎实的结账

v0.2.2-rc.1 是一个广度优先的候选版本。

它没有单一炸裂的新功能，但它把移动端适配、多语言、插件管理、实验性能力、聊天体验、网络性能、平台兼容性全部推进了一轮。811 个 commit 的积累，最终落成一个功能冻结的候选版本。

几个值得特别关注的方向：

移动端真正可用了——软键盘、导航、窄屏布局被系统性地处理；
多语言一次加六种——国际化迈出一大步；
「变更请求与工作树」——把 code review 和工作树隔离做成内置能力；
插件管理走向成熟——富文本详情、第三方更新、失败诊断、回滚机制；
Node.js 24.9 门槛——运行时要求提高，升级前需确认环境。

当然，rc 不等于正式版。按照 DSH 的迭代习惯，rc.1 之后可能还会有 rc.2、rc.3。但方向已经明确：0.2.2 系列离正式发布不远了。

如果你一直在等一个移动端可用、多语言完善、插件管理成熟的版本，v0.2.2-rc.1 值得开始认真评估。但升级前请务必注意：

Node.js 最低版本已提高到 24.9；
PTC 配置和 SSH 协议有迁移要求；
Session Projection 注册 API 改为异步；
官方组合包导出位置变更；
此前启用独立 worktree 插件的用户需手动移除。

升级前请备份重要会话数据和配置。

升级命令：npm i -g @deepseek-ai/dsh@next
GitHub 仓库：github.com/deepseek-ai/deepseek-harness
特别提醒：Node.js 最低版本已提高到 24.9，PTC 配置、SSH 协议、Session Projection API 均有迁移要求，升级前请仔细阅读 Release Note 并备份数据。