添加代码水印相关文档

Author: pirunxi

docs/intro.md

@@ -32,6 +32,7 @@ Obfuz 是一款开源、强大、易用及稳定可靠的充分满足商业化
 - **静态与动态解密**：结合静态和动态解密，防止离线静态分析。
 - **混淆多态化**：通过配置不同的生成密钥和随机化种子，生成不同的混淆代码。
 - **垃圾代码生成**：支持多种垃圾代码生成，提高App Store和Google Play审核通过率。
+- **代码水印**：嵌入可追踪的水印。
 - **深度 Unity 集成**：与 Unity 工作流无缝衔接，简单配置即可使用。
 - **热更新支持**：全面兼容 HybridCLR、xLua 等热更新框架，确保动态代码更新顺畅。
 - **兼容DOTS**：兼容DOTS各个版本，无需配置即可正常工作。
@@ -53,7 +54,6 @@ Obfuz 是一款开源、强大、易用及稳定可靠的充分满足商业化
 
 Obfuz 正在持续开发中，即将推出的功能包括：
 
-- **代码水印**：嵌入可追踪的水印。
 - **反内存转储与反调试**：防止内存转储和调试行为。
 - **代码虚拟化**：将代码转化为虚拟化指令，提供最高级别安全。
 

docs/manual/configuration.md

@@ -175,6 +175,15 @@ Obfuz提供了极其丰富的配置选项和灵活的混淆规则配置文件，
 |Min Instruction Count Of Basic Block To Obfuscated|被混淆的[基本块](https://en.wikipedia.org/wiki/Basic_block)的最小指令数|
 |Rule Files| 加密规则文件列表。可以为0到多个。如果为空会对所有常量进行混淆。详细配置规则见[函数调用混淆](./call-obfuscation)。|
 
+### Watermark Settings
+
+代码水印相关设置。补充文档见[代码水印](./watermark)。
+
+|选项|描述|
+|-|-|
+|Text|代码中嵌入的水印文本|
+|Signature Length|嵌入的水印文本的Hash签名长度|
+
 ### PolyMorphic Dll Settings
 
 多态dll相关设置。 补充文档见[多态dll文件](./hybridclr/polymorphic-dll)。

docs/manual/obfuscation-pass.md

@@ -30,10 +30,10 @@ Obfuz的混淆（或加密）流程的执行方式为先判定对目标是否启
 - Control Flow Obfusaction （控制流混淆）
 - CleanUp Pass。没有任何混淆操作，只执行一些清理操作（如优化冗余代码等）。
 - RemoveObfuzAttributesPass。 最后一个Pass，移除最终的代码中用不到的`[ObfuzIgnore]`特性。
+- Watermark Pass （添加水印）
 
 后续将会支持的Obfuscation Pass有：
 
-- 加水印
 - Anti-Debugger、Anti-Damper、Anti-Dumping
 
 ## 设置

docs/manual/watermark.md

@@ -0,0 +1,21 @@
+# 代码水印
+
+Obfuz往混淆后的程序集元数据中注入特殊的元数据及特定指令序列，形成可标识的水印特征。
+
+## 代码水印的目标
+
+- 版权标识：证明该代码是由你生成或授权发布的。
+- 溯源追踪：用于标记不同用户或不同授权方生成的代码，若泄露可追查来源。
+- 抗混淆还原：即使代码经过再次混淆或部分还原，水印仍可在某种程度上保留。
+
+## 设置
+
+`ObfuzSettings.WatermarkSettings`中包含相关设置，详细见文档[设置](./configuration)。
+
+## 水印标识类别
+
+注入以下特殊水印标识：
+
+- rva数据中注入水印Hash签名
+- 生成特殊规则的类型及函数及字段
+- 代码体中注入特定指令序列

sidebars.ts

@@ -65,6 +65,7 @@ const sidebars: SidebarsConfig = {
         'manual/expr-obfuscation',
         'manual/call-obfuscation',
         'manual/control-flow-obfuscation',
+        'manual/watermark',
         'manual/garbage-code-generation',
         'manual/build-pipeline',
         'manual/run-obfuscation-standalonely',