魔法少女生成器 (MahoShojo-Generator) 是一款基于 AI 结构化生成技术的 Web 小游戏，玩家可以创建个性化、可成长的魔法少女（也可能是奇奇怪怪的角色）及相关角色，然后开始紧张刺激的赛博斗蛐蛐或者是创作小故事的活动，甚至还有排位功能！
除此之外，项目也实现了 AI 多渠道轮询、用户系统、数据卡公开分享、敏感词检测等丰富神秘的功能。
📖 查看完整的版本更新历史，请参阅 CHANGELOG.md
当前版本：
v0.8.2最新版本重点：接入万途生态互通与竞技场素材注入。档案馆可导入/导出万途通用角色卡，竞技场可把角色、情景、历史、问卷或万途 Card 作为参考素材注入战报；顶部导航新增万途驿站、万途竞技场、废土车卡与废土旅途入口。
- 魔法少女生成：输入名字快速生成基础设定
- 深度问卷生成：通过奇妙妖精大调查问卷生成深度设定
- 残兽生成：创建魔法少女的宿敌——残兽
- 流式/非流式切换：角色生成支持实时 Markdown 或结构化 JSON
- 随机组合：一键从预设素材库随机生成角色
- 通用角色模板：支持多种角色模板切换
- 故事生成：上传 1-10 位角色，AI 生成刺激的对战，或温馨（？）的故事
- 实时流式生成：实时观看战报生成过程
- 连续战报会话：本地保存章节链，支持章节规划、续写 / 分支 / 重写最后一章，适合长篇连续剧情
- 素材注入：可把 JSON 数据卡、万途 Card、历史或问卷作为参考素材加入普通竞技场与连续战报；使用素材时不计严格排位
- 情景卡章节规划：主情景可为连续战报提供建议或固定章节数，帮助 AI 按章推进并控制终章收束
- 多种模式：经典/日常/羁绊/情景模式
- 随机元素：随机角色加入、随机判定事件
- 历战记录：AI 参考角色过往经历生成故事
- 成长升华：角色通过对战积累经验并进化
- 排位系统：1v1 对局计算排位分，展示排行榜
- PVP 卡牌对决：回合制对战，投票决定胜负
- 个人中心：展示战报、生成个人资料卡
- 用户系统：注册/登录账户，云端保存角色数据（v0.8.0 起进入旧密钥迁移窗口）
- 公开分享：分享角色供他人使用，支持点赞和筛选
- 数据卡管理：可视化编辑器、回收站、徽章系统
- 万途通用卡互通：档案馆支持把本站角色导出为万途
character卡，也支持把万途角色卡导入为通用角色 - 标签系统：标签库分类与筛选
- 情景生成：自定义故事场景
- 通用情景卡（Markdown）：更自由的长线舞台设定卡，也可携带连续战报章节规划扩展
- 自由生成：任意提示词按 Schema 生成角色/情景数据卡
- 酒馆生态联动：SillyTavern 角色卡 PNG 导入/导出
- 万途生态入口：顶部导航提供万途驿站、万途竞技场、废土车卡与废土旅途外链入口
- 角色组队卡：把多张角色卡拼成一张队伍卡
- 魔法茶会：基于角色卡/情景卡的长期剧情对话（本地会话，支持选项/摘要/角色更新）
- 立绘生成：AI 绘图接口生成角色立绘（实验性）
- 原生性签名：验证数据来源与完整性
- 内容安全：敏感词检测、屏蔽词替换、多层审核机制
- 百科系统：新手指引、规则说明
- 框架: Next.js 15（App Router 页面与 Route Handlers）, React 19
- 语言: TypeScript
- 包管理器: pnpm 11.3.0
- 运行时: Node.js 22+ (开发、构建与脚本), Cloudflare Pages/Workers (生产，Edge Runtime)
- 数据库: Cloudflare D1（主库）+ Cloudflare R2
- AI: Vercel AI SDK, 支持 OpenAI/Google Gemini 等多种模型 (推荐
gemini-2.5-flash或gemini-2.5-flash-lite) - 样式: Tailwind CSS 4, shadcn/ui (部分)
- 安全: Cloudflare Turnstile (验证码)
- 开发工具: Turbopack (开发模式)
- Node.js 22+（推荐 v24.14.0）
- pnpm 11.3.0（可通过 Corepack 启用）
- Vitest（当前测试运行器）
- AI 提供商 API Key (推荐使用 Google Gemini 系列)
- Cloudflare Turnstile Site Key & Secret Key
- Cloudflare 的一些相关配置（如 D1 数据库绑定）
# 安装依赖
pnpm install
# 配置环境变量
cp env.example .env.local编辑 .env.local 配置你的 AI 提供商：
AI_PROVIDERS_CONFIG='[
{
"name": "gemini_provider",
"apiKey": "your_gemini_api_key_here",
"baseUrl": "https://generativelanguage.googleapis.com/v1beta",
"model": "gemini-2.5-flash",
"type": "google"
},
{
"name": "siliconflow_provider",
"apiKey": "your_siliconflow_api_key_here",
"baseUrl": "https://api.siliconflow.cn/v1",
"model": ["deepseek-ai/DeepSeek-V3.2", "zai-org/GLM-5", "zai-org/GLM-4.6", "Qwen/Qwen3-32B", "moonshotai/Kimi-K2-Instruct-0905"],
"type": "openai"
}
]'# 开发模式
pnpm dev
# 生产构建
pnpm build
pnpm start
# Cloudflare Pages 构建（推荐）
pnpm build:cf
pnpm preview访问 http://localhost:3000 查看应用。
Cloudflare Pages 部署环境变量需显式设置 PNPM_VERSION=11.3.0，避免构建平台使用默认 pnpm 版本。
查看详细的开发进度和完成功能，请参阅 CHANGELOG.md
-
命名规范采用“分层统一 + 边界映射”，适用于全项目，不限于鉴权模块。
-
当前路由统一使用 App Router；历史迁移评估见 docs/reports/2026-06-03_204053_App_Router迁移评估.md。
-
新增 API 默认使用
app/api/**/route.tsRoute Handler；不要新增pages/或pages/api/入口。 -
核心 AI 生成系统
-
角色成长与竞技场系统
-
云端存储与用户系统
-
排位系统与排行榜
-
PVP 对决模式
-
系统通用化与模块化
-
更多角色模板扩展
MahoShojo-Generator/
├── app/ # App Router 页面、全局 layout 与 Route Handlers
│ ├── api/ # Web Request/Response API 入口
│ ├── layout.tsx # 全局 HTML 壳、metadata、样式与 Providers
│ └── **/page.tsx # 页面路由入口
├── lib/ # 核心逻辑
│ ├── ai/ # AI 集成
│ ├── ai-session/ # AI 连续会话（连续战报等）
│ ├── database/ # 数据库访问
│ ├── db/ # Drizzle schema/repositories
│ ├── d1.ts # Cloudflare D1
│ └── signature.ts # 数据签名
├── drizzle/ # D1 迁移 SQL
├── components/ # UI 组件
├── public/ # 静态资源
│ ├── announcements.json # 公告
│ ├── encyclopedia/ # 百科 Markdown
│ └── presets/ # 预设数据
└── types/ # TypeScript 类型定义
✨ 为结构化生成献上祝福 ✨