插件 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 附件。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 等系统导航文件；已移动到排除索引分区的同类文件同样排除。仅过滤待整理清单，不删除系统文件。
修正待归档清单：排除收件箱中的“原件归档”和旧版 _archive 目录，包括没有处理记录的历史归档原件；UI 与 AI 的 kb_inbox 清单共用该筛选。自动备份与手动备份目录新增“选择文件夹”按钮，复用宿主目录选择器，保留手动输入。
知识库页签与宿主内的知识库设置共用字体、主题色、卡片、表单和按钮规范；常规表单与按钮高度统一为 36px，提供浅色与深色主题。
收件箱突出拖入/选文件、整理模型与一键整理；待整理资料卡和已归档资料详情均用“排除索引”开关，开启代表排除，关闭代表正常索引，仍支持批量设置。资料移动后保留详情位置，避免刷新收起详情。
宿主设置按知识库与导入、偏好与隐私、检索、解析、采集、备份、版本分组。工作台与宿主复用同一偏好表单；切换宿主设置分类保留未保存的检索字段。技术运行信息默认折叠。
可编辑 Figma 设计；统一样式源为 src/client/knowledge-ui.css，经同步脚本嵌入客户端，随构建清单校验。此次以桌面端为范围，不新增手机适配。

验证：9 项定向检查通过；Edge 虚构库验证选择/拖入文件、逐份及批量排除、模型选择与发送顺序、宿主设置保存与分类切换、已归档资料开关往返，并查看桌面浅深色渲染。宿主服务为测试替身，未安装到正式 DSH 或调用真实模型。2.3.0 已发布。

2.3.0 正式版：收件箱入口与一键整理（2026-10-29）

新增底层资料排除策略：待整理卡片逐份或批量设置，已归档资料也可在详情修改；原件和已登记派生文件一起归入“排除索引分区”。排除后清理全文、向量及关系链条，取消后按原分类归档并重建全文与关系链条，已启用向量服务自动补建。
未归档资料不参与全文、向量或关系索引；知识库 agent 通过待整理清单直接读取并整理，归档产物继承来源的排除状态。解析文字可在排除分区中直接查看。完成归档后移出待整理区。
文件移动保留校验和与进度，遇到同名不同内容拒绝覆盖；失败时保留禁止检索状态并可重试。旧向量代次会清理后补建，详见索引机制说明。
收件箱首页支持拖入或选择多个文件，选择后立即保存，列出整个收件箱内的文件（含手动放入的文件）；每个文件沿用 8 MiB 上限，重复文件跳过，逐项显示添加结果。
“一键整理”旁提供模型选择，并按知识库记住上次选择；使用用户所选模型新建知识库 agent 会话，推理强度固定 High，确认选模完成后发送固定整理归档指令；模型不可用、不支持 High 或选模失败时不发送任务。流程页运行此内置流程时同样可选择模型。
流程页常驻“整理并归档收件箱”，同样新开会话执行；内置流程不可编辑、停用或删除。原有文字、网页和收集记录折叠至辅助入口。

验证：虚构库后端定向检查及 Edge 浏览器中的文件选择、拖入、文件显示、会话发送顺序通过；桌面与窄屏检查无横向溢出。宿主会话服务使用测试替身，未执行真实 DSH 安装或模型归档。2.3.0 已作为正式版发布。

2.3.0 正式版：会话目录侧边栏入口（2026-10-28）

左侧会话目录新增“知识库”行，与插件、定时任务并列（顺序20），点开显示同一套工作台界面；顶部“知识库”页签保持不变，两处入口数据相同。
行与全局面板成对注册：行的 id 与面板 key 一致（kb-panel），行本身由宿主渲染，插件只提供图标（stroke 用 currentColor，跟随主题）。
无新设置项、无数据迁移或索引重建；首次设置引导仍可从页签或插件设置打开。

验证：定向检查与同层镜像探针逐项核对行与面板配对、标签、顺序和图标属性。本机没有浏览器工具，真实宿主中的实际渲染未观察到，探针只能镜像从宿主读取的规则。回退方式不变。

2.2.1 自定义流程执行模型（2026-10-27）

