修复描述性错误,完善测试

This commit is contained in:
2026-03-21 22:53:03 +08:00
parent 8998ad6900
commit 8e9deb2865
34 changed files with 202 additions and 95 deletions

View File

@ -1,12 +1,14 @@
# Lua Runner for Cangjie
[![License](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](LICENSE)
[![License](https://img.shields.io/badge/License-LGPL%20v3-blue.svg)](LICENSE)
[![Lua](https://img.shields.io/badge/Lua-5.4-blue)](https://www.lua.org/)
[![Cangjie](https://img.shields.io/badge/Cangjie-SDK-orange)](https://cangjie-lang.cn/)
Lua Runner for Cangjie 是一个专为仓颉语言设计的轻量级、高性能 Lua 脚本执行引擎。它通过 C FFI 桥接 C++,提供了稳定且易用的 Lua 虚拟机管理能力。
**注:本项目是开发原生鸿蒙应用时产生的副产物,当前版本依然存在局限性与不足,请详细检查后再使用。**
安全与发布说明:仓库中不应提交任何中心仓访问令牌、私有凭据或其他敏感配置。发布前请使用本地环境变量、用户级配置或 CI 密钥注入方式提供认证信息,并检查待上传制品中不包含明文凭据。
除了基础的脚本嵌入功能外,该引擎的核心特色在于支持一种独特的 **“栈式管道执行模式”**,能够实现脚本间的隐式参数传递,非常适合构建数据处理管道、游戏脚本系统或插件化架构。同时,它提供了完善的异常处理机制和灵活的 I/O 重定向功能。
## 特性
@ -180,7 +182,12 @@ println(finalResult) // 最终输出: [PREFIX] HELLO [SUFFIX]
- **容量限制**:内部使用固定数组管理加载的库,上限为 **20 个**,超过将报错 `5016`。
- **I/O 性能**I/O 重定向依赖于文件系统交换,相对于纯内存交互存在微小的性能开销。
## 第三方组件与合规说明
- 本项目仓库内包含 Lua 5.4.8 源码副本,用于构建底层原生运行时。
- Lua 5.4.8 使用 MIT License其原始版权与许可声明可在 `lib/lua/` 对应源码中查看。
- 本项目自身以 `LGPL-3.0-or-later` 方式发布,使用或分发时请同时遵守项目本身以及所包含第三方组件的许可证要求。
## 许可证
本项目基于 GPLv3 协议开源。这意味着您可以自由地使用、修改和分发本软件,但任何衍生作品也必须以相同的 GPLv3 协议开源。详情请参阅 [LICENSE](LICENSE) 文件
本项目基于 LGPL-3.0-or-later 协议开源。仓库同时包含 Lua 5.4.8 的 MIT Licensed 源码副本,用于构建底层原生运行时。分发和集成时,请一并检查 [LICENSE](LICENSE) 以及 `lib/lua/` 中随源码附带的许可声明。