2026-05-25: 等级体系升级(20级)+论坛二级分类+会员空间

2026-05-24 23:05:38 +08:00
parent 6c78c32157
commit 9bf3e7574a
118 changed files with 11842 additions and 3262 deletions
@@ -1,275 +1,92 @@
 # 追光AI 变更日志

-## v0.11.1 (2026-05-22) - AI发现管线质量优化
+## 2026-05-25 等级体系升级 + 论坛二级分类 + 会员空间

-### 全链路测试
- 跑通全部AI自动化管线：GitHub搜索 → DeepSeek评测 → 入库 → 内容生成
- 2个脚本(automatic-review + daily-discover) + 4个API端点全部验证通过
- 连测创建12条技能+评测记录，DeepSeek生成1篇日报+长文+视频脚本+社交卡片
+### 🔥 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问题)

-### 质量过滤修复
- **非AI项目过滤**: auto-review.mjs + daily-discover.mjs 新增 `isValidAIProject()` 函数
-  - 关键词过滤: `book/guide/tutorial/awesome/interview/notes/handbook/cheatsheet/roadmap/curated-list` 等
-  - 语言过滤: 纯Markdown/HTML文档Repo(Stars<5000)自动拒绝
-  - 主题过滤: 有GitHub Topics的Repo必须包含AI相关Topic（ai/llm/rag/agent/gpt等）
- 清理5条误入库非AI数据：AgentGuide、JavaGuide、pathway、StableDiffusionBook、Claude-Code-Everything
+### 🔥 论坛二级分类结构
+- **ForumCategory自引用关系**: parent/children (CategoryHierarchy)
+- **6个父分类 + 24个子分类**:
+  - 综合讨论区 → 新手入门/AI资讯/观点讨论
+  - AI工具 → 聊天写作/图像创作/视频音频/代码编程/效率办公/数据分析/教育学习
+  - 开源技能 → LLM框架/Agent框架/RAG技术/模型训练/部署推理/多模态/数据工程
+  - 技术深度 → 算法原理/模型评测/安全对齐/硬件加速
+  - 教程与分享 → 入门教程/实战项目/最佳实践
+  - 社区互动 → 求助问答/求职招聘/闲聊灌水/反馈建议
+- **修复脚本**: `scripts/fix-forum-categories.mjs` (修正孤立子分类parentId)
+- `/community` 首页更新为显示二级分类结构

-### JSON解析健壮性
- 新增 `extractJSON()` 统一工具函数 → `src/lib/utils.ts`
- 支持markdown代码块包裹(`\`\`\`json...\`\`\``)、花括号/方括号容错
- 替换 deepseek.ts、auto-review.mjs、daily-discover.mjs、daily-reports/generate 的旧解析逻辑
- 新增 `scripts/test-content-generation.mjs` 全管线测试脚本
+### 🆕 会员个人空间
+- `/user/[id]` — 会员空间页面（资料/统计/话题/评论）
+- **分享功能**: `ShareButton` 组件（原生API/Twitter/QQ/复制链接）
+- **bio字段**: 用户个人简介，支持编辑（最多500字符）
+- `/user` 页面新增bio编辑区域

-### 新增脚本
- `scripts/cleanup-non-ai.mjs` — 一键清理误入库非AI技能数据
+### 🔧 技术修复
+- 修复所有旧等级引用 (BRONZE → LV01)
+- 修复 ShareButton 构建错误 (Twitter图标 → Link图标)
+- 修复 LevelProgress 动态颜色逻辑 (基于等级数字计算)
+- 数据库迁移标记为已应用: `20260525000000_expand_user_levels`

 ---

-## v0.11.0 (2026-05-22) - 权限体系重构
+## 2026-05-24 会员功能优化 + 追光会论坛上线

-### 架构变更
- **新增数据模型**: `Role`(角色), `Permission`(权限点), `RolePermission`(角色-权限关联) 三张表
- **User 模型**: 新增 `roleId` 字段关联 `Role`，与原有 `role` 字符串字段并行（向后兼容）
- 默认角色：**超级管理员**(Admin, 全部53权限)、**VIP成员**(Vip, 19个精选权限)
+### 🆕 积分体系
+- **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