新增／编辑流程时可保存执行模型与推理强度；模型来自当前宿主已配置服务，强度按模型支持的档位显示，切换模型清除旧档位。
点击“立即运行”先选择本次模型、推理强度和参数，单次更改不覆盖流程默认值；新会话先完成选模再发送任务，选模失败不启动任务。
后台流程逐步执行同样使用保存的模型设置。旧流程不指定模型时延续原有默认路由，无需手动迁移或重建索引。

验证：流程配置持久化、编辑往返、单次覆盖、发送前选模与失败阻断的定向检查通过，发布包逐文件与摘要校验通过。未在正式 DSH 宿主安装或调用真实模型。

升级由宿主加载，只有宿主提示需要重启时才完全退出（含托盘）后重开。回退可安装先前的 2.2.0 正式包；本次不改知识正文、绑定、凭据或索引格式。

2.2.0 稳定性与底层性能优化（2026-10-27）

缓存已验证的正文索引，复用同次请求的原文和行位置；保持精确排序、权限及引用检查。
共享同根目录监听，协调前后台维护；无变化的关系快照不重复保存，大型派生JSON分段同步发布。
改善临时读写故障自动退避恢复，保留身份与异常删除保护；修复Windows短路径的来源折叠。
新增运行依赖为零，无新设置、手动迁移或兼容向量重建。本版作为2.2.0正式版交付；未在用户正式宿主执行安装。

验证与基准条件见优化记录。

2.1.5 现有框架与大库精确检索优化（2026-10-26）

复用长文行位置，精确保留原排名需要的候选；大向量工作集分窗扫描，继续全量打分和checksum校验。
为正文、分块与清单缓存设置保留预算，复用未变化的清单；改进范围筛选、按批生成建库输入、并发限流与活动查询取消。
加速既有名称子串建议，修复关系更新等待旧扫描后返回旧文件集合的问题。
插件设置仅显示版本号；构建号继续用于内部更新与完整性校验。
保留模型、分块版本、磁盘索引与问答协议，不要求重建兼容索引。SQLite / USearch 和新证据协议暂缓，不包含在本版。

合成对照：2万条1024维向量，热查询中位数约553ms→180ms，独立进程峰值RSS约418MB→201MB；排名与覆盖数量一致。71项相关检查通过。全量向量读取仍为81.92MB/查询，问答上下文预算保持原样；Windows及几百GB真实库尚未验收。详见优化与验证记录。

2.1.4 后台更新与完成状态修复（2026-10-26）

同一大版本内可自动安装的正式版静默下载、校验和安装，不再同时弹出“有可用更新”。跨大版本和预览通道保留手动选择。
宿主构建与客户端版本确认加载后刷新共享版本状态、移除已安装版本提示并重新检查，更新前的迟到检查结果不能还原旧状态。
正式版补丁升级不弹更新内容；只有小版本或大版本升级才弹，汇总期间未读的补丁内容，关闭后不重复显示。预览版沿用每次升级显示的规则。

验证：26 项定向检查及客户端语法检查通过，覆盖静默提示、完成状态、迟到检查、热加载恢复和更新说明已读。未在真实 DSH 宿主执行升级安装。

2.1.3 响应与检索优化（2026-10-26）

工作台和关系网络使用事件合并刷新，减少每 5 秒重复扫描；可见页面保留 60 秒兜底，返回页面或获得焦点时刷新。检索设置按任务事件更新，关系索引增加完成/失败通知。
检索 worker 按版本复用资料目录、词频与倒排项，资料变化时只传增删改；向量分片加入有界缓存，继续核对文件指纹和逐向量 checksum。
向量构建每批每个分片只打开、同步一次，完整落盘后才提交 manifest；保留中断恢复、旧代次、隐私过滤与来源引用核验。新增本地阶段耗时和缓存计数，不增加敏感内容日志。

合成基准：20,000 份单片段资料的 worker 暖查询 p50 约 109ms → 17ms，p95 约 129ms → 40ms；冷查询略有增加。这不代表真实个人库、模型 API 或整个界面的响应时间。完整方法和缓存边界见性能优化记录。

