docs: 更新README,反映AI创作和UGC功能

This commit is contained in:
2026-03-03 17:25:56 +08:00
parent 7fc6779fce
commit 729bb3aaeb

150
README.md
View File

@@ -1,6 +1,6 @@
# 星域故事汇 # 星域故事汇
一款 AI 驱动的互动短剧微信小游戏,将超休闲游戏的极简操作与互动叙事的强代入感相结合。 一款 AI 驱动的互动短剧微信小游戏,支持 AI 创作、UGC 内容发布,将超休闲游戏的极简操作与互动叙事的强代入感相结合。
## 项目结构 ## 项目结构
@@ -9,121 +9,139 @@ ai_game/
├── client/ # 微信小游戏客户端 ├── client/ # 微信小游戏客户端
│ ├── js/ │ ├── js/
│ │ ├── data/ # 数据管理 │ │ ├── data/ # 数据管理
│ │ │ ── StoryManager.js │ │ │ ── StoryManager.js # 故事数据
│ │ │ ├── UserManager.js # 用户数据
│ │ │ └── AudioManager.js # 音频管理
│ │ ├── scenes/ # 场景模块 │ │ ├── scenes/ # 场景模块
│ │ │ ├── HomeScene.js # 首页 │ │ │ ├── HomeScene.js # 首页(推荐/关注/最新/排行)
│ │ │ ├── StoryScene.js # 故事播放 │ │ │ ├── StoryScene.js # 故事播放
│ │ │ ├── EndingScene.js # 结局页 │ │ │ ├── EndingScene.js # 结局页
│ │ │ ├── ProfileScene.js # 个人中心 │ │ │ ├── ProfileScene.js # 个人中心(作品/草稿/收藏)
│ │ │ ├── ChapterScene.js # 章节选择 │ │ │ ├── ChapterScene.js # 章节选择
│ │ │ ├── AICreateScene.js # AI创作中心
│ │ │ └── SceneManager.js # 场景管理 │ │ │ └── SceneManager.js # 场景管理
│ │ ├── utils/ # 工具类 │ │ ├── utils/
│ │ └── main.js # 入口文件 │ │ └── main.js
│ ├── game.js # 游戏启动 │ ├── game.js
│ └── game.json # 小游戏配置 │ └── game.json
├── server/ # Node.js 后端服务 ├── server/ # Node.js 后端服务
│ ├── routes/ # API 路由 │ ├── routes/
│ │ ├── story.js # 故事相关接口 │ │ ├── story.js # 故事接口
│ │ └── user.js # 用户相关接口 │ │ └── user.js # 用户接口
│ ├── models/ # 数据模型 │ ├── models/
│ ├── config/ # 配置文件 │ ├── story.js # 故事模型
├── sql/ # 数据库脚本 │ └── user.js # 用户模型
── app.js # 服务入口 ── config/
│ ├── sql/
│ │ ├── schema.sql # 基础表结构
│ │ └── schema_v2.sql # 完整表结构含AI/UGC
│ └── app.js
├── docs/
│ └── AI创作系统设计.md
└── README.md └── README.md
``` ```
## 技术栈 ## 技术栈
**客户端** | 层级 | 技术 |
- 原生微信小游戏(无引擎) |------|------|
- Canvas 2D 渲染 | 客户端 | 原生微信小游戏 Canvas 2D |
- ES6+ 模块化 | 服务端 | Node.js + Express |
| 数据库 | MySQL 8.0 |
**服务端** | AI服务 | OpenAI / Claude API |
- Node.js + Express
- MySQL 数据库
## 快速开始 ## 快速开始
### 1. 启动后端服务 ### 1. 启动后端
```bash ```bash
cd server cd server
npm install npm install
# 配置 .env 文件(参考 .env.example cp .env.example .env # 配置数据库
npm start npm start
``` ```
### 2. 导入客户端 ### 2. 导入客户端
1. 打开微信开发者工具 1. 微信开发者工具 → 导入项目 → 选择 `client` 目录
2. 导入项目,选择 `client` 目录 2. 填入 AppID
3. 填入 AppID测试号可使用测试 AppID 3. 编译运行
4. 编译运行
## 核心功能 ## 核心功能
### 故事游玩 ### 故事游玩
- 沉浸式视觉小说风格界面 - 沉浸式视觉小说界面
- 打字机效果文字展示 - 打字机效果文字展示
- 多分支选择剧情 - 多分支选择剧情
- 多结局达成系统 - 多结局达成系统
### 章节选择 ### AI 创作中心
- 可选择任意已解锁节点重新游玩 - AI 改写结局
- 体验不同分支剧情 - AI 续写剧情
- AI 完整创作新故事
- 配额管理(免费/付费)
### UGC 生态
- 用户发布原创故事
- 作品审核机制
- 创作者数据统计
- 收益分成系统
### 个人中心 ### 个人中心
- 游玩记录 - 我的作品管理
- 收藏管理 - 草稿箱
- 结局成就 - 收藏/游玩记录
- 创作者统计
## API 接口 ## API 接口
### 故事相关
| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/stories` | GET | 故事列表 |
| `/api/stories/:id` | GET | 故事详情 |
| `/api/stories/:id/rewrite` | POST | AI改写结局 |
| `/api/stories/:id/continue` | POST | AI续写 |
| `/api/stories/ai-create` | POST | AI完整创作 |
### 用户相关
| 接口 | 方法 | 说明 | | 接口 | 方法 | 说明 |
|------|------|------| |------|------|------|
| `/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/login` | POST | 用户登录 |
| `/api/user/progress` | GET/POST | 游玩进度 | | `/api/user/progress` | GET/POST | 游玩进度 |
| `/api/user/collections` | GET/POST | 收藏管理 | | `/api/user/collections` | GET | 收藏列表 |
| `/api/user/my-works` | GET | 我的作品 |
| `/api/user/drafts` | GET | 草稿箱 |
| `/api/user/ai-quota` | GET | AI配额 |
| `/api/user/recent-played` | GET | 最近游玩 |
## 配置说明 ## 数据库
### 服务端配置 (.env) 完整表结构见 `server/sql/schema_v2.sql`,包含:
- 用户体系users, user_stats, user_follows
- 故事内容stories, story_nodes, story_choices
- AI生成ai_generations, ai_prompt_templates
- 用户行为user_progress, user_endings, user_collections
- 经济体系user_ai_quota, coin_transactions
- 审核运营content_reviews, reports
```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] 故事播放场景
- [x] 结局展示系统 - [x] 结局展示系统
- [x] 章节选择功能 - [x] 章节选择功能
- [ ] AI 改写功能 - [x] AI创作中心UI
- [ ] AI 续写功能 - [x] 首页UGC布局
- [ ] UGC 创作系统 - [x] 个人中心创作者功能
- [ ] 社交分享优化 - [x] 后端API完善
- [ ] AI服务对接
- [ ] 审核系统
- [ ] 支付系统
- [ ] 社交分享
## License ## License