V2.0.1

Vertree 2.0.1

修复局域网分享提示残留，以及公告、初始化弹窗重复出现的问题。

修复

• 局域网分享准备成功或失败后主动关闭“正在准备”提示；鼠标悬停不再暂停 Toast 自动关闭，并处理任务在提示插入界面前完成的情况。
• 同一公告的并发显示请求只打开一次。关闭公告或成功打开公告链接后保存已读状态，重启后不再重复弹出；新公告仍正常显示。
• 初始化的“已经询问过”和“全部设置成功”分别保存。取消或部分失败后不再反复弹窗，可在设置中继续配置相关功能。
• 重复进入首页会等待已有初始化流程结束；成功状态先保存，再发送系统通知，避免通知失败导致下次重新初始化。

安装与验证

• Windows MSI 保留完整安装向导、完成页、启动选项及修复／卸载入口。
• 从 2.0.0 升级保留现有 settings.json；若此前没有记录公告已读或初始化提示状态，升级后首次处理时会保存。
• 本地 110 项测试、静态分析、架构检查和 Windows Release 构建通过；包含本次修复的测试 MSI 已经用户安装验证。
• 正式发布产物由 GitHub Actions 构建，并执行 MSI 页面、目录、安装、快捷方式与卸载检查。

V2.0.0

Vertree 2.0.0

本次为不兼容升级：重组版本、快照和监控架构，并修正 Windows MSI 安装包。

升级前请注意

• 使用新的 settings.json 配置和 monitorTasks 任务格式，不读取或迁移旧 config.json。升级后请重新设置偏好并添加监控任务。
• 自动快照保存在源目录的 .vertree/snapshots/<任务 UUID> 中，通过清单确认归属。旧 *_bak 文件保持原样，但不会自动导入或显示在新快照列表中。
• 手动版本仍是普通文件，继续按文件名识别版本关系。
• 本机 API 删除 /backups、/version-files 和任务 /backups 路由。手动版本统一使用 GET/POST /api/v1/versions；自动快照使用 GET /api/v1/snapshots 和任务 /snapshots。任务使用 UUID 和 enabled；版本树返回 entries、parents、diagnostics。
• SSE 游标改为 sessionId:序号，进程重启后重新查询状态并订阅。

可靠性与架构

• UI、CLI、托盘和 HTTP 共用版本命令，集中处理创建、分支、标签、恢复和同名冲突。
• 手动版本与自动快照共享写入协调；新文件暂存后发布，不覆盖同名目标。
• 快照成功提交后才执行保留清理，只删除已验证归属的快照，保留未知文件。
• 监控失败不推进成功时间；复制期间的后续变化继续处理。监听与复制故障独立记录和重试，页面实时同步任务变化。
• 统一 Windows 短路径别名处理；原生文件发布在同一次调用内捕获错误码，可靠报告同名冲突。
• 启动失败回收资源，退出等待正在进行的写入；设置读取无写入副作用。
• 新增模块依赖检查与 CI，禁止反向依赖、跨模块内部引用及循环依赖，无历史白名单。

Windows MSI 修复

• 2026-09-08 重新发布 2.0.0：请重新下载安装包，文件名和版本号保持不变，SHA256SUMS.txt 已随产物更新。
• 补齐安装向导、安装目录选择、进度和完成页；完成页可勾选启动 Vertree，并提示桌面及开始菜单入口。重复打开同一个 MSI 时提供修复和卸载入口。
• 允许新 MSI 替换此前已安装的同版本 MSI，避免登记为两个同版本产品；替换安装纳入事务回滚。
• 构建时检查最终 MSI 的向导、维护、完成页面及启动动作，防止仅静默安装通过却没有交互界面。
• 修正公共桌面和开始菜单目录，避免快捷方式被安装到 C:\ 根目录。
• 修正快捷方式组件 KeyPath，保留 WiX ICE 校验。
• 发布前检查 MSI 目录，并在 Windows CI 中执行安装、快捷方式目标检查和卸载，失败阻止发布并保留日志。

