---
title: "DeepSeek Harness 0.1.2-alpha.3：长会话、图片修复与 SQLite Session 迁移"
seo_title: "DeepSeek Harness 0.1.2-alpha.3 更新：DSH 长会话、图片与 Session 迁移"
description: "DeepSeek Harness 0.1.2-alpha.3 更新了什么？整理 DSH 长会话导航、图片投递、read_image、连接与计划界面修复，并说明 SQLite Session 用户升级前的数据迁移风险。"
canonical: https://52dsh.com/tutorials/deepseek-harness-0-1-2-alpha-3/
authors: ["52DSH 编辑部"]
audience: ["使用长会话、图片或子 Agent 工作流的 DSH 用户","曾启用 SQLite Session 持久化后端的部署维护者"]
outcomes: ["区分 alpha.3 的界面修复、实现边界与默认安装通道","判断自己的工作流是否值得隔离评估 alpha.3","在升级前保护旧 SQLite Session 数据和回退环境"]
prerequisites: ["已记录当前 DSH 精确版本和 Session 持久化方式","评估预发布版前已准备配置、工作区与重要 Session 数据副本"]
difficulty: intermediate
estimated_action_time: "10～15 分钟阅读"
next_steps: {"success":["/tutorials/dsh-update-uninstall/","/tutorials/dsh-session-guide/"],"failure":["/errors/web-ui-start-failed/"]}
published_at: 2026-09-01
updated_at: 2026-09-01
verified_on: 2026-09-01
maintenance_status: community
verification_level: source_reviewed
risk_level: high
dsh_version: 0.1.2-alpha.3
plugin_id: null
tutorial_kind: null
related_plugin_url: null
---

# DeepSeek Harness 0.1.2-alpha.3：长会话、图片修复与 SQLite Session 迁移

DeepSeek Harness 0.1.2-alpha.3 更新了什么？整理 DSH 长会话导航、图片投递、read_image、连接与计划界面修复，并说明 SQLite Session 用户升级前的数据迁移风险。

## 先看结论：体验修复很多，SQLite 用户先不要直接升级

DeepSeek Harness（DSH）`0.1.2-alpha.3` 是官方于 **2026-08-31 发布的预发布版**。52DSH 于 2026-09-01 核对了 Release、固定提交 `dd6322d604e00eec1ba5e0c8541159906a21094a` 和 npm 元数据：精确版本包已经存在，但 npm `latest`、`next` 仍指向 `0.1.1-rc.2`。因此，alpha.3 已经可以作为明确指定的预发布版本评估，却没有取代本站默认教程基线。

普通用户最容易感知的变化是长会话导航、屏外代码高亮、排队图片与子 Agent 图片投递、无扩展名图片识别、斜杠命令 Tab 补全、Host 停顿连接判断和窄屏计划目录。**曾使用 SQLite 作为权威 Session 持久化后端的用户风险最高**：alpha.3 删除了这一后端，当前版本不会自动打开或迁移旧数据库。请保留旧程序、原数据和可回退环境，确认能在旧版本中完成符合自身部署方式的逻辑导出后，再评估升级。

本文是固定版本源码与官方说明审阅，**没有安装或运行 alpha.3，没有使用真实 Session、凭据或第三方插件，也没有执行 SQLite 数据迁移**。文中的“修复”是官方版本声明与固定实现事实，不代表本站完成了跨平台运行认证。

## 版本状态与默认安装通道

| 渠道 | 2026-09-01 核对结果 | 对用户的意义 |
|---|---|---|
| GitHub Release | `dsh-v0.1.2-alpha.3`，Pre-release | 新预发布版，不是稳定性承诺 |
| npm 精确版本包 | `0.1.2-alpha.3` 已存在 | 可以被明确引用，不等于默认安装已切换 |
| npm latest / next | 均为 `0.1.1-rc.2` | 普通默认安装仍按候选版基线判断 |
| 52DSH 默认教程基线 | `0.1.1-rc.2` | 旧教程保留自己的版本与复核日期 |

版本通道会继续变化，操作前应重新核对[官方 Release](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.2-alpha.3)和 npm dist-tag。不要只看 GitHub 首页的最新标签，也不要把“精确包已发布”写成“所有用户已自动升级”。

## 哪些变化与你有关

| 你的场景 | alpha.3 对应变化 | 仍需注意 |
|---|---|---|
| 会话很长，目标轮次尚未加载 | 增加全日志轮次轮廓与加载后跳转 | 深跳转仍可能加载中间分页，完整轮廓也会随会话增长 |
| 长页面有大量代码块 | 代码块进入视口时再做语法高亮 | 不是列表虚拟化；已访问代码块仍占用内存 |
| 图片先排队发送，或继续子 Agent 时附图 | 统一图片接纳与回显职责，补齐连续子 Agent 图片传递 | 不应据此断言所有并发等待问题都消失 |
| 附件保存路径没有扩展名 | `read_image` 可按 PNG、JPEG、WebP、GIF 文件签名识别 | 文件权限、大小限制和真实解码仍然生效 |
| Host 短暂停顿后页面误报断线 | 网关容忍有限次心跳缺失，客户端不再因准备超时立即中止 | 服务退出、地址错误、认证失败仍需单独排查 |
| 使用斜杠命令候选 | Tab 可接受当前高亮候选或进入下一层 | 没有高亮候选时仍保留原生焦点移动 |
| 在窄屏查看计划目录 | 浮层会限制在视口边缘并允许纵向滚动 | 只处理目录布局，不代表整个任务已完成 |
| SQLite 保存权威 Session | 该持久化后端被移除 | 当前版不迁移旧数据库，先保全旧环境和数据 |

