script_engine/skill/SKILL.md

name	description
script_engine	逻辑编程（脚本/规则引擎）模块——脚本表 CRUD + execute_script/validate_script 接口，通过 load_script_engine() 挂载。

script_engine 模块

概述

逻辑编程（脚本/规则引擎）模块。管理 script_engine 表（脚本/规则），提供脚本执行与语法校验接口。依赖 world、scene、entity 模块。

数据模型

表 script_engine：id、world_id(→world)、scene_id(→scene)、entity_id(→entity)、name、code(unique)、script_type、trigger_event、content(text)、status、created_at、updated_at。

关键接口

• api/execute_script.dspy：输入 script_id / context_json（可选），按 script_type 选择执行器执行 content，返回 {success, result}。
• api/validate_script.dspy：输入 content / script_type，语法/格式校验，返回 {valid, message}。

脚本类型编码（appcodes script_type）

• 0 = Python脚本（受限命名空间，通过 result 变量返回结果）
• 1 = 规则(JSON)（解析 JSON 作为结果）
• 2 = 表达式（eval 求值）

状态编码（appcodes script_status）

• 0 = 禁用、1 = 启用

挂载

宿主应用入口 init() 调用 load_script_engine()，向 ServerEnv 注册 execute_script / validate_script / create_script / update_script / delete_script。

陷阱

• 脚本执行使用受限命名空间（__builtins__={}），Python 脚本须通过 result 变量返回结果。
• content 为 text 字段：列表页隐藏（browserfields.exclouded），编辑页显示。
• code 唯一索引，create 时校验重复。
• 取库名统一 ServerEnv().get_module_dbname('script_engine')，禁止硬编码 DBNAME。