OliverZhaohaibin/iPhotron-LocalPhotoAlbumManager

📦 🚀 v6.6.6 — Internationalization, Map Runtime & Location Resilience

• 🌐 Major improvements to UI internationalization, runtime language switching, map preview runtime behavior, and location assignment reliability.

📦 Key Updates

• Added TranslationManager as a runtime service on RuntimeContext, backed by the `ui.language` setting and runtime `languageChanged` refresh signals.
• Added bundled Qt translation resources for German and Simplified Chinese, including `languages.json` metadata and package-data coverage for `.ts` / `.qm` resources.
• Added a language menu under Settings with English, Deutsch, and 简体中文 choices; English remains the fallback language.
• Migrated major GUI surfaces to translated text, including main menus, status-bar feedback, info panel, People dashboard, album navigation, gallery context menus, detail/player controls, share/export feedback, face overlays, edit sidebar controls, and the standalone map preview entry point.
• Added locale-aware GUI formatters for dates, integers, decimals, and file sizes so translated surfaces do not depend on the host system locale.
• Added Python-aware i18n extraction through `tools/extract_i18n_strings.py` and `scripts/i18n_extract.sh`, covering `src/iPhoto/gui` and `src/maps`.
• Added `scripts/i18n_compile.sh` for rebuilding `.qm` translation resources with `pyside6-lrelease`.
• Added `tools/check_i18n_strings.py` and architecture tests to block direct English literals in high-risk GUI APIs such as `setText`, `setToolTip`, `QAction`, dialogs, and status messages.
• + 11 more

📦 🚀 v6.6.6 — 国际化、地图运行时与位置分配可靠性提升

• 🌐 针对 UI 国际化、运行时语言切换、地图预览运行时行为以及位置分配可靠性进行了全面优化。

📦 核心更新

• 新增 `TranslationManager`，并将其作为 `RuntimeContext` 上的运行时服务，由 `ui.language` 设置和运行时 `languageChanged` 刷新信号驱动。
• 新增内置 Qt 翻译资源，支持德语和简体中文，并包含 `languages.json` 元数据以及 `.ts` / `.qm` 资源的 package-data 覆盖。
• 在 Settings 下新增语言菜单，支持 English、Deutsch 和 简体中文；English 仍作为默认回退语言。
• 将主要 GUI 界面迁移为可翻译文本，包括主菜单、状态栏反馈、信息面板、People 面板、相册导航、图库右键菜单、详情页 / 播放器控件、分享 / 导出反馈、人脸覆盖层、编辑侧边栏控件以及独立地图预览入口。
• 新增支持区域设置的 GUI 格式化工具，用于日期、整数、小数和文件大小显示，避免翻译界面依赖宿主系统语言环境。
• 新增面向 Python 的 i18n 字符串提取工具 `tools/extract_i18n_strings.py` 和 `scripts/i18n_extract.sh`，覆盖 `src/iPhoto/gui` 与 `src/maps`。
• 新增 `scripts/i18n_compile.sh`，用于通过 `pyside6-lrelease` 重新生成 `.qm` 翻译资源。
• 新增 `tools/check_i18n_strings.py` 和架构测试，阻止在 `setText`、`setToolTip`、`QAction`、对话框和状态消息等高风险 GUI API 中直接写入英文文案。
• + 10 more

⚡ 🚀 v6.5.0 — Large Library Performance, Scan Recovery & Location Reliability

• 🖼️ Major improvements to large-library gallery responsiveness, scan batching and recovery, location assignment reliability, and collection pagination stability.

📦 Key Updates

• Refined thumbnail loading, backfill behavior, and startup sizing calculations to keep large galleries responsive.
• Preserved gallery selection state across refreshes.
• Fixed regressions caused by optimistic mutation updates.
• Kept scan progress visible while switching between albums.
• Improved progressive publish updates for smoother gallery refresh behavior.
• Coalesced scan batches to improve scanning efficiency and reduce update overhead.
• Improved backfill event handling during library synchronization.
• Tightened thumbnail cache readiness validation before gallery presentation.
• + 13 more

📦 🚀 v6.5.0 — 大型图库性能优化、扫描恢复与位置可靠性提升

• 🖼️ 针对大型图库浏览性能、扫描批处理与恢复机制、位置分配可靠性以及收藏集分页稳定性进行了全面优化。

📦 核心更新

• 优化缩略图加载、回填（Backfill）逻辑以及启动时的尺寸计算，提升大型图库的响应速度。
• 在刷新后保留图库选中状态。
• 修复乐观更新（Optimistic Mutation）导致的回归问题。
• 在切换相册时持续显示扫描进度。
• 改进渐进式发布（Progressive Publish）更新机制，使图库刷新过程更加平滑。
• 合并扫描批次，提升扫描效率并减少更新开销。
• 优化图库同步过程中的回填事件处理。
• 加强图库显示前的缩略图缓存就绪状态校验。
• + 12 more

🐛 🚀 v6.1.0 — Legacy Dependency Cleanup, Map Extension Fixes & Stability

• 🧹 Cleanup after the MVVM refactor, a critical Map Extension download fix, and a focused round of stability improvements across the application.

📦 Key Updates

• Removed remaining legacy-code dependencies left after the MVVM architecture refactor.
• Cleaned up obsolete compatibility paths that were no longer required by the new view-model driven structure.
• Reduced coupling between modern UI components and older implementation layers.
• Improved maintainability by ensuring the post-MVVM code path no longer relies on deprecated legacy modules.
• Simplified internal architecture boundaries to make future feature development and debugging more predictable.
• Fixed a bug where Map Extension downloads could become stuck and never complete.
• Improved download-state handling to prevent the extension installer from remaining in a blocked or pending state.
• Hardened error recovery during Map Extension setup so interrupted or failed downloads can be handled more reliably.
• + 6 more

📦 🚀 v6.1.0 — Legacy 依赖清理、地图扩展修复与稳定性提升

• 🧹 清理 MVVM 重构后的遗留依赖，修复 Map Extension 下载卡死问题，并进行一轮针对整体稳定性的修复。

📦 核心更新

• 移除了 MVVM 架构重构后残留的 legacy 代码依赖。
• 清理了新架构中已不再需要的旧兼容路径。
• 降低了现代 UI 组件与旧实现层之间的耦合。
• 确保重构后的 MVVM 代码路径不再依赖已废弃的 legacy 模块，从而提升可维护性。
• 简化了内部架构边界，使后续功能开发和问题定位更加清晰、可预测。
• 修复了 Map Extension 下载过程中可能卡死、无法完成的问题。
• 改进了下载状态处理，避免扩展安装器停留在阻塞或等待状态。
• 强化了 Map Extension 安装过程中的错误恢复能力，使中断或失败的下载能够更可靠地处理。
• + 6 more

📦 🚀 v6.0.0 — People, Face Clusters, Groups & Linux Maps Runtime

• 👥 *A major People release with automatic face clustering, persistent People
• state, multi-person groups, richer location metadata, and broader Windows/Linux
• runtime packaging.*

📦 Key Updates

• Added the optional People face-scanning pipeline powered by InsightFace
• and ONNXRuntime through the `ai-demo` extra.
• Detects faces in image assets, writes cropped face thumbnails, builds face
• embeddings, and clusters them into persistent People cards.
• Added background face-scan scheduling alongside the normal asset scan, with
• `pending`, `done`, `skipped`, `retry`, and `failed` status tracking in the
• global asset index.
• Rebuilt the People persistence model around a rebuildable runtime snapshot
• + 48 more

📦 🚀 v6.0.0 — People、人脸聚类、Group 与 Linux 地图运行时

• 👥 *这是一次重要的 People 功能发布，带来了自动人脸聚类、持久化 People 状态、多人 Group、更丰富的位置元数据，以及更完整的 Windows/Linux 运行时打包支持。*

📦 主要更新

• 新增可选的 People 人脸扫描管线，通过 `ai-demo` extra 集成 InsightFace 与 ONNXRuntime。
• 可检测图片资源中的人脸，写入裁剪后的人脸缩略图，生成人脸 embedding，并将其聚类为持久化的 People 卡片。
• 在常规资源扫描之外新增后台人脸扫描调度，并在全局资源索引中记录 `pending`、`done`、`skipped`、`retry` 和 `failed` 状态。
• 重构 People 持久化模型：基于可重建的运行时快照和稳定的 People 状态，让姓名、封面、排序、隐藏标记和 Group 决策在重新扫描与重新聚类后仍能保留。
• 新增 People Group，用于收集多个选中人物共同出现的照片。
• Group 卡片支持共同照片查询、封面选择、拖拽排序、置顶状态，以及不删除底层人物或照片的安全解散。
• 新增 People 卡片操作：命名、合并、隐藏/取消隐藏、封面管理，以及 Dashboard 中的隐藏人物过滤。
• 加强合并安全性，避免隐藏人物和可见人物被误合并。
• + 16 more

📦 🚀 v6.0.0 — People, Face Clusters, Groups & Linux Maps Runtime

• 👥 *A major People release with automatic face clustering, persistent People
• state, multi-person groups, richer location metadata, and broader Windows/Linux
• runtime packaging.*

📦 Key Updates

• Added the optional People face-scanning pipeline powered by InsightFace
• and ONNXRuntime through the `ai-demo` extra.
• Detects faces in image assets, writes cropped face thumbnails, builds face
• embeddings, and clusters them into persistent People cards.
• Added background face-scan scheduling alongside the normal asset scan, with
• `pending`, `done`, `skipped`, `retry`, and `failed` status tracking in the
• global asset index.
• Rebuilt the People persistence model around a rebuildable runtime snapshot
• + 45 more

📦 🚀 v5.0.0 — Video Editing, Trim System & Platform Stability

• 🎬 *Full non-destructive video editing, a visual trim timeline, centralized keyboard shortcuts, and a sweeping round of Linux/GL stability fixes.*

📦 Key Updates

• <img width="1800" height="1080" alt="image" src="https://github.com/user-attachments/assets/893fd6a5-dbb1-4441-bfed-aa7d611646c8" />
• Introduced a complete non-destructive video editing suite powered by a smooth OpenGL-accelerated preview pipeline.
• Added a visual trim timeline with thumbnail strip, draggable in/out handles, and real-time playhead clamping inside the trim range.
• Trim in/out points are saved to the sidecar file and persist across app restarts; the gallery duration badge now reflects the trimmed length.
• Playback progress bar is remapped to the active trim range so the scrubber always tracks the visible portion of the clip.
• Fixed stale progress bar after returning from edit mode — duration is force-synced when the video is reloaded.
• Added video transport keyboard shortcuts (seek, play/pause, frame-step) inside the video edit panel.
• Simplified the video edit sidebar section layout for a cleaner editing experience.
• + 32 more

📦 🚀 v5.0.0 — 视频编辑、裁剪系统与平台稳定性

