面向 Windows 10/11 x64 的轻量图片查看器
当前发布版本为 0.3.12,main 分支可能包含尚未发布的改进。
Pixora 支持图片与视频混合目录浏览、快速搜索、缩略图、收藏、基础编辑和超大图片安全预览。本项目由 AI 辅助编程完成。
| 类别 | 能力 |
|---|---|
| 浏览 | 常见图片格式、视频封面、缩放、旋转、全屏和排序 |
| 大目录 | 后台扫描、虚拟化缩略图、目录变化自动刷新 |
| 查找 | 使用 Ctrl+K 按序号或文件名快速定位 |
| 编辑 | 裁剪、圆形裁剪、单图压缩、批量压缩和设置壁纸 |
| 性能 | 内存与磁盘缓存、低内存保护、邻图预加载 |
| 超大图 | JPEG/PNG 和带预览层的 BigTIFF 安全预览 |
| 系统 | 深色/亮色主题、快捷键、收藏、窗口复用和 Windows 文件关联 |
- 修复 USB 手机照片只能打开首张、大图无法继续读取和快捷键跳回旧本地目录的问题,支持手机目录按需浏览、断线重试及保存原始副本。
- 修复 EXIF 方向处理和损坏的磁盘缩略图缓存,优化内存缓存的最近使用顺序维护。
- 连续打开图片时,新请求可及时进入已有窗口,迟到的旧结果不会覆盖当前选择。
- 超大 JPEG/PNG 安全预览,以及带缩略图或金字塔层的 BigTIFF 安全预览。
- 显示真实图片打开耗时,避免快速目录索引覆盖加载信息。
- 新增可自动淡出的缩放比例提示,支持百分比和相对“适应窗口”倍数。
- 新增可即时预览并持久化的深色、亮色主题。
- 修复设为默认图片应用后,资源管理器大图标视图可能回退显示 Pixora 图标的问题。
- 设置页“诊断与关于”现在清晰显示当前版本号和程序更新时间。
- 界面美观性优化:标题栏颜色随主题同步,控件悬停/按下有平滑过渡动画,右键菜单和徽标使用统一的系统图标,画布浮层配色完全主题化。
运行发布包:
- Windows 10 x64:最低支持 22H2
- Windows 11 x64
- .NET Desktop Runtime 9 x64
从源码构建需要 .NET 9 SDK。项目目标框架为 net9.0-windows,主要图片依赖为 Magick.NET-Q16-AnyCPU。
Windows 7、Windows 8.1 和 32 位 Windows 不在支持范围内。
dotnet run --project src\Pixora\Pixora.csproj也可以传入图片或目录:
dotnet run --project src\Pixora\Pixora.csproj -- "D:\Pictures"dotnet build Pixora.sln
dotnet run --project tests\Pixora.SmokeTests\Pixora.SmokeTests.csprojSmoke test 覆盖图片解码、超大图策略、视频封面、目录索引、快速搜索、缓存、设置、快捷键、裁剪、压缩、渲染和大目录性能。
需要测试真实素材目录时:
dotnet run --project tests\Pixora.SmokeTests\Pixora.SmokeTests.csproj -- --media-folder "D:\Samples" --sample-count 50 --video-sample-count 5.\publish.ps1 -Zip默认生成:
publish\Pixora-win-x64
publish\Pixora-win-x64.zip
默认发布包依赖 .NET Desktop Runtime 9 x64;使用 -SelfContained 可生成自包含版本。完整检查流程见 docs/RELEASE.md。
- USB 手机照片通过资源管理器的临时文件打开时,会尝试匹配仍打开的手机目录,并按需读取同目录照片;请保持手机解锁和该目录窗口打开。来源无法唯一匹配时仅查看当前文件,不扫描临时缓存目录。设备视图使用名称自然排序,暂不支持直接编辑、删除或收藏手机原图。
- 手机读取失败后可连接并解锁设备,再点击“重试读取”;设备目录或原文件变化时需重新打开。成功加载后,可通过“文件操作 → 保存原始副本到电脑”保存原始文件,再在本地编辑。
- 视频仅显示系统提供的封面,不支持播放、裁剪或压缩。
- 批量压缩只处理静态图片,动图会被跳过。
- 超大图片可能只加载安全预览;需要完整原始像素的裁剪、压缩和壁纸功能会停用。
- BigTIFF 只使用已有缩略图或金字塔层,不支持按瓦片读取和任意深度缩放。
- Windows 10/11 通常不允许普通应用静默修改默认应用。
详细解码边界和实现说明见 docs/ARCHITECTURE.md。
- “关联常见图片格式”会将 Pixora 添加到 Windows 的“打开方式”列表。
- “关联并设为默认应用”会尝试系统支持的方式;现代 Windows 通常需要用户在设置页确认。
- “高级一键默认”依赖用户自行提供的
SetUserFTA.exe,项目和正式发布包不内置该工具。
设置、收藏、快捷键、缓存和错误日志保存在:
%LOCALAPPDATA%\Pixora
启动时会尽力迁移旧版 %LOCALAPPDATA%\Pic-O 和 %LOCALAPPDATA%\PureView 中的用户数据。
src\Pixora:WPF 主程序。src\Pixora\Services:图片加载、目录索引、缓存、设置和文件关联等服务。tests\Pixora.SmokeTests:控制台式冒烟测试。test-images:内置测试样本。tools:批量压缩辅助脚本。
维护前请阅读 AGENTS.md、docs/ARCHITECTURE.md 和 docs/RELEASE.md。
Pixora 使用 MIT License,详见 LICENSE。