编者摘要：DeepSeek Harness 发布 dsh-v0.1.7-alpha.1 预发布版本，重点升级会话管理、文件预览与 Agent 任务能力，并包含多项底层破坏性变更。

用户侧新增会话置顶、归档、筛选、撤销归档，归档运行中会话增加二次确认；长耗时命令与工作流支持后台执行，后台任务可实时查看输出。界面新增工作过程、性能用量、开发者工具设置，推理与工具调用过程支持多视图折叠展示。文件能力大幅增强：支持 XLSX/CSV/PDF/Office/ 图片统一预览，文件对比默认左右分栏、同步滚动，可直接调用系统程序打开文件。长对话加载性能优化，内置 Agent 模式增加使用指引；新增实验性本地语音转写插件。

本次版本修复 Web 反向代理子路径部署、Windows 沙箱文件越权删除、Markdown 本地图片加载、插件并发加载崩溃等大量稳定性与安全问题。

⚠️ 重要迁移提醒：DeepSeek 官方适配器仅保留 Messages API，旧配置需删除 protocol 字段；会话日志升级 V4、Agent 预设改为插件包管理、文件读取 API 变更，旧 Agent 预设与插件需要迁移。Alpha 版本不建议承载重要业务，升级前请备份会话与配置。

仓库主页https://github.com/deepseek-ai/deepseek-harness

v0.1.7-alpha.1 Release 页面（你刚才的版本）https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.7-alpha.1

源码分支（dsh-v0.1.7-alpha.1）https://github.com/deepseek-ai/deepseek-harness/tree/dsh-v0.1.7-alpha.1

本次提交 commithttps://github.com/deepseek-ai/deepseek-harness/commit/c36a83ff6bb95e3f82cf79f9be7c724270a8aa61

对比变更（v0.1.6-alpha.2 → dsh-v0.1.7-alpha.1）https://github.com/deepseek-ai/deepseek-harness/compare/dsh-v0.1.6-alpha.2...dsh-v0.1.7-alpha.1

10 个关键问题 Q&A

1. Q：dsh-v0.1.7-alpha.1 是什么版本，可以拿来做正式工作吗？
   A：属于 alpha 预发布版，仍在迭代。不建议跑关键、不可恢复的生产任务，升级前务必备份会话与 Profile 配置。
2. Q：这次更新最大的面向用户的新能力是什么？
   A：三大亮点：①侧边栏会话归档 / 置顶管理，运行会话归档增加强确认；②长任务支持后台执行；③全面增强文件预览（Excel/CSV/PDF/Office）、代码差异审阅。
3. Q：升级后 DeepSeek 模型配置会失效吗，要怎么改？
   A：会。官方适配器只保留 Messages API，旧配置需要删掉 protocol字段，使用 Messages 兼容端点，否则接口调用会失败。
4. Q：Agent 预设（自定义智能体）升级后会直接丢失吗？
   A：旧目录形式的 Agent 预设不再支持，需要迁移到插件组合包方式；设置页面仅支持查看、选择预设，不再提供复制、删除入口。
5. Q：什么是会话日志 V4，对普通用户有影响吗？
   A：会话存储日志升级到 V4。普通用户无感；开发者提供批量迁移工具，兼容部分 V3 缺少轮次结束记录的旧会话。
6. Q：后台任务是什么？工作流也能后台跑吗？
   A：长时间运行命令超时后可转入后台继续执行，工作流同样支持后台运行，后台任务面板可实时查看输出。
7. Q：文件预览新增哪些格式？有什么特色？
   A：新增 XLSX/XLS/CSV/TSV 只读预览，支持切换工作表、复制单元格、查看公式；PDF / 图片 / Office 统一缩放；代码 diff 默认左右分栏、同步滚动。
8. Q：插件开发者有哪些必须适配的破坏性变更？
   A：文件读取接口统一改为readBytes，旧文件 API 需要迁移；自定义事件内附件不再自动读取导出；设置存储机制变更，旧 settings.yaml 仅一次性导入。
9. Q：新增的实验语音转写插件有什么限制？
   A：属于实验功能，首次使用需要本地下载识别模型；下载失败会返回具体错误原因与恢复方案。
10. Q：Web 网页部署版本有什么重要修复？
    A：修复反向代理子路径部署无法访问的问题；内置浏览器在 Web 端默认关闭，Electron 桌面端默认开启，链接可选择打开方式。

DeepSeek Harness（DSH）是 DeepSeek 推出的本地 Agent 工作台，本次为 alpha 预发布版本，核心方向：Agent 会话管理增强、文件预览能力大幅升级、后台长任务支持、插件体系重构、大量稳定性修复，同时有若干不兼容变更需要用户 / 插件开发者注意。

一、体验优化（面向终端用户）

1. 会话侧边栏管理升级

• 会话支持置顶、归档、筛选、撤销归档、搜索恢复归档会话
• 归档正在运行的会话会列出所有受影响回合、子代理、任务、提醒，增加「停止并归档」二次确认，防止误操作中断任务
• 全新安装首次启动自动创建默认工作区 + 空白会话，不再强制先选文件夹，降低上手门槛
• 会话右上角增加反馈入口，可直接提交当前会话问题反馈

2. 思考与工具调用可视化（重点）

新增三类设置：工作过程展示 / 性能与用量 / 开发者工具

• 连续思考 + 工具调用合并成可折叠过程组，提供 3 种视图：简洁 / 详细 / 运行时完全展开
• 开发者工具默认开启；关闭时第三方会话标签页仍然保留

3. 长任务 & 后台执行能力