• 🎬 *全功能非破坏性视频编辑、可视化裁剪时间线、集中式快捷键管理，以及针对 Linux/GL 稳定性的大规模修复。*

📦 核心更新

• 引入了全套非破坏性视频编辑套件，由平滑的 OpenGL 加速预览管线驱动。
• 新增可视化裁剪时间线，包含缩略图条、可拖动的入点/出点手柄，以及裁剪范围内的实时播放头限制。
• 裁剪的入点和出点将保存至 Sidecar 文件并在应用重启后持久保存；图库中的时长角标现在会反映裁剪后的长度。
• 播放进度条已重新映射至激活的裁剪范围，确保进度滑块始终对应片段的可视部分。
• 修复了从编辑模式返回后进度条停滞的问题——在视频重新加载时强制同步时长。
• 在视频编辑面板中增加了视频传输快捷键（寻道、播放/暂停、逐帧步进）。
• 简化了视频编辑侧边栏的布局，提供更清爽的编辑体验。
• 引入 `AppShortcutManager` —— 统一管理所有应用级键盘绑定的类，消除了跨组件的重复快捷键设置。
• + 30 more

📦 🚀 v5.0.0 — Video Editing, Trim System & Platform Stability

• 🎬 *Full non-destructive video editing, a visual trim timeline, centralized keyboard shortcuts, and a sweeping round of Linux/GL stability fixes.*

📦 Key Updates

• Introduced a complete non-destructive video editing suite powered by a smooth OpenGL-accelerated preview pipeline.
• Added a visual trim timeline with thumbnail strip, draggable in/out handles, and real-time playhead clamping inside the trim range.
• Trim in/out points are saved to the sidecar file and persist across app restarts; the gallery duration badge now reflects the trimmed length.
• Playback progress bar is remapped to the active trim range so the scrubber always tracks the visible portion of the clip.
• Fixed stale progress bar after returning from edit mode — duration is force-synced when the video is reloaded.
• Added video transport keyboard shortcuts (seek, play/pause, frame-step) inside the video edit panel.
• Simplified the video edit sidebar section layout for a cleaner editing experience.
• Introduced `AppShortcutManager` — a single class that owns all application-level keyboard bindings, eliminating duplicated shortcut setup across components.
• + 31 more

📦 🚀 v5.0.0 — 视频编辑、裁剪系统与平台稳定性

• 🎬 *全功能非破坏性视频编辑、可视化裁剪时间线、集中式快捷键管理，以及针对 Linux/GL 稳定性的大规模修复。*

📦 核心更新

• 引入了全套非破坏性视频编辑套件，由平滑的 OpenGL 加速预览管线驱动。
• 新增可视化裁剪时间线，包含缩略图条、可拖动的入点/出点手柄，以及裁剪范围内的实时播放头限制。
• 裁剪的入点和出点将保存至 Sidecar 文件并在应用重启后持久保存；图库中的时长角标现在会反映裁剪后的长度。
• 播放进度条已重新映射至激活的裁剪范围，确保进度滑块始终对应片段的可视部分。
• 修复了从编辑模式返回后进度条停滞的问题——在视频重新加载时强制同步时长。
• 在视频编辑面板中增加了视频传输快捷键（寻道、播放/暂停、逐帧步进）。
• 简化了视频编辑侧边栏的布局，提供更清爽的编辑体验。
• 引入 `AppShortcutManager` —— 统一管理所有应用级键盘绑定的类，消除了跨组件的重复快捷键设置。
• + 30 more

📦 🚀 v4.6.0 — Windows Maps Extension & Offline OsmAnd Runtime

• 🗺️ *A new Windows-only maps extension brings the offline OsmAnd/OBF runtime into iPhotron, with clearer packaging, installer integration, and a documented upstream build workflow.*

📦 Key Updates

• Added a self-contained maps extension rooted at `src/maps/tiles/extension/` for the offline OBF map runtime.
• The bundled extension now carries `World_basemap_2.obf`, OsmAnd resources, and native runtime binaries in one predictable layout.
• Windows builds can use the native OsmAnd widget runtime for a fuller offline map experience while keeping the repository self-contained.
• <table>
• <thead>
• <tr>
• <th align="center">Without maps extension</th>
• <th align="center">With maps extension</th>
• + 23 more

📦 🚀 v4.6.0 — Windows 地图扩展与离线 OsmAnd 运行时

• 🗺️ *新增的 Windows 专用地图扩展为 iPhotron 引入了离线 OsmAnd/OBF 运行时，并带来了更清晰的打包结构、安装程序集成以及文档化的上游构建工作流。*

📦 关键更新

• 在 `src/maps/tiles/extension/` 目录下新增了自包含的 地图扩展 (maps extension)，用于支持离线 OBF 地图运行时。
• 绑定的扩展现在集成了 `World_basemap_2.obf`、OsmAnd 资源文件以及原生运行时二进制文件，采用了统一的可预测布局。
• Windows 版本现在可以使用原生的 OsmAnd 挂件运行时，以获得更完整的离线地图体验，同时保持仓库的自包含性。
• 优化了地图后端启动逻辑，使 iPhotron 在运行时环境健康时优先选择原生 Windows 挂件。
• 保留了基于 Python/辅助程序的 OBF 渲染器作为实用的备选路径。
• 在原生地图扩展仅限 Windows 使用期间，Linux 和 macOS 将继续使用现有的 Python 或旧版地图路径。
• 围绕相同的扩展目录规范，统一了本地开发、Nuitka 打包以及 Windows 安装程序的处理逻辑。
• 记录了扩展如何同步到打包构建版本以及可选安装程序资产中的过程。
• + 4 more

📦 🚀 v4.5.0 — Color Grading Expansion & Video Compatibility Improvements

• 🎨 *A richer color grading workflow, new creative tools, stronger video compatibility, and more native desktop window behavior.*

📦 Key Updates

• Further refined the color grading experience for smoother, more precise adjustment workflows.
• Added new editing tools including Definition, Noise Reduction, Sharpen, and Vignette.
• Sharpen includes dedicated `Intensity`, `Edges`, and `Falloff` controls, while Vignette adds `Strength`, `Radius`, and `Softness` adjustments.
• Improved the overall editing flow to make advanced adjustments feel more consistent and intuitive.
• <img width="536" height="1038" alt="image" src="https://github.com/user-attachments/assets/fd92e78c-a260-4ca4-a528-fcaf2ea7320e" />
• Fixed preview black borders: Videos now render correctly in preview mode without unwanted letterboxing artifacts.
• Fixed HEVC and HDR display issues: Improved compatibility for modern video formats to ensure more reliable playback and preview rendering.
• Better overall media presentation consistency across different codecs and dynamic-range formats.
• + 4 more

📦 🚀 v4.5.0 — 色彩分级扩展与视频兼容性改进

• 🎨 *更丰富的色彩分级工作流、全新的创意工具、更强的视频兼容性，以及更原生的桌面窗口行为。*

📦 主要更新

• 进一步优化了色彩分级体验，带来更顺畅、更精确的调整工作流。
• 添加了全新的编辑工具，包括清晰度、降噪、锐化和暗角。
• 锐化包含专属的 `强度`、`边缘` 和 `衰减` 控制，而暗角则添加了 `强度`、`半径` 和 `柔和度` 调整。
• 改进了整体编辑流程，使高级调整操作感觉更加一致和直观。
• 修复了预览黑边问题： 视频现在能够在预览模式下正确渲染，不再出现多余的黑边（信箱模式）伪影。
• 修复了 HEVC 和 HDR 显示问题： 提升了对现代视频格式的兼容性，以确保更可靠的播放和预览渲染。
• 改善了跨不同编解码器和动态范围格式时，整体媒体呈现的一致性。
• 修复了 Linux 上缩略图方向错误的问题： 解决了一个间歇性问题，该问题偶尔会导致生成的视频缩略图出现旋转角度错误。
• + 4 more

📋 Changes

• Linux Version Enters Alpha Testing!!!
• Native RAW Image Support
• Aspect Ratio Constraints for Cropping
• Fullscreen and General Bug Fixes
• Linux 版本进入 Alpha 测试！！！
• 新增对 RAW 格式图片的支持
• 裁剪功能新增比例约束选项
• 修复全屏问题及其他 Bug

📦 🏗️ MVVM Architecture — More Complete, More Stable State-Driven UI

• Addressing feedback: “Complex states feel inconsistent, refresh behavior is unstable, maintenance is costly.”
• Stronger MVVM boundaries: clearer responsibilities across View / ViewModel / Model, reducing cross-layer coupling and implicit dependencies.
• Upgraded state management: standardized UI State (Loading / Content / Empty / Error) to prevent edge-case rendering divergence.
• More consistent unidirectional data flow: the View only subscribes to ViewModel outputs; all mutations enter through the ViewModel, eliminating multi-source updates.
• Better testability: critical logic moved into ViewModel + UseCase/Service layers for finer unit testing and safer regression coverage.
• Lifecycle & resource governance: subscriptions and async tasks are properly scoped and disposed with lifecycle events to reduce leaks and background overhead.
• ---

⚡ ⚡ Scrolling Performance Boost — Dramatically Smoother Browsing

• Addressing feedback: “Scrolling drops frames, fast flicking loads thumbnails slowly, occasional freezes.”
• Lighter rendering pipeline: reduced unnecessary re-renders and layout recalculations for steadier high FPS while scrolling.
• Enhanced virtualization for lists/grids: improved visible-range computation and reuse strategy to lower UI workload on large datasets.
• Smarter thumbnail loading: prefetch + prioritization for on-screen items, with progressive loading and better decode scheduling.
• Cache improvements: multi-level caching (memory + disk) with smarter eviction to stabilize hit rate and reduce redundant decoding.
• Async task coordination: better debouncing/coalescing for rapid scroll events to avoid main-thread contention and request storms.
• Lower memory churn: fewer transient allocations during fast scrolling, reducing GC/ARC pressure and micro-stutters.
• ---
• + 8 more

📦 🏗️ MVVM 架构 — 架构完善，状态驱动更稳定

• 回应用户反馈：“复杂场景状态不一致、刷新不稳定、维护成本高”
• MVVM 分层进一步标准化：统一 View / ViewModel / Model 职责边界，减少跨层调用与隐式依赖。
• 状态管理体系升级：统一 UI State（Loading / Content / Empty / Error），降低边界场景渲染分歧。
• 单向数据流更彻底：View 仅订阅 ViewModel 输出；所有数据变更统一从 ViewModel 入口触发，避免“多源更新”。
• 可测试性增强：核心业务逻辑下沉到 ViewModel 与 UseCase/Service 层，支持更细粒度单元测试与回归覆盖。
• 生命周期与资源治理：订阅与异步任务跟随生命周期自动回收，减少泄漏与后台无效工作。
• ---

