This repository has been archived on 2026-08-09. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
Hulumath-Web-Demo/docs/产品文档/开发对话记录.md
T
2026-08-08 15:49:06 +08:00

101 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 对话记录 — 数学脑项目
> 对话时间:2026-07-11
> 项目:数学脑 (miniapp)
> 当前状态:Flask 后端已成功运行在 http://127.0.0.1:5000
---
## 对话 1:运行 app.py
**用户请求**:运行这个 app
**AI 执行过程**
1. **读取 app.py**:确认这是一个 Flask 后端应用,包含:
- SQLite 数据库初始化
- 54 条种子视频数据导入
- 8 张知识卡片种子数据
- DeepSeek AI 对话接口
- 路由:视频列表、AI 对话、行为日志、故事数据、模拟器、知识卡片、收藏、历史、用户资料
2. **检查项目结构**:确认 data/ 目录、static/ 目录、templates/ 目录均存在,种子数据文件齐全。
3. **安装依赖**
```powershell
pip install flask requests
```
Flask 3.1.3 和 requests 2.32.3 均已安装。
4. **查找 Python 解释器**
- `python` 命令报 9009 错误(未找到)
- 通过 `where pip` 找到 pip 在 `D:\AN\Scripts\pip.exe`
- 确认 Python 在 `D:\AN\python.exe`Python 3.12.7
5. **启动应用**
```powershell
D:\AN\python.exe app.py
```
成功启动,输出:
```
==================================================
数学桥梁计划 · MVP 后端启动中...
==================================================
[完成] 已导入 54 条视频数据
访问地址: http://127.0.0.1:5000
* Running on http://127.0.0.1:5000
```
6. **结果**:应用在 http://127.0.0.1:5000 成功运行,浏览器预览已打开。
**关键技术细节**
- 应用使用 DeepSeek API Key:已在代码中配置
- 数据库:`data/miniapp_v3.db`
- 种子数据:`data/seed_videos.json`54条)、`data/seed_story.json`93节点)、`data/seed_simulator.json`
---
## 对话 2:打包项目文件以供另一个 AI 接手
**用户请求**
1. 打包工作区与 app 相关的文件
2. 导出对话记录为 MD 文档
3. 导出操作规范为 Skill
4. 打包以上所有文件,供另一个 AI 继续开发
**当前正在执行中**
- 创建对话记录 MD(本文件)
- 创建 Skill(数学脑开发操作规范)
- 打包为 zip
---
## 项目当前状态总结
### 已完成的功能 (P0)
- [x] 四大模块基础架构(发现/知识/数学人生/我的)
- [x] 视频发现 + 12专业分区 + 搜索
- [x] 知识卡片流(Hero大卡 + 话题标签 + 8张卡片)
- [x] 葫芦侠行 8章互动剧情(93节点 + 四属性 + 8结局)
- [x] 数学专业模拟器(已启动,部分完成)
- [x] 个人中心(资料 + 统计 + 收藏/历史)
- [x] AI 数学助教(DeepSeek + 上下文感知 + 快捷提问)
- [x] iPhone 移动端适配(390px + 100dvh + safe-area
### 配置信息
- **项目路径**`C:\Users\Asus\Desktop\miniapp`
- **Python 路径**`D:\AN\python.exe`Python 3.12.7
- **启动方式**`D:\AN\python.exe app.py`
- **访问地址**`http://127.0.0.1:5000`
- **数据库**`data/miniapp_v3.db`SQLite
- **DeepSeek API Key**:已在 app.py 中配置
### 待开发
- [ ] 数学专业模拟器完整剧情(当前数据不完整)
- [ ] 用户真实登录系统
- [ ] PWA + 小程序壳
- [ ] 双语支持
- [ ] 家长模式
- [ ] 工具箱/趣味计算器