# 追光AI 变更日志

## 2026-05-25 等级体系升级 + 论坛二级分类 + 会员空间

### 🔥 20级成长体系 (类似QQ)
- **从4级扩展到20级**: LV01(0分) → LV20(50000分)
- **等级图标**: ⭐(初级) → ⭐⭐⭐(中级) → 🌟(高级) → 🌟🌟(精英) → 🌟🌟🌟(大师)
- **旧等级迁移**: BRONZE→LV01, SILVER→LV03, GOLD→LV06, PLATINUM→LV10
- `src/lib/level-config.ts` — 20级完整配置（含每日限额表）
- **迁移脚本**: `scripts/run-migration-manual.mjs` (绕过shadow DB问题)

### 🔥 论坛二级分类结构
- **ForumCategory自引用关系**: parent/children (CategoryHierarchy)
- **6个父分类 + 24个子分类**:
  - 综合讨论区 → 新手入门/AI资讯/观点讨论
  - AI工具 → 聊天写作/图像创作/视频音频/代码编程/效率办公/数据分析/教育学习
  - 开源技能 → LLM框架/Agent框架/RAG技术/模型训练/部署推理/多模态/数据工程
  - 技术深度 → 算法原理/模型评测/安全对齐/硬件加速
  - 教程与分享 → 入门教程/实战项目/最佳实践
  - 社区互动 → 求助问答/求职招聘/闲聊灌水/反馈建议
- **修复脚本**: `scripts/fix-forum-categories.mjs` (修正孤立子分类parentId)
- `/community` 首页更新为显示二级分类结构

### 🆕 会员个人空间
- `/user/[id]` — 会员空间页面（资料/统计/话题/评论）
- **分享功能**: `ShareButton` 组件（原生API/Twitter/QQ/复制链接）
- **bio字段**: 用户个人简介，支持编辑（最多500字符）
- `/user` 页面新增bio编辑区域

### 🔧 技术修复
- 修复所有旧等级引用 (BRONZE → LV01)
- 修复 ShareButton 构建错误 (Twitter图标 → Link图标)
- 修复 LevelProgress 动态颜色逻辑 (基于等级数字计算)
- 数据库迁移标记为已应用: `20260525000000_expand_user_levels`

---

## 2026-05-24 会员功能优化 + 追光会论坛上线

### 🆕 积分体系
- **PointsHistory** 数据模型 — 记录所有积分变动，含原因/详情/关联信息
- **4级会员系统**: 青铜🥉(0分) → 白银🥈(100分) → 黄金🥇(500分) → 铂金💎(2000分)
- **积分规则**: 评论+5/被赞+2/发帖+10/回复+5/评价+8，含每日上限防刷分
- `src/lib/level-config.ts` — 客户端安全等级配置（无 Prisma 依赖）
- `src/lib/points-reward.ts` — 积分奖励引擎（rewardPoints / getUserStats / getUserPointsHistory）
- `/api/user/points` — 积分统计 + 历史查询 API

### 🆕 追光会（论坛）
- **3个新页面**: /community（首页）、/community/[category]（板块）、/community/topic/[id]（话题详情）
- **8个论坛板块**: 综合讨论/AI工具推荐/技能分享/技术探讨/教程指南/反馈建议/求职招聘/闲聊灌水
- **5个论坛API**: 分类/话题(CRUD)/回复(CRUD) 共10个端点
- **4个论坛组件**: ForumBoard / ForumTopicCard / ForumEditor / NotificationBell
- **种子脚本**: `scripts/seed-forum-categories.mjs`

### 🆕 评论系统(全新实现)
- `/api/comments` — GET获取（含用户等级/积分）+ POST创建（自动积分奖励+通知）
- `/api/comments/[id]/like` — 点赞/取消点赞（切换模式，+2分+通知）
- `CommentCard` — 评论卡片（等级徽章/评分/点赞/嵌套回复）
- `CommentThread` — 评论列表（分页/排序/回复面板）

### 🆕 通知系统
- `/api/notifications` — GET获取（含未读数）+ PUT标记已读
- `NotificationBell` — 导航栏通知铃铛（红点/下拉面板/自动已读）
- 自动触发: 评论回复/评论点赞/话题回复

### 🆕 会员UI组件
- `MemberBadge` — 等级徽章（3种尺寸，支持显示/隐藏积分）
- `LevelProgress` — 等级进度条（当前等级/下一级/进度百分比）

### 🔧 技术改进
- **NextAuth 类型扩展** (`src/types/next-auth.d.ts`) — Session/User/JWT 包含 level/points
- **auth.ts 增强** — JWT/Session回调包含 level/points
- **客户端安全架构** — level-config.ts 与 points-reward.ts 分离，避免客户端打包Node.js原生模块
- **Header 增强** — 新增社区导航链接 + 通知铃铛 + 会员等级徽章
- **/user 页面增强** — 积分进度条/积分明细/统计卡片

### 修复
- ForumPost 新增 `isAnswer` 字段（标记最佳回答）
- Prisma schema 日期默认值修正 `@default(now)` → `@default(now())`
- 迁移兼容问题处理（`prisma db push` 同步）

### 统计数据（本次新增）
- **新增文件**: 15个
- **新增API端点**: 15个
- **新增页面**: 3个
- **新增组件**: 8个
- **新增数据模型**: 1个（PointsHistory）

---

## 2026-05-24 全面技术文档生成
（详见历史 CHANGELOG 记录）