智能小说阅读平台 (AI-Powered Fiction Reading Platform)

🌟 项目介绍

基于Spring Boot构建的现代化中文小说阅读平台，集成先进的AI智能问答系统，提供智能化阅读体验。

• 在线体验: https://bookstore.lingjingwanxiang.cn
• 核心特色: AI智能问答 + 个性化推荐 + 智能搜索
• 技术栈: Spring Boot 3.1.12 + MyBatis Plus + AI/LLM + MySQL 8.0

如果对你有用，请给个小星星吧！⭐

🚀 GitOps 自动部署

此项目采用现代化 GitOps 实践，通过 Argo CD + Helm 实现完整的自动化部署到 Kubernetes。

部署流程

1. 代码提交 → Git 仓库（ljwx-bookstore）
2. 镜像构建 → Docker 构建应用镜像
3. 镜像推送 → 推送到 Harbor 私有仓库（harbor.omniverseai.net:8080/ljwx/ljwx-bookstore）
4. Argo CD Application → 在 ljwx-deploy 仓库创建 Application 配置
5. 自动同步 → Argo CD 检测 Helm 配置变更，自动同步到 Kubernetes
6. Flyway 迁移 → 启动时自动执行数据库 schema 迁移
7. 滚动更新 → 零停机滚动更新，保证服务连续性
8. 健康检查 → Liveness/Readiness Probe 验证应用状态

部署状态

• ✅ Gitea Workflow: 完整的 CI/CD 流程（test → build → deploy）
• ✅ Helm Chart: v0.1.0 标准化配置
• ✅ Harbor 镜像仓库: 私有镜像 + Proxy Cache 模式
• ✅ Flyway 迁移: 自动化数据库 schema 管理（已验证 baseline 策略）
• ✅ Argo CD GitOps: 声明式自动部署（ljwx-deploy 仓库）
• ✅ 跨 Namespace 服务: bookstore → infra（MySQL + Redis）
• ✅ 零停机更新: 滚动更新 + 健康检查
• ✅ HTTPS 访问: Let's Encrypt 自动证书
• ✅ 可观测性: Prometheus + OpenTelemetry + 结构化日志

访问地址

• 应用主页: https://book.omniverseai.net
• 健康检查: https://book.omniverseai.net/actuator/health
• 命名空间: bookstore
• GitOps 仓库: ljwx-deploy
• 镜像仓库: harbor.omniverseai.net:8080/ljwx/ljwx-bookstore

部署架构

Git Repository (ljwx-bookstore)
    ├── Application Code
    ├── Helm Chart (./helm)
    └── K8s Manifests (./k8s)
         ↓
