带 dsh.so 解读的版本追踪——自动跟踪官方 GitHub Releases 页面（github.com/deepseek-ai/deepseek-harness/releases），官方双语更新日志自动同步，并附 dsh.so 的解读：每个版本对用户意味着什么、对插件意味着什么。
dsh 0.2.2-rc.2 是一个改动量很大的预发布版本：新增按分支、提交与文件类别进行的 Git Worktree 代码评审、可命名的多级 SubAgent 与按会话启用的 AgentTeam，以及桌面端稳定/开发更新通道切换。其余多为代码评审、侧边栏与插件组织、聊天历史加载与 diff 渲染等体验打磨，并修复了大量稳定性问题。对插件开发者而言 API 面变化明显：插件可动态注册 MCP 服务器、按语言扩展聊天代码块渲染、插件索引可提供 stars 与 npm 下载量、自定义模型提供方支持原生 Gemini，同时工具错误分类、会话事件批量追加、菜单定位等契约有调整。官方虽未标注 breaking，但多处明确要求迁移。
Read the official upgrade guide before rolling this rc out. Main items: (1) Web search now defaults to the DeepSeek Search API — migrate older providers and custom search settings, and review Search vs Fetch billing. (2) Archiving a session now cleans up eligible Git worktrees (branches and commits are preserved) — disable cleanup to keep local directories, and migrate custom Forge plugin/config. (3) AgentTeam now runs on unified named subagents with the interrupt tool off by default — migrate custom plugins and SDK integrations, and upgrade all processes that share session storage together. (4) Plugin/SDK contracts: adopt the new menu-positioning API for custom panels, support batched session event appends, update tool-failure error classifications, and migrate Stagehand's removed extensionId setting (Stagehand 4.4.0 / Zod 4.6.6). (5) Reconfigure Computer Use behavior, LiveShare grants, Windows extra-directory grants (file tools only), and legacy Office/skill package names, and update anything referencing old dsh-doc skill names or paths. Optional-plugin failures now no longer block Web startup, so verify that enabled plugins actually load.
subagent_oar工具」插件，可将独立任务交给本机 Codex 或 Claude CLI。 @tianyicuiwebsocketCompression 关闭。 @imccyuapply_patch 工具，一次完成多文件新增、编辑、删除和移动，并在 Review 中查看变更。 @sjw1231, @CreatixChusdk-minimal 配置在请求模型或执行工具前保存会话恢复记录；保存失败时不会继续相关操作，提高短会话中断后的可恢复性。 @LogosVeritasrun_code 记录的代码页缺少 TypeScript 或 Python 语法高亮的问题。 @kermanx作为 0.2.2 系列的首个候选版本，本版本汇总了自 v0.2.1-rc.5 以来的主要用户和开发者相关变更。
subagent_oar工具」插件，可将独立任务交给本机 Codex 或 Claude CLI。 @tianyicuiwebsocketCompression 关闭。 @imccyusdk-minimal 配置在请求模型或执行工具前保存会话恢复记录；保存失败时不会继续相关操作，提高短会话中断后的可恢复性。 @LogosVeritasrun_code 记录的代码页缺少 TypeScript 或 Python 语法高亮的问题。 @kermanxapply_patch 工具，一次完成多文件新增、编辑、删除和移动，并在 Review 中查看变更。 @sjw1231, @CreatixChuThis first release candidate for 0.2.2 summarizes the major user- and developer-facing changes since v0.2.1-rc.5.
0.2.2-rc.1 是一个以移动端/平板体验、多语言（日、西、法、德、俄、巴西葡语）以及插件平台重构为主的候选版本，而非主打终端用户新功能。对插件开发者影响最大的是：工具可按步骤条件性激活并采用新的 tools.resolve/executable 契约，原生与 PTC 执行被拆分为 Agent 作用域的插件，模型选择改由 agent.model 决定，Session Projection 注册改为异步，PTC Node 控制通道迁移到 birpc 且 SSH 协议从 2 升到 3。平台同时升级到 Cordis Core 4.1.0/Loader 1.1.0/Include 1.1.0 与 pi-ai 1.3.0，Node.js 最低版本提高到 24.9，并新增 apply_patch、默认关闭写前读取检查。subagent_oar、统计、变更请求与 worktree、个性化推荐等实验性能力仍在实验开关之后，因此在 0.2.2 正式版前 API 仍可能继续调整。
Upgrade the runtime to Node.js 24.9+ before installing. Plugin authors must migrate the tool layer: adopt the per-step activation contract (tools.resolve/executable plus prompt-assembly integration), replace tools.mode / DSH_TOOLS_MODE usage with configuration overlays now that native and PTC execution are Agent-scoped plugins, select models through agent.model instead of rewriting routes in agent/request, and treat a caller-cancelled run_code as ABORTED rather than CODE_RUN_FAILED. Session Projection registration is now asynchronous, so retain the returned handle at startup. Self-hosted bootstraps and SSH helpers must be upgraded together (SSH protocol 2 -> 3). Remove @deepseek-ai/dsh-experimental-tool-worktree from dsh.profile.bundles if the standalone plugin was enabled, and re-add an explicit observation policy if a profile still needs read-before-write checks. Set explicit context/output capacities for custom endpoints smaller than the new 1M/128K defaults, restart the SDK after plugin changes, and note websocketCompression is now on by default for remote connections.
apply_patch 工具，一次完成多文件新增、编辑、删除和移动，并在 Review 中查看变更。 @sjw1231 @CreatixChu$$ 数学块的不稳定兼容解析。 @yudshjrun_code 记录的代码页缺少 TypeScript 或 Python 语法高亮的问题。 @kermanxrun_code 记录的代码页缺少 TypeScript 或 Python 语法高亮的问题。 @kermanxapply_patch 工具，一次完成多文件新增、编辑、删除和移动，并在 Review 中查看变更。 @sjw1231 @CreatixChu$$ 数学块的不稳定兼容解析。 @yudshjdsh 0.2.2-alpha.3 是一个打磨型 alpha 版本,在扩展插件能力的同时简化了默认行为。插件现在可以按 Session 身份与请求用途提供动态 pi-ai 请求头(非法请求头会在派发前被拒绝),可为设置页提供导航图标,并获得能区分安装失败与激活失败的更清晰诊断信息。实验性的 change-request/worktree 流程已整合原先独立的 Git worktree 入口,并新增可搜索的 diff 文件树与向 Agent 引用代码的能力;Cordis Core/Loader/Include 的升级与 SDK 插件管理命令意味着插件作者需要针对新的配置管线重新验证。默认值变化值得注意:`apply_patch` 默认关闭,read-before-write 与外部变更检查默认关闭(沙箱限制与 Review 保留),alpha.2 中不稳定的多行 `$$` 数学解析已回滚。
1) If you had enabled the standalone worktree plugin, manually remove @deepseek-ai/dsh-experimental-tool-worktree from dsh.profile.bundles in your profile — the entry now lives in change requests/worktrees. 2) Re-verify plugins against Cordis Core 4.0.0-rc.11 / Loader 1.0.0-rc.8 / Include 1.1.1, which unify configuration access, entry changes, and persistence. 3) SDK users must restart the SDK after plugin changes; TS/Python SDKs now expose native commands and plugin management. 4) Read-before-write and external-change checks are now off by default; profiles that relied on them must explicitly restore the previous observation policy. 5) `apply_patch` is opt-in and disabled by default. 6) Plugins supplying pi-ai headers must use Session identity/request purpose or their headers will be rejected pre-dispatch.
这是一个小型的 0.2.1 候选发布版本，重点是展示效果而非运行时行为。唯一列出的变更是改进对话中思考内容的显示方式，没有新增功能、修复或破坏性变更。对插件开发者而言，这应是一个低风险更新：该版本未显示 API 或插件契约发生变化，不过涉及推理/思考内容渲染的 UI 插件可检查其输出是否与改进后的显示一致。
subagent_oar工具」插件，可将独立任务交给本机 Codex 或 Claude CLI @tianyicuiwebsocketCompression 关闭。 @imccyusdk-minimal 配置在请求模型或执行工具前保存会话恢复记录；保存失败时不会继续相关操作，提高短会话中断后的可恢复性。 @LogosVeritassubagent_oar工具」插件，可将独立任务交给本机 Codex 或 Claude CLI @tianyicuiwebsocketCompression 关闭。 @imccyusdk-minimal 配置在请求模型或执行工具前保存会话恢复记录；保存失败时不会继续相关操作，提高短会话中断后的可恢复性。 @LogosVeritasDSH 0.2.2-alpha.2 是一次覆盖面较广的预发布：插件管理器的富文本详情、移动端/平板输入与布局优化、六种新界面语言，以及若干实验性能力（逐步统计、Git worktree 变更请求，以及可将任务委派给本地 Codex/Claude CLI 的 subagent_oar 工具）。对插件开发者来说，这主要是一次迁移版本：工具改为按步骤条件激活，原生与 PTC 执行被拆分为 Agent 作用域插件，Custom plugin markets 更名为 plugin indexes，官方 bundle 列表迁移到 @deepseek-ai/dsh-official-bundles，Session 投影改为异步保留句柄。第三方插件更新器现在支持热更新，并在失败时回滚到上一版本；最低 Node.js 版本提升至 24.9。PTC 控制通道改用 birpc（SSH 协议从 2 升到 3），自建 bootstrap 与 SSH 辅助程序需要一同升级。
1) Upgrade Node.js to >= 24.9 before upgrading DSH. 2) Custom plugins: migrate to asynchronous retained Session-projection handles; legacy registration disposers and key-based reads still work but emit deprecation notices, and approval-state recovery now requires the composition to provide `sessionProjections` and to await service activation. 3) Tool plugins: migrate `tools.resolve`/`executable` and prompt-assembly integration to per-step conditional activation; split native and PTC execution into Agent-scoped plugins and migrate `tools.mode` / `DSH_TOOLS_MODE` usage to configuration overlays. 4) Select models through `agent.model` rather than changing routes in `agent/request`. 5) Update imports of official bundle lists from `app-boot` to `@deepseek-ai/dsh-official-bundles`. 6) “Custom plugin markets” are renamed to “Custom plugin indexes”; user-added index files are discovered automatically. 7) PTC: control channel moved to birpc — upgrade self-deployed bootstraps and SSH helpers together (SSH protocol 2 → 3); caller-cancelled `run_code` calls now report ABORTED instead of CODE_RUN_FAILED, so update SDK/Session cancellation handling. 8) Cordis Timer is synchronized with upstream; adapt to changed return values. 9) Undeclared custom models now default to 1M context / 128K output — set explicit capacities for smaller endpoints to avoid delayed compaction.
这是 dsh 0.2.1 的第四个候选发布版本，属于范围很窄的修补而非功能更新：变更列表中唯一一项是修复 ACP 模式下诊断信息泄漏到 stdout 的问题。对插件生态而言，实际意义在于协议输出的整洁性——在 ACP 会话中，插件或 harness 写入 stdout 的任何内容都可能污染面向客户端的协议流，此次修复可避免编辑器与 agent 客户端集成出现响应错乱。本版本未公布新增或变更的 API，也没有标记破坏性变更，因此现有插件应可照常工作。可将其视为低风险升级，主要影响发布或使用 ACP 相关工具的开发者。
No breaking changes, so no code migration is required. If your plugin prints logs or debug output while running in ACP mode, route them to stderr (or a log sink) instead of stdout to avoid re-introducing the stream corruption this release fixes.
DSH 0.2.1-rc.3 是一个候选发布版本，重点在界面与可靠性打磨，而非新增 API。左侧边栏、会话视图和右侧边栏新增了面向插件的菜单，方便浏览和创建插件，增强了 harness 内的插件发现体验。本次还修复了切换会话时未发送草稿丢失的问题，并让 DeepSeek API key 适配器的模型列表更新方式与账号登录保持一致。变更列表中没有破坏性变更，插件开发者可将其视为低风险升级，并适合提前测试。
dsh 0.2.1-rc.2 是一个预发布版本，新增了模型 DeepSeek-V4.1-Flash-1017，并在 Web Search 设置中引入了对 DeepSeek Search 与 Fetch API 的支持。本次没有 changed、fixed 或 breaking 条目，属于纯新增能力，而非修复或破坏性变更。对插件开发者而言，主要意味着需要适配新的模型标识，并考虑新增的可选检索链路——涉及联网搜索或抓取的工具需判断用户是否已开启这些 API，因为它们为显式开启且可能不可用。由于是 RC 版本，行为仍可能调整，建议先充分测试再在正式插件中依赖。
./invariant 导出；使用这些诊断入口的开发者需相应调整扩展或自定义 profile。 @turtle2099package.json，显示文本和图标须通过对应子路径导出；插件开发模板同步补齐本地化信息与图标。 @turtle1999engines.dsh 判断；未声明时沿用原有规则。插件作者需检查声明是否覆盖支持的 DSH 版本。 @turtle1999activity 和 usage 两个独立入口；覆盖旧 stats 整行的插件需要更新注册 ID。 @turtle1999--public-url 指定显示、打开及提供给模型的对外访问地址，支持带路径前缀的反向代理入口。 @oraluben/ 菜单未更新技能列表的问题。 @grllll作为 0.2.1 系列的首个候选版本，本版本汇总了自 v0.2.0-rc.2 以来的主要用户和开发者相关变更。
/ 菜单未更新技能列表的问题。 @grllll./invariant 导出；使用这些诊断入口的开发者需相应调整扩展或自定义 profile。 @turtle2099package.json，显示文本和图标须通过对应子路径导出；插件开发模板同步补齐本地化信息与图标。 @turtle1999engines.dsh 判断；未声明时沿用原有规则。插件作者需检查声明是否覆盖支持的 DSH 版本。 @turtle1999activity 和 usage 两个独立入口；覆盖旧 stats 整行的插件需要更新注册 ID。 @turtle1999--public-url 指定显示、打开及提供给模型的对外访问地址，支持带路径前缀的反向代理入口。 @oralubenThis first release candidate for 0.2.1 summarizes the major user- and developer-facing changes since v0.2.0-rc.2.
DSH 0.2.1-rc.1 是一个以插件体系为核心的大型预发布版本：插件现在可以从自定义索引源发现并安装，启用、禁用、卸载和更新时会同步依赖（可替换插件支持热重载），Minimal 模式可按需安装官方 Claude Code、Codex 套件，用于 headless、SDK 和 ACP 场景。同时新增大量扩展面——Session 状态记录 API、用户消息/文本与图片渲染/新会话页/模型选择器的扩展点，以及实验性的 Developer Tools、Git Worktrees、推理翻译插件，和一个被官方明确定位为“能力子集验证”而非完整兼容的 Claude Code Mods 兼容层。对插件开发者来说，主要成本在于契约清理而非新功能：invariant 运行时导出、子路径 package.json 读取、composer 的 `stats` 扩展 ID、混合 `both` 工具呈现模式、agent-instructions 的 `dshHome`、以及 `azure-openai-responses` 供应商名均已移除或改名，第三方兼容性现在优先以声明的 `engines.dsh` 范围为准。
Prerelease (rc) — pin versions deliberately; the official breaking list is empty, but several removed/renamed contracts require edits. Plugin authors should audit: (1) remove any use of runtime invariant plugins and `./invariant` exports; (2) subpath plugins must publish display text and icons via subpath exports — separate `package.json` files are no longer read; (3) composer statistics are split: re-register plugins that replaced the `stats` row under the `activity` and `usage` entry IDs; (4) the mixed `both` tool-presentation mode is removed — use `native` or `ptc`; (5) declare and verify `engines.dsh` in your manifest, as third-party compatibility now prioritizes it; (6) custom SDK runtimes must support session/wait, and custom Python PTC compositions must provide `sandbox` and `sandboxPolicy` services; (7) rename provider configuration `azure-openai-responses` to `azure`; (8) drop the per-row `dshHome` setting from agent-instructions and rely on DSH_HOME / the shared DSH_AGENTS_HOME directory; (9) note the SDK default profile is now a general AI Agent identity, and `--from-default-profile` overwrites an existing custom profile including its plugins and settings. Also review credential handling: Web/Desktop now prefer saved credentials while headless reads environment variables and .env files only.
conversation.input.model.label Slot，支持插件按模型渠道自定义输入框模型选择器中的名称展示。 @LegGasai/ 菜单未更新技能列表的问题。 @grllll/ 菜单未更新技能列表的问题。 @grllllconversation.input.model.label Slot，支持插件按模型渠道自定义输入框模型选择器中的名称展示。 @LegGasaidsh 0.2.1-alpha.5 是一个 alpha 预发布版本，没有新增重磅功能，也没有破坏性变更，主要内容是一个新增扩展点和若干修复。最值得关注的是新增的 `conversation.input.model.label` Slot，插件可以按 provider 在 composer 的模型选择器中自定义模型标签，这是插件能力面在面向 provider 的 UI 上的一次小扩展。修复同样与插件开发者相关：已打开 Session 的 `/` 菜单中的 skill 列表现在会在插件启用或禁用后刷新，插件开关能立即生效；同时优化了终端查询与重试、PTC Mode 引导、SDK/Web/headless 之间的模型身份提示一致性，以及 Windows/Linux 上 Page Up 导致界面左移的问题。由于仍是 alpha 版本，稳定版发布前仍可能有变动。
engines.dsh 判断；未声明时沿用原有规则。插件作者需检查声明是否覆盖支持的 DSH 版本。 by @turtle1999engines.dsh 判断；未声明时沿用原有规则。插件作者需检查声明是否覆盖支持的 DSH 版本。 by @turtle1999DSH 0.2.1-alpha.4 是一个以打磨插件与模型配置体验为主的小型预发布版本，核心行为没有大改。主要新增包括：可在 UI 中为单个自定义 API 模型配置推理等级，以及可从自定义插件索引源发现并安装插件，这让 dsh.so 这类注册表的接入方式更加灵活。第三方插件兼容性规则现在优先采用声明的 engines.dsh 范围，未声明时回退到原有规则。本次没有破坏性变更；修复涉及命令输入、Office 文件交付、开发者工具启用、Linux 启动开销以及失败命令状态显示。
No breaking changes, so no mandatory migration. Plugin authors should still verify that any declared engines.dsh range actually covers the DSH versions they support, since that declaration now takes precedence in third-party compatibility checks. Users who rely on non-default plugin indexes can start using custom index sources, but should confirm each source is trusted before installing from it.
dsh 0.2.1-alpha.3 是一个 alpha 版本，重点在凭据与密钥安全、上下文管理以及插件/运行时打磨。亮点包括：本地 HTTP 访问的 Web 应用支持 DeepSeek 账号登录；发送消息中检测到的密钥和令牌默认打码并可选择显示；极简模式支持读图、手动 /compact 以及长对话自动压缩；子代理可通过独立的 Agent Preset 统一管理角色和工具。对插件开发者而言，值得关注的是插件旧代码残留问题的修复（可热重载插件立即生效，否则提示重启）、Python SDK 的 Office 引擎改为按需下载，以及 TypeScript/Python SDK 支持带原始会话 ID 和工作目录的会话恢复。官方未列出 breaking 项，但 Azure provider 更名和新的 API key 优先级属于行为变更，升级前应检查相关配置。
Some real config review is needed despite no listed breaking items. (1) Azure provider: configurations using the azure-openai-responses provider name must be migrated to the renamed azure provider. (2) API key precedence changed: Web and Desktop now prefer saved credentials, while headless uses environment variables and .env files by default and no longer reads saved keys — verify which credential source your environment relies on. (3) --from-default-profile now replaces an existing custom profile, including its plugins and settings, so avoid reusing that flag on profiles you intend to keep. (4) Plugin behavior after updates: hot-reloadable plugins take effect immediately, while non-hot-reloadable changes require a restart — plan restarts accordingly. Session resume in the TypeScript and Python SDKs is additive; no migration required to keep existing session flows.
dsh 0.2.1-alpha.2 是一个 alpha 版本，重点在于扩展插件能力并收紧会话/运行时行为，而非推出单一重点功能。亮点包括实验性的推理翻译与 Git Worktrees 插件、带 TypeScript/Python SDK API 的 working_directory 工具、供实验插件使用的会话状态记录 API，以及 reasoning-body Slot 和官方 Markdown Content Factory，同时加入字体、麦克风选择与工作详情折叠等界面设置。对插件生态而言整体是增量式的，但 changed 列表移除了混合工具展示模式、取消了 agent-instructions 中按行配置的 dshHome，并重构了 Agent Team 消息投递与子代理完成 ID，因此依赖这些路径的插件与自定义 SDK 运行时必须同步适配。官方未单列 breaking 章节，但 alpha 阶段仍可能继续变动。
Alpha release — validate in a test profile before upgrading. Changes requiring action: (1) the mixed tool-presentation mode is removed; switch configurations and API calls to 'native' or 'ptc'. (2) The per-row dshHome setting for agent-instructions is gone; instruction directories now resolve from the process DSH_HOME or its default. (3) Agent Team messages go directly to the target Inbox with no separate outbox, automatic retries, or resend deduplication — migrate affected configuration and result fields. (4) Subagent tools now return child IDs immediately, so custom SDK runtimes must support session/wait. (5) Python PTC now applies session filesystem sandbox policies; custom compositions must provide sandbox and sandboxPolicy services. (6) The default SDK profile changed from a fixed coding persona to a general AI Agent identity — set an explicit persona if you relied on the old default. Experimental plugins (Reasoning Translation, Git Worktrees) and the on-demand Claude Code/Codex bundles are opt-in from the Plugins page.
--public-url 指定显示、打开及提供给模型的对外访问地址，支持带路径前缀的反向代理入口。 @oralubenpackage.json，显示文本和图标须通过对应子路径导出；插件开发模板同步补齐本地化信息与图标。 @turtle1999./invariant 导出；依赖这些诊断入口的扩展和自定义 profile 需要调整。 @turtle2099activity 和 usage 两个独立入口；覆盖旧 stats 整行的插件需要更新注册 ID。 @turtle1999--public-url 指定显示、打开及提供给模型的对外访问地址，支持带路径前缀的反向代理入口。 @oralubenpackage.json，显示文本和图标须通过对应子路径导出；插件开发模板同步补齐本地化信息与图标。 @turtle1999./invariant 导出；依赖这些诊断入口的扩展和自定义 profile 需要调整。 @turtle2099activity 和 usage 两个独立入口；覆盖旧 stats 整行的插件需要更新注册 ID。 @turtle1999dsh 0.2.1-alpha.1 是一个以插件开发体验、界面打磨和兼容性探索为主的 alpha 版本。亮点包括实验性的 Claude Code Mods 兼容层（主要用于验证其 API 大致是 DSH 插件能力的子集，而非承诺完整实用兼容）、插件管理中的“让 Agent 创建插件”入口、Markdown 预览中的 YAML frontmatter 展示、支持反向代理与路径前缀的 `--public-url`，以及可选的开发者工具包。对插件生态而言，重要变化偏结构性：运行时 invariant 插件与 `./invariant` 导出被移除，composer 的 `stats` 行拆分为 `activity` 和 `usage` 扩展项，子路径插件不再读取独立 `package.json`，显示文本与图标必须使用对应子路径导出。其他修复改善了 bundle 依赖处理，但替换已安装包版本仍需重启。
Breaking changes require action: (1) Extensions and custom profiles that use runtime invariant plugins or package `./invariant` diagnostic exports must be updated or removed, since those entry points no longer exist. (2) Plugins replacing the composer `stats` row must update their registered IDs to the new `activity` and `usage` entries. (3) Subpath plugins must stop relying on separate `package.json` files for display text and icons and use the corresponding subpath exports instead; plugin templates now include localized metadata and icons. (4) After enabling, disabling, or uninstalling bundles, dependency mapping fixes reduce stale/missing dependencies, but replacing an installed package version still requires a restart.
dsh 0.2.0-rc.2 是一个预发布版本，将 dsh 命令行随 macOS 与 Windows 桌面端一起打包，插件管理不再需要单独安装 Node 或 pnpm。该版本细化了插件安装与升级指引，区分已安装、不兼容与内置插件，并将第三方模型目录更新至 pi-ai 0.87.1。多项桌面端修复（计划评审、持久 PowerShell 补全、macOS/Linux 登录 shell 环境、Windows 沙箱权限修复）提升了插件开发者所依赖的 Agent 与终端工具稳定性。官方未声明破坏性变更，升级时主要需注意重新选择已被移除的模型 ID，并手动开启实验性的异步提问模式。
Release candidate; the change list declares no breaking changes. Post-upgrade checks: (1) pi-ai 0.87.1 removed some older model IDs, so saved model selections may need to be reselected in settings; (2) the experimental asynchronous question mode is off by default and must be enabled manually via configuration. On macOS/Windows, use the "Manage dsh command" menu bar item to install the bundled dsh command if you want CLI-based plugin management without a separate Node/pnpm install.
0.2.0 summarizes the major user- and developer-facing changes since v0.1.7-rc.2.作为 0.2.0 系列的首个候选版本，本版本汇总了自 v0.1.7-rc.2 以来的主要用户和开发者相关变更。
This first release candidate for 0.2.0 summarizes the major user- and developer-facing changes since v0.1.7-rc.2.
dsh 0.2.0-rc.1 是一个以打磨体验为主的候选版本，而非平台新能力的堆叠：会话运行状态动画、耗时信息与间距更流畅，图片过期后重新上传与继续对话更可靠，插件管理与内置插件清单的布局交互及安装引导更完善、保存插件配置等待时间更短，并修复了 Windows 资源管理器/打开文件夹、macOS 麦克风权限、Safari 流式响应刷新恢复以及部分 Linux 系统 npm 安装失败等问题。对插件生态最关键的变化是：Creator 模式增强了插件开发指引并提供 agent-experience 技能，Windows 内置沙箱新增权限诊断技能，使用 DeepSeek 账号模型的会话无需额外 API Key 即可联网搜索，同时自动化任务已从核心移出、改为由可选插件包提供。官方未声明破坏性变更，因此插件作者主要需要针对重构后的插件管理与 Creator 模式界面重新验证插件；由于是 RC 版本，建议先在预发布环境验证再投入生产。
No declared breaking changes. The main migration action: automation tasks are now delivered as an optional plugin bundle—install/enable it if you depended on the previously built-in automation tasks. If npm installs failed on your Linux system due to missing optional native prebuilt packages, upgrade/reinstall to pick up the fix. Since this is a release candidate, validate plugins (especially plugin-management and Creator-mode flows) in a staging environment before production rollout.
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. |