script_engine/README.md

script_engine 脚本引擎模块（W-06）

脚本引擎：脚本表 CRUD + execute_script / validate_script 接口。独立模块，无业务依赖。

功能

• script 表 CRUD：新增 / 编辑 / 删除 / 详情 / 分页列表
• execute_script：按脚本 id 取库内脚本（或直传 content），校验通过后执行
• validate_script：校验脚本内容（语法 + 受限语法 + 调用白名单），不落库不执行
• 编码字典：script_type（0=Python / 1=JavaScript / 2=规则表达式）、script_status（0=停用 / 1=启用）经 init/data.json（Format B appcodes）幂等落库

数据表

• script：id / script_name / script_type / content / description / status / created_at / updated_at
• 索引：idx_script_name、idx_script_type

接口约定

• REST 统一前缀：/script_engine/api/*.dspy
• 错误结构：{code, message, field, detail}（code=0 成功，400 参数错误，404 不存在，500 内部错误，501 类型暂不支持）
• 分页：{list, total}
• 非法输入 100% 拦截，不落库、不执行

集成

1. pip install .
2. 宿主应用 from script_engine.init import load_script_engine → init() 内调用 load_script_engine()
3. scripts/load_path.py 登记 RBAC 路径；宿主 load_path.py 兜底
4. build.sh 四步：安装 xls2ddl → 生成 DDL → 生成 CRUD UI → 链接 wwwroot

接口清单（wwwroot/api/）

路径	说明
/script_engine/api/script_create.dspy	新增脚本
/script_engine/api/script_update.dspy	编辑脚本
/script_engine/api/script_delete.dspy	删除脚本
/script_engine/api/script_get.dspy	脚本详情
/script_engine/api/script_list.dspy	分页列表（{list,total}）
/script_engine/api/script_execute.dspy	执行脚本
/script_engine/api/script_validate.dspy	校验脚本