Repository navigation
v1.6.0
v1.6.0 — UI Toolkit 模块 & 服务器增强
⭐ Highlight - 全新 UI Toolkit 模块 — 15 个 uitk_* skills 让 AI 直接操控 Unity 现代 UI 系统:创建/读写/删除
UXML+USS 文件、配置 UIDocument、PanelSettings 全部 27+ 属性的创建/读取/修改(含 Unity 6 World Space
渲染模式),6 种即用模板一键生成完整界面
- SKILL.md 内置 USS Design Guide — 完整的 USS vs CSS 能力对照、Flexbox
布局、设计模式库(卡片/导航栏/徽章/进度条等)、过渡动画写法、常见陷阱提示,帮助 AI 直接编写正确的 USS
样式代码
Added
- 文件操作 (6 skills):uitk_create_uss / uitk_create_uxml — 创建样式表和布局文件(UXML 支持自动关联
USS);uitk_read_file / uitk_write_file — 读写文件内容;uitk_delete_file — 安全删除;uitk_find_files
— 按名称/类型搜索项目中的 USS/UXML - 场景管理 (6 skills):uitk_create_document — 创建 UIDocument GameObject 并自动挂载 UXML +
PanelSettings;uitk_set_document — 修改已有 UIDocument 属性;uitk_list_documents — 列出场景中所有
UIDocument 及其配置状态;uitk_create_panel_settings — 创建 PanelSettings 资产(27+
参数全属性覆盖);uitk_get_panel_settings — 读取 PanelSettings 所有属性;uitk_set_panel_settings —
部分修改已有 PanelSettings(仅改显式传入的参数,其余保持不变) - 检查/模板/批量 (3 skills):uitk_inspect_uxml — 解析 UXML
元素层级树(支持深度限制);uitk_create_from_template — 从 6 种内置模板(menu / hud / dialog /
settings / inventory / list)生成完整 UXML + USS;uitk_create_batch — 批量创建多个 USS/UXML 文件 - PanelSettings 全属性支持:覆盖 Inspector 中全部属性 — 核心(scaleMode / referenceResolution /
screenMatchMode)、通用(targetDisplay / sortOrder / scale / match / referenceDpi /
fallbackDpi)、资产引用(themeStyleSheet / textSettings / targetTexture)、Dynamic
Atlas(min/max/maxSub/filters)、Color Clear(clearColor / RGBA / clearDepthStencil) - Unity 6 World Space 支持:renderMode(ScreenSpaceOverlay /
WorldSpace)、colliderUpdateMode(Match3DBoundingBox / Match2DDocumentRect / KeepExistingCollider)、
colliderIsTrigger、forceGammaRendering、bindingLogLevel、vertexBudget、textureSlotCount — 使用 #if
UNITY_6000_0_OR_NEWER 智能区分,旧版自动忽略 - USS Design Guide:SKILL.md 内置完整的 USS 设计参考 — USS vs CSS 能力对照表、Flexbox 布局模式、10+
设计模式(卡片 / 导航栏 / 徽章 / 按钮组 / 进度条 / 表单 / 模态框)、transition 过渡动画写法、CSS
Variables 主题变量、常见陷阱(不支持 gap / grid / z-index / box-shadow 等) - SkillsHttpServer Watchdog 机制:后台每 15
秒自检监听线程存活状态,线程异常退出时自动重启服务器,彻底消除 Unity 失焦后服务无响应问题 - KeepAlive 间隔可配置:设置面板新增 KeepAlive 间隔调整(默认 30s,最小
5s),控制后台无任务时的主线程唤醒频率,平衡响应速度与 CPU 占用
Changed
- Skills 总数:431 → 446(新增 15 个 UI Toolkit skills)
- 模块数:37 → 38
- UIToolkitSkills USS 路径处理:uitk_create_uxml 的 ussPath 参数支持相对路径自动解析
- PanelSettings 内部属性访问:Unity 6 的 renderMode / colliderUpdateMode / colliderIsTrigger 通过
SerializedObject 访问(这些属性在部分 Unity 6 版本中为 internal API),确保跨版本编译兼容
Compatibility
- ✅ Unity 2021.3+:全部 15 个 skills 正常运行(已验证 Unity 2022.3.62f2)
- ✅ Unity 6 (6000.x):额外支持 7 个 Unity 6 专属属性(已验证 Unity 6000.3.9f1)
- #if UNITY_6000_0_OR_NEWER 编译隔离,无需手动配置