AHA 动态升级路线图（v1.x → v2.x）
目标：在不推翻 Hexo + Matery + GitHub Pages 架构的前提下，逐步引入“动态能力”，形成 AHA World 轻动态生态。
一、总体原则
- 内容仍由 Hexo 生成
- 动态能力通过 API（Serverless）实现
- 数据先轻后重
- 功能可插拔、可回退
- 不破坏当前 gh-pages 发布流程
二、阶段划分
Phase 1：轻度动态启用（AHA v1.2）
🎯 目标
让网站具备基础互动能力。
1. 联系我表单（优先级最高）
功能
- 表单提交
- 邮件或 Telegram 通知
- 防垃圾提交
技术路径
- 快速方案：Formspree
- 推荐方案：Cloudflare Workers API
前端落点
/contact/ 页面 + fetch() 提交接口
2. 评论系统
推荐方案
- Giscus（零维护）
- Waline（可控性更高）
原则
Phase 1 先用 Giscus
后续视情况升级为自有评论系统
3. 基础统计
功能
- PV
- 访问来源
- 设备统计
推荐
- Cloudflare Web Analytics
- Umami
✅ Phase 1 交付标准
- 可以联系站长
- 可以评论互动
- 可以查看基础访问数据
网站正式具备“动态感”。
Phase 2：数据型互动（AHA v1.3）
🎯 目标
建立可累计的数据资产。
4. 点赞 / 阅读量系统
功能
- 点赞数
- 阅读量统计
- 热门文章排行
推荐架构
- API：Cloudflare Workers
- 数据库：Cloudflare D1 / Upstash Redis
前端落点
post.ejs 添加点赞按钮组件
5. 留言板页面
功能
- 公开留言
- 管理审核
- 站长回复
技术
与点赞共用 API + 数据库
✅ Phase 2 交付标准
- 文章有点赞数
- 文章有阅读量
- 首页有热门文章
- 站内有留言板
Phase 3：服务化升级（AHA v1.4）
🎯 目标
让网站成为“服务入口”。
6. 订阅系统
功能
- 邮件订阅
- RSS 自动推送
- Telegram 通知
技术建议
- Hexo RSS 保留
- Workers 管理订阅列表
7. 搜索升级
功能
- 全文搜索
- 拼音/中英混合搜索
- 标签推荐
技术路径
- 轻量：Hexo 本地搜索插件
- 进阶：Algolia / Meilisearch
✅ Phase 3 交付标准
- 支持订阅
- 搜索体验升级
- 网站具备回访机制
Phase 4：半动态平台化（AHA v2.0）
🎯 目标
构建可管理的数据后台。
8. 管理后台（最小 CMS）
功能
- 审核留言
- 查看统计
- 黑名单管理
实现
/admin页面- 简单鉴权（JWT / 管理口令）
9. 用户体系（可选）
仅在以下情况下启用：
- 会员系统
- 课程体系
- 社群功能
否则保持轻量匿名互动。
✅ Phase 4 交付标准
- 有后台管理系统
- 动态数据可视化
- 前端仍然高速静态访问
三、推荐版本节奏
| 版本 | 功能 |
|---|---|
| v1.2 | Contact + 评论 + 统计 |
| v1.3 | 点赞 + 阅读量 + 热门文章 |
| v1.4 | 订阅 + 搜索升级 |
| v2.0 | 后台管理 + 数据整合 |
四、优先级建议
- 联系表单
- 评论系统
- 点赞 / 阅读量
- 热门文章
- 留言板
- 订阅系统
- 后台系统
五、AHA 架构愿景
静态内容负责：
- SEO
- 高速访问
- 品牌表达
动态能力负责：
- 数据沉淀
- 用户互动
- 服务扩展
六、哲学表达（AHA 理念）
静态是根。
动态是枝。
数据是年轮。
AHA 不追求复杂，而追求“可生长”。
七、下一步行动
- 部署联系表单 API
- 接入评论系统
- 设计点赞数据结构
- 规划 AHA-api 仓库
AHA v1.x —— 生长中
