v0.14.0

画廊 v0.14.0 · 旅行日期自动重算、应用内检查更新与微信照片修复

把旅行照片，做成一本翻不腻的手账。本地优先 · 免安装即用 · 照片原地不动。

这一版补上了两块「用久了才会遇见」的体验：照片搬来搬去之后旅行日期自动跟着走，以及不用再手动到 GitHub 看有没有新版——设置里一键检查更新。同时修复了一个高频痛点：微信转存的 HEIC 照片（文件名是 .jpg、内容其实是 HEIC）此前无法生成缩略图，现在按文件内容智能分流解码。

✨ 新亮点

• 📅 旅行日期自动重算 — 照片迁入、迁出（移动到旅行、导入、删除进回收站、恢复、外部增删文件）时，所属旅行的开始/结束日期按照片拍摄时间自动重算：日期跟着照片走，无需手改。你手动改过的日期永不被覆盖——只有「应用自动填的」或「你主动清空的」才会跟随照片变化，随时手改一次即锁定
• 🔍 应用内检查更新 — 设置新增「关于」区：显示当前版本，一键检查 GitHub 上的最新发布；有新版会展示版本号、发布说明摘要，并一键前往下载页。仅在你点击时联网，不轮询、不自动下载，网络失败给出可读的提示
• 🧩 微信 HEIC 照片修复 — 微信等 IM 转存的照片常见「HEIC 内容挂着 .jpg 扩展名」，此前缩略图与大图都会显示失败；现在按文件头内容嗅探真实格式、自动分流到兼容解码器，这类照片可直接入库正常浏览（Windows 上报告的「缩略图生成失败」即此问题）
• 🩹 失败可诊断 — 缩略图生成失败不再静默：失败原因会写入运行日志，个别文件再出问题可以按日志直接定位（格式/路径/解码器一目了然）

📸 新功能速览

🛠 修复与体验优化

• 旅行页日期实时刷新 — 后台照片集合变化（移动/删除/外部增删引发的日期重算）即时反映到旅行页顶栏，且不打断正在编辑的表单
• 迁移照片进新旅行时，新旅行日期自动按首批照片填充，不再留空
• 「移出全部照片后旅行日期残留旧值」的问题随重算一并解决（自动值自动清空，手动值保留）
• 回收站恢复照片后，旅行日期自动回摆到包含该照片时的范围

📦 下载

平台	文件
macOS（Apple Silicon，macOS 14+）	gallery-0.14.0-mac-arm64.dmg
Windows 10/11（64 位）	gallery-0.14.0-win-x64.exe

升级提示：数据库结构无变化，直接覆盖安装即可。照片文件始终原地不动。

首次运行提示：安装包未做代码签名——macOS 首次启动若提示无法验证开发者，到「系统设置 → 隐私与安全性」点击**「仍要打开」**，或执行 xattr -cr /Applications/画廊.app；Windows SmartScreen 弹窗点击「更多信息 → 仍要运行」。

v0.13.0 · 照片墙大改版：筛选、密度、时间序，归档与地图更省心

画廊 v0.13.0 · 照片墙大改版：筛选、密度、时间序，归档与地图更省心

把旅行照片，做成一本翻不腻的手账。本地优先 · 免安装即用 · 照片原地不动。

这一版围绕「看照片、挑照片、归类照片」把首页照片墙和旅行页照片墙全面升级：可以按旅行筛选、三档密度一屏看更多、按拍摄时间排序浏览；同时补齐了两类常见导入场景——根目录平铺的照片引导归档、空目录自动建成待整理的旅行；地图换用国内可直连的卫星影像源，首次导入大批量照片也不再卡死窗口。

✨ 新亮点

