后台自定义配置

Annoying Theme 的后台配置建议集中成一份主题配置 Schema。站长以后只需要在后台修改字段，前台主题、个人中心、用户中心、AI 自动回复和官网内容都从同一份配置读取。

配置分组

分组	用途
site	站点名称、品牌文案、主色、强调色、页脚备案等基础信息
navigation	顶部导航、侧边栏分区、右上角头像菜单、外链入口
userCenter	个人主页、作者卡片、用户标识、资料卡展示策略
userBenefits	用户中心、扩展入口、权益说明、记录入口、开源主题标识
ai	AI 自动回复开关、提示词、回复频率、审核策略
publishing	官网首页、下载说明、文档入口、发布节奏

推荐结构

{
  "site": {
    "name": "Annoying Theme",
    "slogan": "为 XiunoX 重新打磨的现代主题系统",
    "primaryColor": "#3b82f6",
    "accentColor": "#ec4899"
  },
  "navigation": {
    "avatarMenu": true,
    "sidebarSections": true,
    "items": ["首页", "主题", "文档", "后台"]
  },
  "userCenter": {
    "enabled": true,
    "authorCard": true,
    "userBadge": true
  },
  "userBenefits": {
    "enabled": true,
    "edition": "open",
    "extensionEntry": true
  },
  "ai": {
    "enabled": false,
    "replyMode": "manual-review"
  },
  "publishing": {
    "downloadPath": "/download/",
    "docsPath": "/docs/",
    "releaseNote": "持续更新"
  }
}

后端接入

静态官网里的配置页用于确认字段和交互。正式接入 XiunoX 时，建议做成主题插件接口：

GET  /plugin/annoying_theme_config
POST /plugin/annoying_theme_config

后台保存时需要校验管理员权限、CSRF 令牌和字段白名单。前台只读取已经发布的配置，不直接暴露管理后台 Token。

使用方式

先在官网后台配置页调整字段，确认 UI 和字段名稳定后，再把同一份 Schema 落到 XiunoX 插件的 MySQL 配置表。这样以后新增右上角菜单、侧边栏栏目、用户入口或 AI 自动回复，都只改后台配置，不需要反复翻模板文件。