主题漫游

1.1.0 - 2026-07-23

这次更新不只是让访客切换主题，也把不同主题的页面模板和导航真正串联起来。站长无需再为了每套主题重复创建页面、创建菜单和逐项绑定，只需拖拽模板即可完成一套独立导航。

新增

• 新增主题导航编排功能，为每套主题维护独立的一级、二级导航结构。
• 自动识别 Halo 内置模板，以及主题声明并真实存在的自定义页面模板。
• 自动关联当前主题与对应模板，集中展示模板名称、来源、访问路径和可用状态。
• 支持把待选模板拖入导航结构，并通过拖拽调整一级导航、二级导航和显示顺序。
• 保存编排时自动生成并复用缺少的页面与导航数据，无需提前在 Halo 后台创建页面或菜单。
• 支持直接编辑导航名称和访问路径，可使用站内真实路径或自定义链接。
• 已完成的导航编排可以直接作为主题菜单使用，并随访客当前选择的主题自动切换。
• 新增前台主题适配接口，支持稳定挂载锚点、自定义切换按钮、CSS 变量、Shadow Parts 和 setAppearance()。

优化

• 优化模板池与导航结构的双栏拖拽体验，拖入右侧后自动从待选区域移除。
• 优化嵌套导航的层级提示、拖拽占位和排序反馈，让一级、二级关系更直观。
• 优化前台切换入口样式，可继承主题按钮的颜色、尺寸、圆角、边框和阴影。
• 优化主题切换入口在 React、SPA 和局部重渲染页面中的挂载稳定性。
• 优化主题选择弹窗的打开过程，已有目录数据时不再重复请求和重建弹窗。
• 保留访客当前真实访问路径进行主题切换，不修改 Halo 全局启用主题，也不影响其他访客。

修复

• 修复页面切换或顶部导航重新渲染后，主题漫游入口偶尔消失的问题。
• 修复主题适配颜色被插件内部默认变量覆盖的问题。
• 修复点击主题切换按钮时弹窗短暂闪烁、入场动画重复执行的问题。
• 修复未提前创建页面或菜单时，部分主题模板无法正常加入导航的问题。
• 修复清空导航编排后旧数据仍被复用的问题。
• 修复主题模板名称、访问路径与实际模板文件对应不准确的问题。