# aiFateGame

**Repository Path**: anlinxi/ai_fate_game

## Basic Information

- **Project Name**: aiFateGame
- **Description**: 纯前端的AI风格无限剧情文字游戏
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-22
- **Last Updated**: 2026-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI大模型无限剧情文字游戏 极简HTML原型

> 纯前端 FATE 风格无限剧情文字游戏，验证核心玩法与 AI 交互逻辑

## 🎮 核心特性

- **无限剧情** — AI 实时生成世界观、NPC、剧情分支，永不重复
- **好感度系统** — NPC 根据玩家选择动态调整好感，影响剧情走向
- **NPC 永久记忆** — IndexedDB 存储对话摘要，NPC 记得你的每个决定
- **多模型支持** — MiniMax / 通义千问 / DeepSeek 自动切换与降级
- **内容安全** — 输入输出双重审核，拒绝违规内容
- **零后端** — 纯 HTML+CSS+JS，浏览器直接运行

## 🚀 快速开始

1. 复制配置文件并填入 API 密钥：
```bash
cp config/dev.example.json config/dev.json
# 编辑 config/dev.json 填入你的 API 地址和密钥
```

2. 启动本地服务器（任选一种）：
```bash
# VS Code Live Server 插件（推荐）
# 或 Python:
python -m http.server 8080
# 或 Node:
npx serve .
```

3. 浏览器打开 `http://localhost:8080`

## 📁 项目结构

```
ai-story-game-prototype/
├── index.html              # 唯一入口
├── css/main.css            # 全局样式
├── js/
│   ├── config.js           # 配置加载器
│   ├── ai-adapter.js       # AI 统一适配器
│   ├── story-engine.js     # 剧情引擎
│   ├── memory-manager.js   # NPC 记忆管理
│   ├── storage.js          # IndexedDB 封装
│   ├── content-safety.js   # 内容安全审核
│   ├── ui-renderer.js      # DOM 渲染
│   └── utils.js            # 工具函数
├── config/
│   ├── dev.json            # 本地配置（不提交 Git）
│   └── dev.example.json    # 配置模板
├── test/                   # 测试
└── README.md
```

## 🏗️ 三层架构

| 层级 | 技术栈 | 职责 |
|---|---|---|
| 页面渲染层 | HTML5+CSS3+原生JS | 布局渲染、逐字显示、音画播放、输入交互 |
| 业务&AI调度层 | 原生JS(ES6+) | 剧情状态机、NPC记忆、好感度、AI适配、输出校验 |
| 本地数据层 | IndexedDB+localStorage | 配置存储、多存档、NPC记忆、本地双备份 |

## 🧪 测试

```bash
npm install
npm test              # 全部测试
npm run test:unit     # 单元测试
npm run test:integration  # 集成测试
```

## ⚠️ 安全须知

- `config/dev.json` 包含 API 密钥，已在 `.gitignore` 中排除
- 所有 AI 输出经过内容安全审核
- 游戏数据仅存储在浏览器本地

## 📜 许可

PolyForm Noncommercial License 1.0.0 (Official Original)