📦 ⚡ 滚动性能大幅提升 — 浏览更丝滑、更稳定

• 回应用户反馈：“滚动掉帧、快速滑动缩略图加载慢、偶发卡顿”
• 渲染链路减负：减少无效重绘与重复布局计算，滚动过程中更稳定维持高帧率。
• 列表/网格虚拟化增强：优化可见区域计算与复用策略，显著降低大数据集下的 UI 压力。
• 缩略图加载更智能：增加预取与优先级调度，优先保障屏幕内内容，支持渐进式加载并优化解码时机。
• 缓存体系优化：内存 + 磁盘多级缓存与更合理的淘汰策略，提升命中率，减少重复解码与 IO 抖动。
• 异步任务协同：对快速滚动事件做去抖/合并，避免主线程争用与请求风暴。
• 降低内存抖动：减少滚动中的临时对象分配，降低 GC/ARC 压力与微卡顿概率。
• ---
• + 1 more

📦 🚀 iPhoto v4.01 — MVVM Architecture & Advanced Editing

• 📸 *MVVM architecture for smooth performance, color curves support, and cluster-based map browsing.*
• We're excited to announce iPhoto v4.01! 🎉
• ---

📦 🌟 Key Updates in v4.01

• *Addressing user feedback: "Reduced lag and improved responsiveness"*
• Complete Architectural Refactoring: We have transformed the codebase to follow the Model-View-ViewModel (MVVM) design pattern.
• Separation of Concerns: Clear separation between UI presentation, business logic, and data management layers.
• Reactive UI Updates: The ViewModel efficiently manages state changes and automatically updates the View, eliminating unnecessary re-renders.
• Reduced Operation Lag: Significantly lower UI freezing and lag during photo browsing, editing, and library management operations.
• Enhanced System Fluency: Smooth scrolling, instant thumbnail loading, and responsive interactions even with large photo libraries.
• Better Resource Management: Improved memory usage and CPU efficiency through proper data binding and lifecycle management.
• <img width="2123" height="1251" alt="image" src="https://github.com/user-attachments/assets/0e4b0c68-e062-4f24-94ad-c6f2b9516185" />
• + 74 more

✨ 🎯 Core Features (Carried Forward)

• All beloved features from previous versions remain fully supported:
• 🎥 Full Live Photo Support
• Automatically pairs HEIC/JPG + MOV files by content-ID or timestamp, with a "LIVE" badge and inline playback.
• 🗂 Folder = Album
• Each folder becomes an album, managed by `.iphoto.album.json` (or `.iphoto.album`).
• 🧠 Smart Albums
• Built-in "Library", "All Photos", "Videos", "Favorites", and "Recently Deleted" views.
• 🖼 Immersive Detail Viewer
• + 6 more

📦 🔧 Technical Highlights

• ```
• View Layer (UI Components)
• ↓ (Data Binding)
• ViewModel Layer (State Management & Business Logic)
• ↓ (Data Access)
• Model Layer (SQLite Database & File System)
• ```
• Key Advantages:
• + 12 more

📦 🇨🇳 iPhoto v4.01 — MVVM 架构与高级编辑

• 📸 *MVVM 架构带来流畅性能，支持调色曲线，地图按聚类浏览。*
• 我们非常激动地宣布 iPhoto v4.01 正式发布！🎉
• 这个重大更新带来了完整的 MVVM 设计模式架构转型，大幅降低操作卡顿感，提高系统流畅度。我们还增加了强大的 调色曲线调整 功能和 基于聚类的地图导航，带来更好的照片管理体验。
• ---

📦 🌟 v4.01 主要更新

• *回应用户反馈：降低卡顿，提升响应速度*
• 完整的架构重构： 我们将代码库转换为遵循 Model-View-ViewModel (MVVM) 设计模式。
• 关注点分离： UI 呈现层、业务逻辑层和数据管理层之间的清晰分离。
• 响应式 UI 更新： ViewModel 高效管理状态变化并自动更新视图，消除不必要的重新渲染。
• 降低操作延迟： 在照片浏览、编辑和图库管理操作期间，显著减少 UI 冻结和卡顿。
• 增强系统流畅度： 即使在大型照片库中，也能实现流畅滚动、即时缩略图加载和响应式交互。
• 更好的资源管理： 通过适当的数据绑定和生命周期管理，改善内存使用和 CPU 效率。
• 专业级色彩编辑，提供多种精密工具：
• + 70 more

📦 🎯 核心功能（继承自之前版本）

• 之前版本中的所有核心功能均得到完整保留：
• 🎥 完整的 Live Photo 支持：自动配对 HEIC/JPG 与 MOV 文件，静态照片带 "LIVE" 徽章，可直接播放动态视频。
• 🗂 文件夹即相册：每个文件夹均视为相册，通过 `.iphoto.album.json` 管理封面、精选与排序。
• 🧠 智能相册：内置 "图库"、"所有照片"、"视频"、"收藏"、"最近删除" 等自动聚合视图。
• 🖼 沉浸式查看器：带胶片条与浮动播放控件的照片/视频查看体验。
• 🎨 非破坏性照片编辑：包含调整和裁剪模式的全面编辑套件（v2.00 功能）。
• ⚡ SQLite 全局数据库：为 TB 级别照片库提供企业级性能（v3.00 架构）。
• ---

📦 🔧 技术亮点

• ```
• 视图层（UI 组件）
• ↓（数据绑定）
• 视图模型层（状态管理与业务逻辑）
• ↓（数据访问）
• 模型层（SQLite 数据库与文件系统）
• ```
• 主要优势：
• + 12 more

📦 📊 Version Comparison / 版本对比

• | Feature / 功能 | v3.00 | v4.01 |
• |----------------|--------|--------|
• | SQLite global database / SQLite 全局数据库 | ✅ | ✅ |
• | Non-destructive editing / 非破坏性编辑 | ✅ | ✅ |
• | Map view / 地图视图 | ✅ | ✅ |
• | Live Photo support / Live Photo 支持 | ✅ | ✅ |
• | MVVM Architecture / MVVM 架构 | ❌ | ✅ |
• | Color Curves / 调色曲线 | ❌ | ✅ |
• + 6 more

📦 💬 Feedback / 反馈与建议

• We'd love to hear from you!
• If you encounter any issues or have ideas for improvement, please open a ticket on [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotron-LocalPhotoAlbumManager/issues).
• Your feedback helps shape the future of iPhoto. 💙
• Thank you for your support!
• 我们非常期待您的反馈！
• 如果您在使用中发现问题，或有新的功能建议，欢迎前往 [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotron-LocalPhotoAlbumManager/issues) 提交。
• 每一条意见都将帮助我们让 iPhoto 变得更好。💙
• 感谢您的支持！
• + 3 more

📦 🚀 iPhoto v4.00 — MVVM Architecture & Advanced Editing

• 📸 *MVVM architecture for smooth performance, color curves support, and cluster-based map browsing.*
• We're excited to announce iPhoto v4.00! 🎉
• <img width="522" height="1125" alt="image" src="https://github.com/user-attachments/assets/71cba363-e88a-4cf8-a02d-7f47f2191664" />
• ---

📦 🌟 Key Updates in v4.00

• *Addressing user feedback: "Reduced lag and improved responsiveness"*
• Complete Architectural Refactoring: We have transformed the codebase to follow the Model-View-ViewModel (MVVM) design pattern.
• Separation of Concerns: Clear separation between UI presentation, business logic, and data management layers.
• Reactive UI Updates: The ViewModel efficiently manages state changes and automatically updates the View, eliminating unnecessary re-renders.
• Reduced Operation Lag: Significantly lower UI freezing and lag during photo browsing, editing, and library management operations.
• Enhanced System Fluency: Smooth scrolling, instant thumbnail loading, and responsive interactions even with large photo libraries.
• Better Resource Management: Improved memory usage and CPU efficiency through proper data binding and lifecycle management.
• Professional-grade color editing with multiple precision tools:
• + 69 more

✨ 🎯 Core Features (Carried Forward)

• All beloved features from previous versions remain fully supported:
• 🎥 Full Live Photo Support
• Automatically pairs HEIC/JPG + MOV files by content-ID or timestamp, with a "LIVE" badge and inline playback.
• 🗂 Folder = Album
• Each folder becomes an album, managed by `.iphoto.album.json` (or `.iphoto.album`).
• 🧠 Smart Albums
• Built-in "Library", "All Photos", "Videos", "Favorites", and "Recently Deleted" views.
• 🖼 Immersive Detail Viewer
• + 6 more

📦 🔧 Technical Highlights

• ```
• View Layer (UI Components)
• ↓ (Data Binding)
• ViewModel Layer (State Management & Business Logic)
• ↓ (Data Access)
• Model Layer (SQLite Database & File System)
• ```
• Key Advantages:
• + 12 more

📦 🇨🇳 iPhoto v4.00 — MVVM 架构与高级编辑

• 📸 *MVVM 架构带来流畅性能，支持调色曲线，地图按聚类浏览。*
• 我们非常激动地宣布 iPhoto v4.00 正式发布！🎉
• 这个重大更新带来了完整的 MVVM 设计模式架构转型，大幅降低操作卡顿感，提高系统流畅度。我们还增加了强大的 调色曲线调整 功能和 基于聚类的地图导航，带来更好的照片管理体验。
• ---

📦 🌟 v4.00 主要更新

• *回应用户反馈：降低卡顿，提升响应速度*
• 完整的架构重构： 我们将代码库转换为遵循 Model-View-ViewModel (MVVM) 设计模式。
• 关注点分离： UI 呈现层、业务逻辑层和数据管理层之间的清晰分离。
• 响应式 UI 更新： ViewModel 高效管理状态变化并自动更新视图，消除不必要的重新渲染。
• 降低操作延迟： 在照片浏览、编辑和图库管理操作期间，显著减少 UI 冻结和卡顿。
• 增强系统流畅度： 即使在大型照片库中，也能实现流畅滚动、即时缩略图加载和响应式交互。
• 更好的资源管理： 通过适当的数据绑定和生命周期管理，改善内存使用和 CPU 效率。
• 专业级色彩编辑，提供多种精密工具：
• + 66 more

📦 🎯 核心功能（继承自之前版本）

• 之前版本中的所有核心功能均得到完整保留：
• 🎥 完整的 Live Photo 支持：自动配对 HEIC/JPG 与 MOV 文件，静态照片带 "LIVE" 徽章，可直接播放动态视频。
• 🗂 文件夹即相册：每个文件夹均视为相册，通过 `.iphoto.album.json` 管理封面、精选与排序。
• 🧠 智能相册：内置 "图库"、"所有照片"、"视频"、"收藏"、"最近删除" 等自动聚合视图。
• 🖼 沉浸式查看器：带胶片条与浮动播放控件的照片/视频查看体验。
• 🎨 非破坏性照片编辑：包含调整和裁剪模式的全面编辑套件（v2.00 功能）。
• ⚡ SQLite 全局数据库：为 TB 级别照片库提供企业级性能（v3.00 架构）。
• ---

