# zipbox **Repository Path**: syukugai/zipbox ## Basic Information - **Project Name**: zipbox - **Description**: 7-Zip File Manager 的 Linux 复刻版 —— Rust + GTK 4 编写,压缩 / 解压由官方 7-Zip 命令行工具(7zz / 7z)完成,界面与交互对齐 Windows 版 7-Zip File Manager。 A Linux clone of the 7-Zip File Manager, written in Rust with GTK 4. The com - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-25 - **Last Updated**: 2026-11-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # zipbox 7-Zip File Manager 的 Linux 复刻版 —— **Rust + GTK 4** 编写,压缩 / 解压由官方 7-Zip 命令行工具(`7zz` / `7z`)完成,界面与交互对齐 Windows 版 7-Zip File Manager。 A Linux clone of the 7-Zip File Manager, written in Rust with GTK 4. The compression engine is the official 7-Zip command line tool. > 仓库里 `src/`、`CMakeLists.txt` 是旧的 Qt 实现,仅作历史保留(`v1.0.0`)。 > 当前版本全部在 `crates/` 下。 ## 功能 / Features **文件管理** - 双面板(`F9` 切换),每面板独立的视图、排序、路径与历史;`Tab` 在面板间切换焦点 - 路径栏:前进 / 后退历史、已挂载驱动器下拉、可直接输入路径 - 视图:大图标 / 小图标 / 列表 / 详细信息,每个面板状态栏右端一键切换 - 排序:名称 / 类型 / 日期 / 大小 / 不排序,时间戳五档精度并可切换 UTC - 扁平视图、显示隐藏文件、自动刷新、`..` 上级项、工具栏可配置 - 收藏夹 10 个位置(`Alt+0`…`Alt+9` 打开,`Alt+Shift+0`…`Alt+Shift+9` 存入) - 明 / 暗主题切换(标题栏右侧按钮) - 界面语言:英文 / 简体中文,切换后程序自动重启生效 - 在线更新:`帮助 > 检查更新...` 读取 Gitee 上的最新发行版,有新版时显示发行说明并可 下载安装(窗口居中,`重新检查` 可原地再查一次);启动时每天最多检查一次,可在 `工具 > 选项 > 设置` 关闭 **压缩包** - 直接进入压缩包浏览(7z / zip / tar / rar / iso / cab / wim / gz / bz2 / xz …), 支持从任意分卷(`.001` / `.partN.rar`)打开;`退格` 或 `Ctrl+PgUp` 退出 - 解压:解压到当前文件夹、解压到同名文件夹、解压文件…(目标目录、四种覆盖方式、 路径模式、掩码、密码) - 压缩:添加到压缩包…(格式、压缩等级、方法、字典、字长、线程、固实块、分卷、 更新模式、路径模式、压缩后删除源文件、AES-256 加密、加密文件名、附加参数); “添加到 .7z / .zip” 不弹对话框 - 在压缩包内编辑:删除条目、`F2` 重命名、`F7` 新建文件夹;拖入或复制文件即加入压缩包 - 测试压缩包;分割文件…(`.001`、`.002`…)与合并文件…(缺卷会提示) - 符号链接 / 硬链接创建 - 拖放:拖出(压缩包内的条目先解到临时目录,再交给目标程序)、拖入(复制到文件夹 或加入打开的压缩包) **引擎与集成** - 自带 7-Zip 26.x 引擎:`.deb` 内置官方 `7zz`(`/usr/lib/zipbox/7zz`),优先于 系统里任何旧版,直接获得最新格式与安全修复 - 命令行动作(`--extract-here`、`--test`、`--crc` 等),供文件管理器菜单与脚本使用 - Nautilus(GNOME 文件)与 Dolphin(KDE)右键菜单子项 **zipbox**,安装 / 卸载时 自动重启正在运行的文件管理器,菜单立即生效 ## 快捷键 / Shortcuts 列表键作用于活动面板;菜单右侧标注同样的组合。 | 键 | 功能 | 键 | 功能 | |---|---|---|---| | `Enter` / 双击 | 打开光标项(文件夹 / 压缩包 / 文件) | `F2` | 重命名 | | `Ctrl+PgDn` | 打开压缩包内的文件夹 | `F3` | 查看 | | `退格` / `Ctrl+PgUp` | 上一级 / 退出压缩包 | `F4` | 编辑(`Shift+F4` 新建文件) | | `Tab` | 焦点移到另一个面板 | `F5` / `F6` | 复制到… / 移动到… | | `F9` | 单面板 / 双面板 | `F7` | 新建文件夹 | | `Ctrl+L` | 输入到活动面板地址栏 | `Delete` | 删除(压缩包内为移除条目) | | `Alt+F1` / `Alt+F2` | 输入到左 / 右面板地址栏 | `Alt+Enter` | 属性 | | `Alt+Up` | 在另一个面板显示此文件夹 | `Ctrl+N` | 新建文件 | | `Alt+Left` / `Alt+Right` | 在另一个面板打开光标项 | `Ctrl+A` | 全选 | | `Alt+0`…`Alt+9` | 前往收藏夹位置 | `Num+` / `Num-` / `Num*` | 按掩码选择 / 取消 / 反选 | | `Alt+Shift+0`…`Alt+Shift+9` | 把当前文件夹存入收藏夹 | `Shift+Num+` / `Shift+Num-` | 全选 / 全不选 | | `Ctrl+1`…`Ctrl+4` | 大图标 / 小图标 / 列表 / 详细信息 | `Alt+Num+` / `Alt+Num-` | 按类型选择 / 取消 | | `Ctrl+F3`…`Ctrl+F7` | 按名称 / 类型 / 日期 / 大小排序 / 不排序 | `Ctrl+H` | 显示隐藏文件 | | `Ctrl+R` | 刷新 | `F1` | 帮助 | | `Alt+F` `E` `V` `A` `T` `H` | 打开 文件 / 编辑 / 查看 / 收藏夹 / 工具 / 帮助 菜单 | `Ctrl+W` | 关闭窗口 | 程序内 `F1` 打开的帮助窗口里有同样的表格和更详细的说明(中英双语)。 ## 命令行 / Command line ```bash zipbox [PATH...] # 打开窗口;给出路径则直接打开 zipbox [--password PW] ACTION [PATH...] --extract-here PATHS # 解压到压缩包所在目录 --extract-to-name PATHS # 每个压缩包解到各自的文件夹 --extract-dialog PATHS # 用对话框解压 --test PATHS # 测试压缩包 --add-dialog PATHS # 对 PATHS 打开“添加到压缩包”对话框 --add-quick 7z|zip PATHS # 压缩为 PATHS[0].7z 或 .zip --open PATH # 在窗口中显示 PATH --crc METHOD PATHS # 输出校验值 --crc-save METHOD PATHS # 在每个文件旁写入 <文件>.<方法> --crc-check PATHS # 校验 PATHS 中的 .sha256/.md5 文件 --menu # 文件管理器菜单使用的对话框 --help / --version ``` `METHOD`:`CRC32` `CRC64` `XXH64` `MD5` `SHA1` `SHA256` `SHA384` `SHA512` `SHA3-256` `BLAKE2sp`(`-h` 是校验动作,不是 help)。 ```bash zipbox ~/Downloads/photo.7z zipbox --extract-here ~/Downloads/*.7z zipbox --crc SHA256 ~/Downloads/photo.7z ``` ## 依赖 / Requirements - GTK 4.14+、glib、graphene(`.deb` 的 `Depends` 由 `dpkg-shlibdeps` 自动生成) - Rust 1.80+(`cargo`) - 7-Zip 命令行:`.deb` 自带 `/usr/lib/zipbox/7zz`;从源码运行时装系统包 (`sudo apt install 7zip`)或用 `SEVENZIP_GUI_BINARY` 指定 ## 构建 / Build ```bash cargo build --release # → target/release/zipbox cargo test # 单元测试 cargo fmt --check cargo clippy --all-targets ``` 无头环境检查界面(Xvfb): ```bash Xvfb :99 -screen 0 1280x800x24 & DISPLAY=:99 ./target/release/zipbox ``` ## 安装 / Install ### Ubuntu 安装包 / .deb ```bash ./packaging/build-deb-rust.sh # 产物:dist/zipbox_<版本>_<架构>.deb sudo apt install ./dist/zipbox_<版本>_<架构>.deb sudo apt remove zipbox ``` 构建脚本会下载官方 7-Zip 26.05 引擎并打进包里(`ENGINE_TARBALL=` 可复用已下载的 tarball),`DEBVERSION=` 可覆盖版本号。包名 `zipbox` 带 `Conflicts/Replaces/ Provides: 7zipshell`,可直接替换旧的 `7zipshell` 包。 安装内容: | 路径 | 说明 | |---|---| | `/usr/bin/zipbox` | 主程序 | | `/usr/lib/zipbox/7zz` | 内置 7-Zip 26.x 引擎 | | `/usr/lib/zipbox/refresh-file-managers.sh` | 重启文件管理器的辅助脚本 | | `/usr/share/applications/zipbox.desktop` | 桌面启动项、压缩包默认打开方式 | | `/usr/share/icons/hicolor/scalable/apps/zipbox.svg` | 图标 | | `/usr/share/nautilus-python/extensions/zipbox.py` | Nautilus 右键菜单 | | `/usr/share/kio/servicemenus/zipbox-*.desktop` | Dolphin 右键菜单 | | `/usr/share/man/man1/zipbox.1.gz` | 手册页(`man zipbox`) | | `/usr/share/doc/zipbox/` | README、版权、按用户安装脚本 | `postinst` / `postrm` 会刷新 desktop / mime / 图标缓存,并在**原用户会话**里重启 正在运行的 Nautilus(`nautilus --quit`)与 KDE 菜单缓存(`kbuildsycoca`),装完 右键菜单立即可用,无需注销。 ### Snap(应用中心)/ Snap ```bash sudo snap install zipbox ``` Ubuntu 24.04 的**应用中心**里搜索 zipbox 也能安装;也可直接进入 点“在桌面商店中查看”。构建与上架流程见 [`docs/SNAP.md`](docs/SNAP.md)。 snap 版运行在**严格沙箱**里,和 `.deb` 版的差别: | 项目 | snap 版 | |---|---| | 可访问范围 | 家目录;外接盘需 `sudo snap connect zipbox:removable-media`。`/usr`、`/etc` 等系统目录不可读 | | 右键菜单 | 不含 Nautilus / Dolphin 菜单(沙箱无法写系统目录) | | 更新 | 由应用中心安装新版本;更新窗口里是“打开应用中心”按钮 | | 设置与收藏 | `~/snap/zipbox/current/.config/zipbox/` | | 外部编辑器(F4 自定义命令) | 沙箱内无法启动系统程序,改用默认应用打开 | ```bash sudo snap refresh zipbox # 手动更新 sudo snap remove zipbox # 卸载 ``` ### 手动安装 / Make-less install ```bash install -m 755 target/release/zipbox ~/.local/bin/zipbox install -m 644 packaging/zipbox.desktop ~/.local/share/applications/ ``` ## 文件管理器集成 / File manager integration `.deb` 已包含系统级菜单;只想装菜单(不装包)时: ```bash sh packaging/shell/install.sh # root 装系统级,普通用户装用户级 sh packaging/shell/install.sh --uninstall # 清理所有新旧副本 BINARY=/path/to/zipbox sh packaging/shell/install.sh ``` 脚本会先清掉所有历史安装名(`7zipshell` 与 `zipbox`)再装一份,避免菜单重复。 装完自动调用 `refresh-file-managers.sh` 重启正在运行的文件管理器;也可手动执行: ```bash sudo sh /usr/lib/zipbox/refresh-file-managers.sh ``` 菜单动作:打开压缩包、解压到当前文件夹、解压到同名文件夹、解压文件…、测试压缩包、 添加到压缩包…、添加到 “<名称>.7z” / “.zip”、CRC / 哈希(SHA-256 等)、 校验校验文件。这些动作在 zipbox 自己的对话框里执行,不打开主窗口。 ## 配置 / Configuration 设置文件:`~/.config/zipbox/config.toml`(`XDG_CONFIG_HOME` 可改),收藏夹: `~/.config/zipbox/favorites`。键与默认值: | 键 | 默认 | 说明 | |---|---|---| | `left_folder` / `right_folder` | 空 | 上次的两个面板目录 | | `active` | `0` | 活动面板:0 左、1 右 | | `two_panels` | `true` | 单 / 双面板 | | `view_mode_left` / `view_mode_right` | `3` | 0 大图标、1 小图标、2 列表、3 详细信息 | | `sort_left` / `sort_right` | `0` | 0 名称、1 类型、2 日期、3 大小、4 不排序 | | `sort_asc_left` / `sort_asc_right` | `true` | 升序 | | `toolbar_archive` / `toolbar_standard` | `true` | 工具栏组 | | `toolbar_large` / `toolbar_text` | `false` / `true` | 大按钮 / 按钮文字 | | `show_path_bar` / `show_parent` | `true` | 地址栏 / `..` 项 | | `timestamp_level` | `1` | 时间戳精度 0–4 | | `timestamp_utc` | `false` | 显示 UTC 时间 | | `auto_refresh` / `flat` / `show_hidden` | `false` | 视图选项 | | `editor` / `work_dir` | 空 | F4 的编辑器 / 工作目录 | | `language` | 空 | `en`、`zh_CN`,空 = 跟随系统 | | `check_updates` | `true` | 启动时检查更新(每天最多一次) | | `last_update_check` | `0` | 上次自动检查的 Unix 时间戳(秒) | 环境变量: - `SEVENZIP_GUI_BINARY` —— 指定 7-Zip 可执行文件,跳过自动查找 - `ZS_LANG` —— `en` / `zh_CN`,覆盖设置里的语言 - `XDG_CONFIG_HOME` —— 设置目录 升级自 1.x(`7zipshell`)时,首次启动会自动读取旧的 `~/.config/7zipshell/config.toml` 与 `favorites`。 ## 疑难解答 / Troubleshooting - **找不到 7-Zip 引擎**:所有压缩包操作都走 7-Zip 命令行。`.deb` 自带 `/usr/lib/zipbox/7zz`;源码运行时安装 `7zip`,或用 `SEVENZIP_GUI_BINARY` 指定路径(`工具 > 选项 > 7-Zip` 里能看到当前使用的引擎与版本)。 - **提示输入密码**:加密压缩包每次操作询问一次;文件管理器菜单的动作会单独弹出 密码窗口,避免被其他窗口挡住。 - **改了语言没生效**:`工具 > 选项 > 语言` 保存后程序会自动重启;也可以 `ZS_LANG=zh_CN zipbox` 直接指定。 - **想恢复默认设置**:删除 `~/.config/zipbox/` 即可。 - **检查更新失败**:手动检查会把原因显示在更新窗口里;启动时的自动检查失败则静默跳过。 检查使用系统里的 `curl` 或 `wget`,它们都不在时无法联网。以 `.deb` 安装的副本会 用 `pkexec` 请求管理员密码、由 `apt-get` 安装;源码或其他方式安装的副本只下载 安装包并用默认程序打开,需要自行安装;以 snap 安装的副本会打开应用中心, 由应用中心更新。 - **拖出的临时文件**:压缩包条目拖出时解到 `/tmp` 下的临时目录,拖放结束即删除。 - **尚未接通的菜单项**(为对齐 Windows 版保留):在外部打开、打开内部 `*` / `#`、 CRC 子菜单、基准测试、删除临时文件、文件夹历史、比较文件、注释、备用数据流。 哈希功能请用命令行(`--crc`)或文件管理器右键菜单。 ## 开发 / Development ``` crates/zs-engine/ 7-Zip 引擎封装:参数拼装、列表解析、错误摘要 crates/zs-gui/ GTK4 界面(Relm4):面板、菜单、对话框、任务 src/app.rs 组件与全部命令 src/help.rs F1 帮助窗口与关于框 src/menu.rs 菜单、动作、快捷键表 src/dialogs.rs 各类对话框(选项、属性、查看器…) src/cli.rs 命令行动作 docs/ 实现依据(7-Zip 26.05 规格)、功能对照表、snap 说明与截图 packaging/ deb / snap / 文件管理器菜单 / 图标 / AppStream 元数据 snap/ snapcraft.yaml 与商店图标 ``` 提交前:`cargo fmt --check && cargo clippy --all-targets && cargo test`。 ## 许可 / License MIT,见 [LICENSE](LICENSE)。7-Zip 由 Igor Pavlov 制作,引擎按其许可分发。