--- title: "DSH 0.1.5-alpha.1 更新：会话 V3、侧栏与插件兼容" seo_title: "DeepSeek Harness 0.1.5-alpha.1：DSH 升级选择与会话 V3" description: "解读 DeepSeek Harness 0.1.5-alpha.1 的会话 V3、右侧 Sidebar 与 Agent/Inbox 变化，区分 npm 通道、历史数据回退和插件适配，提供升级前后核对清单。" canonical: https://52dsh.com/tutorials/deepseek-harness-0-1-5-alpha-1/ authors: ["52DSH 编辑部"] audience: ["评估预发布的 DSH 用户","维护历史会话与插件的开发者"] outcomes: ["区分默认版与 alpha 通道","判断 V3 迁移和回退边界","定位需复核的插件能力"] prerequisites: ["记录原程序与插件版本","保留独立数据和配置副本","核对插件依赖的会话与 Agent 接口"] difficulty: intermediate estimated_action_time: null next_steps: null published_at: 2026-09-09 updated_at: 2026-09-09 verified_on: 2026-09-09 maintenance_status: community verification_level: source_reviewed risk_level: high dsh_version: 0.1.5-alpha.1 plugin_id: null tutorial_kind: null related_plugin_url: null --- # DSH 0.1.5-alpha.1 更新：会话 V3、侧栏与插件兼容 解读 DeepSeek Harness 0.1.5-alpha.1 的会话 V3、右侧 Sidebar 与 Agent/Inbox 变化，区分 npm 通道、历史数据回退和插件适配，提供升级前后核对清单。 升级后已有会话打不开时，按[会话迁移失败与未知事件排查](/errors/dsh-session-open-failed/)先保留副本并分流错误；列表可见不代表正文恢复成功。 ## 要不要升级：先按使用方式选择 DeepSeek Harness（DSH）0.1.5-alpha.1 是预发布版，包含 Session V3、实验性右侧 Sidebar 和插件接口变化。2026-09-09 核对时，精确 npm 包已发布，`alpha` 指向该版本；`latest` 和 `next` 仍为 `0.1.2-rc.1`。**维护现有环境时，本站默认安装命令继续固定 rc.1；需要新能力时，先在独立数据副本评估。** 本次最需要先理解的是数据回退：新版可迁移受支持的历史会话，但旧程序不能降级读取 V3。保留原日志不等于保留了升级后所有新增对话的旧版副本。版本和迁移说明基于官方固定源码与文档，未执行完整真实数据迁移；下方插件复核另包含隔离启动与合成测试，并逐项说明限制。 | 使用方式 | 今天怎样选择 | |---|---| | 普通用户，当前任务正常 | 保留原版本，按[安装指南](/tutorials/deepseek-harness-install-web-ui/)维护；不要只因版本号变大而覆盖唯一数据 | | 需要新版界面或修复 | 阅读下面的变化与限制，用独立副本检验自己的任务；完整维护步骤见[更新与回退指南](/tutorials/dsh-update-uninstall/) | | 重度插件用户 | 先核查会话读取、消息控制和旧面板依赖；插件能安装不等于能正确恢复历史或完成任务 | | 插件作者 | 对照固定 Agent/Inbox 接口及 V3 格式审阅调用链；编译通过之后仍需隔离运行验收 | ## 版本与证据 | 项目 | 本次核对 | |---|---| | GitHub Release | dsh-v0.1.5-alpha.1，预发布 | | 发布时间 | 2026-09-08 16:16:04 UTC；北京时间为 9 月 9 日 00:16:04 | | 固定提交 | `5dda764ed3aa172535a7967b06ff95d9cbfe536a` | | npm latest / next | 均为 0.1.2-rc.1，仍是候选版 | | npm alpha / 精确包 | 0.1.5-alpha.1 / 已发布 | | 核验边界 | tag 指向该提交；npm 未提供 gitHead，未完成包与源码构建一致性验证 | 官方变更比较从 0.1.3-alpha.2 开始。从 rc.1 升级还要考虑此前 Session v2、默认文件工具、persona 和 subprocess 的变化，不能把本页当作所有中间版本的完整迁移脚本。可结合[历史 alpha.1 专题](/tutorials/deepseek-harness-0-1-3-alpha-1/)与官方完整差异阅读。 ## Session V3：格式变化与历史数据 固定格式 catalog 当前为 3，包含 V0→V1→V2→V3 相邻转换。这里只支持通过对应校验的历史数据，不是任意 JSONL 或旧 SQLite 数据库都能自动转换。 V2→V3 将系统提示词变成消息历史的一部分。插入系统事件会改变事件数量和部分引用坐标，因此自定义日志读取器不能继续把旧事件序号当成新版中的同一位置。迁移还处理精确的旧 PTC 标签和 `code` 预设引用；它不是全文替换，不会改写任意工具参数或 settings.yaml 中同名字符串。 | 操作 | 0.1.5-alpha.1 固定实现的边界 | |---|---| | stat / list | 读取所选 generation 的头部，不启动事件正文迁移 | | 只读 open | 准备并校验历史输入的当前逻辑结果，不发布后继文件 | | 写 open / 可运行恢复涉及的写入路径 | 校验并复查源修订后，在同目录发布新 generation，源文件保持不变 | | 旧程序打开新版数据目录 | 可能选中它无法理解的最高 generation；不能靠降包版本实现数据回退 | 这与本站历史 0.1.3-alpha.1 说明的只读打开行为不同，必须按宿主版本阅读。应用中的“查看”动作未必只调用底层 read，因此不能把这张表当成所有界面操作零写入的保证。 迁移会拒绝未知事件和部分未经审计的扩展字段。拒绝时保留源字节、不发布后继；应保存脱敏的错误类型、事件位置和版本交给维护者，不能删除报错事件、改 header 版本或重命名 generation 来强行通过。Session 格式文档与 JSONL README 的部分布局例子仍展示 v2；当前版本以固定 catalog 的 3 为准。 具体恢复与 Fork 概念见[Session 使用与恢复指南](/tutorials/dsh-session-guide/)。 ## 实验性右侧 Sidebar 怎样使用和判断 官方右侧 Sidebar 接替原 Detail 面板，文件链接和产出文件可在侧栏打开，支持标签、分栏和全屏。已有会话时，可从会话头部角落的展开入口打开；普通模式让聊天区域让出空间，窄屏会使用全屏呈现。 侧栏状态按会话分别保留在内存，切换会话后可回到原布局；刷新页面会恢复折叠默认态。不要把它当成跨刷新保存的工作区。它也不意味着 Better Sidebar 等第三方插件全部被替代，需比较具体功能和所依赖槽位。 建议用不含敏感信息的小文本产物检查打开、切换标签、分栏和刷新行为；这里列的是待执行验收，不是本站实测结果。 ## Agent 与 Inbox：插件作者需要检查什么 新版移除 `ctx.agent`，在需要身份的调用链显式传入 Agent。创建时的 `setup(agentCtx, agent)` 区分作用域上下文和实际 Agent，不能用 Context 上旧的反向属性补回身份。 `Inbox` 是类型接口，不再作为公开运行时类构造；经 `agent.inbox` 操作待处理消息，公开面不再包含 `hasPending` 和 `claim`。官方公开接口列出了 nextTurn/nextStep 与 append、prepend、replace、remove、clear、splice 等操作。具体迁移要保留原来的消息语义，不能机械地给旧方法换名字。 可继续对话的子代理归属也有修正。对消息队列、自动继续、定时调度及团队插件，至少验收主/子会话归属、暂停后恢复入口、排队与插话的实际结果。只搜索到旧 API 字符串不足以证明活动代码会执行，搜索不到也不足以证明兼容。 ## 其他体验改进如何理解 动态系统提示词保留 KV Cache 需要模型显式声明支持；不能写成所有模型都省 token 或账单必然下降。缓存命中、请求用量和费用是不同指标，应对照具体模型返回值。 本版还调整会话统计与中文斜杠命令，统一忙碌时发送按钮和 Enter 的行为，修复用户暂停目标被模型恢复、POSIX 本地图片显示等问题。macOS/Linux 的 fs-ext 本地编译问题得到处理，但固定 JSONL 实现仍依赖匹配的预编译系统 addon；不能承诺所有架构都没有原生依赖问题。用户原有错误仍按[Web UI 启动排障](/errors/web-ui-start-failed/)定位。 ## 9 月 9 日插件复核：哪些可以更新 本轮目录只将 [Auto Continue](/plugins/hsiangnianian-dsh-auto-continue/) 从 0.8.1 更新为 **0.11.4**，保持“源码审阅”等级。旧版在新宿主导入 `settingsNamespace` 失败；新版启动通过，并补做停止尊重、暂停、续跑和循环保护的合成验收。**以下“通过”均有测试范围，不代表全部插件适配或真实模型任务已验证。** | 插件 | 候选版本与测试结果 | 本站更新决定 | |---|---|---| | [Auto Continue](/plugins/hsiangnianian-dsh-auto-continue/) | 0.11.4：实际发行引擎 130 项合成断言通过，客户端模块/设置同步模拟通过 | 目录更新到 0.11.4；真实模型与副作用重试未验证 | | [IM](/plugins/xmanrui-dsh-im/) | 4.16.1：166 项合成测试通过，覆盖钉钉卡片失败回退、模型设置、会话绑定和企业微信应用回调等 | 保留 4.15.0；真实渠道收发、文件回传及 V3 恢复待验收 | | [Better Sidebar](/plugins/omdsh-dev-dsh-better-sidebar/) | 0.18.1：161 项固定源码测试通过，覆盖会话状态、固定页签、偏好、布局计算和脱敏 | 保留 0.18.0；官方新侧栏共存、刷新及实际文件交互待验收 | | [Share](/plugins/hellodigua-dsh-share/) | 0.4.0：16 项固定源码 DOM/设置测试通过，覆盖卡片、Markdown 和过程过滤 | 保留 0.3.1；实际 V3 页面与 PNG 图片导出待验收 | | [Agent Teams](/plugins/nanmicoder-dsh-agent-teams/) | 0.1.15 挂载调用缺失的 `registerContinuableSetup` | 暂缓新版，不作为新宿主适配推荐 | | [Cost Meter](/plugins/han-1413141-dsh-cost-meter/) | 1.7.16 的真实历史枚举函数漏掉 V3-only 夹具；凭据服务不可用时迁移后 flush 未保存原测试值 | 暂缓新版，需修复并重新验收 | | [Session Pruner](/plugins/mrzhangkris-dsh-session-pruner/) | 0.3.3 虽能启动，但仍按旧固定日志文件名扫描，npm gitHead 与发行源码不一致 | 暂缓新版，不用唯一会话副本试清理 | ### 测试环境与证据边界 隔离 Host 为 DSH 0.1.5-alpha.1、Node 22.22.0、macOS arm64，使用空数据根和独立 Profile；插件执行时禁止外网与真实用户数据访问。启动夹具通过本地链接引用 npm 发行包，公共宿主依赖固定为同一 alpha 版本；没有验证包管理器自动解析全部 peer 的正常安装流程。HTTP 200 仅证明 Host 能服务页面。 Auto Continue 与 IM 的运行测试调用实际发行代码，但事件、Agent 或渠道响应为合成输入。Share 与 Better Sidebar 的补充测试运行固定源码及 DOM 夹具；不是实际浏览器，也不是完整 V3 日志读取。浏览器验收因测试工具拒绝本地地址而未完成。以上结果不升级为全功能“编辑实测”。 Auto Continue 55 个、IM 313 个、Share 37 个 npm 文件与各自固定源码一致。Better Sidebar 169 个文件一致，package.json 有发布清理差异，lib 构建产物未独立重建核对。npm integrity 校验通过不等同于可复现构建证明。 ### 选用新版前怎样验证 Auto Continue 的精确安装目标为 `dsh-client-auto-continue@0.11.4`，安装入口和权限见[插件详情](/plugins/hsiangnianian-dsh-auto-continue/)。在可丢弃的 Profile 与数据副本中，先暂停自动续跑，再用无副作用任务检查人为停止、临时错误、连续次数上限和卸载后的监听器清理。通知“立即继续”会绕过冷却及连续上限，不要连续点击重试同一任务。 IM 4.16.1 新增实验性企业微信自建应用入口，涉及公网回调和企业可信 IP；暂不作为新手默认接入方式。Share 0.4.0 的“不展示过程”只是内容过滤，仍可能保留提问、最终回答或路径中的敏感信息，不能当作自动脱敏。Better Sidebar 的文件写入、终端与外部浏览能力仍按原权限边界管理。 若检查失败，停止测试宿主，恢复匹配的程序、Profile 与数据副本；Auto Continue 旧版 0.8.1 不能作为 alpha 宿主的有效修复方案。其他三款的现有推荐版本也不因此获得 alpha 兼容认证。 ## 升级前后核对清单 1. 记录正在运行的 Host 版本、启动入口、Profile、插件版本和锁文件；磁盘下载了新版不代表当前进程已更新。 2. 停止任务和相关进程，保留程序、配置、完整所需 Session 与工作区副本；凭据采用受保护的备份，不进入公开日志或 Git。 3. 评估使用独立数据根和副本；单独 Profile 不自动隔离共享 Session、凭据或插件自己的存储，也不要同时访问同一数据目录。 4. 先检验列出、读取和恢复重要历史会话，再执行低风险任务，检查工具结果、消息队列和插件入口。列出成功不代表正文迁移成功。 5. 若要回退，停止新版，使用旧程序与对应的旧数据副本；升级后新增内容需要另行保存和评估，不能承诺反向迁移或无损合并。 操作细节集中在[更新、回退与卸载指南](/tutorials/dsh-update-uninstall/)，插件安装层次见[Profile 与 Bundle 指南](/plugins/dsh-plugin-profile-guide/)。 ## 常见问题 ### npm next 会安装这次 alpha 吗 本次核对不会：next 仍指向 rc.1。通道会变化，评估时要明确精确版本，并确认自己具备隔离和恢复条件。 ### 保留旧日志为什么还需要备份 程序通常选择最高 generation；源文件保存不表示旧程序会自动退回它，也不包含新版之后的全部写入。恢复需要成套的数据、配置和程序版本。 ### 插件教程已经写了 rc.1，能否直接改成 alpha 不能。IM、Context、Cost Meter 以及侧栏、队列和记忆插件要按各自数据流核验。本文不宣称它们都失效，也不把未运行组合标为兼容。 ## 固定来源 - [官方发行说明](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.5-alpha.1) - [格式 catalog](https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/session/session-format-catalog/src/generated.ts) - [V2→V3 迁移规则](https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/session/session-format-v2-to-v3/README.zh.md) - [JSONL 持久化](https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/session/session-persistence-jsonl/README.zh.md) - [Agent/Inbox 类型](https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/core/agent/src/runtime-types.ts) - [Agent 生命周期](https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/core/agent/README.zh.md) - [右侧 Sidebar](https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/client/ui-sidebar-right/README.zh.md) - [系统提示词](https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/core/system-prompt/README.zh.md) - [npm 精确包](https://registry.npmjs.org/@deepseek-ai%2Fdsh/0.1.5-alpha.1) - [npm 通道](https://registry.npmjs.org/-/package/@deepseek-ai%2Fdsh/dist-tags) - [Auto Continue 固定源码](https://github.com/HsiangNianian/dsh-auto-continue/blob/592afc0c143c1daf1c4fb3dd01a4547dd0e626c8/src/host/engine.ts) - [IM 固定变更记录](https://github.com/xmanrui/dsh-im/blob/ccabfeb9cbe8f6e545a5588791f815970db8b109/CHANGELOG.md) - [Better Sidebar 固定源码](https://github.com/omdsh-dev/DSH-better-sidebar/blob/364a48df989238a294c840369a59a84d7981443f/src/client/state.ts) - [Share 固定导出逻辑](https://github.com/hellodigua/dsh-share/blob/4cca10110cc3cde7b58febfd2c1ffdbdc66c630d/src/client/card.ts) ## 原始来源 - https://github.com/hellodigua/dsh-share/blob/4cca10110cc3cde7b58febfd2c1ffdbdc66c630d/src/client/card.ts - https://github.com/omdsh-dev/DSH-better-sidebar/blob/364a48df989238a294c840369a59a84d7981443f/src/client/state.ts - https://github.com/xmanrui/dsh-im/blob/ccabfeb9cbe8f6e545a5588791f815970db8b109/CHANGELOG.md - https://github.com/HsiangNianian/dsh-auto-continue/blob/592afc0c143c1daf1c4fb3dd01a4547dd0e626c8/src/host/engine.ts - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.5-alpha.1 - https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/session/session-format-catalog/src/generated.ts - https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/session/session-format-v2-to-v3/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/session/session-persistence-jsonl/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/core/agent/src/runtime-types.ts - https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/core/agent/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/client/ui-sidebar-right/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/5dda764ed3aa172535a7967b06ff95d9cbfe536a/packages/core/system-prompt/README.zh.md - https://registry.npmjs.org/@deepseek-ai%2Fdsh/0.1.5-alpha.1 - https://registry.npmjs.org/-/package/@deepseek-ai%2Fdsh/dist-tags