📦 🔧 技术亮点

• ```
• 视图层（UI 组件）
• ↓（数据绑定）
• 视图模型层（状态管理与业务逻辑）
• ↓（数据访问）
• 模型层（SQLite 数据库与文件系统）
• ```
• 主要优势：
• + 12 more

📦 📊 Version Comparison / 版本对比

• | Feature / 功能 | v3.00 | v4.00 |
• |----------------|--------|--------|
• | SQLite global database / SQLite 全局数据库 | ✅ | ✅ |
• | Non-destructive editing / 非破坏性编辑 | ✅ | ✅ |
• | Map view / 地图视图 | ✅ | ✅ |
• | Live Photo support / Live Photo 支持 | ✅ | ✅ |
• | MVVM Architecture / MVVM 架构 | ❌ | ✅ |
• | Color Curves / 调色曲线 | ❌ | ✅ |
• + 6 more

📦 💬 Feedback / 反馈与建议

• We'd love to hear from you!
• If you encounter any issues or have ideas for improvement, please open a ticket on [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotron-LocalPhotoAlbumManager/issues).
• Your feedback helps shape the future of iPhoto. 💙
• Thank you for your support!
• 我们非常期待您的反馈！
• 如果您在使用中发现问题，或有新的功能建议，欢迎前往 [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotron-LocalPhotoAlbumManager/issues) 提交。
• 每一条意见都将帮助我们让 iPhoto 变得更好。💙
• 感谢您的支持！
• + 3 more

📦 🚀 iPhoto v4.00 — MVVM Architecture & Advanced Editing

• 📸 *MVVM architecture for smooth performance, color curves support, and cluster-based map browsing.*
• We're excited to announce iPhoto v4.00! 🎉
• ---

📦 🌟 Key Updates in v4.00

• *Addressing user feedback: "Reduced lag and improved responsiveness"*
• Complete Architectural Refactoring: We have transformed the codebase to follow the Model-View-ViewModel (MVVM) design pattern.
• Separation of Concerns: Clear separation between UI presentation, business logic, and data management layers.
• Reactive UI Updates: The ViewModel efficiently manages state changes and automatically updates the View, eliminating unnecessary re-renders.
• Reduced Operation Lag: Significantly lower UI freezing and lag during photo browsing, editing, and library management operations.
• Enhanced System Fluency: Smooth scrolling, instant thumbnail loading, and responsive interactions even with large photo libraries.
• Better Resource Management: Improved memory usage and CPU efficiency through proper data binding and lifecycle management.
• <img width="489" height="702" alt="image" src="https://github.com/user-attachments/assets/f335f898-c2db-4997-99a0-1c68088ce1fe" />
• + 38 more

✨ 🎯 Core Features (Carried Forward)

• All beloved features from previous versions remain fully supported:
• 🎥 Full Live Photo Support
• Automatically pairs HEIC/JPG + MOV files by content-ID or timestamp, with a "LIVE" badge and inline playback.
• 🗂 Folder = Album
• Each folder becomes an album, managed by `.iphoto.album.json` (or `.iphoto.album`).
• 🧠 Smart Albums
• Built-in "Library", "All Photos", "Videos", "Favorites", and "Recently Deleted" views.
• 🖼 Immersive Detail Viewer
• + 6 more

📦 🔧 Technical Highlights

• ```
• View Layer (UI Components)
• ↓ (Data Binding)
• ViewModel Layer (State Management & Business Logic)
• ↓ (Data Access)
• Model Layer (SQLite Database & File System)
• ```
• Key Advantages:
• + 13 more

📦 🇨🇳 iPhoto v4.00 — MVVM 架构与高级编辑

• 📸 *MVVM 架构带来流畅性能，支持调色曲线，地图按聚类浏览。*
• 我们非常激动地宣布 iPhoto v4.00 正式发布！🎉
• 这个重大更新带来了完整的 MVVM 设计模式架构转型，大幅降低操作卡顿感，提高系统流畅度。我们还增加了强大的 调色曲线调整 功能和 基于聚类的地图导航，带来更好的照片管理体验。
• ---

📦 🌟 v4.00 主要更新

• *回应用户反馈：降低卡顿，提升响应速度*
• 完整的架构重构： 我们将代码库转换为遵循 Model-View-ViewModel (MVVM) 设计模式。
• 关注点分离： UI 呈现层、业务逻辑层和数据管理层之间的清晰分离。
• 响应式 UI 更新： ViewModel 高效管理状态变化并自动更新视图，消除不必要的重新渲染。
• 降低操作延迟： 在照片浏览、编辑和图库管理操作期间，显著减少 UI 冻结和卡顿。
• 增强系统流畅度： 即使在大型照片库中，也能实现流畅滚动、即时缩略图加载和响应式交互。
• 更好的资源管理： 通过适当的数据绑定和生命周期管理，改善内存使用和 CPU 效率。
• <img width="489" height="702" alt="image" src="https://github.com/user-attachments/assets/48bf0ffb-fd83-4c11-aaac-81c73e9561ce" />
• + 38 more

📦 🎯 核心功能（继承自之前版本）

• 之前版本中的所有核心功能均得到完整保留：
• 🎥 完整的 Live Photo 支持：自动配对 HEIC/JPG 与 MOV 文件，静态照片带 "LIVE" 徽章，可直接播放动态视频。
• 🗂 文件夹即相册：每个文件夹均视为相册，通过 `.iphoto.album.json` 管理封面、精选与排序。
• 🧠 智能相册：内置 "图库"、"所有照片"、"视频"、"收藏"、"最近删除" 等自动聚合视图。
• 🖼 沉浸式查看器：带胶片条与浮动播放控件的照片/视频查看体验。
• 🎨 非破坏性照片编辑：包含调整和裁剪模式的全面编辑套件（v2.00 功能）。
• ⚡ SQLite 全局数据库：为 TB 级别照片库提供企业级性能（v3.00 架构）。
• ---

📦 🔧 技术亮点

• ```
• 视图层（UI 组件）
• ↓（数据绑定）
• 视图模型层（状态管理与业务逻辑）
• ↓（数据访问）
• 模型层（SQLite 数据库与文件系统）
• ```
• 主要优势：
• + 13 more

📦 📊 Version Comparison / 版本对比

• | Feature / 功能 | v3.00 | v4.00 |
• |----------------|--------|--------|
• | SQLite global database / SQLite 全局数据库 | ✅ | ✅ |
• | Non-destructive editing / 非破坏性编辑 | ✅ | ✅ |
• | Map view / 地图视图 | ✅ | ✅ |
• | Live Photo support / Live Photo 支持 | ✅ | ✅ |
• | MVVM Architecture / MVVM 架构 | ❌ | ✅ |
• | Color Curves / 调色曲线 | ❌ | ✅ |
• + 4 more

📦 💬 Feedback / 反馈与建议

• We'd love to hear from you!
• If you encounter any issues or have ideas for improvement, please open a ticket on [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotron-LocalPhotoAlbumManager/issues).
• Your feedback helps shape the future of iPhoto. 💙
• Thank you for your support!
• 我们非常期待您的反馈！
• 如果您在使用中发现问题，或有新的功能建议，欢迎前往 [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotron-LocalPhotoAlbumManager/issues) 提交。
• 每一条意见都将帮助我们让 iPhoto 变得更好。💙
• 感谢您的支持！
• + 3 more

📋 Changes

• Enhanced Editing Stability: Fixed an issue where background album refreshes could cause the app to unexpectedly exit edit mode. Your editing session and selected asset will now be preserved during background updates.
• Reliable Photo Selection: Improved the underlying logic for identifying and selecting photos, ensuring a more consistent experience when navigating your library.
• Performance Optimization: Optimized the processing of high-resolution images with orientation data, resulting in faster loading times and smoother previews.
• 编辑稳定性提升：修复了后台相册刷新时可能导致意外退出编辑模式的问题。现在，即使相册在后台更新，您当前的编辑状态和选中的照片也会被妥善保留。
• 照片选择更可靠：优化了照片识别与定位逻辑，确保在浏览库文件时，照片的选中状态更加准确、稳定。
• 性能优化：改进了对带有旋转信息的高清图片的处理方式，提升了图片加载速度和预览流畅度。

⚡ 🚀 iPhoto v3.00 — Performance Overhaul / 性能重构

• ⚡ *Migration to SQLite with global database architecture, optimized for TB-level libraries, and rock-solid stability.*
• We are thrilled to announce iPhoto v3.00! 🛠️
• ---

📦 🌟 Key Updates in v3.00

• *Addressed user feedback: "freezing on TB-level large albums"*
• Complete Backend Rewrite: We have migrated from JSON-based indexing to a SQLite-powered global database.
• Single Database Design: All metadata across your entire library is stored in one centralized, high-performance SQLite database at the library root.
• Massive Scalability: Effortlessly handle TB-level photo libraries with hundreds of thousands of files without UI freezing or lag.
• Instant Response: Querying, sorting, and filtering are now instantaneous, regardless of library size.
• Smart Indexing: Multi-column indexes on `parent_album_path`, `ts` (timestamp), `media_type`, and `is_favorite` enable lightning-fast queries.
• Separation of Concerns: The 1100+ line monolithic index store has been split into 5 focused modules:
• `engine.py` — Database connection and transaction management
• + 14 more

📦 🆚 The "Scan Once" Advantage

• Better than Windows Explorer:
• Windows Explorer often struggles with large folders containing thousands of images:
• 🐢 Slow folder switching.
• 🐢 Thumbnails load one by one, every time.
• 🐢 High memory usage triggers frequent re-rendering of thumbnails.
• iPhoto v3.00 Experience:
• ⚡ Scan Once, Benefit Forever: After the initial scan, everything is solidified in the global SQLite database.
• ⚡ Instant Switching: Switch between massive folders instantly thanks to indexed queries.
• + 4 more

📦 🔧 Technical Highlights

