Lampio 知识库

主题

Changelog ​

本文件记录 Lampio Admin 的版本变更历史。

格式参考: Keep a Changelog

[0.2.0] - 2026-06-16 ​

Added — 推荐系统运营后台（对接 RB 推荐 agent 化 Phase 1+2 治理表） ​

  • 运营监控页 /admin/observability（force-dynamic，6 Tab）：运行历史、审计日志（展开 score_detail 多维分）、LLM 调用、池健康（含月预算燃尽率）、成本/报告（Recharts：成本趋势/发现漏斗/质量分布）、复核队列
  • 配置管理页改造：recommend_config 阈值表单（写单行 id=1）、黑名单管理（增删）、手动触发 Edge Function（dry-run 默认 + 真实执行二次确认）、Edge 健康状态
  • 推荐管理 Sites Tab 新增置顶（pin）列
  • 人工治理：复核队列 批准(pin)/否决(停用+黑名单)、撤销恢复（重新激活 + 重置存活期 + 删黑名单）、OPML 导出
  • 数据层读 5 张 service-only 治理表（llm_call_log / edge_run_log / recommend_audit_log / recommend_config / recommended_blocklist）；新 Server Action app/actions/recommend-config.ts

Changed ​

  • settings 页由静态改为 force-dynamic（读写 recommend_config + 黑名单 + edge 健康）
  • observability 页一次加载共享 config/sites 快照，消除重复查询（config 3→1、sites 4→1）

Docs ​

  • CLAUDE.md §1/§7、docs/architecture.md §7、docs/database.md 同步治理表 + 新路由 + recommended_sites 新列（is_pinned/admitted_at/cefr_band）

[0.1.0] - 2026-04-13 ​

Added — Phase 1: 项目搭建 + Dashboard + Landing Page ​

  • Next.js 15 项目初始化（TypeScript strict, Tailwind CSS 4, shadcn/ui）
  • Supabase 客户端配置（server: service_role, client: anon）
  • Admin Auth 守卫（email 白名单）+ 登录页
  • Dashboard 概览页（4 统计卡片 + 最近推荐文章）
  • Landing Page（Hero + Features + Footer）

Added — Phase 2: 推荐内容管理 + 配置管理 ​

  • 推荐管理页（Sites / Feeds / Articles 三 Tab）
  • Sites/Feeds: 搜索、筛选、is_active 开关（Server Actions）
  • Articles: CEFR 分布饼图（Recharts）
  • 配置管理页（4 张配置卡片 + 修改指引）

Added — Phase 3: 用户 & 学习数据分析 ​

  • 用户分析 Tab（注册趋势折线图、平台分布饼图）
  • 学习数据 Tab（每日新增/复习柱状图、CEFR 分布、阅读来源分布、热门查词 TOP 20）
  • 9 个聚合查询（隐私优先，仅 COUNT/AVG/GROUP BY）

Added — Phase 4: 词库质量管理 ​

  • 词库仪表盘（总量/已分级/PENDING 统计 + CEFR 柱状图）
  • 搜索词库（前缀匹配）+ 词条表格
  • 编辑单词 CEFR 等级（Dialog）
  • 批量设置 CEFR 等级

Fixed ​

  • 词库页 pos_definitions 过大导致 Vercel 渲染失败 → 服务端截断 + force-dynamic
  • 登录页错误信息不具体 → 显示详细错误
  • Vercel 环境变量未持久化 → 通过 vercel env add 配置

Infrastructure ​

  • GitHub 仓库: ttfishnet/lampio（monorepo，admin/ subtree；原独立仓 readvocab-admin 已归档）
  • Vercel 部署: lampio-admin.vercel.app（Vercel 项目待改名）
  • Supabase RPC: get_user_count, get_registration_trend
  • 项目文档体系: CLAUDE.md + docs/ + 3 个 skills