Skip to content

v1.6.0

Choose a tag to compare

@Besty0728 Besty0728 released this 07 Mar 03:03
· 471 commits to main since this release

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 编译隔离,无需手动配置

完整更改日志见 https://github.com/Besty0728/Unity-Skills/blob/main/CHANGELOG.md