3.0.1 · 个人知识库插件

2026-11-11 · 插件 3.0.1 / 客户端 2.0.1 · 自动更新事务恢复补丁

修复旧更新停留在 prepared、宿主后来已安装其他版本时，新更新永久受阻的问题。持有配置写锁后完整归档旧事务并取消旧准备，再准备本次更新；不回退当前安装、不删除候选与备份。旧确认请求失效。publishing、未知状态、已存在发布备份或活跃写入锁仍需恢复或等待。更新弹窗区分安装恢复与写入占用。

提供仅取消准备的 cancel-prepared 恢复入口及中英文步骤，先归档再取消，拒绝对安装中状态执行回滚。

已安装旧版仍使用旧更新器；若已被历史事务阻塞，须先按恢复说明安全结束“仅准备”的旧事务，不能指望尚未安装的新包修复旧更新器。本机该历史事务已备份取消。此后可按正常入口更新到 3.0.1。客户端 2.0.1 携带相同修复内核及配套插件。

验证包含真实 pnpm 的归档/重新准备/提交、旧确认拒绝、锁与发布保护，真实 Windows 服务停服交接、安装后重新连接，以及真实安装配置隔离副本的升级。中英文文档、产品清单与下载入口同步；不改变协议和存储代次，不重建知识库。客户端仍需空目录安装，安装器未签名。

---

2026-11-11 · Plugin 3.0.1 / client 2.0.1 · Update transaction recovery patch

Fixes abandoned prepared receipts blocking later updates after a separate Host installation. Under the profile writer lock, archive the complete old receipt and abort only its preparation before staging a new update. Preserve the installed version, candidates and backups, and reject stale confirmations. Publishing/unknown phases, publication backups and active writer locks still require recovery or waiting. Update dialogs distinguish recovery from writer contention.

Adds a preparation-only cancel-prepared recovery command and bilingual instructions. Archive before cancellation; never roll back a publishing transaction through this command.

An installed older version still runs its older updater. An already blocked installation needs one-time safe cancellation of the preparation-only receipt before the normal update to 3.0.1; the not-yet-installed patch cannot repair that updater in advance. This machine's historical receipt was backed up and cancelled. Client 2.0.1 includes the matching repaired backend and plugin.

Validation covers real pnpm archive/restage/commit, stale confirmation rejection, writer/publication guards, real Windows service drain and reconnection, and an isolated copy of the installed profile. Synchronizes bilingual records, product feeds and download links. No protocol/storage epoch change or library rebuild. The unsigned client installer still requires an empty destination.

2.0.1 · Windows 知识工作台

2026-11-11 · 插件 3.0.1 / 客户端 2.0.1 · 自动更新事务恢复补丁

修复旧更新停留在 prepared、宿主后来已安装其他版本时，新更新永久受阻的问题。持有配置写锁后完整归档旧事务并取消旧准备，再准备本次更新；不回退当前安装、不删除候选与备份。旧确认请求失效。publishing、未知状态、已存在发布备份或活跃写入锁仍需恢复或等待。更新弹窗区分安装恢复与写入占用。

提供仅取消准备的 cancel-prepared 恢复入口及中英文步骤，先归档再取消，拒绝对安装中状态执行回滚。

已安装旧版仍使用旧更新器；若已被历史事务阻塞，须先按恢复说明安全结束“仅准备”的旧事务，不能指望尚未安装的新包修复旧更新器。本机该历史事务已备份取消。此后可按正常入口更新到 3.0.1。客户端 2.0.1 携带相同修复内核及配套插件。

验证包含真实 pnpm 的归档/重新准备/提交、旧确认拒绝、锁与发布保护，真实 Windows 服务停服交接、安装后重新连接，以及真实安装配置隔离副本的升级。中英文文档、产品清单与下载入口同步；不改变协议和存储代次，不重建知识库。客户端仍需空目录安装，安装器未签名。

---

2026-11-11 · Plugin 3.0.1 / client 2.0.1 · Update transaction recovery patch

Fixes abandoned prepared receipts blocking later updates after a separate Host installation. Under the profile writer lock, archive the complete old receipt and abort only its preparation before staging a new update. Preserve the installed version, candidates and backups, and reject stale confirmations. Publishing/unknown phases, publication backups and active writer locks still require recovery or waiting. Update dialogs distinguish recovery from writer contention.

Adds a preparation-only cancel-prepared recovery command and bilingual instructions. Archive before cancellation; never roll back a publishing transaction through this command.

An installed older version still runs its older updater. An already blocked installation needs one-time safe cancellation of the preparation-only receipt before the normal update to 3.0.1; the not-yet-installed patch cannot repair that updater in advance. This machine's historical receipt was backed up and cancelled. Client 2.0.1 includes the matching repaired backend and plugin.

Validation covers real pnpm archive/restage/commit, stale confirmation rejection, writer/publication guards, real Windows service drain and reconnection, and an isolated copy of the installed profile. Synchronizes bilingual records, product feeds and download links. No protocol/storage epoch change or library rebuild. The unsigned client installer still requires an empty destination.

3.0.0 · 个人知识库插件

插件 3.0.0 / 客户端 2.0.0 · 大版本发布

汇总本轮发布审查、交叉审查和界面检查修复：插件与客户端可独立使用，也可连接同一知识库；兼容性仍依据共享协议、存储代次及能力协商，不因产品主版本变化强制重建或迁移。

• 首次建库、中断恢复、迁移、备份恢复、授权续期、并发入库和更新交接修复。
• 外部修改库内原件按受影响路径更新，连续保存可重试；启动读取合并、健康索引复用，权限变化及时隐藏旧内容。
• 管理界面共享控件样式、开关对齐、深浅主题、状态徽标、弹窗滚动和焦点可见性修复。
• 编译与打包指纹一致性检查，并按本次插件重新生成真实库引导所需配套身份，避免沿用旧版元数据。

现有资料保留原位，不因版本号升级自动迁移或全库重建。复制导入后只监视知识库内副本；修改外部源文件不会自动同步副本。客户端支持检查与校验下载，安装仍通过安装器完成。旧宿主安装能力限制及历史 2.4.6 恢复边界保持不变。

发布标签为 v3.0.0 与 client-v2.0.0，附件分别提供插件 TGZ、客户端 EXE 和产品清单。安装器未签名，要求空安装目录；发布不修改生产环境。验证范围与摘要见发布附件。

首次激活并发修复：新旧版本同时接入复用已验证的同库激活状态，避免重复迁移冲突。

---

Plugin 3.0.0 / Client 2.0.0 · Major release

Consolidates release, cross-round and visual review fixes. Both products work independently or share one library. Compatibility continues to use the shared protocol, storage generation and negotiated capabilities; changing the product major version does not force migration or rebuilding.

• Fixes first-run creation, interrupted initialization, migration, backup restoration, grant renewal, concurrent ingestion and update handoff.
• External edits within the library trigger scoped maintenance with retryable continuous saves. Startup reads coalesce, healthy indexes are reused, and permission changes hide stale content.
• Restores shared management control styling, aligned switches, light/dark themes, readable badges, modal scrolling and visible keyboard focus.
• Checks build/package fingerprints and regenerates real-library launcher pairing metadata for the exact companion plugin.

Existing originals stay in place. A version upgrade alone does not migrate or rebuild the entire library. Copy imports watch the library copy, not the external source. The client checks and verifies downloads; installation still uses the installer. Historical host installation constraints and the 2.4.6 recovery boundary remain unchanged.

Release tags are v3.0.0 and client-v2.0.0, with separate plugin TGZ, client EXE and product manifests. The installer is unsigned and requires an empty destination. Publication does not install into production. See release assets for checksums and validation scope.

Concurrent first activation now reuses the authenticated active library state across old and new clients, avoiding duplicate migration conflicts.

2.0.0 · Windows 知识工作台

插件 3.0.0 / 客户端 2.0.0 · 大版本发布

汇总本轮发布审查、交叉审查和界面检查修复：插件与客户端可独立使用，也可连接同一知识库；兼容性仍依据共享协议、存储代次及能力协商，不因产品主版本变化强制重建或迁移。

• 首次建库、中断恢复、迁移、备份恢复、授权续期、并发入库和更新交接修复。
• 外部修改库内原件按受影响路径更新，连续保存可重试；启动读取合并、健康索引复用，权限变化及时隐藏旧内容。
• 管理界面共享控件样式、开关对齐、深浅主题、状态徽标、弹窗滚动和焦点可见性修复。
• 编译与打包指纹一致性检查，并按本次插件重新生成真实库引导所需配套身份，避免沿用旧版元数据。

现有资料保留原位，不因版本号升级自动迁移或全库重建。复制导入后只监视知识库内副本；修改外部源文件不会自动同步副本。客户端支持检查与校验下载，安装仍通过安装器完成。旧宿主安装能力限制及历史 2.4.6 恢复边界保持不变。

发布标签为 v3.0.0 与 client-v2.0.0，附件分别提供插件 TGZ、客户端 EXE 和产品清单。安装器未签名，要求空安装目录；发布不修改生产环境。验证范围与摘要见发布附件。

---

Plugin 3.0.0 / Client 2.0.0 · Major release

Consolidates release, cross-round and visual review fixes. Both products work independently or share one library. Compatibility continues to use the shared protocol, storage generation and negotiated capabilities; changing the product major version does not force migration or rebuilding.

• Fixes first-run creation, interrupted initialization, migration, backup restoration, grant renewal, concurrent ingestion and update handoff.
• External edits within the library trigger scoped maintenance with retryable continuous saves. Startup reads coalesce, healthy indexes are reused, and permission changes hide stale content.
• Restores shared management control styling, aligned switches, light/dark themes, readable badges, modal scrolling and visible keyboard focus.
• Checks build/package fingerprints and regenerates real-library launcher pairing metadata for the exact companion plugin.

Existing originals stay in place. A version upgrade alone does not migrate or rebuild the entire library. Copy imports watch the library copy, not the external source. The client checks and verifies downloads; installation still uses the installer. Historical host installation constraints and the 2.4.6 recovery boundary remain unchanged.

Release tags are v3.0.0 and client-v2.0.0, with separate plugin TGZ, client EXE and product manifests. The installer is unsigned and requires an empty destination. Publication does not install into production. See release assets for checksums and validation scope.

2.5.12 · 个人知识库插件

插件 2.5.12 · 首次共库与整理流程刷新

Windows 首次从空目录建立共享库时默认启用原件索引。插件与客户端可以独立使用，也可以连接同一个库。插件首次绑定共享库后，需完全退出 DSH 并重新打开。已有嵌入式库仍通过显式迁移接入。

更新完成或服务重连后，流程页面自动刷新。启动收件箱整理前会读取当前流程修订号。同库配置发生变化时，只重试一次尚未执行的准备步骤。切换知识库时停止原库请求并提示。

插件 2.5.10 · 统一记忆接口

知识库工作台通过版本化接口读写 DSH 的全局记忆。原文维护的联动条目随知识库更新。正常连接时，记忆页收到变更才重新读取。DSH 宿主断开后切回本库记忆，恢复连接后再显示共享条目。

本版包含 2.5.9 的服务安全交接修复。建议搭配 DSH Memory 1.0.14。

插件 2.5.9 · 安全接管知识库服务

更新器等待知识库任务结束，继续使用已校验的安装包。旧服务正常退出后才切换插件，并在支持热重载的 DSH 中自动加载。新版宿主和服务都就绪后才确认完成。

插件 2.5.8 · 加快知识库重开

切回同一个知识库时直接显示已有视图。文件变化或手动刷新时更新，权限变化时清除旧缓存。

插件 2.5.7 · 修复 ASAR 索引误报

知识库服务按磁盘上的真实文件扫描，整份 ASAR 安装包作为一个原件登记。包内虚拟文件不再触发「文件在读取期间发生变化」，索引维护可正常完成。此版仅更新 DSH 插件，客户端版本仍为 1.1.2。

插件 2.5.6 · 历史会话记忆联动

知识库桥接按历史会话已保存的归属读取联动记忆。副库断开时返回明确状态。配合 DSH Memory 1.0.12 使用。桌面客户端继续使用 1.1.2。

插件 2.5.5 / 客户端 1.1.2：共库兼容与手动更新（2026-11-07）

修复打开客户端时因插件构建指纹不同而提示“其他版本在线”的问题。构建指纹保留用于诊断；共享服务改为核对协议主版本、完整接口契约指纹、存储和引擎兼容代次及调用方必需能力。已核验的公开插件 2.5.3 / 2.5.4 服务可被新版客户端复用，不要求关闭正在运行的 DSH，不启动第二个写入者。未知旧构建、缺少能力或确实不兼容的服务仍保留安全交接限制。未来不兼容的存储或引擎语义变更必须提升兼容代次，不能只沿用原标记。

客户端“帮助 → 更新与手动安装”增加“手动更新 · 下载并校验”“启动已校验的安装程序”及官方下载页入口。允许复用已校验缓存，启动前再次核对大小与 SHA-256；不接受界面传入任意程序路径。保存并关闭客户端后按安装器提示完成安装，自动原位覆盖安装仍未实现。原有自动检查和校验下载保留。

30 项定向检查通过，包含真实 Windows 共享服务、原旧连接反例、不同构建双向接入、一个写入者、原件字节保持、安全停服恢复和手动更新包损坏拒绝。发布包另核对源码、分片和客户端内嵌插件摘要。测试使用虚构库；真实用户库仅通过既有授权服务核对连接状态，不读取正文，不执行知识库迁移或收费模型调用。实际安装与界面加载结果另记。

插件 2.5.4：更新下载与失败提示修复（2026-11-07）

修复版本清单可读、安装包却下载失败的问题。Gitee 大二进制 raw 地址可能拒绝访问，GitCode 同步可能滞后，GitHub raw 在部分网络下不可达。现在支持国内镜像的小文本分片下载，按发布摘要定位固定分片路径，最多三个并发，组装后执行完整的大小、SHA-256 和插件格式校验；另增加固定的 GitHub Pages 和 Release 下载备用入口，不接受清单提供的任意地址。

大文件改用传输空闲超时，持续收到数据时不再被原有 20 秒总超时中断，同时保留五分钟总时限。关闭失败提示后，同一次失败的关闭状态在界面切换、组件重挂载与本次页面会话内保留；手动重试产生的新失败仍可提示。

36 项定向测试通过，覆盖分片重组、摘要损坏、编码与恶意跳转拒绝、并发上限、慢速持续传输及关闭状态恢复。样例使用正式发布包和虚构状态，不连接真实知识库或付费模型。客户端独立版本仍为 1.1.1，本次只发布插件；程序更新不执行知识库迁移。旧版更新器无法识别分片，遇到同样问题可使用已校验的本地 TGZ 安装；本机已准备对应更新缓存。

插件 2.5.3 / 客户端 1.1.1（2026-11-07）

本次统一发布此前本地交付的原件索引架构及后续修正，两端继续使用同一共享内核与服务，独立安装、独立版本。

• 原件保持原位；索引层记录身份、路径、分类、标签与指纹。插件和客户端提供迁移预览与确认入口，程序更新不会自动迁移资料库。
• 客户端增加原件分类文件树及分类操作，分类与隐私筛选由共享服务执行；既有文件、绑定及资料库身份保留。
• 流程卡保存模型与推理配置，运行使用已保存配置；内置收件箱仍要求 High。自定义流程准备不再误入内置收件箱校验。
• 任务计划面板修正宽度和向上展开方向；长工具执行期间提示模型核对进度，由模型依据实际结果更新状态。
• 成品登记说明明确支持复用系列目录：task 填系列目录名，title 填单期标题，path 填库内相对路径。无需按日期拆目录，路径与隐私校验继续生效。

本次验证使用虚构库与针对性检查，发布包核对源码、构建指纹和摘要；不读取真实私有库，不调用收费模型。历史验收记录保留其当时范围；本次打包不代表正式用户安装、DSH 重启激活、真实报告生成或外部发送已经验证。客户端自动覆盖安装与激活尚未接入。

安装：插件使用 v2.5.3 Release 中的 TGZ；客户端使用 client-v1.1.1 Release 中的 Windows x64 Setup.exe（未签名），分别核对清单与 SHA-256。客户端安装目录需为空，先保存工作并退出旧客户端；DSH 插件按宿主提示重新加载或完全退出含托盘后重开，核对版本和构建号。旧 2.4.6 更新受阻时仍使用既有恢复入口。

2.5.x：任务计划面板宽度修复（源码补丁，未发布，2026-11-06）

任务计划面板沿用官方 composer 的宽度与居中公式，补齐 border-box 和 CSS 变量兜底；变量缺失时卡片上限取 952px，面板上限取 920px，极窄容器下计算宽度不小于零。保留原有边框、圆角、字号、默认收起、状态映射及隐藏官方面板的规则。未根据未经测量的状态滞后报告修改状态源、文案或 Host 收尾核对机制。

独立源码修改后运行 python -X utf8 tools/sync-todo-lifecycle-client.py 同步 index.js 的标记区块，再运行 node --test tests/todo-lifecycle.test.mjs。本次未变更 package.json 版本、未生成安装包或修改发布清单；发布时仍须按 VERSIONING.md 选择新版本，并通过既有打包流程重新计算构建指纹与摘要。测量范围和缺口见 面板验收记录。

2.5.0：原件索引架构（本地交付，2026-11-06）

插件与客户端新增同名“迁移到索引架构”入口，共用预览、确认、文件目录和分类。原件保持原位；索引层登记文件身份、位置、分类和指纹，不保存分类正文副本。迁移后全文索引写入索引层，原地接入和收件箱分类直接登记原件。

识别旧机器引用并在检索中去重，保留用户独立笔记。文件修改、可核验改名及缺失由维护更新；预览后文件变化、原件缺失或链接路径会阻止发布。已有规则、模板和目录保留，原目录补齐功能标为可选。既有库身份和授权事务元数据继续使用 .kbmeta，不执行全量元数据搬迁。

隔离检查覆盖迁移保护、原件检索、分类、文件变化、索引失败待完成及 Windows 两端独立/共享访问；Electron 中验证设置入口、预览确认、启用状态与保存分类。未对真实私有库执行迁移，未验证真实模型或所有二进制正文解析。详见 原件索引架构。本次为本地交付，尚未发布到远程更新源。

2.4.14：旧库框架迁移（2026-11-05）

