# pixlens

**Repository Path**: wyler_admin/pixlens

## Basic Information

- **Project Name**: pixlens
- **Description**: 免费 · 无广告 · 纯本地的 Windows 看图软件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-20
- **Last Updated**: 2026-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# PixLens · 图镜

**免费 · 无广告 · 纯本地的 Windows 看图软件**

*轻快如镜，纤毫毕现*

免费无广 ✦ PSD/PSB 原生支持 ✦ 图片+视频缩略图预览 ✦ 万张图库流畅浏览

[下载最新版](https://gitee.com/wyler_admin/pixlens/releases) · v1.3.4

</div>

---

## ✨ 为什么选择 PixLens

### 1. 设计师友好：原生 PSD / PSB 支持

不用启动 Photoshop，双击就能看设计稿。市面上的免费看图软件几乎都不支持 PSD——我们**自研了完整的 PSD/PSB 解析引擎**（Rust 实现），覆盖真实世界的全部形态：

- 🖼️ **资源管理器里直接显示 PSD/PSB/视频 缩略图**（安装即生效，不装 Photoshop 也有预览）——从真实 Photoshop 文件到游戏管线工具导出的"PSB"，从 CMYK 印刷稿到 640MB 大资源段文件、2GB 超大文件全覆盖；**MP4/MOV 等视频同样有缩略图**（纯净系统不装任何播放器/解码套件也出图），卸载时自动还原系统默认处理
- ⚡ 大文件不等待：2GB PSB 内嵌缩略图 23ms 出图；合成预览采用**跨步采样 + 流式按需读取**——只解码需要的行、只读取命中的字节，文件再大内存也有界
- 内嵌缩略图快路径 + 合成图解码双引擎，损坏文件全程护栏不崩溃

### 2. 极致性能（全部实测，非口号）

| 指标 | 实测结果 |
|---|---|
| 冷启动 | **215 ms** |
| 万张文件夹扫描 | **148 ms** |
| 万张缩略图墙滚动 | **60 fps 满帧** |
| 50MP 超大图 100% 平移 | **60 fps 满帧** |
| 翻页响应（已预取） | **0.9 ms** |
| 二次打开文件夹出图 | **19 ms** |
| 2GB PSB 内嵌缩略图 | **23 ms** |
| 视频代表帧缩略图（冷提取） | **~120 ms**（热缓存 4 ms） |
| 安装包体积 | **2.8 MB** |

### 3. 真正的免费与干净

- **无广告、无内购、无功能阉割**——不搞"专业版"套路
- **纯本地运行**：不联网、无遥测、无账号，你的图片不出你的电脑
- 卸载不留垃圾（缓存随卸载清理）

### 4. 小身材，全功能

安装包只有 2.8MB（同类 Electron 方案 100MB+），但该有的都有：

## 🖼️ 功能一览

**浏览**
- 虚拟滚动缩略图墙——单文件夹上万张流畅滚动
- 排序（文件名自然序/修改时间/大小/类型）、即时搜索、缩略图尺寸滑块
- 文件夹变更实时刷新（增删改自动同步）
- **视频也能看**：MP4/MOV/WebM/MKV/AVI/WMV 显示代表帧缩略图（带播放角标），双击交给系统默认播放器——**资源管理器里的视频缩略图也由 PixLens 提供**（v1.3.1 起接管，卸载还原系统默认）
- **拖拽即开**：图片/文件夹拖入窗口直接打开；空格键快速预览（悬停哪个看哪个）
- **接着上次用**：记住窗口位置大小，启动直达上次浏览的文件夹

**大图查看器**
- 默认按原始大小（100%）显示，滚轮以光标为中心平滑缩放、拖拽平移
- 旋转/翻转、全屏幻灯片（2/5/10 秒）、GIF 动图播放
- LOD 分级加载：预览先行，放大到 100% 无损替换
- 多页 TIFF 翻页（PgUp/PgDn）；32 位 HDR 曝光滑块（EV）
- **鼠标侧键翻页**（浏览器式前进/后退）；**EXIF 拍摄信息**（相机/镜头/光圈/快门/ISO/GPS）
- **一键设为桌面壁纸**（任意格式，含 PSD）
- 完整键盘快捷键 + 丝滑动效（开合过渡、翻页淡入）

**批量处理**
- 重命名：`{原名} {序号:n} {日期}` 模板，实时预览、冲突检测、交叉改名安全执行
- 格式转换（JPG/PNG/WebP）、压缩、缩放（最长边/百分比）
- Ctrl/Shift 多选、进度条、随时取消——万张转换 34.5s，UI 全程不卡

**基础编辑**（所见即所得）
- 裁剪（画布框选）、旋转/翻转保存
- 亮度/对比度/饱和度实时预览（预览 = 成品，同一套算法）
- 灰度/复古/反色滤镜；默认另存副本，原图零风险

**格式支持**：JPG · PNG · GIF(动图) · WebP · BMP · ICO · AVIF · SVG · TIFF(多页) · HDR(32位) · **PSD · PSB**（含 CMYK）

## 📦 安装

1. [下载](https://gitee.com/wyler_admin/pixlens/releases) `PixLens_x64-setup.exe`（2.8MB）双击安装
2. 安装时可选：**"为所有用户安装"（推荐）**——缩略图扩展写入机器级注册，兼容性最好（会弹一次管理员确认）；"仅为我安装"保持轻量用户级
3. **系统要求**：Windows 10/11 x64（WebView2 一般系统自带）
4. 首次运行如遇 SmartScreen 提示"已保护你的电脑"：点**更多信息 → 仍要运行**（个人开发者未购买代码签名证书）

> PSD/PSB/视频缩略图安装后即生效：**新文件立即可见**；旧文件如仍显示图标，是 Explorer 缓存了旧结果（安装完成页与应用首次启动均有提示）——重启资源管理器或电脑即可刷新。遇到环境问题的排查可使用仓库 `dist-diag` 诊断修复工具。
>
> .jpg 等常见格式如需设为默认打开方式：右键 → 打开方式 → 始终选择 PixLens（Windows 对常见格式有防篡改保护，任何软件都需要用户手动确认一次）。

## 🏗️ 技术架构（开发者向）

Tauri 2（Rust 核心 + WebView2 界面，TypeScript 无框架前端），几处值得一提的设计：

- **自研 PSD/PSB 解析器**（`crates/psd-codec`）：PSD/PSB 统一处理，**布局自适应解析**（真实世界的段长宽度形态多变，按结构锚点甄别）、mmap 零拷贝 + rayon 行级并行、**跨步行采样**让 2GB 文件只解 1/144 的数据就出预览、损坏文件全程护栏不崩溃
- **Explorer 缩略图扩展**：C++ COM 壳 + Rust 解码核心（独立 cdylib）+ 系统 GDI+，三层各司其职；视频走 Media Foundation 代表帧（与应用内 Rust 管线同策略）；流式初始化（2MB 头 + IStream seek 回调按需采样 + 容器 magic 嗅探）让任意大小文件都有界内存——这条路踩过的坑全部记录在 `doc/06-经验沉淀.md`
- **数据通道设计**：像素字节走自定义协议（`thumb://` / `image://`），JSON IPC 只走小控制消息；Canvas 位图渲染 + 定容 LRU 保证万张滚动内存有界
- **性能即验收**：12 项性能指标全部有自动化基准（`PIXLENS_BENCH` 验收模式），每次改动跑回归，指标即文档

## 📚 文档

| 文档 | 内容 |
|---|---|
| [doc/01-需求定义.md](doc/01-需求定义.md) | 定位与原则、功能清单、格式支持矩阵、决策记录 |
| [doc/02-技术选型.md](doc/02-技术选型.md) | 三方案对比、Tauri 决定与理由、依赖清单 |
| [doc/03-架构设计.md](doc/03-架构设计.md) | 分层架构、模块设计、PSD/PSB 解析器详设 |
| [doc/04-性能要求.md](doc/04-性能要求.md) | 12 项性能验收表（含测量方法） |
| [doc/05-里程碑计划.md](doc/05-里程碑计划.md) | M1~M7 分期计划 |
| [doc/06-经验沉淀.md](doc/06-经验沉淀.md) | 踩坑与解法实录（Shell 扩展/Rust×C++/分发/调试方法论） |
| [doc/验收记录.md](doc/验收记录.md) | 各里程碑实测验收数据（含 v1.1.x 真实文件排障全记录） |
| [CHANGELOG.md](CHANGELOG.md) | 版本更新日志 |

## 🛠️ 从源码构建

```bash
pnpm install                                # 前端依赖
pnpm tauri dev                              # 开发运行
cargo build -p psd-capi --release           # Rust 解码 cdylib（输出 pixlens_psd.dll）
cmd /c shell-thumb-cpp\build.bat            # C++ 缩略图 COM DLL
pnpm tauri build                            # NSIS 安装器（含缩略图扩展）
cargo test                                  # 单元测试
```

## 🗺️ 路线图

**已交付**（v1.1.x ~ v1.3.x）

- [x] EXIF 拍摄信息面板（相机参数、GPS）
- [x] 拖拽打开 / 空格快速预览 / 鼠标侧键翻页
- [x] 窗口几何记忆 + 启动恢复上次文件夹
- [x] 一键设为桌面壁纸（全格式）
- [x] 超大 PSD/PSB 的 Explorer 缩略图（任意大小、真实文件全形态、CMYK）
- [x] 远程诊断修复工具（dist-diag）
- [x] 双图对比视图（同步缩放平移，美术审稿利器）
- [x] 视频文件浏览（MP4 等代表帧缩略图 + 播放角标，双击系统播放器打开；Explorer 缩略图同步接管，卸载还原系统默认）
- [x] 安装后 Explorer 缓存知会（完成页说明 + 应用内一次性提示，不替用户强刷）

**规划中**（按"轻便 · 好用 · 高性能"尺子筛过之后刻意保持精简）

- [ ] 巨型图金字塔分块（tile://）

> RAW 格式（CR3/NEF/ARW）、收藏/评分等经评估**不纳入**：与"轻便"核心相悖，专业需求建议交给专业工具。

---

<div align="center">

**PixLens · 图镜** —— 看图本该如此轻快

</div>