加密包和运行器如何配合

pyconcrete 会把 Python 模块转换为加密字节码，并由配套运行组件在导入或启动时解密执行。本工具接受单个 .py 或项目 ZIP，生成加密 .pyz、运行器及相关文件的下载包。运行器与本次构建所用密钥相匹配，不能随意替换为另一项目生成的运行器。

当前生成目标是 Linux x86_64 与 CPython 3.12。项目 ZIP 应有根目录 __main__.py，或在页面填写 package.module:function 入口；第三方依赖需要在目标机器另行提供。该方案提高直接查看源码的成本，但密钥和代码在运行环境中必须可用，不能构成绝对防逆向边界。

从脚本或项目 ZIP 生成运行包

1. 整理项目输入

   选择单个 .py，或上传保留包目录、资源文件和入口模块的 ZIP。ZIP 根目录放置 __main__.py，也可准备可调用函数作为入口。

2. 设置项目入口

   如果 ZIP 没有根目录入口，在输入框填写 package.module:function，例如 myapp.cli:main。模块和函数名必须与压缩包中的实际路径一致，函数应能在运行器启动时调用。

3. 等待加密构建

   页面会显示当前账号的上传大小限制。启动后文件经云端隔离处理，构建会生成匹配本次密钥的运行器和加密归档；如果依赖编译环境、入口或项目结构不满足要求，任务会失败并给出错误提示。

4. 下载后在目标环境验证

   解压输出包，在 Linux x86_64 且安装 CPython 3.12 的环境中运行。按项目要求准备未随包安装的第三方依赖，检查资源相对路径、启动命令和实际业务流程。

构建和运行问题

目标环境、密钥与安全边界

输出运行器针对 Linux x86_64 和 CPython 3.12。构建结果依赖 pyconcrete 及其本地编译工具链，运行时还需要项目用到的第三方库和系统依赖。部署前应先在与生产一致的系统镜像上验证启动、数据文件路径、异常退出和升级方式。

密钥与运行器匹配；妥善保存和限制分发输出包，不要误把同一运行器用于无关项目。加密/混淆只能提升逆向成本，经验丰富的使用者仍可能提取代码或密钥。请只处理拥有或获准处理的源码，并为真正的访问控制保留服务器端校验。