用途：在 Pireel Studio 中创建与重写覆盖在视频上的图形块（指标卡、图表、示意图、标注、标题等），采用 BYO（自带模型）方式，消耗你 agent 的订阅额度而非用户的 Pireel 积分。使用 Pireel 自带 LLM 的 add_block、edit_block、add_graphics 会扣账户积分，仅在 BYO 流程反复失败时才回退使用。
流程固定为三步：compose_block_brief → 自己生成 block → apply_block。
第一步 compose_block_brief 返回完整生成契约 {system, prompt}，内容按合成实时组装（主题 token、画面设计语言、盒子尺寸、屏幕节奏、相邻元素名单）。三种定位方式：填充占位符时传 blockId（来自 get_state），其设计规格即指令，省略 instruction；重写已有块时传 blockId 加 instruction，如需保留原有细节先调 get_block；新建元素只传 instruction，可用 atSec 指定时间线起点（默认播放头）。只给 blockId 或只给 instruction 都没有时会报错（instruction required）。
第二步：严格照契约生成，原样采用返回的 system 与 prompt，输出为一段简短说明、一个 html 围栏（块标记与作用域样式）、一个 js 围栏（确定性动画时间线）。遵守契约中的尺寸、token、允许的 CSS、动画约束。契约会引用 MCP 服务器上的 get_icons 工具，用 get_icons {names} 取内联 SVG 图标（最多 8 个小写 kebab-case 名称，品牌图标用 kind:"brand"），不要手绘语义图标，画布上不要用 emoji。若附加了 frame（主题内容包），其设计语言已写入 brief；自行规划块前先读 read_frame {frame_id}（id 由 list_frames 获取，用 attach_frame 附加），把其母题、比例、语气带入 instruction，但不要照搬 playbook 中的绝对 px 值。
第三步 apply_block：传入与 brief 相同的 blockId / atSec，raw 填完整生成文本（说明 + html + js，围栏会被解析）。占位符 blockId 则填充；已有 blockId 则覆盖；两者都没有则插入新元素，可选 durationSec（默认 3 秒）与 label。
lint 循环：apply_block 会校验（作用域 CSS、无脚本、确定性动画），失败时返回 lint 问题。只修复这些问题后重试，不要重头再生成、不要改动无关部分、不要改说明。同一失败重复 2–3 次后可回退到扣积分的 add_block/edit_block。
落地后：回执确认位置与块 id，调 focus_element 让用户看到结果；再用 capture_frame {atSec} 实际查看渲染画面（位置、与说话人重叠、对比度、尺寸），有问题再走一轮 brief → 生成 → apply。时间与位置调整不算重新生成，用 move_block / resize_block、delete_block、duplicate_block。批量填充占位符时逐个循环，先 apply 再取下一个 brief。capture_frame 需要工作室标签页处于打开状态。