常见问题与上线检查

保存了配置，前台为什么没变化？

先确认启用的是 KnowSphere 知识付费主题，且点击了当前设置分组的保存按钮。刷新前台再检查。配色和文章排版还可能被浏览器保存的用户偏好覆盖，应在未保存偏好的浏览器中对比默认效果。

首页出现“暂未配置展示区块”

进入 首页模块编排 → 首页区块排序，选择至少一个区块并保存。该列表同时决定可见性与顺序，只有填写 Hero 文案并不会自动启用 Hero。

勾选了专栏区域，首页仍没有专栏

按顺序检查 KnowSphere 插件是否可用、是否为 Pro、专栏是否已发布，以及是否有有效数据。主题勾选只能控制展示，不能开通 Pro 或创建商品。

首页专栏目录关联不对

专栏类型的目录项和轮播选择的是专栏绑定的 Halo 分类。核对插件中的分类绑定，再检查文章是否关联这个分类。不要把另一个同名分类误当作实际绑定项。

会员按钮打开 404

核对会员自定义页面已发布并选择 page_membership.html，再复制其真实固定链接。部分初始链接为 /membership/plans；若实际采用 /membership，统一修改菜单、品牌按钮、快捷入口、轮播与页脚。更换模板不会自动创建两套地址。

套餐价格、会员权益在哪里修改？

在 KnowSphere 插件中修改。主题“会员页”只负责页面文案，首页会员卡片和完整页面读取业务套餐数据。

学习进度为空或显示 0%

进度来自当前账号与插件已有数据。检查登录、专栏购买、实际学习记录和 Pro 能力，不需要在主题配置中手工填写进度。游客、普通用户和已购用户出现不同推荐属于正常情况。

为什么调整全站宽度后手机没有变成 1440px？

全站设置控制最大宽度；手机仍按屏幕宽度自适应。大屏有侧栏时，还会给侧栏留出空间。若只有某个表格、代码块或嵌入内容过宽，应检查该内容内部的响应式样式。

菜单只展开、不跳转

使用侧边栏且父项带子菜单时，默认只展开。需要父项跳转，可开启“允许父级菜单可点击跳转”。当前页面或新窗口打开则在 Halo 菜单项本身设置；品牌、轮播与页脚有各自独立的打开方式。

邮件订阅没有反应

确认站点实际存在处理 /subscribe 表单的订阅服务，并核对表单接口。主题提供 UI，不自动创建后端。SMTP 配置与订阅接口是不同环节。

插件页面没有使用主题的导航与页脚

主题支持 Halo 2.26.0+ 的页面布局契约，但插件页面也需要采用这一契约。请核对 Halo 和插件版本。主题声明的最低版本 2.20.0 不表示旧版 Halo 具备所有新增布局能力。

11 个配置分组速查

上线检查清单

•  已启用正确主题，并保存需要的配置分组。
•  页面模板、发布状态和固定链接正确；默认示例地址已替换。
•  游客、登录用户、会员与已购用户的展示分别核对。
•  Base/Pro 能力与首页模块、导航入口相匹配。
•  顶部与侧边栏菜单的首次及后续跳转方式正确。
•  首页、正文与页脚宽度一致；侧栏展开时组件没有被遮挡。
•  手机卡片、长标题、表格、图片与付费组件没有横向溢出。
•  亮暗模式中的文字、遮罩、菜单、摘要与用户面板清晰可读。
•  所有封面与文档图片附件可访问。
•  备案、版权、社交与帮助链接是真实有效内容。
•  如启用订阅运营，已验证表单后端与实际邮件流程。
•  如启用支付，已按插件流程验证支付渠道与订单状态同步。

本指南的截图来自本地演示环境，并已上传为文档附件。截图展示实际界面；套餐、进度与示例文案不是需要照抄的业务配置。