新增“版本与诊断 → 旧库框架迁移”：先只读预览，再确认补齐缺失的标准目录、条目模板和框架管理说明。已有资料位置、自定义目录、AGENTS 正文、人工 INDEX 和不同内容的模板保留；可查看新版参考。迁移不自动搬移资料、重写笔记或调用模型。

预览绑定知识库身份与文件快照；状态改变、同名类型冲突或链接路径时停止。写入失败只撤销可核对的本次新增文件和空目录；用户后续修改保留并提示恢复。共享服务校验管理授权，机制版本改为实际核心版本。

7 项迁移/界面定向检查和 2 项既有托管升级检查通过，包含真实 Windows 共享服务与 EPERM 恢复。发布包完整性与升级加载另做必要检查。未对真实用户库执行迁移，未验证完整 Electron 界面或模型调用。程序更新与旧库框架迁移分别执行，旧更新器受阻限制继续适用。

2.4.6 升级范围补充（2026-11-05）

原版 2.4.6 的旧回执确认会在下载新包前阻断更新，旧准备器还可能重新解析其他宿主依赖。仅发布 2.4.13 或过渡包不能修复已经运行的旧代码；本机经过单次兼容恢复后成功，不代表其他原版用户均能零操作升级。

现提供独立的 2.4.6 通用升级恢复入口，校验公开原包后事务安装未改动的正式 2.4.13，支持自动发现单一 profile 或明确选择其他 profile。它是一次性外部恢复，不是静默自动升级。4 项 Windows 入口/真实 pnpm 检查和 2 项旧客户端边界检查通过，覆盖其他依赖保持、提交 EPERM 回滚、忙碌拒绝、多 profile 选择和独立 Python。历史安全事务不匹配仍可能阻止后续安装，不能宣称通用零操作自动迁移已经完成；这需要 DSH 宿主独立恢复通道。

2.4.13：更新不再重解析宿主依赖（2026-11-05）

安全更新只在独立解析目录中解析无依赖的知识库包，将其 importer、package、snapshot 三组记录合并到原 pnpm v9 锁文件。其他插件的来源、锁定版本及记录逐字节保留，不再向注册源查找宿主内置包，也不复制或重装其他插件。未知锁格式、歧义或跨包引用失败时保留旧安装。

19 项更新状态检查、8 项真实 pnpm／事务检查通过；另用本机清单的隔离副本验证仅解析知识库包能完成准备，原 profile 清单与锁未改动。保留回滚与崩溃恢复；真实设备安装及加载结果另记，不由准备成功推断。

2.4.12：本地依赖与自动更新准备（2026-11-05）

保留 2.4.11 的共享状态构建字段与旧接口确认修复。进一步修复更新准备阶段拒绝 profile 内相对路径本地插件的问题：将这些依赖复制到隔离的影子目录，使 pnpm 只处理影子清单；保持真实 profile 中其他插件的来源字符串及文件不变。拒绝越界、链接、元数据冲突和超过 64 MiB 的相对依赖，不复制运行知识库或凭据。

19 项状态确认检查、7 项真实 pnpm 与事务检查通过，覆盖本地依赖保留、越界拒绝、发布失败回滚和进程崩溃恢复。实际设备自动升级另行记录；下载成功、合成检查或磁盘包版本均不单独代表正在运行的新构建已经生效。

2.4.11：共享状态构建与自动更新确认（2026-11-05）

修复共享模式 POST status 缺少 build，而更新确认必须校验版本与构建号的问题。旧安装即使已经加载，也可能永久停在待确认。现在共享状态统一携带 Host 构建；客户端兼容从旧版 GET 状态读取构建，仍要求精确匹配，不按版本号单独确认。

19 项定向检查通过，新增原共享状态缺字段反例和旧接口兼容确认；保留安装锁、已准备事务续装及失败恢复限制。针对已被旧代码锁住的客户端，需要一次受控的兼容恢复才能重新进入自动流程；发布更新源本身不能修改正在运行的旧代码。恢复必须先验证旧请求与已安装构建，不得无条件清空客户端状态。真实用户升级结果单独记录，不把这些合成检查当作实机安装证明。

2.4.10：安装待确认状态恢复（2026-11-05）

修复核对不到旧安装回执时，界面永久停在待确认、安装按钮保持禁用的问题。核对流程增加磁盘安装构建、当前安全安装操作和 profile 写锁信息；只有宿主明确没有旧请求、安装操作及写锁均不活跃且当前安装可校验时，才解除旧请求。单纯等待时间变长或接口失败不能触发解除。

已准备但尚未开始的安全事务可继续原事务，不创建第二次准备或重复安装。目标文件已经写入而宿主仍运行旧构建时，显示保存工作并重启；正在安装、无法校验或损坏状态继续拒绝盲目重试。

17 项定向检查通过，覆盖失效旧请求、写锁与活动操作、缺失事务文件、已安装未加载、原事务续装及既有完成状态。没有对正式用户实例执行安装、删除客户端缓存或强制重启。

若旧版界面已经被待确认状态锁住，新修复尚无法加载：在 DSH 自身“设置 → 插件”中使用本版正式安装源更新一次，按宿主提示重新加载；不要在知识库的灰色按钮上反复尝试。详见升级恢复说明。

2.4.9：kb_flow 返回契约（2026-11-05）

修复共享模式 kb_flow 的返回结果缺少 action，导致宿主报 value.action 字段缺失的问题。共享服务与 Host 工具边界都按原请求补全动作；业务失败、断线与调用方校验失败也保留 action、原错误和成功状态，不放宽原输出校验，不把失败伪装成成功，不重放调用。

3 项定向测试通过，覆盖全部 8 种动作、实际注册的 Host 工具成功及失败返回，以及隔离真实 Windows 共享服务读取与业务失败。仅使用合成数据，没有重放正式用户流程。

另定位到记忆插件 1.0.4 在工具续步中仅从新输入查用户消息，可能以空快照替换已召回约定；该组件的 1.0.5 本地修复另行交付，不包含在此知识库包内，未公开发布或自动安装。合成课堂录音约定验证了持久保存、召回及解析完成后的上下文续接，未证明正式录音已自动生成笔记。

2.4.8：设置页的解析调用记录（2026-11-05）

修复共享服务把管理界面的只读请求当作普通会话的问题。设置页依据已认证连接的管理权限读取 OCR / ASR 执行任务和提交记录，不再按固定界面会话误过滤 Agent 发起的任务；资料可见性筛选仍然生效。普通模型工具和只读连接不因此获得跨会话管理权限，写接口仍要求管理授权。

3 项定向测试通过：在隔离的真实 Windows 共享服务中，由独立 Agent 会话调用本地合成 OCR / ASR 接口，设置页两种读取入口均能看到执行中、提交及完成后的记录；普通会话、只读连接与伪造参数不能越权。反例在修复前复现为空列表，修复后通过。样本和接口为合成数据，未读取正式知识库、调用外部付费服务或验证正式用户完整界面。

2.4.7：升级交接等待提示（2026-11-05）

交接期间保留稳定的知识库 API 入口，明确返回服务准备状态；界面显示“知识库服务准备中，请稍候…”，接口就绪后继续读取。只对服务明确确认尚未执行的请求等待后重新提交；真实 HTTP 405、断线及未知写入结果不自动重放。准备失败或等待超时仍提供错误与恢复说明，不把它们伪装为就绪。

19 项定向检查通过，包含真实本地 HTTP 路由准备、恢复后的写请求仅执行一次、失败与超时边界、旧服务交接和服务恢复。未额外重复完整功能回归；未对正式用户实例操作或声称完整界面实测。

2.4.6：2.4.3 直接自动升级与恢复（2026-11-05）

沿用本次验证的 2.4.3 直接安装、自然退出交接、条件错误提示和固定旧包恢复。补充 Windows 内置管理员 SID 别名的规范化校验，权限仍要求同一组明确的主体与授权。2.4.5 候选未通过发布环境校验，未创建正式 Release；保留其包字节，后续以 2.4.6 为自动更新目标。

Direct 2.4.3 upgrades, natural idle handoff, conditional recovery help and pinned legacy repair are retained. Windows SID aliases are normalized before exact ACL comparison. The unpublished 2.4.5 candidate is preserved; 2.4.6 is the follow-up distribution.

升级错误恢复说明 / Recovery instructions

升级报错后的手动恢复说明 / Upgrade error recovery

2.4.5：2.4.3 直接自动升级与旧服务交接（2026-11-05）

• 恢复正式自动更新入口，正常 2.4.3 可直接安装本版，不要求先手动安装过渡版本。
• 新版通过已发布 2.4.3 的精确运行时指纹识别旧服务；释放探测连接后等待旧服务按原有空闲机制自然退出，核对原进程出生标识和清理回执，再启动新服务。不向缺少停服协议的旧服务发送 shutdown，不终止其他连接或任务；超时显示恢复说明。
• 新版运行中的安装、事务恢复或交接确实报错时，才显示手动更新与恢复说明。2.4.3 若在首次 pnpm 安装阶段就失败，新代码尚未加载，仍使用旧版原错误界面；现有更新说明入口提供同一恢复文档，不能承诺旧界面具有新版弹窗。
• 手动恢复包可从固定摘要的公开 2.4.3 包重建受损代码目录，保留残留目录和原 profile 清单，再使用事务安装器升级；不清空知识库或解析记录。

验证使用真实公开 2.4.3 TGZ、Windows 上的运行服务与真实 pnpm，覆盖直接安装、自然退出后交接、原件保留及受损旧安装恢复；事务失败回退沿用并补验现有检查。验证范围不包含正式用户 profile 安装或完整 Electron 界面操作。旧 2.4.3 首次安装仍由宿主旧安装器执行，不能获得新版事务器在安装前的保护；异常时走恢复入口。旧更新源不能按客户端运行状态筛选，2.4.3 以外的旧版不属于本次定向保证。

2.4.4：Windows 安全更新与失败恢复（2026-11-05）

• pnpm 只在隔离的清单副本中准备锁文件；新包先完成摘要、构建号、路径和文件校验，不让包管理器改写在线插件目录。
• 更新前通过管理员授权的停服协议检查其他连接、排队及运行中的解析、导入和流程任务；忙碌时延后。停服后核对清理回执及进程退出，再切换完整包目录。
• 原插件目录和清单保留在私有事务目录；切换或清单写入失败时回退并逐文件校验。中途退出的安装可从持久事务记录恢复，不把未知结果标为成功，不重复发起安装。
• 2.4.4 使用 release-manifest-v2.json。旧 release-manifest.json 停用安装分发，阻断旧更新器继续走不安全的原地安装。2.4.3 及更早版本首次过渡须退出宿主及连接客户端，使用本版过渡安装包；旧服务不支持停服协议时自动路径会拒绝接管。
• 成功安装后明确提示重启生效。嵌入模式或缺少安全停服能力时保持旧版，暂不自动安装。包带额外依赖、相对本地依赖或旧包已不完整等不支持的情况均停止，不擅自重建用户配置。

验证：35 项 Node 定向检查、5 项真实文件系统/真实 pnpm 事务测试，以及 1 个 Windows 运行服务升级复合场景通过。复合场景包括原始 2.4.3 服务的拒绝接管、额外连接和排队任务的延后、使用旧目录 Python 的协议服务退出、真实 2.4.3 包切换失败后逐文件恢复、成功升级重启和虚构原件保留。具备新停服协议的服务升级与未修改旧服务的首次过渡是两条不同路径。本次未在正式用户 profile 安装，也未验证真实模型或完整 UI。

2.4.3：原件同步与 Windows 解析任务修复（2026-11-05）

• 合入文本原件与引用同步：归档文本参与检索，原件编辑后更新索引与引用范围；旧的自动生成镜像引用当前原件，独立撰写的摘要仍保留。
• 调整索引排除与恢复时的关联原件、派生记录及增量向量复用；修复含中文路径及版本化 Python 路径的 PDF 渲染。
• Windows 解析任务记录的读取和原子替换共用进程级队列，减少句柄重叠；外部占用有限重试，耗尽时保留旧记录并清理临时文件。
• 提交、重试和启动恢复的后台错误均被捕获；尽力保存失败状态，无法保存时明确报告，清理心跳和运行标记。

Windows 定向复验 73/73 通过（原有 68 项及新增 5 项故障测试）。测试使用虚构资料和请求替身，不证明真实 OCR/ASR 效果、自动 PDF/Office 索引同步、原生位置映射或完整桌面运行兼容性。客户端独立发布版本仍为 1.0.3，本次不重新发布客户端安装器。

历史记录 / Earlier releases

统一仓库源码 · 2026-11-04

2026-11-04 合仓时源码版本：客户端 1.0.1 / 插件 2.4.1。整合桌面工作区、共享内核与服务、可选记忆联动适配及现有安装器。两端后续统一维护于本仓库。该次文档更新未发布二进制 Release，当时公开插件清单为 2.3.1。后续历史条目除另有说明外均为插件记录。客户端版本说明。

2.3.1：收件箱提示词与任务状态修复（2026-11-03）

• 收件箱整理只发送“帮我整理并归档收件箱内文件”，不再附加流程及目录说明。
• OCR/ASR 任务记录使用静默后台刷新，合并同时发生的刷新请求，保留列表位置及详情展开状态。
• 知识库会话的命令工具漏传显示说明时补全说明；保留原有参数校验、工具可见范围及权限拒绝。
• 会话计划增加逐步更新规则及每轮一次的结束前核对。会话停止后旧的进行中步骤显示为未确认完成，完成数仍以实际待办记录为准。

验证包括定向自动检查、已安装 DSH 工具调度器的合成执行，以及 Edge 中的任务刷新和待办状态场景。权限拒绝及工具限制仍生效。正式桌面安装、真实模型对整项任务的完成质量及真实云端 OCR/ASR 未验证；会话结束不会自动把待办改为成功。

2.3.0 同版本修复：收件箱迁移与一键整理（2026-10-31）

简体中文 · English

• 桌面收件箱直接扫描当前知识库的 90-收件箱/。拖入或选择文件后迁移原件到该目录，不再通过快速收集的 Base64 上传接口，也不再受其 8 MiB 限制或依赖收集记录。同名文件追加编号；跨盘先复制并校验，再移除源文件；失败时保留源文件。手机快速收集页仍沿用上传限制。
• 修复“一键整理”选模时的 remote.session 依赖注入错误，检查模型选择返回结果，失败时不发送任务。错误提示区分“任务尚未发送”和“发送结果未确认”，不自动重试。
• 一键整理只发送“整理并归档收件箱内的文件。”；执行规则由知识库 Agent 与插件提供。用户所选模型与 High 推理强度继续生效。

版本号保持 2.3.0，本次更新仓库源码和配套安装包，不移动已有 v2.3.0 标签或替换其 Release ...

2.5.10 · 个人知识库插件

插件 2.5.10 · 统一记忆接口

知识库工作台通过版本化接口读写 DSH 的全局记忆。原文维护的联动条目随知识库更新。正常连接时，记忆页收到变更才重新读取。DSH 宿主断开后切回本库记忆，恢复连接后再显示共享条目。

本版包含 2.5.9 的服务安全交接修复。建议搭配 DSH Memory 1.0.14。

插件 2.5.9 · 安全接管知识库服务

更新器等待知识库任务结束，继续使用已校验的安装包。旧服务正常退出后才切换插件，并在支持热重载的 DSH 中自动加载。新版宿主和服务都就绪后才确认完成。

插件 2.5.8 · 加快知识库重开

切回同一个知识库时直接显示已有视图。文件变化或手动刷新时更新，权限变化时清除旧缓存。

插件 2.5.7 · 修复 ASAR 索引误报

知识库服务按磁盘上的真实文件扫描，整份 ASAR 安装包作为一个原件登记。包内虚拟文件不再触发「文件在读取期间发生变化」，索引维护可正常完成。此版仅更新 DSH 插件，客户端版本仍为 1.1.2。

插件 2.5.6 · 历史会话记忆联动

知识库桥接按历史会话已保存的归属读取联动记忆。副库断开时返回明确状态。配合 DSH Memory 1.0.12 使用。桌面客户端继续使用 1.1.2。

插件 2.5.5 / 客户端 1.1.2：共库兼容与手动更新（2026-11-07）

修复打开客户端时因插件构建指纹不同而提示“其他版本在线”的问题。构建指纹保留用于诊断；共享服务改为核对协议主版本、完整接口契约指纹、存储和引擎兼容代次及调用方必需能力。已核验的公开插件 2.5.3 / 2.5.4 服务可被新版客户端复用，不要求关闭正在运行的 DSH，不启动第二个写入者。未知旧构建、缺少能力或确实不兼容的服务仍保留安全交接限制。未来不兼容的存储或引擎语义变更必须提升兼容代次，不能只沿用原标记。

客户端“帮助 → 更新与手动安装”增加“手动更新 · 下载并校验”“启动已校验的安装程序”及官方下载页入口。允许复用已校验缓存，启动前再次核对大小与 SHA-256；不接受界面传入任意程序路径。保存并关闭客户端后按安装器提示完成安装，自动原位覆盖安装仍未实现。原有自动检查和校验下载保留。

30 项定向检查通过，包含真实 Windows 共享服务、原旧连接反例、不同构建双向接入、一个写入者、原件字节保持、安全停服恢复和手动更新包损坏拒绝。发布包另核对源码、分片和客户端内嵌插件摘要。测试使用虚构库；真实用户库仅通过既有授权服务核对连接状态，不读取正文，不执行知识库迁移或收费模型调用。实际安装与界面加载结果另记。

插件 2.5.4：更新下载与失败提示修复（2026-11-07）

修复版本清单可读、安装包却下载失败的问题。Gitee 大二进制 raw 地址可能拒绝访问，GitCode 同步可能滞后，GitHub raw 在部分网络下不可达。现在支持国内镜像的小文本分片下载，按发布摘要定位固定分片路径，最多三个并发，组装后执行完整的大小、SHA-256 和插件格式校验；另增加固定的 GitHub Pages 和 Release 下载备用入口，不接受清单提供的任意地址。

大文件改用传输空闲超时，持续收到数据时不再被原有 20 秒总超时中断，同时保留五分钟总时限。关闭失败提示后，同一次失败的关闭状态在界面切换、组件重挂载与本次页面会话内保留；手动重试产生的新失败仍可提示。

