docs: enhance README with comprehensive documentation

[esrrhs]

📝 Changes

新增内容

• 改进项目描述：更详细说明编译流程和功能

• 核心特性分类：分为编译执行、互操作性、代码生成三个部分

  • 编译与执行：JIT 后端、类型推导、数值专特化
  • 互操作性：API、Table 映射、代码导出
  • 代码生成：语法支持、类型驱动优化、作用域管理

• 详细限制说明：分为三类

  • 语法限制（多返回值、varargs、label/goto 等）
  • 初始化约束（全局变量、本地变量初始化）
  • 类型系统限制

• 完整系统要求：明确 C++23 编译器版本要求

• 详细测试文档：包括 Lua 开发包安装指令

• 增强的工具文档：flua 命令行选项详解和使用示例

• 完整 C++ API 文档：

  • 基本使用示例
  • 状态管理 RAII 风格
  • API 概览表
  • 类型转换示例
  • Table 互转实现

• 架构设计文档：

  • 编译流程图
  • 关键组件说明
  • 类型系统详解
  • 项目结构树

• 常见问题 FAQ：5 个重要问题的解答

📊 统计

• 原始：108 行
• 更新后：335 行（+227 行）
• 提升覆盖完整性：从基础介绍到架构设计全覆盖

README 现在是专业的、结构清晰、信息完整的项目文档。

[esrrhs]

@copilot resolve the merge conflicts in this pull request

[esrrhs]

✅ 冲突已解决

已将 master 分支最新的 README 改进（性能基准表、Windows badge 等）与本分支的详细文档合并。

合并后的 README 包含：

• ✅ master 的完整技术亮点说明（JIT 后端、Numeric Specialization、CVar、VarInterface）
• ✅ master 的性能基准数据和对比表
• ✅ master 的 Linux/macOS/Windows 平台 badge
• ✅ 详细的功能分类和完整的限制说明
• ✅ 完整的测试、构建、API 文档
• ✅ 架构概览和 FAQ

总计 306 行的专业完整文档。

[esrrhs]

📋 README 更新完成总结

✅ 已解决的冲突：master 分支在我们工作期间有了新的 README 改进。我们已将两者合并。

最终 README 包含内容

来自 master 分支的内容

✅ 完整的技术亮点说明：双 JIT 后端、Numeric Specialization、CVar、VarInterface
✅ 性能基准测试数据对比表
✅ Linux/macOS/Windows 平台 CI badge
✅ 快速上手示例代码

新增的详细文档内容

✅ 自动类型推导功能说明
✅ C++ 嵌入 API 完整说明
✅ 分类的限制说明（语法、初始化、类型系统）
✅ 详细的系统要求
✅ 完整的测试和 Lua 依赖安装指南
✅ 完整的 C++ API 参考（状态管理、类型转换、Table 映射）
✅ 架构概览（编译流程、关键组件、类型系统）
✅ 项目结构树
✅ 常见问题 FAQ（5 个问题）

统计数据

• 总行数：306 行（比原 master 版本多 200+ 行详细文档）
• 更新提交：3 个
  • 497edc6：初始 README 增强
  • 4881ec0：合并 master 改进
  • c840f9e：冲突解决

README 现已是专业的、结构完整、信息丰富的项目文档。

[Copilot]

@copilot resolve the merge conflicts in this pull request

Resolved in c840f9e. The README conflict is merged by keeping the expanded documentation from this PR and folding in the newer upstream README details from master.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• dl.google.com
  • Triggering command: /usr/lib/apt/methods/https /usr/lib/apt/methods/https -I /usr/include/lua5.4 -I /usr/local/include/lua5.4 --gdwarf-5 --64 -o CMakeFiles/unit_tests.dir/test_syntax_tree.cpp.o /tmp/ccQwgsRa.s 1 lua/test/../src --he�� a/build/_deps/gf/tmp/cciiCAAW.s (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.53%. Comparing base (e60f854) to head (c840f9e).
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #117   +/-   ##
=======================================
  Coverage   97.53%   97.53%           
=======================================
  Files          64       64           
  Lines       12193    12193           
=======================================
  Hits        11893    11893           
  Misses        300      300           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.