argon-theme/.kiro/steering/settings-reorganize-plan-v2.md

Settings.php 完整重新分类方案

当前问题分析

1. 分类不合理

• 验证码与安全：包含了评论功能、评论外观等不相关设置
• 特殊页面：页脚设置被错误放置在这里（出现两次）
• 浮动按钮与页脚：页脚设置应该独立
• 文章显示 vs 文章功能：标题样式、过时提示放在了文章显示中，应该在文章功能

2. 重复的子分类

• subsection-subdirectory 出现两次（第294行和第310行）
• subsection-footer 出现两次（第2539行和第2555行）
• subsection-comment-features 在验证码与安全分类中（第3766行），应该在评论设置中

3. 设置项错位

• 评论功能设置（Markdown、编辑等）在"验证码与安全"中
• 评论外观设置在"验证码与安全"中
• AI 垃圾评论识别在"验证码与安全"中，应该在"评论设置"中
• 页脚设置在"特殊页面"中

新的分类结构方案

1. 基础设置 (section-basic)
   ├── 主题色 (subsection-theme-color)
   ├── 夜间模式 (subsection-dark-mode)
   └── 子目录 (subsection-subdirectory)

2. 外观样式 (section-appearance)
   ├── 卡片样式 (subsection-card-style)
   ├── 字体 (subsection-font)
   └── 动画效果 (subsection-animation)

3. 页面布局 (section-layout)
   └── 整体布局 (subsection-page-layout)

4. 顶栏设置 (section-toolbar)
   ├── 基本设置 (subsection-toolbar-basic)
   ├── 顶栏标题 (subsection-toolbar-title)
   ├── 顶栏图标 (subsection-toolbar-icon)
   ├── 顶栏外观 (subsection-toolbar-appearance)
   └── 自定义链接 (subsection-toolbar-links)

5. Banner 设置 (section-banner)
   ├── Banner 内容 (subsection-banner-content)
   ├── Banner 外观 (subsection-banner-appearance)
   └── Banner 动画 (subsection-banner-animation)

6. 页面背景 (section-background)
   ├── 背景图片 (subsection-background-image)
   └── 透明度与毛玻璃 (subsection-transparency)

7. 侧边栏 (section-sidebar)
   ├── 作者信息 (subsection-author-info)
   ├── 扩展功能 (subsection-sidebar-features)
   └── 博客公告 (subsection-announcement)

8. 浮动按钮 (section-fab) [新建]
   └── 浮动操作按钮 (subsection-fab)

9. 页脚设置 (section-footer) [新建]
   └── 页脚 (subsection-footer)

10. SEO 与性能 (section-seo-performance)
    ├── SEO (subsection-seo)
    ├── CDN 加速 (subsection-cdn)
    └── 日期格式 (subsection-date-format)

11. 文章显示 (section-post-display)
    ├── Meta 信息 (subsection-post-meta)
    └── 文章头图 (subsection-thumbnail)

12. 文章功能 (section-post-features)
    ├── AI 文章摘要 (subsection-ai-summary)
    ├── 脚注引用 (subsection-footnote)
    ├── 分享 (subsection-share)
    ├── 文章目录 (subsection-toc)
    ├── 赞赏 (subsection-donate)
    ├── 文末内容 (subsection-post-footer)
    ├── 相似推荐 (subsection-related-posts)
    ├── 标题样式 (subsection-title-style) [从文章显示移入]
    └── 过时提示 (subsection-post-other) [从文章显示移入]

13. 特殊页面 (section-special-pages)
    ├── 搜索设置 (subsection-search) [新增]
    ├── 归档页面 (subsection-archive)
    └── 友情链接 (subsection-friend-links)

14. 功能增强 (section-enhancements)
    ├── 代码高亮 (subsection-code-highlight)
    ├── 数学公式 (subsection-math)
    ├── Lazyload (subsection-lazyload)
    ├── 图片放大 (subsection-lightbox)
    └── Pangu.js (subsection-pangu)

15. 评论设置 (section-comment)
    ├── 评论分页 (subsection-comment-pagination)
    ├── 发送评论 (subsection-comment-submit)
    ├── 评论功能 (subsection-comment-features) [从验证码与安全移入]
    ├── AI 垃圾评论识别 (subsection-comment-spam-detection) [从验证码与安全移入]
    └── 评论区外观 (subsection-comment-appearance) [从验证码与安全移入]

16. 验证码设置 (section-captcha) [重命名]
    ├── 验证码配置 (subsection-captcha)
    └── 场景验证码 (subsection-captcha-scenes)

17. 反馈与安全 (section-feedback-security) [新建]
    ├── 反馈设置 (subsection-feedback) [从验证码与安全移入]
    └── 速率限制 (subsection-rate-limit) [从验证码与安全移入]

18. 高级设置 (section-advanced)
    ├── 自定义脚本 (subsection-scripts)
    └── 杂项 (subsection-misc)

主要调整说明

1. 拆分"浮动按钮与页脚"

• 浮动按钮 → 独立为"浮动按钮"分类
• 页脚 → 独立为"页脚设置"分类

2. 拆分"验证码与安全"

• 验证码相关 → "验证码设置"分类
• 反馈和速率限制 → "反馈与安全"分类
• 评论功能/外观/AI识别 → 移到"评论设置"分类

3. 优化"文章显示"和"文章功能"

• 文章显示：只保留 Meta 信息和头图（纯展示相关）
• 文章功能：包含所有功能性设置（标题样式、过时提示等）

4. 完善"特殊页面"

• 添加搜索设置子分类
• 移除错误的页脚设置

5. 删除重复项

• 删除重复的子目录设置
• 删除重复的页脚设置
• 删除重复的评论功能设置

实施步骤

步骤 1：删除重复的子分类

1. 删除第310-324行的重复子目录设置
2. 删除第2555-2569行的重复页脚设置

步骤 2：创建新的一级分类

1. 拆分"浮动按钮与页脚"为两个独立分类
2. 创建"反馈与安全"分类

步骤 3：移动设置项

1. 将评论功能、AI垃圾评论识别、评论外观从"验证码与安全"移到"评论设置"
2. 将标题样式、过时提示从"文章显示"移到"文章功能"
3. 将反馈设置、速率限制从"验证码与安全"移到"反馈与安全"

步骤 4：重命名分类

1. "验证码与安全" → "验证码设置"

步骤 5：调整编号

1. 重新编号所有一级分类（1-18）

优化效果

• 逻辑更清晰：每个分类职责单一，不再混杂
• 易于查找：相关设置集中在一起
• 结构合理：18个一级分类，每个分类3-5个子分类
• 无重复项：删除所有重复的设置项
• 保持兼容：所有 ID 和 name 属性保持不变