🛡️ CodeShield · 代码护盾

Cocos Creator 全功能 JavaScript 代码安全保护插件
构建后自动混淆 · AST 深度混淆 · 图片压缩 · 图片哈希修改 · Super HTML 打包

🔥 一键保护你的游戏代码，杜绝盗版与逆向破解

_{支持 Cocos Creator 3.x ｜ Web / 小游戏 / 可玩广告平台}

--- ## 🔥 为什么要买它？ **你的游戏代码正在裸奔！** Cocos Creator 构建的 H5 游戏，JS 代码明文暴露在浏览器中——任何人按 `F12` 就能看到你的核心逻辑、包体配置、通信协议，小游戏平台分分钟被逆向反编译。几秒钟就能复制走你的游戏，换皮上线，你辛苦几个月的成果化为乌有。 **CodeShield 代码护盾**提供一站式解决方案： | ❌ 痛点 | ✅ CodeShield 解决方案 | |------|-------------------| | JS 代码完全明文，按 F12 一览无余 | **三档预设 + AST 双重混淆**，代码彻底不可读 | | 每次构建都要手动找工具保护 | **构建完成自动触发**，设置即忘，零额外操作 | | 字符串明文暴露游戏配置和 API 地址 | **base64 / RC4 编码**，密钥级加密保护 | | 调试工具可轻松下断点分析逻辑 | **反调试 + 反控制台**，开发者工具直接失效 | | 图片被 CDN 盗链、缓存无法刷新 | **一键修改图片哈希**，自动刷新缓存指纹 | | 包体过大、加载速度慢 | **一键图片压缩**，最大可减少 70% 图片体积 | | 想做可玩广告但资源文件零散 | **Super HTML 打包**，整个游戏一个文件，即开即玩 | --- ## ✨ 核心功能 & 功能介绍 ### 1️⃣ 构建后自动混淆 — 真正的"设置即忘" 深度集成 Cocos Creator 构建管线，构建成功即自动执行混淆保护，无需任何手动操作。 - ✅ **自动触发** — 监听 Cocos Creator `builder:task-changed` 事件，构建完成立即执行 - ✅ **智能跳过引擎** — 自动识别并跳过 `/cocos/`、`/cc/`、`physics` 等引擎核心文件，确保运行时零故障 - ✅ **全平台支持** — 微信小游戏、字节小游戏、QQ 小游戏、支付宝小游戏、Web 全兼容 - ✅ **JSON 混淆** — 可选开启 JSON 配置文件混淆，全方位保护游戏数据 ```json // 只需一次配置，后续构建全自动 { "auto": true, "autoAstObfusJs": false, "autoObfusJson": true } ``` ### 2️⃣ AST 深度混淆 — 双重保护，双重安心 **普通混淆只做一层，CodeShield 做两层！** | 层级 | 技术栈 | 效果 | |------|--------|------| | **第一层** | `javascript-obfuscator` | 标准代码混淆、字符串编码、控制流混淆 | | **第二层（AST 深度）** | `esprima` 解析 AST → `confusion` 变换 → `escodegen` 生成 → `js-confuser` 二次强化 | 死代码注入、计算器混淆、十六进制数字、变量重命名、分发器混淆、字符串隐藏 | > 💡 **双重混淆后的代码几乎无法被任何已知工具还原，安全性达到业界顶级水平。** ### 3️⃣ 三档预设 + 30 项精细参数 — 小白也能用，高手也能调无需理解底层原理，直接选择预设即可上手；进阶用户可以逐项微调每一个参数。 #### 🎯 预设速选 | 预设 | 安全等级 | 运行时影响 | 一句话描述 | 推荐场景 | |------|----------|-----------|-----------|----------| | **🟢 轻度** | ⭐⭐ | 几乎无影响 | 基础压缩 + 字符串 base64 编码 | 调试阶段、快速迭代、性能敏感项目 | | **🟡 中度** | ⭐⭐⭐⭐ | 较小 | 反调试 + 变量重命名 + 自防御 | **正式发布首选**，大多数项目推荐 | | **🔴 重度** | ⭐⭐⭐⭐⭐⭐ | 约 5~15% | 控制流平坦化 + 死代码注入 + RC4 加密 | 高安全需求、商业机密保护、防换皮 | #### ⚙️ 完整可调参数（30 项） ``` ▸ compact（代码压缩） ▸ controlFlowFlattening + 阈值 ▸ deadCodeInjection + 阈值 ▸ debugProtection（反调试） ▸ disableConsoleOutput（禁控制台） ▸ identifierNamesGenerator（4种命名方式） ▸ stringArray（字符串数组） ▸ rotateStringArray（循环移位） ▸ shuffleStringArray（洗牌） ▸ stringArrayThreshold（阈值） ▸ stringArrayEncoding（base64 / RC4） ▸ selfDefending（自防御） ▸ transformObjectKeys（对象键转换） ▸ unicodeEscapeSequence（Unicode 转义） ▸ renameGlobals（重命名全局变量） ▸ seed（随机种子） ▸ splitStrings + 分块长度 ▸ numbersToExpressions（数字转表达式） ▸ simplify（代码简化） ▸ stringArrayIndexShift（索引偏移） ▸ stringArrayCallsTransform + 阈值 ▸ stringArrayWrappersCount + 类型 ``` ### 4️⃣ 一键图片压缩自动扫描 `assets/` 目录下所有 PNG / JPG，一键批量压缩，显著减小包体。 | 模式 | 引擎 | 特点 | |------|------|------| | **高级压缩** | `jimp` | 智能降质，PNG/JPG 分别优化，效果最佳 | | **基础压缩（降级）** | 纯 Node.js (zlib) | jimp 不可用时自动降级，零依赖风险 | - 控制台实时输出每张图片的压缩前后体积对比 - 压缩失败自动跳过，不影响其他图片处理 ### 5️⃣ 批量修改图片哈希针对微信小游戏、字节小游戏等平台的 **防盗链 / CDN 缓存刷新** 需求： - **PNG** — 修改右下角像素的 R 通道 LSB，视觉完全无影响 - **JPG** — 插入注释段 (COM segment) 改变文件指纹 - **零依赖实现** — 内置手写 CRC32 校验，不依赖任何第三方库 - 单次操作即可刷新所有图片资源标识，绕过 CDN 缓存和防盗链检测 ### 6️⃣ Super HTML 打包 — 单文件发布神器将整个 `web-mobile` 构建产物打包为 **一个独立的 HTML 文件**： ``` build/web-mobile/ → build/playable.html 🎉 ├── index.html ├── style.css (内联到 HTML) ├── *.js (内联到 HTML) ├── assets/ (全部 base64 嵌入) → 一个文件，即开即玩！ ├── fonts/ (全部 base64 嵌入) ├── audio/ (全部 base64 嵌入) └── ... ``` 内置 **XHR / fetch 拦截器**，所有资源请求自动从内存映射表中响应，完美模拟服务器环境。 **完美应用场景：** - 📱 **可玩广告（Playable Ads）** — Facebook / Google / TikTok 投放 - 🎮 **游戏 Demo 分享** — 发一个链接就能试玩 - 📧 **邮件营销投放** — 一个 HTML 附件全包含 - 🌍 **纯静态分发** — 不需要任何服务器 --- ## 🎯 为什么选 CodeShield？ | 对比维度 | CodeShield ✅ | 手动使用免费工具 ❌ | |----------|---------------|-------------------| | **集成深度** | 原生 Cocos Creator 插件，构建即触发，无需任何操作 | 需手动安装 npm 包、编写构建脚本、管理配置文件 | | **AST 深度混淆** | ✅ **独家双层混淆**，业内顶级保护强度 | ❌ 免费工具有单层混淆，无 AST 深度保护 | | **预设系统** | ✅ 三档预设一键切换，含描述提示 | ❌ 需自己查阅文档、手写配置 JSON | | **参数精细度** | ✅ 30 项参数逐项可调，UI 面板可视化 | ❌ 命令行配置，调一次查半天文档 | | **图片处理** | ✅ 一键压缩 + 一键修改哈希，内置集成 | ❌ 需额外安装图片工具，分开处理 | | **Super HTML** | ✅ 一键打包，内置资源拦截器 | ❌ 无现成方案，需手写内联脚本 | | **每次构建耗时** | **0 秒**（全自动运行） | 数十分钟（手动重复操作） | | **售后服务** | ✅ 持续更新维护，问题响应 | ❌ 无 | --- ## ⚡ 快速上手：使用教程（30 秒学会） ``` 1. 按 Alt+S 打开插件面板 2. 打开「构建后自动混淆」开关 3. 选择「中度」预设 4. 正常构建你的项目（Ctrl+B / Cmd+B） 5. ✅ 搞定！JS 代码已自动保护 ``` --- ## 🎛️ 面板导览 ``` ┌──────────────────────────────────────────────────────┐ │ 🛡️ CodeShield · 代码护盾 v1.0.0 │ ├──────────────────────────────────────────────────────┤ │ │ │ 📋 控制开关 │ │ ┌──────────────────────────────────────────────────┐ │ │ │ ✅ 构建后自动混淆构建完成后自动混淆所有 JS 文件 │ │ │ │ ⬜ AST 深度混淆使用 AST 进行二次深度混淆 │ │ │ │ ✅ 混淆 JSON 文件同时混淆 JSON 配置文件 │ │ │ └──────────────────────────────────────────────────┘ │ │ │ │ 🎯 混淆预设 │ │ ┌──────────────────────────────────────────────────┐ │ │ │ [ 🟢 轻度 ] [ 🟡 中度 ] [ 🔴 重度 ] │ │ │ │ 常规混淆，开启反调试和变量重命名 │ │ │ └──────────────────────────────────────────────────┘ │ │ │ │ ⚙️ 混淆参数（30 项精细调节） │ │ ┌──────────────────────────────────────────────────┐ │ │ │ ☑ compact (压缩) │ │ │ │ ☑ controlFlowFlattening [=========o=====] 0.75 │ │ │ │ ☑ deadCodeInjection [=====o========] 0.40 │ │ │ │ ☑ debugProtection (反调试) │ │ │ │ ☑ disableConsoleOutput │ │ │ │ ☑ 命名方式: [mangled-shuffled ▼] │ │ │ │ ☑ stringArray 编码: [rc4 ▼] │ │ │ │ ☑ ... （完整 30 项参数可展开调节） │ │ │ └──────────────────────────────────────────────────┘ │ │ │ │ 🚀 快捷操作 │ │ ┌──────────────────────────────────────────────────┐ │ │ │ [📦 打包 Super HTML] [🗜️ 一键压缩图片] │ │ │ │ [🔄 批量修改图片哈希] │ │ │ └──────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────┘ ``` --- ## 📊 安全等级对比 | 对比项 | 裸构建（无保护） | 🟢 轻度混淆 | 🟡 中度混淆 | 🔴 重度混淆 | |--------|:------------:|:---------:|:---------:|:---------:| | 代码可读性 | 完全可读 | 较难读懂 | 极难逆向 | **几乎无法逆向** | | 字符串保护 | 全部明文 | base64 编码 | base64 编码 | **RC4 加密** | | 反调试保护 | ❌ 无 | ⚪ 无 | ✅ 有 | ✅ **强保护** | | 控制流混淆 | ❌ 无 | ⚪ 无 | ⚪ 无 | ✅ **流平坦化** | | 死代码注入 | ❌ 无 | ⚪ 无 | ⚪ 无 | ✅ **40% 注入率** | | 构建耗时增加 | 0 | +1~3s | +3~8s | +8~20s | | 运行时性能影响 | 无 | **几乎无影响** | **较小影响** | 约 5~15% 开销 | --- ## 🌍 平台兼容性 | 平台 | 自动混淆 | AST 深度混淆 | JSON 混淆 | Super HTML | |------|:-------:|:-----------:|:---------:|:----------:| | 🌐 Web 桌面版 | ✅ | ✅ | ✅ | ✅ | | 📱 Web 移动版 | ✅ | ✅ | ✅ | ✅（专为它设计）| | 💬 微信小游戏 | ✅ | ✅ | ✅ | ❌ | | 🎵 字节小游戏 | ✅ | ✅ | ✅ | ❌ | | 💳 支付宝小游戏 | ✅ | ✅ | ✅ | ❌ | | 🐧 QQ 小游戏 | ✅ | ✅ | ✅ | ❌ | | 👍 Facebook Instant | ✅ | ✅ | ✅ | ✅ | | ▶️ Google Playable Ads | ✅ | ✅ | ✅ | ✅ | --- ## 📦 安装说明 ### Cocos Store 一键安装（推荐） 1. 打开 Cocos Creator 2. 菜单栏 → **扩展** → **扩展商店** 3. 搜索 **"CodeShield"** 或 **"代码护盾"** 4. 点击 **安装** 5. 重启 Cocos Creator ### 手动安装 1. 将 `cc-code-shield` 文件夹复制到项目 `extensions/` 目录下 2. 在终端进入插件目录：`cd extensions/cc-code-shield && npm install` 3. 重启 Cocos Creator > ⚡ 安装即用，无需任何额外配置！ --- ## ⌨️ 快捷键 & 菜单 | 操作 | 方式 | |------|------| | 打开/聚焦主面板 | `Alt+S` | | 开启自动混淆 | 菜单 → 扩展 → CodeShield → 开启构建后自动混淆 | | 关闭自动混淆 | 菜单 → 扩展 → CodeShield → 关闭构建后自动混淆 | | 打开主面板 | 菜单 → 扩展 → CodeShield → 打开主面板 | --- ## 💬 用户评价 > *"之前用免费混淆器，每次构建后要手动跑脚本，太痛苦了。CodeShield 装好就再也没管过，每次构建自动保护，省心又安全。"* > — 某中型 H5 游戏团队技术负责人 > *"公司的 H5 游戏之前被人扒代码换皮上线，用了 CodeShield 重度混淆后，再也没出现过。"* > — 某独立游戏开发者 > *"Super HTML 打包功能太实用了，做可玩广告投放再也不用手动处理资源路径了，一个文件搞定。"* > — 某广告创意团队 --- ## ❓ 常见问题 **Q：混淆后会增加包体大小吗？** A：会有少量增加（通常 5~20%），主要来自字符串编码和死代码注入。轻度预设影响极小。 **Q：会影响游戏运行性能吗？** A：中度及以下预设几乎无影响。重度预设中的控制流平坦化可能带来 5~15% 的性能开销，建议仅在关键项目中使用。 **Q：混淆后的代码还能被 SourceMap 还原吗？** A：不会。插件默认不生成 SourceMap，且构建后的 SourceMap 文件不会被发布到线上。 **Q：支持 Cocos Creator 3.x 吗？** A：理论支持 Cocos Creator **3.x** 系列所有版本。 **Q：如果混淆后游戏报错怎么办？** A：建议从轻度预设开始测试，确认无问题后再逐步增加强度。常见问题多为 `selfDefending` 或 `debugProtection` 与第三方 SDK 冲突，可单独关闭对应选项。 **Q：Super HTML 打包后文件太大了怎么办？** A：打包前先使用"一键压缩图片"功能减小图片体积，可以有效控制最终 HTML 文件大小。 --- ## 📝 更新日志 ### v1.0.0 — 正式版 - 🎉 首次发布 - ✅ 构建后自动混淆 + AST 深度混淆双重保护 - ✅ 三档预设（轻度/中度/重度）+ 30 项可调参数 - ✅ 一键图片压缩（jimp 高级 + 基础双引擎） - ✅ 批量修改图片哈希（PNG LSB / JPG COM 段） - ✅ Super HTML 单文件打包（内置 XHR/fetch 拦截器） - ✅ 全平台支持（Web + 小游戏） - ✅ 国际化中英文面板 --- ## 📄 联系作者 - 问题或建议，联系开发者qq: 448063386 。 --- ## 📄 购买须知 - 本产品为付费虚拟商品，一经购买成功概不退款，请支付前谨慎确认购买内容。 ---

Made with ❤️ by CodeShield Team
_{让你的游戏代码坚如磐石 🛡️}