• 任务列表可直接停止正在运行任务
• 长时间运行命令：超时后可配置转入后台继续执行，工作流也支持后台运行；后台任务列表可展开看实时输出
• 长对话加载优化：优化初始化加载、轮次导航，降低历史会话加载开销

4. 文件预览 & 代码审阅（本版本亮点）

• 文件预览会在回合结束自动刷新，并监听本地文件变更自动更新
• 预览卡片、改动审阅面板支持调用系统关联程序打开文件 / 打开文件所在位置；不支持预览的文件也可直接唤起外部程序打开
• 文件改动审阅默认左右分栏，代码高亮 + 同步滚动；改动卡片支持悬停看单栏 diff，不用打开侧边栏
• 侧边栏新增 Excel 预览：XLSX/XLS/CSV/TSV 只读预览，切换工作表、复制单元格、查看公式
• PDF / 图片 / Office 预览统一缩放控件：默认适应宽度，支持百分比 + 手势缩放，每个标签页独立保存缩放比例
• 优化交付卡片逻辑：优先在对话正文展示结果，减少正文与交付卡片重复展示

5. UI、信息展示优化

• 统一图标、状态标记、菜单、滚动条样式；失败 / 中断状态提示保留清晰
• 目标、待办、定时任务、工具历史结果：从原始 JSON 改成紧凑卡片展示
• 输入栏模型名称空间不足时自动折叠成图标，空间恢复自动还原，避免控件换行
• 工作区会话列表分批加载；运行中会话、包含活跃子代理的父会话持续保持可见

6. Agent / Team 多智能体能力调整

• Team 工具改用成员名称作为操作对象；子代理与 Team 统一空闲 / 就绪状态展示
• Team 任务看板改为只读，任务创建、更新全部交由 Agent 通过工具调用完成
• 内置 Agent 模式增加用途说明、使用指南、示例任务，帮助用户选择合适的 Agent 模式

7. 模型配置

模型页面统一为「添加模型提供商」入口，可在第三方提供商 / 自定义 API 之间切换，保留填写草稿

二、问题修复（稳定性、安全、Bug）

• Web 反向代理子路径部署修复，现在可正常访问
• 修复带旧子代理通知的会话用 Messages API 续对话请求失败
• 修复新建会话意外复用已有历史会话、或占用别的 DSH 实例空白会话
• Windows 沙箱安全加固：禁止删除授权目录外文件，阻止跨工作区删除文件
• Playwright 浏览器插件开启后导致新建会话 / 子 Agent 创建失败问题修复
• Markdown 预览本地图片修复：支持相对路径、中文、空格、URL 编码图片
• 主动上下文压缩优化：预留模型输出预算，减少长输出后触发压缩导致上下文溢出
• 修复 pi-ai 插件处理超大流式工具参数阻塞整个 DSH 进程
• Bash 命令：单纯调用时空权限说明不再报错；提权操作依旧需要有效理由
• Pkg Runtime 并发首次加载原生插件崩溃问题修复
• 大量 UI 细节：diff 滚动回弹、背景色不一致、文件名被截断；设置面板独立滚动，小窗口可访问底部选项
• 会话刷新 / 重连后，正在运行会话误显示为空白新会话问题修复
• 插件加载：可选插件包读取失败不再直接中断 Profile 加载，插件管理页保留错误信息与禁用 / 删除操作

三、其他变更（重点！插件开发者、老配置迁移必读，存在破坏性变更）

1. Session 日志升级 V4
   ，提供批量迁移工具，兼容部分缺少轮次结束记录的 V3 旧会话
2. DeepSeek 官方适配器仅保留 Messages API
   ，移除 Chat Completions 选项。👉旧配置需要手动删掉protocol字段，使用 Messages 兼容端点
3. 插件体系增强：
• package.json 可声明图标，支持 locale 多语言标题描述
• 插件安装源可选：官方源 /npmmirror 镜像 / 自定义源，带进度展示
• 插件组合包支持多 patch 顺序加载；可声明无需重载即可实时更新的配置字段
• 新增 CLI 参数 --dump-config-schema导出 Cordis 配置 JSON Schema，辅助配置静态校验
4. Remote 底层：支持双向流，普通调用、Office 预览支持二进制传输，降低大文件 base64 编码开销；文件读取统一为readBytes，旧文件 API 需要插件迁移
5. Agent 预设机制重构：Agent 预设现在由插件组合包声明安装；创造模式可以新建 / 覆盖预设；设置页面仅保留查看选择，删除了复制 / 删除 / 打开目录入口，旧目录式预设需要迁移
6. 设置存储变更：配置保存在当前 Profile 插件配置内；旧settings.yaml只会尝试导入一次，自定义设置插件需要适配
7. 内置浏览器：Web 版本默认关闭，Electron 桌面端默认开启；链接可选内置浏览器或新标签页打开
8. 新增实验语音转写插件
   ：首次使用需要本地下载模型；下载失败会给出原因、来源与恢复指引
9. 自定义事件内的附件不再自动读取 / 导出，插件需要自行适配

四、变更小结

v0.1.7-alpha.1 主打Agent 会话生命周期管理、后台长任务、增强型多格式文件预览；同时底层插件、会话日志、模型适配器、设置存储有多处不兼容改动，升级时需要迁移旧 DeepSeek 模型配置与旧 Agent 预设，插件开发者需要适配新文件接口。

五、风险提示

• 属于 alpha 预发布版本，不适合生产 / 重要工作负载
• 升级前建议备份会话、profile 配置
• 老用户：DeepSeek 模型配置需要删除 protocol 字段；旧目录 Agent 预设需要迁移到插件包形式