• 🧹 根目录平铺照片自动归档 — 注册相册时若根目录直接放着照片，会弹出确认：一键创建默认旅行并把照片移进对应文件夹（可改旅行名）；取消则不导入、不移动任何文件。归档失败自动回滚，绝不留半成品
• 📁 空子目录建旅行 — 「先建目录骨架、后补照片」的习惯现在被完整支持：扫描时空子目录也会创建旅行（0 张照片），时间线里以拍立得空白相框占位，随时编辑或删除
• 🗺 地图国内直连 — 瓦片源换为 Esri 卫星影像（免 Key、国内网络实测稳定加载）+ OSM 回退，多源失败自动切换；照片标记与 EXIF 坐标同系（WGS-84），落点无偏移
• 🔀 排列方式切换 — 照片墙新增「按时间 / 填充」两种排布：时间序为行优先网格，阅读顺序与时间线一致，旅行页照片改按拍摄时间排序（此前是文件名/导入序），灯箱翻页同步跟随；偏好跨启动记忆
• 📐 密度三档 — 照片墙「大 / 中 / 小」密度随意切：最小档 1080p 一屏约 42 张，批量挑拣归类效率倍增；切换即时生效、全局记忆
• 🎯 按旅行筛选 — 首页照片墙新增可折叠筛选树：选中某次旅行只看它的照片，计数同步「X / Y」，与收藏/标签/年份筛选叠加
• 🖱 多选反馈强化 — 选中卡片改为全周均匀的 3px 主题色描边 + 柔和遮罩，勾选徽标改高对比不透明底（选中为绿色粗白勾），过曝/深色照片上一眼可辨；五套主题明暗全部适配
• ⚡ 大批量导入不再卡死 — 缩略图未生成完的照片以占位块显示、绝不回退加载原图（此前首扫期间打开照片墙可能把 Windows 窗口打到「未响应」）；缩略图边生成边点亮，无需刷新
• 🚀 缩略图生成提速 — 图片与视频分池并行（慢视频不再拖住图片）、并发按 CPU 自适应有界、数据库事务批量落盘；3000 张实测总耗时缩短约 11%，中途退出重启自动续跑

📸 新功能速览

🛠 修复与体验优化

• 首次扫描不再无响应（Windows）：未就绪缩略图统一占位化，原图只在灯箱单张查看时加载——根除了「照片墙批量加载原图 + HEIC 实时转码」把渲染与主进程同时打满的死结
• 滚动回弹消失：照片卡固定宽高比占位，懒加载完成不再触发瀑布流重平衡；单次勾选只重渲染对应卡片（实测 1/420），滚动中位帧间隔 16.7ms（≈60fps）
• 旅行页照片墙增量渲染：千张级旅行首屏渲染 500 张、触底追加，不再一次性挂载全部 DOM
• 空旅行/未填日期不再显示「? 天旅程」：结束日期缺省按当天计，起止缺一不显示天数
• 修复旅行页加载态白屏：旅行数据未就绪时组件提前返回后的 hook 会触发 React #310 崩溃，已将排序改为纯计算规避
• 时间线卡片、灯箱胶片条、标签/图注/移动弹层的缩略图占位统一，弱网/首扫体验一致

📦 下载

平台	文件
macOS（Apple Silicon，macOS 14+）	gallery-0.13.0-mac-arm64.dmg
Windows 10/11（64 位）	gallery-0.13.0-win-x64.exe

升级提示：数据库结构无变化，直接覆盖安装即可。照片文件始终原地不动。

首次运行提示：安装包未做代码签名——macOS 首次启动若提示无法验证开发者，到「系统设置 → 隐私与安全性」点击**「仍要打开」**，或执行 xattr -cr /Applications/画廊.app；Windows SmartScreen 弹窗点击「更多信息 → 仍要运行」。

v0.12.0

画廊 v0.12.0 · 回收站、首页照片墙、翻阅室灯箱与五套主题

把旅行照片，做成一本翻不腻的手账。本地优先 · 免安装即用 · 照片原地不动。

这一版补上了照片管理最要紧的一块拼图：删除从此可反悔。旅行和照片先进回收站，随时恢复；配合重做的灯箱翻阅室、全新的首页照片墙和全套右键菜单，浏览、整理、反悔都顺手了。视觉上则完成了整套语义主题系统重构：五套主题各有完整明暗映射，还支持用自定义 CSS 随心换色。

✨ 新亮点

