LuaCangjia_api/doc/ADAPTATION-lua25.md

Lua 2.5 分支移植评估（ADAPTATION.md）

本分支已 vendor Lua 2.5 官方源码到 lib/lua/（src/ + include/）。 桥接层尚未适配，且不建议移植。

结论：不建议移植

Lua 2.5（1996）与 Lua 3.2 同属"前 lua_State 时代"，且比 3.2 更原始：

1. 全局单例状态机 —— lua_open(void) 无参数无句柄，与本项目多 runner 实例抽象根本冲突
2. fallback 机制而非 metatable —— 面向对象模型完全不同
3. 无独立编译 —— lua_dofile(char*) 一步式，管道模式的块压栈不可实现
4. upvalue 语义缺失 —— 闭包模型尚未引入（3.1 才有 upvalue）
5. 1996 年代码，现代编译器需多处修正才能通过（K&R C 残留）

若确需支持历史脚本，建议直接用 Lua 5.1 的兼容模式跑（语法子集大部分兼容）， 或参考 lua_3.2 分支的评估做极简 doString-only 桥接。

本分支仅作为源码存档。