验证与边界

本地通过 98 项 Flutter 测试、静态分析、架构检查、Windows Debug 构建与文档构建。正式安装产物由 GitHub Actions 构建和校验。

当前未实现跨进程文件事务日志；内部协调不能阻止其他编辑器并发修改文件。macOS/Linux 原生文件发布行为仍需持续补充对应平台的运行测试。

V1.2.0

Vertree 1.2.0

新增文件预览图 API，扩展本机自动化能力。Office-Viewer 与 Vertree 复用同一套渲染和格式清单。

文件预览图

• POST /api/v1/preview-images：传本机绝对路径，后台直接返回 PNG；不弹窗、不影响当前预览。
• 可指定宽高（默认 1200 × 1600，最大 4096 × 4096）、PDF/PPT 页码、工作表和视频时间点。
• 未知格式检测为文本后可预览，未知二进制和音频等无可视内容文件明确返回不支持。
• Office-Viewer 增加共享导出函数和桌面“导出预览图”入口，格式能力在构建时自动生成。

自动化与可靠性

• 增加预览控制/状态、格式能力、版本恢复/备注、文件比较、设置读写、批处理、异步任务、SSE 事件和诊断接口。
• 恢复版本前保留当前文件备份；修复连续备份可能复用分支编号并覆盖旧备份的问题。
• SSE 支持最近 256 条事件回放；异步任务支持状态、进度和安全边界上的协作式取消。
• 配置写入串行化；补充本地预览测试页与完整 API 使用文档。

使用说明

本机 API 默认关闭，需要在设置中启用并携带 Bearer Token。成功生成返回 image/png 字节，失败返回 JSON 错误。

Windows 使用 WebView2，macOS 使用 WKWebView；Linux 后台图片生成需要安装 Chromium / Google Chrome。Word 和连续文本导出首屏，不支持按打印页码选择；视频编码支持取决于浏览器引擎。

本地验证：Flutter 83 项测试、Office-Viewer 112 项测试、预览宿主 20 项测试通过；Windows 实测 PNG/PDF/Word/PPT/表格/Markdown/XMind、视频时间点和第二页选择，以及恢复、批处理、异步任务、SSE 回放。各平台安装产物由发布工作流构建。

Windows 常规安装请选择 vertree-windows-x64-1.2.0-setup.exe，先退出旧版或本地测试实例，再覆盖安装。

V1.1.4

Vertree 1.1.4

修复 Windows 任务栏图标白底和退出卡顿，统一各平台与官网的 Logo 资源。

修复与改进

• Windows 运行窗口明确指定透明图标和任务栏应用标识，安装器创建的快捷方式使用相同标识，修复升级后仍显示白底 Logo 的问题。
• 统一主页、托盘和本地 API 的退出流程。先关闭后台服务、移除托盘图标，再结束 Windows 进程，避开引擎销毁期间的原生异常与退出拖延。
• Logo 统一以 assets/img/logo/logo.png、logo.ico 为公共源，删除重复资源；平台所需尺寸由脚本生成，官网直接使用公共文件。
• 补充 Logo 维护文档及 Windows 无底板图标资源索引构建流程。

验证

• Windows 任务栏白底修复已在实际运行窗口确认。
• Windows 退出实测约 0.19 秒（包含本地 API 的 120 毫秒调度延迟），退出码为 0；实际耗时取决于运行环境。
• 本地 Windows Release 编译、安装包构建与相关 Dart 静态检查通过。

Windows 常规安装请选择 vertree-windows-x64-1.1.4-setup.exe，退出旧版后覆盖安装。此版本保留 1.1.0 的文件预览功能。

V1.1.0

Vertree 1.1.0

新增本地文件预览：在 Windows 文件右键菜单选择“预览文件”，或从版本树节点打开预览，即可查看文件内容。也支持命令行 vertree preview <path>。

文件预览