36 项定向测试通过，覆盖分片重组、摘要损坏、编码与恶意跳转拒绝、并发上限、慢速持续传输及关闭状态恢复。样例使用正式发布包和虚构状态，不连接真实知识库或付费模型。客户端独立版本仍为 1.1.1，本次只发布插件；程序更新不执行知识库迁移。旧版更新器无法识别分片，遇到同样问题可使用已校验的本地 TGZ 安装；本机已准备对应更新缓存。

插件 2.5.3 / 客户端 1.1.1（2026-11-07）

本次统一发布此前本地交付的原件索引架构及后续修正，两端继续使用同一共享内核与服务，独立安装、独立版本。

• 原件保持原位；索引层记录身份、路径、分类、标签与指纹。插件和客户端提供迁移预览与确认入口，程序更新不会自动迁移资料库。
• 客户端增加原件分类文件树及分类操作，分类与隐私筛选由共享服务执行；既有文件、绑定及资料库身份保留。
• 流程卡保存模型与推理配置，运行使用已保存配置；内置收件箱仍要求 High。自定义流程准备不再误入内置收件箱校验。
• 任务计划面板修正宽度和向上展开方向；长工具执行期间提示模型核对进度，由模型依据实际结果更新状态。
• 成品登记说明明确支持复用系列目录：task 填系列目录名，title 填单期标题，path 填库内相对路径。无需按日期拆目录，路径与隐私校验继续生效。

本次验证使用虚构库与针对性检查，发布包核对源码、构建指纹和摘要；不读取真实私有库，不调用收费模型。历史验收记录保留其当时范围；本次打包不代表正式用户安装、DSH 重启激活、真实报告生成或外部发送已经验证。客户端自动覆盖安装与激活尚未接入。

安装：插件使用 v2.5.3 Release 中的 TGZ；客户端使用 client-v1.1.1 Release 中的 Windows x64 Setup.exe（未签名），分别核对清单与 SHA-256。客户端安装目录需为空，先保存工作并退出旧客户端；DSH 插件按宿主提示重新加载或完全退出含托盘后重开，核对版本和构建号。旧 2.4.6 更新受阻时仍使用既有恢复入口。

2.5.x：任务计划面板宽度修复（源码补丁，未发布，2026-11-06）

任务计划面板沿用官方 composer 的宽度与居中公式，补齐 border-box 和 CSS 变量兜底；变量缺失时卡片上限取 952px，面板上限取 920px，极窄容器下计算宽度不小于零。保留原有边框、圆角、字号、默认收起、状态映射及隐藏官方面板的规则。未根据未经测量的状态滞后报告修改状态源、文案或 Host 收尾核对机制。

独立源码修改后运行 python -X utf8 tools/sync-todo-lifecycle-client.py 同步 index.js 的标记区块，再运行 node --test tests/todo-lifecycle.test.mjs。本次未变更 package.json 版本、未生成安装包或修改发布清单；发布时仍须按 VERSIONING.md 选择新版本，并通过既有打包流程重新计算构建指纹与摘要。测量范围和缺口见 面板验收记录。

2.5.0：原件索引架构（本地交付，2026-11-06）

插件与客户端新增同名“迁移到索引架构”入口，共用预览、确认、文件目录和分类。原件保持原位；索引层登记文件身份、位置、分类和指纹，不保存分类正文副本。迁移后全文索引写入索引层，原地接入和收件箱分类直接登记原件。

识别旧机器引用并在检索中去重，保留用户独立笔记。文件修改、可核验改名及缺失由维护更新；预览后文件变化、原件缺失或链接路径会阻止发布。已有规则、模板和目录保留，原目录补齐功能标为可选。既有库身份和授权事务元数据继续使用 .kbmeta，不执行全量元数据搬迁。

隔离检查覆盖迁移保护、原件检索、分类、文件变化、索引失败待完成及 Windows 两端独立/共享访问；Electron 中验证设置入口、预览确认、启用状态与保存分类。未对真实私有库执行迁移，未验证真实模型或所有二进制正文解析。详见 原件索引架构。本次为本地交付，尚未发布到远程更新源。

2.4.14：旧库框架迁移（2026-11-05）

新增“版本与诊断 → 旧库框架迁移”：先只读预览，再确认补齐缺失的标准目录、条目模板和框架管理说明。已有资料位置、自定义目录、AGENTS 正文、人工 INDEX 和不同内容的模板保留；可查看新版参考。迁移不自动搬移资料、重写笔记或调用模型。

预览绑定知识库身份与文件快照；状态改变、同名类型冲突或链接路径时停止。写入失败只撤销可核对的本次新增文件和空目录；用户后续修改保留并提示恢复。共享服务校验管理授权，机制版本改为实际核心版本。

7 项迁移/界面定向检查和 2 项既有托管升级检查通过，包含真实 Windows 共享服务与 EPERM 恢复。发布包完整性与升级加载另做必要检查。未对真实用户库执行迁移，未验证完整 Electron 界面或模型调用。程序更新与旧库框架迁移分别执行，旧更新器受阻限制继续适用。

2.4.6 升级范围补充（2026-11-05）

原版 2.4.6 的旧回执确认会在下载新包前阻断更新，旧准备器还可能重新解析其他宿主依赖。仅发布 2.4.13 或过渡包不能修复已经运行的旧代码；本机经过单次兼容恢复后成功，不代表其他原版用户均能零操作升级。

现提供独立的 2.4.6 通用升级恢复入口，校验公开原包后事务安装未改动的正式 2.4.13，支持自动发现单一 profile 或明确选择其他 profile。它是一次性外部恢复，不是静默自动升级。4 项 Windows 入口/真实 pnpm 检查和 2 项旧客户端边界检查通过，覆盖其他依赖保持、提交 EPERM 回滚、忙碌拒绝、多 profile 选择和独立 Python。历史安全事务不匹配仍可能阻止后续安装，不能宣称通用零操作自动迁移已经完成；这需要 DSH 宿主独立恢复通道。

2.4.13：更新不再重解析宿主依赖（2026-11-05）

安全更新只在独立解析目录中解析无依赖的知识库包，将其 importer、package、snapshot 三组记录合并到原 pnpm v9 锁文件。其他插件的来源、锁定版本及记录逐字节保留，不再向注册源查找宿主内置包，也不复制或重装其他插件。未知锁格式、歧义或跨包引用失败时保留旧安装。

19 项更新状态检查、8 项真实 pnpm／事务检查通过；另用本机清单的隔离副本验证仅解析知识库包能完成准备，原 profile 清单与锁未改动。保留回滚与崩溃恢复；真实设备安装及加载结果另记，不由准备成功推断。

2.4.12：本地依赖与自动更新准备（2026-11-05）

保留 2.4.11 的共享状态构建字段与旧接口确认修复。进一步修复更新准备阶段拒绝 profile 内相对路径本地插件的问题：将这些依赖复制到隔离的影子目录，使 pnpm 只处理影子清单；保持真实 profile 中其他插件的来源字符串及文件不变。拒绝越界、链接、元数据冲突和超过 64 MiB 的相对依赖，不复制运行知识库或凭据。

19 项状态确认检查、7 项真实 pnpm 与事务检查通过，覆盖本地依赖保留、越界拒绝、发布失败回滚和进程崩溃恢复。实际设备自动升级另行记录；下载成功、合成检查或磁盘包版本均不单独代表正在运行的新构建已经生效。

2.4.11：共享状态构建与自动更新确认（2026-11-05）

修复共享模式 POST status 缺少 build，而更新确认必须校验版本与构建号的问题。旧安装即使已经加载，也可能永久停在待确认。现在共享状态统一携带 Host 构建；客户端兼容从旧版 GET 状态读取构建，仍要求精确匹配，不按版本号单独确认。

19 项定向检查通过，新增原共享状态缺字段反例和旧接口兼容确认；保留安装锁、已准备事务续装及失败恢复限制。针对已被旧代码锁住的客户端，需要一次受控的兼容恢复才能重新进入自动流程；发布更新源本身不能修改正在运行的旧代码。恢复必须先验证旧请求与已安装构建，不得无条件清空客户端状态。真实用户升级结果单独记录，不把这些合成检查当作实机安装证明。

2.4.10：安装待确认状态恢复（2026-11-05）

修复核对不到旧安装回执时，界面永久停在待确认、安装按钮保持禁用的问题。核对流程增加磁盘安装构建、当前安全安装操作和 profile 写锁信息；只有宿主明确没有旧请求、安装操作及写锁均不活跃且当前安装可校验时，才解除旧请求。单纯等待时间变长或接口失败不能触发解除。

已准备但尚未开始的安全事务可继续原事务，不创建第二次准备或重复安装。目标文件已经写入而宿主仍运行旧构建时，显示保存工作并重启；正在安装、无法校验或损坏状态继续拒绝盲目重试。

17 项定向检查通过，覆盖失效旧请求、写锁与活动操作、缺失事务文件、已安装未加载、原事务续装及既有完成状态。没有对正式用户实例执行安装、删除客户端缓存或强制重启。

若旧版界面已经被待确认状态锁住，新修复尚无法加载：在 DSH 自身“设置 → 插件”中使用本版正式安装源更新一次，按宿主提示重新加载；不要在知识库的灰色按钮上反复尝试。详见升级恢复说明。

2.4.9：kb_flow 返回契约（2026-11-05）

修复共享模式 kb_flow 的返回结果缺少 action，导致宿主报 value.action 字段缺失的问题。共享服务与 Host 工具边界都按原请求补全动作；业务失败、断线与调用方校验失败也保留 action、原错误和成功状态，不放宽原输出校验，不把失败伪装成成功，不重放调用。

3 项定向测试通过，覆盖全部 8 种动作、实际注册的 Host 工具成功及失败返回，以及隔离真实 Windows 共享服务读取与业务失败。仅使用合成数据，没有重放正式用户流程。

另定位到记忆插件 1.0.4 在工具续步中仅从新输入查用户消息，可能以空快照替换已召回约定；该组件的 1.0.5 本地修复另行交付，不包含在此知识库包内，未公开发布或自动安装。合成课堂录音约定验证了持久保存、召回及解析完成后的上下文续接，未证明正式录音已自动生成笔记。

2.4.8：设置页的解析调用记录（2026-11-05）

修复共享服务把管理界面的只读请求当作普通会话的问题。设置页依据已认证连接的管理权限读取 OCR / ASR 执行任务和提交记录，不再按固定界面会话误过滤 Agent 发起的任务；资料可见性筛选仍然生效。普通模型工具和只读连接不因此获得跨会话管理权限，写接口仍要求管理授权。

3 项定向测试通过：在隔离的真实 Windows 共享服务中，由独立 Agent 会话调用本地合成 OCR / ASR 接口，设置页两种读取入口均能看到执行中、提交及完成后的记录；普通会话、只读连接与伪造参数不能越权。反例在修复前复现为空列表，修复后通过。样本和接口为合成数据，未读取正式知识库、调用外部付费服务或验证正式用户完整界面。

2.4.7：升级交接等待提示（2026-11-05）

交接期间保留稳定的知识库 API 入口，明确返回服务准备状态；界面显示“知识库服务准备中，请稍候…”，接口就绪后继续读取。只对服务明确确认尚未执行的请求等待后重新提交；真实 HTTP 405、断线及未知写入结果不自动重放。准备失败或等待超时仍提供错误与恢复说明，不把它们伪装为就绪。

19 项定向检查通过，包含真实本地 HTTP 路由准备、恢复后的写请求仅执行一次、失败与超时边界、旧服务交接和服务恢复。未额外重复完整功能回归；未对正式用户实例操作或声称完整界面实测。

2.4.6：2.4.3 直接自动升级与恢复（2026-11-05）

沿用本次验证的 2.4.3 直接安装、自然退出交接、条件错误提示和固定旧包恢复。补充 Windows 内置管理员 SID 别名的规范化校验，权限仍要求同一组明确的主体与授权。2.4.5 候选未通过发布环境校验，未创建正式 Release；保留其包字节，后续以 2.4.6 为自动更新目标。

Direct 2.4.3 upgrades, natural idle handoff, conditional recovery help and pinned legacy repair are retained. Windows SID aliases are normalized before exact ACL comparison. The unpublished 2.4.5 candidate is preserved; 2.4.6 is the follow-up distribution.

升级错误恢复说明 / Recovery instructions

升级报错后的手动恢复说明 / Upgrade error recovery

2.4.5：2.4.3 直接自动升级与旧服务交接（2026-11-05）

• 恢复正式自动更新入口，正常 2.4.3 可直接安装本版，不要求先手动安装过渡版本。
• 新版通过已发布 2.4.3 的精确运行时指纹识别旧服务；释放探测连接后等待旧服务按原有空闲机制自然退出，核对原进程出生标识和清理回执，再启动新服务。不向缺少停服协议的旧服务发送 shutdown，不终止其他连接或任务；超时显示恢复说明。
• 新版运行中的安装、事务恢复或交接确实报错时，才显示手动更新与恢复说明。2.4.3 若在首次 pnpm 安装阶段就失败，新代码尚未加载，仍使用旧版原错误界面；现有更新说明入口提供同一恢复文档，不能承诺旧界面具有新版弹窗。
• 手动恢复包可从固定摘要的公开 2.4.3 包重建受损代码目录，保留残留目录和原 profile 清单，再使用事务安装器升级；不清空知识库或解析记录。

验证使用真实公开 2.4.3 TGZ、Windows 上的运行服务与真实 pnpm，覆盖直接安装、自然退出后交接、原件保留及受损旧安装恢复；事务失败回退沿用并补验现有检查。验证范围不包含正式用户 profile 安装或完整 Electron 界面操作。旧 2.4.3 首次安装仍由宿主旧安装器执行，不能获得新版事务器在安装前的保护；异常时走恢复入口。旧更新源不能按客户端运行状态筛选，2.4.3 以外的旧版不属于本次定向保证。

2.4.4：Windows 安全更新与失败恢复（2026-11-05）

• pnpm 只在隔离的清单副本中准备锁文件；新包先完成摘要、构建号、路径和文件校验，不让包管理器改写在线插件目录。
• 更新前通过管理员授权的停服协议检查其他连接、排队及运行中的解析、导入和流程任务；忙碌时延后。停服后核对清理回执及进程退出，再切换完整包目录。
• 原插件目录和清单保留在私有事务目录；切换或清单写入失败时回退并逐文件校验。中途退出的安装可从持久事务记录恢复，不把未知结果标为成功，不重复发起安装。
• 2.4.4 使用 release-manifest-v2.json。旧 release-manifest.json 停用安装分发，阻断旧更新器继续走不安全的原地安装。2.4.3 及更早版本首次过渡须退出宿主及连接客户端，使用本版过渡安装包；旧服务不支持停服协议时自动路径会拒绝接管。
• 成功安装后明确提示重启生效。嵌入模式或缺少安全停服能力时保持旧版，暂不自动安装。包带额外依赖、相对本地依赖或旧包已不完整等不支持的情况均停止，不擅自重建用户配置。

验证：35 项 Node 定向检查、5 项真实文件系统/真实 pnpm 事务测试，以及 1 个 Windows 运行服务升级复合场景通过。复合场景包括原始 2.4.3 服务的拒绝接管、额外连接和排队任务的延后、使用旧目录 Python 的协议服务退出、真实 2.4.3 包切换失败后逐文件恢复、成功升级重启和虚构原件保留。具备新停服协议的服务升级与未修改旧服务的首次过渡是两条不同路径。本次未在正式用户 profile 安装，也未验证真实模型或完整 UI。

2.4.3：原件同步与 Windows 解析任务修复（2026-11-05）

• 合入文本原件与引用同步：归档文本参与检索，原件编辑后更新索引与引用范围；旧的自动生成镜像引用当前原件，独立撰写的摘要仍保留。
• 调整索引排除与恢复时的关联原件、派生记录及增量向量复用；修复含中文路径及版本化 Python 路径的 PDF 渲染。
• Windows 解析任务记录的读取和原子替换共用进程级队列，减少句柄重叠；外部占用有限重试，耗尽时保留旧记录并清理临时文件。
• 提交、重试和启动恢复的后台错误均被捕获；尽力保存失败状态，无法保存时明确报告，清理心跳和运行标记。

Windows 定向复验 73/73 通过（原有 68 项及新增 5 项故障测试）。测试使用虚构资料和请求替身，不证明真实 OCR/ASR 效果、自动 PDF/Office 索引同步、原生位置映射或完整桌面运行兼容性。客户端独立发布版本仍为 1.0.3，本次不重新发布客户端安装器。

历史记录 / Earlier releases

统一仓库源码 · 2026-11-04

2026-11-04 合仓时源码版本：客户端 1.0.1 / 插件 2.4.1。整合桌面工作区、共享内核与服务、可选记忆联动适配及现有安装器。两端后续统一维护于本仓库。该次文档更新未发布二进制 Release，当时公开插件清单为 2.3.1。后续历史条目除另有说明外均为插件记录。客户端版本说明。

2.3.1：收件箱提示词与任务状态修复（2026-11-03）

• 收件箱整理只发送“帮我整理并归档收件箱内文件”，不再附加流程及目录说明。
• OCR/ASR 任务记录使用静默后台刷新，合并同时发生的刷新请求，保留列表位置及详情展开状态。
• 知识库会话的命令工具漏传显示说明时补全说明；保留原有参数校验、工具可见范围及权限拒绝。
• 会话计划增加逐步更新规则及每轮一次的结束前核对。会话停止后旧的进行中步骤显示为未确认完成，完成数仍以实际待办记录为准。

验证包括定向自动检查、已安装 DSH 工具调度器的合成执行，以及 Edge 中的任务刷新和待办状态场景。权限拒绝及工具限制仍生效。正式桌面安装、真实模型对整项任务的完成质量及真实云端 OCR/ASR 未验证；会话结束不会自动把待办改为成功。

2.3.0 同版本修复：收件箱迁移与一键整理（2026-10-31）

简体中文 · English

• 桌面收件箱直接扫描当前知识库的 90-收件箱/。拖入或选择文件后迁移原件到该目录，不再通过快速收集的 Base64 上传接口，也不再受其 8 MiB 限制或依赖收集记录。同名文件追加编号；跨盘先复制并校验，再移除源文件；失败时保留源文件。手机快速收集页仍沿用上传限制。
• 修复“一键整理”选模时的 remote.session 依赖注入错误，检查模型选择返回结果，失败时不发送任务。错误提示区分“任务尚未发送”和“发送结果未确认”，不自动重试。
• 一键整理只发送“整理并归档收件箱内的文件。”；执行规则由知识库 Agent 与插件提供。用户所选模型与 High 推理强度继续生效。

