Skip to content

About

「极速看图」是一款专注「快速翻看大量本地图片」的桌面应用。把一个文件夹拖进窗口,程序会按字母顺序递归遍历所有子目录,把每个目录里的图片按顺序连成一条完整浏览序列。配合双向预加载技术,左右方向键连按翻页时几乎感觉不到加载延迟;退出时自动记住浏览位置,下次启动从上次那张继续看。

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

极速看图(JisuKantu)

基于 Rust + Tauri 2.0 + Svelte 5 + Vite 的桌面图片浏览器 拖入目录即看 · 字母顺序递归浏览 · 全键盘操作 · 幻灯片播放 · EXIF 查看 · 翻页零动画、极速响应


项目简介

「极速看图」是一款专注「快速翻看大量本地图片」的桌面应用。把一个文件夹拖进窗口,程序会按字母顺序递归遍历所有子目录,把每个目录里的图片按顺序连成一条完整浏览序列。配合双向预加载技术,左右方向键连按翻页时几乎感觉不到加载延迟;退出时自动记住浏览位置,下次启动从上次那张继续看。

技术栈:

层 技术
后端 Rust 1.77+,Tauri 2,image 库(特殊格式解码),kamadak-exif(EXIF 解析),tauri-plugin-dialog(系统目录选择)
前端 Svelte 5(runes),Vite 6
通信 Tauri IPC 命令 + asset 协议(本地图片零拷贝直显)

本仓库已在 Debian 13 + Rust 1.98 + Node 24 环境验证:npm run build(前端)、cargo check / cargo test(后端,11/11 单测通过)全部通过;无显示环境,未做 GUI 交互测试,请在目标平台运行 npm run tauri dev 体验。


功能特性

  • 拖拽即开:把文件夹拖到窗口任意位置即可开始浏览;误拖文件时自动打开其所在目录
  • 点选即开:引导页大号「+」按钮弹出系统目录选择对话框,与拖拽完全等效(无需鼠标拖拽也能用)
  • 一键关目录:X 键关闭当前目录回到引导页,同时清空已记住的位置(下次启动不再自动恢复)
  • 递归有序浏览:按字母顺序递归遍历所有子目录(自然排序:img2.jpg 排在 img10.jpg 之前)
  • 30 余种图片格式:常用格式直显(最快),冷门格式(TIFF/TGA/PNM/DDS/QOI/HDR 等)由 Rust 解码
  • 极速翻页:前后双向预加载 + 解码池 + OS 页缓存预热 + PNG 解码缓存,切换零动画纯瞬时
  • 智能适配:大图等比缩放至完整可见,小图 1:1 居中黑底显示
  • 自由缩放平移:+/-/滚轮缩放(滚轮以鼠标位置为锚点),放大后可拖拽平移
  • 环形循环:最后一张的下一张回到第一张,第一张的上一张回到最后一张
  • 目录级跳转:PageUp / PageDown 在「有图的目录」之间跳转(空目录自动跳过)
  • 信息栏:Enter 切换显示图片相对路径、已看/总数、宽×高
  • 幻灯片播放:空格一键播放/暂停(末尾循环),, / . 分段步长实时调节间隔(0.1~30 秒),播放期间禁止屏保/休眠,信息栏与底部徽标实时显示状态
  • EXIF 信息:E 键呼出右侧面板,展示相机/镜头、拍摄时间、快门/光圈/ISO/焦距、测光/曝光程序/白平衡/闪光灯、GPS 位置与文件信息;Rust 侧会话级缓存,开关零成本
  • 位置与偏好记忆:退出时记住主目录/子目录/图片,以及幻灯片间隔(未打开目录时调整同样生效)、信息栏/EXIF 面板可见性,下次启动原样恢复
  • 全屏 / 最小化:方向键一键切换;最小化时自动退出幻灯片(恢复不自动重启)

支持的图片格式

类别 扩展名 显示方式
直显格式(WebView 原生渲染,速度最快) jpg jpeg jpe jfif png apng gif(含动图) bmp dib ico cur webp svg asset 协议直接加载
解码格式(Rust image 库解码转 PNG) tif tiff tga icb vda vst pbm pgm ppm pnm pam dds qoi hdr pic ff(farbfeld) 解码后缓存为 PNG 再显示
尽力直显(取决于系统 WebView) avif jxl heic heif WebView 支持则直接显示,否则提示错误