-### 权限体系
- **53个精细化权限点**，按页面分组管理：
-  - 工具管理 14项 · 技能库 12项 · 评测管理 8项
-  - AI发现 7项 · 内容管理 8项 · 系统管理 4项
- 所有后台按钮/操作均已对应权限点，可逐个勾选控制
+### 🆕 追光会（论坛）
+- **3个新页面**: /community（首页）、/community/[category]（板块）、/community/topic/[id]（话题详情）
+- **8个论坛板块**: 综合讨论/AI工具推荐/技能分享/技术探讨/教程指南/反馈建议/求职招聘/闲聊灌水
+- **5个论坛API**: 分类/话题(CRUD)/回复(CRUD) 共10个端点
+- **4个论坛组件**: ForumBoard / ForumTopicCard / ForumEditor / NotificationBell
+- **种子脚本**: `scripts/seed-forum-categories.mjs`

-### 新增页面
- **`/admin/roles` 角色权限管理**: 左侧角色列表 + 右侧按分组的权限勾选网格
-  - 新建/删除自定义角色（系统角色受保护）
-  - 分组全选/取消全选
-  - 保存按钮实时同步到数据库
+### 🆕 评论系统(全新实现)
+- `/api/comments` — GET获取（含用户等级/积分）+ POST创建（自动积分奖励+通知）
+- `/api/comments/[id]/like` — 点赞/取消点赞（切换模式，+2分+通知）
+- `CommentCard` — 评论卡片（等级徽章/评分/点赞/嵌套回复）
+- `CommentThread` — 评论列表（分页/排序/回复面板）

-### 新增 API
- `GET/POST /api/admin/roles` — 角色列表/创建
- `PUT/DELETE /api/admin/roles/[id]` — 角色编辑/删除
- `GET /api/admin/permissions` — 全部权限点列表
- `GET /api/admin/user-permissions` — 用户权限查询(支持roleId/userId/当前用户)
+### 🆕 通知系统
+- `/api/notifications` — GET获取（含未读数）+ PUT标记已读
+- `NotificationBell` — 导航栏通知铃铛（红点/下拉面板/自动已读）
+- 自动触发: 评论回复/评论点赞/话题回复

-### 鉴权升级
- **middleware.ts**: 从硬编码 `role==="admin"` 改为认证检查 + 路由层委派
- **admin-auth.ts**: `requireAdmin()` 兼容旧 `role` 字符串 + 新 `roleId` 关联角色双重逻辑
- 新增 `requirePermission(key)` — 细粒度权限点校验
- 新增 `getAllUserPermissions()` — 获取当前用户全部权限集合
+### 🆕 会员UI组件
+- `MemberBadge` — 等级徽章（3种尺寸，支持显示/隐藏积分）
+- `LevelProgress` — 等级进度条（当前等级/下一级/进度百分比）