版本号保持 2.3.0，本次更新仓库源码和配套安装包，不移动已有 v2.3.0 标签或替换其 Release 附件。8 项定向测试及流程探针通过；使用虚构资料和宿主服务替身，未安装到正式 DSH 或调用真实模型。

2.3.0 正式版：统一桌面界面（2026-10-30）

简体中文 · English

• 修正普通桌面宿主中知识库 Agent 的 OCR / ASR 被误拒绝：没有 H1 时按活的知识库根会话或实时委派授权校验，可正常提交解析；显式 ...

2.5.8 · 个人知识库插件

插件 2.5.8 · 加快知识库重开

切回同一个知识库时直接显示已有视图。文件变化或手动刷新时更新，权限变化时清除旧缓存。

插件 2.5.7 · 修复 ASAR 索引误报

知识库服务按磁盘上的真实文件扫描，整份 ASAR 安装包作为一个原件登记。包内虚拟文件不再触发「文件在读取期间发生变化」，索引维护可正常完成。此版仅更新 DSH 插件，客户端版本仍为 1.1.2。

插件 2.5.6 · 历史会话记忆联动

知识库桥接按历史会话已保存的归属读取联动记忆。副库断开时返回明确状态。配合 DSH Memory 1.0.12 使用。桌面客户端继续使用 1.1.2。

插件 2.5.5 / 客户端 1.1.2：共库兼容与手动更新（2026-11-07）

修复打开客户端时因插件构建指纹不同而提示“其他版本在线”的问题。构建指纹保留用于诊断；共享服务改为核对协议主版本、完整接口契约指纹、存储和引擎兼容代次及调用方必需能力。已核验的公开插件 2.5.3 / 2.5.4 服务可被新版客户端复用，不要求关闭正在运行的 DSH，不启动第二个写入者。未知旧构建、缺少能力或确实不兼容的服务仍保留安全交接限制。未来不兼容的存储或引擎语义变更必须提升兼容代次，不能只沿用原标记。

客户端“帮助 → 更新与手动安装”增加“手动更新 · 下载并校验”“启动已校验的安装程序”及官方下载页入口。允许复用已校验缓存，启动前再次核对大小与 SHA-256；不接受界面传入任意程序路径。保存并关闭客户端后按安装器提示完成安装，自动原位覆盖安装仍未实现。原有自动检查和校验下载保留。

30 项定向检查通过，包含真实 Windows 共享服务、原旧连接反例、不同构建双向接入、一个写入者、原件字节保持、安全停服恢复和手动更新包损坏拒绝。发布包另核对源码、分片和客户端内嵌插件摘要。测试使用虚构库；真实用户库仅通过既有授权服务核对连接状态，不读取正文，不执行知识库迁移或收费模型调用。实际安装与界面加载结果另记。

插件 2.5.4：更新下载与失败提示修复（2026-11-07）

修复版本清单可读、安装包却下载失败的问题。Gitee 大二进制 raw 地址可能拒绝访问，GitCode 同步可能滞后，GitHub raw 在部分网络下不可达。现在支持国内镜像的小文本分片下载，按发布摘要定位固定分片路径，最多三个并发，组装后执行完整的大小、SHA-256 和插件格式校验；另增加固定的 GitHub Pages 和 Release 下载备用入口，不接受清单提供的任意地址。

大文件改用传输空闲超时，持续收到数据时不再被原有 20 秒总超时中断，同时保留五分钟总时限。关闭失败提示后，同一次失败的关闭状态在界面切换、组件重挂载与本次页面会话内保留；手动重试产生的新失败仍可提示。

36 项定向测试通过，覆盖分片重组、摘要损坏、编码与恶意跳转拒绝、并发上限、慢速持续传输及关闭状态恢复。样例使用正式发布包和虚构状态，不连接真实知识库或付费模型。客户端独立版本仍为 1.1.1，本次只发布插件；程序更新不执行知识库迁移。旧版更新器无法识别分片，遇到同样问题可使用已校验的本地 TGZ 安装；本机已准备对应更新缓存。

插件 2.5.3 / 客户端 1.1.1（2026-11-07）

本次统一发布此前本地交付的原件索引架构及后续修正，两端继续使用同一共享内核与服务，独立安装、独立版本。

• 原件保持原位；索引层记录身份、路径、分类、标签与指纹。插件和客户端提供迁移预览与确认入口，程序更新不会自动迁移资料库。
• 客户端增加原件分类文件树及分类操作，分类与隐私筛选由共享服务执行；既有文件、绑定及资料库身份保留。
• 流程卡保存模型与推理配置，运行使用已保存配置；内置收件箱仍要求 High。自定义流程准备不再误入内置收件箱校验。
• 任务计划面板修正宽度和向上展开方向；长工具执行期间提示模型核对进度，由模型依据实际结果更新状态。
• 成品登记说明明确支持复用系列目录：task 填系列目录名，title 填单期标题，path 填库内相对路径。无需按日期拆目录，路径与隐私校验继续生效。

本次验证使用虚构库与针对性检查，发布包核对源码、构建指纹和摘要；不读取真实私有库，不调用收费模型。历史验收记录保留其当时范围；本次打包不代表正式用户安装、DSH 重启激活、真实报告生成或外部发送已经验证。客户端自动覆盖安装与激活尚未接入。

安装：插件使用 v2.5.3 Release 中的 TGZ；客户端使用 client-v1.1.1 Release 中的 Windows x64 Setup.exe（未签名），分别核对清单与 SHA-256。客户端安装目录需为空，先保存工作并退出旧客户端；DSH 插件按宿主提示重新加载或完全退出含托盘后重开，核对版本和构建号。旧 2.4.6 更新受阻时仍使用既有恢复入口。

2.5.x：任务计划面板宽度修复（源码补丁，未发布，2026-11-06）

任务计划面板沿用官方 composer 的宽度与居中公式，补齐 border-box 和 CSS 变量兜底；变量缺失时卡片上限取 952px，面板上限取 920px，极窄容器下计算宽度不小于零。保留原有边框、圆角、字号、默认收起、状态映射及隐藏官方面板的规则。未根据未经测量的状态滞后报告修改状态源、文案或 Host 收尾核对机制。

独立源码修改后运行 python -X utf8 tools/sync-todo-lifecycle-client.py 同步 index.js 的标记区块，再运行 node --test tests/todo-lifecycle.test.mjs。本次未变更 package.json 版本、未生成安装包或修改发布清单；发布时仍须按 VERSIONING.md 选择新版本，并通过既有打包流程重新计算构建指纹与摘要。测量范围和缺口见 面板验收记录。

2.5.0：原件索引架构（本地交付，2026-11-06）

插件与客户端新增同名“迁移到索引架构”入口，共用预览、确认、文件目录和分类。原件保持原位；索引层登记文件身份、位置、分类和指纹，不保存分类正文副本。迁移后全文索引写入索引层，原地接入和收件箱分类直接登记原件。

识别旧机器引用并在检索中去重，保留用户独立笔记。文件修改、可核验改名及缺失由维护更新；预览后文件变化、原件缺失或链接路径会阻止发布。已有规则、模板和目录保留，原目录补齐功能标为可选。既有库身份和授权事务元数据继续使用 .kbmeta，不执行全量元数据搬迁。

隔离检查覆盖迁移保护、原件检索、分类、文件变化、索引失败待完成及 Windows 两端独立/共享访问；Electron 中验证设置入口、预览确认、启用状态与保存分类。未对真实私有库执行迁移，未验证真实模型或所有二进制正文解析。详见 原件索引架构。本次为本地交付，尚未发布到远程更新源。

2.4.14：旧库框架迁移（2026-11-05）

新增“版本与诊断 → 旧库框架迁移”：先只读预览，再确认补齐缺失的标准目录、条目模板和框架管理说明。已有资料位置、自定义目录、AGENTS 正文、人工 INDEX 和不同内容的模板保留；可查看新版参考。迁移不自动搬移资料、重写笔记或调用模型。

预览绑定知识库身份与文件快照；状态改变、同名类型冲突或链接路径时停止。写入失败只撤销可核对的本次新增文件和空目录；用户后续修改保留并提示恢复。共享服务校验管理授权，机制版本改为实际核心版本。

7 项迁移/界面定向检查和 2 项既有托管升级检查通过，包含真实 Windows 共享服务与 EPERM 恢复。发布包完整性与升级加载另做必要检查。未对真实用户库执行迁移，未验证完整 Electron 界面或模型调用。程序更新与旧库框架迁移分别执行，旧更新器受阻限制继续适用。

2.4.6 升级范围补充（2026-11-05）

原版 2.4.6 的旧回执确认会在下载新包前阻断更新，旧准备器还可能重新解析其他宿主依赖。仅发布 2.4.13 或过渡包不能修复已经运行的旧代码；本机经过单次兼容恢复后成功，不代表其他原版用户均能零操作升级。

现提供独立的 2.4.6 通用升级恢复入口，校验公开原包后事务安装未改动的正式 2.4.13，支持自动发现单一 profile 或明确选择其他 profile。它是一次性外部恢复，不是静默自动升级。4 项 Windows 入口/真实 pnpm 检查和 2 项旧客户端边界检查通过，覆盖其他依赖保持、提交 EPERM 回滚、忙碌拒绝、多 profile 选择和独立 Python。历史安全事务不匹配仍可能阻止后续安装，不能宣称通用零操作自动迁移已经完成；这需要 DSH 宿主独立恢复通道。

2.4.13：更新不再重解析宿主依赖（2026-11-05）

安全更新只在独立解析目录中解析无依赖的知识库包，将其 importer、package、snapshot 三组记录合并到原 pnpm v9 锁文件。其他插件的来源、锁定版本及记录逐字节保留，不再向注册源查找宿主内置包，也不复制或重装其他插件。未知锁格式、歧义或跨包引用失败时保留旧安装。

19 项更新状态检查、8 项真实 pnpm／事务检查通过；另用本机清单的隔离副本验证仅解析知识库包能完成准备，原 profile 清单与锁未改动。保留回滚与崩溃恢复；真实设备安装及加载结果另记，不由准备成功推断。

2.4.12：本地依赖与自动更新准备（2026-11-05）

保留 2.4.11 的共享状态构建字段与旧接口确认修复。进一步修复更新准备阶段拒绝 profile 内相对路径本地插件的问题：将这些依赖复制到隔离的影子目录，使 pnpm 只处理影子清单；保持真实 profile 中其他插件的来源字符串及文件不变。拒绝越界、链接、元数据冲突和超过 64 MiB 的相对依赖，不复制运行知识库或凭据。

19 项状态确认检查、7 项真实 pnpm 与事务检查通过，覆盖本地依赖保留、越界拒绝、发布失败回滚和进程崩溃恢复。实际设备自动升级另行记录；下载成功、合成检查或磁盘包版本均不单独代表正在运行的新构建已经生效。

2.4.11：共享状态构建与自动更新确认（2026-11-05）

修复共享模式 POST status 缺少 build，而更新确认必须校验版本与构建号的问题。旧安装即使已经加载，也可能永久停在待确认。现在共享状态统一携带 Host 构建；客户端兼容从旧版 GET 状态读取构建，仍要求精确匹配，不按版本号单独确认。

19 项定向检查通过，新增原共享状态缺字段反例和旧接口兼容确认；保留安装锁、已准备事务续装及失败恢复限制。针对已被旧代码锁住的客户端，需要一次受控的兼容恢复才能重新进入自动流程；发布更新源本身不能修改正在运行的旧代码。恢复必须先验证旧请求与已安装构建，不得无条件清空客户端状态。真实用户升级结果单独记录，不把这些合成检查当作实机安装证明。

2.4.10：安装待确认状态恢复（2026-11-05）

修复核对不到旧安装回执时，界面永久停在待确认、安装按钮保持禁用的问题。核对流程增加磁盘安装构建、当前安全安装操作和 profile 写锁信息；只有宿主明确没有旧请求、安装操作及写锁均不活跃且当前安装可校验时，才解除旧请求。单纯等待时间变长或接口失败不能触发解除。

已准备但尚未开始的安全事务可继续原事务，不创建第二次准备或重复安装。目标文件已经写入而宿主仍运行旧构建时，显示保存工作并重启；正在安装、无法校验或损坏状态继续拒绝盲目重试。

17 项定向检查通过，覆盖失效旧请求、写锁与活动操作、缺失事务文件、已安装未加载、原事务续装及既有完成状态。没有对正式用户实例执行安装、删除客户端缓存或强制重启。

若旧版界面已经被待确认状态锁住，新修复尚无法加载：在 DSH 自身“设置 → 插件”中使用本版正式安装源更新一次，按宿主提示重新加载；不要在知识库的灰色按钮上反复尝试。详见升级恢复说明。

2.4.9：kb_flow 返回契约（2026-11-05）

修复共享模式 kb_flow 的返回结果缺少 action，导致宿主报 value.action 字段缺失的问题。共享服务与 Host 工具边界都按原请求补全动作；业务失败、断线与调用方校验失败也保留 action、原错误和成功状态，不放宽原输出校验，不把失败伪装成成功，不重放调用。

3 项定向测试通过，覆盖全部 8 种动作、实际注册的 Host 工具成功及失败返回，以及隔离真实 Windows 共享服务读取与业务失败。仅使用合成数据，没有重放正式用户流程。

另定位到记忆插件 1.0.4 在工具续步中仅从新输入查用户消息，可能以空快照替换已召回约定；该组件的 1.0.5 本地修复另行交付，不包含在此知识库包内，未公开发布或自动安装。合成课堂录音约定验证了持久保存、召回及解析完成后的上下文续接，未证明正式录音已自动生成笔记。

2.4.8：设置页的解析调用记录（2026-11-05）

修复共享服务把管理界面的只读请求当作普通会话的问题。设置页依据已认证连接的管理权限读取 OCR / ASR 执行任务和提交记录，不再按固定界面会话误过滤 Agent 发起的任务；资料可见性筛选仍然生效。普通模型工具和只读连接不因此获得跨会话管理权限，写接口仍要求管理授权。

3 项定向测试通过：在隔离的真实 Windows 共享服务中，由独立 Agent 会话调用本地合成 OCR / ASR 接口，设置页两种读取入口均能看到执行中、提交及完成后的记录；普通会话、只读连接与伪造参数不能越权。反例在修复前复现为空列表，修复后通过。样本和接口为合成数据，未读取正式知识库、调用外部付费服务或验证正式用户完整界面。

2.4.7：升级交接等待提示（2026-11-05）

交接期间保留稳定的知识库 API 入口，明确返回服务准备状态；界面显示“知识库服务准备中，请稍候…”，接口就绪后继续读取。只对服务明确确认尚未执行的请求等待后重新提交；真实 HTTP 405、断线及未知写入结果不自动重放。准备失败或等待超时仍提供错误与恢复说明，不把它们伪装为就绪。

19 项定向检查通过，包含真实本地 HTTP 路由准备、恢复后的写请求仅执行一次、失败与超时边界、旧服务交接和服务恢复。未额外重复完整功能回归；未对正式用户实例操作或声称完整界面实测。

2.4.6：2.4.3 直接自动升级与恢复（2026-11-05）

沿用本次验证的 2.4.3 直接安装、自然退出交接、条件错误提示和固定旧包恢复。补充 Windows 内置管理员 SID 别名的规范化校验，权限仍要求同一组明确的主体与授权。2.4.5 候选未通过发布环境校验，未创建正式 Release；保留其包字节，后续以 2.4.6 为自动更新目标。

Direct 2.4.3 upgrades, natural idle handoff, conditional recovery help and pinned legacy repair are retained. Windows SID aliases are normalized before exact ACL comparison. The unpublished 2.4.5 candidate is preserved; 2.4.6 is the follow-up distribution.

升级错误恢复说明 / Recovery instructions

升级报错后的手动恢复说明 / Upgrade error recovery

2.4.5：2.4.3 直接自动升级与旧服务交接（2026-11-05）

• 恢复正式自动更新入口，正常 2.4.3 可直接安装本版，不要求先手动安装过渡版本。
• 新版通过已发布 2.4.3 的精确运行时指纹识别旧服务；释放探测连接后等待旧服务按原有空闲机制自然退出，核对原进程出生标识和清理回执，再启动新服务。不向缺少停服协议的旧服务发送 shutdown，不终止其他连接或任务；超时显示恢复说明。
• 新版运行中的安装、事务恢复或交接确实报错时，才显示手动更新与恢复说明。2.4.3 若在首次 pnpm 安装阶段就失败，新代码尚未加载，仍使用旧版原错误界面；现有更新说明入口提供同一恢复文档，不能承诺旧界面具有新版弹窗。
• 手动恢复包可从固定摘要的公开 2.4.3 包重建受损代码目录，保留残留目录和原 profile 清单，再使用事务安装器升级；不清空知识库或解析记录。

验证使用真实公开 2.4.3 TGZ、Windows 上的运行服务与真实 pnpm，覆盖直接安装、自然退出后交接、原件保留及受损旧安装恢复；事务失败回退沿用并补验现有检查。验证范围不包含正式用户 profile 安装或完整 Electron 界面操作。旧 2.4.3 首次安装仍由宿主旧安装器执行，不能获得新版事务器在安装前的保护；异常时走恢复入口。旧更新源不能按客户端运行状态筛选，2.4.3 以外的旧版不属于本次定向保证。

2.4.4：Windows 安全更新与失败恢复（2026-11-05）

• pnpm 只在隔离的清单副本中准备锁文件；新包先完成摘要、构建号、路径和文件校验，不让包管理器改写在线插件目录。
• 更新前通过管理员授权的停服协议检查其他连接、排队及运行中的解析、导入和流程任务；忙碌时延后。停服后核对清理回执及进程退出，再切换完整包目录。
• 原插件目录和清单保留在私有事务目录；切换或清单写入失败时回退并逐文件校验。中途退出的安装可从持久事务记录恢复，不把未知结果标为成功，不重复发起安装。
• 2.4.4 使用 release-manifest-v2.json。旧 release-manifest.json 停用安装分发，阻断旧更新器继续走不安全的原地安装。2.4.3 及更早版本首次过渡须退出宿主及连接客户端，使用本版过渡安装包；旧服务不支持停服协议时自动路径会拒绝接管。
• 成功安装后明确提示重启生效。嵌入模式或缺少安全停服能力时保持旧版，暂不自动安装。包带额外依赖、相对本地依赖或旧包已不完整等不支持的情况均停止，不擅自重建用户配置。

