使用文档

这套文档怎么用

如果你第一次接触 Sugo Protector，建议按下面的顺序阅读：

1. 下载安装：确认系统要求、安装客户端、完成登录与授权激活。
2. CLI 使用文档：需要在构建流水线、批处理或服务器上自动保护时使用。
3. GUI 使用文档：用图形界面完成一次完整保护，适合日常操作。
4. GUI 完整使用文档：需要排查问题或使用全部功能时查阅。

GUI 还是 CLI？

两个版本使用同一套保护引擎，区别主要在交互方式与自动化能力。

建议：第一次先用 GUI 配置并验证一份样本，确认选项与函数范围后，再把同样的 .sugo 配置交给 CLI 在流水线中复用。

通用概念

输入文件与输出文件

• 输入文件：待保护的 PE、ELF、.NET 程序集或 Android APK/AAB。
• 输出文件：保护后生成的新文件，默认命名为 <原文件名>.protected.<原后缀>。
• 相对输出路径以输入文件所在目录为基准解析，不以当前工作目录为基准。

授权

保护前必须存在一条已激活且已绑定到本机的授权，并且授权类型覆盖当前文件类型。授权不覆盖时会直接拒绝保护，不会生成半成品文件。

.sugo 配置文件

每个输入文件可以有一份旁路配置 <输入文件完整路径>.sugo，保存输出路径、保护选项开关和函数保护规则。GUI 在开始保护前会自动保存，CLI 会自动读取。

保护前检查清单

• 已在测试机完成一次保护，并验证启动、登录、核心业务流程。
• 输出目录有足够磁盘空间，且没有被杀毒软件实时扫描锁定。
• 保留原始未保护产物，便于回滚和对比。
• 发布包使用正式签名证书，签名顺序与发布流程一致。
• 记录本次使用的客户端版本、保护选项和函数清单。

遇到问题

• 安装或授权问题：先看下载安装的常见问题。
• 命令行报错：看 CLI 使用文档的返回码与错误说明。
• 界面行为不符合预期：看 GUI 完整使用文档。
• 保护后崩溃或兼容性异常：看对应平台的技术文档。