说明:AVIF 在 Windows WebView2(Win10/11)通常可直显;HEIC/HEIF 需要系统编解码器支持(macOS 较常见)。不支持时会给出提示,不影响继续浏览。PSD / EXR 等暂不支持。


快捷键

按键 功能
→ 右方向键 下一张图片
← 左方向键 上一张图片
↑ 上方向键 全屏显示 / 恢复窗口
↓ 下方向键 最小化窗口(幻灯片播放时自动退出)
PageDown 下一个目录(跳到该目录第一张图)
PageUp 上一个目录
Home 第一张图片
End 最后一张图片
Esc 退出程序(帮助层打开时先关闭帮助)
+ / = 放大
- / _ 缩小
Enter 显示 / 隐藏图片信息栏
E 显示 / 隐藏 EXIF 信息面板
X 关闭当前目录,回到引导页(同时清除位置记忆)
空格 幻灯片播放 / 暂停(末尾自动循环,播放期间阻止屏保/休眠)
,(含中文逗号) 幻灯片间隔减小:≤ 0.5 秒后改 0.1 秒步长(最小 0.1 秒)
.(含中文句号) 幻灯片间隔增大:≥ 5 秒后改 1 秒步长(最大 30 秒)
F1 显示 / 隐藏快捷键帮助

鼠标操作

操作 功能
引导页大号「+」按钮 点击弹出系统目录选择对话框(与拖拽等效)
点击窗口左半边 上一张图片
点击窗口右半边 下一张图片
滚轮向上 放大(以鼠标位置为中心)
滚轮向下 缩小
按住左键拖拽 平移图片(放大显示局部时)
拖入文件夹 打开 / 切换主目录
EXIF 面板内滚轮 滚动查看参数(不触发缩放/翻页)

信息栏(Enter 切换)显示在窗口顶部:50% 黑色背景 + 白色文字,内容为: 相对主目录的路径/文件名 · 已看张数 / 总张数 · 宽 × 高(px);幻灯片播放中会附加黄色 幻灯片 3.0s 指示。


幻灯片播放

  • 空格 开/关:按当前间隔自动翻到下一张,末尾循环回第一张,跨目录连续播放;手动翻页后重新计时,不打断播放
  • , / .(支持中文逗号/句号)分段步长调速,范围 0.1~30 秒,播放中立即生效:
    • 减小:间隔 ≤ 0.5 秒后改用 0.1 秒细步长,最小可到 0.1 秒;其余区间每次 -0.5 秒
    • 增大:间隔 < 0.5 秒时每次 +0.1 秒回到 0.5;0.5~5 秒每次 +0.5 秒;≥ 5 秒后改用 1 秒大步长,最大 30 秒
  • 播放期间禁止屏保/休眠:跨平台抑制(Windows SetThreadExecutionState / macOS IOKit 电源断言 / Linux systemd-inhibit),退出幻灯模式即恢复系统默认策略
  • 最小化自动退出:窗口最小化(或整窗不可见)时自动退出幻灯模式并解除保活;恢复窗口不会自动重启,需要时再按空格
  • 播放中底部显示黄色徽标 幻灯片播放中 · 3.0 秒/张 · 空格暂停,信息栏同步显示间隔
  • 间隔随状态文件持久化(未打开目录时调整同样会被记住);下次启动开始幻灯模式时使用上次的间隔值;切换新目录后自动停止(避免误播)
  • 复用预加载池:播到的每张图早已解码完毕,节奏稳定不掉帧

EXIF 信息(E 键)

右侧半透明面板(避开顶部信息栏),分区展示:

分区 内容
文件 文件名、相对路径、尺寸、大小、修改时间(任何格式都显示)
相机与拍摄 机身+镜头型号、拍摄时间
曝光参数 快门(1/250 s)、光圈(f/2.8)、ISO、焦距、等效 35mm、测光/曝光程序/白平衡/闪光灯
其他信息 拍摄方向、色彩空间、软件、作者、版权、描述
GPS 位置 纬度/经度(度分秒 + 十进制)、海拔
  • 适用 JPEG / TIFF 等含标准 EXIF 的图片;PNG / 截图 / 网络转存图通常没有 EXIF,会显示「不包含 EXIF 数据」及文件信息
  • 面板内可滚轮滚动、可选中复制参数;面板上的点击/滚轮不会触发翻页缩放
  • 解析在 Rust 侧(kamadak-exif)阻塞线程池执行,并带会话级缓存

目录遍历与排序规则

漫画/
├── cover.jpg          ← ① 先列出本目录的图片(按文件名自然排序)
├── ch02/
│   ├── 1.jpg          ← ③ 再按目录名顺序进入第一个子目录,如此递归
│   └── 10.jpg
├── ch01/              ← ② 注意:ch01 排在 ch02 之后?不 —— 目录按名称排序,
│   └── a.png             所以实际顺序是 ch01 的图先于 ch02 的图
└── empty/             ← 空目录不会出现在 PageUp/PageDown 导航序列里

准确规则:每个目录内,先显示本目录图片(自然排序),再依次进入按名称排序的各子目录递归;文件与目录均忽略大小写、数字按数值比较(img2 < img10,IMG.JPG 与 img.jpg 同级)。目录符号链接不跟随(防目录环)。


环境要求

