131 lines
3.1 KiB
Markdown
131 lines
3.1 KiB
Markdown
|
# 星域故事汇
|
|||
|
|
|
|||
|
|
一款 AI 驱动的互动短剧微信小游戏，将超休闲游戏的极简操作与互动叙事的强代入感相结合。
|
|||
|
|
|
|||
|
|
## 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
ai_game/
|
|||
|
|
├── client/ # 微信小游戏客户端
|
|||
|
|
│ ├── js/
|
|||
|
|
│ │ ├── data/ # 数据管理
|
|||
|
|
│ │ │ └── StoryManager.js
|
|||
|
|
│ │ ├── scenes/ # 场景模块
|
|||
|
|
│ │ │ ├── HomeScene.js # 首页
|
|||
|
|
│ │ │ ├── StoryScene.js # 故事播放
|
|||
|
|
│ │ │ ├── EndingScene.js # 结局页
|
|||
|
|
│ │ │ ├── ProfileScene.js # 个人中心
|
|||
|
|
│ │ │ ├── ChapterScene.js # 章节选择
|
|||
|
|
│ │ │ └── SceneManager.js # 场景管理
|
|||
|
|
│ │ ├── utils/ # 工具类
|
|||
|
|
│ │ └── main.js # 入口文件
|
|||
|
|
│ ├── game.js # 游戏启动
|
|||
|
|
│ └── game.json # 小游戏配置
|
|||
|
|
│
|
|||
|
|
├── server/ # Node.js 后端服务
|
|||
|
|
│ ├── routes/ # API 路由
|
|||
|
|
│ │ ├── story.js # 故事相关接口
|
|||
|
|
│ │ └── user.js # 用户相关接口
|
|||
|
|
│ ├── models/ # 数据模型
|
|||
|
|
│ ├── config/ # 配置文件
|
|||
|
|
│ ├── sql/ # 数据库脚本
|
|||
|
|
│ └── app.js # 服务入口
|
|||
|
|
│
|
|||
|
|
└── README.md
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 技术栈
|
|||
|
|
|
|||
|
|
**客户端**
|
|||
|
|
- 原生微信小游戏（无引擎）
|
|||
|
|
- Canvas 2D 渲染
|
|||
|
|
- ES6+ 模块化
|
|||
|
|
|
|||
|
|
**服务端**
|
|||
|
|
- Node.js + Express
|
|||
|
|
- MySQL 数据库
|
|||
|
|
|
|||
|
|
## 快速开始
|
|||
|
|
|
|||
|
|
### 1. 启动后端服务
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd server
|
|||
|
|
npm install
|
|||
|
|
# 配置 .env 文件（参考 .env.example）
|
|||
|
|
npm start
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 导入客户端
|
|||
|
|
|
|||
|
|
1. 打开微信开发者工具
|
|||
|
|
2. 导入项目，选择 `client` 目录
|
|||
|
|
3. 填入 AppID（测试号可使用测试 AppID）
|
|||
|
|
4. 编译运行
|
|||
|
|
|
|||
|
|
## 核心功能
|
|||
|
|
|
|||
|
|
### 故事游玩
|
|||
|
|
- 沉浸式视觉小说风格界面
|
|||
|
|
- 打字机效果文字展示
|
|||
|
|
- 多分支选择剧情
|
|||
|
|
- 多结局达成系统
|
|||
|
|
|
|||
|
|
### 章节选择
|
|||
|
|
- 可选择任意已解锁节点重新游玩
|
|||
|
|
- 体验不同分支剧情
|
|||
|
|
|
|||
|
|
### 个人中心
|
|||
|
|
- 游玩记录
|
|||
|
|
- 收藏管理
|
|||
|
|
- 结局成就
|
|||
|
|
|
|||
|
|
## API 接口
|
|||
|
|
|
|||
|
|
| 接口 | 方法 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| `/api/stories` | GET | 获取故事列表 |
|
|||
|
|
| `/api/stories/:id` | GET | 获取故事详情 |
|
|||
|
|
| `/api/stories/categories` | GET | 获取分类列表 |
|
|||
|
|
| `/api/stories/:id/play` | POST | 记录游玩 |
|
|||
|
|
| `/api/stories/:id/like` | POST | 点赞故事 |
|
|||
|
|
| `/api/user/login` | POST | 用户登录 |
|
|||
|
|
| `/api/user/progress` | GET/POST | 游玩进度 |
|
|||
|
|
| `/api/user/collections` | GET/POST | 收藏管理 |
|
|||
|
|
|
|||
|
|
## 配置说明
|
|||
|
|
|
|||
|
|
### 服务端配置 (.env)
|
|||
|
|
|
|||
|
|
```env
|
|||
|
|
PORT=3000
|
|||
|
|
DB_HOST=localhost
|
|||
|
|
DB_USER=root
|
|||
|
|
DB_PASSWORD=your_password
|
|||
|
|
DB_NAME=ai_game
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 客户端配置 (game.json)
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"deviceOrientation": "portrait",
|
|||
|
|
"showStatusBar": false
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 开发计划
|
|||
|
|
|
|||
|
|
- [x] 核心游玩模块
|
|||
|
|
- [x] 故事播放场景
|
|||
|
|
- [x] 结局展示系统
|
|||
|
|
- [x] 章节选择功能
|
|||
|
|
- [ ] AI 改写功能
|
|||
|
|
- [ ] AI 续写功能
|
|||
|
|
- [ ] UGC 创作系统
|
|||
|
|
- [ ] 社交分享优化
|
|||
|
|
|
|||
|
|
## License
|
|||
|
|
|
|||
|
|
MIT
|