主题首页模块与配置规范
首页展示来自已公开内容和真实业务数据；没有数据时显示空态或隐藏对应内容，不填充模拟销量、评分和收入。
模块与数据
| 模块 | 数据来源 | Base / Pro |
|---|---|---|
| 品牌首屏、公告、导航 | 主题设置 | 共用 |
| 文章、分类 | Halo 原生变量 / Finder | 共用 |
| 会员套餐 | KnowSphere listMembershipPlans | 共用 |
| 基础专栏 | listColumns / getColumnByCategory | 共用 |
| 签到入口与评论区 | 插件组件 | 共用 |
| 任务、分销等独立业务入口 | Pro 已启用能力 | 按安装版本与实际配置展示 |
设置与渲染
settings.yaml 将每个模块的 enable、标题、简介、数量和导航目标集中配置。数组采用 FormKit array。theme.config 的键名保持稳定，新增配置提供默认值并兼容已安装主题。
首屏按钮使用实际配置 URL。内容卡片用资源 permalink；不要写死 /archives/。会员套餐标题使用 title，专栏标题使用 displayName。
首次服务端渲染读取公共目录；订单、会员状态、钱包等用户数据应按当前请求身份渲染，不能放入跨用户静态缓存。多模块复用一次查询结果，避免每张卡片重复请求完整目录。
展示与适配
- 手机端单列，宽屏逐步增加列数，封面缺失用主题文字或颜色占位。
- 封面设置 width/height 或 aspect-ratio，首屏重要图片优先加载，其余延迟加载。
- 控件有键盘焦点，图标按钮有可访问名称，暗色模式检查文字对比度。
- 等级、价格、免费、试读等标签来自服务端字段，不由封面或主题开关决定访问资格。