StoryForge · 文化游戏工坊

滴水湖全球OPC人工智能挑战赛暨第二届燕缘·协创者号AI+国际创业大赛 雪窦山 AIGC 品牌出海赛道 · 方向一：研发 AI 智能体工具 个人参赛 · 主攻子赛道：AI 游戏生成

一句话定位：输入一个中国文化主题，自动生成一个可玩、可多语种发布、适合海外分发的 HTML5 互动游戏（剧情 + 战斗玩法）。

🎮 在线试玩（演示链接）：👉 https://Ma-TINC.github.io/storyforge-demo/mecha.html 《龙甲·东方机甲·寻踪》—— 中国文化机甲战斗题材（中文 / English / 日本語 / 한국어 四语种内置）

V2 更新：程序化生成 SVG 机甲立绘（玄龙·龙角覆鳞披帛太极核心 vs 暗枭·鸦角羽翼爪刃）， 回合制战斗全面升级——动作动画（攻击/蓄力/防御/受击）、战斗对话气泡、双战斗（试炼→决战）、 道具收集（太极核心/龙魂玉/古法阵图）与隐藏结局「龙魂觉醒」。

本地体验：打开 demo/ 目录 中的 index.html 即可直接游玩，无需任何安装。 演示链接部署指南：见 docs/deploy.md（GitHub Pages / itch.io 双方案）。

---

项目简介

文化出海最大的门槛不是内容本身，而是"内容生产规模化"与"本地化"。 StoryForge 把这两件事交给一个 AI 智能体工具完成：

用户输入文化主题（如"中国文化机甲"、"油纸伞"、"茶文化"）
        │
        ▼
┌─────────────────────────────────────────┐
│  StoryForge Agent                       │
│  ① 策划生成：题材分析 → 剧情大纲 → 多分支脚本 │
│  ② 游戏渲染：脚本 → 可玩 HTML5 单文件游戏    │
│  ③ 出海包装：多语种文案 → 导出包/发布素材     │
└─────────────────────────────────────────┘
        │
        ▼
输出：可玩的游戏页面（含剧情分支 + 回合制战斗）+ 中英日韩多语种文案 + 发布素材

核心能力（Core Capabilities）

能力	说明	当前状态
题材理解与策划	将文化主题转化为剧情大纲、角色、多分支路线	✅ 离线知识库 + LLM 增强
游戏生成	策划案 → 完整可玩的 HTML5 单文件游戏（剧情分支 + 回合制战斗）	✅ 可运行
多语种出海包装	文案/界面自动多语种化（中/英/日/韩）	✅ 可运行
LLM 创意增强	接入任意 OpenAI 兼容大模型，生成更自由的故事	🔌 接口已预留，插拔式启用（.env 配置）

技术架构

storyforge/
├── core/                    # 核心引擎（纯 Python，零依赖）
│   ├── story_engine.py      # 策划生成引擎（确定性生成器 + 多战斗场景 + 隐藏结局）
│   ├── game_renderer.py     # 游戏渲染器：脚本 → HTML5 游戏（立绘+战斗动画UI）
│   ├── mech_svg.py          # 机甲立绘生成器（程序化 SVG：龙甲/暗枭，纯代码零图片）
│   ├── i18n.py              # 多语种文案引擎
│   ├── knowledge.py         # 内置文化题材知识库（机甲战斗含立绘视觉数据）
│   └── llm_client.py        # LLM 客户端（OpenAI 兼容，.env 配置，可插拔）
├── demo/                    # 演示产物（可直接打开游玩）
├── site/                    # 作品集展示页（演示链接主页）
├── output/                  # 生成的游戏输出目录（运行时创建）
└── docs/
    ├── spec.md              # Wave 1：项目提案（需求/评测方法）
    ├── skill.md             # Wave 2：工具能力规格与评测标准
    ├── workflow.md          # Wave 2：人与AI协作工作流
    └── deploy.md            # 演示链接部署指南（GitHub Pages / itch.io）

快速开始

# 生成机甲题材游戏（四语种）
python3 storyforge.py --theme "机甲" --lang zh --lang en --lang ja --lang ko
# 打开 output/龙甲·东方机甲·寻踪/index.html 即可游玩

没有 API key 也能完整使用：离线确定性生成器内置文化知识库（机甲、油纸伞、茶文化、丝绸、汉服等），保证任何主题都能产出可玩游戏；配置 .env（见 .env.example）后启用 LLM 增强，剧情由大模型实时创作。

评测标准（Evaluation）

按 docs/spec.md 与 docs/skill.md 中的标准自测通过：

1. 可运行性：任意文化主题 → 60 秒内产出可直接游玩的 HTML5 游戏 ✅
2. 有效性：游戏有完整剧情闭环（开局→分支→战斗→结局）、可操作交互、文化元素正确 ✅
3. 出海能力：一键导出中英日韩多语种发布素材包 ✅
4. 复用性：同一主题可重复生成不同剧本（随机种子）；不同主题可迁移 ✅

文档索引

• Wave 1 项目提案 spec.md — 需求描述、目标用户、核心功能、评测方法
• Wave 2 能力规格 skill.md — 工具能力、输入输出规范、可运行验证
• 人与AI协作工作流 workflow.md — 创作流程、工具使用、迭代机制
• 演示链接部署指南 deploy.md — GitHub Pages / itch.io 双方案
• Demo 游戏 — 可直接打开游玩的演示产物
• 作品集展示页 — 所有 demo 的入口页

版权与合规

• 所有生成内容为项目原创演绎，不涉及典籍宗教题材；素材见 docs/spec.md 附录 A。
• 生成的游戏代码为项目自有实现；图标与字体均为内联生成，无外部资源依赖，可离线运行。