Prometheus 开发者文档
Prometheus 是一款专为 Lua 开发者设计的企业级代码保护解决方案。不同于传统的本地混淆器，我们采用了 SaaS 云端编译架构，结合独创的 VM 虚拟化技术，为您的脚本提供银行级的安全防护。
为什么选择 SaaS 架构？
本地混淆器容易被破解者逆向分析出混淆算法。Prometheus 的核心混淆逻辑运行在云端服务器，客户端仅负责加密传输。这意味着没有任何人能通过分析客户端来破解您的代码。
1. 安装与激活
环境准备
- 操作系统：Windows 10 / 11 (64位)
- 网络环境：必须保持互联网连接（云端混淆需要验证）
- 运行库：无需安装 Python/Lua 环境，软件已内置独立运行时。
安装步骤
- 从官网下载最新版本的压缩包
Prometheus_v13.zip。 - 解压到任意文件夹（建议不要放在 C盘根目录或含中文路径）。
- 右键
Prometheus.exe，选择 以管理员身份运行。
关于杀毒软件误报
由于我们对软件自身进行了高强度加壳保护，Windows Defender 可能会误报为 "Trojan:Win32/Wacatac"。请将软件目录添加到杀软白名单，我们承诺软件绝对安全无毒。
2. 3分钟快速上手
完成激活登录后，您将看到主界面。只需三步即可完成混淆：
- 拖入文件：将您的
.lua脚本或整个文件夹拖入软件中部的列表区域。 - 选择强度：在顶部下拉框选择
Medium或Strong（推荐）。 - 开始混淆：点击右下角的
🚀 开始混淆 (F5)按钮。
稍等片刻，混淆后的文件将自动生成在源文件同级目录下，文件名带有 _obfuscated 后缀。
3. 混淆强度详解
我们提供了三种预设方案，分别适用于不同的开发场景。选择合适的强度可以在“安全性”和“性能”之间找到平衡。
| 预设 (Preset) | 包含特性 | 推荐适用场景 | 性能损耗 |
|---|---|---|---|
| Weak | 变量重命名 注释清除 |
开发调试阶段、对FPS要求极高的死循环代码。仅提供基础防读保护。 | 极低 (0%) |
| Medium | 控制流扁平化 字符串加密 垃圾代码注入 |
大多数通用脚本，如 UI 界面、配置表、非核心逻辑。（默认推荐） | 低 (5-10%) |
| Strong | VM 虚拟化 防篡改检测 动态操作码 |
核心验证模块、商业逻辑、关键算法。彻底防止反编译。 | 中 (15-20%) |
4. 哨兵模式 (Sentinel Mode)
这是一款为了解放开发者双手而设计的“自动化监听”功能。开启后，软件将化身为后台服务。
工作流演示
- 在软件右上角勾选 👁️ 自动监听。
- 将您的 VS Code 项目目录拖入软件。
- 回到 VS Code 编辑代码。
- 当你按下 Ctrl + S 保存文件时，Prometheus 会在 0.5秒 内自动完成混淆并覆盖输出文件。
您无需离开编辑器，实现“写完即混淆，保存即发布”的丝滑体验。
5. 右键菜单集成
为了进一步提高效率，您可以将 Prometheus 集成到 Windows 资源管理器的右键菜单中。
启用步骤
- 在软件顶部菜单栏点击 帮助 -> 🖱️ 添加到右键菜单。
- 弹出“成功”提示后，集成即生效。
使用方法
直接在任意 .lua 文件上点击鼠标右键，选择 🛡️ 使用 Prometheus 混淆。软件将自动启动、加载该文件并准备就绪。
提示
如果移动了软件位置，右键菜单可能会失效。请重新运行软件并再次点击添加即可修复。
6. VM 虚拟化原理
在 Strong 模式下，Prometheus 不再生成标准的 Lua 代码，而是生成一套自定义的虚拟指令集。
- 编译：将源码编译为自定义 OpCode（操作码）。
- 封装：生成一个随机化的虚拟 CPU (VM Interpreter)。
- 执行：脚本运行时，由虚拟 CPU 读取 OpCode 并解释执行。
-- 混淆前
print("Hello World")
-- VM 混淆后 (示意)
local v1 = {0x45, 0x12, 0x99...} -- OpCode
local v2 = function(a, b) ... end -- Virtual CPU
v2(v1) -- Execute
由于 OpCode 和 CPU 逻辑在每次混淆时都是随机生成的，传统的反编译器（如 LuaDec, Unluac）将完全失效。
7. 自定义参数详解
在软件界面的 "参数 (Args)" 输入框中，您可以输入以下高级指令来开启特殊功能：
| 参数指令 | 功能描述 |
|---|---|
| --roblox | 启用针对 Roblox (Luau) 引擎的兼容模式，防止特定语法报错。 |
| --fivem | 针对 GTA5 FiveM 引擎优化，减少资源占用。 |
| --no-watermark | 隐藏混淆文件头部的版权信息注释（仅限企业版）。 |
| --debug | 在混淆代码中保留部分调试信息，用于排查运行错误。 |
8. 游戏引擎兼容性
Prometheus 并非普通的 Lua 混淆器，它内置了多套语法规则以适配不同的游戏引擎。
- ✅ 标准 Lua 5.1 - 5.4：完美支持所有特性。
- ✅ LuaJIT：支持高性能 JIT 编译模式。
- ✅ FiveM (GTA5)：经过数千个脚本测试，无掉帧，无红字报错。
- ✅ Roblox (Luau)：支持 Luau 特有的语法糖（需加 --roblox 参数）。
- ✅ World of Warcraft (WoW)：兼容魔兽世界 API 环境。
9. 常见问题 (FAQ)
Q: 混淆后的脚本体积变大了？
A: 正常现象。为了保护代码，我们注入了大量的垃圾代码、加密字符串和 VM 解释器。通常体积会增加 3-5 倍，但这不影响运行逻辑。
Q: 如何排除某些文件不被混淆？
A: 目前支持白名单机制。如果您拖入的是文件夹，可以在软件设置中添加忽略规则（即将上线）。目前建议手动剔除不需要的文件。
Q: 提示 "Network Error" 或 "连接超时"？
A: 请检查您的网络连接。由于核心引擎在云端，我们需要稳定的网络传输数据。软件内置了断线重连机制，如果依然失败，请检查防火墙是否拦截了 Python 进程。
10. 错误代码查询
| 错误提示 | 原因分析 | 解决方案 |
|---|---|---|
| API 鉴权失败 | 卡密无效、过期或机器码不匹配。 | 检查卡密是否输入正确，或联系客服解绑机器码。 |
| 文件过大 | 源码超过了服务器限制 (10MB)。 | 请拆分文件进行混淆，或联系客服升级企业版额度。 |
| syntax error | 源代码本身有语法错误。 | 混淆前请先确保源码能正常运行。 |
11. 联系与支持
如果您在使用过程中遇到任何问题，欢迎通过以下渠道联系我们：
- 官方 QQ 群: 1074204946
- 商务合作: 1347774200@qq.com
- Telegram: @Prometheus_Dev