docs: 添加设置页优化规划文档
- settings-page-structure.md: 优化后的完整分类结构 - settings-reorganize-plan.md: 重组实施计划 - 这些文档用于指导优化过程
This commit is contained in:
126
.kiro/steering/settings-page-structure.md
Normal file
126
.kiro/steering/settings-page-structure.md
Normal file
@@ -0,0 +1,126 @@
|
||||
# Argon 主题设置页结构优化方案
|
||||
|
||||
## 优化后的分类结构
|
||||
|
||||
```
|
||||
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-footer)
|
||||
├── 浮动操作按钮 (subsection-fab)
|
||||
└── 页脚 (subsection-footer)
|
||||
|
||||
9. SEO 与性能 (section-seo-performance)
|
||||
├── SEO (subsection-seo)
|
||||
├── CDN 加速 (subsection-cdn)
|
||||
└── 日期格式 (subsection-date-format)
|
||||
|
||||
10. 文章显示 (section-post-display)
|
||||
├── Meta 信息 (subsection-post-meta)
|
||||
├── 文章头图 (subsection-thumbnail)
|
||||
├── 标题样式 (subsection-title-style)
|
||||
└── 过时提示 (subsection-post-other)
|
||||
|
||||
11. 文章功能 (section-post-features)
|
||||
├── AI 文章摘要 (subsection-ai-summary)
|
||||
├── 脚注引用 (subsection-footnote)
|
||||
├── 分享 (subsection-share)
|
||||
├── 文章目录 (subsection-toc)
|
||||
├── 赞赏 (subsection-donate)
|
||||
├── 文末内容 (subsection-post-footer)
|
||||
└── 相似推荐 (subsection-related-posts)
|
||||
|
||||
12. 特殊页面 (section-special-pages)
|
||||
├── 搜索设置 (subsection-search)
|
||||
├── 归档页面 (subsection-archive)
|
||||
└── 友情链接 (subsection-friend-links)
|
||||
|
||||
13. 功能增强 (section-enhancements)
|
||||
├── 代码高亮 (subsection-code-highlight)
|
||||
├── 数学公式 (subsection-math)
|
||||
├── Lazyload (subsection-lazyload)
|
||||
├── 图片放大 (subsection-lightbox)
|
||||
└── Pangu.js (subsection-pangu)
|
||||
|
||||
14. 高级设置 (section-advanced)
|
||||
├── 自定义脚本 (subsection-scripts)
|
||||
└── 杂项 (subsection-misc)
|
||||
|
||||
15. 评论设置 (section-comment)
|
||||
├── 评论分页 (subsection-comment-pagination)
|
||||
├── 发送评论 (subsection-comment-submit)
|
||||
├── 评论功能 (subsection-comment-features)
|
||||
├── AI 垃圾评论识别 (subsection-comment-spam-detection)
|
||||
└── 评论区外观 (subsection-comment-appearance)
|
||||
|
||||
16. 验证码与安全 (section-security)
|
||||
├── 验证码设置 (subsection-captcha)
|
||||
├── 场景验证码 (subsection-captcha-scenes)
|
||||
├── 反馈设置 (subsection-feedback)
|
||||
└── 速率限制 (subsection-rate-limit)
|
||||
```
|
||||
|
||||
## 主要优化点
|
||||
|
||||
### 1. 结构调整
|
||||
- **拆分"高级设置"**:将 SEO、CDN、日期格式独立为"SEO 与性能"分类
|
||||
- **优化"特殊页面"**:将搜索设置提前,更符合使用频率
|
||||
- **细化"验证码与安全"**:增加反馈设置子分类
|
||||
- **完善"评论设置"**:增加 AI 垃圾评论识别子分类
|
||||
|
||||
### 2. 命名优化
|
||||
- "各场景验证码" → "场景验证码"(更简洁)
|
||||
- "标题" → "顶栏标题"(更明确)
|
||||
- "文章内标题样式" → "标题样式"(更简洁)
|
||||
- "左侧栏文章目录" → "文章目录"(更简洁)
|
||||
- "文末附加内容" → "文末内容"(更简洁)
|
||||
- "文章头图 (特色图片)" → "文章头图"(更简洁)
|
||||
- "其他" → "过时提示"(更明确)
|
||||
- "归档外观" → 合并到"归档页面"
|
||||
- "归档配置" → 合并到"归档页面"
|
||||
- "CDN" → "CDN 加速"(更明确)
|
||||
|
||||
### 3. 逻辑优化
|
||||
- 将"子目录"从原"高级设置"移到"基础设置"
|
||||
- 将"动画效果"从"功能增强"移到"外观样式"
|
||||
- 将"日期格式"从原位置移到"SEO 与性能"
|
||||
- 将"自定义脚本"保留在"高级设置"
|
||||
- 新增"评论区外观"子分类
|
||||
|
||||
## 实施说明
|
||||
|
||||
1. 保持所有设置项的 ID 不变,确保兼容性
|
||||
2. 只调整分类标题和层级结构
|
||||
3. 优化后的结构更符合用户使用习惯
|
||||
4. 减少了重复和冗余的分类
|
||||
71
.kiro/steering/settings-reorganize-plan.md
Normal file
71
.kiro/steering/settings-reorganize-plan.md
Normal file
@@ -0,0 +1,71 @@
|
||||
# Settings.php 重组实施计划
|
||||
|
||||
## 当前问题
|
||||
|
||||
1. **重复的分类标题**:
|
||||
- 第611行:`<!-- ========== 4. 顶栏设置 ==========` (错误位置,实际是 CDN/子目录/日期格式)
|
||||
- 第718行:`<!-- ========== 4. 顶栏设置 ==========` (正确位置)
|
||||
- 第1574行:`<!-- ========== 9. 高级设置 ==========` (第一次出现,包含 SEO)
|
||||
- 第3018行:`<!-- ========== 14. 高级设置 ==========` (第二次出现,包含自定义脚本)
|
||||
|
||||
2. **结构混乱**:
|
||||
- CDN、子目录、日期格式被错误地放在"顶栏设置"标题下
|
||||
- 动画效果在"功能增强"中,应该在"外观样式"中
|
||||
|
||||
## 修改步骤
|
||||
|
||||
### 步骤 1:删除第611-717行的错误内容
|
||||
这部分包含:
|
||||
- 错误的"顶栏设置"标题
|
||||
- CDN 设置
|
||||
- 子目录设置
|
||||
- 日期格式设置
|
||||
|
||||
这些内容需要移动到正确的位置。
|
||||
|
||||
### 步骤 2:重新组织分类顺序
|
||||
|
||||
**新的分类顺序**:
|
||||
1. 基础设置 (93行) - 保持不变,添加子目录
|
||||
2. 外观样式 (294行) - 添加动画效果
|
||||
3. 页面布局 (383行) - 保持不变
|
||||
4. 顶栏设置 (718行) - 保持不变
|
||||
5. Banner 设置 (959行) - 保持不变
|
||||
6. 页面背景 (1176行) - 保持不变
|
||||
7. 侧边栏 (1350行) - 保持不变
|
||||
8. 浮动按钮与页脚 (1501行) - 保持不变
|
||||
9. **SEO 与性能** (新建) - 包含 SEO、CDN、日期格式
|
||||
10. 文章显示 (1607行) - 保持不变
|
||||
11. 文章功能 (1884行) - 保持不变
|
||||
12. 特殊页面 (2411行) - 调整子分类顺序
|
||||
13. 功能增强 (2484行) - 移除动画效果
|
||||
14. 高级设置 (3018行) - 只保留自定义脚本和杂项
|
||||
15. 评论设置 (3169行) - 添加 AI 垃圾评论识别子分类
|
||||
16. 验证码与安全 (3296行) - 添加反馈设置子分类
|
||||
|
||||
### 步骤 3:子分类名称优化
|
||||
|
||||
需要修改的子分类名称:
|
||||
- `各场景验证码` → `场景验证码`
|
||||
- `标题` → `顶栏标题` (在顶栏设置中)
|
||||
- `文章内标题样式` → `标题样式`
|
||||
- `左侧栏文章目录` → `文章目录`
|
||||
- `文末附加内容` → `文末内容`
|
||||
- `文章头图 (特色图片)` → `文章头图`
|
||||
- `其他` → `过时提示` (在文章显示中)
|
||||
- `CDN` → `CDN 加速`
|
||||
|
||||
## 实施方式
|
||||
|
||||
由于文件结构复杂且存在重复,建议采用以下方式:
|
||||
|
||||
1. **手动编辑关键部分**:删除重复的分类标题
|
||||
2. **批量替换简单内容**:子分类名称优化
|
||||
3. **验证修改结果**:确保所有设置项都在正确的分类下
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. 保持所有设置项的 `name` 属性不变
|
||||
2. 保持所有 ID 不变(`section-*` 和 `subsection-*`)
|
||||
3. 不修改任何设置项的逻辑代码
|
||||
4. 只调整分类标题和层级结构
|
||||
Reference in New Issue
Block a user