• ```
• LibraryRoot/
• .iphoto/
• global_index.db # Single SQLite database for entire library
• thumbs/ # Unified thumbnail cache
• Album1/
• .iphoto.album.json # Album-specific manifest (cover, favorites, etc.)
• photo.jpg
• + 18 more

📦 🇨🇳 iPhoto v3.00 — 性能重构

• ⚡ *后端迁移至 SQLite 全局数据库架构，专为 TB 级超大图库优化，坚如磐石的稳定性。*
• 我们非常激动地宣布 iPhoto v3.00 正式发布！🛠️
• 本次更新专注于 性能与稳定性。针对用户反馈的"管理 TB 级别超大相册时容易卡死"的问题，我们彻底重写了后端存储引擎，采用革命性的全局数据库架构。
• ---

📦 🌟 v3.00 主要更新

• *回应用户反馈：解决超大图库卡顿问题*
• 后端彻底重写： 从基于 JSON 的索引迁移到 SQLite 驱动的全局数据库。
• 单一数据库设计： 整个图库的所有元数据存储在图库根目录的一个集中式高性能 SQLite 数据库中。
• 海量吞吐： 轻松管理 TB 级别的超大相册，即使包含数十万张照片，界面依然流畅丝滑，彻底告别卡死。
• 即时响应： 无论图库多大，查询、排序和筛选操作都能瞬间完成。
• 智能索引： 对 `parent_album_path`、`ts`（时间戳）、`media_type` 和 `is_favorite` 进行多列索引，实现闪电般的查询速度。
• 关注点分离： 将 1100+ 行的单体索引存储拆分为 5 个专注的模块：
• `engine.py` — 数据库连接和事务管理
• + 14 more

📦 🆚 "一次扫描，终生受益"

• 体验大幅领先 Windows Explorer：
• Windows Explorer（资源管理器）在面对包含数千张图片的大文件夹时往往力不从心：
• 🐢 文件夹切换缓慢。
• 🐢 缩略图加载缓慢，每次打开都要重新读条。
• 🐢 全内存逻辑容易导致缓存被清除，频繁触发重新渲染。
• iPhoto v3.00 的体验：
• ⚡ 固化扫描成果： 经过扫描固化后，所有索引和缩略图都会持久化到全局 SQLite 数据库中。
• ⚡ 秒切秒加载： 无论文件夹多大，得益于索引查询，切换瞬间完成，所有图库内容秒开。
• + 4 more

📦 🔧 技术亮点

• ```
• 图库根目录/
• .iphoto/
• global_index.db # 整个图库的单一 SQLite 数据库
• thumbs/ # 统一缩略图缓存
• 相册1/
• .iphoto.album.json # 相册特定的清单（封面、收藏等）
• photo.jpg
• + 18 more

⚡ 🚀 iPhoto v3.00-alpha — Performance Overhaul / 性能重构

• ⚡ *Migration to SQLite, optimized for TB-level libraries, and rock-solid stability.*
• We are announcing iPhoto v3.00-alpha! 🛠️
• ---

📦 🌟 Key Updates in v3.00-alpha

• *Addressed user feedback: "freezing on TB-level large albums"*
• No new features, just pure speed. We have migrated the entire metadata and index backend to SQLite.
• Massive Scalability: Effortlessly handle TB-level photo libraries with hundreds of thousands of files without UI freezing or lag.
• Instant Response: Querying, sorting, and filtering are now instantaneous, regardless of library size.
• Reduced Resource Usage: RAM and CPU footprint has been drastically reduced.
• Rock-Solid Stability: Significantly lower crash rates and improved error handling ensure a smooth experience even under heavy load.
• Disk Space Saver: We now maintain a single, unified thumbnail cache folder.
• No Redundancy: Drastically reduces disk space occupation compared to the previous scatter-file approach.
• + 1 more

📦 🆚 The "Scan Once" Advantage

• Better than Windows Explorer:
• Windows Explorer often struggles with large folders containing thousands of images:
• 🐢 Slow folder switching.
• 🐢 Thumbnails load one by one, every time.
• 🐢 High memory usage triggers frequent re-rendering of thumbnails.
• iPhoto v3.00-alpha Experience:
• ⚡ Scan Once, Benefit Forever: After the initial scan, everything is solidified in the database and cache.
• ⚡ Instant Switching: Switch between massive folders instantly.
• + 3 more

📦 🇨🇳 iPhoto v3.00-alpha — 性能重构

• ⚡ *后端迁移至 SQLite，专为 TB 级超大图库优化，坚如磐石的稳定性。*
• 我们正式发布 iPhoto v3.00-alpha！🛠️
• 本次更新专注于 性能与稳定性。针对用户反馈的“管理 TB 级别超大相册时容易卡死”的问题，我们彻底重写了后端存储引擎。
• ---

📦 🌟 v3.00-alpha 主要更新

• *回应用户反馈：解决超大图库卡顿问题*
• 无新功能，专注于速度： 本次更新没有增加新功能，而是对底层进行了彻底的重构，将元数据和索引后端迁移至 SQLite。
• 海量吞吐： 轻松管理 TB 级别的超大相册，即使包含数十万张照片，界面依然流畅丝滑，彻底告别卡死。
• 即时响应： 无论图库多大，查询、排序和筛选操作都能瞬间完成。
• 轻量化运行： 大幅降低了软件运行时的内存和 CPU 占用。
• 更稳定： 大幅降低了软件崩溃概率，显著提高了系统的鲁棒性，确保在长时间运行和高负载下的稳定性。
• 节省磁盘空间： 现在只维护一个统一的缩略图缓存文件夹。
• 告别冗余： 相比之前的分散存储方式，大幅降低了用户的磁盘占用空间。
• + 1 more

📦 🆚 "一次扫描，终生受益"

• 体验大幅领先 Windows Explorer：
• Windows Explorer（资源管理器）在面对包含数千张图片的大文件夹时往往力不从心：
• 🐢 文件夹切换缓慢。
• 🐢 缩略图加载缓慢，每次打开都要重新读条。
• 🐢 全内存逻辑容易导致缓存被清除，频繁触发重新渲染。
• iPhoto v3.00-alpha 的体验：
• ⚡ 固化扫描成果： 经过扫描固化后，所有索引和缩略图都会持久化存储。
• ⚡ 秒切秒加载： 无论文件夹多大，切换瞬间完成，所有图库内容秒开。
• + 2 more

📦 🖼 Overview

• iPhoto v2.3.1 builds upon the powerful folder-native photo management and non-destructive editing features from v2.0.0, now with full theme customization.
• Experience your photos in the lighting that suits you best:
• 🌞 Light Mode — Bright, clean interface for well-lit environments
• 🌙 Dark Mode — Easy on the eyes for low-light viewing
• 🔄 System Default — Automatically follows your OS theme preferences
• All while maintaining the folder-native, non-destructive philosophy that makes iPhoto unique.
• ---

📦 🌓 **Comprehensive Dark Mode Support**

• The headline feature of v2.3.1! A fully integrated theming system that transforms the entire application:
• iPhoto now offers flexible theme control through Settings → Appearance:
• 1. 🔄 System Default (Recommended)
• Automatically detects and follows your operating system's theme preference
• Seamlessly switches when you change your system settings
• Perfect for users who adjust their OS theme throughout the day
• 2. 🌞 Light Mode
• Bright, clean interface with high contrast
• + 33 more

✨ 🎯 Additional Improvements in v2.3.1

• Beyond dark mode, this release includes refinements and polish:
• Edit mode now always uses dark theme for consistent, professional color grading environment
• Improved contrast in adjustment panels
• Better visibility of sliders and controls
• Carefully calibrated accent colors for both themes
• Improved text contrast ratios for accessibility
• Semantic color definitions ensure consistency across all UI elements
• Faster theme switching with optimized palette updates
• + 6 more

✨ 🎯 Core Features (Carried Forward from v2.0.0)

• All the beloved features from previous versions remain fully supported and now look great in both light and dark themes:
• 🎥 Full Live Photo Support
• Automatically pairs HEIC/JPG + MOV files by content-ID or timestamp, with a "LIVE" badge and inline playback.
• 🗺 Interactive Map View
• Reads GPS metadata and displays your photo footprints on an interactive map.
• 🗂 Folder = Album
• Each folder becomes an album, managed by `.iphoto.album.json` (or `.iphoto.album`).
• 🧠 Smart Albums
• + 10 more

📦 Changing the Theme

• 1. Open Settings Menu
• Click Settings in the menu bar at the top of the window
• 2. Select Appearance
• Navigate to Settings → Appearance
• 3. Choose Your Theme
• System Default — Follow your OS theme (recommended)
• Light Mode — Always use light theme
• Dark Mode — Always use dark theme
• + 3 more

📦 Edit Mode Behavior

• When you enter Edit Mode by clicking the Edit button:
• iPhoto automatically switches to Dark Mode for optimal color grading
• This happens regardless of your global theme setting
• Provides consistent, professional environment for photo adjustments
• Exiting Edit Mode restores your preferred theme

📦 System Integration

• If you choose System Default:
• iPhoto automatically detects your OS theme preference
• On macOS: Follows System Preferences → Appearance
• On Windows: Follows Settings → Personalization → Colors
• Updates in real-time when you change your system theme
• ---

📦 💬 Feedback

• We'd love to hear from you!
• If you encounter any issues or have ideas for improvement, please open a ticket on [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotos/issues).
• Your feedback helps shape the future of iPhoto. 💙
• Thank you for your support!
• ---

📦 🇨🇳 iPhoto v2.3.1 — 深色模式正式发布！

• 我们非常高兴地宣布 iPhoto v2.3.1 正式发布！🎉
• 此版本引入了 全面的深色模式支持，带来了一个适应您偏好和环境的精致视觉体验。
• ---

📦 🖼 核心理念

• iPhoto v2.3.1 在 v2.0.0 强大的文件夹原生照片管理和非破坏性编辑功能基础上，现已支持 完整的主题自定义。
• 以最适合您的光线体验您的照片：
• 🌞 浅色模式 — 适用于明亮环境的清爽界面
• 🌙 深色模式 — 低光环境下更舒适的观看体验
• 🔄 跟随系统 — 自动跟随您的操作系统主题偏好
• 同时保持了使 iPhoto 独特的文件夹原生、非破坏性理念。
• ---

📦 ✨ v2.3.1 新增功能

• v2.3.1 的核心功能！一个完全集成的主题系统，可以转换整个应用程序：
• iPhoto 现在通过 设置 → 外观 提供灵活的主题控制：
• 1. 🔄 跟随系统（推荐）
• 自动检测并跟随您的操作系统主题偏好
• 当您更改系统设置时无缝切换
• 适合全天调整操作系统主题的用户
• 2. 🌞 浅色模式
• 明亮、清爽的高对比度界面
• + 34 more

📦 🎯 v2.3.0 的其他改进

• 除了深色模式，此版本还包括优化和润色：
• 编辑模式现在始终使用深色主题，提供一致、专业的色彩分级环境
• 改进了调整面板中的对比度
• 更好的滑块和控件可见性
• 为两个主题精心校准的强调色
• 提高文本对比度以增强可访问性
• 语义色彩定义确保所有 UI 元素的一致性
• 通过优化调色板更新实现更快的主题切换
• + 6 more

📦 🎯 核心功能（继承自 v2.0.0）