验证：35 项 Node 定向检查、5 项真实文件系统/真实 pnpm 事务测试，以及 1 个 Windows 运行服务升级复合场景通过。复合场景包括原始 2.4.3 服务的拒绝接管、额外连接和排队任务的延后、使用旧目录 Python 的协议服务退出、真实 2.4.3 包切换失败后逐文件恢复、成功升级重启和虚构原件保留。具备新停服协议的服务升级与未修改旧服务的首次过渡是两条不同路径。本次未在正式用户 profile 安装，也未验证真实模型或完整 UI。

2.4.3：原件同步与 Windows 解析任务修复（2026-11-05）

• 合入文本原件与引用同步：归档文本参与检索，原件编辑后更新索引与引用范围；旧的自动生成镜像引用当前原件，独立撰写的摘要仍保留。
• 调整索引排除与恢复时的关联原件、派生记录及增量向量复用；修复含中文路径及版本化 Python 路径的 PDF 渲染。
• Windows 解析任务记录的读取和原子替换共用进程级队列，减少句柄重叠；外部占用有限重试，耗尽时保留旧记录并清理临时文件。
• 提交、重试和启动恢复的后台错误均被捕获；尽力保存失败状态，无法保存时明确报告，清理心跳和运行标记。

Windows 定向复验 73/73 通过（原有 68 项及新增 5 项故障测试）。测试使用虚构资料和请求替身，不证明真实 OCR/ASR 效果、自动 PDF/Office 索引同步、原生位置映射或完整桌面运行兼容性。客户端独立发布版本仍为 1.0.3，本次不重新发布客户端安装器。

历史记录 / Earlier releases

统一仓库源码 · 2026-11-04

2026-11-04 合仓时源码版本：客户端 1.0.1 / 插件 2.4.1。整合桌面工作区、共享内核与服务、可选记忆联动适配及现有安装器。两端后续统一维护于本仓库。该次文档更新未发布二进制 Release，当时公开插件清单为 2.3.1。后续历史条目除另有说明外均为插件记录。客户端版本说明。

2.3.1：收件箱提示词与任务状态修复（2026-11-03）

• 收件箱整理只发送“帮我整理并归档收件箱内文件”，不再附加流程及目录说明。
• OCR/ASR 任务记录使用静默后台刷新，合并同时发生的刷新请求，保留列表位置及详情展开状态。
• 知识库会话的命令工具漏传显示说明时补全说明；保留原有参数校验、工具可见范围及权限拒绝。
• 会话计划增加逐步更新规则及每轮一次的结束前核对。会话停止后旧的进行中步骤显示为未确认完成，完成数仍以实际待办记录为准。

验证包括定向自动检查、已安装 DSH 工具调度器的合成执行，以及 Edge 中的任务刷新和待办状态场景。权限拒绝及工具限制仍生效。正式桌面安装、真实模型对整项任务的完成质量及真实云端 OCR/ASR 未验证；会话结束不会自动把待办改为成功。

2.3.0 同版本修复：收件箱迁移与一键整理（2026-10-31）

简体中文 · English

• 桌面收件箱直接扫描当前知识库的 90-收件箱/。拖入或选择文件后迁移原件到该目录，不再通过快速收集的 Base64 上传接口，也不再受其 8 MiB 限制或依赖收集记录。同名文件追加编号；跨盘先复制并校验，再移除源文件；失败时保留源文件。手机快速收集页仍沿用上传限制。
• 修复“一键整理”选模时的 remote.session 依赖注入错误，检查模型选择返回结果，失败时不发送任务。错误提示区分“任务尚未发送”和“发送结果未确认”，不自动重试。
• 一键整理只发送“整理并归档收件箱内的文件。”；执行规则由知识库 Agent 与插件提供。用户所选模型与 High 推理强度继续生效。

版本号保持 2.3.0，本次更新仓库源码和配套安装包，不移动已有 v2.3.0 标签或替换其 Release 附件。8 项定向测试及流程探针通过；使用虚构资料和宿主服务替身，未安装到正式 DSH 或调用真实模型。

2.3.0 正式版：统一桌面界面（2026-10-30）

简体中文 · English

• 修正普通桌面宿主中知识库 Agent 的 OCR / ASR 被误拒绝：没有 H1 时按活的知识库根会话或实时委派授权校验，可正常提交解析；显式 parse.allowWithoutIsolation:false 仍要求 H1，已启用但未就绪的 H1 不回退。独立流程工作区中的已授权知识库会话可解析当前绑定库的原件。来源授权入口保留实际拒绝代码与原因，避免把隔离环境问题误报为缺少知识库权限。6 项定向检查通过，包括虚构原件经本机模拟 OCR / ASR 服务提交和读取结果；未调用真实模型。

• OCR / ASR 每条提交记录新增“查看详情”，包括被拒绝的提交：展示原始失败说明与代码、请求编号、时间、来源文件、发起会话 / Agent / 预设与授权入口、知...

2.5.7 · 个人知识库插件

插件 2.5.7 · 修复 ASAR 索引误报

知识库服务按磁盘上的真实文件扫描，整份 ASAR 安装包作为一个原件登记。包内虚拟文件不再触发「文件在读取期间发生变化」，索引维护可正常完成。此版仅更新 DSH 插件，客户端版本仍为 1.1.2。

插件 2.5.6 · 历史会话记忆联动

知识库桥接按历史会话已保存的归属读取联动记忆。副库断开时返回明确状态。配合 DSH Memory 1.0.12 使用。桌面客户端继续使用 1.1.2。

插件 2.5.5 / 客户端 1.1.2：共库兼容与手动更新（2026-11-07）

修复打开客户端时因插件构建指纹不同而提示“其他版本在线”的问题。构建指纹保留用于诊断；共享服务改为核对协议主版本、完整接口契约指纹、存储和引擎兼容代次及调用方必需能力。已核验的公开插件 2.5.3 / 2.5.4 服务可被新版客户端复用，不要求关闭正在运行的 DSH，不启动第二个写入者。未知旧构建、缺少能力或确实不兼容的服务仍保留安全交接限制。未来不兼容的存储或引擎语义变更必须提升兼容代次，不能只沿用原标记。

客户端“帮助 → 更新与手动安装”增加“手动更新 · 下载并校验”“启动已校验的安装程序”及官方下载页入口。允许复用已校验缓存，启动前再次核对大小与 SHA-256；不接受界面传入任意程序路径。保存并关闭客户端后按安装器提示完成安装，自动原位覆盖安装仍未实现。原有自动检查和校验下载保留。

30 项定向检查通过，包含真实 Windows 共享服务、原旧连接反例、不同构建双向接入、一个写入者、原件字节保持、安全停服恢复和手动更新包损坏拒绝。发布包另核对源码、分片和客户端内嵌插件摘要。测试使用虚构库；真实用户库仅通过既有授权服务核对连接状态，不读取正文，不执行知识库迁移或收费模型调用。实际安装与界面加载结果另记。

插件 2.5.4：更新下载与失败提示修复（2026-11-07）

修复版本清单可读、安装包却下载失败的问题。Gitee 大二进制 raw 地址可能拒绝访问，GitCode 同步可能滞后，GitHub raw 在部分网络下不可达。现在支持国内镜像的小文本分片下载，按发布摘要定位固定分片路径，最多三个并发，组装后执行完整的大小、SHA-256 和插件格式校验；另增加固定的 GitHub Pages 和 Release 下载备用入口，不接受清单提供的任意地址。

大文件改用传输空闲超时，持续收到数据时不再被原有 20 秒总超时中断，同时保留五分钟总时限。关闭失败提示后，同一次失败的关闭状态在界面切换、组件重挂载与本次页面会话内保留；手动重试产生的新失败仍可提示。

36 项定向测试通过，覆盖分片重组、摘要损坏、编码与恶意跳转拒绝、并发上限、慢速持续传输及关闭状态恢复。样例使用正式发布包和虚构状态，不连接真实知识库或付费模型。客户端独立版本仍为 1.1.1，本次只发布插件；程序更新不执行知识库迁移。旧版更新器无法识别分片，遇到同样问题可使用已校验的本地 TGZ 安装；本机已准备对应更新缓存。

插件 2.5.3 / 客户端 1.1.1（2026-11-07）

本次统一发布此前本地交付的原件索引架构及后续修正，两端继续使用同一共享内核与服务，独立安装、独立版本。

• 原件保持原位；索引层记录身份、路径、分类、标签与指纹。插件和客户端提供迁移预览与确认入口，程序更新不会自动迁移资料库。
• 客户端增加原件分类文件树及分类操作，分类与隐私筛选由共享服务执行；既有文件、绑定及资料库身份保留。
• 流程卡保存模型与推理配置，运行使用已保存配置；内置收件箱仍要求 High。自定义流程准备不再误入内置收件箱校验。
• 任务计划面板修正宽度和向上展开方向；长工具执行期间提示模型核对进度，由模型依据实际结果更新状态。
• 成品登记说明明确支持复用系列目录：task 填系列目录名，title 填单期标题，path 填库内相对路径。无需按日期拆目录，路径与隐私校验继续生效。

本次验证使用虚构库与针对性检查，发布包核对源码、构建指纹和摘要；不读取真实私有库，不调用收费模型。历史验收记录保留其当时范围；本次打包不代表正式用户安装、DSH 重启激活、真实报告生成或外部发送已经验证。客户端自动覆盖安装与激活尚未接入。

安装：插件使用 v2.5.3 Release 中的 TGZ；客户端使用 client-v1.1.1 Release 中的 Windows x64 Setup.exe（未签名），分别核对清单与 SHA-256。客户端安装目录需为空，先保存工作并退出旧客户端；DSH 插件按宿主提示重新加载或完全退出含托盘后重开，核对版本和构建号。旧 2.4.6 更新受阻时仍使用既有恢复入口。

2.5.x：任务计划面板宽度修复（源码补丁，未发布，2026-11-06）

任务计划面板沿用官方 composer 的宽度与居中公式，补齐 border-box 和 CSS 变量兜底；变量缺失时卡片上限取 952px，面板上限取 920px，极窄容器下计算宽度不小于零。保留原有边框、圆角、字号、默认收起、状态映射及隐藏官方面板的规则。未根据未经测量的状态滞后报告修改状态源、文案或 Host 收尾核对机制。

独立源码修改后运行 python -X utf8 tools/sync-todo-lifecycle-client.py 同步 index.js 的标记区块，再运行 node --test tests/todo-lifecycle.test.mjs。本次未变更 package.json 版本、未生成安装包或修改发布清单；发布时仍须按 VERSIONING.md 选择新版本，并通过既有打包流程重新计算构建指纹与摘要。测量范围和缺口见 面板验收记录。

2.5.0：原件索引架构（本地交付，2026-11-06）

插件与客户端新增同名“迁移到索引架构”入口，共用预览、确认、文件目录和分类。原件保持原位；索引层登记文件身份、位置、分类和指纹，不保存分类正文副本。迁移后全文索引写入索引层，原地接入和收件箱分类直接登记原件。

识别旧机器引用并在检索中去重，保留用户独立笔记。文件修改、可核验改名及缺失由维护更新；预览后文件变化、原件缺失或链接路径会阻止发布。已有规则、模板和目录保留，原目录补齐功能标为可选。既有库身份和授权事务元数据继续使用 .kbmeta，不执行全量元数据搬迁。

隔离检查覆盖迁移保护、原件检索、分类、文件变化、索引失败待完成及 Windows 两端独立/共享访问；Electron 中验证设置入口、预览确认、启用状态与保存分类。未对真实私有库执行迁移，未验证真实模型或所有二进制正文解析。详见 原件索引架构。本次为本地交付，尚未发布到远程更新源。

2.4.14：旧库框架迁移（2026-11-05）

新增“版本与诊断 → 旧库框架迁移”：先只读预览，再确认补齐缺失的标准目录、条目模板和框架管理说明。已有资料位置、自定义目录、AGENTS 正文、人工 INDEX 和不同内容的模板保留；可查看新版参考。迁移不自动搬移资料、重写笔记或调用模型。

预览绑定知识库身份与文件快照；状态改变、同名类型冲突或链接路径时停止。写入失败只撤销可核对的本次新增文件和空目录；用户后续修改保留并提示恢复。共享服务校验管理授权，机制版本改为实际核心版本。

7 项迁移/界面定向检查和 2 项既有托管升级检查通过，包含真实 Windows 共享服务与 EPERM 恢复。发布包完整性与升级加载另做必要检查。未对真实用户库执行迁移，未验证完整 Electron 界面或模型调用。程序更新与旧库框架迁移分别执行，旧更新器受阻限制继续适用。

2.4.6 升级范围补充（2026-11-05）

原版 2.4.6 的旧回执确认会在下载新包前阻断更新，旧准备器还可能重新解析其他宿主依赖。仅发布 2.4.13 或过渡包不能修复已经运行的旧代码；本机经过单次兼容恢复后成功，不代表其他原版用户均能零操作升级。

现提供独立的 2.4.6 通用升级恢复入口，校验公开原包后事务安装未改动的正式 2.4.13，支持自动发现单一 profile 或明确选择其他 profile。它是一次性外部恢复，不是静默自动升级。4 项 Windows 入口/真实 pnpm 检查和 2 项旧客户端边界检查通过，覆盖其他依赖保持、提交 EPERM 回滚、忙碌拒绝、多 profile 选择和独立 Python。历史安全事务不匹配仍可能阻止后续安装，不能宣称通用零操作自动迁移已经完成；这需要 DSH 宿主独立恢复通道。

2.4.13：更新不再重解析宿主依赖（2026-11-05）

安全更新只在独立解析目录中解析无依赖的知识库包，将其 importer、package、snapshot 三组记录合并到原 pnpm v9 锁文件。其他插件的来源、锁定版本及记录逐字节保留，不再向注册源查找宿主内置包，也不复制或重装其他插件。未知锁格式、歧义或跨包引用失败时保留旧安装。

19 项更新状态检查、8 项真实 pnpm／事务检查通过；另用本机清单的隔离副本验证仅解析知识库包能完成准备，原 profile 清单与锁未改动。保留回滚与崩溃恢复；真实设备安装及加载结果另记，不由准备成功推断。

2.4.12：本地依赖与自动更新准备（2026-11-05）

保留 2.4.11 的共享状态构建字段与旧接口确认修复。进一步修复更新准备阶段拒绝 profile 内相对路径本地插件的问题：将这些依赖复制到隔离的影子目录，使 pnpm 只处理影子清单；保持真实 profile 中其他插件的来源字符串及文件不变。拒绝越界、链接、元数据冲突和超过 64 MiB 的相对依赖，不复制运行知识库或凭据。

19 项状态确认检查、7 项真实 pnpm 与事务检查通过，覆盖本地依赖保留、越界拒绝、发布失败回滚和进程崩溃恢复。实际设备自动升级另行记录；下载成功、合成检查或磁盘包版本均不单独代表正在运行的新构建已经生效。

2.4.11：共享状态构建与自动更新确认（2026-11-05）

修复共享模式 POST status 缺少 build，而更新确认必须校验版本与构建号的问题。旧安装即使已经加载，也可能永久停在待确认。现在共享状态统一携带 Host 构建；客户端兼容从旧版 GET 状态读取构建，仍要求精确匹配，不按版本号单独确认。

19 项定向检查通过，新增原共享状态缺字段反例和旧接口兼容确认；保留安装锁、已准备事务续装及失败恢复限制。针对已被旧代码锁住的客户端，需要一次受控的兼容恢复才能重新进入自动流程；发布更新源本身不能修改正在运行的旧代码。恢复必须先验证旧请求与已安装构建，不得无条件清空客户端状态。真实用户升级结果单独记录，不把这些合成检查当作实机安装证明。

2.4.10：安装待确认状态恢复（2026-11-05）

修复核对不到旧安装回执时，界面永久停在待确认、安装按钮保持禁用的问题。核对流程增加磁盘安装构建、当前安全安装操作和 profile 写锁信息；只有宿主明确没有旧请求、安装操作及写锁均不活跃且当前安装可校验时，才解除旧请求。单纯等待时间变长或接口失败不能触发解除。

已准备但尚未开始的安全事务可继续原事务，不创建第二次准备或重复安装。目标文件已经写入而宿主仍运行旧构建时，显示保存工作并重启；正在安装、无法校验或损坏状态继续拒绝盲目重试。

17 项定向检查通过，覆盖失效旧请求、写锁与活动操作、缺失事务文件、已安装未加载、原事务续装及既有完成状态。没有对正式用户实例执行安装、删除客户端缓存或强制重启。

若旧版界面已经被待确认状态锁住，新修复尚无法加载：在 DSH 自身“设置 → 插件”中使用本版正式安装源更新一次，按宿主提示重新加载；不要在知识库的灰色按钮上反复尝试。详见升级恢复说明。

2.4.9：kb_flow 返回契约（2026-11-05）

修复共享模式 kb_flow 的返回结果缺少 action，导致宿主报 value.action 字段缺失的问题。共享服务与 Host 工具边界都按原请求补全动作；业务失败、断线与调用方校验失败也保留 action、原错误和成功状态，不放宽原输出校验，不把失败伪装成成功，不重放调用。

3 项定向测试通过，覆盖全部 8 种动作、实际注册的 Host 工具成功及失败返回，以及隔离真实 Windows 共享服务读取与业务失败。仅使用合成数据，没有重放正式用户流程。

另定位到记忆插件 1.0.4 在工具续步中仅从新输入查用户消息，可能以空快照替换已召回约定；该组件的 1.0.5 本地修复另行交付，不包含在此知识库包内，未公开发布或自动安装。合成课堂录音约定验证了持久保存、召回及解析完成后的上下文续接，未证明正式录音已自动生成笔记。

2.4.8：设置页的解析调用记录（2026-11-05）

修复共享服务把管理界面的只读请求当作普通会话的问题。设置页依据已认证连接的管理权限读取 OCR / ASR 执行任务和提交记录，不再按固定界面会话误过滤 Agent 发起的任务；资料可见性筛选仍然生效。普通模型工具和只读连接不因此获得跨会话管理权限，写接口仍要求管理授权。

