# 元舟压缩

**Repository Path**: pivark/yuanzhou-compression

## Basic Information

- **Project Name**: 元舟压缩
- **Description**: 元舟开源系列
- **Primary Language**: Rust
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-31
- **Last Updated**: 2026-08-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 元舟压缩

**把压缩这件事做干净。**

本地压缩 · 本地解压 · 不绑杀软 · 不往资源管理器里塞插件。  
Windows 先行，Linux / 鸿蒙同内核跟进。

[在线仓库](https://gitee.com/pivark/yuanzhou-compression) · 版本 **0.1.0** · [MIT](LICENSE)

### 下载

**Windows 安装包（推荐）** → [元舟压缩_0.1.0_setup.exe](https://gitee.com/pivark/yuanzhou-compression/releases/download/v0.1.0/元舟压缩_0.1.0_setup.exe)  
发行说明：[Releases / v0.1.0](https://gitee.com/pivark/yuanzhou-compression/releases/v0.1.0)

---

## 一句话

自研 **Rust 压缩内核**，外面包一层轻量 **Flutter** 壳。  
算法在 `core`，界面只负责点选与进度——不另起一套「壳内压缩」。

| 你要的 | 元舟怎么做 |
|--------|------------|
| 装上不折腾系统 | 无驱动、无 Explorer COM 注入；右键/关联走安装包注册，坏了大不了本程序退出 |
| 格式别太寒酸 | ZIP / 7z / TAR·GZ 读写；RAR、ISO、XZ、BZ2 等只解压；分卷、自解压 EXE |
| 界面可认真可极简 | 现壳 / 7-Zip 风格模板一键切换；四语界面；配色跟系列主题 |
| 广告能关 | 系列推广位可关；**内核从不联网弹广告** |

---

## 能做什么（0.1）

### 压缩与解压

- **ZIP**：Deflate（zlib-ng）· AES 加密 · 分卷 · Windows 自解压（SFX）
- **7z**：读写 · 固实 · LZMA2 多线程；可选调用本机 7-Zip 加速写侧
- **TAR / GZ / TAR.GZ**：日常打包与解压
- **只解压**：RAR · ISO · XZ · BZ2 · TAR.XZ · TAR.BZ2
- **改包**：ZIP 内增删文件；排除规则同时作用于压缩与解压
- **档位**：快 / 标准 / 极限内置调校；极小文件自动 Store；PE 可走 BCJ

### 浏览与预览

- 包内目录树、多选、筛选、CRC、选中解压
- 文本预览（语法高亮 + 行号）· 图片预览
- 拖入文件即开；「解压到此」一键落盘

### Windows 集成

- 资源管理器右键菜单 · 按扩展图标的文件关联
- 命令行：`--open` / `--compress` / `--extract` / `--extract-here` / `--test`
- Inno Setup 安装包；可选桌面快捷方式与系统集成项

### 体验细节

- 进度可取消 · 最近打开 · 解压后打开目录 · 包名子目录
- 可选密码记忆（**仅 Windows DPAPI**，默认关）
- Pro：离线激活壳 · 创建数据 ISO（能力位 `createIso`）

完整路线与缺口对照见 [docs/features.md](docs/features.md)、[docs/gap-vs-competitors.md](docs/gap-vs-competitors.md)。

---

## 明确不做

强制登录 · 第三方广告 SDK · 捆绑安装页 · 假关联未实现格式 · 把业务逻辑塞进公共 kit

装机稳定性说明：[docs/security-av.md](docs/security-av.md)

---

## 架构一眼看懂

```text
┌─────────────────────────────────────────┐
│  Flutter 壳（app/）  浏览 · 设置 · CLI  │
└──────────────────┬──────────────────────┘
                   │ C ABI
┌──────────────────▼──────────────────────┐
│  Rust 内核（core/）  压缩 · 格式 · SFX  │
└─────────────────────────────────────────┘
```

```text
元舟压缩/
├── app/                        Flutter 壳
├── core/                       Rust 内核 + FFI + SFX stub
├── platforms/windows/shell/    右键 / 关联脚本
├── installer/                  Inno Setup
├── docs/                       架构 · API · 测试 · 审计
└── build-all.ps1               一键出 Windows 安装包
```

契约与模块边界：[docs/architecture.md](docs/architecture.md) · [docs/api.md](docs/api.md)

---

## 从源码跑起来

**环境**：Rust（见 `core/rust-toolchain.toml`）+ MSVC · CMake（zlib-ng）· Flutter **3.44.8** · 打安装包需 Inno Setup 6+

壳依赖系列公共包 `yuanzhou-kit`（本机放在兄弟目录 `../yuanzhou-kit`；独立 clone 请改 git tag 或拷贝到 `packages/yuanzhou_kit`）。

```powershell
# 内核
cd core
cargo test --workspace
cargo build -p yuanzhou_ffi --release
cargo build -p yuanzhou_sfx --release

# 壳
cd ..\app
flutter pub get
flutter test
flutter run -d windows

# 安装包 → release\元舟压缩_0.1.0_setup.exe
cd ..
.\build-all.ps1 -Platform windows
```

测通清单：[docs/test-matrix.md](docs/test-matrix.md) · Win 验收：[docs/plans/win-accept-0.1.md](docs/plans/win-accept-0.1.md)

---

## 文档

| | |
|--|--|
| [CHANGELOG](CHANGELOG.md) | 版本变更 |
| [algorithms](docs/algorithms.md) | 算法选型 |
| [cli](docs/cli.md) | 命令行参数 |
| [audits/2026-07-28](docs/audits/2026-07-28.md) | 代码审计（含系统稳定性） |
| [docs/README](docs/README.md) | 文档目录 |

---

## 许可

[MIT](LICENSE)  
© 元舟 / 杭州珍睿网络科技有限公司 · [www.zhenrui.net](https://www.zhenrui.net)