## 长会话：可以定位未加载轮次，不等于无限历史零成本

alpha.3 的轮次导航不再只依赖浏览器已经加载的消息。Session 投影会提供整个日志的轮次轮廓；用户选择尚未加载的轮次时，客户端先继续加载历史分页，再滚动到目标位置。右侧固定间距的轮次轨道用于预览和跳转，当前轮次也会随滚动位置更新。[长会话轮次导航官方说明](https://github.com/deepseek-ai/deepseek-harness/blob/dd6322d604e00eec1ba5e0c8541159906a21094a/packages/session/session-turn-outline/README.zh.md)

这解决的是“目标轮次不在当前分页里就无法直接定位”的问题，不应夸大成“任意长度会话都没有性能成本”。官方维护说明仍明确记录：完整轮廓数据会随 Session 增长，深层跳转可能需要加载中间页；如果投影不可用，界面退回到只导航已加载内容。

代码块高亮也改成进入视口后再启动解析，有助于减少首屏不需要的工作。它不会卸载已高亮内容，也不是消息虚拟列表，因此本文不提供未经官方基准支持的“快多少倍”结论。

## 图片投递：排队、子 Agent 和无扩展名路径分别修了什么

alpha.3 把用户消息及图片的接纳、排队和回显职责对齐到 Host。排队图片会保留可见缩略信息；可继续的子 Agent follow-up 也能够接收图片，而不是只把文本转发给子会话。返回结果仍应由实际 Session 事件和界面状态确认，不能仅凭看到缩略图认定下游已经处理完成。

官方修复记录同时保留一个边界：某些延迟竞争中，已接受消息可能保持等待，直到后续唤醒发生。因此，“图片投递更可靠”不等于“所有排队竞态已消失”。出现异常时应保存父／子 Session、发送顺序、图片数量和脱敏日志，不要反复上传真实敏感图片试错。

`read_image` 则补充了无扩展名附件路径识别：在文件系统授权和大小限制通过后，工具可从 PNG、JPEG、WebP 或 GIF 文件签名判断类型。已有但不受支持的非空扩展名仍会在读取前拒绝，最终是否可用还要以完整解码为准。这不是绕过文件权限或任意二进制探测入口。

## 连接、Tab 和计划目录属于针对性修复

当 Host 因同步工作短暂停顿时，alpha.3 的网关允许有限次心跳缺失，并安排后续终止检查；客户端准备阶段的超时改为警告，而不是直接把停顿 Host 当作断开。这只缩小一种误报，不会解决服务已退出、端口错误、代理中断、登录令牌失效或模型 Provider 401。具体分流继续使用[DSH Web UI 启动与连接排障](/errors/web-ui-start-failed/)。

斜杠命令菜单中，Tab 会处理当前高亮项：普通候选被选中，可继续展开的候选进入下一层；如果没有高亮项，Tab 仍执行浏览器原生焦点导航。窄屏计划目录则采用受视口约束的浮层，距离边缘保留空间，内容过高时自身滚动。这些变化改善键盘与移动端使用，不会改变命令本身的权限，也不会替用户执行计划。

## 高风险变化：SQLite Session 持久化后端被移除

这里必须区分三件名字相近的事：

1. **Session 没有被删除**，DSH 仍然记录和恢复会话；
2. **JSONL 成为唯一第一方权威 Session 持久化后端**；
3. 用于可重建查询索引或其他通用存储的 SQLite 代码仍可能存在，它们不等于被移除的权威 Session 后端。

alpha.3 的固定变更删除了 `session-persistence-sqlite` 包。官方简化说明明确表示：当前构建不会打开或迁移由旧后端创建的数据库；需要保留其中内容的维护者，应使用仍包含旧提供者的版本，在升级前导出逻辑 Session。上游未来可以再设计恢复工具，但本文不能把尚未提供的工具写成现有能力。

还要特别注意：Web Session Header 的下载按钮和 `/export` 文档要求 JSONL 后端提供的每 Session 原始产物。固定文档没有证明它能直接读取旧 SQLite 权威存储；旧版实现说明反而明确不支持 SQLite 导出。因此，**不要在 alpha.3 中直接对旧数据库尝试一个想当然的 `/export` 命令**，也不要删除唯一数据库副本。

### SQLite Session 用户的安全判断顺序

1. 暂停升级和新的写入操作，记录当前 DSH 精确版本、启动方式与持久化配置；
2. 正常停止旧实例，并按部署制度复制数据库、配置、Profile 与工作区；
3. 保留仍包含 SQLite Session 后端的旧程序和依赖环境，不在唯一副本上试验；
4. 根据旧版本固定文档或自身部署实现，验证能否逐个读取需要保留的 Session；
5. 只有在逻辑内容可复核、备份可恢复且回退路径明确后，才在隔离副本评估 alpha.3；
6. 官方步骤不足时暂停，不用未经来源验证的脚本转换生产数据。

本站本批不创建“SQLite 一键迁移教程”，因为官方尚未提供可被我们可靠引用并复核的通用恢复步骤。操作框架见[DSH 更新、回退与卸载指南](/tutorials/dsh-update-uninstall/)，Session 结构和数据边界见[DSH Session 使用与恢复指南](/tutorials/dsh-session-guide/)。

## 现在是否值得评估 alpha.3

| 条件 | 建议 |
|---|---|
| 当前环境正常，只使用 npm 默认通道 | 先保持现状，阅读变更，不因热点自动升级 |
| 明确受长会话、图片或 Host 停顿问题影响 | 记录可复现症状，在隔离 Profile 和可丢弃工作区评估 |
| 使用过 SQLite 权威 Session 持久化 | 暂停直接升级，先保全旧环境并完成可复核的数据处置 |
| 依赖第三方插件或内部扩展 | 逐项核对固定版本、权限和接口，不推断全目录兼容 |
| 无法确认当前持久化后端或版本 | 先调查配置与数据位置，不在不明状态下覆盖安装 |

评估前至少保留版本、配置、重要 Session、工作区 Diff 和回退方式。验证时先使用无敏感数据、可丢弃的工作区，分别检查启动、长会话定位、图片投递和连接；一次只验证一个变化。真实账号、生产数据迁移或第三方插件运行需要另行授权和风险控制。

## 常见问题

### alpha.3 已在 npm，为什么默认教程仍是 rc.2？

精确版本包与 `latest`、`next` 是不同通道。本次核对时两个默认标签仍是 `0.1.1-rc.2`，所以本站不会用预发布 Release 批量覆盖旧教程的适用版本。

### SQLite 被移除后，所有 Session 都没了吗？

不是。被移除的是可选的 SQLite 权威 Session 持久化后端；JSONL Session 持久化保留并成为唯一第一方实现。旧 SQLite 数据不会被 alpha.3 自动迁移，是否仍可读取取决于保留的旧版本环境和原数据。

### `/export` 能直接把旧 SQLite 数据迁移到 alpha.3 吗？

现有固定文档不足以支持这个结论。Web 下载与 `/export` 依赖 JSONL 原始产物，不能被本站写成旧 SQLite 通用迁移器。请先保留旧环境和数据，等待或采用有固定证据、适合自身部署的导出流程。

### 长会话和图片修复是否已经实测？

本站完成的是官方 Release、固定提交和实现说明审阅，没有运行 alpha.3 或真实图片、Session 迁移测试。需要评估时应在隔离环境自行验证，并保留脱敏证据。

上一版的 Node 24、连接入口与插件分组背景可查阅[alpha.2 历史更新说明](/tutorials/deepseek-harness-0-1-2-alpha-2/)；本文不覆盖它的历史发布日期或事实。刚接触项目、还需要区分 Harness 与 DeepSeek 模型时，先看[DeepSeek Harness 是什么](/tutorials/what-is-deepseek-harness/)。

## 原始来源

- https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.2-alpha.3
- https://github.com/deepseek-ai/deepseek-harness/commit/dd6322d604e00eec1ba5e0c8541159906a21094a
- https://github.com/deepseek-ai/deepseek-harness/compare/dsh-v0.1.2-alpha.2...dsh-v0.1.2-alpha.3
- https://registry.npmjs.org/-/package/@deepseek-ai%2Fdsh/dist-tags
- https://registry.npmjs.org/@deepseek-ai%2Fdsh/0.1.2-alpha.3
- https://github.com/deepseek-ai/deepseek-harness/blob/dd6322d604e00eec1ba5e0c8541159906a21094a/packages/session/session-turn-outline/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/dd6322d604e00eec1ba5e0c8541159906a21094a/.agents/notes/implemented/architecture/2026-08-31-viewport-activated-syntax-highlighting.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/dd6322d604e00eec1ba5e0c8541159906a21094a/.agents/notes/implemented/bug-fix/2026-08-27-steer-followup-image-delivery.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/dd6322d604e00eec1ba5e0c8541159906a21094a/.agents/notes/implemented/bug-fix/2026-08-28-read-image-extensionless-paths.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/dd6322d604e00eec1ba5e0c8541159906a21094a/packages/client/ui-input-trigger/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/dd6322d604e00eec1ba5e0c8541159906a21094a/packages/client/ui-schedule/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/dd6322d604e00eec1ba5e0c8541159906a21094a/.agents/notes/implemented/simplification/2026-08-30-jsonl-only-session-persistence.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/dd6322d604e00eec1ba5e0c8541159906a21094a/packages/session-query/session-log-export/README.zh.md