更新文档

Author: pirunxi

docs/architecture/call-path-overview.md

@@ -67,7 +67,7 @@ sequenceDiagram
 | C#→Lua | DelegateBridge / DoString | `[LuaInvoke]` |
 | Player | 生成 Wrap 或 IL | C++ 直桥（设计目标） |
 
-详见 [与 xLua 对比](../concepts/comparison-with-xlua)。
+详见 [ZLua 与 xLua 技术架构对比](../concepts/comparison-with-xlua)。
 
 ## 相关文档
 

docs/community/faq.md

@@ -12,7 +12,7 @@ description: ZLua 常见问题与解答（25+ 条）。
 
 ### ZLua 与 xLua 有什么区别？
 
-ZLua 在 Il2Cpp 内嵌 Lua、C++ 直桥，不生成 C# Wrap。类型访问用 `CSharp` 根表，C# 调 Lua 用 `[LuaInvoke]`。选型理由见 **[为什么选择 ZLua](../concepts/why-zlua)**；架构与理论性能见 [与 xLua 对比](../concepts/comparison-with-xlua)；迁移见 [迁移对照草稿](./migration-from-xlua)。
+ZLua 在 Il2Cpp 内嵌 Lua、C++ 直桥，不生成 C# Wrap。类型访问用 `CSharp` 根表，C# 调 Lua 用 `[LuaInvoke]`。选型理由见 **[为什么选择 ZLua](../concepts/why-zlua)**；架构与理论性能见 [ZLua 与 xLua 技术架构对比](../concepts/comparison-with-xlua)；迁移见 [迁移对照草稿](./migration-from-xlua)。
 
 ### Mono 和 Il2Cpp 差别有多大？
 

docs/community/migration-from-xlua.md

@@ -7,7 +7,7 @@ description: 从 xLua / tolua 迁移到 ZLua 的对照草稿（v2.0 完整版规
 # 从 xLua 迁移
 
 :::info 对照草稿
-本文为 **迁移对照草稿**，便于评估与试点迁移；完整迁移指南、工具与案例计划在 **v2.0**。架构差异见 [与 xLua 对比](../concepts/comparison-with-xlua)。
+本文为 **迁移对照草稿**，便于评估与试点迁移；完整迁移指南、工具与案例计划在 **v2.0**。架构差异见 [ZLua 与 xLua 技术架构对比](../concepts/comparison-with-xlua)。
 :::
 
 ## 何时考虑迁移
@@ -128,7 +128,7 @@ obj:Subscribe(function(x) print(x) end)   -- 隐式 marshal，见回调指南
 
 ## 建议迁移步骤（草稿）
 
-1. **并行评估** — 只读 [与 xLua 对比](../concepts/comparison-with-xlua)，确认 Il2Cpp 路线与 MVP 边界
+1. **并行评估** — 只读 [ZLua 与 xLua 技术架构对比](../concepts/comparison-with-xlua)，确认 Il2Cpp 路线与 MVP 边界
 2. **搭骨架** — clone zlua-demo，替换 `Demo.cs` / `app.lua` 为最小业务
 3. **迁 Lua 层** — `CS.` → `CSharp.{asm}.`；namespace 改括号访问
 4. **迁 C# 调 Lua** — `GetFunction` / `DoString` → `[LuaInvoke]`
@@ -152,7 +152,7 @@ obj:Subscribe(function(x) print(x) end)   -- 隐式 marshal，见回调指南
 
 ## 相关文档
 
-- [与 xLua 对比](../concepts/comparison-with-xlua)
+- [ZLua 与 xLua 技术架构对比](../concepts/comparison-with-xlua)
 - [路线图](./roadmap) — v2.0 完整迁移指南
 - [快速开始](../getting-started/quick-start)
 - [排错指南](../guides/troubleshooting)

docs/concepts/comparison-with-xlua.md

@@ -2,15 +2,15 @@
 mdx:
   format: md
 sidebar_position: 6
-title: 与 xLua 对比
-description: 架构、调用路径与理论开销对比，供技术选型参考。
+title: ZLua 与 xLua 技术架构对比
+description: 与 xLua 的架构、调用路径与理论开销推演，供性能评审参考。
 ---
 
-# ZLua 与 xLua 对比分析
+# ZLua 与 xLua 技术架构对比
 
 本文档从 **架构、调用路径、理论开销** 三方面对比 ZLua 与 xLua（Tencent，Unity Il2Cpp 常用方案）。用于技术选型与设计评审。
 
-**选型理由（用法、GC、Wrapper 等）** 请先读 [为什么选择 ZLua](./why-zlua)；本文侧重 **路径级性能推演**。
+**选型理由（用法、GC、Wrapper 等）** 请先读 [为什么选择 ZLua](./why-zlua)；**基于 xLua Examples 的用法逐项对照与详证** 见 [ZLua 与 xLua 全面对比报告](./xlua-comparison-report)。本文侧重 **路径级性能推演**。
 
 **说明：**
 

