一款免费开源的 Windows 系统重装工具
LetRecovery 在 PolyForm Noncommercial 1.0.0 许可范围内免费使用并公开源代码。 该许可证不是 OSI 认可的传统开源许可证,禁止商业用途。请仅从本页下方的官方渠道获取。
⚠️ 严禁将本项目用于任何违反用户协议的行为。 对侵权、违规分发、未经授权的商业定制及其他违约使用,作者保留依法追究责任的权利;作者同时保留在适用法律及既有许可约束允许的范围内,随时调整后续版本授权方式或停止公开后续版本源代码的权利。
维护交接: 原作者现已进入高中阶段,后续日常维护将由 hwyyds-skidder-team 接替。项目原有作者署名、许可证和使用条款不因此改变。
bin/pe 保持用户可定制,不会因修改 WIM 被远端哈希阻断可部署的目标镜像范围比运行环境更广,包含功能列表中列出的 Windows XP/2003 及较新 Windows 版本;旧系统能否正常启动仍取决于硬件、固件模式和驱动支持。
⚠️ 警告: 安装系统会格式化目标分区,请提前备份重要数据!
LetRecovery/
├── lr-core/ # 两端共享的纯逻辑与 Windows 适配层
├── 正常系统端/ # Windows 桌面环境版本
├── PE端/ # WinPE 环境版本
├── assets/ # 发布时使用的语言和资源文件
├── docs/ # 设计与第三方二进制溯源文档
├── Cargo.toml # Rust workspace
├── Cargo.lock # 已锁定的应用依赖图
└── LICENSE # PolyForm Noncommercial 1.0.0
| 技术 | 用途 |
|---|---|
| Rust | 主要编程语言 |
| 原生 Win32 / windows-rs | 正常系统端与 PE 端界面、Windows API 边界 |
| tokio | 异步运行时 |
| aria2 | 高速下载引擎 |
| wimlib / WIMGAPI / DISM | 系统镜像部署、捕获与驱动维护 |
| Ghost | GHO 镜像恢复 |
rust-src 组件(正常端 Win7 构建与 CI 固定使用该版本)# 克隆仓库
git clone https://github.com/NORMAL-EX/LetRecovery.git
cd LetRecovery
# 正常系统端必须使用 Win7 目标重编译标准库,并在构建后检查导入表
rustup toolchain install 1.88.0 --component rust-src
powershell -ExecutionPolicy Bypass -File .github/scripts/build-win7-normal.ps1
# PE 端仅运行在现代 WinPE,继续使用普通 Windows MSVC 目标单独构建
cargo +1.88.0 build -p letrecovery-pe --release --locked --target x86_64-pc-windows-msvc
不要用
cargo build --workspace --release生成要在 Windows 7 上运行的正常端程序。该命令会使用宿主机的x86_64-pc-windows-msvc标准库,可能静态导入 Windows 8+ API。本地与 Release 必须统一通过build-win7-normal.ps1生成并验证target/x86_64-win7-windows-msvc/release/LetRecovery.exe。
提交前应运行:
cargo fmt --all --check
cargo check --workspace --all-targets --locked
cargo clippy --workspace --all-targets --locked --features "LetRecovery/non-elevated-tests,letrecovery-pe/non-elevated-tests" -- -D warnings -A clippy::uninlined_format_args
cargo test --workspace --no-run --locked --features "LetRecovery/non-elevated-tests,letrecovery-pe/non-elevated-tests"
cargo test -p lr-core --locked
cargo test -p letrecovery-pe --locked --features non-elevated-tests
cargo test -p LetRecovery --locked --features non-elevated-tests
CI 会在 Pull Request 和 main push 上编译全部测试目标并运行确定性单元测试。官网由独立私有仓库维护;本仓库创建 Release 成功后会同步更新其 version.json。CI 不会执行真实格式化、分区、BCD、DISM 写盘或重启;这些流程必须在隔离虚拟机和专用测试盘上另行验证。内置 libwim-15.dll 的版本、许可证和哈希见 第三方二进制清单。
本项目采用 PolyForm Noncommercial License 1.0.0 许可证。
这是一个 source-available(源代码公开)许可证,不是 OSI 批准的开源许可证,也不应笼统描述为传统意义上的“开源软件”。
安全问题请按 SECURITY.md 中的方式私下报告。参与开发前请阅读 CONTRIBUTING.md。
感谢所有参与测试、反馈与代码贡献的社区成员。
No open issues yet, or sync has not completed.