CloverViewer v0.1.3

v0.1.3 — 界面打磨与截图体验改进

改进

• 主界面体验统一：完善左侧导航轨、内容区上下文栏与整页设置面板的过渡和空态表现，
  浏览图片与调整设置时的层级更清晰。
• 截图提示更易读：快捷键帮助框与滚动截图面板统一视觉样式，并会根据当前鼠标所在屏幕落位。
• 长截图结果可直接复制：在查看器中打开长截图后，可通过原生剪贴板复制图片，避免受 WebView
  图片剪贴板兼容性影响。

修复

• 避免滚动截图混入覆盖窗 UI：当提示面板与捕获区重叠时，优先使用 Windows 捕获排除；
  不支持时整段隐藏提示，避免逐帧闪烁或把 HUD 拼进长图。
• 稳定首帧与重试帧的捕获时机：滚动截图在所有采帧路径上都应用同一套 HUD 让位策略。

维护

• 清理已完成阶段的路线图、设计草图与重复 Logo 资源，保留可复现的滚动截图验证工具。

---

CloverViewer v0.1.2

v0.1.2 — 滚动截图（长截图）

一句话：框选一块可滚动区域，程序自动滚下去并把每一屏拼成一张长图。

新增

• 滚动截图（长截图）：截图工具栏新增「滚动截图」按钮。
  框选区域后自动滚动、逐帧按重叠像素拼接成长图；结束后可 复制 / 保存到桌面 / 在查看器中打开。
• 专属全局热键 Alt+Shift+S（可自定义）：按一次即进入滚动截图待框选态，
  框选完自动开始，单击窗口则直接对该窗口开跑 —— 最短路径是「按热键 → 点一下浏览器」。
• 自动探测注入方式：不同应用吃的滚动方式不一样（浏览器吃滚轮消息、资源管理器只认真实滚轮或
  PageDown、标准列表控件吃滚动条命令）。程序在主循环里挨个试、谁先让画面动就用谁，
  并顺手标定「每格滚多少像素」来决定步长，无需用户理解这些差异。
• 智能拼接：自动识别并只保留一份吸顶标题栏 / 吸底工具栏，自动忽略左右两侧的
  滚动条与固定侧栏；周期性内容（等距列表、图标网格）用「上一步位移」先验消除歧义。
• 稳定帧等待：按「画面是否已经停住」而不是固定延迟取帧。Chrome 的平滑滚动要
  ≈1.1s 才停，固定延迟必然截到「滚到一半」的中间帧 —— 这是本项目 P0 实测结论。
• 实时进度反馈：HUD 显示已捕获高度、帧数与缩略预览，边框颜色反映匹配状态
  （绿 = 良好 / 琥珀 = 部分帧证据不足 / 红 = 失败）；整屏选区时改用任务栏进度条，
  保证「正在跑」这件事始终可见。
• 随时停止：Esc 或 HUD 的停止按钮均可中止，已捕获部分不丢（标记为「部分结果」）。
• 失败可解释：不可滚动、选区太矮、内容有大面积动画、连续多帧无法匹配等原因分别给出
  对应文案与排查清单，而不是笼统的「截图失败」。
• 热键冲突自动降级：Alt+Shift+S 被其它程序（微信 / QQ / 输入法 / 别的截图工具）占用时，
  自动改用候选组合并在主窗口提示「想用的 / 实际生效的」分别是哪个。
• 设置面板新增「滚动截图热键」：与截图热键、取色热键一致，可改、可即时重注册。
• 调试开关 CLOVER_SCROLL_DEBUG=1：把每帧的位移、匹配质量、追加决策写入
  临时目录的 clover_scroll_debug.log，遇到拼接问题时便于反馈定位。

改进

• 截图覆盖窗状态更稳：会话语义的临时状态（鼠标穿透、临时全局 Esc、任务栏进度、
  HUD 让位）改为「租约 + 析构兜底」，任何一条错误路径都不会把窗口留在异常状态。
• 滚动截图与普通截图共用同一把「正在截图」互斥，长截图过程中不会再被 Alt+S 打断。
• 「在查看器中打开」不再触发主窗口冷启动：主窗口若在托盘态会先被唤起再载入长图，
  并提示「已在查看器中打开长图」。

修复

• 修复在页面底部启动滚动截图时被误报为「该区域没有发生滚动 / 可能不可滚动」的问题。
• 修复会话异常结束时覆盖窗可能永久停在鼠标穿透态、且临时全局 Esc 未注销的问题
  （表现为覆盖窗像「死」了一样点不到任何按钮）。
• 修复结果态 HUD 在特定时序下按钮与缩略预览全部不显示的问题。
• 修复实时缩略预览与最终长图相差一个页脚高度、对不上的问题。
• 修复「每步滚动像素」标定完成后反而可能每步只追加一点、帧数暴涨的问题。

文档

• 新增 CHANGELOG.md（本文件），Release 正文由 CI 从此文件对应的版本段落生成。
• 新增 SCROLL_CAPTURE_PLAN.md：完整设计方案 + P0 兼容性实测矩阵 + P1/P2 踩坑记录
  （含发布前 review 抓到的 5 个问题与教训）。
• 三语言 README 补充滚动截图功能说明与快捷键表；ROADMAP.md 记录滚动截图这一阶段。
• 新增 tools/README.md，说明 tools/ 下的验证脚本（长页面素材、确定性可滚动目标、
  拼接算式离线复刻、多屏落位几何检查）。

说明

• 滚动截图依赖目标应用的渲染稳定性，不保证 100% 成功；成功率的边界已写进
  SCROLL_CAPTURE_PLAN.md 第 11 节（风险与缓解）。失败时已捕获部分会保留。
• 长图标注与结果态裁剪（视图变换 zoom/pan）留待下一阶段，当前长图在查看器中查看与导出。

---

CloverViewer v0.1.0

CloverViewer 更新。

从下方 Assets 下载 *-setup.exe 安装即可：

• 安装包（NSIS）: CloverViewer_ + version + _x64-setup.exe