# 更新记录

## 0.12.8 · 2026-09-27

- 以第一次接触终端的用户为起点，重写中英文安装流程，说明命令粘贴位置、执行顺序和每步成功标志。
- 将账号登录拆成终端发起、浏览器验证码与授权、回到终端检查三个阶段；区分登录命令和状态检查。
- 减少正文中重复的工具名称链接，保留下载、注册及实际需要的帮助入口。
- 补充真正重启 DSH、新电脑取回数据及 API 密钥的处理方式；同步更新详细安装指南。本版不修改运行时代码。

## 0.12.7 · 2026-09-27

- 重写中英文 README：首屏突出用途，提供工具下载清单、三步上手和另一台电脑的接入步骤。
- 外部工具与服务补齐链接，流程图和兼容性细节折叠，排障入口集中。
- 将新版说明同步到 npm 安装包与包主页；本版不修改运行时代码。

## 0.12.6 · 2026-09-27

- 设置页可直接填写 GitHub 仓库地址与分支、切换自动建仓；保存后明确区分配置保存与实际连接验证。
- 放大说明文字、提高可读性、补齐键盘焦点样式与窄屏布局，提供首次使用指引及下载、登录、换机蓝链。
- 自动同步或另一处按钮触发的同步也会更新状态；状态读取失败提供重试入口。
- 缺少 Git 时报告失败，不再显示同步完成；配置文件损坏时拒绝覆盖，同步期间拒绝修改连接设置。
- 中英文说明与配置参考同步更新，补齐依赖恢复、换机检查表和排障入口。

## 0.12.5 · 2026-09-26

- 修复同秒内连续冲突备份分支重名：每次备份使用唯一后缀，避免第二份备份创建失败。
- 设置页切换手动 / 自动模式立即生效，无需重启；取消待执行活动同步，避免重复定时器。
- 状态显示实际自动调度情况；宿主加载参数覆盖偏好时显示实际配置。
- 工作区传输失败计入状态接口失败结果。
- 重写中英文 README，突出会话与项目文件一起换机，补齐兼容性和双向验证入口。
- 增加调度生命周期与配置 API 回归测试。

- 上传前核实 GitHub 仓库为私有；公开仓库、可见性未知和含凭据的远端地址拒绝云端同步。
- 主数据或工作区推送失败会报告失败；备份分支区分已上传与仅在本机。
- 首次自动建仓的同一轮同步即可上传工作区文件，并新增真实 Git 双设备回归。
- 声明 DSH Web 宿主最低要求 `0.1.5-rc.3`，该版本已完成隔离环境中的安装、组合与启动检查。

## 0.12.4 · 2026-09-18

- 重写中文首页，补充英文入门、第二台电脑接入、双向验收与排障说明。
- 设置页增加同步模式与工作区文件范围偏好；明确模式更改需要重启。
- 修正本地快照、专用凭据排除、历史冲突副本和备份分支的说明。
- 增加同步流程示意、反馈模板、仓库内设置交互测试与 CI 配置。

## 0.12.2

- 修复同步前补登记会话后未触发索引重建的问题；自动重启行为仍受配置与本机环境约束。

## 0.12.1

- 修复归档会话被重新登记到工作区、历史双登记，以及拉取新会话后的索引重建触发问题。

## 0.12.0

- 引入按文件类型处理的合并引擎：会话日志并集、配置字段合并、普通文件冲突取本机并尝试保留远端备份。

此处整理原 README 中的版本摘要，不是完整版本历史；包括 0.12.3 在内的其他提交见 [Git 历史](https://github.com/dpskk2/dsh-sync-plugin/commits/main/)。当前行为与边界以[同步说明](docs/sync-content.md)为准。

### 0.12.5 补充回归

- 工作区拉取失败明确报告失败；仅在远端查询证实分支不存在时允许首次上传。
- 工作区推送失败时仍保留备份分支及上传状态，CLI 返回非零退出码。
- 增加第三副本恢复、工作区断网重试、冲突备份内容可恢复验证。