v0.12.13

• 桌面端的「立即重启」现在调用随插件安装的 PowerShell 脚本，核对桌面 Host 和主程序后重启桌面应用；Web 端仍只重启 Web 服务。计划任务隐藏命令行窗口。桌面端同步后需要刷新会话列表时提示手动重启，自动重启开关只适用于 Web 端。
• 桌面端不再把 Web 运行时补丁套用到独立的 Web 安装。同步时排除桌面插件市场与插件管理器的本地缓存；Web 和桌面同时运行时，同步操作通过本机进程锁串行执行。
• 验证：Windows 11 上分别对桌面端和 Web 端的重启接口执行实际重启，各自进程更新且另一端保持运行，两项计划任务都返回成功；38 个自动测试和补丁回归检查通过。未完成两台物理电脑的实网验收，也未目视确认所有窗口焦点行为。
• 升级注意：Web 与桌面端需分别更新插件；两端共用 ~/.dsh 中的会话等数据，但各自使用独立的插件 profile。桌面端需要手动确认重启，正在进行的任务会中断。

v0.12.12

• 修复会话日志分叉时混排事件、重编号导致引用和生命周期关系错误的风险。仅原样选择可确认的追加历史；无法安全接续时保留当前一侧，并在同步详情和命令行列出双方原件的 Git 提交。
• 为会话日志配置本地 Git 合并规则，防止纯文本日志绕过上述检查被 Git 自动拼接；配置与普通文件保持各自的合并策略。
• 修复多帧 zstd 的边界识别，完整检查帧与块长度；解码失败不再跳过损坏帧继续合并。
• 补丁不再凭旧标记覆盖文件；缺少原始备份和录制版本时暂停应用。增加按安装版本停用旧补丁的清单字段，状态文案区分“文件一致”与兼容性验证。
• 一键重启前显示本机是否具备 Windows 重启脚本，缺少条件或同步正在运行时禁用按钮；不再将自动重启描述为默认开启。
• 验证：Windows 11 / Node.js 24.19.0；两个隔离 DSH 0.2.0-rc.1 实例完成插件加载、模式切换及重启保持检查；本机 10 个会话的当前日志通过对应版本校验器只读检查。完整测试与打包结果见兼容验证记录。未验证正式版 DSH 0.2.0，也未执行两台物理电脑的实网验收。
• 升级注意：发生分叉的同一会话不会把双方新增内容拼成一份；请按同步详情中的提交位置查看另一份原件。更新后重启 DSH。用户自建补丁不包含在 npm 包内，需单独审核适用版本。

v0.12.11

• 设置页新增「立即重启 DSH」按钮：同步归组或补丁套用后需重启才生效的场景，可一键经计划任务重启（schtasks 独立进程树，避免在服务器进程树内自杀）；未部署 restart-dsh-web.ps1 时给出明确提示。
• 同步引擎把重启调度泛化为 scheduleRestart(reason)，保留 scheduleRestartAfterRepair 向后兼容；新增 POST /dsh-sync/api/restart 端点。
• 兼容 DSH 0.1.7-rc.x 的新会话格式（session.v4.jsonl.zstd）：会话日志识别改为按目录枚举（未来格式自动兼容），修复 v4 会话无法自动归组、「未分组」自动重启修复不触发的问题；设置卡新增未分组会话提示。
• 中英文 README 新增「功能」章节，介绍会话自动归组、两种同步方式、会话管理、冲突自动合并、分组自动修复与补丁托管；并精简首页、把安装与授权步骤集中到安装指南、增加源码下载与更新日志入口。
• 将本地维护约定纳入仓库；发布流程增加中文更新日志检查，并自动将对应标签的完整源码 ZIP 上传到 GitHub Releases。

v0.12.10

• 修正宿主补丁中的包名和浏览器模块加载标识，统一为 @dpskk2/dsh-chatsync，使其与实际发布的 npm 包名一致。
• 修正安装说明中的作用域包名。

v0.12.8 · 从第一次打开终端开始

本版重写新手安装与换机指南，不修改运行时代码。

• 解释从哪里打开终端、把命令粘贴在哪里、何时继续下一步。
• 登录流程明确分为终端发起、浏览器输入验证码并授权、回终端检查用户名。
• 工具名称不再重复加链接，保留下载、注册与必要帮助入口。
• 说明刷新网页与重启应用的区别、新电脑数据恢复和密钥配置。
• 中英文 README、详细安装指南和 npm 包同步更新。

升级命令：dsh plugin --profile web update dsh-sync-plugin。完成后重启 DSH。

v0.12.7 · 更好上手的 README

本版将重新整理的中英文 README 同步到 npm 包与包主页，不修改运行时代码。

• 首屏突出用途，紧接工具下载清单与三步上手。
• 外部工具和服务提供直接链接。
• 新增电脑、日常使用和排障分别提供清晰入口。
• 流程图及兼容性细节折叠，减少首屏干扰。

升级：dsh plugin --profile web update dsh-sync-plugin，完成后重启 DSH。

v0.12.6 · 更清晰的设置与换机引导

设置页现在可直接连接已有 GitHub 私有仓库，新电脑无需手工编辑配置文件。说明文字、蓝链、窄屏布局和换机文档同步改进。

• 新增仓库地址、分支和自动建仓选项，明确保存与实际连接验证的区别。
• 改善自动同步状态更新和错误重试提示。
• 修复缺少 Git 时误报成功，保护损坏配置，避免并发保存丢失设置。
• 补齐新电脑依赖恢复、双向验证和排障指南。

验证：28 项测试与 6 个补丁断言通过，浏览器交互和窄屏检查通过。同步测试使用隔离数据目录与真实本地 Git 远端；尚未完成真实 GitHub 两台设备验收。

升级后重启 DSH：

dsh plugin --profile web update dsh-sync-plugin

v0.12.5 · 更可靠的多机同步

这次更新聚焦同步可靠性、即时配置生效和更清晰的上手体验。

• 修复连续冲突备份分支重名，确保每份备份都能安全保留。
• 手动 / 自动模式切换保存后立即生效，并避免重复定时任务。
• 上传前验证 GitHub 仓库私有状态，拒绝不安全或含凭据的远端地址。
• 工作区传输失败会进入同步失败状态，错误不再被静默忽略。
• 完善首次建仓与双设备恢复流程，并新增配置、调度、私有远端和两机恢复回归测试。
• 重写中英文 README 与使用文档，让安装、第二台电脑接入和排障路径更直接。

升级：dsh plugin --profile web update dsh-sync-plugin

升级后重启 DSH。

验证：20 项自动化测试、6 项补丁断言及 npm 打包预检均已通过。

v0.12.4 · 换台电脑，接着做

这次更新让第一次连接两台电脑更容易：从安装、登录到第二台取回数据，文档给出了完整步骤和验证方法。

• 设置页可选择手动或自动同步，也可关闭工作区文件同步；保存后明确提示何时生效。
• 重写中文 README，新增英文入门、同步流程图、配置参考和排障指南。
• 修正本地快照、凭据排除、历史冲突副本和备份分支的说明。
• 增加问题反馈模板、设置交互测试与发布前测试检查。

升级：

dsh plugin --profile web update dsh-sync-plugin

升级后重启 DSH。手动 / 自动模式切换后也需要重启。专用凭据文件 .credentials.yaml 排除同步，每台电脑需单独配置 API 密钥。

验证：Windows 与 Linux 的 CI 均通过，涵盖 6 项设置交互测试、补丁应用测试及安装包预检。本次未新增真实双机端到端验收。