-### 前端工具
- 新增 `usePermission()` hook — 提供 `can(key)`, `canAny(keys)`, `canAll(keys)` 方法
- 侧边栏新增"角色权限"菜单入口
-
-### 种子脚本
- `scripts/seed-permissions.mjs` — 一键初始化全部权限点+角色
-
---
-
-## v0.10.1 (2026-05-22) - 全面修复与优化
-
-### 安全修复
- **Admin API 鉴权增强**: 中间件matcher新增`/api/admin/:path*`路由保护，未登录或非管理员角色返回403
- 所有关键admin路由已内置`requireAdmin()`双重校验（中间件+路由层防御深度）
-
-### Bug 修复
- **Category ID 动态化**: `skill-discoverer.ts`、`daily-discover.mjs`、`auto-review.mjs`三个文件的硬编码Category ID(120-127)替换为数据库查询+关键词匹配，消除分类错配风险
- **reviews统计卡片**: 修复评测管理页面统计（已发布/草稿/平均评分）只显示当前页数据的问题，改为从全局groupBy统计获取
- **内容生成日志完善**: `/api/admin/reviews/[id]/generate`成功和失败均写入`ReviewGenerationLog`
-
-### 功能增强
- **待审核技能编辑增强**: 编辑对话框新增"功能特性(JSON)"和"标签(逗号分隔)"输入框，支持直接编辑上传
- **已发布技能编辑增强**: 编辑对话框新增"分类"下拉选择、"功能特性(JSON)"、"标签"字段，功能对齐待审核页面
- **日报AI一键生成**: 新增`/api/admin/daily-reports/generate`端点，前端新增"一键AI生成"按钮，直接调用DeepSeek生成日报并自动填充表单，替代原有的"复制提示词→粘贴JSON"手动流程
-
-### 内部改进
- `ReviewGenerationLog`确认已在`skill-discoverer.ts`和两个脚本中正常使用，非僵尸表
- 三个脚本文件统一使用数据库查询获取分类ID，消除代码不一致
-
---
-
-## v0.10.0 (2026-05-20) - 五维评测系统
-
-### 新增
- **数据库扩展**: SkillReview模型(五维评测)、ReviewGenerationLog模型(评测日志)、ReviewStatus枚举(DRAFT/PUBLISHED/REJECTED/OUTDATED)
- **Skill模型扩展**: 新增lastReviewedAt(最近评测时间)、githubStarsHistory(Star历史)字段，关联skillReview
- **GitHub数据采集模块** (`src/lib/github.ts`): octokit封装，支持searchHotRepos搜索热门仓库、getRepoReadme获取README
- **DeepSeek评测生成模块** (`src/lib/deepseek.ts`): OpenAI兼容接口，五维评测提示词模板，综合分自动校验
- **自动化评测脚本** (`scripts/auto-review.mjs`): GitHub搜索→README获取→DeepSeek评测→入库全流程，每日限制8个
- **评测API** (`/api/skills/[slug]/review`): 获取PUBLISHED状态的五维评测数据
- **SkillReviewCard组件**: Chart.js雷达图+维度详情卡片，dynamic import(ssr:false)，紫色主色调
- **技能详情页集成**: 在标签卡片和评论之间展示五维评测雷达图
- **发布评测脚本** (`scripts/publish-reviews.mjs`): 批量将DRAFT评测改为PUBLISHED
- **测试脚本**: test-github.mjs(GitHub API)、test-deepseek.mjs(DeepSeek API)
- **新依赖**: octokit, openai, chart.js, react-chartjs-2
-
-### 修改
- .env新增GITHUB_TOKEN、DEEPSEEK_API_KEY配置
- 开发规则更新: 允许服务端脚本调用外部AI API，前端仍禁止
- 迁移记录: 第10次迁移 add_skill_reviews
-
-### 踩坑
- Prisma 7.8需通过PrismaMariaDb适配器初始化，脚本中不能直接new PrismaClient()
- Chart.js组件需dynamic import + ssr:false，不支持服务端渲染
- 服务器环境SSL证书问题: 运行脚本需设置$env:NODE_TLS_REJECT_UNAUTHORIZED="0"
- Chart.js font.weight只接受bold/normal/bolder/lighter，不接受数字字符串如"500"
-
---
-
-## v0.9.0 (2026-05-09)
-
-### 重大变更
- **移除所有外部AI API调用**: discover-tools、discover-skills、discover-news三个API不再调用DeepSeek API，改为接收前端提交的JSON数据
- **端口迁移**: 开发端口从3100-3110迁移至8301-8310，默认端口8301
- **五大操作指令模式重构**: 从"一键调用API"模式改为"提示词+JSON粘贴导入"模式
-
-### 新增
- AI新闻发现页面 `/admin/discover-news`：3步流程（复制提示词→粘贴JSON→查看日报），6大分类+热度评分
- AI新闻发现API `POST /api/admin/discover-news`：接收新闻JSON数组，自动生成今日AI日报
- AI新闻发现API `GET /api/admin/discover-news`：获取今日AI日报
- `fetchLogoWithMethod()` 函数：返回Logo URL + 成功方法名（如"HTML Link图标"、"OG/Twitter图片"等）
- 检测AI工具页面增加Logo抓取功能：检测时同步抓取缺失Logo，记录成功方法名统计
- 检测AI工具页面增加Logo抓取方法统计面板：按成功次数排序展示每种方法的效果
- 检测AI工具页面增加Logo新抓取成功列表：展示Logo预览和使用的抓取方法名
- 导入10天100条真实AI新闻（4月30日-5月9日）
-
-### 修改
- discover-tools API: 从调用DeepSeek API改为接收 `{tools: [...], categoryId}` JSON数组
- discover-skills API: 从调用DeepSeek API改为接收 `{skills: [...], categoryId}` JSON数组
- discover-tools页面: 从一键发现改为4步流程（选分类→复制提示词→粘贴JSON→抓取Logo）
- discover-skills页面: 从一键发现改为3步流程（选分类→复制提示词→粘贴JSON）
- discover-news页面: 从一键发现改为3步流程（复制提示词→粘贴JSON→查看日报）
- check-tools API: 增加Logo抓取功能，返回logoFetched/logoMethod/logoUrl字段，GET请求获取HTML用于Logo抓取
- check-tools页面: 默认选中待审核工具，4步流程卡片，增加Logo抓取方法统计和新抓取成功列表
- update-skills页面: 去掉复制提示词，保留快速更新Star
- logo-fetcher.ts: 新增 `fetchLogoWithMethod()` 导出，每种成功方法返回中文名称
- package.json: 端口3100→8301
- .env: NEXTAUTH_URL端口3100→8301
- restart.ps1: 端口扫描范围3100-3110→8301-8310
- project_rules.md: 端口规范8301-8310，新增强制要求；五大操作指令改为提示词+JSON粘贴模式；禁止硬编码API Key；禁止调用外部AI API
-
-### 删除
- 移除3个API文件中的DeepSeek API调用逻辑（硬编码API Key、callDeepSeek函数等）
- 移除discover-tools页面的"一键发现"按钮和DeepSeek API调用
- 移除discover-skills页面的"一键发现"按钮和DeepSeek API调用
- 移除discover-news页面的DeepSeek API调用
- 清除旧的虚构AI新闻数据
-
---
-
-## v0.8.0 (2026-05-05)
-
-### 新增
- 用户系统：邮箱注册/登录、GitHub OAuth登录、用户中心页面
- 收藏功能：工具/技能收藏、收藏列表页面、乐观更新按钮
- 浏览历史：自动记录浏览过的工具/技能
- 评论评价系统：ReviewSection组件，支持评分和文字评论
- LoginModal组件：登录/注册弹窗，支持模式切换
- FavoriteButton组件：收藏按钮，乐观更新
- CategorySidebar组件：通用分类侧边栏
- 用户API: `/api/user/favorites`, `/api/user/history`
- 评论API: `/api/reviews`
- 首页API: `/api/homepage`（含嵌套分类结构）
-
-### 改进
- **UI主题重构：暗色→浅色主题**
-  - 全局CSS变量从暗色切换为浅色（background: 210 20% 98%, card: 0 0% 100%等）
-  - 所有页面和组件适配浅色主题（7个前台页面+12个后台页面+5个组件）
-  - 颜色规范：文字-600/-700、背景-50、边框-200/60
-  - 卡片样式：bg-white/60/80 + shadow-sm，hover时bg-white + shadow-md
-  - 输入框：bg-muted/50 focus:bg-white focus:ring-2 focus:ring-primary/10
-  - 毛玻璃效果：bg-white/80 backdrop-blur-xl
-  - 渐变文字：蓝→紫→粉渐变保持科技感
-  - 移除noise纹理，新增dot-grid点阵背景
- **层级分类导航重构**
-  - 首页/技能页：左侧固定一级分类导航 + 右侧二级分类标签切换
-  - 每个一级类目下有"全部"标签显示该分类下所有内容
-  - 左侧导航sticky跟随页面滚动
- **安全加固**
-  - 新增admin-auth.ts中间件，requireAdmin函数
-  - 28个后台API端点全部添加requireAdmin中间件验证
-  - 移除硬编码API密钥，改用环境变量
- Header组件：滚动时bg-white/80 backdrop-blur-2xl，搜索框bg-muted/50
- Logo位置修复：Header容器宽度统一为max-w-[1440px]
+### 🔧 技术改进
+- **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 页面增强** — 积分进度条/积分明细/统计卡片

 ### 修复
