带 dsh.so 解读的版本追踪——自动跟踪官方 GitHub Releases 页面（github.com/deepseek-ai/deepseek-harness/releases），官方双语更新日志自动同步，并附 dsh.so 的解读：每个版本对用户意味着什么、对插件意味着什么。
0.1.7-rc.2 是一个没有 new 或 breaking 条目的候选版本，整体更偏向稳定性与打磨。不少改动集中在插件体验上：插件详情与设置页现在能正确显示插件信息，安装时会明确所选官方源或镜像，崩溃或中断后不再遗留持续的插件安装与设置保存失败。值得注意的行为调整包括：Auto review 改从 Plugins 页面启用、Inspector 不再默认包含而需单独安装，计划任务与时间上下文在 Web 和桌面端默认关闭。此外还带来快捷键自定义、更完善的引导、桌面端关闭窗口后任务继续执行，以及更一致的界面与语法高亮。
Mostly non-breaking, but some defaults changed. Auto review is now enabled from the Plugins page, and Inspector is no longer bundled by default, so install it separately if you depended on it. Scheduled tasks and time context are off by default on Web and Desktop and must be enabled explicitly. Newly created default workspace folders no longer derive their name from the interface language (the display name stays localised; existing workspaces are unchanged). Desktop tasks keep running after the window is closed and quitting warns about the impact, so plan upgrades around in-flight tasks.
--session-id 继续已有会话，用 --json 逐行输出 JSON 运行事件。 @lsdsjyprotocol 配置和 Chat Completions 地址需迁移。 @LegGasai, @tianyicuiptc-runtime 系列，旧名称不再兼容，自定义插件和配置需更新。 @tianyicuiworkflow-ptc，遵循会话文件策略；自定义配置需更新名称，暂不支持 Python PTC。 @tianyicuiagent/session-start 改为异步串行的 agent/created，首次模型请求等待初始化完成，相关插件及注册调用需适配。 @kermanxsnapshotEvents、eventAt 和 ownEvents。 @kermanxspawn_teammate，关闭 subagent 和 subagent_fork，默认队友创建上限从 8 增至 16。 @Dudu-0223process.env 为空，依赖旧执行环境的代码需适配。 @tianyicuiSandboxProvider.confine 和 ShellExecutor.start 改为可取消的异步接口，准备时间计入超时；修复 POSIX 符号链接与父目录组合、Windows 驱动器相对路径解析。 @tianyicuireadBytes，插件需迁移旧接口。 @imccyu, @yudshjspill-policy 配置中的 maxInlineBytes 需改为 maxInlineTokens，按 token 数重新设置预算。 @CreatixChu作为 0.1.7 系列的首个候选版本，本版本汇总了自 v0.1.5-rc.3 以来的主要用户和开发者相关变更。
--session-id 继续已有会话，用 --json 逐行输出 JSON 运行事件。 @lsdsjyprotocol 配置和 Chat Completions 地址需迁移。 @LegGasai, @tianyicuiptc-runtime 系列，旧名称不再兼容，自定义插件和配置需更新。 @tianyicuiworkflow-ptc，遵循会话文件策略；自定义配置需更新名称，暂不支持 Python PTC。 @tianyicuiagent/session-start 改为异步串行的 agent/created，首次模型请求等待初始化完成，相关插件及注册调用需适配。 @kermanxsnapshotEvents、eventAt 和 ownEvents。 @kermanxspawn_teammate，关闭 subagent 和 subagent_fork，默认队友创建上限从 8 增至 16。 @Dudu-0223process.env 为空，依赖旧执行环境的代码需适配。 @tianyicuiSandboxProvider.confine 和 ShellExecutor.start 改为可取消的异步接口，准备时间计入超时；修复 POSIX 符号链接与父目录组合、Windows 驱动器相对路径解析。 @tianyicuireadBytes，插件需迁移旧接口。 @imccyu, @yudshjspill-policy 配置中的 maxInlineBytes 需改为 maxInlineTokens，按 token 数重新设置预算。 @CreatixChudsh 0.1.7-rc.1 是一个改动量很大的预发布版本：Web 侧边栏终端、会话归档、MCP 资源发现与 URI 模板、Headless 的 NDJSON 运行事件、SSH 远程工作区、浏览器/电脑操作后端，以及带官方/镜像/自定义源选择的插件安装、配置与移除管理。同时伴随大量 API 与运行时变更：PTC 包改为 ptc-runtime 系列，workflow-ptc 取代旧工作流执行器，agent/created 异步取代 agent/session-start，Node PTC 在独立进程中运行且 process.env 为空，spill 策略改用 token 预算，E2B 后端与 V4 Flash 模型被移除。插件作者应把该 RC 当作迁移检查点，在正式版前针对 Session 日志 V4、Profile 插件配置、预设包和插件版本兼容性检查重新测试。
Plan a real migration for this RC. Rename PTC packages/services to the ptc-runtime family and move to workflow-ptc (Python PTC unsupported); drop E2B execution backends and legacy PTC environment assumptions, since Node PTC now runs in separate processes with an empty process.env. Update plugins that use agent/session-start to the async, serial agent/created initialization (the first model request waits for it), stop using snapshotEvents/eventAt/ownEvents, and expect multi-instance Client Sessions plus Session log V4 with the batch migration tool. Replace spill-policy maxInlineBytes with maxInlineTokens and set a token budget; switch workspace file reads to readBytes for remote/binary streams. Settings now live in the current Profile's plugin configuration with one-time import from legacy settings.yaml, Agent presets must be declared through plugin bundles, Creator mode installs persistent plugins via Plugin Manager instead of Cordis dynamic tools, and plugin compatibility is checked against the running DSH version. Also note Removed V4 Flash/V4 Flash Vision Exp, Ralph disabled by default, subagent/subagent_fork disabled in Team mode in favor of spawn_teammate, and attachments kept only in custom events no longer auto-read or exported.
spill-policy 配置中的 maxInlineBytes 需改为 maxInlineTokens，按 token 数重新设置预算。 @CreatixChuspill-policy 配置中的 maxInlineBytes 需改为 maxInlineTokens，按 token 数重新设置预算。 @CreatixChudsh 0.1.7-alpha.2 是一个小型预发布版本，重点在打磨对话与工作区体验而非新增功能：滚动跟随、历史分页、轮次导航，以及统一的代码块样式（支持复制、换行与更清晰的 diff 和行号）。对插件与 harness 开发者而言有两处实质性变化：工具结果保留策略改为文本与图片共享估算 token 预算（保留首尾并为被省略内容提供访问路径，同时修复 MCP 图片在文本截断后不可用的问题）；首次安装插件时会在未配置的情况下优先选择响应最快的 npm registry。此外修复了后台命令与子代理任务完成后的会话卡顿（完成触发的 Agent 唤醒默认不限次数，可选配置上限）、语音识别设置持久化、Excel 预览、以及服务重启后 Web 客户端看似连接却不再显示回复等问题。官方未声明破坏性变更，但自定义 spill-policy 配置需要迁移。
Only one real migration: custom `spill-policy` configurations must replace `maxInlineBytes` with `maxInlineTokens` and express the budget in tokens. If you rely on completion-triggered Agent wakeups, note that they are now unlimited by default and can optionally be capped. No other breaking changes are declared, so standard upgrade applies.
/v1。 @LegGasai[object Object] 的问题。 @imccyu/v1。 @LegGasai[object Object] 的问题。 @imccyudsh 0.1.7-alpha.1 是一个范围较广的预发布版本，重塑了会话管理、文件处理以及插件与配置层面。亮点包括会话置顶与归档管理（支持撤销）、更丰富的文件预览（新增表格预览与统一缩放）、V4 会话日志及批量迁移工具，以及插件管理器的多项增强：注册源选择、package.json 中的本地化插件标题/图标、有序补丁文件列表，以及无需重载即可生效的配置字段。对插件开发者而言，影响主要是契约层面的：官方 DeepSeek 适配器仅使用 Messages API（Chat Completions 与 protocol 选项已移除）、仅存于自定义事件中的附件不再被自动读取或导出、工作区文件读取统一为 readBytes，设置与 Agent 预设迁移至 Profile 插件配置与插件包。官方变更列表未标记 `new` 或 `breaking` 条目，但这些行为变化意味着现有插件在升级前需要适配。
1) DeepSeek 适配器：从现有配置中删除 protocol 字段，改用兼容 Messages 的端点；Chat Completions 不再受支持。2) 仅在自定义事件中保存附件的插件必须改用受支持的持久化方式，自动读取/导出已取消。3) 将旧的工作区文件读取 API 迁移到 readBytes。4) 运行 V4 会话日志批量迁移工具（可处理部分缺少 turn-end 记录的 V3 历史）。5) 将设置迁入当前 Profile 的插件配置；legacy settings.yaml 只会尝试导入一次，自定义设置插件需适配。6) 把基于目录的 Agent 预设迁移为插件包声明，必要时使用有序补丁文件列表与可实时更新的配置字段。7) 用 --dump-config-schema 校验 Cordis 配置与补丁的 JSON Schema 并做静态检查。另请注意：内置浏览器在 Web 默认关闭、在 Electron 默认开启；语音转写插件为实验性，首次使用前需本地下载识别模型。
dsh 0.1.5-rc.3 是 0.1.5 稳定化线路上于 2026-09-22 发布的预发布版本。官方变更列表在 new、changed、fixed、breaking 各栏均为空，说明本次更偏向内部或打包层面的刷新，而非功能发布。对插件开发者而言没有需要适配的新特性，也未释放 API 变更信号，现有插件应可在 0.1.5 预发布通道上继续正常工作。建议将其视为验证版本：继续锁定精确版本号，在 0.1.5 正式版发布前用它回归测试你的插件，因为 RC 阶段仍可能调整。
dsh <profile> 启动指定 Profile。 @turtle1999dsh <profile> 启动指定 Profile。 @turtle1999dsh 0.1.6-alpha.2 是一个以插件与界面为主的大型 alpha 版本：新增插件页面，可安装、配置并实时启用/停用插件，同时带来回合结束的文件变更卡片，以及侧边栏中的 Office 文件、URL、子代理对话和已提交计划预览。底层方面，插件依赖改为运行时解析，Plugin Manager 支持运行时卸载；Creator 模式移除了旧的 Cordis 动态定义与执行工具，改用 Plugin Manager 安装持久化插件，Client Sessions 也支持多实例共存并伴随相关 API 与 slot 变更。侧边栏布局与终端连接现在可跨刷新保持，启动更快，并修复了大量问题。对生态而言，插件作者需要重新验证加载/卸载逻辑及会话与 slot 集成，用户则获得更顺畅、更易发现的插件体验。
No hard breaking entries were listed, but plugin authors should act on three changes: (1) plugin dependencies now use runtime resolution and Plugin Manager supports runtime unloading — review and test your load/unload lifecycle, cleanup, and dependency assumptions; (2) Creator mode no longer provides the Cordis dynamic definition/execution tools — switch to installing persistent plugins via Plugin Manager; (3) Client Sessions can now run multiple coexisting instances, with changed APIs and slots — update any session or slot integrations and re-verify them. Also note V4 Flash and V4 Flash Vision Exp were removed from the default model list; re-add them explicitly if your setup depends on them. Subagent chains now default to at most 8 live children and delegation depth 1, adjustable in settings.
--session-id 继续已有会话，用 --json 逐行输出 JSON 运行事件。 @lsdsjyrun_code 支持按次设置超时时间，默认 120 秒、最多 600 秒。 @tianyicuihttps://api.deepseek.com/anthropic。 @LegGasai, @tianyicuiptc-runtime 系列，旧名称不再兼容，自定义插件和配置需更新。 @tianyicuiworkflow-ptc，遵循会话文件策略；自定义配置需更新名称，暂不支持 Python PTC。 @tianyicuiagent/session-start 改为异步串行的 agent/created，首次模型请求等待初始化完成，相关插件及注册调用需适配。 @kermanxsnapshotEvents、eventAt 和 ownEvents。 @kermanxspawn_teammate，关闭 subagent 和 subagent_fork，默认队友创建上限从 8 增至 16。 @Dudu-0223process.env 为空，依赖旧执行环境的代码需适配。 @tianyicuiSandboxProvider.confine 和 ShellExecutor.start 改为可取消的异步接口，准备时间计入超时；修复 POSIX 符号链接与父目录组合、Windows 驱动器相对路径解析。 @tianyicuiDSH_HOME/cache/attachments/request-images，删除后可重建；原图保留，旧缓存不自动清理。 @turtle1999--session-id 继续已有会话，用 --json 逐行输出 JSON 运行事件。 @lsdsjyrun_code 支持按次设置超时时间，默认 120 秒、最多 600 秒。 @tianyicuihttps://api.deepseek.com/anthropic。 @LegGasai, @tianyicuiptc-runtime 系列，旧名称不再兼容，自定义插件和配置需更新。 @tianyicuiworkflow-ptc，遵循会话文件策略；自定义配置需更新名称，暂不支持 Python PTC。 @tianyicuiagent/session-start 改为异步串行的 agent/created，首次模型请求等待初始化完成，相关插件及注册调用需适配。 @kermanxsnapshotEvents、eventAt 和 ownEvents。 @kermanxspawn_teammate，关闭 subagent 和 subagent_fork，默认队友创建上限从 8 增至 16。 @Dudu-0223process.env 为空，依赖旧执行环境的代码需适配。 @tianyicuiSandboxProvider.confine 和 ShellExecutor.start 改为可取消的异步接口，准备时间计入超时；修复 POSIX 符号链接与父目录组合、Windows 驱动器相对路径解析。 @tianyicuiDSH_HOME/cache/attachments/request-images，删除后可重建；原图保留，旧缓存不自动清理。 @turtle19990.1.6-alpha.1 是一次覆盖面很广的实验性 alpha：Web 侧边栏新增可多标签、可切换 shell 并在刷新后恢复的终端，设置中可浏览与恢复归档会话，MCP 支持资源发现与 URI 模板，headless 支持从标准输入读取任务、用 --session-id 恢复会话并以 --json 输出事件，新增远程 SSH 工作区，以及实验性的 Browser Use、Computer Use 和 Auto review 模式。底层方面，MCP 升级到官方 SDK v2，PTC 运行时被重组为 ptc-runtime 系列并使用独立进程运行 Node PTC。虽然 breaking 列表为空，但多条变更移除了旧别名、替换了初始化与工作流 API，并弃用了同步 Session 历史接口，因此插件作者应将其视为需要迁移的 alpha，而非直接升级。涉及 PTC、workflow、session 启动、E2B/远程执行或推理内容输出的插件在适配前可能无法使用。
Real migration is required despite the empty breaking list. (1) Rename PTC packages/services to the ptc-runtime family; there are no legacy aliases. (2) Replace the workflow executor with workflow-ptc under the session file policy; Python PTC is not supported. (3) Replace agent/session-start with asynchronous, serial agent/created initialization — the first model request waits for it to finish. (4) Stop using the deprecated synchronous Session history APIs snapshotEvents, eventAt, and ownEvents. (5) Node PTC now runs in separate processes with output/heap limits and an empty process.env, so code relying on the previous environment must migrate; run_code per-call timeouts default to 120s (max 600s). (6) Remove built-in E2B execution backends from custom configurations. (7) Messages is now the default DeepSeek protocol and uploaded images are reused via the Files API; if you explicitly set the old official root URL, remove that override or change it to https://api.deepseek.com/anthropic. (8) Ralph is disabled by default and must be enabled explicitly. (9) In experimental Team mode use spawn_teammate; subagent and subagent_fork are disabled and the teammate creation limit rises from 8 to 16. (10) Hot reload no longer rolls back transactionally: parse failures keep the original configuration, but activation failures may leave partial changes needing manual correction. Also note San
DSH 0.1.5-rc.2 是 DSH 于 2026-09-10 发布的预发布版本，位于 0.1.5-rc.1 与最终 0.1.5 稳定版之间。本次登记的变更列表为空，没有新增、变更、修复或破坏性条目，因此更适合把它看作稳定化/候选版本检查点，而非功能更新。对插件开发者而言，这表示 API 表面没有变化信号：基于 0.1.5-rc 系列构建的插件应可继续正常加载。使用更早 0.1.5 预发布版的用户可升级以协助验证即将到来的稳定版，但不应期待插件市场中已记录的任何行为差异。
DeepSeek-V41-Flash（deepseek-flash）支持文本、图片及会话历史中的系统提示词更新。新会话默认使用该模型，配置文件显式指定模型时以配置值为准。 @LegGasaimodels 对象和 Anthropic 原生模型列表的支持，并支持回填模型名称、上下文窗口及最大输出 token 的回填。 @LegGasaiHTTP_PROXY、HTTPS_PROXY、ALL_PROXY 与 NO_PROXY 配置。 @LegGasai/feedback 命令支持提交明细反馈内容，提交时附带相关会话内容。 @tianyicui, @Chinesezjc, @CreatixChuread_image 的图片结果，以及模型回复中引用的 POSIX 绝对路径本地图片，包括工作区外截图；加载失败时显示替代文字或原路径。 @Chinesezjc, @kermanxsend_message 统一采用 steer 语义，并在跨 Agent 和冷恢复投递中保留发送者归属与顺序。 @Dudu-0223SessionHandle；agentLoop.create() 改为异步，新增session锁，同一session至多被一个进程持有。 @turtle1999, @imccyuminimal 与 Python sdk-minimal 默认仅提供持久 shell，str_replace_editor 需显式启用，持久 Bash 输出统一报告退出或超时状态。 @koalazf99FS_NOT_OBSERVED 诊断，保留文件路径、结构化错误码和原始原因。 @turtle1999ctx.agent，调用方需显式传递 Agent；同时修正可继续对话的子代理归属，避免它们被当作根会话参与定时调度。 @kermanxInbox 改为类型接口，不再导出可构造的运行时类；插件通过 agent.inbox 读写待处理消息，hasPending 与 claim 不再属于公共接口。 @kermanxsidebar.panellist 与 main 注册全局面板；原 conversation Slot 迁移为 main 的 conversation key @imccyunode 开头的命令错误重写为 dsh runtime 的问题。 @imccyu作为 0.1.5 系列的首个候选版本，本版本汇总了自 v0.1.2-rc.1 以来的主要用户和开发者相关变更。
DeepSeek-V41-Flash（deepseek-flash）支持文本、图片及会话历史中的系统提示词更新。新会话默认使用该模型，配置文件显式指定模型时以配置值为准。 @LegGasaimodels 对象和 Anthropic 原生模型列表的支持，并支持回填模型名称、上下文窗口及最大输出 token 的回填。 @LegGasaiHTTP_PROXY、HTTPS_PROXY、ALL_PROXY 与 NO_PROXY 配置。 @LegGasai/feedback 命令支持提交明细反馈内容，提交时附带相关会话内容。 @tianyicui, @Chinesezjc, @CreatixChuread_image 的图片结果，以及模型回复中引用的 POSIX 绝对路径本地图片，包括工作区外截图；加载失败时显示替代文字或原路径。 @Chinesezjc, @kermanxsend_message 统一采用 steer 语义，并在跨 Agent 和冷恢复投递中保留发送者归属与顺序。 @Dudu-0223node 开头的命令错误重写为 dsh runtime 的问题。 @imccyuSessionHandle；agentLoop.create() 改为异步，新增session锁，同一session至多被一个进程持有。 @turtle1999, @imccyuminimal 与 Python sdk-minimal 默认仅提供持久 shell，str_replace_editor 需显式启用，持久 Bash 输出统一报告退出或超时状态。 @koalazf99FS_NOT_OBSERVED 诊断，保留文件路径、结构化错误码和原始原因。 @turtle1999ctx.agent，调用方需显式传递 Agent；同时修正可继续对话的子代理归属，避免它们被当作根会话参与定时调度。 @kermanxInbox 改为类型接口，不再导出可构造的运行时类；插件通过 agent.inbox 读写待处理消息，hasPending 与 claim 不再属于公共接口。 @kermanxsidebar.panellist 与 main 注册全局面板；原 conversation Slot 迁移为 main 的 conversation key @imccyuThis first release candidate for 0.1.5 summarizes the major user- and developer-facing changes since v0.1.2-rc.1.
dsh 0.1.5-rc.1 是一个内容较广的候选版本，核心亮点是新默认模型 `DeepSeek-V41-Flash`（支持文本、图像与历史内系统提示更新），新会话默认使用它，显式配置的模型优先。Web 端新增可标签化、可分栏的右侧边栏，支持 Markdown、代码、HTML、PDF 和图片预览（原 Detail 面板被移除）、任意文件上传、标题栏“Open in”启动器，并优化了长会话性能。对插件生态而言这主要是一次兼容性升级：会话格式升级到 V3、持久化 API 改由生命周期作用域的 `SessionHandle` 承载且 `agentLoop.create()` 变为异步、默认文件工具改为 read/write/edit（`str_replace_editor` 需显式开启），同时插件 API 有变更（移除 `ctx.agent`、`Inbox` 变为纯类型接口、Web 面板插槽调整、persona 拆分为前缀与后缀）。尽管官方变更列表的 breaking 段为空，插件与 SDK 作者仍应将其视为需要改代码的升级。
Though no items are listed as breaking, several changes require code updates: (1) Session format V3 — new log files replace old ones during migration and upgraded sessions cannot be read by older versions; custom log readers must adapt (see the session-format-v2-to-v3 README). (2) Session persistence is now owned by lifecycle-scoped `SessionHandle`s, `agentLoop.create()` is async, and a new lock ensures one process per session. (3) Default file tools are read/write/edit in SDK, Headless and ACP; `str_replace_editor` and persistent-shell-only modes must be opted into explicitly. (4) Plugin APIs: `ctx.agent` is removed (pass the Agent explicitly), `Inbox` is a type-only interface accessed via `agent.inbox`, Web panel registration moves to `sidebar.panellist`/`main` (old `conversation` slot becomes `main.conversation`), and custom persona config must be split into prefix and suffix. Also note new sessions default to `deepseek-flash` unless a model is configured.
/feedback 命令新增支持提交明细反馈内容 @CreatixChusidebar.panellist 与 main 注册全局面板；原 conversation Slot 迁移为 main 的 conversation key @imccyuminimal 与 Python sdk-minimal 默认仅提供持久 shell，str_replace_editor 改为显式启用；持久 Bash 输出统一报告退出或超时状态 @koalazf99fs-ext 本地编译的问题 @imccyu/feedback 命令新增支持提交明细反馈内容 @CreatixChufs-ext 本地编译的问题 @imccyusidebar.panellist 与 main 注册全局面板；原 conversation Slot 迁移为 main 的 conversation key @imccyuminimal 与 Python sdk-minimal 默认仅提供持久 shell，str_replace_editor 改为显式启用；持久 Bash 输出统一报告退出或超时状态 @koalazf990.1.5-alpha.2 版本丰富了对话工作流，新增常见文档预览和模型明确交付文件的功能，并增强了 /feedback 反馈与界面本地化/可访问性。对于插件生态，该版本引入带迁移文档的 V3 会话格式、调整 Web 插件面板注册方式、发布需显式启用的实验性 Agent Teams 配置，并将最小化 shell 配置默认改为不含 str_replace_editor，需显式选择启用。
No blocking breaking changes are listed, but plugin developers should update web panel registrations: use sidebar.panellist and main.conversation instead of the old conversation slot. For session data, follow the provided session-format-v2-to-v3 migration guide when upgrading stored sessions. Users on the web minimal or Python sdk-minimal profiles must explicitly opt in to str_replace_editor if needed, as those profiles now default to shell-only.
code 预设引用自动迁移。自定义日志读取器需适配新格式；升级后的会话不支持降级读取。 @tianyicuictx.agent，调用方需显式传递 Agent；同时修正可继续对话的子代理归属，避免它们被当作根会话参与定时调度。 @kermanxInbox 改为类型接口，不再导出可构造的运行时类；插件通过 agent.inbox 读写待处理消息，hasPending 与 claim 不再属于公共接口。 @kermanxfs-ext 需要本地编译的问题 @imccyufs-ext 需要本地编译的问题 @imccyucode 预设引用自动迁移。自定义日志读取器需适配新格式；升级后的会话不支持降级读取。 @tianyicuictx.agent，调用方需显式传递 Agent；同时修正可继续对话的子代理归属，避免它们被当作根会话参与定时调度。 @kermanxInbox 改为类型接口，不再导出可构造的运行时类；插件通过 agent.inbox 读写待处理消息，hasPending 与 claim 不再属于公共接口。 @kermanx本次 alpha 版本聚焦 UI/UX 与插件 API 优化。亮点包括：支持模型声明可动态更新系统提示而不失效 KV 缓存、新增实验性侧边栏并移除 Detail 面板、会话格式升级为 V3 并迁移日志，以及 Agent/Inbox API 的破坏性调整。插件开发者需适配新会话格式和接口变更，普通用户可体验改进的编辑器、中文本地化及子代理更新。
If you maintain custom log readers, migrate to session format V3; older sessions are upgraded in place with originals preserved, and downgrade reads are unsupported. For agent plugins, stop using ctx.agent and pass the Agent instance explicitly; root-only scheduling now correctly excludes continuable subagents. For inbox access, import Inbox as a type only and read pending messages via agent.inbox—hasPending and claim are no longer public. Update slash command or interface integrations if they relied on the removed Detail panel.
该 0.1.3-alpha.2 版本侧重于稳定性和开发者体验：pi-ai 升级至 0.85.1 以支持更多新模型，新增“在应用中打开”工作区、子代理消息排队/编辑/删除/Steer/停止等增强，以及 PTC 模式下可展开命令输出。同时降低了长会话的卡顿和内存占用，修复了 Web 重连、自动滚动、Windows SDK 启动崩溃和进程清理等问题。对插件生态而言，最需要关注的变化是部分客户端的默认编辑工具调整、自定义 persona 配置拆分，以及普通 subprocess handle 移除 pid——这些都可能需要适配修改。
Existing custom persona configurations must be adapted to the new prefix/suffix structure, and old constants need updating. Code relying on pid in ordinary subprocess handles should be changed (terminal handles remain unaffected). Note that SDK, Headless, and ACP now default to read/write/edit for file editing, while Web minimal and sdk-minimal are unchanged; verify your plugin's overrides and behavior. Also review long-session performance improvements for any timing assumptions.
HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 与 NO_PROXY 配置。 @LegGasairead_image 的顶层与 PTC 嵌套工具调用会在 Web 工具卡中直接渲染图片，不再展示原始附件对象。 @Chinesezjcmodels 对象和 Anthropic 原生模型列表的支持，并支持回填模型名称、上下文窗口及最大输出 token 的回填。 @LegGasaiFS_NOT_OBSERVED 诊断，保留文件路径、结构化错误码和原始原因。 @turtle1999send_message 统一采用 steer 语义，并在跨 Agent 和冷恢复投递中保留发送者归属与顺序。 @Dudu-0223SessionHandle；agentLoop.create() 改为异步，新增session锁，同一session至多被一个进程持有。 @turtle1999node 开头的命令错误重写为 dsh runtime 的问题。 @imccyuHTTP_PROXY、HTTPS_PROXY、ALL_PROXY 与 NO_PROXY 配置。 @LegGasairead_image 的顶层与 PTC 嵌套工具调用会在 Web 工具卡中直接渲染图片，不再展示原始附件对象。 @Chinesezjcmodels 对象和 Anthropic 原生模型列表的支持，并支持回填模型名称、上下文窗口及最大输出 token 的回填。 @LegGasainode 开头的命令错误重写为 dsh runtime 的问题。 @imccyuFS_NOT_OBSERVED 诊断，保留文件路径、结构化错误码和原始原因。 @turtle1999send_message 统一采用 steer 语义，并在跨 Agent 和冷恢复投递中保留发送者归属与顺序。 @Dudu-0223SessionHandle；agentLoop.create() 改为异步，新增session锁，同一session至多被一个进程持有。 @turtle1999该 alpha 版本扩展了平台覆盖和 Web 功能，新增任意文件上传（含后台进度/取消及跨会话保留）、代理感知网络和 Python SDK macOS x64 支持；同时改进了模型发现和工具结果展示。但此版本引入了 Session 持久化 API 的破坏性变更及格式 v2 迁移，并存在一个已知性能回退，官方表示将在下一版本修复。
Session persistence is now owned by lifecycle-scoped SessionHandles; agentLoop.create() is asynchronous, and each Session is locked to at most one process. Existing v0/v1 session logs are automatically migrated to v2, but Assistant streams are now aggregated by attempt into durable settlements, so consumers of raw streams should adjust. No other breaking changes are noted. The known performance regression requires no migration action.
send_message 双向传递后续消息，取代单向 report 工具 @Dudu-0223/ 与 @ 菜单的图标、目录加载和文件搜索，支持通过鼠标在目录层级间导航 @Yifffan, @LegGasairead_image 读取没有扩展名的附件路径 @CreatixChuweb_search 失败时报告实际端点和错误明细 @CreatixChudsh Profile 启动，包括 Python SDK、ACP 模式等 @tianyicuiweb_fetch @koalazf99workflow 工具 @koalazf99Session.events 被按需读取 API seq、eventAt() 和 snapshotEvents() 取代 @kermanxSessionSeq 与 SessionLogOffset 使用强类型区分，本改造保持向前兼容 @tianyicui, @imccyu/goal 命令 @Magolornull 占位值 @lsdsjyrun_code 调用，不再被模型当作普通工具直接调用 @CreatixChuTab 可补全当前高亮的斜杠命令 @mektpoy作为 0.1.2 系列的首个候选版本，本版本汇总了自 v0.1.1-rc.2 以来的主要用户和开发者相关变更。
> oh-my-dsh 开源社区推出了帮助插件作者随着 DSH 版本升级插件代码的 skill： https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill. 欢迎 DSH 插件作者试用并参与开源共建。oh-my-dsh 与 DeepSeek AI 没有隶属关系，相关项目非 DeepSeek 官方出品。
send_message 双向传递后续消息，取代单向 report 工具 @Dudu-0223/ 与 @ 菜单的图标、目录加载和文件搜索，支持通过鼠标在目录层级间导航 @Yifffan, @LegGasairead_image 读取没有扩展名的附件路径 @CreatixChuweb_search 失败时报告实际端点和错误明细 @CreatixChu/goal 命令 @Magolornull 占位值 @lsdsjyrun_code 调用，不再被模型当作普通工具直接调用 @CreatixChuTab 可补全当前高亮的斜杠命令 @mektpoydsh Profile 启动，包括 Python SDK、ACP 模式等 @tianyicuiweb_fetch @koalazf99workflow 工具 @koalazf99Session.events 被按需读取 API seq、eventAt() 和 snapshotEvents() 取代 @kermanxSessionSeq 与 SessionLogOffset 使用强类型区分，本改造保持向前兼容 @tianyicui, @imccyuThis first release candidate for v0.1.2 summarizes the major user- and developer-facing changes since v0.1.1-rc.2.
> The oh-my-dsh open-source community has launched a skill to help plugin authors upgrade their plugin code alongside DSH version updates: https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill. DSH plugin authors are welcome to try it out and participate in open-source contribution. The oh-my-dsh org is not affiliated with DeepSeek AI, and their projects are not official DeepSeek products.
这个 0.1.2-rc.1 候选版本带来大量 UI/UX 和插件 SDK 升级，包括自适应对话流、可调整宽度、token 用量显示、全历史回合导航、子代理模型选择、第三方界面语言，以及实验性的 Inspector 和 Web 预览工具。启动成本、渲染效率和资源占用也得到明显优化。对插件生态来说，新的接入点（如提供方登录、插件元数据随官方请求上报等）扩展了能力，但部分 API 与默认行为的变更需要维护者关注。
No official breaking changes are listed, but a few notable changes may affect existing plugins or SDK users. Replace usages of `Session.events` with the new on-demand read APIs `seq`, `eventAt()`, and `snapshotEvents()`. The optional SQLite Session persistence backend has been removed, so export any needed data using an older release before upgrading. Also evaluate tool-exposure defaults: the general-purpose `workflow` tool is no longer enabled by default in Web PTC Mode, while `web_fetch` is now on by default, and Web interface access over a network requires a one-time token in the launch URL.
0.1.1-rc.2 或 0.1.2-alpha.3 升级时，应用可能启动失败或者会话列表标题丢失的问题 @imccyu0.1.1-rc.2 或 0.1.2-alpha.3 升级时，应用可能启动失败或者会话列表标题丢失的问题 @imccyu此版本是一个补丁版本，主要修复了从 0.1.1-rc.2 或 0.1.2-alpha.3 升级时可能导致应用无法启动或会话标题从列表中消失的问题。本次发布没有新增功能或破坏性变更，因此插件生态在API或行为上不受影响。现有插件仍可正常工作；受影响的用户应更新以获得平稳升级体验。
send_message 双向传递后续消息，取代单向 report 工具 @Dudu-0223web_fetch @koalazf99workflow 工具 @koalazf99Session.events 被按需读取 API seq、eventAt() 和 snapshotEvents() 取代 @kermanxSessionSeq / SessionLogOffset 强类型区分，请开发者关注兼容性 @tianyicuisend_message 双向传递后续消息，取代单向 report 工具 @Dudu-0223web_fetch @koalazf99workflow 工具 @koalazf99Session.events 被按需读取 API seq、eventAt() 和 snapshotEvents() 取代 @kermanxSessionSeq / SessionLogOffset 强类型区分，请开发者关注兼容性 @tianyicui本次 alpha 版本引入 send_message 实现父/子 Agent 双向消息，取代单向 report 工具，并将 Session.events 改为 seq/eventAt()/snapshotEvents() 按需读取，同时引入更强类型。还优化模型发现、UI、长会话渲染性能，并调整默认工具与网络行为。使用旧 API 的开发者需相应迁移。
Update agent communication from the one-way report tool to send_message if you used continuable child agents. Replace Session.events usage with seq(), eventAt(), and snapshotEvents(). Update code referencing SessionSeq/SessionLogOffset to use the new strong types. Also review default behavior changes: web_fetch is now enabled by default in Python SDK, Headless, ACP, and custom Profiles, while the general-purpose workflow tool is no longer exposed by default in Web PTC Mode.
read_image 可根据文件内容识别并读取没有扩展名的图片附件路径 @CreatixChuTab 可补全当前高亮的斜杠命令 @mektpoyread_image 可根据文件内容识别并读取没有扩展名的图片附件路径 @CreatixChuTab 可补全当前高亮的斜杠命令 @mektpoy0.1.2-alpha.2 之后的纯稳定化版本，没有新功能：重点在长会话——右侧导航现在可以预览并跳转尚未载入的轮次，渲染内存开销更低、代码高亮更流畅；消息可靠性同步改进，会话运行中追加的图片能正确回显并可靠投递，持续子代理的后续消息也支持图片。需要留意的是一项移除：可选的 SQLite Session 持久化后端已删除，已有内容不会被删除，但导出需要旧版本。官方更新日志未涉及插件 manifest 变更，已安装插件应不受影响。
web_search 失败时报告实际端点和错误明细 @CreatixChuSessionEvent.ignorable @tianyicui@ 菜单中下钻目录时面包屑丢失或路径消失的问题 @LegGasaiweb_search 失败时报告实际端点和错误明细 @CreatixChu@ 菜单中下钻目录时面包屑丢失或路径消失的问题 @LegGasaiSessionEvent.ignorable @tianyicui本版的主线是让系统状态可见：连接异常直接显示在界面上，支持自动重试和立即重连；每条回答末尾展示 token 用量与耗时；web_search 失败时报告实际端点与错误明细。插件列表改为按会话插件与全局插件分组，支持切换 Agent Preset 与跨预设搜索，会话标题区可查看活动的定时计划。对插件开发者：恢复 0.1.2-alpha.1 移除的 SessionEvent.ignorable，Remote 网关调用异常统一封装为 RemoteError；Node.js 24.0–24.11.1 上的启动失败与 HMR 失效问题也在本版修复。
/ 与 @ 菜单图标、目录加载、文件搜索 @Yifffan, @LegGasai@Remote 网关 @imccyudsh Profile 启动，包括 Python SDK、ACP 模式等 @tianyicui/goal 命令 @Magolornull 占位值 @lsdsjyrun_code 调用，不再被模型当作普通工具直接调用 @CreatixChu/ 与 @ 菜单图标、目录加载、文件搜索 @Yifffan, @LegGasai/goal 命令 @Magolornull 占位值 @lsdsjyrun_code 调用，不再被模型当作普通工具直接调用 @CreatixChu@Remote 网关 @imccyudsh Profile 启动，包括 Python SDK、ACP 模式等 @tianyicui0.1.2 系列目前体量最大的一次发布。长会话阅读被重新设计：已完成的回答默认折叠过程内容，配备紧凑的轮次导航、逐回答的 token 用量展示，正文宽度可自适应或拖拽调整、字号可调。Agent 能力扩展：启动子代理时可指定提供方、模型、推理力度与最大输出长度（含 Claude Code 与 Codex 子代理）；界面新增第三方语言，WebFetch 默认公开并带 SSRF 防护。对插件开发者：旧 ApiProxy 接口完成向 @Remote 网关的迁移，官方 DeepSeek 请求会携带已启用插件的包名与版本（可在设置中关闭），通过网络访问 Web 界面需要启动 URL 中的一次性令牌。Python SDK 新增 Windows x64 发行包；ACP 补齐标准会话控制、模型设置、MCP、权限与取消能力。
这是 DSH 插件市场 0.1.1-rc.2 发布候选版，日期为 2026-08-21。由于未提供具体变更，该版本可能包含对先前候选版的增量修复和改进。插件开发者在生产环境采用此 RC 前，应查看上游仓库了解详情。
DeepSeek-V4-Flash-Vision-Expask_user_question 回答内容支持多行输入、自动换行、Shift+Enter 换行@ 引用前增删改文本时，潜在的布局问题/proc/<pid>/root 绕过限制的问题DeepSeek-V4-Flash-Vision-Exp@ 引用前增删改文本时，潜在的布局问题/proc/<pid>/root 绕过限制的问题ask_user_question 回答内容支持多行输入、自动换行、Shift+Enter 换行这是 DSH 工具的一个候选版本（0.1.1-rc.1）。作为候选发布版，它供插件开发者在稳定补丁发布前测试兼容性。由于未捕获到详细变更日志，此处未列出具体更改；开发者应查看上游仓库以了解具体的修复或改进。
/goal、/plan 等命令可接收图文输入，@ 菜单支持引用文件和会话~ 缩写表示、输入框窄屏布局、反馈界面等web_search 支持并发查询、子代理 reportDelivery 会及时反馈并唤醒父任务dsh web 时会自动打开浏览器rg / glob 搜索和 MCP stdio 工具所需依赖/goal、/plan 等命令可接收图文输入，@ 菜单支持引用文件和会话~ 缩写表示、输入框窄屏布局、反馈界面等web_search 支持并发查询、子代理 reportDelivery 会及时反馈并唤醒父任务dsh web 时会自动打开浏览器rg / glob 搜索和 MCP stdio 工具所需依赖0.1.0-rc.8 是 dsh.so 插件市场 0.1.0 系列的第八个候选版本。作为候选版本，它侧重于稳定性和发布前验证。此元数据中未记录具体的功能变更。插件开发者应将其视为兼容性测试的检查点。
low 推理强度，默认仍为 highCode mode 更名为 PTC modelow 推理强度，默认仍为 highCode mode 更名为 PTC mode这是 DSH插件市场的候选版本 7（0.1.0-rc.7）。作为候选版本，它可能侧重于稳定化、缺陷修复和打磨，为 0.1.0 正式版做准备。本摘要未披露具体变更；插件开发者和用户应查看官方更新日志或仓库了解详情。
这是对新用户最重要的发布：dsh 系列包现已无需特殊权限即可从 npm 公开安装。npx @deepseek-ai/dsh web 在 http://127.0.0.1:3080 提供 Web UI。GitHub Releases 仍没有 tag 产物——版本历史的权威来源是 npm 注册表与 master 分支。插件表面（dsh.bundle / dsh.client manifest）预计会继续演进。
| 插件 | 状态 | 备注 |
|---|---|---|
modlens | unknown | Declares dsh.bundle manifest; not yet verified by dsh.so. |
dsh-opencode-usage | unknown | Declares dsh.client manifest; not yet verified by dsh.so. |
dsh-launcher-windows | unknown | External Windows launcher; no dsh manifest. |
0.1.0 系列在同一天开始，插件生态随之爆发：此后不久就出现了 300+ 个带 dsh-plugin 话题的仓库。dsh.so 将 0.1.0-rc 视为兼容性声明的首个相对稳定基线，但目前尚无任何插件通过独立验证。
| 插件 | 状态 | 备注 |
|---|---|---|
modlens | unknown | Author-declared bundle manifest; not yet tested by dsh.so. |
dsh-launcher-windows | unknown | External Windows launcher; no dsh manifest. |
npx @deepseek-ai/dsh web.首个公开 npm 产物。DSH 进入开发者预览，npx @deepseek-ai/dsh web 成为可用的命令行安装方式。该版本没有发布 GitHub Release tag——版本历史通过 npm 与仓库提交追踪。
| 插件 | 状态 | 备注 |
|---|---|---|
modlens | unknown | Plugin ecosystem had not yet formed. |