# 追光AI 变更日志

## v0.11.1 (2026-05-22) - AI发现管线质量优化

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

### 质量过滤修复
- **非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

### JSON解析健壮性
- 新增 `extractJSON()` 统一工具函数 → `src/lib/utils.ts`
- 支持markdown代码块包裹(`\`\`\`json...\`\`\``)、花括号/方括号容错
- 替换 deepseek.ts、auto-review.mjs、daily-discover.mjs、daily-reports/generate 的旧解析逻辑
- 新增 `scripts/test-content-generation.mjs` 全管线测试脚本

### 新增脚本
- `scripts/cleanup-non-ai.mjs` — 一键清理误入库非AI技能数据

---

## v0.11.0 (2026-05-22) - 权限体系重构

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

### 权限体系
- **53个精细化权限点**，按页面分组管理：
  - 工具管理 14项 · 技能库 12项 · 评测管理 8项
  - AI发现 7项 · 内容管理 8项 · 系统管理 4项
- 所有后台按钮/操作均已对应权限点，可逐个勾选控制

### 新增页面
- **`/admin/roles` 角色权限管理**: 左侧角色列表 + 右侧按分组的权限勾选网格
  - 新建/删除自定义角色（系统角色受保护）
  - 分组全选/取消全选
  - 保存按钮实时同步到数据库

### 新增 API
- `GET/POST /api/admin/roles` — 角色列表/创建
- `PUT/DELETE /api/admin/roles/[id]` — 角色编辑/删除
- `GET /api/admin/permissions` — 全部权限点列表
- `GET /api/admin/user-permissions` — 用户权限查询(支持roleId/userId/当前用户)

### 鉴权升级
- **middleware.ts**: 从硬编码 `role==="admin"` 改为认证检查 + 路由层委派
- **admin-auth.ts**: `requireAdmin()` 兼容旧 `role` 字符串 + 新 `roleId` 关联角色双重逻辑
- 新增 `requirePermission(key)` — 细粒度权限点校验
- 新增 `getAllUserPermissions()` — 获取当前用户全部权限集合

### 前端工具
- 新增 `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]

### 修复
- 修复webpack缓存损坏导致的页面加载失败（清除.next目录）
- 修复左侧导航栏sticky定位不生效（flex容器添加self-start）
- 修复Logo被左侧导航遮挡（统一容器宽度）

---

## 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布局组件