[中文](#cn-v0.1.7-alpha.1) | [English](#en-v0.1.7-alpha.1)
<h3 id="cn-v0.1.7-alpha.1">体验优化</h3>
- 侧边栏会话支持置顶、归档管理、筛选、撤销归档及从搜索结果恢复。 @Yifffan
- 对运行中会话归档，会列出受影响的回合、子代理、任务和提醒，新增「停止并归档」确认。 @LegGasai
- 新增「工作过程展示」「性能与用量」「开发者工具」设置；连续思考与工具调用合并为可折叠过程组，支持简洁、详细及运行中完全展开。开发者工具默认开启，关闭时仍显示第三方会话标签页。 @lsdsjy, @std4453, @imccyu
- 可在任务列表中确认停止运行中的任务；长时间运行的命令可按配置在等待超时后转入后台继续执行，工作流也支持后台运行。 @LegGasai
- 全新安装首次启动时自动创建默认工作区和空白会话，无需先选择文件夹。 @kermanx
- 会话右上角菜单新增反馈入口，可直接提交当前会话的反馈。 @Kaige-Gao
- 文件预览在回合结束后自动更新，并支持响应本地文件变化 @grllll
- 文件预览、交付卡片和改动审阅支持使用系统默认或其他关联应用打开文件、显示文件位置，不支持预览的文件也可直接打开。 @CreatixChu
- 文件改动审阅默认使用左右分栏，支持代码高亮和左右同步滚动。 @CreatixChu, @yixiangihsiang
- 文件改动卡片支持悬停查看单栏差异，无需先打开侧边栏；侧边栏仍默认左右分栏。 @yixiangihsiang
- 调整文件交付指引，优先在回复中展示结果，减少交付卡片与正文的重复展示。 @CreatixChu
- 统一界面图标、状态标记、菜单和滚动条的视觉样式，保留失败与中断状态的清晰提示。 @yixiangihsiang
- 优化会话中设置，目标、待办、定时任务及多种工具的历史结果展示，由 JSON 调整为，更紧凑的卡片展示 @kermanx
- 改善长对话的初始化加载、轮次导航跳转、加载历史开销 @imccyu, @tianyicui
- Team 工具统一以成员名称作为操作目标；子代理和 Team 统一空闲/就绪状态显示。 @Dudu-0223
- Team 任务看板改为只读，任务创建和更新由 Agent 通过工具完成。 @Dudu-0223
- 后台任务列表支持展开查看实时输出。 @LegGasai
- 内置 Agent 模式提供用途说明、使用指南和示例任务，帮助选择适合的模式。 @ZiyaZhang
- 模型页统一为「添加模型提供商」入口，可在第三方提供商和自定义 API 之间切换并保留草稿。 @LegGasai
- 工作区会话列表分批展开，运行中会话及有运行中子代理的父会话保持可见。 @turtle2099
- 输入栏空间不足时自动将模型名称收为图标，空间恢复后重新显示，减少控件换行。 @turtle2099
- 侧边栏 Excel 预览支持只读预览 XLSX、XLS、CSV 和 TSV，可切换工作表、选择和复制单元格、查看公式；部分不支持内容会提示。 @yudshj, @imccyu
- PDF、Office 和图片预览统一缩放控件，默认适应宽度，支持百分比缩放和手势缩放，并保留当前标签页的缩放比例。 @yudshj
### 问题修复
- 修复 Web 部署在反向代理的子路径下无法正常访问的问题。 @mektpoy
- 修复包含旧子代理通知的会话通过 Messages 协议继续对话时请求失败的问题。 @LegGasai
- 修复「新会话」误复用已有聊天历史或被其他 DSH 实例占用的空白会话的问题。 @LegGasai, @turtle1999
- 无法读取的可选插件包不再直接中止 Profile 加载，并在插件管理页保留错误信息和禁用、移除操作。 @turtle1999
- 插件安装弹窗可在等待期间立即关闭，并可重新查看同一安装任务；连接异常后会尝试恢复结果，无法确认时明确提示。 @LegGasai
- 自定义模型提供方的 API 地址示例随协议切换，避免 Anthropic Messages 地址重复添加 `/v1`。 @LegGasai
- 修复侧边栏 Markdown 预览中的本地图片加载，支持相对文档路径、中文、空格及 URL 编码。 @LegGasai
- 主动压缩会预留模型输出预算和额外上下文空间，减少长输出后才触发压缩而导致的上下文溢出。 @Dudu-0223
- 修复会话重新打开时，插件投影缓存中部分特殊 JSON 字段丢失的问题。 @tianyicui
- 修复源码启动时受模块运行时解析行为影响导致的初始化失败，并支持 link 到本地开发中的插件。 @imccyu
- 修复启用 Playwright 浏览器插件后，新会话、子代理及其他 Agent 创建失败的问题。 @mektpoy
- 修复极简模式的持久 Bash、PowerShell 取消时错误显示为 `[object Object]` 的问题。 @imccyu
- DeepSeek Files API 返回空内容或截断 JSON 时，报错会包含失败操作和 HTTP 状态。 @tianyicui
- 修复 Windows 沙箱可删除授权目录之外文件的问题，并阻止跨工作区删除。 @Elevator14B
- 修复已受理或运行中的会话在刷新列表、重连后被错误显示为空白新会话的问题。 @liukx0205
- 新建会话失败时显式反馈失败原因。 @LegGasai
- 修复计划审阅在其他面板打开期间到达后，「查看全文」和侧边栏预览失效的问题。 @LegGasai
- 设置导航支持独立滚动，窗口较矮或分区较多时可访问底部条目。 @grllll
- 修复 pi-ai 处理大型流式工具参数时阻塞整个 DSH 进程的问题。 @turtle1999
- 修复取消轮次时结束记录写入失败或混入内部调用栈的问题。 @kermanx
- 普通 Bash 调用不再因无须使用的权限说明为空而失败，权限提升仍需提供有效理由。 @turtle1999
- 修复多个带检查工具的 Agent 预设共存时，重复注册导致预设加载失败的问题。 @turtle1999
- 修复 Pkg 运行时并发首次加载 Native addon 时崩溃或加载失败的问题。 @koalazf99
- 修复 macOS「从应用打开」菜单重复列出同一应用的问题，保留不同名称的并存安装。 @Yifffan
- 修复左右分栏差异滚动到边缘时回弹、空白区域背景不一致及长路径遮住文件名末尾的问题。 @sjw1231
### 其他变更
- Session 日志升级为 V4，新增面向开发者的批量迁移工具，并兼容部分 V3 会话缺少轮次结束记录的情况。 @tianyicui, @kermanx
- 仅保存在自定义事件中的附件不再自动读取或导出，插件需适配。 @tianyicui
- 官方 DeepSeek 适配器仅使用 Messages API，移除 Chat Completions 和 protocol 选项；旧配置需删除 protocol 并使用 Messages 兼容地址。 @tianyicui
- 插件可通过 locale 数据结构声明多语言标题和描述，通过 package.json 声明图标，并用于插件管理页面展示 @imccyu, @turtle1999
- 插件管理中的安装支持选择官方源、npmmirror 镜像站或自定义源，并提供安装示例、进度展示。 @LegGasai, @Yifffan
- 插件组合包支持按顺序加载多个 patch 文件，保留原有单文件写法。插件可声明无需重载的配置字段，仅修改这类字段时可保留运行中的实例。 @turtle1999
- 新增 --dump-config-schema，导出 Cordis 配置及 patch 的 JSON Schema，辅助配置编写与静态检查。 @turtle1999
- Remote 支持双向流，普通调用和 Office 预览结果支持二进制传输，减少大文件编码开销；工作区文件读取统一为 readBytes，插件需迁移旧接口。 @imccyu, @yudshj
- 精简创造模式提示词，按需加载插件开发参考、模板和旧预设迁移指引；支持查询运行中插件的配置字段与约束，Shell 提供当前 Profile 的名称与目录。 @turtle1999
- Agent 预设改由插件组合包声明和安装，可通过创造模式创建或覆盖；设置页保留查看与选择，移除复制、删除和打开目录入口，旧目录预设需迁移。 @turtle1999
- 设置改由当前 Profile 的插件配置保存，支持声明过的实时更新字段；旧 settings.yaml 仅尝试导入一次，自定义设置插件需适配。 @turtle1999
- 内置浏览器在 Web 默认关闭，在 Electron 中默认启用，可选择聊天链接在内置浏览器或新标签页打开。 @turtle2099
- 新增实验性语音转写插件，首次使用需下载识别模型至本地；下载失败时显示具体原因、下载来源和恢复建议。 @LegGasai
<h3 id="en-v0.1.7-alpha.1">Improvements</h3>
- Add sidebar session pinning and archive management, with filtering, undo, and restoration from search results. by @Yifffan
- Archiving a running session lists affected turns, subagents, jobs, and reminders and requires “Stop and archive” confirmation. by @LegGasai
- Add Work Details, Performance and Usage, and Developer Tools settings. Consecutive reasoning and tool calls form collapsible groups, with Compact, Detailed, and fully expanded views for running turns. Developer Tools is enabled by default and keeps third-party session tabs visible when disabled. by @lsdsjy, @std4453, @imccyu
- Confirm stopping running jobs from the job list. Long-running commands can continue in the background after the wait timeout when configured, and workflows also support background execution. by @LegGasai
- Create a default workspace and blank session on first launch after a fresh installation, without requiring a folder selection. by @kermanx
- Add a Feedback action to the session header menu for submitting feedback on the current session. by @Kaige-Gao
- Refresh file previews after turns and on local file changes. by @grllll
- Open files with the system default or another associated application, or reveal their location, from previews, deliverable cards, and change review. Files without preview support can also be opened directly. by @CreatixChu
- Default file-change reviews to side-by-side comparison with syntax highlighting and synchronized scrolling. by @CreatixChu, @yixiangihsiang
- Preview single-column diffs by hovering over changed-file cards without opening the sidebar; the sidebar continues to use a side-by-side view by default. by @yixiangihsiang
- Refine file-delivery guidance to favor results in the response and reduce duplicate presentation in file cards. by @CreatixChu
- Unify icons, status indicators, menus, and scrollbars while keeping failures and interruptions clearly visible. by @yixiangihsiang
- Replace JSON displays for conversation settings, goals, to-dos, schedules, and supported historical tool results with compact cards. by @kermanx
- Improve initial loading and turn navigation in long conversations, and reduce history-loading overhead. by @imccyu, @tianyicui
- Use member names as targets in Team tools and unify idle/ready status display for subagents and Teams. by @Dudu-0223
- Make the Team task board read-only; agents create and update tasks through tools. by @Dudu-0223
- Expand jobs in the background job list to view live output. by @LegGasai
- Add descriptions, guides, and example tasks for built-in Agent modes to help users choose a suitable mode. by @ZiyaZhang
- Unify model setup under Add Model Provider, with switching between third-party providers and custom APIs while preserving drafts. by @LegGasai
- Expand workspace session lists in batches, keeping running sessions and parents with running subagents visible. by @turtle2099
- Collapse the model name to an icon when the composer runs out of space, and restore it when space becomes available to reduce control wrapping. by @turtle2099
- Preview XLSX, XLS, CSV, and TSV spreadsheets as read-only files in the sidebar, with worksheet switching, cell selection and copying, and formula inspection. The preview flags some unsupported content. by @yudshj, @imccyu
- Unify zoom controls for PDF, Office, and image previews, with Fit Width by default, percentage and gesture zoom, and a retained zoom level per tab. by @yudshj
### Bug Fixes
- Fix Web access when deployed under a reverse-proxy subpath. by @mektpoy
- Fix Messages API request failures when resuming sessions containing historical subagent notifications. by @LegGasai
- Fix New Session reusing conversations that already contain history or blank sessions held by another DSH instance. by @LegGasai, @turtle1999
- Continue Profile loading past unreadable optional bundles and retain diagnostics and disable/remove controls in Plugin Manager. by @turtle1999
- Allow pending plugin installation dialogs to close immediately and reopen the same task. Recover results after connection failures when possible and clearly report unknown outcomes. by @LegGasai
- Match custom-provider URL examples to the selected protocol to avoid duplicate `/v1` segments with Anthropic Messages. by @LegGasai
- Fix local images in sidebar Markdown previews, including document-relative paths, Chinese characters, spaces, and URL encoding. by @LegGasai
- Reserve model output capacity and additional context headroom for proactive compaction, reducing overflow after long outputs. by @Dudu-0223
- Preserve special JSON keys in plugin projection caches when reopening sessions. by @tianyicui
- Fix source-launch initialization failures caused by runtime module resolution, and support linking plugins under local development. by @imccyu
- Fix failures when creating new sessions, subagents, and other Agents with the Playwright browser plugin enabled. by @mektpoy
- Fix persistent Bash and PowerShell cancellations displaying `[object Object]` in minimal mode. by @imccyu
- Include the failed operation and HTTP status when the DeepSeek Files API returns empty or truncated JSON. by @tianyicui
- Fix Windows sandbox deletions escaping the authorized directory, and prevent deletions across workspaces. by @Elevator14B
- Fix accepted or running sessions incorrectly appearing as blank new sessions after list refreshes or reconnection. by @liukx0205
- Show the failure reason when a new session cannot be created. by @LegGasai
- Fix View Full Text and sidebar previews failing when a plan review arrives while another panel is open. by @LegGasai
- Allow settings navigation to scroll independently so bottom entries remain accessible in short windows or with many sections. by @grllll
- Fix large streaming tool-call arguments blocking the entire DSH process in pi-ai. by @turtle1999
- Fix turn-end records failing to write or including internal stack traces when a turn is cancelled. by @kermanx
- Allow ordinary Bash calls with an empty, unused permission explanation; privilege elevation still requires a valid reason. by @turtle1999
- Fix duplicate inspection-tool registration preventing Agent presets from loading when multiple presets with inspection tools coexist. by @turtle1999
- Fix crashes and load failures when Pkg runtimes concurrently load native addons for the first time. by @koalazf99
- Fix duplicate applications in the macOS Open With menu while preserving side-by-side installations with different names. by @Yifffan
- Fix edge rebound, inconsistent blank-area backgrounds, and truncated filename endings in side-by-side diffs. by @sjw1231
### Chores
- Upgrade Session logs to V4 and add a batch migration tool for developers, including support for some V3 histories with missing turn-end records. by @tianyicui, @kermanx
- Attachments stored only in custom events are no longer read or exported automatically; plugins must adapt. by @tianyicui
- Use only the Messages API in the official DeepSeek adapter, removing Chat Completions and the protocol option. Remove protocol from existing configurations and use a Messages-compatible endpoint. by @tianyicui
- Allow plugins to declare localized titles and descriptions through the locale data structure and icons in package.json for display in Plugin Manager. by @imccyu, @turtle1999
- Choose the official registry, npmmirror, or a custom registry for installation in Plugin Manager, with installation examples and progress display. by @LegGasai, @Yifffan
- Support ordered patch-file lists in plugin bundles while retaining single-file declarations. Plugins can declare configuration fields that update without reloading, retaining running instances when only those fields change. by @turtle1999
- Add --dump-config-schema to export JSON Schema for Cordis configuration and patches, assisting configuration authoring and static checks. by @turtle1999
- Support bidirectional Remote streams and binary transfer for ordinary call results and Office previews, reducing large-file encoding overhead. Unify workspace file reads under readBytes; plugins must migrate from the old APIs. by @imccyu, @yudshj
- Streamline Creator mode prompts and load plugin development references, templates, and legacy preset migration guidance on demand. Inspect configuration fields and constraints of running plugins, with the current Profile name and directory available to Shell commands. by @turtle1999
- Declare and install Agent presets through plugin bundles, with creation and overrides available in Creator mode. Settings retains viewing and selection but removes copy, delete, and open-directory actions; legacy directory-based presets require migration. by @turtle1999
- Save settings in the current Profile’s plugin configuration, supporting fields declared for live updates. Import from the legacy settings.yaml is attempted only once; custom settings plugins must adapt. by @turtle1999
- The built-in browser is disabled by default in Web and enabled by default in Electron. Choose whether chat links open in the built-in browser or a new tab. by @turtle2099
- Add an experimental speech transcription plugin. Download the recognition model locally before first use; download failures include the specific cause, source, and recovery guidance. by @LegGasai
Full Changelog: [dsh-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)