• 之前版本的所有核心功能均得到完整保留，现在在浅色和深色主题下都很美观：
• 🎥 完整的 Live Photo 支持：自动配对 HEIC/JPG 与 MOV 文件，静态照片带 "LIVE" 徽章，可直接播放动态视频。
• 🗺 交互式地图视图：自动读取照片与视频的 GPS 信息，聚合显示拍摄地点。
• 🗂 文件夹即相册：每个文件夹均视为相册，通过 `.iphoto.album.json` 管理。
• 🧠 智能相册：内置"图库"、"所有照片"、"视频"、"收藏"、"最近删除"等自动聚合视图。
• 🎨 非破坏性照片编辑：带有调整和裁剪模式的综合编辑套件，现已增强深色模式支持。
• 🖼 沉浸式查看器：带胶片条与浮动播放控件的照片/视频查看体验。
• ℹ️ 浮动信息面板：查看 EXIF、相机/镜头、光圈、快门速度、文件大小等元数据。
• + 2 more

📦 更改主题

• 1. 打开设置菜单
• 点击窗口顶部菜单栏中的 设置（Settings）
• 2. 选择外观
• 导航到 设置 → 外观（Appearance）
• 3. 选择您的主题
• 跟随系统（System Default） — 跟随您的操作系统主题（推荐）
• 浅色模式（Light Mode） — 始终使用浅色主题
• 深色模式（Dark Mode） — 始终使用深色主题
• + 3 more

📦 编辑模式行为

• 当您通过点击 编辑（Edit） 按钮进入编辑模式时：
• iPhoto 自动切换到 深色模式，以实现最佳色彩分级
• 无论您的全局主题设置如何，都会发生这种情况
• 为照片调整提供一致、专业的环境
• 退出编辑模式会恢复您首选的主题

📦 系统集成

• 如果您选择 跟随系统：
• iPhoto 自动检测您的操作系统主题偏好
• 在 macOS 上：跟随系统偏好设置 → 外观
• 在 Windows 上：跟随设置 → 个性化 → 颜色
• 当您更改系统主题时实时更新
• ---

📦 💬 反馈与建议

• 我们非常期待您的反馈！
• 如果您在使用中发现问题，或有新的功能建议，欢迎前往 [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotos/issues) 提交。
• 每一条意见都将帮助我们让 iPhoto 变得更好。💙
• 感谢您的支持！
• ---

📦 Theme Architecture / 主题架构

• iPhoto v2.3.1 implements a comprehensive theming system built on Qt's palette mechanism:
• iPhoto v2.3.1 实现了一个基于 Qt 调色板机制的综合主题系统：
• Manages three theme modes: `system`, `light`, and `dark` / 管理三种主题模式：`system`、`light` 和 `dark`
• Detects system theme preferences via `QGuiApplication.styleHints().colorScheme()` / 通过 `QGuiApplication.styleHints().colorScheme()` 检测系统主题偏好
• Emits `themeChanged` signal when the effective theme changes / 当有效主题更改时发出 `themeChanged` 信号
• Supports forced dark mode override for Edit View / 支持编辑视图的强制深色模式覆盖
• Two predefined color schemes with semantic naming:
• 两个预定义的色彩方案，具有语义命名：
• + 22 more

📦 Settings Schema / 设置架构