验证覆盖定向回归、排序一致性、缓存隔离、损坏分片、同步失败恢复，以及真实浏览器中的刷新调度与 watcher/SSE。完整 DSH React 宿主、正式桌面安装与真实云 API 未验证，未读取个人知识库。扫描并发仍为条件项。

升级保留资料和磁盘索引格式；按宿主提示完成加载或重启，核对版本 2.1.3 与发布清单构建号。需要回退时可安装原 2.1.2 正式包。补丁更新沿用现有不弹更新说明的规则，公告内容保留供未来跨小版本汇总。

2.1.2 关系画布全屏（2026-10-26）

关系网络新增“全屏画布 / 退出全屏”，图谱和关联清单一起铺满应用窗口。画布按实际区域宽高比调整，减少宽屏留白；缩放、拖拽、适配与节点详情继续可用。Esc 优先退出全屏，切换页签或进入链接检查时自动收起；全屏状态不持久化。

全屏指铺满应用窗口。进出全屏时分栏回到默认比例，不覆盖原有拖拽偏好。

验证：来源构建已有合成宿主浏览器验收；本次发布执行语法、定向回归与包一致性/隐私检查。未在真实 DSH 桌面宿主安装验证，宿主祖先元素的 transform、filter 或 contain 可能限制固定定位覆盖范围；未执行真实模型或云 API 验证。

本次将交付目录中仍标为 2.1.1 的新构建统一发布为 2.1.2，并重新计算构建号与安装包摘要。回退可安装先前的 2.1.1 发布包。

2.1.1 下载入口清理

当前安装入口统一为正式版 2.1.1。旧预览包及网站副本撤下；预览通道显示“暂无预览版”，不同步的旧镜像预览不会作为当前版本推荐。官网安装说明和下载链接同步更新。

2.1.1 收件箱与页面滚动修复

客户端浏览器扩展安装指南新增“下载浏览器扩展”：自动匹配 Gitee、GitCode、GitHub，下载失败或文件校验不通过时切换其他源，全部失败才显示原因及备用链接。README、使用说明和开发记录同步更新国内下载入口。

收件箱列表和详情支持将采集原件移入回收站，确认后保留 30 天恢复能力；删除知识笔记后保留的采集原件也可单独删除。工作台限定在可视区域内，顶部导航保持固定，列表和详情独立滚动，允许滚动在区域边界自然传递，预览详情底部为宿主输入框预留滚动空间。

2.1.1 图标更新

知识库插件采用统一的书页与知识节点图标，并应用到桌面插件清单、网页快速收集入口、浏览器扩展工具栏／弹窗／设置页和产品展示页。此更新只调整品牌识别与展示，不改变功能行为或版本号。

正式安装包、浏览器扩展包、官网展示及发布摘要同步采用此图标。

2.1.0 正式版

本版将已验证的 2.1 预览功能整理为正式版本，并保留 2.0.3 的同一大版本正式版自动更新能力。

2026-11-05：插件 2.4.2 / 客户端 1.0.3

客户端反馈现已通过 Cloudflare Workers 与 D1 创建公开 GitHub Issue。用户无需登录 GitHub，提交前填写标题、正文并确认公开；只附带版本和构建号，不自动附带资料、日志或设备路径。凭据只保存在服务端 Secret 中。重复提交使用同一回执，结果未知时核对而不盲目重发；存在频率和每日总量限制。

跨盘回收修复：新回收项保存到资料库内部元数据目录；兼容旧回收项目，跨盘恢复经过复制及逐项校验；失败回执只有在确认源目录未变化且未移动时才标记失败。断线重连刷新保留已有页面快照。

插件 2.4.2 修复共库 Host 的正式更新检查与准备接口、1 MiB 发布清单读取及版本状态提示。共享 Host 的 Python helper 按内容摘要复制并验证到插件目录之外的持久运行目录，避免占用待替换的插件文件。沿用原有绑定、配置、解析记录和服务身份，不初始化、迁库或重发解析任务。独立离线安装器先阻止活跃客户端、备份并比较状态，再调用本机包管理器；真实安装及宿主激活由用户完成。

