微信小游戏 wasm 水印插件：Unity WebGL 转换小游戏的代码溯源防护指南

• 游戏开发
• 移动开发
• WebAssembly

在微信小游戏生态中，Unity 游戏通过 WebAssembly 转换为小游戏后，主逻辑代码会集中在一个 wasm 文件中，成为被恶意扒包、抄袭的重灾区。本文以本仓库适配方案中的 wasmWaterMark.md 为核心，系统讲解 wasm 水印机制的设计目的、与代码分包的协作顺序、插件的安装与使用全流程，以及上线前后的注意事项，帮助开发者用最小成本为自己的 wasm 小游戏加上可被平台识别的"数字指纹"。

wasm 水印机制的背景与作用

Unity 引擎导出的小游戏项目，其核心游戏代码经过编译后会集中存放在一个 wasm 文件中，经 brotli 压缩后置于wasmcode目录下（详见代码分包文档对 wasm 包结构的说明）。由于 wasm 是面向浏览器的可执行二进制，天然可以被抓取、反编译和二次分发，传统小游戏代码面临着被恶意人员"扒包抄袭"的风险。

微信小游戏平台本身已具备代码相似度检测能力，能够发现高度雷同的代码包。在此基础上，本方案引入了wasm 水印机制，作为相似度检测之外的又一道溯源防线：

• 事前威慑：为 wasm 代码植入平台可识别的水印信息，让抄袭者难以在发布后洗清代码来源；
• 事后溯源：一旦发生恶意扒包抄袭，平台可依据 wasm 中留存的水印准确检测出游戏的原作者，并对恶意抄袭人员进行处罚。

水印机制的核心价值在于：它解决的不是"代码能不能被拿走"的问题，而是"代码被拿走之后，如何证明原创归属"的问题。对于长期运营、高价值投入的 Unity 小游戏，这是一项低成本的版权保护基建。

注意：wasm 水印插件仅适用于 Unity 转化的小游戏项目，其目标是给 wasm 小游戏添加水印、防止代码被恶意抄袭。插件详细说明可见本仓库 README.md 所描述的"微信小游戏Unity/团结引擎适配方案"整体架构。

与代码分包插件的协作：先分包，再打水印

如果你的项目同时使用了代码分包插件（wasmCodeSplit，详见代码分包），必须严格遵循以下协作顺序：

先使用分包插件对 wasm 代码进行分包，再使用水印插件对分包后的 wasm 代码打水印。

原因很直观：代码分包（Profile Guided Optimization）会按函数粒度将原始 wasm 拆分为启动加载的主包与延迟加载的子包，分包过程会改写、重组 wasm 的二进制结构。如果先打水印再分包，分包处理很可能会破坏水印标记，或者导致最终发布的 wasm 文件中并不包含水印。只有等分包完成后、针对最终实际发布形态的 wasm 文件打水印，水印才能随正式包分发并被平台识别。

对于采用 iOS 高性能模式、Android 与 iOS 普通模式等不同 runtime 的组合场景，这一先后顺序同样适用。

环境要求：微信开发者工具版本

wasm 水印插件以**微信开发者工具扩展（编辑器扩展）**的形式提供，依赖工具版本如下：

插件详情页中标注的适用工具版本为1.05.2106010 以上。

与代码分包插件类似，请务必使用stable 版本的微信开发者工具。小游戏版（Minigame Build）开发者工具存在插件无法正常更新或安装的问题（参见代码分包中的相关说明）。部分界面截图可能与最新工具略有出入，建议升级工具至最新版本后再操作。

安装水印插件

安装流程在微信开发者工具的「设置 → 拓展设置」中完成：

1. 打开微信开发者工具，进入设置菜单，切换到拓展分类；
2. 在左侧导航中选择编辑器扩展，在右侧插件列表中找到水印工具（wasm-watermark）；
3. 点击进入插件详情页，点击「获取」按钮添加插件。

插件安装完成后，需重启开发者工具以确保插件正常运行。