• 🗑 回收站 — 删除旅行或照片不再直接进废纸篓：先软删除收进相册内的隐藏回收站（文件原地挪入 .gallery-trash，扫描与监听天然无视），随时恢复；「彻底删除」才送入系统废纸篓作为误操作的最后一道保险。外置盘没插时拒绝删除，绝不误伤
• 🏠 首页照片墙 — 首页在「时间线 / 照片墙」间一键切换：全部旅行的照片与视频按拍摄时间从新到旧铺成瀑布流，万张级相册也能流畅滚动（增量渲染 + 惰性加载）
• 🔍 灯箱「翻阅室」 — 暖褐深色房间 + 拍立得主舞台 + 楷体图注 + 底部胶片条。单击缩放、滚轮/双击缩放平移、←→ 翻页、Space 播放、I 信息卡、F 全屏、⌫ 删除；视频直接拖进度条
• 🎨 五套主题 — 全新语义主题引擎：暖纸（米白暖棕）、烛光（蜜色琥珀暗房）、月白（素白青灰）、黛蓝（黛蓝靛青）、青瓷（青瓷釉色），每套都有完整的明暗两幅映射；亮 / 暗 / 跟随系统三态依旧，切换即时生效、重启保持
• 🖌 自定义 CSS — 设置里一键打开 theme.css，用语义 token 覆盖任意颜色（可按主题 × 明暗组合选择器），保存即热更新、无需重启
• 🖱 桌面式右键菜单 — 照片、旅行、空白区、回收站全套右键菜单（支持键盘操作与子菜单）；照片墙多选后批量收藏 / 移动 / 删除
• 📦 移动到旅行 — 照片与视频可在旅行之间搬家（文件随迁、封面自动交接、重名自动避让），也可在移动时顺手新建旅行
• ⭐ 封面即时生效 — 「设为封面」立即反映到时间线卡片：堆叠首图跟随封面（本次修复；此前封面只改徽标，主视图毫无变化）

📸 新功能速览

🛠 修复与体验优化

• 可读性达标：全应用颜色通过 WCAG 对比度契约（正文 ≥ 4.5:1、大字 ≥ 3:1，全部主题 × 明暗组合由测试自动校验）——主按钮改为主题色配对墨色，次要文字重定档，暗色下的低对比按钮一并修复
• Esc 分层：多层弹层叠放时 Esc 只作用于最上层——灯箱上取消删除确认不再连灯箱一起关掉，多选态上关菜单不再连带退出多选
• 时区修复：拍摄时间与旅行日期统一按本地时区入库展示，东八区凌晨拍摄的照片不再「提前一天」
• 恢复旅行不再被改名：从回收站恢复「日本之行」得到「日本之行 (2)」的bug已修复
• 批量删除/移动后灯箱跟随当前张，不再跳到错误的照片
• 崩溃防护：后台扫描/回填/缩略图任务全面兜底，外置盘拔出、监听异常等场景不再可能打断应用
• 侧栏相册操作（重新定位被占用、扫描失败、重命名）失败给出明确提示
• macOS 关窗常驻 Dock（点图标重建窗口）；窗口位置记忆钳制屏内；日期时区、缩略图队列、文件监听等十余项稳定性加固

📦 下载

平台	文件
macOS（Apple Silicon，macOS 14+）	gallery-0.12.0-mac-arm64.dmg
Windows 10/11（64 位）	gallery-0.12.0-win-x64.exe

升级提示：首次启动会自动完成数据库 v4 迁移与一次性数据自愈（从 .settings.json 补回历史标签/图注，只填空、绝不覆盖你的编辑）。照片文件始终原地不动。

首次运行提示：安装包未做代码签名——macOS 首次启动若提示无法验证开发者，到「系统设置 → 隐私与安全性」点击**「仍要打开」**，或执行 xattr -cr /Applications/画廊.app；Windows SmartScreen 弹窗点击「更多信息 → 仍要运行」。

v0.11.0

画廊 v0.11.0 · 地图、手账导出与照片级整理

把旅行照片，做成一本翻不腻的手账。本地优先 · 免安装即用 · 照片原地不动。

自 v0.9.0 以来的第一个新版本：旅行有了地图，一次旅行可以排成一本纸感手账导出带走，收藏与标签也细分到了每一张照片。

✨ 新亮点

• 🗺 地图视图 — 有 GPS 的照片自动落点在地图上，点击拍立得标记直接定位到那张照片；没带位置的照片也有贴心引导（底图 © OpenStreetMap 贡献者）
• 📖 导出手账 — 一键把旅行排成米白纸感的手账长卷：楷体标题、拍立得照片、缝线分隔。可导出 PDF（矢量，可送印）或长图 PNG（适合分享）
• ❤️ 照片级收藏与标签 — 收藏和小标签可以精确到每张照片；照片墙「只看收藏 / 按标签过滤」，⌘K 搜索也能命中照片标签
• 🍎 HEIC / HEIF — iPhone 原片直接导入浏览（缩略图与大图自动转码，拍摄时间与位置照常读取）
• 🗑 删除旅行 — 时间线卡片与旅行页顶栏均可删除；一律移入系统废纸篓，可反悔

