stage-dsl

stage-dsl 是 OpenMAIC 舞台文档的读取与编辑地图，本身不是字段手册，用于判断某个值属于哪棵子树、读取哪条路径、加载哪章参考，写作前需先读精确源码。文档模型为 stage 包含 outline 与按 order 排序的 scenes[]；每个 scene 有 id、order、type（slide、quiz、interactive、pbl）、按 type 决定的 content 与有序的 actions[]，type 与 content.type 必须一致。通用工具不替代页面列表操作：插入、删除、重排、改标题用 edit_deck；读取场景用 read_stage；编辑内容或动作用 patch_stage；搜索可见文本或源码用 grep_stage；列目录舞台用 list_folder_stages。read_stage 路径支持省略、/outline、/scenes/3、/scenes/scene_abc 等，order 从 1 起，JSON 内数组索引从 0 起；detail 可选 tree、source、text，source 与 text 超过 12000 字符会分页。patch_stage 的 target 是单个场景路径，每次调用携带意图与一个或多个原子操作（set、remove、str_replace、add_element、delete_element），路径以 /content/ 或 /actions/ 为根的 JSON Pointer，/ 转义为 ~1、~ 转义为 ~0。改动大型 HTML 或长文本优先用 str_replace 配合短唯一锚点。grep_stage 按 text 或 source 作用域，字面、不区分大小写并做 NFKC 归一化，每场景最多 10 条、整体最多 30 条，truncated 时返回游标。硬性规则：每次 patch 前读 source、后读回验证；只改最小叶子；不用 tree 构造 patch；不写入媒体省略占位符；页面插入删除重排标题不用 patch_stage。校验边界：幻灯片为封闭 schema，quiz 有封闭检查，interactive 与 PBL 在 content 根封闭但历史扩展字段被容忍；通过校验不代表教学或渲染正确。具体字段参考需加载已安装的 slide-dsl 技能及 quiz.md、widget.md、actions.md、pbl.md。