添加成功后，在项目目录树的上方工具栏中即可看到水印工具的水滴样式 icon，点击即可唤起水印插件面板。

使用水印插件打水印

首次使用与默认状态

项目首次使用插件时，默认会启用打水印功能。插件会扫描并检测当前小游戏项目中的 wasm 文件，以列表形式展示出来；开发者自行决定哪些 wasm 文件需要上传并打水印。

水印插件检测的正是 Unity 导出后位于wasmcode目录下的 wasm 代码文件——即代码分包所处理的同一批文件。若项目已按上文顺序先完成代码分包，这里检测到的即为分包后的主包/子包 wasm。

上传打水印的完整流程

在插件面板中选择需要打水印的 wasm 文件后，点击上传按钮，插件会自动执行完整逻辑，界面状态依次流转：

1. 正在打水印：插件将选中的 wasm 文件上传到平台侧，执行水印嵌入逻辑；
2. 下载中：水印嵌入完成后，插件将带水印的 wasm 文件下载回本地项目，覆盖原文件；
3. 已完成：打水印流程结束，wasm 文件已包含可被平台识别的水印信息。

完成打水印后，请立即在开发者工具中测试小游戏是否正常运行。由于水印嵌入涉及对 wasm 二进制的改写，个别情况下可能引入运行异常：

• 若测试出现异常，可在插件面板点击还原 wasm 文件到初始状态，再重新打水印；
• 若项目存在两个及以上 wasm 文件（例如代码分包后的主包与子包），操作流程同理：逐个选择、逐个上传打水印即可。

关闭水印与回退

如果出于调试或其他原因不希望保留水印，可点击插件面板中的关闭水印按钮，wasm 代码将回到未打水印的初始状态，与"还原"功能效果一致。后续如需上线，请记得重新执行打水印流程。

注意事项与常见问题

打水印过程可能耗时

打水印与下载过程涉及文件上传、服务端处理和结果回传，可能会有一定耗时，请耐心等待，不要在状态流转期间中断操作或关闭工具。耗时长短通常与 wasm 文件大小、网络状况相关——而 Unity 小游戏的 wasm 一般在 30M 左右（压缩后约 6M），属于正常耗时范围。

AppID 校验

若当前项目的 AppID 为测试号，或者本身是小程序 AppID（而非小游戏 AppID），插件面板会出现invalid-appid 之类的无效提示界面。此时需要：

1. 在project.config.json或开发者工具中将 AppID 更换为正确的小游戏 AppID；
2. 重新打开插件面板触发重新检测。

与代码分包联动的上线建议

若项目同时启用代码分包与水印，建议遵循代码分包文档（Design/WasmSplit.md）中的上线检查项，在发布前确认：

• 生成的是release 版分包，且首包函数个数达到原始包函数总数的 30% 以上；
• 新增收集函数个数清零，子包无过早加载日志（wait for func）、iOS 高性能模式无fetch js相关异常日志；
• 确认最终发布的 wasm 均已打水印，避免出现"分包已发布、水印遗漏"的窗口期。

总结

wasm 水印插件为 Unity 转微信小游戏提供了一道独立于代码相似度检测的代码溯源防线。其使用要点可归纳为：

• 协作顺序：与代码分包并用时，先分包、后打水印；
• 工具版本：使用 stable 版微信开发者工具（1.05.2105100 及以上），避免小游戏版工具；
• 操作闭环：添加插件 → 工具栏唤起面板 → 选择 wasm 上传打水印 → 真机/工具内验证 → 异常则还原重打；
• 合规前提：使用正确的小游戏 AppID，测试号与小程序 AppID 无法通过检测；
• 过程耐心：上传打水印、下载回写均有一定耗时，属正常现象。

将水印机制纳入上线流程后，即便代码包被恶意搬运，平台也能借助水印准确还原作者信息，从而对抄袭行为形成有效约束，为开发者的原创代码加上一层"保险"。

• 游戏开发
• 移动开发
• WebAssembly