3 项定向测试通过：在隔离的真实 Windows 共享服务中，由独立 Agent 会话调用本地合成 OCR / ASR 接口，设置页两种读取入口均能看到执行中、提交及完成后的记录；普通会话、只读连接与伪造参数不能越权。反例在修复前复现为空列表，修复后通过。样本和接口为合成数据，未读取正式知识库、调用外部付费服务或验证正式用户完整界面。

2.4.7：升级交接等待提示（2026-11-05）

交接期间保留稳定的知识库 API 入口，明确返回服务准备状态；界面显示“知识库服务准备中，请稍候…”，接口就绪后继续读取。只对服务明确确认尚未执行的请求等待后重新提交；真实 HTTP 405、断线及未知写入结果不自动重放。准备失败或等待超时仍提供错误与恢复说明，不把它们伪装为就绪。

19 项定向检查通过，包含真实本地 HTTP 路由准备、恢复后的写请求仅执行一次、失败与超时边界、旧服务交接和服务恢复。未额外重复完整功能回归；未对正式用户实例操作或声称完整界面实测。

2.4.6：2.4.3 直接自动升级与恢复（2026-11-05）

沿用本次验证的 2.4.3 直接安装、自然退出交接、条件错误提示和固定旧包恢复。补充 Windows 内置管理员 SID 别名的规范化校验，权限仍要求同一组明确的主体与授权。2.4.5 候选未通过发布环境校验，未创建正式 Release；保留其包字节，后续以 2.4.6 为自动更新目标。

Direct 2.4.3 upgrades, natural idle handoff, conditional recovery help and pinned legacy repair are retained. Windows SID aliases are normalized before exact ACL comparison. The unpublished 2.4.5 candidate is preserved; 2.4.6 is the follow-up distribution.

升级错误恢复说明 / Recovery instructions

升级报错后的手动恢复说明 / Upgrade error recovery

2.4.5：2.4.3 直接自动升级与旧服务交接（2026-11-05）

• 恢复正式自动更新入口，正常 2.4.3 可直接安装本版，不要求先手动安装过渡版本。
• 新版通过已发布 2.4.3 的精确运行时指纹识别旧服务；释放探测连接后等待旧服务按原有空闲机制自然退出，核对原进程出生标识和清理回执，再启动新服务。不向缺少停服协议的旧服务发送 shutdown，不终止其他连接或任务；超时显示恢复说明。
• 新版运行中的安装、事务恢复或交接确实报错时，才显示手动更新与恢复说明。2.4.3 若在首次 pnpm 安装阶段就失败，新代码尚未加载，仍使用旧版原错误界面；现有更新说明入口提供同一恢复文档，不能承诺旧界面具有新版弹窗。
• 手动恢复包可从固定摘要的公开 2.4.3 包重建受损代码目录，保留残留目录和原 profile 清单，再使用事务安装器升级；不清空知识库或解析记录。

验证使用真实公开 2.4.3 TGZ、Windows 上的运行服务与真实 pnpm，覆盖直接安装、自然退出后交接、原件保留及受损旧安装恢复；事务失败回退沿用并补验现有检查。验证范围不包含正式用户 profile 安装或完整 Electron 界面操作。旧 2.4.3 首次安装仍由宿主旧安装器执行，不能获得新版事务器在安装前的保护；异常时走恢复入口。旧更新源不能按客户端运行状态筛选，2.4.3 以外的旧版不属于本次定向保证。

2.4.4：Windows 安全更新与失败恢复（2026-11-05）

• pnpm 只在隔离的清单副本中准备锁文件；新包先完成摘要、构建号、路径和文件校验，不让包管理器改写在线插件目录。
• 更新前通过管理员授权的停服协议检查其他连接、排队及运行中的解析、导入和流程任务；忙碌时延后。停服后核对清理回执及进程退出，再切换完整包目录。
• 原插件目录和清单保留在私有事务目录；切换或清单写入失败时回退并逐文件校验。中途退出的安装可从持久事务记录恢复，不把未知结果标为成功，不重复发起安装。
• 2.4.4 使用 release-manifest-v2.json。旧 release-manifest.json 停用安装分发，阻断旧更新器继续走不安全的原地安装。2.4.3 及更早版本首次过渡须退出宿主及连接客户端，使用本版过渡安装包；旧服务不支持停服协议时自动路径会拒绝接管。
• 成功安装后明确提示重启生效。嵌入模式或缺少安全停服能力时保持旧版，暂不自动安装。包带额外依赖、相对本地依赖或旧包已不完整等不支持的情况均停止，不擅自重建用户配置。

验证：35 项 Node 定向检查、5 项真实文件系统/真实 pnpm 事务测试，以及 1 个 Windows 运行服务升级复合场景通过。复合场景包括原始 2.4.3 服务的拒绝接管、额外连接和排队任务的延后、使用旧目录 Python 的协议服务退出、真实 2.4.3 包切换失败后逐文件恢复、成功升级重启和虚构原件保留。具备新停服协议的服务升级与未修改旧服务的首次过渡是两条不同路径。本次未在正式用户 profile 安装，也未验证真实模型或完整 UI。

2.4.3：原件同步与 Windows 解析任务修复（2026-11-05）

• 合入文本原件与引用同步：归档文本参与检索，原件编辑后更新索引与引用范围；旧的自动生成镜像引用当前原件，独立撰写的摘要仍保留。
• 调整索引排除与恢复时的关联原件、派生记录及增量向量复用；修复含中文路径及版本化 Python 路径的 PDF 渲染。
• Windows 解析任务记录的读取和原子替换共用进程级队列，减少句柄重叠；外部占用有限重试，耗尽时保留旧记录并清理临时文件。
• 提交、重试和启动恢复的后台错误均被捕获；尽力保存失败状态，无法保存时明确报告，清理心跳和运行标记。

Windows 定向复验 73/73 通过（原有 68 项及新增 5 项故障测试）。测试使用虚构资料和请求替身，不证明真实 OCR/ASR 效果、自动 PDF/Office 索引同步、原生位置映射或完整桌面运行兼容性。客户端独立发布版本仍为 1.0.3，本次不重新发布客户端安装器。

历史记录 / Earlier releases

统一仓库源码 · 2026-11-04

2026-11-04 合仓时源码版本：客户端 1.0.1 / 插件 2.4.1。整合桌面工作区、共享内核与服务、可选记忆联动适配及现有安装器。两端后续统一维护于本仓库。该次文档更新未发布二进制 Release，当时公开插件清单为 2.3.1。后续历史条目除另有说明外均为插件记录。客户端版本说明。

2.3.1：收件箱提示词与任务状态修复（2026-11-03）

• 收件箱整理只发送“帮我整理并归档收件箱内文件”，不再附加流程及目录说明。
• OCR/ASR 任务记录使用静默后台刷新，合并同时发生的刷新请求，保留列表位置及详情展开状态。
• 知识库会话的命令工具漏传显示说明时补全说明；保留原有参数校验、工具可见范围及权限拒绝。
• 会话计划增加逐步更新规则及每轮一次的结束前核对。会话停止后旧的进行中步骤显示为未确认完成，完成数仍以实际待办记录为准。

验证包括定向自动检查、已安装 DSH 工具调度器的合成执行，以及 Edge 中的任务刷新和待办状态场景。权限拒绝及工具限制仍生效。正式桌面安装、真实模型对整项任务的完成质量及真实云端 OCR/ASR 未验证；会话结束不会自动把待办改为成功。

2.3.0 同版本修复：收件箱迁移与一键整理（2026-10-31）

简体中文 · English

• 桌面收件箱直接扫描当前知识库的 90-收件箱/。拖入或选择文件后迁移原件到该目录，不再通过快速收集的 Base64 上传接口，也不再受其 8 MiB 限制或依赖收集记录。同名文件追加编号；跨盘先复制并校验，再移除源文件；失败时保留源文件。手机快速收集页仍沿用上传限制。
• 修复“一键整理”选模时的 remote.session 依赖注入错误，检查模型选择返回结果，失败时不发送任务。错误提示区分“任务尚未发送”和“发送结果未确认”，不自动重试。
• 一键整理只发送“整理并归档收件箱内的文件。”；执行规则由知识库 Agent 与插件提供。用户所选模型与 High 推理强度继续生效。

版本号保持 2.3.0，本次更新仓库源码和配套安装包，不移动已有 v2.3.0 标签或替换其 Release 附件。8 项定向测试及流程探针通过；使用虚构资料和宿主服务替身，未安装到正式 DSH 或调用真实模型。

2.3.0 正式版：统一桌面界面（2026-10-30）

简体中文 · English

• 修正普通桌面宿主中知识库 Agent 的 OCR / ASR 被误拒绝：没有 H1 时按活的知识库根会话或实时委派授权校验，可正常提交解析；显式 parse.allowWithoutIsolation:false 仍要求 H1，已启用但未就绪的 H1 不回退。独立流程工作区中的已授权知识库会话可解析当前绑定库的原件。来源授权入口保留实际拒绝代码与原因，避免把隔离环境问题误报为缺少知识库权限。6 项定向检查通过，包括虚构原件经本机模拟 OCR / ASR 服务提交和读取结果；未调用真实模型。

• OCR / ASR 每条提交记录新增“查看详情”，包括被拒绝的提交：展示原始失败说明与代码、请求编号、时间、来源文件、发起会话 / Agent / 预设与授权入口、知识库编号及关联任务；有执行任务时可继续查看任务详情和结果预览。旧记录缺失的信息明确标注未记录。

• OCR / ASR 提交记录明确...

2.5.6 · 个人知识库插件

插件 2.5.6 · 历史会话记忆联动

知识库桥接按历史会话已保存的归属读取联动记忆。副库断开时返回明确状态。配合 DSH Memory 1.0.12 使用。桌面客户端继续使用 1.1.2。

插件 2.5.5 / 客户端 1.1.2：共库兼容与手动更新（2026-11-07）

修复打开客户端时因插件构建指纹不同而提示“其他版本在线”的问题。构建指纹保留用于诊断；共享服务改为核对协议主版本、完整接口契约指纹、存储和引擎兼容代次及调用方必需能力。已核验的公开插件 2.5.3 / 2.5.4 服务可被新版客户端复用，不要求关闭正在运行的 DSH，不启动第二个写入者。未知旧构建、缺少能力或确实不兼容的服务仍保留安全交接限制。未来不兼容的存储或引擎语义变更必须提升兼容代次，不能只沿用原标记。

客户端“帮助 → 更新与手动安装”增加“手动更新 · 下载并校验”“启动已校验的安装程序”及官方下载页入口。允许复用已校验缓存，启动前再次核对大小与 SHA-256；不接受界面传入任意程序路径。保存并关闭客户端后按安装器提示完成安装，自动原位覆盖安装仍未实现。原有自动检查和校验下载保留。

30 项定向检查通过，包含真实 Windows 共享服务、原旧连接反例、不同构建双向接入、一个写入者、原件字节保持、安全停服恢复和手动更新包损坏拒绝。发布包另核对源码、分片和客户端内嵌插件摘要。测试使用虚构库；真实用户库仅通过既有授权服务核对连接状态，不读取正文，不执行知识库迁移或收费模型调用。实际安装与界面加载结果另记。

插件 2.5.4：更新下载与失败提示修复（2026-11-07）

修复版本清单可读、安装包却下载失败的问题。Gitee 大二进制 raw 地址可能拒绝访问，GitCode 同步可能滞后，GitHub raw 在部分网络下不可达。现在支持国内镜像的小文本分片下载，按发布摘要定位固定分片路径，最多三个并发，组装后执行完整的大小、SHA-256 和插件格式校验；另增加固定的 GitHub Pages 和 Release 下载备用入口，不接受清单提供的任意地址。

大文件改用传输空闲超时，持续收到数据时不再被原有 20 秒总超时中断，同时保留五分钟总时限。关闭失败提示后，同一次失败的关闭状态在界面切换、组件重挂载与本次页面会话内保留；手动重试产生的新失败仍可提示。

36 项定向测试通过，覆盖分片重组、摘要损坏、编码与恶意跳转拒绝、并发上限、慢速持续传输及关闭状态恢复。样例使用正式发布包和虚构状态，不连接真实知识库或付费模型。客户端独立版本仍为 1.1.1，本次只发布插件；程序更新不执行知识库迁移。旧版更新器无法识别分片，遇到同样问题可使用已校验的本地 TGZ 安装；本机已准备对应更新缓存。

插件 2.5.3 / 客户端 1.1.1（2026-11-07）

本次统一发布此前本地交付的原件索引架构及后续修正，两端继续使用同一共享内核与服务，独立安装、独立版本。

• 原件保持原位；索引层记录身份、路径、分类、标签与指纹。插件和客户端提供迁移预览与确认入口，程序更新不会自动迁移资料库。
• 客户端增加原件分类文件树及分类操作，分类与隐私筛选由共享服务执行；既有文件、绑定及资料库身份保留。
• 流程卡保存模型与推理配置，运行使用已保存配置；内置收件箱仍要求 High。自定义流程准备不再误入内置收件箱校验。
• 任务计划面板修正宽度和向上展开方向；长工具执行期间提示模型核对进度，由模型依据实际结果更新状态。
• 成品登记说明明确支持复用系列目录：task 填系列目录名，title 填单期标题，path 填库内相对路径。无需按日期拆目录，路径与隐私校验继续生效。

本次验证使用虚构库与针对性检查，发布包核对源码、构建指纹和摘要；不读取真实私有库，不调用收费模型。历史验收记录保留其当时范围；本次打包不代表正式用户安装、DSH 重启激活、真实报告生成或外部发送已经验证。客户端自动覆盖安装与激活尚未接入。

安装：插件使用 v2.5.3 Release 中的 TGZ；客户端使用 client-v1.1.1 Release 中的 Windows x64 Setup.exe（未签名），分别核对清单与 SHA-256。客户端安装目录需为空，先保存工作并退出旧客户端；DSH 插件按宿主提示重新加载或完全退出含托盘后重开，核对版本和构建号。旧 2.4.6 更新受阻时仍使用既有恢复入口。

2.5.x：任务计划面板宽度修复（源码补丁，未发布，2026-11-06）

任务计划面板沿用官方 composer 的宽度与居中公式，补齐 border-box 和 CSS 变量兜底；变量缺失时卡片上限取 952px，面板上限取 920px，极窄容器下计算宽度不小于零。保留原有边框、圆角、字号、默认收起、状态映射及隐藏官方面板的规则。未根据未经测量的状态滞后报告修改状态源、文案或 Host 收尾核对机制。

独立源码修改后运行 python -X utf8 tools/sync-todo-lifecycle-client.py 同步 index.js 的标记区块，再运行 node --test tests/todo-lifecycle.test.mjs。本次未变更 package.json 版本、未生成安装包或修改发布清单；发布时仍须按 VERSIONING.md 选择新版本，并通过既有打包流程重新计算构建指纹与摘要。测量范围和缺口见 面板验收记录。

2.5.0：原件索引架构（本地交付，2026-11-06）

插件与客户端新增同名“迁移到索引架构”入口，共用预览、确认、文件目录和分类。原件保持原位；索引层登记文件身份、位置、分类和指纹，不保存分类正文副本。迁移后全文索引写入索引层，原地接入和收件箱分类直接登记原件。

识别旧机器引用并在检索中去重，保留用户独立笔记。文件修改、可核验改名及缺失由维护更新；预览后文件变化、原件缺失或链接路径会阻止发布。已有规则、模板和目录保留，原目录补齐功能标为可选。既有库身份和授权事务元数据继续使用 .kbmeta，不执行全量元数据搬迁。

隔离检查覆盖迁移保护、原件检索、分类、文件变化、索引失败待完成及 Windows 两端独立/共享访问；Electron 中验证设置入口、预览确认、启用状态与保存分类。未对真实私有库执行迁移，未验证真实模型或所有二进制正文解析。详见 原件索引架构。本次为本地交付，尚未发布到远程更新源。

2.4.14：旧库框架迁移（2026-11-05）

新增“版本与诊断 → 旧库框架迁移”：先只读预览，再确认补齐缺失的标准目录、条目模板和框架管理说明。已有资料位置、自定义目录、AGENTS 正文、人工 INDEX 和不同内容的模板保留；可查看新版参考。迁移不自动搬移资料、重写笔记或调用模型。

预览绑定知识库身份与文件快照；状态改变、同名类型冲突或链接路径时停止。写入失败只撤销可核对的本次新增文件和空目录；用户后续修改保留并提示恢复。共享服务校验管理授权，机制版本改为实际核心版本。

7 项迁移/界面定向检查和 2 项既有托管升级检查通过，包含真实 Windows 共享服务与 EPERM 恢复。发布包完整性与升级加载另做必要检查。未对真实用户库执行迁移，未验证完整 Electron 界面或模型调用。程序更新与旧库框架迁移分别执行，旧更新器受阻限制继续适用。

2.4.6 升级范围补充（2026-11-05）

原版 2.4.6 的旧回执确认会在下载新包前阻断更新，旧准备器还可能重新解析其他宿主依赖。仅发布 2.4.13 或过渡包不能修复已经运行的旧代码；本机经过单次兼容恢复后成功，不代表其他原版用户均能零操作升级。

现提供独立的 2.4.6 通用升级恢复入口，校验公开原包后事务安装未改动的正式 2.4.13，支持自动发现单一 profile 或明确选择其他 profile。它是一次性外部恢复，不是静默自动升级。4 项 Windows 入口/真实 pnpm 检查和 2 项旧客户端边界检查通过，覆盖其他依赖保持、提交 EPERM 回滚、忙碌拒绝、多 profile 选择和独立 Python。历史安全事务不匹配仍可能阻止后续安装，不能宣称通用零操作自动迁移已经完成；这需要 DSH 宿主独立恢复通道。

2.4.13：更新不再重解析宿主依赖（2026-11-05）

安全更新只在独立解析目录中解析无依赖的知识库包，将其 importer、package、snapshot 三组记录合并到原 pnpm v9 锁文件。其他插件的来源、锁定版本及记录逐字节保留，不再向注册源查找宿主内置包，也不复制或重装其他插件。未知锁格式、歧义或跨包引用失败时保留旧安装。