验证包括反馈接口及状态测试、真实部署测试 Issue #46 / #47（重复提交返回原 Issue）、隔离 C/D 双卷回收恢复、服务文件生命周期、Windows helper 存活时原包目录改名，以及 2.4.1 状态重开测试。独立安装器的包管理调用使用模拟；未以用户真实库或真实模型调用作评测，也不声称完整 Office 保真或所有网络可达。

两端分别使用 client-update.json 与 release-manifest-v2.json，版本与 SHA-256 独立核验。客户端检查更新及校验下载已实现，自动覆盖安装与激活尚未实现。镜像附件在同步校验完成后可用。

客户端 1.0.2 · 2026-11-04

修复安装完成后首次启动的潜在阻塞：隔离安装器运行环境，首屏不再同步等待 IPC 或知识库服务；重复启动聚焦已有窗口。修正首次连接失败后的重试。

左右侧栏及预览分栏按帧预览宽度，松手提交布局；PDF、图片和浮窗等待尺寸稳定后更新，避免拖动反复重绘。拖动取消、失焦和栏目卸载均释放拖动状态。

反馈入口只把用户输入、版本和构建号复制到系统剪贴板，没有反馈服务器、上传接口或自动创建 Issue。请手动提交到本仓库 Issues。

验证：生产构建、22 项针对性测试、9 项界面检查、隔离安装后首次启动、连接失败重试，以及最终安装版本启动与拖动卸载检查通过。旧版间歇性白屏未稳定复现；不据此声称唯一根因或真实库负载性能。测试使用示例库，不包含个人资料或真实模型调用。

客户端检查更新和校验下载可用；自动覆盖安装与激活仍未完成。插件保持 2.4.1。

正式发布记录

GitHub Release：v2.1.0，已发布；原始发布由 PR #25 合并至 main，提交为 bf41c52c088495596c619af30b38a4a4bc43a3e1。
PR #26 已将发布记录、随包文档、安装包、网站下载副本和摘要清单全量同步到 main，合并提交为 5abc0bbfd37162e91343906aa761a37ea590639f。这是文档与发布元数据同步，构建号仍为 37b7ff660806754d。
安装包字节数、SHA-256 与逐文件摘要以权威 release-manifest-v2.json 为准。
产品展示页：个人知识库 2.1.0；正式发布工作流和 Pages 部署均通过。
Gitee 镜像同步成功；GitCode 镜像同步工作流失败。镜像结果与 GitHub Release 状态分开记录。
用户确认 2.1-beta4 预览版可用。正式包没有在维护者本机安装验证，也没有使用真实云端 Embedding/Rerank API。
多语言全文与向量协同检索：并行召回、一次双向局部补充、RRF 融合、精确匹配和来源去重。
长文按结构切片，关联章节与原文位置，命中后恢复必要上下文；不缩短原有证据范围。
内置硅基流动 BGE-M3 配置，提供通用 Embedding 与 Rerank API；保存启用后自动增量建库。
索引位于知识库根目录的“索引层”，空间以 KB／MB／GB 估算；API Key 沿用加密凭据，版本升级不重置。
复用检索 worker、分词计算、请求内读取和同时在途查询向量，按证据缺口补查；不缓存最终答案。
问答协议减少整篇答案重复回传；保留蓝色知识库引用入口、来源链接和默认开启的简短检索流程。
新增最终引用检查：漏引或跳过审查时最多请求一次定向修正；初稿流式输出可能先显示，不声称能证明全部事实正确。
新增机制版本检查、索引兼容升级和托管文件差异处理，保留用户修改和 AGENTS 规则。

配套记忆补丁

发布附件 memory-evolve-context-fix.zip 将标题、别名、审查和写入提醒与稳定记忆分离，避免这些小变化触发大段记忆重注入。补丁不删除正文、不降低规则预算，不改写已有会话历史；真实记忆更新和其他插件变化仍可能增加上下文。只安装知识库包不会自动修改记忆插件。

补丁是对特定 memory-evolve 基线的可回退代码修改，需要另行应用；内容不包含维护者的记忆数据和设备路径。详见补丁说明。

更新与验证

