webjing 发布于
1.4.0
最新>=2.26.0
EchoCraft 产品官网主题 v1.4.0 发布说明
- 发布日期：2026-09-05
- 上一个版本：v1.3.4（要求 Halo >= 2.22.3）
本次更新聚焦三件事：把文档页的目录（TOC）体验整体重做，适配Halo2.26.0的布局模版 layout.html。以及修复开启两步验证后无法访问的问题。同时补上了网页语言的动态适配。
✨ 文档页目录全面升级
如果你用 Docsme 插件发布文档，这一版会有非常直观的变化。原先主题自带的是一个「简易目录」小脚本，现在已替换为成熟的 tocbot 方案，并与 Docsme 插件官方对接。
✨ 适配 Halo2.26.0 布局契约
在 tempaltes 目录下新增 layout.html，适配新的布局契约。
现在的目录会是什么样
- 滚动跟随高亮：阅读正文时，右侧目录会自动高亮你当前所在的章节，左侧还有一条竖线指示条，随时知道"读到哪了"。
- 点击平滑滚动：点击目录项会平滑滚动到对应标题，不再"跳一下"。
- 标题不会被顶栏遮住：跳转后标题会自动下移一段距离，正好落在顶部导航栏下方。
- 目录层级更深：从原来只识别
h2、h3两级，扩展到h1~h4四级，结构复杂的文档也能完整呈现。 - 桌面端与移动端一致：移动端的目录浮层会实时同步桌面端的高亮状态，手机上同样是"当前章节高亮"。
- 空目录自动隐藏：页面里没有标题时，目录栏直接隐藏，不会留下一块空白。
细节优化
- 文档页右下角/移动端的目录面板不再出现错位或样式冲突，整体视觉与主题配色统一。
- 文档页现在同时加载 Docsme 插件提供的代码高亮资源，代码块渲染更稳定。
- 目录适配逻辑与 Docsme 插件解耦，插件后续升级时不易冲突。
🔐 修复：开启两步验证后页面无法访问
问题描述：当站点启用了两步验证（2FA / TOTP）时，用户完成账号密码登录后会被引导到验证码页面，但该页面被主题的访问控制拦截，导致无法输入验证码、进不了站点。
现在：已把两步验证页面加入公开访问白名单，2FA 用户可以正常走完验证流程。
如果你的站点开启了身份认证且启用了两步验证，建议尽快升级到本版本。
🌐 网页语言动态适配
页面 <html lang> 属性不再固定写死为 zh-CN，而是根据当前访问语言自动输出。这对多语言站点、浏览器翻译提示、以及屏幕阅读器等场景都更友好。同时在部分没有标题的页面上，也避免输出空标签。
⚠️ 升级提示
- 环境要求提高：本版本要求 Halo 2.26.0 及以上（上一版为 2.22.3）。请先在后台确认你的 Halo 版本，低于 2.26.0 的站点请先升级 Halo 再更新主题。
- 文档页依赖：文档目录功能依赖 Docsme 插件，请确保插件已更新到较新版本。
- 无需额外配置：升级后新目录自动生效，不需要手动调整主题设置。
资源下载
- themeLogo.svg