Harbor Registry (harbor.omniverseai.net:8080)
    ├── ljwx/ljwx-bookstore:latest    # 业务镜像
    └── library/*                      # 基础镜像（3rd party）
         ↓
ljwx-deploy (GitOps Repo)
    └── argocd/applications/ljwx-bookstore.yaml
         ↓
Argo CD (GitOps Controller)
    ↓
Kubernetes Cluster
┌─────────────────────────────────────────────┐
│ bookstore namespace                         │
│  ├── Deployment (2 replicas)                │
│  ├── Service (ClusterIP :8080)              │
│  ├── Ingress (nginx + HTTPS)                │
│  ├── ConfigMap (app config)                 │
│  └── Secret (database password)             │
└─────────────────────────────────────────────┘
         │ (跨 namespace 服务访问)
         ↓
┌─────────────────────────────────────────────┐
│ infra namespace                             │
│  ├── MySQL 8.0 (mysql-infra:3306)          │
│  │   └── org_fiction database              │
│  └── Redis 7.x (redis-infra-master:6379)   │
└─────────────────────────────────────────────┘

基础设施

• Kubernetes: K8s 1.25+
• GitOps: Argo CD
• Package Manager: Helm 3.x
• Ingress Controller: Nginx Ingress
• Certificate Manager: cert-manager + Let's Encrypt
• Container Registry: Harbor (Proxy Cache 模式)
• 数据库: MySQL 8.0 (infra namespace, 自动备份到 MinIO)
• 缓存: Redis 7.x (infra namespace)
• 数据库迁移: Flyway (自动化 schema 管理)

🚀 核心功能

📱 移动端应用 (Flutter) - 全新上线！

核心特性:

• 📲 跨平台支持: iOS + Android 原生体验
• 🎨 精美UI设计: Material Design 3 设计规范，GetX 状态管理
• 📖 流畅阅读: 优化的阅读器，支持字体调整、夜间模式
• 📚 书架管理: 收藏、阅读历史自动同步
• 🔍 智能搜索: 支持小说名、作者、类型快速检索
• 💾 离线缓存: 章节本地缓存 (SQLite)，随时随地阅读
• 🔄 实时同步: 与Web端数据完全同步

技术架构:

• Flutter SDK: 3.x
• 状态管理: GetX 4.x
• 网络请求: Dio + ApiResponse 统一封装
• 本地存储: SQLite (sqflite) + SharedPreferences
• 图片缓存: cached_network_image
• UI组件: Material Design 3

移动端部署:

# iOS 部署 (需要 macOS + Xcode 15+)
cd flutter_app
flutter clean && flutter pub get
cd ios && pod install && cd ..
flutter run -d <device-id>

# Android 部署
cd flutter_app
flutter clean && flutter pub get
flutter run -d <device-id>

# 构建发布包
flutter build ipa      # iOS
flutter build apk      # Android
flutter build appbundle  # Android App Bundle

已验证设备:

• ✅ iPad Mini 6 (iOS 18.1+)
• ✅ iPhone 系列
• ✅ Android 设备

移动端文档:

• iOS 部署指南: iOS 真机部署完整流程
• 部署到设备: iOS/Android 设备部署说明
• Xcode 配置: Xcode 项目配置指南
• 部署检查清单: 部署前检查项
• 移动端 API 指南: 移动端专用 JSON API 文档

📚 Web端功能

• 📖 小说阅读与章节浏览
  • 自适应宽度设计，充分利用大屏幕空间（2026-01-10优化）
  • 最大宽度1400px，宽度90%自动居中
  • 优化字体大小（18px）和行距（2.2）提升阅读体验
• 📚 个人书架管理
• 🔍 小说搜索与分类浏览
• 👤 用户注册登录
• 💬 评论与互动
• 📱 响应式设计
• 🖼️ 智能封面管理 (新增 2026-01-10)
  • 自动从起点中文网搜索并更新封面URL
  • 使用Selenium浏览器自动化绕过反爬虫
  • 支持单本更新和批量更新（234本）
  • 实时进度监控，预计90-110分钟完成全量更新
  • 直接使用起点CDN链接，无需本地存储图片

🤖 AI智能功能 (已集成)

• 🤖 悬浮式AI助手: 全局智能聊天助手，实时响应用户问题
  • 右下角悬浮按钮，随时唤起
  • 智能对话界面，支持快捷操作
  • 基于 lingjingwanxiang:32b 本地模型
  • 个性化推荐和阅读建议
• 🧠 AI智能问答: 基于小说内容的智能问答系统，支持流式响应
• 📝 AI章节摘要: 智能生成章节内容摘要（已修复，2026-01-10）
  • 统一使用 lingjingwanxiang:32b (30.5B参数) 模型
  • 自动生成关键事件、人物、情节要点
  • 响应时间优化：平均 6-8 秒
  • 支持短摘要（100字）、中摘要（300字）、长摘要（500字）
• 🎯 语义搜索: 支持自然语言的智能搜索，混合 BM25 + 向量检索
• 🔗 相似发现: 发现相似风格和主题的小说
• ⚡ 实时分析: 阅读进度智能分析和建议

🎯 智能推荐系统 (V3.0.0 - 已完成)

基于ChatGPT-5.2设计的多维度个性化推荐系统，提供可解释的智能推荐体验：

• 📊 多维度用户画像 (4层体系)

  • 基础层：年龄、性别、地域
  • 兴趣层：类型偏好、标签偏好、作者偏好
  • 能力层：阅读速度、完读率、弃书率
  • 行为层：活跃时间、阅读场景、互动行为

• 🎯 四层推荐架构

  • 规则过滤：内容质量、合规性检查
  • 多路召回：兴趣40% + 协同30% + 向量20% + 热门10%
  • 排序打分：兴趣匹配、质量评分、新鲜度、热度
  • 可解释性：详细推荐理由和匹配因子

• 🌟 场景化推荐

  • 书荒场景（hungry）：完本高质量作品
  • 睡前场景（sleep）：轻松休闲小说
  • 追更场景（update）：连载中热门作品
  • 新书场景（new）：最新上架小说

• 📈 行为埋点跟踪

  • 阅读行为：章节阅读时长、完读率
  • 收藏行为：加入书架、移除书架
  • 搜索行为：搜索关键词、点击反馈
  • 实时画像更新，精准推荐

• 📖 智能摘要: 章节摘要、全书摘要（规划中）

• 👤 人物分析: 人物画像、关系分析（规划中）

🏗️ 技术架构

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   前端展示层    │    │    AI服务层      │    │   数据存储层    │
│  - Thymeleaf   │◄──►│  - RAG系统      │◄──►│  - MySQL 8.0   │
│  - 响应式UI    │    │  - 向量搜索     │    │  - OpenSearch  │
│  - 用户交互    │    │  - LLM集成      │    │  - FAISS       │
└─────────────────┘    └──────────────────┘    └─────────────────┘

核心技术栈:

• 后端框架: Spring Boot 3.1.12, MyBatis Plus 3.5.7
• Java版本: JDK 21+ (LTS版本，性能优化)
• AI/LLM:
  • Ollama (本地部署，lingjingwanxiang:32b 30.5B参数模型)
  • OpenAI API (备用云端方案)
  • BGE-M3 embeddings (文本向量化)
• 搜索引擎: OpenSearch (BM25全文搜索) + FAISS (向量相似度搜索)
• 数据库: MySQL 8.0 + Flyway迁移
• Web爬虫: JSoup + HtmlUnit (支持多站点抓取)

🖼️ 界面展示

📱 用户界面

• 登录页面: 用户认证与安全管理
• 个人书架: 个性化阅读管理
• 小说详情: 丰富的元数据展示
• 章节阅读: 优化的阅读体验
• 智能搜索: AI驱动的搜索体验

🤖 AI功能演示

• 智能问答: AI助手解答小说相关问题
• 推荐系统: 基于阅读偏好的智能推荐
• 相似发现: 发现相似主题和风格的小说

🛠️ 快速开始

环境要求

Java: JDK 21+
Maven: 3.8.1+
MySQL: 8.0+
Python: 3.8+ (用于AI模型)
Docker: 20.10+ (可选)

本地部署

# 1. 克隆项目
git clone https://github.com/BrunoGaoSZ/ljwx-bookstore.git
cd ljwx-bookstore

# 2. 配置数据库
# 创建数据库 org_fiction
mysql -u root -p -e "CREATE DATABASE org_fiction CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# 导入 Schema（52 张表）
mysql -u root -p org_fiction < deploy/sql/schema.sql

# 3. 配置连接（可选，默认配置在 application.properties）
# MySQL: jdbc:mysql://127.0.0.1:3306/org_fiction
# Redis: 127.0.0.1:6379

# 4. 启动应用（⚠️ 必须使用 start.sh）
./start.sh

# ⚠️ 重要说明：
# - start.sh 会自动检查Java版本、清理编译缓存、强制重新编译、验证关键文件
# - start.sh 会自动使用正确的数据库配置（application-local.yml）
# - 直接使用 mvn spring-boot:run 可能导致数据库连接失败或使用旧代码
# - 除非你明确知道自己在做什么，否则请始终使用 start.sh

# 5. 访问应用
# 主页: http://localhost:8844/fiction/index
# AI 问答: http://localhost:8844/fiction/ai/qna
# AI 推荐: http://localhost:8844/fiction/ai-search/recommend
# 健康检查: http://localhost:8844/fiction/actuator/health
# API 文档: http://localhost:8844/swagger-ui/index.html

# 6. 封面管理（可选）
# 更新小说封面到起点CDN（需要Python环境）
pip3 install selenium requests beautifulsoup4

# 单本更新
curl -X POST "http://localhost:8844/fiction/sys/qidian-cover/update-single/555"

# 批量更新所有小说（约90-110分钟）
curl -X POST "http://localhost:8844/fiction/sys/qidian-cover/update-all"

# 监控更新进度
./scripts/monitor_cover_update.sh

# 详细文档见 scripts/README_COVER_UPDATE.md

Kubernetes 部署（推荐）

快速开始（详见 QUICK_DEPLOY.md）:

# 1. 前置条件
kubectl create namespace bookstore

# 创建 Harbor 镜像拉取凭证
kubectl create secret docker-registry harbor-registry \
  --docker-server=harbor.omniverseai.net:8080 \
  --docker-username=admin \
  --docker-password=<harbor-password> \
  --namespace=bookstore

# 2. 构建并推送镜像到 Harbor
docker build -t harbor.omniverseai.net:8080/ljwx/ljwx-bookstore:latest .
docker push harbor.omniverseai.net:8080/ljwx/ljwx-bookstore:latest

# 3. 使用 Helm 部署（方式 1）
helm upgrade --install bookstore ./helm \
  --namespace bookstore \
  --create-namespace \
  --values ./helm/values.yaml \
  --wait --timeout 10m

# 或使用 Argo CD 部署（方式 2，推荐）
# 在 ljwx-deploy 仓库创建 Application:
kubectl apply -f argocd/applications/ljwx-bookstore.yaml -n argocd
argocd app sync ljwx-bookstore --prune

# 4. 验证部署
kubectl get pods -n bookstore        # 等待 2/2 Running
kubectl get ingress -n bookstore     # 查看 Ingress 配置
curl https://book.omniverseai.net/actuator/health  # 验证健康状态

部署文档:

• 快速部署指南: QUICK_DEPLOY.md - 10-15分钟快速上手
• 详细部署清单: K8S_DEPLOYMENT_CHECKLIST.md - 完整验证步骤
• 配置变更总结: INFRA_INTEGRATION_SUMMARY.md - 技术细节
• Harbor 验证报告: HARBOR_VERIFICATION_REPORT.md - 镜像拉取验证
• 镜像路径规范: IMAGE_REGISTRY_CONVENTION.md - Harbor 路径标准

关键配置:

• 镜像路径: harbor.omniverseai.net:8080/ljwx/ljwx-bookstore:latest
• 数据库: mysql-infra.infra.svc.cluster.local:3306/org_fiction
• Redis: redis-infra-master.infra.svc.cluster.local:6379
• Flyway: 自动执行 src/main/resources/db/migration/ 下的迁移脚本
• 域名: book.omniverseai.net (自动 HTTPS)

AI系统部署

# 1. 启动Ollama服务（本地LLM）
ollama serve

# 2. 拉取lingjingwanxiang:32b模型
ollama pull lingjingwanxiang:32b

# 3. 启动搜索服务（可选，用于向量搜索）
docker-compose -f docker-compose-search.yml up -d

# 4. 构建AI索引（可选）
curl -X POST http://localhost:8088/sys/build-ai-index

# 5. 测试AI功能
# 智能搜索
curl "http://localhost:8088/ai-search/search?query=仙侠小说推荐"

# AI章节摘要（示例：章节ID 266263）
curl "http://localhost:8844/fiction/api/ai/summary/chapter/266263?type=short"

# 个性化推荐
curl "http://localhost:8844/fiction/api/recommend/personalized?userId=1&limit=10"

📚 技术文档

AI 系统文档:

• AI系统架构: 完整的AI系统设计方案
• Week 1实施总结: 基础设施搭建完成情况

K8s 部署文档:

• 快速部署指南: 10-15分钟快速部署到K8s
• 部署验证清单: 完整的前置检查和验证步骤
• 配置变更总结: infra namespace 集成技术细节
• Harbor 验证报告: 镜像仓库拉取验证
• 镜像路径规范: Harbor 镜像路径标准

CI/CD 文档:

• Gitea Workflow 最佳实践: Gitea Actions + Flyway + GitOps 完整实践指南
• CI/CD 配置: Gitea Actions 配置说明

开发文档:

• 开发指南: 面向开发者的详细文档
• [API文档]: Swagger UI - /swagger-ui/index.html (SpringDoc OpenAPI)

运维配置文档:

• 爬虫调度器配置: 定时任务配置与启动优化指南
  • 禁用启动时自动抓取小说
  • 定时任务执行时间配置
  • 配置化控制启用/禁用
• 启动日志优化: 启动日志优化方案
  • 减少87%的冗余日志输出
  • 本地开发使用简洁文本格式
  • 生产环境保持JSON格式
• 管理后台UI统一: 管理后台界面风格统一
  • 统一为白色侧边栏设计
  • 提升视觉一致性和用户体验
  • 优化布局和间距

内容管理文档:

• 封面更新指南: 起点封面自动更新使用说明
  • Python + Selenium爬虫实现
  • RESTful API使用方法
  • 进度监控和故障排查

🔧 项目特色

🚀 技术亮点

• AI驱动: 集成先进的RAG (检索增强生成) 系统
• 混合搜索: BM25 + 向量搜索的智能检索
• 实时爬虫: 支持多源头的自动化内容抓取
• 高可用: 微服务架构，支持水平扩展
• 企业级: 完整的监控、审计和合规体系

📊 性能指标

• 响应时间: AI问答 P95 < 3s
• 并发支持: 1000+ 用户
• 搜索精度: Citation Recall@5 ≥ 0.8
• 可用性: 99.9%

🛡️ 安全合规

• 内容过滤: 自动化敏感内容识别
• 审计日志: 完整的操作记录追踪
• 权限控制: 细粒度的访问管理
• 成本控制: AI服务调用量限制

🌐 在线演示

• 应用主页: https://bookstore.lingjingwanxiang.cn
• 小说首页: https://bookstore.lingjingwanxiang.cn/fiction/index
• 健康检查: https://bookstore.lingjingwanxiang.cn/fiction/actuator/health
• AI搜索: https://bookstore.lingjingwanxiang.cn/ai-search/search

注意: 当前部署使用自签名证书，浏览器可能提示安全警告。

📈 项目状态

• ✅ 基础功能: 100% 完成
• ✅ GitOps 部署: 100% 完成（Argo CD + Helm）
• ✅ Kubernetes 生产环境: 100% 完成（K8s 1.25+ + Nginx Ingress + cert-manager）
• ✅ Harbor 私有镜像仓库: 100% 完成（Proxy Cache 模式）
• ✅ infra namespace 集成: 100% 完成（共享 MySQL + Redis）
• ✅ Flyway 数据库迁移: 100% 完成（自动化 schema 管理）
• ✅ HTTPS 访问: 100% 完成（Let's Encrypt 自动证书）
• ✅ 数据库: MySQL 8.0 (infra namespace, 自动备份到 MinIO) + Redis 7.x
• ✅ AI基础设施: 100% 完成 (Week 1)
• ✅ AI前端集成: 100% 完成 (2025-12-25)
  • ✅ 首页 AI 智能推荐区域
  • ✅ AI 智能问答页面 (/fiction/ai/qna)
  • ✅ 智能搜索 API 集成
  • ✅ 相似书籍推荐
  • ✅ JavaScript API 客户端 (ai-client.js)
  • ✅ 统一 UI 组件库 (ai-components.js)
• ✅ PROMPT_BLUEPRINT 合规性: 100% 完成 (2025-12-26)
  • ✅ 安全合规: 13个密钥迁移到K8s Secret，零硬编码
  • ✅ OpenAPI文档: 19个Controller全部注解，Swagger UI完整
  • ✅ 分布式追踪: OpenTelemetry Java Agent集成，trace_id贯穿全链路
  • ✅ 结构化日志: JSON格式 + trace_id，支持Loki查询
  • ✅ Prometheus Metrics: AI服务指标、业务指标全覆盖
  • ✅ 测试框架: 68个测试用例，覆盖率>50%（Mockito + AssertJ + Testcontainers）
  • ✅ 配置管理: 19个环境变量支持，12-Factor App合规
  • ✅ GitOps验证: 完整部署文档和验证流程
• ✅ K8s 生产部署配置: 100% 完成 (2025-12-27)
  • ✅ Helm Chart v0.1.0: 完整的 K8s 资源定义
  • ✅ infra namespace 集成: 使用共享 MySQL + Redis 服务
  • ✅ Harbor 镜像仓库: 业务镜像（ljwx/）与基础镜像（library/）分离
  • ✅ Flyway 自动迁移: 启动时自动执行 schema 迁移
  • ✅ 跨 namespace 服务访问: bookstore → infra
  • ✅ 完整部署文档: 快速部署、验证清单、配置总结、Harbor验证
• ✅ 最新优化 (2026-01-10):
  • ✅ AI章节摘要功能修复
    • 统一模型配置为 lingjingwanxiang:32b (30.5B参数)
    • RestTemplate超时优化（连接30秒，读取300秒）
    • JSON反序列化优化（@JsonAlias注解支持snake_case映射）
    • Result类构造函数完善（支持3参数）
  • ✅ 阅读体验优化
    • 章节阅读页面自适应宽度（最大1400px，90%宽度）
    • 字体和行距优化（18px字号，2.2行距）
    • AI摘要区域自适应（最大1200px）
  • ✅ Bug修复
    • 修复"最近阅读"下拉菜单Thymeleaf模板渲染问题
    • 修复"加入书架"功能404错误（移除冲突的@ResponseBody注解）
  • ✅ 智能封面管理系统
    • 创建Python + Selenium爬虫脚本自动搜索起点中文网
    • 实现Java调用Python脚本的进程管理和输出解析
    • 修复JsoupUtil HTTP 202状态码支持
    • 提供RESTful API：单本更新、批量更新、状态查询
    • 实时进度监控脚本（每5秒刷新，进度条显示）
    • 完整文档：使用指南和API说明 (scripts/README_COVER_UPDATE.md)
• ✅ 移动端应用 (Flutter): 100% 完成 (2026-01-18)
  • ✅ iOS + Android 跨平台支持
  • ✅ Material Design 3 UI 设计
  • ✅ GetX 状态管理
  • ✅ SQLite 本地缓存
  • ✅ 完整的阅读、搜索、书架功能
  • ✅ 与 Web 端数据完全同步
  • ✅ iPad Mini 6 真机验证通过
• 🚧 AI高级功能: 进行中
  • ✅ 智能摘要（章节摘要已完成）
  • 📋 智能摘要（全书摘要）
  • 📋 人物分析（画像、关系图谱）
  • 📋 情节分析、主题分析
• 📋 计划中: 知识图谱可视化

🤝 贡献指南

欢迎贡献代码、提出建议或报告问题！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 开源协议

本项目采用 MIT 协议 - 查看 LICENSE 文件了解详情。

📝 更新日志

2026-01-18 - 移动端应用 (Flutter) 正式发布

• ✅ Flutter 移动端应用完成: iOS + Android 双平台支持
• ✅ 完整功能实现: 小说浏览、搜索、阅读、书架管理
• ✅ 离线缓存: SQLite 本地存储，章节内容缓存
• ✅ 阅读体验优化: Material Design 3，支持字体调整、夜间模式
• ✅ 状态管理: GetX 4.x 响应式状态管理
• ✅ 网络请求: Dio + 统一 ApiResponse 封装
• ✅ 真机验证: iPad Mini 6 (iOS 18.1+) 验证通过
• ✅ API 集成: 与 Spring Boot 后端完全对接
  • 修复章节列表数据解析（nested structure）
  • 修复章节内容读取（nested chapter ID）
  • 添加移动端专用 JSON API 端点
• ✅ 部署文档: 完整的 iOS/Android 部署指南

2026-01-10 - AI功能修复、用户体验优化与智能封面管理

• ✅ 修复AI章节摘要功能，统一使用lingjingwanxiang:32b模型
• ✅ 优化章节阅读页面，支持自适应宽度（最大1400px）
• ✅ 修复"最近阅读"下拉菜单显示问题
• ✅ 修复"加入书架"功能404错误
• ✅ 优化字体大小和行距，提升阅读体验
• ✅ 新增智能封面管理系统
  • Python + Selenium自动爬取起点中文网封面
  • RESTful API支持单本/批量更新
  • 实时进度监控和完整使用文档
  • 已更新43/234本（18.4%），使用起点CDN直链

2025-12-27 - K8s生产部署配置完成

• ✅ Helm Chart v0.1.0发布
• ✅ Harbor镜像仓库集成
• ✅ Flyway自动迁移
• ✅ 跨namespace服务访问

2025-12-26 - PROMPT_BLUEPRINT合规性达标

• ✅ 安全合规：13个密钥迁移到K8s Secret
• ✅ OpenAPI文档：19个Controller全部注解
• ✅ 分布式追踪：OpenTelemetry集成
• ✅ 测试框架：68个测试用例

2025-12-25 - AI前端集成完成

• ✅ AI智能问答页面
• ✅ 首页智能推荐区域
• ✅ JavaScript API客户端
• ✅ 统一UI组件库

---

⭐ 如果这个项目对你有帮助，请给个Star支持一下！