当大语言模型遇见实时资讯，新闻阅读不再只是「看」，而是「理解」。
一、平台概览
Toutiao AI 是一个基于大语言模型（LLM）的智能新闻聚合与分析平台。它从聚合数据 API 实时获取新闻，通过 DeepSeek / Moonshot 等 AI 模型进行深度内容分析，自动生成结构化、可视化的新闻解读页面，为读者提供超越传统新闻阅读的沉浸式体验。
平台分为两大核心部分：
- 前台阅读端：面向读者的杂志风格新闻浏览与深度阅读体验
- 后台管理端：面向运营者的数据看板、内容管理与自动化调度系统
二、前台：沉浸式新闻阅读
2.1 首页新闻流
首页以暗色杂志风格呈现，采用三栏卡片式布局，每张新闻卡片包含缩略图、分类标签、标题、AI 摘要和关键词标签。页面顶部提供日期筛选器，支持按日期快速切换浏览不同天的新闻。
功能亮点：
- 日期胶囊式筛选器，支持「今天」「全部」及历史日期切换
- 日期过多时自动折叠，点击「更早日期」展开
- 卡片悬停光晕效果与微动效
- 分页浏览，滚动位置记忆
- 响应式布局，适配移动端
2.2 新闻详情页
详情页是平台的核心阅读体验，AI 对每篇新闻进行多维度结构化分析后，以丰富的可视化组件呈现：
摘要与核心要点
页面顶部以高亮卡片呈现一句话摘要，下方以网格布局展示 3-5 个核心要点，每个要点配有金色圆点标记，帮助读者在 10 秒内把握新闻精髓。
多角度观点
AI 自动提取新闻中不同立场方的核心观点（如监管层、行业专家、公众等），以卡片式对比呈现，帮助读者跳出单一视角，形成独立判断。
智能高亮组件
AI 会根据新闻内容自动选择最合适的高亮展示方式：
| 高亮类型 | 触发条件 | 展示形式 |
|---|---|---|
| 数据网格 (stat-grid) | 数据丰富 | 多卡片统计网格，带数字滚动动画 |
| 核心数据卡 (data-card) | 有一个核心数据 | 大号数据英雄卡 + 辅助指标 |
| 对比分析 (comparison) | 包含对比性内容 | 结构化对比表格 |
| 关键引言 (quote-block) | 有重要引言 | 沉浸式引言区块 |
事件时间线
以垂直时间线形式呈现事件发展脉络，每个节点包含日期与事件描述，配合渐变连接线和金色圆点标记。
行动建议
针对实用类资讯，AI 会总结读者下一步应关注的行动点，以清单形式呈现，每条建议配有对勾图标。
图片画廊与灯箱
新闻配图以画廊形式展示，支持左右切换、圆点导航，点击图片可进入全屏灯箱模式查看大图。
阅读进度条
页面顶部固定一条金色渐变进度条，实时反映阅读进度。
滚动渐入动画
所有内容区块采用 IntersectionObserver 驱动的渐入动画，滚动到可视区域时优雅呈现。
情感标签
每篇新闻自动标注情感倾向（积极 / 中性 / 消极），以不同颜色的胶囊标签展示在标题旁。
三、后台：智能运营管理
3.1 管理员登录
基于 JWT 的管理员认证系统，密码使用 bcrypt 加密存储，Cookie 设置 HttpOnly 属性保障安全。
3.2 数据仪表盘
仪表盘是运营者的核心数据看板，提供以下关键指标：
- 新闻总数：已入库的新闻总量
- 已生成：AI 分析完成并生成页面的数量
- 生成中：正在处理中的任务数
- 失败：生成失败的任务数
- 总 Token 消耗：LLM API 调用的累计 Token 数
图表区域：
- 每日 Token 消耗趋势图（折线图，区分 Prompt / Completion / Total）
- 模型用量分布（按模型名称统计 Token 数与调用次数）
3.3 新闻管理
新闻管理页面提供完整的新闻生命周期管理：
- 查看：打开已生成的新闻详情页
- 重新生成：使用 AI 从不同角度重新分析新闻，生成全新解读页面
- 删除：永久删除新闻及其生成记录和 HTML 文件
所有操作均有二次确认弹窗，防止误操作。
3.4 任务管理
任务管理是平台的核心操作入口，支持：
新建生成任务
通过弹窗表单创建生成任务，可选择：
- 新闻类型：推荐、国内、国际、娱乐、体育、军事、科技、财经、游戏、汽车、健康（共 11 类）
- 生成数量：1-50 篇
实时进度追踪
任务启动后，通过 Server-Sent Events (SSE) 实时推送每篇新闻的处理状态：
- ⏳ 等待中 → 🔄 获取新闻 → 🧠 AI 分析 → 🎨 渲染页面 → ✅ 完成
- 每个状态配有不同颜色的图标和旋转动画
- 顶部进度条实时更新
- 完成后自动刷新任务列表
任务历史
以表格形式展示所有历史任务，包含任务 ID、类型、数量、状态、成功/失败数、Token 消耗、起止时间等信息。
3.5 定时任务
定时任务功能实现新闻生成的全自动化：
- 添加定时任务：设置任务名称、执行时间（24 小时制）、新闻类型和生成数量
- 启用/停用：一键切换任务状态
- 删除：确认后永久删除
- 时间冲突检测：同一时间点不允许设置多个任务
- 执行记录：显示上次执行时间
定时任务基于 APScheduler 的 CronTrigger 实现，服务启动时自动从数据库加载已启用的任务。
四、AI 分析能力
4.1 多模型支持
平台支持切换不同的 LLM 提供商：
| 提供商 | 模型 | 适用场景 |
|---|---|---|
| DeepSeek | deepseek-chat | 默认内容分析模型，中文理解能力强 |
| Moonshot | moonshot-v1-8k | 备选模型，8K 上下文窗口 |
通过 .env 配置文件中的 LLM_PROVIDER 参数即可切换，无需修改代码。
4.2 结构化内容分析
AI 对每篇新闻进行 12 个维度的深度分析：
- 一句话摘要：30 字以内的核心概括
- 核心要点：3-5 个最关键的事实、数据或结论
- 多角度观点：不同立场方的主要观点
- 事件背景：直接原因或长期背景
- 影响分析：对行业、人群或政策的潜在影响
- 行动建议：读者可采取的下一步行动
- 事件时间线：关键节点的时间序列
- 关键引言：新闻中的重要引述
- 数据事实：可量化的关键数据（数值 + 单位 + 指标名 + 背景）
- 对比分析：结构化的正反/前后/方案对比
- 标签与情感：自动分类标签与情感倾向判断
- 高亮建议：智能选择最佳展示组件
4.3 重新生成
重新生成功能会以更高的温度参数（0.7 vs 首次 0.3）调用 AI，并附加提示要求从不同角度分析，提供新的见解和观点，避免与之前的分析重复。
五、技术架构
5.1 技术栈
| 层级 | 技术 |
|---|---|
| Web 框架 | FastAPI |
| 模板引擎 | Jinja2 |
| 数据库 | MySQL (SQLAlchemy ORM) |
| 任务调度 | APScheduler (AsyncIOScheduler) |
| LLM 接入 | OpenAI SDK (兼容 DeepSeek / Moonshot) |
| 新闻数据 | 聚合数据 API (httpx 异步客户端) |
| 认证 | JWT (python-jose) + bcrypt (passlib) |
| 前端样式 | Tailwind CSS (CDN) + 自定义 CSS |
| 图表 | Chart.js |
| 字体 | Newsreader + Noto Sans SC + Fira Code |
5.2 数据模型
平台包含 6 个核心数据模型：
- NewsArticle：新闻原文，含标题、分类、作者、原始内容等
- GeneratedPage：生成页面，关联文章与 AI 分析结果，追踪生成状态
- GenerationTask：生成任务，记录批量生成的执行情况与 Token 消耗
- ScheduledTask：定时任务，定义自动执行的 Cron 规则
- TokenUsage：Token 用量，精细追踪每次 AI 调用的成本
- User：用户，支持管理员角色区分
六、总结
Toutiao AI 将大语言模型的深度理解能力与新闻资讯的实时性相结合，打造了一个从「信息获取」到「知识理解」的智能新闻平台。无论是读者快速获取新闻要点，还是运营者自动化管理内容生产，平台都提供了完整的解决方案。
核心价值：
- 🧠 AI 深度分析：不是简单的摘要，而是多维度结构化解读
- 📊 智能可视化：根据内容自动选择最佳展示方式
- ⏰ 全自动化：定时任务 + 实时进度追踪，无人值守运行
- 💰 成本可控：精细的 Token 用量追踪与模型切换
- 🎨 极致体验：暗色杂志风阅读体验，沉浸式内容呈现