沙盒启动器 .plagr 转换器

此仓库包含一个 Rust 包，它是沙盒启动器项目的一部分。该包提供将文件转换为和从 .plagr 文件格式的功能，这是我们项目的自定义文件格式。

.plagr 文件格式允许我们将不同类型的文件存储为 base64 编码的文本文件。原始文件的扩展名存储在文件顶部，使得在需要时很容易将其转换回原始格式。

新功能

我们将转换器迁移到 Rust 并添加了一些新功能。以下是变更的概述

加密（安全模式）

现在您可以在压缩和将数据转换为 .plagr 格式之前对数据进行加密。此功能为敏感文件提供了额外的安全层。要启用加密，请在运行 plagr to_plagr 命令时使用 --secure 标志。

解密

当将 .plagr 文件转换回其原始格式时，现在可以解密在转换过程中加密的数据。此功能确保数据保持安全，并且只能通过正确的解密密钥访问。解密过程需要提供用于加密的密钥，并将 --secure 标志设置为。您可以通过使用 --keys 选项将密钥作为命令行参数提供，或者使用 --key-path 选项指定 key.ini 文件的路径。

文件扩展名覆盖

新功能允许您将文件扩展名传递给 from_plagr 命令。此功能忽略在 .plagr 文件中设置的文件扩展名，而是使用通过命令行参数传递的扩展名。当您想确保转换文件具有特定的文件扩展名时，这很有用。要覆盖文件扩展名，请在命令行参数中使用 --ext 标志，后跟所需的扩展名（无需点号）。例如

plagr from_plagr test.plagr --ext txt

在上面的命令中，test.plagr 文件将转换为 .txt 文件，无论原始文件扩展名存储在 .plagr file.

备份文件选项

转换器提供在转换前创建原始文件备份的选项。此备份文件在需要稍后恢复原始文件时可能很有用。要在运行 plagr to_plagr 命令时创建备份，请使用 --no-backup 标志。

清理选项

当将 .plagr 文件转换回其原始格式时，您可以选择是否在转换后删除 .plagr 文件及其备份文件。此选项提供了更多对文件管理的控制。要在运行 plagr from_plagr 命令时跳过清理过程，请使用 --no-cleanup 标志。

增强错误处理

我们已经改进了转换器的错误处理，以提供更多有用的错误消息并处理各种边缘情况。

安装

要安装 .plagr 转换器，请确保您的系统已安装 Rust 和 Cargo。然后，运行以下命令

cargo install plagr

这将安装 plagr 命令行工具，您可以使用它将文件转换为 .plagr 格式，或将文件从 .plagr 格式转换为其他格式。

用法

要将文件转换为 .plagr 格式，请使用以下命令

plagr to_plagr <file> [--ext <ext>] [--no-backup] [--secure]

在上面的命令中，将 <file> 替换为您要转换的文件的路径。--ext 选项允许您为转换文件指定新的文件扩展名。默认情况下，将使用原始文件的扩展名。--no-backup 标志跳过创建原始文件的备份，而 --secure 标志启用加密。

plagr from_plagr <file> [--keys <keys>] [--key-path <key-path>] [--no-cleanup] [--secure] [--ext <ext>]