预览版本经用户实机测试确认可用；正式版重新同步版本、清单、包与下载入口。发布前执行一组定向检查、源码与归档一致性及公开内容检查；不额外开展大规模压测或真实云端调用。
25 项定向自动检查通过；安装包逐文件摘要、正式版发布工作流与展示页部署检查通过。用户实测对象是 2.1-beta4 预览包，发布清单明确标注未在维护者本机生产安装、未进行真实云端模型调用。
升级不会自动清除已有会话积累的重复内容。完整重启后建议新会话验证；自定义规则或预设的待处理差异请在知识库设置中查看。

2.0.3 补丁更新

同一大版本内的正式版小版本与补丁更新自动下载、校验并交由 DSH 安装；跨大版本及预览版更新仍需手动选择。
保留已有“有可用更新”提示、关闭记录，以及安装后的更新说明弹窗规则。
宿主不提供客户端安装接口时，继续通过 DSH 插件管理器更新。

本次为补丁更新；按正式版规则，不弹出安装后的更新说明。

2.0.2 补丁更新

从公开材料和安装包中移除维护者设备路径、账号目录、本机服务地址及个人知识库目录样例；本地 OCR／ASR 默认路径改为由用户配置或从当前环境发现。
将随包知识库 Skill 改为通用安全说明，不再包含个人资料目录、账号路径或私人工作流示例。
增加发布前文档隐私扫描，并在插件设计与演进记录中固定公开内容的隐私边界。
删除旧版本发布资产中的随包资料副本，并以 2.0.2 发布经审查的安装包。

本次为补丁更新；按正式版规则，不弹出安装后的更新说明。

2.0.1 补丁更新

更新说明正文合并为本次升级内容清单，不再按历史版本分组；相同条目只显示一次，保留跨版本汇总和关闭已读规则。
新增插件设计与演进记录，记录产品定位、架构、数据与权限、实现方案、源码索引、演进路线、未来方向及能力边界。
README 前部、知识库工作台设置页及 DSH 个人知识库设置均增加文档入口。文档随安装包分发，发布检查要求其版本同步。

遵循补丁更新规则：从 2.0.0 升级到 2.0.1 不弹安装后的更新说明；从更早的大／小版本或预览版升级时，按既有规则显示合并内容。

2.0.0 正式版

本版将知识库工作台从预览版带入正式版：统一总览、资料目录、关系网络、收件箱、阅读与摘录、回顾、流程和设置的导航与布局。关系网络使用按文件变化维护的索引；可选择中心资料、查看全库分区、追踪连接与修复证据。普通可写文件可移入回收站，30 天内恢复；系统文件受保护。OCR／ASR 经受管解析通道登记任务和提交记录，结果回到发起会话。

顶部与设置页共用更新状态。正式版用户只对新的正式版弹出更新提示；预览版用户对两个渠道的新版本弹出提示。安装需用户点击。版本格式及旧 2.0.2-betaN 的迁移比较规则见 VERSIONING.md。

安装后更新说明按版本变化决定：正式版跨大／小版本弹窗，单独补丁更新不弹；预览版每次更新弹窗。跳过多个版本时汇总区间内的更新内容为一个弹窗，关闭后记录已读版本。此规则与“有可用更新”的弹窗互不影响。

升级不会主动删除用户知识库。回退时使用安装前保留的插件包和配置备份；回收站文件存于知识库内部受保护目录，降回不支持回收站的旧版本前应先确认需要恢复的文件。

1.1.6 正式版：自动选择可用更新源

在国内更新源基础上简化更新操作：点击更新后自动选择可用地址，下载、校验及交给宿主安装。正常情况不列出来源、地址或单个源的失败信息；只有全部源不可用时才列出原因和备用入口。保留正式版/预览版自主选择，不包含工作台功能。

对应预览版：2.0.1-beta3。旧版本安装包保留。

1.1.5 正式版：国内更新源

基于 1.1.4 的小更新，加入 Gitee / GitCode / GitHub 三源检查和下载，保留正式版/预览版自主选择。没有加入知识工作台功能。

并发读取各源清单，采用最新可用版本，避免镜像延迟隐藏新版本。
同版本摘要不一致时阻止更新；下载失败或校验失败后切换其他源。
展开下载源可查看各源状态及正式、预览安装包入口。
GitCode 使用官方 raw 文件 API，Gitee 仅允许平台文件域名内的 HTTPS 跳转。
检查更新不自动下载或安装。保留资料、绑定和设置。

