#常见问题

#点击登录没有出现弹窗

在「外观 → 认证界面 → 基础设置」确认登录方式为「弹窗」并已保存。主题的登录入口需要指向 /login、/signup 或 /logout 等 Halo 原生地址。修改设置后刷新站点页面，并清除浏览器或 CDN 缓存。

如果背景页面本身需要登录才能访问，插件会改用独立登录页，避免反复跳转。

#想固定使用完整登录页

在链接后加上 ?auth_ui_page=1，例如 /login?auth_ui_page=1。也可以在基础设置中把登录方式改为「独立页面」，此时站点不再加载弹窗脚本。

#启用设计后站点没有变化

启用会在片刻后生效，刷新页面再看。确认列表中该设计显示「使用中」，并检查是否有 CDN 或页面缓存。在工作室中修改正在使用的设计后，需要点击「保存」才会更新站点。

#想恢复插件默认样式

删除或停用当前设计即可。删除正在使用的设计后，站点会自动恢复插件默认样式；也可以让外部 AI 调用 auth-ui__activate_design 并传入空字符串。

#AI 面板提示未启用 AI Foundation

站内 AI 需要 Halo AI Foundation 1.3.0 或更高的 1.x 版本。在「系统 → 插件」安装并启用后，回到 AI 面板点击「重新检测」。

#AI 提示还没有设置默认语言模型

在输入框下方的模型选择器中选一个语言模型，或到「AI Foundation → 默认模型」设置默认语言模型并保存。详见 站内 AI 设计。

#AI 返回错误或格式不对

#MCP 客户端看不到登录工坊的工具

• 确认 MCP Server 为 1.3.0 或更高的 1.x 版本，且已启用。
• 在「工具 → MCP 服务」中编辑访问密钥，勾选「登录工坊 → 登录界面设计」下的工具。新工具不会自动加入已有密钥。
• 重启客户端，或重新连接 MCP 服务。

#自定义 JavaScript 没有效果

JavaScript 不会在工作室预览中运行，保存并启用后在站点生效。打开浏览器开发者工具查看控制台报错。代码出错不会影响登录本身。

#自定义 HTML 中的部分内容消失了

自定义区块中的 <script> 和 onclick 等事件属性会被移除。交互逻辑请写在「代码 → JavaScript」中，样式请使用 CSS 或内置样式类。