• Theme preference is stored in the settings file as:
• 主题偏好存储在设置文件中：
• ```json
• {
• "ui": {
• "theme": "system" // or "light" or "dark"
• }
• }
• + 3 more

📦 Color Accessibility / 色彩可访问性

• All theme colors meet WCAG contrast requirements:
• 所有主题颜色都符合 WCAG 对比度要求：
• Light Mode: Minimum 4.5:1 contrast ratio for normal text
• Dark Mode: Minimum 4.5:1 contrast ratio for normal text
• Disabled text uses reduced opacity for visual hierarchy
• 浅色模式：正常文本最小对比度 4.5:1
• 深色模式：正常文本最小对比度 4.5:1
• 禁用文本使用降低的不透明度以实现视觉层次
• + 1 more

📦 📊 Version Comparison / 版本对比

• | Feature / 功能 | v2.1.1 | v2.3.1 |
• |----------------|--------|--------|
• | Folder-native albums / 文件夹原生相册 | ✅ | ✅ |
• | Live Photo support / Live Photo 支持 | ✅ | ✅ |
• | Map view / 地图视图 | ✅ | ✅ |
• | Non-destructive editing / 非破坏性编辑 | ✅ | ✅ |
• | Light adjustments / 光线调整 | ✅ | ✅ |
• | Color adjustments / 色彩调整 | ✅ | ✅ |
• + 10 more

🐛 🚀 iPhoto v2.1.1 — Bug Fixes and UI Improvements

• 📸 *A modern, folder-native photo manager with non-destructive editing for Windows and macOS.*
• We're pleased to announce iPhoto v2.1.1! 🎉
• This update brings important bug fixes and interface improvements to enhance your photo management experience.
• ---

✨ ✨ What's New in v2.1.1

• Problem: After editing photos, thumbnails in aggregated albums (Library, All Photos, Favorites) and folder albums were not syncing properly, showing outdated previews.
• Solution: Implemented automatic thumbnail refresh across all album views when photos are edited. Now your thumbnails always reflect the latest edits.
• Problem: The gallery grid view couldn't automatically adjust to window size changes, resulting in blank spaces or incorrect layout.
• Solution: Enhanced the grid layout algorithm to dynamically respond to window resizing, ensuring optimal photo arrangement without blank spaces.
• Refined the album interface to more closely replicate the macOS Photos experience
• Improved visual consistency and layout spacing
• Better integration with system UI themes
• Smoother transitions and animations
• + 2 more

✨ 🎯 Core Features (Carried Forward from v2.0.0)

• All the powerful features from v2.0.0 remain fully supported:
• 🎨 Non-Destructive Photo Editing with comprehensive Adjust and Crop modes
• 🎥 Full Live Photo Support with automatic pairing and inline playback
• 🗺 Interactive Map View showing your photo locations
• 🗂 Folder = Album with filesystem-native structure
• 🧠 Smart Albums for Library, All Photos, Videos, Favorites, and Recently Deleted
• 🖼 Immersive Detail Viewer with filmstrip navigation
• ℹ️ Floating Metadata Panel for EXIF information
• + 2 more

📦 💬 Feedback

• We'd love to hear from you!
• If you encounter any issues or have ideas for improvement, please open a ticket on [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotos/issues).
• Your feedback helps shape the future of iPhoto. 💙
• Thank you for your support!
• ---

🐛 🇨🇳 iPhoto v2.1.1 — Bug修复与界面改进

• 我们很高兴地宣布 iPhoto v2.1.1 正式发布！🎉
• 此次更新带来了重要的错误修复和界面改进，进一步提升您的照片管理体验。
• ---

📦 ✨ v2.1.1 更新内容

• 问题： 编辑照片后，聚合相册（图库、所有照片、收藏）和文件夹相册中的缩略图无法正确同步，显示过时的预览。
• 解决方案： 实现了照片编辑后所有相册视图中的自动缩略图刷新。现在您的缩略图始终反映最新的编辑内容。
• 问题： 图库网格视图无法自动适应窗口大小变化，导致出现空白区域或布局不正确。
• 解决方案： 增强了网格布局算法，使其能够动态响应窗口大小调整，确保照片排列最优且无空白区域。
• 优化了相册界面，更加贴近 macOS 照片应用的体验
• 改进了视觉一致性和布局间距
• 更好地集成系统UI主题
• 更流畅的过渡和动画效果
• + 2 more

📦 🎯 核心功能（继承自 v2.0.0）

• v2.0.0 中的所有强大功能均得到完整保留：
• 🎨 非破坏性照片编辑，包含全面的调整和裁剪模式
• 🎥 完整的 Live Photo 支持，自动配对和内联播放
• 🗺 交互式地图视图，展示照片位置
• 🗂 文件夹即相册，文件系统原生结构
• 🧠 智能相册，包括图库、所有照片、视频、收藏和最近删除
• 🖼 沉浸式详情查看器，带胶片条导航
• ℹ️ 浮动元数据面板，显示 EXIF 信息
• + 2 more

📦 💬 反馈与建议

• 我们非常期待您的反馈！
• 如果您在使用中发现问题，或有新的功能建议，欢迎前往 [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotos/issues) 提交。
• 每一条意见都将帮助我们让 iPhoto 变得更好。💙
• 感谢您的支持！
• ---
• iPhoto v2.1.1 — *Refined experience. Better performance.*
• iPhoto v2.1.1 — *精致体验，卓越性能。*

📦 🚀 iPhoto v2.0.0 — Edit 功能正式加入！

• 📸 *A modern, folder-native photo manager with non-destructive editing for Windows and macOS.*
• We're excited to announce iPhoto v2.0.0! 🎉
• This major update introduces a comprehensive non-destructive photo editing suite while maintaining all the powerful album management features you love.
• ---

📦 🖼 Overview

• iPhoto remains folder-native:
• 📁 *Your folders are your albums.*
• No import, no heavy database — just pure filesystem structure.
• Every album stores its metadata (cover, favorites, order, filters) in a small JSON manifest file, and all thumbnails / pairings are cached locally for speed.
• Now with v2.0.0, all your photo edits are also stored non-destructively in `.ipo` sidecar files — your original photos remain 100% untouched.
• ---

✨ ✨ What's New in v2.0.0

• The headline feature of v2.0.0! A comprehensive editing suite with Adjust and Crop modes:
• Fine-tune your photos with professional-grade adjustments:
• 💡 Light Adjustments
• Master slider with intelligent distribution across 7 fine-tuning controls
• Brilliance, Exposure, Highlights, Shadows, Brightness, Contrast, Black Point
• Real-time thumbnail preview strips showing the effect range for each adjustment
• 🎨 Color Adjustments
• Saturation, Vibrance, and Cast (white balance correction)
• + 27 more

✨ 🎯 Core Features (Carried Forward from v1.0.0)

• All the beloved features from v1.0.0 remain fully supported:
• 🎥 Full Live Photo Support
• Automatically pairs HEIC/JPG + MOV files by content-ID or timestamp, with a "LIVE" badge and inline playback.
• 🗺 Interactive Map View
• Reads GPS metadata and displays your photo footprints on an interactive map.
• 🗂 Folder = Album
• Each folder becomes an album, managed by `.iphoto.album.json` (or `.iphoto.album`).
• 🧠 Smart Albums
• + 8 more

📦 🏁 Getting Started

• When you first open iPhoto, you'll see the *Basic Library — not bound* screen:
• <p align="center">
• <img width="800" alt="firstpage" src="https://github.com/user-attachments/assets/2c6b1269-8da6-465e-bbd7-00fa4f756baa" />
• </p>
• Click "Bind Basic Library…" to select any folder on your computer —
• that folder will become your album root.
• iPhoto will automatically scan its contents, generate thumbnails, and recognize Live Photos,
• creating a lightweight `.iphoto.album.json` manifest inside that folder.
• + 2 more

📦 🎨 How to Edit Photos

• 1. Select a photo in the gallery or detail viewer
• 2. Click the Edit button in the toolbar
• <img width="1925" height="1086" alt="image" src="https://github.com/user-attachments/assets/636ee8b8-0e4b-4ebd-afc8-f219f4e09edb" />
• 3. Choose your mode:
• Adjust — for light, color, and black & white adjustments
• Crop — for perspective correction, straightening, and cropping
• 4. Make your adjustments using the sliders and controls
• 5. Click Done to save your edits (stored in `.ipo` sidecar files)
• + 4 more

📦 💾 Exporting Edited Photos

• Export Selected Photos:
• 1. Select one or more photos in the gallery (edited or unedited)
• 2. Go to File > Export Selected in the menu
• <img width="1909" height="399" alt="image" src="https://github.com/user-attachments/assets/a8b10fdf-319c-4590-85f3-3fa4ec45b552" />
• 3. Choose a destination (or use the default)
• 4. iPhoto will:
• Render edited photos with all adjustments applied and save as high-quality JPG (regardless of original format)
• Copy unedited photos and videos as-is (preserving original format)
• + 9 more

📦 📂 Open a Folder Temporarily / 临时打开文件夹

• If you just want to browse a folder without binding it as a library,
• you can use the "Open Album Folder…" option from the top menu:
• <img width="735" height="399" alt="image" src="https://github.com/user-attachments/assets/b6601e9e-dee2-4be7-b891-7d576c56001f" />
• > *This lets you temporarily open any directory to preview its photos and videos —
• no manifest file will be created, and your original files remain untouched.*
• ---

📦 💬 Feedback

• We'd love to hear from you!
• If you encounter any issues or have ideas for improvement, please open a ticket on [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotos/issues).
• Your feedback helps shape the future of iPhoto. 💙
• Thank you for your support!
• ---

📦 🇨🇳 iPhoto v2.0.0 — 编辑功能正式加入！

• 我们非常激动地宣布 iPhoto v2.0.0 正式发布！🎉
• 这个重大更新引入了全面的 非破坏性照片编辑功能，同时保留了您喜爱的所有相册管理特性。
• ---

📦 🖼 核心理念

• 文件夹原生 · 无需导入 · 非破坏性设计
• 📁 您的文件夹 就是 您的相册。
• 我们通过轻量级的 JSON 清单文件与本地缓存来保存封面、精选与排序信息。
• 现在在 v2.0.0 中，所有照片编辑也被非破坏性地保存在 `.ipo` 附属文件中 — 您的原始照片保持原样，100% 不修改、不搬动。
• ---

📦 ✨ v2.0.0 新增功能

• v2.0.0 的核心功能！全面的编辑套件，包含 调整（Adjust） 和 裁剪（Crop） 两种模式：
• 使用专业级别的调整功能微调您的照片：
• 💡 光线调整
• 主滑块智能分配至 7 个精细控制参数
• 亮度、曝光、高光、阴影、明度、对比度、黑点
• 实时缩略图预览条，显示每个调整的效果范围
• 🎨 色彩调整
• 饱和度、自然饱和度、色偏（白平衡校正）
• + 27 more

📦 🎯 核心功能（继承自 v1.0.0）

• v1.0.0 中的所有核心功能均得到完整保留：
• 🎥 完整的 Live Photo 支持：自动配对 HEIC/JPG 与 MOV 文件，静态照片带 "LIVE" 徽章，可直接播放动态视频。
• 🗺 交互式地图视图：自动读取照片与视频的 GPS 信息，聚合显示拍摄地点。
• 🗂 文件夹即相册：每个文件夹均视为相册，通过 `.iphoto.album.json` 管理封面、精选与排序。
• 🧠 智能相册：内置 "图库"、"所有照片"、"视频"、"收藏"、"最近删除" 等自动聚合视图。
• 🖼 沉浸式查看器：带胶片条与浮动播放控件的照片/视频查看体验。
• ℹ️ 浮动信息面板：查看 EXIF、相机/镜头、光圈、快门速度、文件大小等元数据。
• ⚙️ 桌面级交互体验：支持拖拽导入、右键菜单、异步扫描、增量加载缩略图等。
• + 1 more

📦 🏁 开始使用

• 首次启动 iPhoto 时，你会看到如下界面：
• <p align="center">
• <img width="800" alt="firstpage" src="https://github.com/user-attachments/assets/2c6b1269-8da6-465e-bbd7-00fa4f756baa" />
• </p>
• 点击 "Bind Basic Library…"（绑定基础图库），然后选择任意一个文件夹，
• 该文件夹就会成为您的 相册根目录。
• iPhoto 会自动扫描其中的照片与视频，生成缩略图并识别 Live Photos，
• 同时在文件夹内创建一个轻量的 `.iphoto.album.json` 文件，用于记录封面、精选与排序信息。
• + 2 more

📦 🎨 如何编辑照片

• 1. 在图库或详情查看器中选择一张照片
• 2. 点击工具栏中的编辑按钮（Edit）
• <img width="1925" height="1086" alt="image" src="https://github.com/user-attachments/assets/636ee8b8-0e4b-4ebd-afc8-f219f4e09edb" />
• 3. 选择编辑模式：
• 调整（Adjust） — 用于光线、色彩和黑白调整
• 裁剪（Crop） — 用于透视校正、拉直和裁剪
• 4. 使用滑块和控件进行调整
• 6. 点击完成以保存您的编辑（保存在 `.ipo` 附属文件中）
• + 4 more

📦 💾 导出已编辑的照片

• 当您在 iPhoto 中编辑照片时，所有调整都以 非破坏性 方式存储在原始文件旁边的 `.ipo` 附属文件中。要在其他地方分享或使用编辑后的照片，您需要 导出 它们，这会将调整渲染为新的图像文件。
• 导出选定的照片：
• 1. 在图库中选择一张或多张照片（已编辑或未编辑均可）
• 2. 点击菜单栏中的 文件（File） > 导出选定（Export Selected）
• 3. 选择目标位置（或使用默认位置）
• 4. iPhoto 将：
• 渲染已编辑的照片，应用所有调整并保存为高质量 JPG 格式（无论原始格式）
• 原样复制未编辑的照片和视频（保留原始格式）
• + 10 more

📦 📂 临时打开文件夹

• 如果您只是想 临时浏览某个文件夹，而不想将它绑定为永久相册，
• 可以点击顶部菜单中的 "Open Album Folder…"（打开相册文件夹）：
• <img width="735" height="399" alt="image" src="https://github.com/user-attachments/assets/3ec92de0-0433-4f32-9628-6ccafda04166" />
• > *此操作将 直接打开并预览文件夹内的照片和视频，
• 不会创建 `.iphoto.album.json` 文件，也不会对原始媒体做任何更改。*
• ---

📦 💬 反馈与建议

• 我们非常期待您的反馈！
• 如果您在使用中发现问题，或有新的功能建议，欢迎前往 [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotos/issues) 提交。
• 每一条意见都将帮助我们让 iPhoto 变得更好。💙
• 感谢您的支持！
• ---

📦 Edit Data Storage / 编辑数据存储

• All photo edits are stored in `.ipo` (iPhoto Output) sidecar files next to your original images:
• ```
• MyAlbum/
• IMG_1234.HEIC # Original photo (untouched)
• IMG_1234.HEIC.ipo # Edit parameters (JSON format)
• .iphoto.album.json # Album manifest
• ```
• The `.ipo` file contains:
• + 10 more

📦 GPU Rendering Pipeline / GPU 渲染管线

• iPhoto v2.0.0 uses OpenGL 3.3 for real-time preview rendering:
• 1. Texture Upload — Original image loaded as OpenGL texture
• 2. Perspective Transform — 4-point homography applied in vertex shader
• 3. Color Grading — Light/Color/B&W adjustments applied in fragment shader
• 4. Crop Box — Final crop region extracted and displayed
• iPhoto v2.0.0 使用 OpenGL 3.3 进行实时预览渲染：
• 1. 纹理上传 — 原始图像作为 OpenGL 纹理加载
• 2. 透视变换 — 在顶点着色器中应用 4 点单应性变换
• + 3 more

📦 📊 Version Comparison / 版本对比

• | Feature / 功能 | v1.0.0 | v2.0.0 |
• |----------------|--------|--------|
• | Folder-native albums / 文件夹原生相册 | ✅ | ✅ |
• | Live Photo support / Live Photo 支持 | ✅ | ✅ |
• | Map view / 地图视图 | ✅ | ✅ |
• | Smart albums / 智能相册 | ✅ | ✅ |
• | Detail viewer / 详情查看器 | ✅ | ✅ |
• | Metadata panel / 元数据面板 | ✅ | ✅ |
• + 23 more

📦 📂 Open a Folder Temporarily / 临时打开文件夹

• If you just want to browse a folder without binding it as a library,
• you can use the "Open Album Folder…" option from the top menu:
• <p align="center">
• <img width="800" alt="open-album-folder" src="https://github.com/user-attachments/assets/030ed204-15b7-482b-9d58-c2c04fdca3d8" />
• </p>
• > *This lets you temporarily open any directory to preview its photos and videos —
• no manifest file will be created, and your original files remain untouched.*
• ---

📦 💬 Feedback

• We'd love to hear from you!
• If you encounter any issues or have ideas for improvement, please open a ticket on [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotos/issues).
• Your feedback helps shape the future of iPhoto. 💙
• Thank you for your support!
• ---

📦 🇨🇳 iPhoto v2.0.0 — 编辑功能正式加入！

• 我们非常激动地宣布 iPhoto v2.0.0 正式发布！🎉
• 这个重大更新引入了全面的 非破坏性照片编辑功能，同时保留了您喜爱的所有相册管理特性。
• ---

📦 🖼 核心理念

• 文件夹原生 · 无需导入 · 非破坏性设计
• 📁 您的文件夹 就是 您的相册。
• 我们通过轻量级的 JSON 清单文件与本地缓存来保存封面、精选与排序信息。
• 现在在 v2.0.0 中，所有照片编辑也被非破坏性地保存在 `.ipo` 附属文件中 — 您的原始照片保持原样，100% 不修改、不搬动。
• ---

📦 ✨ v2.0.0 新增功能

• v2.0.0 的核心功能！全面的编辑套件，包含 调整（Adjust） 和 裁剪（Crop） 两种模式：
• 使用专业级别的调整功能微调您的照片：
• 💡 光线调整
• 主滑块智能分配至 7 个精细控制参数
• 亮度、曝光、高光、阴影、明度、对比度、黑点
• 实时缩略图预览条，显示每个调整的效果范围
• 🎨 色彩调整
• 饱和度、自然饱和度、色偏（白平衡校正）
• + 27 more

📦 🎯 核心功能（继承自 v1.0.0）

• v1.0.0 中的所有核心功能均得到完整保留：
• 🎥 完整的 Live Photo 支持：自动配对 HEIC/JPG 与 MOV 文件，静态照片带 "LIVE" 徽章，可直接播放动态视频。
• 🗺 交互式地图视图：自动读取照片与视频的 GPS 信息，聚合显示拍摄地点。
• 🗂 文件夹即相册：每个文件夹均视为相册，通过 `.iphoto.album.json` 管理封面、精选与排序。
• 🧠 智能相册：内置 "图库"、"所有照片"、"视频"、"收藏"、"最近删除" 等自动聚合视图。
• 🖼 沉浸式查看器：带胶片条与浮动播放控件的照片/视频查看体验。
• ℹ️ 浮动信息面板：查看 EXIF、相机/镜头、光圈、快门速度、文件大小等元数据。
• ⚙️ 桌面级交互体验：支持拖拽导入、右键菜单、异步扫描、增量加载缩略图等。
• + 1 more

📦 🏁 开始使用

• 首次启动 iPhoto 时，你会看到如下界面：
• <p align="center">
• <img width="800" alt="firstpage" src="https://github.com/user-attachments/assets/2c6b1269-8da6-465e-bbd7-00fa4f756baa" />
• </p>
• 点击 "Bind Basic Library…"（绑定基础图库），然后选择任意一个文件夹，
• 该文件夹就会成为您的 相册根目录。
• iPhoto 会自动扫描其中的照片与视频，生成缩略图并识别 Live Photos，
• 同时在文件夹内创建一个轻量的 `.iphoto.album.json` 文件，用于记录封面、精选与排序信息。
• + 2 more

📦 🎨 如何编辑照片

• 1. 在图库或详情查看器中选择一张照片
• 2. 点击工具栏中的编辑按钮（Edit）
• <img width="1925" height="1086" alt="image" src="https://github.com/user-attachments/assets/636ee8b8-0e4b-4ebd-afc8-f219f4e09edb" />
• 3. 选择编辑模式：
• 调整（Adjust） — 用于光线、色彩和黑白调整
• 裁剪（Crop） — 用于透视校正、拉直和裁剪
• 4. 使用滑块和控件进行调整
• 5. 点击完成以保存您的编辑（保存在 `.ipo` 附属文件中）
• + 4 more

📦 💾 导出已编辑的照片

• 当您在 iPhoto 中编辑照片时，所有调整都以 非破坏性 方式存储在原始文件旁边的 `.ipo` 附属文件中。要在其他地方分享或使用编辑后的照片，您需要 导出 它们，这会将调整渲染为新的图像文件。
• 导出选定的照片：
• 1. 在图库中选择一张或多张照片（已编辑或未编辑均可）
• 2. 点击菜单栏中的 文件（File） > 导出选定（Export Selected）
• 3. 选择目标位置（或使用默认位置）
• 4. iPhoto 将：
• 渲染已编辑的照片，应用所有调整并保存为高质量 JPG 格式（无论原始格式）
• 原样复制未编辑的照片和视频（保留原始格式）
• + 10 more

📦 📂 临时打开文件夹

• 如果您只是想 临时浏览某个文件夹，而不想将它绑定为永久相册，
• 可以点击顶部菜单中的 "Open Album Folder…"（打开相册文件夹）：
• <p align="center">
• <img width="800" alt="open-album-folder" src="https://github.com/user-attachments/assets/030ed204-15b7-482b-9d58-c2c04fdca3d8" />
• </p>
• > *此操作将 直接打开并预览文件夹内的照片和视频，
• 不会创建 `.iphoto.album.json` 文件，也不会对原始媒体做任何更改。*
• ---

📦 💬 反馈与建议

• 我们非常期待您的反馈！
• 如果您在使用中发现问题，或有新的功能建议，欢迎前往 [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotos/issues) 提交。
• 每一条意见都将帮助我们让 iPhoto 变得更好。💙
• 感谢您的支持！
• ---

📦 Edit Data Storage / 编辑数据存储

• All photo edits are stored in `.ipo` (iPhoto Output) sidecar files next to your original images:
• ```
• MyAlbum/
• IMG_1234.HEIC # Original photo (untouched)
• IMG_1234.HEIC.ipo # Edit parameters (JSON format)
• .iphoto.album.json # Album manifest
• ```
• The `.ipo` file contains:
• + 10 more

📦 GPU Rendering Pipeline / GPU 渲染管线

• iPhoto v2.0.0 uses OpenGL 3.3 for real-time preview rendering:
• 1. Texture Upload — Original image loaded as OpenGL texture
• 2. Perspective Transform — 4-point homography applied in vertex shader
• 3. Color Grading — Light/Color/B&W adjustments applied in fragment shader
• 4. Crop Box — Final crop region extracted and displayed
• iPhoto v2.0.0 使用 OpenGL 3.3 进行实时预览渲染：
• 1. 纹理上传 — 原始图像作为 OpenGL 纹理加载
• 2. 透视变换 — 在顶点着色器中应用 4 点单应性变换
• + 3 more

📦 📊 Version Comparison / 版本对比

• | Feature / 功能 | v1.0.0 | v2.0.0 |
• |----------------|--------|--------|
• | Folder-native albums / 文件夹原生相册 | ✅ | ✅ |
• | Live Photo support / Live Photo 支持 | ✅ | ✅ |
• | Map view / 地图视图 | ✅ | ✅ |
• | Smart albums / 智能相册 | ✅ | ✅ |
• | Detail viewer / 详情查看器 | ✅ | ✅ |
• | Metadata panel / 元数据面板 | ✅ | ✅ |
• + 10 more

📦 🚀 iPhoto v1.0.0 — First Stable Release

• 📸 *A modern, folder-native photo manager for Windows and macOS.*
• We’re thrilled to announce the first official release of iPhoto v1.0.0! 🎉
• Inspired by macOS Photos, iPhoto brings a lightweight yet powerful photo-management experience to desktop users — without database lock-in.
• ---

📦 🖼 Overview

• iPhoto is folder-native:
• 📁 *Your folders are your albums.*
• No import, no heavy database — just pure filesystem structure.
• Every album stores its metadata (cover, favorites, order, filters) in a small JSON manifest file, and all thumbnails / pairings are cached locally for speed.
• Your original photos and videos remain untouched — 100% non-destructive.
• ---

✨ ✨ Key Features

• 🎥 Full Live Photo Support
• Automatically pairs HEIC/JPG + MOV files by content-ID or timestamp, with a “LIVE” badge and inline playback.
• 🗺 Interactive Map View
• Reads GPS metadata and displays your photo footprints on an interactive map.
• 🗂 Folder = Album
• Each folder becomes an album, managed by `.iphoto.album.json` (or `.iphoto.album`).
• 🧠 Smart Albums
• Built-in “Library”, “All Photos”, “Videos”, “Favorites”, and “Recently Deleted” views.
• + 7 more

📦 🏁 Getting Started

• When you first open iPhoto, you’ll see the *Basic Library — not bound* screen, as shown below:
• <p align="center">
• <img width="800" alt="firstpage" src="https://github.com/user-attachments/assets/2c6b1269-8da6-465e-bbd7-00fa4f756baa" />
• </p>
• Click “Bind Basic Library…” to select any folder on your computer —
• that folder will become your album root.
• iPhoto will automatically scan its contents, generate thumbnails, and recognize Live Photos,
• creating a lightweight `.iphoto.album.json` manifest inside that folder.
• + 2 more

📦 📂 Open a Folder Temporarily / 临时打开文件夹

• If you just want to browse a folder without binding it as a library,
• you can use the “Open Album Folder…” option from the top menu:
• <p align="center">
• <img width="800" alt="open-album-folder" src="https://github.com/user-attachments/assets/030ed204-15b7-482b-9d58-c2c04fdca3d8" />
• </p>
• >*This lets you temporarily open any directory to preview its photos and videos —
• no manifest file will be created, and your original files remain untouched.*
• ---

📦 💬 Feedback

• We’d love to hear from you!
• If you encounter any issues or have ideas for improvement, please open a ticket on [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotos/issues).
• Your feedback helps shape the future of iPhoto. 💙
• Thank you for your support!
• ---

📦 🇨🇳 iPhoto v1.0.0 — 首个正式版发布！

• 我们非常激动地宣布 iPhoto v1.0.0 正式发布！🎉
• iPhoto 是一款面向 Windows 与 macOS 的现代化照片管理器，其灵感来自 macOS 的《照片》 应用。
• ---

📦 🖼 核心理念

• 文件夹原生 · 无需导入 · 非破坏性设计
• 📁 您的文件夹 就是 您的相册。
• 我们通过轻量级的 JSON 清单文件与本地缓存来保存封面、精选与排序信息。
• 所有原始照片与视频保持原样，100% 不修改、不搬动。
• ---

📦 ✨ 主要功能

• 🎥 完整的 Live Photo 支持：自动配对 HEIC/JPG 与 MOV 文件，静态照片带 “LIVE” 徽章，可直接播放动态视频。
• 🗺 交互式地图视图：自动读取照片与视频的 GPS 信息，聚合显示拍摄地点。
• 🗂 文件夹即相册：每个文件夹均视为相册，通过 `.iphoto.album.json` 管理封面、精选与排序。
• 🧠 智能相册：内置 “图库”、“所有照片”、“视频”、“收藏”、“最近删除” 等自动聚合视图。
• 🖼 沉浸式查看器：带胶片条与浮动播放控件的照片/视频查看体验。
• ℹ️ 浮动信息面板：查看 EXIF、相机/镜头、光圈、快门速度、文件大小等元数据。
• ⚙️ 桌面级交互体验：支持拖拽导入、右键菜单、异步扫描、增量加载缩略图等。
• ---

📦 🏁 开始使用

• 首次启动 iPhoto 时，你会看到如下界面：
• <p align="center">
• <img width="800" alt="firstpage" src="https://github.com/user-attachments/assets/2c6b1269-8da6-465e-bbd7-00fa4f756baa" />
• </p>
• 点击 “Bind Basic Library…”（绑定基础图库），然后选择任意一个文件夹，
• 该文件夹就会成为您的 相册根目录。
• iPhoto 会自动扫描其中的照片与视频，生成缩略图并识别 Live Photos，
• 同时在文件夹内创建一个轻量的 `.iphoto.album.json` 文件，用于记录封面、精选与排序信息。
• + 10 more

📦 💬 反馈与建议

• 我们非常期待您的反馈！
• 如果您在使用中发现问题，或有新的功能建议，欢迎前往 [GitHub Issues](https://github.com/OliverZhaohaibin/iPhotos/issues) 提交。
• 每一条意见都将帮助我们让 iPhoto 变得更好。💙
• 感谢您的支持！