• 集成 Office Viewer，只读预览办公文档、PDF、图片、文本、音视频、电子书、邮件和压缩包，文件内容在本机处理。
• 扩展 Office 模板、宏文档及 OpenDocument 格式，增加 EPUB、FB2、CBZ、EML、HEIC/HEIF、AVIF、CUR、SVGZ、Parquet、CRX 和 Java class 等格式支持。
• PPTX 幻灯片支持画布显示和翻页；PSD 显示保存的合成图及图层信息；XMind 支持可缩放、可折叠的思维导图。
• 取消固定的 64 MiB 文件大小上限。音视频、PDF 和 Parquet 支持按需分段读取，其他格式仍受解析器、可用内存和临时磁盘空间限制。
• 未知格式仅检测是否为文本；可识别则显示文本，否则提示不支持。移除十六进制和无意义的回退信息。

操作与界面

• 简化 Windows 右键菜单注册逻辑，统一管理预览、备份、监控和版本树入口。
• 连续预览多个文件时自动关闭上一个预览窗口，修复弹窗叠加。
• 去掉重复文件名和多余状态文字，“用系统程序打开”改为图标按钮。
• 去掉版本树画布的外层边框和包边。

下载与使用

• Windows 常规安装下载 vertree-windows-x64-1.1.0-setup.exe，免安装使用下载 .zip；另提供 MSI、MSIX 和调试工件。
• macOS 提供带架构标识的 ZIP、DMG；Linux 提供 TAR.GZ、DEB、RPM。
• Windows 预览需要 WebView2 Runtime；macOS 使用嵌入式 WebView，Linux 使用本机浏览器打开预览。
• 预览不保证完整还原所有排版；旧版 DOC/PPT、MSG、MOBI/AZW 和加密文档暂不支持，音视频解码取决于系统浏览器能力。

Office-Viewer 的配套改进已同步提交至 Office-Viewer 仓库，Vertree 固定使用提交 9b7f8ec。

V1.0.0

Vertree 1.0.0

Vertree 1.0.0 是首个稳定正式版，整理并确认 Windows、macOS、Linux 桌面发布链路，同时把本机 HTTP API、OpenAPI 文档和局域网文件分享能力纳入稳定发布说明。

本次重点

• Windows 桌面发布提供安装包、便携包、MSI、符号包和 Win11 菜单调试包
• macOS 桌面发布提供带架构标识的 zip / dmg 和符号包
• Linux 桌面发布提供便携 tar.gz、Debian / Ubuntu .deb 和 RPM 包
• 本机 HTTP API 保持 loopback-only，并提供 OpenAPI 文档、监控任务控制、备份、版本树和截图接口
• 局域网文件分享可从版本树节点生成短分享链接、二维码和自动选路分享页
• 文档站、README、官网公告和应用内版本检查同步更新到 1.0.0

发布说明

• 这是正式稳定版，不会以 prerelease 形式发布
• 若通过 tag 触发发布，请使用 V1.0.0 或 v1.0.0

V0.14.0

Vertree 0.14.0

Vertree 0.14.0 修复 Windows 11 新设备上的新右键菜单注册链路，并收紧局域网分享页自动探测失败后的重试和候选地址展示行为。

本次重点

• Windows 11 一级右键菜单注册改为优先使用 signed sparse MSIX + ExternalLocation，保留 loose manifest 作为本地开发兜底
• 安装器在原始登录用户上下文注册/清理 per-user sparse package，避免管理员 UAC token 写到错误账户
• 构建脚本支持通过 VERTREE_MSIX_CERTIFICATE_PATH / VERTREE_MSIX_CERTIFICATE_PASSWORD 生成并签名 Win11 sparse identity package
• 分享下载页的“重新探测”不再污染 URL hash，避免失败后反复触发探测循环
• 分享下载页现在会对候选 LAN IP 和 ip:port 组合去重并设置硬上限，避免失败时列表膨胀
• 官网公告、首页、简介和安装/开发文档同步更新到 0.14.0