📸 新功能速览

📦 下载

平台	文件
macOS（Apple Silicon，macOS 14+）	gallery-0.11.0-mac-arm64.dmg
Windows 10/11（64 位）	gallery-0.11.0-win-x64.exe

安装包未经代码签名：macOS 首次打开若提示无法验证开发者，到「系统设置 → 隐私与安全性」点击**「仍要打开」**，或在终端执行一次 xattr -cr /Applications/画廊.app（macOS 15 起旧的「右键 → 打开」绕过已失效）；Windows 在 SmartScreen 弹窗中选择「更多信息 → 仍要运行」。

📝 全部变更（自 v0.9.0）

整理与时间

• 照片按 EXIF 真实拍摄时间排序；存量照片自动回填，开始日期为空的旅行可按照片自动推断
• 图注编辑：照片墙悬停按钮 / 灯箱内随时写

灯箱重做

• 滚轮 / 双击缩放（指针锚点）、拖拽平移、底部缩略图胶片条、信息栏（序号 / 文件名 / 摄于日期 / 尺寸）
• 灯箱内直接删除、设封面、收藏、写标签

⌘K 搜索

• 全局搜索旅行标题 / 描述 / 标签 / 图注 / 照片标签，按旅行聚合并标注命中字段、高亮命中词；空查询快速跳转

地图与导出

• 扫描与导入时读取 GPS 入库；地图视图支持亮暗主题、离线优雅降级
• 手账导出为纸制品配色，不随应用主题；超大旅行自动分段，封面缺失有占位

体验与修复

• 大相册（数百张）滚动流畅，照片墙按需渲染
• 拖照片进窗口即可选择放入哪次旅行；删除、导入等操作全部改为应用内确认与轻提示
• 数据库自动迁移（v1→v3），老数据无感升级

---

MIT License · 如果画廊对你有用，欢迎 Star ⭐ 与反馈 Issue。

v0.9.0

画廊 v0.9.0 · 第一个公开预览版

把旅行照片，做成一本翻不腻的手账。本地优先 · 免安装即用 · 照片原地不动。

画廊是一款本地优先的旅行照片管理桌面应用：把你已有的照片文件夹变成一条按日期排开的手账时间线——拍立得照片堆叠、和纸胶带日期贴、缝线书脊。没有账号、没有云、没有追踪，照片永远在你自己的硬盘上。

✨ 亮点

• 📅 手账时间线 — 旅行按日期倒序排开，封面照片以拍立得堆叠呈现，悬停即散开
• 🖼 照片墙 + 灯箱 — 瀑布流缩略图秒开，灯箱看原图，←/→ 切换，视频直接拖进度条
• 🗂 多相册 — 注册多个照片根目录随切随换；外置硬盘拔出灰显、插回即恢复
• 🏷 标签 / 收藏 / 年份 — 三类筛选自由叠加，标签输入带常用联想
• 🌗 三态主题 — 亮 / 暗 / 跟随系统，暗色是特调的暖褐「烛光」配色
• 🛡 数据自持 — 照片原地不动，元数据只是一个本地 SQLite 文件，随时可以带走

📸 界面速览

手账时间线	烛光暗色
旅行照片墙	灯箱看图

📦 下载

平台	文件
macOS（Apple Silicon，macOS 14+）	gallery-0.9.0-mac-arm64.dmg
Windows 10/11（64 位）	gallery-0.9.0-win-x64.exe

安装包未经代码签名：macOS 首次打开请右键 → 打开（或在系统设置 → 隐私与安全性中「仍要打开」）；Windows 在 SmartScreen 弹窗中选择「更多信息 → 仍要运行」。

📝 全部变更

Electron 重写后的首个公开版本（自 v0.8 的 Web 版完全重构）：

• electron-vite + React 18 + TypeScript 5 + Tailwind v4 全新桌面架构
• SQLite（better-sqlite3）本地元数据 + sharp 缩略图队列 + 自定义 gallery-media:// 协议（支持视频 Range 请求）
• 相册目录扫描入库、watcher 实时同步、缺失相册检测与重定位
• 拖拽导入、旧版 .settings.json 数据一键迁移、废纸篓安全删除
• 手账风界面（语义化设计 token）、三态主题、标签输入联想、矢量图标体系

---

MIT License · 如果画廊对你有用，欢迎 Star ⭐ 与反馈 Issue。