19 项更新状态检查、8 项真实 pnpm／事务检查通过；另用本机清单的隔离副本验证仅解析知识库包能完成准备，原 profile 清单与锁未改动。保留回滚与崩溃恢复；真实设备安装及加载结果另记，不由准备成功推断。

2.4.12：本地依赖与自动更新准备（2026-11-05）

保留 2.4.11 的共享状态构建字段与旧接口确认修复。进一步修复更新准备阶段拒绝 profile 内相对路径本地插件的问题：将这些依赖复制到隔离的影子目录，使 pnpm 只处理影子清单；保持真实 profile 中其他插件的来源字符串及文件不变。拒绝越界、链接、元数据冲突和超过 64 MiB 的相对依赖，不复制运行知识库或凭据。

19 项状态确认检查、7 项真实 pnpm 与事务检查通过，覆盖本地依赖保留、越界拒绝、发布失败回滚和进程崩溃恢复。实际设备自动升级另行记录；下载成功、合成检查或磁盘包版本均不单独代表正在运行的新构建已经生效。

2.4.11：共享状态构建与自动更新确认（2026-11-05）

修复共享模式 POST status 缺少 build，而更新确认必须校验版本与构建号的问题。旧安装即使已经加载，也可能永久停在待确认。现在共享状态统一携带 Host 构建；客户端兼容从旧版 GET 状态读取构建，仍要求精确匹配，不按版本号单独确认。

19 项定向检查通过，新增原共享状态缺字段反例和旧接口兼容确认；保留安装锁、已准备事务续装及失败恢复限制。针对已被旧代码锁住的客户端，需要一次受控的兼容恢复才能重新进入自动流程；发布更新源本身不能修改正在运行的旧代码。恢复必须先验证旧请求与已安装构建，不得无条件清空客户端状态。真实用户升级结果单独记录，不把这些合成检查当作实机安装证明。

2.4.10：安装待确认状态恢复（2026-11-05）

修复核对不到旧安装回执时，界面永久停在待确认、安装按钮保持禁用的问题。核对流程增加磁盘安装构建、当前安全安装操作和 profile 写锁信息；只有宿主明确没有旧请求、安装操作及写锁均不活跃且当前安装可校验时，才解除旧请求。单纯等待时间变长或接口失败不能触发解除。

已准备但尚未开始的安全事务可继续原事务，不创建第二次准备或重复安装。目标文件已经写入而宿主仍运行旧构建时，显示保存工作并重启；正在安装、无法校验或损坏状态继续拒绝盲目重试。

17 项定向检查通过，覆盖失效旧请求、写锁与活动操作、缺失事务文件、已安装未加载、原事务续装及既有完成状态。没有对正式用户实例执行安装、删除客户端缓存或强制重启。

若旧版界面已经被待确认状态锁住，新修复尚无法加载：在 DSH 自身“设置 → 插件”中使用本版正式安装源更新一次，按宿主提示重新加载；不要在知识库的灰色按钮上反复尝试。详见升级恢复说明。

2.4.9：kb_flow 返回契约（2026-11-05）

修复共享模式 kb_flow 的返回结果缺少 action，导致宿主报 value.action 字段缺失的问题。共享服务与 Host 工具边界都按原请求补全动作；业务失败、断线与调用方校验失败也保留 action、原错误和成功状态，不放宽原输出校验，不把失败伪装成成功，不重放调用。

3 项定向测试通过，覆盖全部 8 种动作、实际注册的 Host 工具成功及失败返回，以及隔离真实 Windows 共享服务读取与业务失败。仅使用合成数据，没有重放正式用户流程。

另定位到记忆插件 1.0.4 在工具续步中仅从新输入查用户消息，可能以空快照替换已召回约定；该组件的 1.0.5 本地修复另行交付，不包含在此知识库包内，未公开发布或自动安装。合成课堂录音约定验证了持久保存、召回及解析完成后的上下文续接，未证明正式录音已自动生成笔记。

2.4.8：设置页的解析调用记录（2026-11-05）

修复共享服务把管理界面的只读请求当作普通会话的问题。设置页依据已认证连接的管理权限读取 OCR / ASR 执行任务和提交记录，不再按固定界面会话误过滤 Agent 发起的任务；资料可见性筛选仍然生效。普通模型工具和只读连接不因此获得跨会话管理权限，写接口仍要求管理授权。

3 项定向测试通过：在隔离的真实 Windows 共享服务中，由独立 Agent 会话调用本地合成 OCR / ASR 接口，设置页两种读取入口均能看到执行中、提交及完成后的记录；普通会话、只读连接与伪造参数不能越权。反例在修复前复现为空列表，修复后通过。样本和接口为合成数据，未读取正式知识库、调用外部付费服务或验证正式用户完整界面。

2.4.7：升级交接等待提示（2026-11-05）

交接期间保留稳定的知识库 API 入口，明确返回服务准备状态；界面显示“知识库服务准备中，请稍候…”，接口就绪后继续读取。只对服务明确确认尚未执行的请求等待后重新提交；真实 HTTP 405、断线及未知写入结果不自动重放。准备失败或等待超时仍提供错误与恢复说明，不把它们伪装为就绪。

19 项定向检查通过，包含真实本地 HTTP 路由准备、恢复后的写请求仅执行一次、失败与超时边界、旧服务交接和服务恢复。未额外重复完整功能回归；未对正式用户实例操作或声称完整界面实测。

2.4.6：2.4.3 直接自动升级与恢复（2026-11-05）

沿用本次验证的 2.4.3 直接安装、自然退出交接、条件错误提示和固定旧包恢复。补充 Windows 内置管理员 SID 别名的规范化校验，权限仍要求同一组明确的主体与授权。2.4.5 候选未通过发布环境校验，未创建正式 Release；保留其包字节，后续以 2.4.6 为自动更新目标。

Direct 2.4.3 upgrades, natural idle handoff, conditional recovery help and pinned legacy repair are retained. Windows SID aliases are normalized before exact ACL comparison. The unpublished 2.4.5 candidate is preserved; 2.4.6 is the follow-up distribution.

升级错误恢复说明 / Recovery instructions

升级报错后的手动恢复说明 / Upgrade error recovery

2.4.5：2.4.3 直接自动升级与旧服务交接（2026-11-05）

• 恢复正式自动更新入口，正常 2.4.3 可直接安装本版，不要求先手动安装过渡版本。
• 新版通过已发布 2.4.3 的精确运行时指纹识别旧服务；释放探测连接后等待旧服务按原有空闲机制自然退出，核对原进程出生标识和清理回执，再启动新服务。不向缺少停服协议的旧服务发送 shutdown，不终止其他连接或任务；超时显示恢复说明。
• 新版运行中的安装、事务恢复或交接确实报错时，才显示手动更新与恢复说明。2.4.3 若在首次 pnpm 安装阶段就失败，新代码尚未加载，仍使用旧版原错误界面；现有更新说明入口提供同一恢复文档，不能承诺旧界面具有新版弹窗。
• 手动恢复包可从固定摘要的公开 2.4.3 包重建受损代码目录，保留残留目录和原 profile 清单，再使用事务安装器升级；不清空知识库或解析记录。

验证使用真实公开 2.4.3 TGZ、Windows 上的运行服务与真实 pnpm，覆盖直接安装、自然退出后交接、原件保留及受损旧安装恢复；事务失败回退沿用并补验现有检查。验证范围不包含正式用户 profile 安装或完整 Electron 界面操作。旧 2.4.3 首次安装仍由宿主旧安装器执行，不能获得新版事务器在安装前的保护；异常时走恢复入口。旧更新源不能按客户端运行状态筛选，2.4.3 以外的旧版不属于本次定向保证。

2.4.4：Windows 安全更新与失败恢复（2026-11-05）

• pnpm 只在隔离的清单副本中准备锁文件；新包先完成摘要、构建号、路径和文件校验，不让包管理器改写在线插件目录。
• 更新前通过管理员授权的停服协议检查其他连接、排队及运行中的解析、导入和流程任务；忙碌时延后。停服后核对清理回执及进程退出，再切换完整包目录。
• 原插件目录和清单保留在私有事务目录；切换或清单写入失败时回退并逐文件校验。中途退出的安装可从持久事务记录恢复，不把未知结果标为成功，不重复发起安装。
• 2.4.4 使用 release-manifest-v2.json。旧 release-manifest.json 停用安装分发，阻断旧更新器继续走不安全的原地安装。2.4.3 及更早版本首次过渡须退出宿主及连接客户端，使用本版过渡安装包；旧服务不支持停服协议时自动路径会拒绝接管。
• 成功安装后明确提示重启生效。嵌入模式或缺少安全停服能力时保持旧版，暂不自动安装。包带额外依赖、相对本地依赖或旧包已不完整等不支持的情况均停止，不擅自重建用户配置。

验证：35 项 Node 定向检查、5 项真实文件系统/真实 pnpm 事务测试，以及 1 个 Windows 运行服务升级复合场景通过。复合场景包括原始 2.4.3 服务的拒绝接管、额外连接和排队任务的延后、使用旧目录 Python 的协议服务退出、真实 2.4.3 包切换失败后逐文件恢复、成功升级重启和虚构原件保留。具备新停服协议的服务升级与未修改旧服务的首次过渡是两条不同路径。本次未在正式用户 profile 安装，也未验证真实模型或完整 UI。

2.4.3：原件同步与 Windows 解析任务修复（2026-11-05）

• 合入文本原件与引用同步：归档文本参与检索，原件编辑后更新索引与引用范围；旧的自动生成镜像引用当前原件，独立撰写的摘要仍保留。
• 调整索引排除与恢复时的关联原件、派生记录及增量向量复用；修复含中文路径及版本化 Python 路径的 PDF 渲染。
• Windows 解析任务记录的读取和原子替换共用进程级队列，减少句柄重叠；外部占用有限重试，耗尽时保留旧记录并清理临时文件。
• 提交、重试和启动恢复的后台错误均被捕获；尽力保存失败状态，无法保存时明确报告，清理心跳和运行标记。

Windows 定向复验 73/73 通过（原有 68 项及新增 5 项故障测试）。测试使用虚构资料和请求替身，不证明真实 OCR/ASR 效果、自动 PDF/Office 索引同步、原生位置映射或完整桌面运行兼容性。客户端独立发布版本仍为 1.0.3，本次不重新发布客户端安装器。

历史记录 / Earlier releases

统一仓库源码 · 2026-11-04

2026-11-04 合仓时源码版本：客户端 1.0.1 / 插件 2.4.1。整合桌面工作区、共享内核与服务、可选记忆联动适配及现有安装器。两端后续统一维护于本仓库。该次文档更新未发布二进制 Release，当时公开插件清单为 2.3.1。后续历史条目除另有说明外均为插件记录。客户端版本说明。

2.3.1：收件箱提示词与任务状态修复（2026-11-03）

• 收件箱整理只发送“帮我整理并归档收件箱内文件”，不再附加流程及目录说明。
• OCR/ASR 任务记录使用静默后台刷新，合并同时发生的刷新请求，保留列表位置及详情展开状态。
• 知识库会话的命令工具漏传显示说明时补全说明；保留原有参数校验、工具可见范围及权限拒绝。
• 会话计划增加逐步更新规则及每轮一次的结束前核对。会话停止后旧的进行中步骤显示为未确认完成，完成数仍以实际待办记录为准。

验证包括定向自动检查、已安装 DSH 工具调度器的合成执行，以及 Edge 中的任务刷新和待办状态场景。权限拒绝及工具限制仍生效。正式桌面安装、真实模型对整项任务的完成质量及真实云端 OCR/ASR 未验证；会话结束不会自动把待办改为成功。

2.3.0 同版本修复：收件箱迁移与一键整理（2026-10-31）

简体中文 · English

• 桌面收件箱直接扫描当前知识库的 90-收件箱/。拖入或选择文件后迁移原件到该目录，不再通过快速收集的 Base64 上传接口，也不再受其 8 MiB 限制或依赖收集记录。同名文件追加编号；跨盘先复制并校验，再移除源文件；失败时保留源文件。手机快速收集页仍沿用上传限制。
• 修复“一键整理”选模时的 remote.session 依赖注入错误，检查模型选择返回结果，失败时不发送任务。错误提示区分“任务尚未发送”和“发送结果未确认”，不自动重试。
• 一键整理只发送“整理并归档收件箱内的文件。”；执行规则由知识库 Agent 与插件提供。用户所选模型与 High 推理强度继续生效。

版本号保持 2.3.0，本次更新仓库源码和配套安装包，不移动已有 v2.3.0 标签或替换其 Release 附件。8 项定向测试及流程探针通过；使用虚构资料和宿主服务替身，未安装到正式 DSH 或调用真实模型。

2.3.0 正式版：统一桌面界面（2026-10-30）

简体中文 · English

• 修正普通桌面宿主中知识库 Agent 的 OCR / ASR 被误拒绝：没有 H1 时按活的知识库根会话或实时委派授权校验，可正常提交解析；显式 parse.allowWithoutIsolation:false 仍要求 H1，已启用但未就绪的 H1 不回退。独立流程工作区中的已授权知识库会话可解析当前绑定库的原件。来源授权入口保留实际拒绝代码与原因，避免把隔离环境问题误报为缺少知识库权限。6 项定向检查通过，包括虚构原件经本机模拟 OCR / ASR 服务提交和读取结果；未调用真实模型。

• OCR / ASR 每条提交记录新增“查看详情”，包括被拒绝的提交：展示原始失败说明与代码、请求编号、时间、来源文件、发起会话 / Agent / 预设与授权入口、知识库编号及关联任务；有执行任务时可继续查看任务详情和结果预览。旧记录缺失的信息明确标注未记录。

• OCR / ASR 提交记录明确标注为“当次”结果；历史拒绝可展开查看当时的原始说明，避免被误解成当前无法查看任务记录。旧记录中的权限错误可能来自旧版对隔离环境失败的笼统提示。

• 修正桌面宿主设置弹窗中的布局冲突：内容区较窄时分类导航移至上方并自动换行，设置表单占满下方，宽页面保留左...

2.5.5 · 个人知识库插件

插件 2.5.5 / 客户端 1.1.2：共库兼容与手动更新（2026-11-07）

修复打开客户端时因插件构建指纹不同而提示“其他版本在线”的问题。构建指纹保留用于诊断；共享服务改为核对协议主版本、完整接口契约指纹、存储和引擎兼容代次及调用方必需能力。已核验的公开插件 2.5.3 / 2.5.4 服务可被新版客户端复用，不要求关闭正在运行的 DSH，不启动第二个写入者。未知旧构建、缺少能力或确实不兼容的服务仍保留安全交接限制。未来不兼容的存储或引擎语义变更必须提升兼容代次，不能只沿用原标记。

客户端“帮助 → 更新与手动安装”增加“手动更新 · 下载并校验”“启动已校验的安装程序”及官方下载页入口。允许复用已校验缓存，启动前再次核对大小与 SHA-256；不接受界面传入任意程序路径。保存并关闭客户端后按安装器提示完成安装，自动原位覆盖安装仍未实现。原有自动检查和校验下载保留。

30 项定向检查通过，包含真实 Windows 共享服务、原旧连接反例、不同构建双向接入、一个写入者、原件字节保持、安全停服恢复和手动更新包损坏拒绝。发布包另核对源码、分片和客户端内嵌插件摘要。测试使用虚构库；真实用户库仅通过既有授权服务核对连接状态，不读取正文，不执行知识库迁移或收费模型调用。实际安装与界面加载结果另记。

插件 2.5.4：更新下载与失败提示修复（2026-11-07）

修复版本清单可读、安装包却下载失败的问题。Gitee 大二进制 raw 地址可能拒绝访问，GitCode 同步可能滞后，GitHub raw 在部分网络下不可达。现在支持国内镜像的小文本分片下载，按发布摘要定位固定分片路径，最多三个并发，组装后执行完整的大小、SHA-256 和插件格式校验；另增加固定的 GitHub Pages 和 Release 下载备用入口，不接受清单提供的任意地址。

大文件改用传输空闲超时，持续收到数据时不再被原有 20 秒总超时中断，同时保留五分钟总时限。关闭失败提示后，同一次失败的关闭状态在界面切换、组件重挂载与本次页面会话内保留；手动重试产生的新失败仍可提示。

36 项定向测试通过，覆盖分片重组、摘要损坏、编码与恶意跳转拒绝、并发上限、慢速持续传输及关闭状态恢复。样例使用正式发布包和虚构状态，不连接真实知识库或付费模型。客户端独立版本仍为 1.1.1，本次只发布插件；程序更新不执行知识库迁移。旧版更新器无法识别分片，遇到同样问题可使用已校验的本地 TGZ 安装；本机已准备对应更新缓存。

插件 2.5.3 / 客户端 1.1.1（2026-11-07）

本次统一发布此前本地交付的原件索引架构及后续修正，两端继续使用同一共享内核与服务，独立安装、独立版本。

• 原件保持原位；索引层记录身份、路径、分类、标签与指纹。插件和客户端提供迁移预览与确认入口，程序更新不会自动迁移资料库。
• 客户端增加原件分类文件树及分类操作，分类与隐私筛选由共享服务执行；既有文件、绑定及资料库身份保留。
• 流程卡保存模型与推理配置，运行使用已保存配置；内置收件箱仍要求 High。自定义流程准备不再误入内置收件箱校验。
• 任务计划面板修正宽度和向上展开方向；长工具执行期间提示模型核对进度，由模型依据实际结果更新状态。
• 成品登记说明明确支持复用系列目录：task 填系列目录名，title 填单期标题，path 填库内相对路径。无需按日期拆目录，路径与隐私校验继续生效。

本次验证使用虚构库与针对性检查，发布包核对源码、构建指纹和摘要；不读取真实私有库，不调用收费模型。历史验收记录保留其当时范围；本次打包不代表正式用户安装、DSH 重启激活、真实报告生成或外部发送已经验证。客户端自动覆盖安装与激活尚未接入。

安装：插件使用 v2.5.3 Release 中的 TGZ；客户端使用 client-v1.1.1 Release 中的 Windows x64 Setup.exe（未签名），分别核对清单与 SHA-256。客户端安装目录需为空，先保存工作并退出旧客户端；DSH 插件按宿主提示重新加载或完全退出含托盘后重开，核对版本和构建号。旧 2.4.6 更新受阻时仍使用既有恢复入口。

2.5.x：任务计划面板宽度修复（源码补丁，未发布，2026-11-06）

