本模块用于 Unity UGUI / Canvas 工作流，与 UI Toolkit 分离。若需处理 UXML/USS/UIDocument，应使用 uitoolkit；若需将 Canvas 转换为 XR 兼容的世界空间画布，应使用 xr_setup_ui_canvas。
适用用途 用于搭建 UGUI 界面、添加 Canvas 元素以及排布 UI 布局。常见触发场景包括构建 UGUI 屏幕、添加 Canvas 元素、安排 UI 布局。
运行模式 Approval 模式下，查询类技能（ui_find_all，源码标 SkillMode.SemiAuto）直接执行；其余创建/修改类技能（ui_create_* / ui_set_* / ui_add_* / ui_layout_children / ui_align_selected 等，标 SkillMode.FullAuto）需用户 grant，grant 后服务端一步执行并返回结果。Auto / Bypass 模式下所有技能直接执行；Auto 走 AI 自我评估，Bypass 全放行。本模块不含 Delete / PlayMode / Reload / 高危技能，无 Bypass-only 拦截项。删除 UI 节点请走 gameobject 模块。
主要能力 创建类技能：ui_create_canvas（创建 Canvas，默认 ScreenSpaceOverlay，参数 name?、renderMode?）、ui_create_panel、ui_create_button、ui_create_text、ui_create_image、ui_create_inputfield、ui_create_slider、ui_create_toggle、ui_create_dropdown、ui_create_scrollview、ui_create_rawimage、ui_create_scrollbar，以及用于批量创建的 ui_create_batch（参数 items 为 JSON 字符串数组）。 查询与布局技能：ui_find_all（按 uiType?、limit? 查找场景 UI 元素）、ui_set_text（更新文本）、ui_set_rect（设置尺寸/偏移）、ui_get_rect_transform（读取完整 RectTransform 数据）、ui_set_rect_transform 及其批量版本 ui_set_rect_transform_batch、ui_set_anchor、ui_layout_children、ui_align_selected、ui_distribute_selected。 属性与特效技能：ui_set_image、ui_add_layout_element、ui_add_canvas_group、ui_add_mask、ui_add_outline、ui_configure_selectable。
使用方式与工作流 建议先创建 Canvas，再用 Panel 分组相关控件。批量创建菜单、HUD 组或重复控件时优先使用 ui_create_batch。多数创建技能不接收显式 x/y 位置，需先创建，再用 ui_set_rect、ui_set_anchor 或 ui_layout_children 进行放置与锚定。ui_set_anchor 是移动控件到标准布局位置最快的方式；ui_set_rect 更适合锚定后进行精确尺寸/偏移编辑；构建垂直、水平或网格菜单时，ui_layout_children 优于逐个手工定位子元素。ui_create_batch 主要用于批量创建而非精确定位，其后应配合布局或 rect/anchor 调整；items 在当前 REST/API 层为 JSON 字符串参数，而非原始数组对象。文本创建会自动检测 TextMeshPro：可用则创建 TextMeshProUGUI，不可用则使用 legacy Text，需通过响应载荷确认后再做组件级编辑。若需构建世界空间游戏 UI，先在此创建 Canvas，仅在需要时再转换为 XR。
常用锚点预设 MiddleCenter 用于模态/菜单面板；TopLeft 或 TopRight 用于 HUD 角落；StretchAll 用于全屏背景。
限制与注意事项 不要凭空猜测技能与其参数，应先读取相关文件或通过 GET /skills/recommend?includeSchema=true 获取 schema；若已从 recommend/schema 得到参数定义，可直接进入 dryRun。常见误用需避免：ui_add_canvas 不存在，应使用 ui_create_canvas；ui_create_label 不存在，应使用 ui_create_text；ui_create_checkbox 不存在，应使用 ui_create_toggle；ui_set_color 不存在，应使用 component_set_property 作用于 Image/Text，或使用可用的专用 UI 属性技能；不要混淆 UGUI（ui）与 UI Toolkit（uitoolkit）。常见错误：TARGET_NOT_FOUND（父对象、UI 元素、RectTransform、Text/Image/Selectable 组件或 sprite 资源未找到），可用 ui_find_all、gameobject_find、scene_get_hierarchy 定位并核对 sprite 路径；SEMANTIC_INVALID（如未知锚点预设、布局类型、对齐方式或含分隔符的名称/路径），需从错误上下文选择有效预设/类型后重试；SKILL_ERROR（基于选择的操作因选中 UI 元素不足失败），需先在 Hierarchy 中选择足够元素。精确名称、参数、默认值与返回值由 GET /skills/schema 或 unity_skills.get_skill_schema() 定义，而非本文档。可加载 UI_REFERENCE.md 获取扩展元素创建细节、属性表与更大示例。