项 要求
Rust ≥ 1.77.2(安装:https://rustup.rs)
Node.js ≥ 18(推荐 20+)
npm ≥ 9

Linux 额外系统依赖(Debian/Ubuntu):

sudo apt-get install libwebkit2gtk-4.1-dev build-essential curl wget file \
  libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev

Windows:需 WebView2(Win10/11 一般自带)+ MSVC Build Tools(通过 "Desktop development with C++")。 macOS:需 Xcode Command Line Tools(xcode-select --install)。


快速开始

# 1. 安装依赖
npm install

# 2. 开发模式(热重载)
npm run tauri dev

# 3. 打包发布版(安装包 + 可执行文件)
npm run tauri build

打包产物位置:src-tauri/target/release/bundle/(Windows 为 nsis/ 下的安装包与 msi/;macOS 为 dmg/;Linux 为 deb/ rpm/ appimage/)。

若只运行调试版可执行文件:cargo run --manifest-path src-tauri/Cargo.toml(调试构建需要 dev server,正式体验请用 npm run tauri dev 或 npm run tauri build)。


状态记忆(断点续看)

程序在每次切换图片后(防抖 200ms)自动保存位置与界面偏好,并在窗口关闭时兜底保存一次。状态文件:

系统 路径
Windows %APPDATA%\jisu-kantu\state.json
macOS ~/Library/Application Support/jisu-kantu/state.json
Linux ~/.config/jisu-kantu/state.json

删除该文件即可「忘记」上次位置。下次启动时若上次目录已不可用,会回到拖拽引导界面。

按 X 关闭目录与删除状态文件效果相同:立即回到引导页,并把状态文件中的位置清空(幻灯片间隔等界面偏好仍会保留)。之后拖拽或点「+」选择新目录即可开始新的浏览。

状态内容:主目录、子目录、当前图片,以及界面偏好(幻灯片间隔、信息栏 / EXIF 面板可见性)。幻灯片间隔在任何时候调整(包括未打开目录、按 X 之后)都会被记住,下次启动开始幻灯模式时直接使用。v1.0 的旧状态文件可无损升级读取,新字段自动取默认值。


项目结构

jisu-kantu/
├── index.html                  # Vite 入口 HTML(内联黑底防白闪)
├── package.json                # 前端依赖与脚本(npm run tauri dev/build)
├── vite.config.js              # Vite 配置
├── svelte.config.js
├── src/
│   ├── main.js                 # Svelte 5 mount 入口
│   ├── app.css                 # 全局样式(黑底、图片元素样式)
│   ├── App.svelte              # 主组件:看图核心逻辑(导航/缩放/预加载池/幻灯片/事件)
│   ├── lib/
│   │   └── format.js           # 展示格式化工具(快门/光圈/文件大小/日期)
│   └── components/
│       ├── HintScreen.svelte   # 引导屏(拖拽提示/大号+按钮/扫描中/空目录/错误)
│       ├── InfoBar.svelte      # 顶部信息栏(Enter 切换,含幻灯片指示)
│       ├── ExifPanel.svelte    # EXIF 信息面板(E 键切换)
│       └── HelpOverlay.svelte  # F1 帮助层
└── src-tauri/
    ├── Cargo.toml              # Rust 依赖(tauri 2 / image 0.25 / kamadak-exif / tauri-plugin-dialog / serde / dirs)
    ├── build.rs
    ├── tauri.conf.json         # 窗口/asset 协议/打包配置
    ├── capabilities/default.json  # Tauri 2 权限(全屏/最小化/关闭/标题/目录选择对话框)
    ├── icons/                  # 全套图标(png/ico/icns)
    └── src/
        ├── main.rs             # 程序入口
        ├── lib.rs              # Tauri Builder 装配(命令注册/事件/退出时解除屏保抑制)
        ├── scanner.rs          # 递归扫描 + 自然排序(含单元测试)
        ├── decoder.rs          # 特殊格式解码 → PNG 缓存(含单元测试)
        ├── exif.rs             # EXIF 解析 + 会话级缓存(含单元测试)
        ├── state.rs            # 状态持久化(含单元测试)
        ├── power.rs            # 幻灯片屏保/休眠抑制(跨平台,含单元测试)
        └── commands.rs         # Tauri IPC 命令定义

性能设计要点(为什么快)

  1. 零动画直换:切换图片时直接替换 DOM 元素,无过渡、无闪烁(图片先 decode() 完成后再上屏)
  2. 双向预加载池:当前图前后各 2~3 张提前创建 <img> 并解码,翻到的瞬间位图已就绪
  3. asset 协议直显:JPG/PNG/GIF/WebP 等由 WebView 直接加载本地文件,无编解码开销
  4. OS 页缓存预热:warm_files 命令后台预读即将展示的文件
  5. 解码缓存:特殊格式只在首次解码,结果按「路径+修改时间+大小」哈希缓存为 PNG,二次浏览毫秒级命中
  6. 池自动回收:远离当前位置的缓存图片及时释放,内存占用稳定
  7. EXIF 惰性加载:只在面板可见时拉取,Rust 侧会话级缓存 + 阻塞线程池解析,不影响翻页速度

常见问题(FAQ)

Q:为什么我的照片没有 EXIF? PNG / 截图 / 微信转存图等通常不含 EXIF;另外 HEIC 在部分平台的 WebView 不支持,EXIF 也读不到。JPEG / TIFF 照片一般都有。

Q:幻灯片会不会播到一半卡住? 不会。播放复用预加载池,下一张总是提前解码好;遇到无法解码的图会照常跳过继续。

Q:HEIC(iPhone 照片)显示不了? HEIC 需要系统 WebView 支持。Windows 需安装「HEIF 图像扩展」;部分 Linux WebKitGTK 版本不支持。程序会提示错误并可继续翻页。

Q:想改成「目录在前、文件在后」或其他排序? 修改 src-tauri/src/scanner.rs 中 scan_dir 的 files / subdirs 处理顺序即可,逻辑集中在一处。

Q:为什么我打不了正式包? 确认系统依赖完整(见「环境要求」),首次 npm run tauri build 会下载打包工具(NSIS / linuxdeploy 等),需要网络。

Q:图片切换为什么完全看不到加载过程? 这就是设计目标:图片在后台预解码完成后才瞬时上屏。网络盘上特别大的图首次仍可能有极短等待。

Q:点「+」选了目录没反应? 对话框中必须选中一个文件夹并确认;取消选择不会做任何事。若对话框都无法弹出,请检查 tauri-plugin-dialog 是否已随项目编译(正常 npm install + cargo build 会自动处理)。


许可

本项目代码供学习与自由使用。

About

「极速看图」是一款专注「快速翻看大量本地图片」的桌面应用。把一个文件夹拖进窗口,程序会按字母顺序递归遍历所有子目录,把每个目录里的图片按顺序连成一条完整浏览序列。配合双向预加载技术,左右方向键连按翻页时几乎感觉不到加载延迟;退出时自动记住浏览位置,下次启动从上次那张继续看。

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages