Magic-Script 接口脚本助手

你在解决什么问题

在 Magic-API（magicapi）里写接口时，逻辑往往落在 magic-script（MagicScript）脚本里：语法接近 JavaScript，但跑在 Mozilla Rhino 上，内置 db、http、request 等模块，和浏览器 JS 并不相同。常见卡点包括：ES6 默认参数、new Set() 不可用；集合用 each/size() 而不是 forEach/length；SQL 里 #{} 与 ${} 分工不同；URL/表单/Header/Body/Path 参数各有取法；多数据源、缓存与事务写法也容易踩坑。

技能如何帮你写脚本

本技能把 magic-api / magic-script 当作同一技术栈（名称写法可互换），按「确认场景 → 查阅 references → 编写/排错」组织内容：

• 语法与类型：关键字、运算符、::type 类型转换及默认值、Lambda/异步等
• 内置能力：数据库查询与增删改、分页、单表链式 API、事务与 db.cache；HTTP 调外部接口；Request/Response/Log/Env；Magic 模块调其它接口
• 函数与扩展：聚合、字符串/日期/数组/数学函数，以及 Collection、Object 等扩展方法
• 集成与示例：脚本调 Java、Java 调接口；快速 CRUD、参数获取、LINQ 式写法
• 排错：FAQ 与参数校验文档，脚本执行错误时可对照

适用边界

• 面向 接口脚本 编写与调试，不是 Magic-API 工程部署或 Java 侧框架配置的完整手册
• 动态 SQL 用 ${} 拼接表名/列名时有注入风险，需自行约束
• 语法限制以 SKILL 内「注意事项」为准（例如循环用 for (value in list)，归约可用 Collection 的 reduce）