发布说明

• 这是正式稳定版，不会以 prerelease 形式发布
• 若通过 tag 触发发布，请使用 V0.14.0 或 v0.14.0

V0.13.1

Vertree 0.13.1

Vertree 0.13.1 是一次面向局域网分享收尾体验的小版本发布，重点是补齐浏览器本地网络权限提示，并清理这条分享链路周边的 warning。

本次重点

• 当浏览器阻止访问本地网络中的其他设备时，分享页现在会明确提示先授权，再重新探测
• 继续保留候选下载页入口，避免自动探测失败时用户无从继续
• 修复局域网分享链路周边的 analyzer warning
• 官网公告、首页和简介文档同步更新到 0.13.1

发布说明

• 这是正式稳定版，不会以 prerelease 形式发布
• 若通过 tag 触发发布，请使用 V0.13.1 或 v0.13.1

V0.13.0

Vertree 0.13.0

Vertree 0.13.0 是一次围绕局域网分享闭环的正式版发布，重点是把分享对象从冗长参数串收敛成更短的 /f#<payload>，并补齐分享页选路、本地下载页和开发联调链路。

本次重点

• 将局域网分享链接统一收口为 /f#<payload>，去掉历史 c1/c2、明文 fragment、/fs 与旧 /file_share 兼容包袱
• shareKey 改为 Base62，候选 RFC1918 IPv4 改为“统一私网序号 + 排序去重 + 差分 + ULEB128 + Base62 外层”的整体列表编码
• 分享页前端改为单 payload 解析模型，不再暴露内部 route 编码细节
• 分享页增加控制台诊断日志，参数解析失败、信息回填失败、候选探测失败都能直接看到原因
• 分享页加入现代浏览器能力检测，对不支持 BigInt/fetch/AbortController 的旧浏览器给出明确提示
• 自动探测失败时默认折叠长候选列表，避免一次性展示过多 IP:port 候选地址
• 真实下载流程改为“公网分享页选路 -> 本地 HTTP 下载页 -> 本地页发起下载”，降低浏览器对不安全下载的拦截概率
• 本地下载页统一视觉、移除冗余下载按钮、按本机时区显示失效时间，并增加图片 / PDF / 文本的简单预览
• 本地开发脚本支持同时启动本地 docs 分享页，并在端口占用时自动复用或递增寻找可用端口
• docs 升级到 Docusaurus 3.10.0

发布说明

• 这是正式稳定版，不会以 prerelease 形式发布
• 若通过 tag 触发发布，请使用 V0.13.0 或 v0.13.0

v0.12.0

Vertree 0.12.0

Vertree 0.12.0 是一次面向 Windows 菜单体系重构与局域网分享体验修正的中版本发布，重点是把旧版右键菜单切回更合理的用户级注册模型，并补齐折叠菜单、图标与迁移链路。

本次重点

• 修复 Windows 右键菜单中“分享到局域网”使用错误图标的问题，统一改为分享图标资源
• 为“旧版右键菜单”增加独立的“收起到 Vertree 二级菜单”开关，默认关闭，且仅在旧版菜单启用时可操作
• 重构 Windows 旧版右键菜单注册路径，将运行时切换逻辑迁移到 HKCU\\Software\\Classes，避免把普通设置操作默认绑定到管理员权限
• 补齐旧版折叠菜单的级联注册项，使 Vertree 根菜单可以正常展开显示子菜单
• 增加旧版菜单布局迁移与遗留检测逻辑，兼容历史 HKLM 注册残留，减少双菜单和状态错乱
• 收敛旧版菜单普通路径与提权路径的行为差异，减少重复失败日志与无效重试
• 修复旧版折叠菜单下子菜单父路径混用 HKCU/HKLM 导致根项存在但无子菜单的问题

发布说明

• 这是正式稳定版，不会以 prerelease 形式发布
• 若通过 tag 触发发布，请使用 V0.12.0 或 v0.12.0