任务计划面板沿用官方 composer 的宽度与居中公式，补齐 border-box 和 CSS 变量兜底；变量缺失时卡片上限取 952px，面板上限取 920px，极窄容器下计算宽度不小于零。保留原有边框、圆角、字号、默认收起、状态映射及隐藏官方面板的规则。未根据未经测量的状态滞后报告修改状态源、文案或 Host 收尾核对机制。

独立源码修改后运行 python -X utf8 tools/sync-todo-lifecycle-client.py 同步 index.js 的标记区块，再运行 node --test tests/todo-lifecycle.test.mjs。本次未变更 package.json 版本、未生成安装包或修改发布清单；发布时仍须按 VERSIONING.md 选择新版本，并通过既有打包流程重新计算构建指纹与摘要。测量范围和缺口见 面板验收记录。

2.5.0：原件索引架构（本地交付，2026-11-06）

插件与客户端新增同名“迁移到索引架构”入口，共用预览、确认、文件目录和分类。原件保持原位；索引层登记文件身份、位置、分类和指纹，不保存分类正文副本。迁移后全文索引写入索引层，原地接入和收件箱分类直接登记原件。

识别旧机器引用并在检索中去重，保留用户独立笔记。文件修改、可核验改名及缺失由维护更新；预览后文件变化、原件缺失或链接路径会阻止发布。已有规则、模板和目录保留，原目录补齐功能标为可选。既有库身份和授权事务元数据继续使用 .kbmeta，不执行全量元数据搬迁。

隔离检查覆盖迁移保护、原件检索、分类、文件变化、索引失败待完成及 Windows 两端独立/共享访问；Electron 中验证设置入口、预览确认、启用状态与保存分类。未对真实私有库执行迁移，未验证真实模型或所有二进制正文解析。详见 原件索引架构。本次为本地交付，尚未发布到远程更新源。

2.4.14：旧库框架迁移（2026-11-05）

新增“版本与诊断 → 旧库框架迁移”：先只读预览，再确认补齐缺失的标准目录、条目模板和框架管理说明。已有资料位置、自定义目录、AGENTS 正文、人工 INDEX 和不同内容的模板保留；可查看新版参考。迁移不自动搬移资料、重写笔记或调用模型。

预览绑定知识库身份与文件快照；状态改变、同名类型冲突或链接路径时停止。写入失败只撤销可核对的本次新增文件和空目录；用户后续修改保留并提示恢复。共享服务校验管理授权，机制版本改为实际核心版本。

7 项迁移/界面定向检查和 2 项既有托管升级检查通过，包含真实 Windows 共享服务与 EPERM 恢复。发布包完整性与升级加载另做必要检查。未对真实用户库执行迁移，未验证完整 Electron 界面或模型调用。程序更新与旧库框架迁移分别执行，旧更新器受阻限制继续适用。

2.4.6 升级范围补充（2026-11-05）

原版 2.4.6 的旧回执确认会在下载新包前阻断更新，旧准备器还可能重新解析其他宿主依赖。仅发布 2.4.13 或过渡包不能修复已经运行的旧代码；本机经过单次兼容恢复后成功，不代表其他原版用户均能零操作升级。

现提供独立的 2.4.6 通用升级恢复入口，校验公开原包后事务安装未改动的正式 2.4.13，支持自动发现单一 profile 或明确选择其他 profile。它是一次性外部恢复，不是静默自动升级。4 项 Windows 入口/真实 pnpm 检查和 2 项旧客户端边界检查通过，覆盖其他依赖保持、提交 EPERM 回滚、忙碌拒绝、多 profile 选择和独立 Python。历史安全事务不匹配仍可能阻止后续安装，不能宣称通用零操作自动迁移已经完成；这需要 DSH 宿主独立恢复通道。

2.4.13：更新不再重解析宿主依赖（2026-11-05）

安全更新只在独立解析目录中解析无依赖的知识库包，将其 importer、package、snapshot 三组记录合并到原 pnpm v9 锁文件。其他插件的来源、锁定版本及记录逐字节保留，不再向注册源查找宿主内置包，也不复制或重装其他插件。未知锁格式、歧义或跨包引用失败时保留旧安装。

19 项更新状态检查、8 项真实 pnpm／事务检查通过；另用本机清单的隔离副本验证仅解析知识库包能完成准备，原 profile 清单与锁未改动。保留回滚与崩溃恢复；真实设备安装及加载结果另记，不由准备成功推断。

2.4.12：本地依赖与自动更新准备（2026-11-05）

保留 2.4.11 的共享状态构建字段与旧接口确认修复。进一步修复更新准备阶段拒绝 profile 内相对路径本地插件的问题：将这些依赖复制到隔离的影子目录，使 pnpm 只处理影子清单；保持真实 profile 中其他插件的来源字符串及文件不变。拒绝越界、链接、元数据冲突和超过 64 MiB 的相对依赖，不复制运行知识库或凭据。

19 项状态确认检查、7 项真实 pnpm 与事务检查通过，覆盖本地依赖保留、越界拒绝、发布失败回滚和进程崩溃恢复。实际设备自动升级另行记录；下载成功、合成检查或磁盘包版本均不单独代表正在运行的新构建已经生效。

2.4.11：共享状态构建与自动更新确认（2026-11-05）

修复共享模式 POST status 缺少 build，而更新确认必须校验版本与构建号的问题。旧安装即使已经加载，也可能永久停在待确认。现在共享状态统一携带 Host 构建；客户端兼容从旧版 GET 状态读取构建，仍要求精确匹配，不按版本号单独确认。

19 项定向检查通过，新增原共享状态缺字段反例和旧接口兼容确认；保留安装锁、已准备事务续装及失败恢复限制。针对已被旧代码锁住的客户端，需要一次受控的兼容恢复才能重新进入自动流程；发布更新源本身不能修改正在运行的旧代码。恢复必须先验证旧请求与已安装构建，不得无条件清空客户端状态。真实用户升级结果单独记录，不把这些合成检查当作实机安装证明。

2.4.10：安装待确认状态恢复（2026-11-05）

修复核对不到旧安装回执时，界面永久停在待确认、安装按钮保持禁用的问题。核对流程增加磁盘安装构建、当前安全安装操作和 profile 写锁信息；只有宿主明确没有旧请求、安装操作及写锁均不活跃且当前安装可校验时，才解除旧请求。单纯等待时间变长或接口失败不能触发解除。

已准备但尚未开始的安全事务可继续原事务，不创建第二次准备或重复安装。目标文件已经写入而宿主仍运行旧构建时，显示保存工作并重启；正在安装、无法校验或损坏状态继续拒绝盲目重试。

17 项定向检查通过，覆盖失效旧请求、写锁与活动操作、缺失事务文件、已安装未加载、原事务续装及既有完成状态。没有对正式用户实例执行安装、删除客户端缓存或强制重启。

若旧版界面已经被待确认状态锁住，新修复尚无法加载：在 DSH 自身“设置 → 插件”中使用本版正式安装源更新一次，按宿主提示重新加载；不要在知识库的灰色按钮上反复尝试。详见升级恢复说明。

2.4.9：kb_flow 返回契约（2026-11-05）

修复共享模式 kb_flow 的返回结果缺少 action，导致宿主报 value.action 字段缺失的问题。共享服务与 Host 工具边界都按原请求补全动作；业务失败、断线与调用方校验失败也保留 action、原错误和成功状态，不放宽原输出校验，不把失败伪装成成功，不重放调用。

3 项定向测试通过，覆盖全部 8 种动作、实际注册的 Host 工具成功及失败返回，以及隔离真实 Windows 共享服务读取与业务失败。仅使用合成数据，没有重放正式用户流程。

另定位到记忆插件 1.0.4 在工具续步中仅从新输入查用户消息，可能以空快照替换已召回约定；该组件的 1.0.5 本地修复另行交付，不包含在此知识库包内，未公开发布或自动安装。合成课堂录音约定验证了持久保存、召回及解析完成后的上下文续接，未证明正式录音已自动生成笔记。

2.4.8：设置页的解析调用记录（2026-11-05）

修复共享服务把管理界面的只读请求当作普通会话的问题。设置页依据已认证连接的管理权限读取 OCR / ASR 执行任务和提交记录，不再按固定界面会话误过滤 Agent 发起的任务；资料可见性筛选仍然生效。普通模型工具和只读连接不因此获得跨会话管理权限，写接口仍要求管理授权。

3 项定向测试通过：在隔离的真实 Windows 共享服务中，由独立 Agent 会话调用本地合成 OCR / ASR 接口，设置页两种读取入口均能看到执行中、提交及完成后的记录；普通会话、只读连接与伪造参数不能越权。反例在修复前复现为空列表，修复后通过。样本和接口为合成数据，未读取正式知识库、调用外部付费服务或验证正式用户完整界面。

2.4.7：升级交接等待提示（2026-11-05）

交接期间保留稳定的知识库 API 入口，明确返回服务准备状态；界面显示“知识库服务准备中，请稍候…”，接口就绪后继续读取。只对服务明确确认尚未执行的请求等待后重新提交；真实 HTTP 405、断线及未知写入结果不自动重放。准备失败或等待超时仍提供错误与恢复说明，不把它们伪装为就绪。

19 项定向检查通过，包含真实本地 HTTP 路由准备、恢复后的写请求仅执行一次、失败与超时边界、旧服务交接和服务恢复。未额外重复完整功能回归；未对正式用户实例操作或声称完整界面实测。

2.4.6：2.4.3 直接自动升级与恢复（2026-11-05）

沿用本次验证的 2.4.3 直接安装、自然退出交接、条件错误提示和固定旧包恢复。补充 Windows 内置管理员 SID 别名的规范化校验，权限仍要求同一组明确的主体与授权。2.4.5 候选未通过发布环境校验，未创建正式 Release；保留其包字节，后续以 2.4.6 为自动更新目标。

Direct 2.4.3 upgrades, natural idle handoff, conditional recovery help and pinned legacy repair are retained. Windows SID aliases are normalized before exact ACL comparison. The unpublished 2.4.5 candidate is preserved; 2.4.6 is the follow-up distribution.

升级错误恢复说明 / Recovery instructions

升级报错后的手动恢复说明 / Upgrade error recovery

2.4.5：2.4.3 直接自动升级与旧服务交接（2026-11-05）

• 恢复正式自动更新入口，正常 2.4.3 可直接安装本版，不要求先手动安装过渡版本。
• 新版通过已发布 2.4.3 的精确运行时指纹识别旧服务；释放探测连接后等待旧服务按原有空闲机制自然退出，核对原进程出生标识和清理回执，再启动新服务。不向缺少停服协议的旧服务发送 shutdown，不终止其他连接或任务；超时显示恢复说明。
• 新版运行中的安装、事务恢复或交接确实报错时，才显示手动更新与恢复说明。2.4.3 若在首次 pnpm 安装阶段就失败，新代码尚未加载，仍使用旧版原错误界面；现有更新说明入口提供同一恢复文档，不能承诺旧界面具有新版弹窗。
• 手动恢复包可从固定摘要的公开 2.4.3 包重建受损代码目录，保留残留目录和原 profile 清单，再使用事务安装器升级；不清空知识库或解析记录。

验证使用真实公开 2.4.3 TGZ、Windows 上的运行服务与真实 pnpm，覆盖直接安装、自然退出后交接、原件保留及受损旧安装恢复；事务失败回退沿用并补验现有检查。验证范围不包含正式用户 profile 安装或完整 Electron 界面操作。旧 2.4.3 首次安装仍由宿主旧安装器执行，不能获得新版事务器在安装前的保护；异常时走恢复入口。旧更新源不能按客户端运行状态筛选，2.4.3 以外的旧版不属于本次定向保证。

2.4.4：Windows 安全更新与失败恢复（2026-11-05）

• pnpm 只在隔离的清单副本中准备锁文件；新包先完成摘要、构建号、路径和文件校验，不让包管理器改写在线插件目录。
• 更新前通过管理员授权的停服协议检查其他连接、排队及运行中的解析、导入和流程任务；忙碌时延后。停服后核对清理回执及进程退出，再切换完整包目录。
• 原插件目录和清单保留在私有事务目录；切换或清单写入失败时回退并逐文件校验。中途退出的安装可从持久事务记录恢复，不把未知结果标为成功，不重复发起安装。
• 2.4.4 使用 release-manifest-v2.json。旧 release-manifest.json 停用安装分发，阻断旧更新器继续走不安全的原地安装。2.4.3 及更早版本首次过渡须退出宿主及连接客户端，使用本版过渡安装包；旧服务不支持停服协议时自动路径会拒绝接管。
• 成功安装后明确提示重启生效。嵌入模式或缺少安全停服能力时保持旧版，暂不自动安装。包带额外依赖、相对本地依赖或旧包已不完整等不支持的情况均停止，不擅自重建用户配置。

验证：35 项 Node 定向检查、5 项真实文件系统/真实 pnpm 事务测试，以及 1 个 Windows 运行服务升级复合场景通过。复合场景包括原始 2.4.3 服务的拒绝接管、额外连接和排队任务的延后、使用旧目录 Python 的协议服务退出、真实 2.4.3 包切换失败后逐文件恢复、成功升级重启和虚构原件保留。具备新停服协议的服务升级与未修改旧服务的首次过渡是两条不同路径。本次未在正式用户 profile 安装，也未验证真实模型或完整 UI。

2.4.3：原件同步与 Windows 解析任务修复（2026-11-05）

• 合入文本原件与引用同步：归档文本参与检索，原件编辑后更新索引与引用范围；旧的自动生成镜像引用当前原件，独立撰写的摘要仍保留。
• 调整索引排除与恢复时的关联原件、派生记录及增量向量复用；修复含中文路径及版本化 Python 路径的 PDF 渲染。
• Windows 解析任务记录的读取和原子替换共用进程级队列，减少句柄重叠；外部占用有限重试，耗尽时保留旧记录并清理临时文件。
• 提交、重试和启动恢复的后台错误均被捕获；尽力保存失败状态，无法保存时明确报告，清理心跳和运行标记。

Windows 定向复验 73/73 通过（原有 68 项及新增 5 项故障测试）。测试使用虚构资料和请求替身，不证明真实 OCR/ASR 效果、自动 PDF/Office 索引同步、原生位置映射或完整桌面运行兼容性。客户端独立发布版本仍为 1.0.3，本次不重新发布客户端安装器。

历史记录 / Earlier releases

统一仓库源码 · 2026-11-04

2026-11-04 合仓时源码版本：客户端 1.0.1 / 插件 2.4.1。整合桌面工作区、共享内核与服务、可选记忆联动适配及现有安装器。两端后续统一维护于本仓库。该次文档更新未发布二进制 Release，当时公开插件清单为 2.3.1。后续历史条目除另有说明外均为插件记录。客户端版本说明。

2.3.1：收件箱提示词与任务状态修复（2026-11-03）

• 收件箱整理只发送“帮我整理并归档收件箱内文件”，不再附加流程及目录说明。
• OCR/ASR 任务记录使用静默后台刷新，合并同时发生的刷新请求，保留列表位置及详情展开状态。
• 知识库会话的命令工具漏传显示说明时补全说明；保留原有参数校验、工具可见范围及权限拒绝。
• 会话计划增加逐步更新规则及每轮一次的结束前核对。会话停止后旧的进行中步骤显示为未确认完成，完成数仍以实际待办记录为准。

验证包括定向自动检查、已安装 DSH 工具调度器的合成执行，以及 Edge 中的任务刷新和待办状态场景。权限拒绝及工具限制仍生效。正式桌面安装、真实模型对整项任务的完成质量及真实云端 OCR/ASR 未验证；会话结束不会自动把待办改为成功。

2.3.0 同版本修复：收件箱迁移与一键整理（2026-10-31）

简体中文 · English

• 桌面收件箱直接扫描当前知识库的 90-收件箱/。拖入或选择文件后迁移原件到该目录，不再通过快速收集的 Base64 上传接口，也不再受其 8 MiB 限制或依赖收集记录。同名文件追加编号；跨盘先复制并校验，再移除源文件；失败时保留源文件。手机快速收集页仍沿用上传限制。
• 修复“一键整理”选模时的 remote.session 依赖注入错误，检查模型选择返回结果，失败时不发送任务。错误提示区分“任务尚未发送”和“发送结果未确认”，不自动重试。
• 一键整理只发送“整理并归档收件箱内的文件。”；执行规则由知识库 Agent 与插件提供。用户所选模型与 High 推理强度继续生效。

版本号保持 2.3.0，本次更新仓库源码和配套安装包，不移动已有 v2.3.0 标签或替换其 Release 附件。8 项定向测试及流程探针通过；使用虚构资料和宿主服务替身，未安装到正式 DSH 或调用真实模型。

2.3.0 正式版：统一桌面界面（2026-10-30）

简体中文 · English

• 修正普通桌面宿主中知识库 Agent 的 OCR / ASR 被误拒绝：没有 H1 时按活的知识库根会话或实时委派授权校验，可正常提交解析；显式 parse.allowWithoutIsolation:false 仍要求 H1，已启用但未就绪的 H1 不回退。独立流程工作区中的已授权知识库会话可解析当前绑定库的原件。来源授权入口保留实际拒绝代码与原因，避免把隔离环境问题误报为缺少知识库权限。6 项定向检查通过，包括虚构原件经本机模拟 OCR / ASR 服务提交和读取结果；未调用真实模型。

• OCR / ASR 每条提交记录新增“查看详情”，包括被拒绝的提交：展示原始失败说明与代码、请求编号、时间、来源文件、发起会话 / Agent / 预设与授权入口、知识库编号及关联任务；有执行任务时可继续查看任务详情和结果预览。旧记录缺失的信息明确标注未记录。

• OCR / ASR 提交记录明确标注为“当次”结果；历史拒绝可展开查看当时的原始说明，避免被误解成当前无法查看任务记录。旧记录中的权限错误可能来自旧版对隔离环境失败的笼统提示。

• 修正桌面宿主设置弹窗中的布局冲突：内容区较窄时分类导航移至上方并自动换行，设置表单占满下方，宽页面保留左右布局；按设置内容区宽度判断。

• 待归档清单进一步排除 README.md（不区分大小写）、INDEX.md、AGENTS.md、知识库清单.md 等系统导航文件；已移动到排除索引分区的同类文件同样...