- 修复webpack缓存损坏导致的页面加载失败（清除.next目录）
- 修复左侧导航栏sticky定位不生效（flex容器添加self-start）
- 修复Logo被左侧导航遮挡（统一容器宽度）
+- ForumPost 新增 `isAnswer` 字段（标记最佳回答）
+- Prisma schema 日期默认值修正 `@default(now)` → `@default(now())`
+- 迁移兼容问题处理（`prisma db push` 同步）
+
+### 统计数据（本次新增）
+- **新增文件**: 15个
+- **新增API端点**: 15个
+- **新增页面**: 3个
+- **新增组件**: 8个
+- **新增数据模型**: 1个（PointsHistory）

 ---

-## v0.5.0 (2026-05-03)
-
-### 新增
- 待审核工具页面批量多选功能：全选/批量通过/批量拒绝
- 待审核技能页面批量多选功能：全选/批量通过/批量拒绝
- 待审核技能一键全部通过功能
- 所有列表页面分页功能（每页20条）
- 批量拒绝API: `/api/admin/pending/batch-reject`, `/api/admin/pending-skills/batch-reject`
- 一键全部发布API: `/api/admin/pending-skills/publish-all`
- AI技能自动探索API: `/api/admin/discover-skills/run`
- 探索脚本存入系统配置，discover-skills页面展示脚本和调用说明
- 一键自动探索按钮（服务端调用DeepSeek API）
- Logo抓取策略改进：新增manifest.json解析、更多link/img匹配模式、图片URL验证
- 工具库与脚本模块文档: `.trae/specs/modules/07-lib-and-scripts.md`
-
-### 改进
- Logo抓取引擎增强：6种策略按优先级，minFileSize降至50字节，timeout增至10秒
- 待审核工具页面：新增Logo状态列、Logo筛选、抓取缺失Logo/重新抓取全部Logo按钮
- 待审核技能页面：新增Star数展示、GitHub链接、分类标签
- pending API和pending-skills API支持分页参数
- 技术文档全面更新（7个模块文档+索引+开发规则+变更日志）
-
---
-
-## v0.4.0 (2026-05-02)
-
-### 新增
- 系统配置页面：Logo抓取配置、发现提示词配置
- 四个AI发现菜单：探索AI工具、检测AI工具、探索Skill技能、更新Skill技能
- AI技能发现脚本 `scripts/discover-skills.mjs`
- GitHub中文友好判断标准（4步标准）
- 技能分类管理页面
- DeepSeek V4 Pro API配置
-
-### 改进
- 配置驱动模式：提示词和Logo抓取策略存储在SystemConfig表
- 去掉DeepSeek API配置功能，改为配置项驱动
- 技能发现提示词优化
-
---
-
-## v0.3.0 (2026-05-01)
-
-### 新增
- 技能库模块：Skill/PendingSkill数据模型、API、管理页面
- API接口配置：ApiProvider数据模型和管理页面
- 发现配置：DiscoveryConfig与分类管理集成
- 公共Logo抓取工具 `src/lib/logo-fetcher.ts`
- 服务重启脚本 `restart.ps1`
-
-### 改进
- 去除爬虫功能，改为AI发现模式
- UI全面优化：暗色主题、毛玻璃效果、动画
- 端口从3000改为3100
-
---
-
-## v0.2.0 (2026-04-30)
-
-### 新增
- 后台管理页面：工具管理、分类管理、待审核工具
- NextAuth认证系统
- Prisma ORM + MySQL数据库
- AI智能发现新工具功能（DeepSeek API）
- 批量导入工具脚本
-
---
-
-## v0.1.0 (2026-04-28)
-
-### 新增
- Next.js 14项目初始化
- Tailwind CSS + shadcn/ui配置
- 前台页面：首页、工具列表、工具详情、分类页
- Header/Footer布局组件
+## 2026-05-24 全面技术文档生成
+（详见历史 CHANGELOG 记录）