26 个 commit 的小步快跑，但每一项都踩在痛点上
9 月 9 日，DeepSeek Harness 发布了 v0.1.5-alpha.2。
距离上一个版本 v0.1.5-alpha.1 只隔了一天，Release Note 里写着 26 commits to master since this release。相比上一版 288 个 commit 的宏大叙事，这次是一个典型的小步快跑版本。
但别被数字骗了。这个版本里，右侧 Sidebar 从“能打开文件”进化成了“真正的文档工作台”，而模型交付文件的能力，也让 Agent 的输出有了更自然的归宿。
下面我们逐项拆解。
一、右侧 Sidebar：从“文件浏览器”到“文档预览器”
上一版（alpha.1）引入了实验性右侧 Sidebar，支持多标签、分栏、全屏，聊天文件链接和产出文件可以在 Sidebar 中打开。
到了 alpha.2，Sidebar 补上了最关键的一块拼图：预览能力。
支持常见文档类型预览
现在 Sidebar 支持预览：
- Markdown
- 代码高亮
- HTML
- 图片
这意味着什么？以前在 DSH 里查看一个 Markdown 文件，你可能看到的是原始文本；查看一个 PDF，可能只能下载到本地再打开。现在，这些文件都能在 Sidebar 里直接预览，不需要跳出 DSH 的工作流。
对于经常需要 Agent 产出报告、文档、代码文件的用户来说，这个改进把“查看产出”和“继续对话”两个动作合并到了同一个界面里。
模型可显式交付文件
更值得关注的是，模型现在支持显式在会话中交付文件。
交付之后，你可以：
- 在右侧 Sidebar 预览
- 用默认应用打开
- 在文件管理器中定位
这是一个非常重要的能力升级。以前的 Agent 产出文件，往往只是一个路径字符串，你需要自己去文件系统里找。现在，文件本身成了会话的一部分，模型可以主动“递”给你，你可以在 DSH 里直接预览、打开、定位。
Agent 的输出，从“一段文字”变成了“一个可交付的产物”。
二、/feedback：反馈也能提交明细了
/feedback 命令新增支持提交明细反馈内容。
结合上一版“反馈可独立提交，无需继续对话”的改进，DSH 的反馈机制正在变得越来越完善。用户可以：
- 在不打断对话的情况下提交反馈
- 附带相关会话内容
- 现在还能提交更详细的明细
对于开源项目来说，高质量的反馈是迭代的燃料。DSH 团队显然在认真打磨这条通路。
三、问题修复：那些让人抓狂的“消失”与“卡住”
这个版本修复的问题，很多都属于**“一旦遇到就很烦”**的类型。
模型设置入口消失
修复了模型目录变化后失效的 pi-ai 配置导致整个模型设置入口消失的问题。
这是一个典型的一处配置错误导致整个功能不可用的问题。现在的处理方式是：错误项保留诊断和修复入口，而不是让整个设置面板消失。用户至少知道哪里出了问题，并且有办法修。
Base URL 校验与规范化
在发现模型或创建自定义 provider 前，校验并规范化 Base URL，并直接提示无效地址。
这避免了用户填错地址后，得到一个莫名其妙的错误，甚至长时间等待。前置校验，即时反馈，是提升配置体验的关键。
Windows 原生文件夹选择器
修复了 Windows Web 界面的原生文件夹选择器可能在其他窗口后方打开的问题。
这是一个典型的平台适配问题。选择器弹在后面，用户会以为点击没反应，实际上窗口已经打开了。修复后，选择器会正常出现在前台。
输入空白字符后占位提示仍显示
修复了在 Composer 中输入空白字符后，占位提示仍然显示的问题。
小细节，但体现了团队对输入体验的细致打磨。
子代理收到不可用工具指导
修复了工具筛选后的子代理仍收到不可用文件和 Web 工具指导的问题。
这意味着，如果你限制了子代理的工具集，它不会再收到那些它根本用不了的工具指导。减少了模型被误导的可能，也节省了上下文。
MCP 工具发现重复分页游标
拒绝 MCP 工具发现中的重复分页游标，避免启动或同步持续等待，并保留上一组可用工具。
这是一个健壮性修复。当 MCP 服务端返回异常数据时，DSH 不会卡死，而是保留上一组可用工具，继续工作。
fs-ext 本地编译问题
修复了 npm 安装需要依赖 fs-ext 本地编译的问题。
对于没有完整编译环境的用户来说，这是一个安装门槛。修复后，安装 DSH 更加顺畅。
四、体验优化：设置界面的本地化与可访问性
改善设置界面的本地化与可访问性：
- 设置入口补充本地化无障碍名称
- 中文显示对话模式与内置模型说明
这意味着：
- 使用屏幕阅读器的用户，能更准确地理解设置入口的用途。
- 中文用户能看到更完整的中文说明，而不是中英混杂。
可访问性和本地化，是产品走向成熟的标志。 虽然不是最亮眼的功能，但体现了一个项目对所有用户的尊重。
五、⚠️ 开发者注意：Session V3、插件 API 与极简模式
以下变更主要面向开发者和插件作者，升级前需要留意。
Session 数据格式当前为 V3
跨版本迁移细节见 session-format-v2-to-v3/README.md。
如果你有自定义的日志读取器，需要适配 V3 格式。升级后的会话不支持降级读取，升级前请备份。
Web 插件面板 API 调整
- 插件可通过 sidebar.panellist 与 main 注册全局面板。
- 原 conversation Slot 迁移为 main 的 conversation key。
插件作者需要更新面板注册方式。这次调整让 Sidebar 的扩展能力更加规范，也为未来更多面板类型打下了基础。
极简模式默认工具调整
Web minimal 与 Python sdk-minimal 默认仅提供持久 shell，str_replace_editor 改为显式启用。
同时，持久 Bash 输出统一报告退出或超时状态。
这意味着极简模式更加“极简”，只保留最核心的持久 shell。需要文件编辑能力的用户，需要显式启用 str_replace_editor。
实验性 Agent Teams 包可从 npm 安装
实验性 Agent Teams 包现可从 npm 安装。用户需显式添加 profile，不默认启用。
这给了想要尝鲜多 Agent 协作的用户一个正式的安装入口，同时保持了默认配置的简洁。
六、写在最后
v0.1.5-alpha.2 是一个承上启下的版本。
它没有 alpha.1 那样 288 个 commit 的宏大叙事，但它在 alpha.1 打下的基础上，把右侧 Sidebar 真正变成了一个可用的文档工作台，让模型交付文件的能力落地，并修复了一批影响日常使用的“消失”与“卡住”问题。
从“能打开文件”到“能预览、能交付、能定位”，Sidebar 的进化只用了两个版本。 而极简模式的工具调整、插件面板 API 的规范、Agent Teams 的 npm 发布，都在为更复杂的 Agent 工作流铺路。
DSH 的迭代速度依然惊人。26 个 commit 的小步快跑，和 288 个 commit 的大步跨越交替出现——这正是 Alpha 阶段该有的节奏。
升级命令：npm i -g @deepseek-ai/dsh@next
GitHub 仓库：github.com/deepseek-ai/deepseek-harness
特别提醒：Session 格式为 V3，升级后不支持降级读取，请提前备份；插件作者请关注 Web 插件面板 API 的调整。
