DeepSeek Harness 0.1.2-alpha.3：长会话、图片修复与 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 数据迁移。文中的“修复”是官方版本声明与固定实现事实，不代表本站完成了跨平台运行认证。

版本状态与默认安装通道

版本通道会继续变化，操作前应重新核对官方 Release ↗（外部链接，在新标签页打开）和 npm dist-tag。不要只看 GitHub 首页的最新标签，也不要把“精确包已发布”写成“所有用户已自动升级”。

哪些变化与你有关

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

alpha.3 的轮次导航不再只依赖浏览器已经加载的消息。Session 投影会提供整个日志的轮次轮廓；用户选择尚未加载的轮次时，客户端先继续加载历史分页，再滚动到目标位置。右侧固定间距的轮次轨道用于预览和跳转，当前轮次也会随滚动位置更新。长会话轮次导航官方说明 ↗（外部链接，在新标签页打开）

这解决的是“目标轮次不在当前分页里就无法直接定位”的问题，不应夸大成“任意长度会话都没有性能成本”。官方维护说明仍明确记录：完整轮廓数据会随 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 启动与连接排障。

斜杠命令菜单中，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 更新、回退与卸载指南，Session 结构和数据边界见DSH Session 使用与恢复指南。

现在是否值得评估 alpha.3

评估前至少保留版本、配置、重要 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 历史更新说明；本文不覆盖它的历史发布日期或事实。刚接触项目、还需要区分 Harness 与 DeepSeek 模型时，先看DeepSeek Harness 是什么。