正式版：1.1.5；预览版：2.0.1-beta2。旧版需安装本次更新后才能获得国内源。

1.1.4 正式版：可选更新通道

基于 1.1.3，仅增加正式版和预览版分别检查、显示及由用户选择下载/安装的能力。知识工作台功能仅在 2.0.1-beta1 预览版提供。

旧版用户通过现有“检查更新”入口获得正式版 1.1.4。
安装 1.1.4 后，同时查看正式版状态和可选预览更新。
检查本身不下载、不安装；选择预览版后才执行对应操作。
预览清单不可用时保留正式版检查；安装前重新校验版本、包身份、大小和 SHA256。
保留原有资料、绑定和设置；不增加工作台引导。

1.1.4 与 2.0.1-beta1 历史安装包已从公开下载处撤下；历史说明仅保留功能记录。

更新通道、原有更新安装流程和导入授权回归使用模拟服务通过；真实 DSH 安装尚待实机验收。

个人知识库 1.1.3

本版修复两个缺口：kb_import action=parse 过去没有经过 kb_parse 的调用者授权与 H1 状态检查；现在只有宿主确认的知识库根会话或仍有效的知识库子代理可以解析，且 H1 必须就绪。任务记录保存授权来源，模型传入的 provider ID 不会改变设置默认值。

更新公告以统一关闭函数处理按钮、遮罩和 Esc 键；按 Esc 关闭后也会保存本版本已读状态。

当时的公告规则为仅显示主人指定的公告；从 2.0.0 起，安装后更新说明改用上述按版本变化的规则。历史 1.1.1、1.1.2、1.1.3 已读记录仅用于迁移旧状态。

新增客户端内一键更新：点击「立即更新」自动从固定仓库下载安装包，校验大小、SHA-256、包名、版本和压缩包路径，再交给 DSH 原生插件管理器安装。支持热加载时直接加载；宿主返回 restart-required 时显示重启提示。通过持久化请求编号恢复热加载断线结果，只有实际宿主构建与客户端版本都吻合才显示加载成功；仅界面未替换时提供刷新界面入口。下载、校验、安装失败均明确显示；结果未知时阻止重复安装并提供核对入口。旧模块的迟到回复不会覆盖后续更新记录。

1.1.3 历史安装包已从公开下载处撤下。旧版需先使用宿主插件管理器安装当前正式包，再接入新版更新器。

展示页地址：https://kingsleyasher.github.io/Personal-Knowledge-Base/。本次合并后由 GitHub Pages Actions 发布 1.1.3 页面和下载包。

新增回归测试覆盖未授权/伪造调用方拒绝、H1 缺失或未就绪拒绝、授权撤销、授权来源留痕和 Esc 已读持久化。未进行 1.1.3 DSH 实机启动验收或真实收费云端 API 验证。

一键更新验证使用隔离临时目录和模拟原生服务结果；已检查本机 DSH 0.2.1-rc.2 的原生 installBundle、waitForInstall 与 HMR 源码契约。桌面端按用户要求保持 1.1.2，未实际执行其升级或热加载。

2026-11-04：同步版本与全自动更新策略

共享版本命名、比较和打包校验；插件跨大版本和预览候选更新均允许自动安装，保留通道偏好、包校验与忙碌/未知结果保护，不再弹更新确认窗口。安装后的版本说明规则不变。客户端在线下载安装尚未接入。本次只更新源码规则，不发布新包。

2.5.1 task plan follow-up (2026-11-07)

Task plan disclosure and list symbols now use vectors/CSS rather than font-dependent characters. During long knowledge tasks, bounded pre-step checkpoints request truthful todo_write progress updates instead of waiting until the final response. No step is automatically marked complete from tool count or elapsed time. Install the local update package and fully restart DSH to load host changes; real long-task behavior remains an installed-host verification step.

Local update 2.5.2 (2026-11-07)

The task plan expands upward above the composer: its arrow now points up when collapsed and down when expanded.

2.5.12 · 个人知识库插件