docs/concepts/design-overview.md

@@ -85,7 +85,7 @@ flowchart TB
 | C#→Lua | `LuaEnv.DoString` / DelegateBridge | `[LuaInvoke]` 声明式 |
 | Player 性能 | Wrap 或生成 C++（视配置） | 设计目标：C++ 直桥 + 签名复用 |
 
-详见 [与 xLua 对比](./comparison-with-xlua)、[调用路径概览](../architecture/call-path-overview)。
+详见 [ZLua 与 xLua 技术架构对比](./comparison-with-xlua)、[调用路径概览](../architecture/call-path-overview)。
 
 ## 何时读哪份文档
 

docs/concepts/why-zlua.md

@@ -28,7 +28,7 @@ xLua、tolua 已是 Unity Lua 绑定的成熟选择。ZLua 不是「多一个绑
 
 :::info 读前须知
 - 上表 **Player** 列以 [项目状态](../getting-started/project-status) 为准；性能/GC 的 **设计目标** 不等于 **当前 MVP 实测**。
-- 路径级性能倍数为 **理论推演**，尚无官方 benchmark → [与 xLua 对比](./comparison-with-xlua)。
+- 路径级性能倍数为 **理论推演**，尚无官方 benchmark → [ZLua 与 xLua 技术架构对比](./comparison-with-xlua)。
 - Il2Cpp 完整版预计 **2026 年 8 月** → [路线图](../community/roadmap)。
 :::
 
@@ -50,7 +50,7 @@ flowchart TD
 |--------|------|
 | **新项目、性能敏感、愿跟路线图** | 读本页 → [5 分钟快速开始](../getting-started/quick-start) → [zlua-demo](https://github.com/focus-creative-games/zlua-demo) |
 | **已有 xLua/tolua 存量、近期上线** | 先看 [不适合](#不适合选-zlua) 与 [迁移草稿](../community/migration-from-xlua) |
-| **架构 / 性能 reviewer** | 本页 + [与 xLua 对比](./comparison-with-xlua) + [Il2Cpp 架构](../architecture/il2cpp-architecture) |
+| **架构 / 性能 reviewer** | 本页 + [ZLua 与 xLua 技术架构对比](./comparison-with-xlua) + [Il2Cpp 架构](../architecture/il2cpp-architecture) |
 | **只关心 API 能不能用** | [兼容性矩阵](../getting-started/compatibility) + Mono Editor 开发 |
 
 ---
@@ -175,7 +175,7 @@ flowchart LR
 | 读 `int` 字段 | 常经 Wrap | **offset 直读**（规范） |
 | 桥接体积 | 每类型大量 Wrap | **按签名复用** MethodBridge |
 
-**为何有机会快数倍（热路径、理论值）：** 消灭 libxlua 往返与 C# Wrap 层；具体场景倍数见 [与 xLua 对比 §4](./comparison-with-xlua#4-分场景理论估计)（**非实测**）。
+**为何有机会快数倍（热路径、理论值）：** 消灭 libxlua 往返与 C# Wrap 层；具体场景倍数见 [ZLua 与 xLua 技术架构对比 §4](./comparison-with-xlua#4-分场景理论估计)（**非实测**）。
 
 ### 今天能用吗
 
@@ -293,7 +293,7 @@ tolua 依赖 **导出的 binding 代码**；xLua 依赖 **Generate + LuaCallCSha
 
 1. **5 分钟上手** — [快速开始](../getting-started/quick-start) + [zlua-demo](https://github.com/focus-creative-games/zlua-demo)  
 2. **确认 Player 边界** — [项目状态](../getting-started/project-status) · [兼容性](../getting-started/compatibility)  
-3. **深度对比** — [与 xLua 对比](./comparison-with-xlua)（路径与理论性能）  
+3. **深度对比** — [ZLua 与 xLua 技术架构对比](./comparison-with-xlua)（路径与理论性能）· [ZLua 与 xLua 全面对比报告](./xlua-comparison-report)（Examples 用法对照）  
 4. **已有 xLua** — [迁移对照草稿](../community/migration-from-xlua)
 
 ---
@@ -302,7 +302,8 @@ tolua 依赖 **导出的 binding 代码**；xLua 依赖 **Generate + LuaCallCSha
 
 | 文档 | 内容 |
 |------|------|
-| [与 xLua 对比](./comparison-with-xlua) | 调用栈、ns 量级推演 |
+| [ZLua 与 xLua 技术架构对比](./comparison-with-xlua) | 调用栈、ns 量级推演 |
+| [ZLua 与 xLua 全面对比报告](./xlua-comparison-report) | Examples 详证 + 用法逐项对照 |
 | [设计概览](./design-overview) | L/Invoke 与自动生成流水线 |
 | [Il2Cpp 架构](../architecture/il2cpp-architecture) | Player C++ 实现 |
 | [Struct 编组](../spec/marshal/struct) | GC 路径完整规范 |