Demo

docs/产品文档/产品描述.md

@@ -0,0 +1,212 @@
+# 数学脑 · 产品描述
+
+> 一个围绕数学的轻量级移动端兴趣社区 App | MVP v6.0
+
+---
+
+## 一、产品定位
+
+**数学脑** 是一款面向 C 端用户的数学科普与兴趣社区 Web App。产品以 "让数学变得有趣" 为核心目标，融合短视频发现、知识卡片阅读、互动剧情游戏三大内容形态，通过 iPhone 移动端友好的设计，打造轻松使用、随时消费的数学兴趣入口。
+
+**Slogan**：数学不是公式，是你理解世界的方式。
+
+---
+
+## 二、目标用户
+
+| 用户画像 | 典型场景 |
+|----------|---------|
+| 初中/高中生 | 课后刷到一条3分钟视频，发现"原来数学跟手机、游戏、追番都有关" |
+| 大学生/研究生 | 跨专业了解"学数学对我专业有什么用" |
+| 职场人 | 碎片时间读一篇知识卡片，刷新认知 |
+| 文史爱好者 | 在互动小说中体验数学与武侠的跨界碰撞 |
+
+核心需求：**轻量、有趣、不考试**——让用户在没有学习压力的环境下，重新认识数学的用处和美感。
+
+---
+
+## 三、四大功能模块
+
+### 🟠 发现（视频流）
+
+> **发现 · 值得一看的数学内容**
+
+手机 App 风格的数学短视频发现页，类似主流视频/DISCOVERY 应用的交互。
+
+**子导航**：
+- **推荐** — 双列瀑布流推荐视频
+- **热门** — 按热度排序
+- **专业分区** — 12 个学科图标网格
+
+**12 个专业分区**：
+
+| 专业 | 图标 |
+|------|------|
+| 人工智能 | 🤖 |
+| 计算机 | 💻 |
+| 电子信息 | 📡 |
+| 微电子 | 🔌 |
+| 机械工程 | ⚙️ |
+| 自动化 | 🦾 |
+| 能源动力 | 🔥 |
+| 化工材料 | 🧪 |
+| 生物医学 | 🧬 |
+| 经济管理 | 📊 |
+| 环境工程 | 🌱 |
+| 数学建模 | 📐 |
+
+每个分区可点击进入该学科专属视频列表，共收录 **54 条**来自各学院志愿者提供的科普视频（占位数据）。
+
+**顶部搜索栏**支持关键词搜索（标题、描述、作者、学科）。
+
+---
+
+### 🔵 知识（数学发现卡片流）
+
+> **知识 · 数学发现**
+
+非视频化的轻量数学知识发现 Feed，类似小红书/得到 App 卡片风格。
+
+**组成**：
+- **每日 Hero 大卡** — 今日主题 + 统计概览
+- **横向滚动话题标签** — 统计陷阱、概率思维、几何直觉、逻辑悖论、数学模型、博弈策略、数列之美、混沌理论
+- **信息流卡片** — 6 个趣味数学主题，每个卡片包含：
+  - 渐变色彩封面
+  - 一个引人思考的「问题」
+  - 知识标题 + 简明描述
+  - 预估阅读时间
+  - 点击可呼出 AI 助教深入探讨
+
+**当前卡片内容**：
+- 被平均数骗过的所有人
+- 彩票：一场精心设计的数学税
+- 为什么所有地图都在骗你
+- 大自然最爱的数列（斐波那契）
+- 博弈论：竞争的最优解
+- 混沌理论：看不见的秩序
+
+---
+
+### 🟢 数学人生（互动剧情游戏）
+
+> **数学人生 · 葫芦侠行**
+
+基于原创小说《葫芦侠行》改编的 **视觉小说（Visual Novel）**，将数学精神融入武侠叙事。
+
+**世界观**：北宋年间，紫金山下秉公习武堂。数学与武侠融合的独特江湖。玩家扮演葫芦侠从初入武堂到创立脑学数堂，经历教习、论道、陷害、审查、悟道——最终揭开真相。
+
+**核心玩法**：
+
+- **选择驱动剧情** — 每个关键节点 2-3 个选项
+- **四属性系统**：
+  - 📐 数理根基 — 解锁高阶功法、影响论道胜负
+  - ⚔️ 侠义声望 — 影响 NPC 态度和武林大会成绩
+  - 🧘 心志韧性 — 面对挫折时的选择余地
+  - 💕 好感度 — 与 8 位关键角色的关系（欧阳侠、Eddie侠、厚朴侠、三力思侠、溜溜侠、孔锝侠、星侠、甲亢侠）
+- **多结局** — 根据属性阈值和关键选择触发不同结局
+
+**8 章完整剧情**：
+
+| 章节 | 时间线 | 核心剧情 |
+|------|--------|---------|
+| 第一章·初入江湖 | 1022年秋 | 入门集训、结识好友、认识厚朴侠、红灰青蟹、瘟疫抉择 |
+| 第二章·西部教习 | 1023年春 | 武林大会队内赛、社牛挑战、姑苏城出游、常青藤支教 |
+| 第三章·数理论道 | 1023年秋 | 玎铧侠赠锦囊、组建堂口团队、跨学科访学 |
+| 第四章·脑学初创 | 1023年冬 | 地下石室建堂、招新大会、甲亢之辩、欧阳侠出海 |
+| 第五章·报国之路 | 1024年春 | 武林大会备战、常青藤精神入堂训、获最佳报国创新奖 |
+| 第六章·暗流涌动 | 1024年秋 | 流言陷害、监察会审查、龙场悟道、溜溜侠揭露身份 |
+| 第七章·陋室修炼 | 1024冬-1025秋 | 统计流三境修炼、黑衣人夜袭、罗素悖论 |
+| 第八章·真相之门 | 1025年秋 | 京城审查、宿老三招之约、周口店真相、何立导演现身 |
+
+**8+ 种结局**：真相守望、数理宗师、逍遥江湖、出海远航、悲情英雄、堕落之路、冤狱、虚无……
+
+**技术特性**：
+- 打字机效果逐字显示剧情
+- 选项按钮显示属性变化预览
+- 章节自动检测 + 徽章展示
+- localStorage 存档/读档/重置
+
+---
+
+### 🟣 我的（个人中心）
+
+> **我的 · 个人中心**
+
+按主流 App 格式设计的个人信息页。
+
+**板块结构**：
+- **个人卡片** — 头像 + 昵称 + ID + 身份标签（紫色渐变背景）
+- **数据统计** — 已看内容、收藏专题、剧情存档（三栏数字）
+- **个人信息** — 昵称与头像、兴趣方向、学习偏好（菜单列表）
+- **我的内容** — 我的收藏、观看记录、数学人生存档
+- **更多** — 设置与帮助、意见反馈
+
+---
+
+## 四、AI 数学助教
+
+集成 **DeepSeek** 大语言模型，在 App 任意位置可通过右上角按钮唤起对话。
+
+**能力**：
+- 解释数学在各学科中的基础作用
+- 用生活化语言回答"学数学有什么用"
+- 知识卡片点击可一键追问
+
+**交互**：
+- 气泡式对话界面
+- 快捷提问按钮（数学与医学 / 数学与建筑 / 数学与AI / 为什么要学）
+- 打字指示器动画
+
+---
+
+## 五、设计语言
+
+### 移动端优先
+- 390px 宽度（iPhone 标准比例）
+- 100dvh 全屏高度 + safe-area 顶部/底部适配
+- 桌面端呈现为圆角设备壳效果（border-radius: 34px + 阴影）
+
+### 底部 TabBar
+- 四个入口：发现 / 知识 / 数学人生 / 我的
+- 白色半透明玻璃感 + 毛玻璃模糊
+- CSS 伪元素绘制的简约图标
+- 激活态为对应模块主色的浅色高亮
+
+### 色彩语义
+- 每个模块有独立主色，切换时全局 CSS 变量动态替换
+- 保证用户在四个模块间不会产生混淆
+
+---
+
+## 六、数据现状
+
+| 数据 | 数量 | 说明 |
+|------|------|------|
+| 短视频 | 54 条 | 12 个专业分区，志愿者提供 |
+| 知识卡片 | 6 张 | 6 个数学趣味主题 |
+| 话题标签 | 8 个 | 横向滚动可筛选 |
+| 互动剧情节点 | 93 个 | 8 章完整剧情 |
+| 关键角色 | 10+ 位 | 含好感度系统 |
+| 结局 | 8+ 种 | 基于属性+选择触发 |
+| AI 助教 | DeepSeek Chat | 全模块可呼出 |
+
+---
+
+## 七、与竞品的差异
+
+| 维度 | 数学脑 | B站/小红书 | 得到 App |
+|------|--------|-----------|---------|
+| 内容聚焦 | 数学单一垂类 | 泛兴趣 | 泛知识 |
+| 内容形态 | 视频 + 卡片 + 互动小说 | 以视频为主 | 音频 + 电子书 |
+| 互动深度 | 视觉小说级分支剧情 | 评论弹幕 | 划线笔记 |
+| 用户心智 | "数学也可以有趣" | 消遣娱乐 | 学习提升 |
+| 目标年龄 | 15-25岁 | 全年龄 | 25岁以上 |
+
+---
+
+## 八、内容来源
+
+1. **视频**：各学院大学生志愿者提供科普课程（占位数据已内置）
+2. **知识卡片**：产品团队原创数学科普内容
+3. **互动小说**：原创小说《葫芦侠行》改编，8 章完整剧情
+4. **AI 对话**：DeepSeek 大模型实时生成