当前正式版本：
v1.6.0-Release
核心定位：专为日系二次元（Anime, Comic, Games, Novel）爱好者及 TRPG 跑团玩家打造的交互式文字物语/跑团轻小说引擎。整合 AI 动态编织技术与经典 D20（二十面骰）好运判定，支持纯本地沙盒剧本自定义。
- 多主基调场景切换：内置皇家神导学院（
Academy）、微光落叶森林（Forest）、古地底矿穴（Cave）、深渊魔王大厅（Dungeon）、繁华城镇酒馆（Town）等场景，并伴有专属色调辉光（Cyan,Rose,Amber,Purple,Emerald,Sky）。 - Live 角色头像交互：包含伙伴（Partner）、魔物（Monster）、神秘导师（Mentor）等多种动态情感反馈的角色头像体系。
- 高频打字机动画：专为快速剧情阅读优化的交互节奏，支持一键跳过。
- D20 掷骰硬核判定：关键剧情走向挂钩力量（
Strength）、魅力（Charisma）、运气（Luck）属性，引入动态二十面骰子（D20）物理动效摇号，结果大成功（Natural 20）、大失败（Natural 1）将彻底阻断或重构后续故事分支。 - 属性与背包沙盒：支持动态生命值（HP/脑力）、精神值（MP）状态管理，实时金币及消耗品/武器装备收纳系统。
- 免代码可视化面板：
- 章节分支节点编创：自定义添加、删除、重置故事节点（Nodes），实时调整对话立绘、色调、音效频段与下级链接。
- 全局配置与主角设定：自定义修改文本标题、作者、世界观、开局描述及主题专属色。
- 主角与代币数值自定义：支持自定义主角名字/代称（如 “转生皇子”）、代币名称（如 “原石”、“魔晶”），设定自由的初始血量、空魔值上限。
- 一键测试与剧本导出：修正测试路径，允许一键下载并复制标准的
.json剧本跑团卡。
- 基建级整合 Gemini AI 智能编织，只需输入一句话（例：“学园都市最弱超能力者”、“转生魔王居然成了前台客服”），即可由 AI 动态编译至少 8 个分支、包含硬核判定与多重结局的完整日系轻小说脚本，并自动贴合数值属性规则。
确保您的开发设备中已安装 Node.js (v18+)。
# 确认安装就绪
node -v
npm -v将本引擎代码拉取到本地，在项目根目录下执行依赖安装：
# 安装必要的前端 React 与物理动画库 (motion/react, lucide-react)
npm install若需启用 AI一键召唤 异世界梦境服务，请在项目根目录创建 .env 文件，并填入您的 Google AI Studio 专属密钥金钥（Gemini API Key 可在 Google AI Studio 免费获取）：
# .env 配置文件
GEMINI_API_KEY=您的_GEMINI_API_KEY_在这里# 启动热重载开发服务器
npm run dev之后在浏览器中打开浏览器预览： http://localhost:3000。
# 执行精简物理构建
npm run build
# 启动服务端 (生产环境)
npm run start- 🆕 【重大新增】世界观基础框架设置：在创作者神卷新增“宏观世界观背景”与“主调体系模式”模块，深度支撑 AI 流体对话，让故事线背景再不穿帮。
- 🆕 【重大新增】主角及代币设定自定义系统：允许自由设计主角称呼（如 “转生皇子”、“阿尔斯”）、独特的钱包金币货币称呼（如 “原石”、“摩晶”、“魔晶”），且在全局 UI 同步联动渲染。
- 🆕 【重大新增】初始背包装备（Starting Gear）：除了消耗型物资，额外增加了战斗级初始装备槽，冒险开局更加坚韧。
- 🆕 【重大功能】创作者修改文本标题：主编辑条顶部重载，可以直接重命名剧本名字，并同步刷新列表视图。
- 🔧 【修复】“测试当前剧本无效问题”：修正测试按钮跳转。现在在编辑器点击“测试当前剧本”后，引擎将重置该角色的游戏运行会话，并自动激活切换至游戏前台（“冒险剧场”），实现“秒改秒测”顺畅体验。
- 🔧 【修复】“导出跑团卡无效问题”：重构导出逻辑，一键触发标准
.json文件形式的本地下载，并向用户弹出美观的卡片对话框，支持右键直接备份剪贴版与一键复制。
- 🆕 引入 D20 骰子物理动效：通过 SVG 与 CSS 三维变形渲染，在决定命运的选项引入掷骰挑战。
- 🆕 背包与属性实时增减：引入
gainItems与loseItems机制，选项可自动引发 HP, MP 和金币增减。 - 🆕 简易音效系统：加入 Web Audio API 原生电子合成音效，提升跑团节奏质感。
- 📢 玩家在线剧本工坊：集成持久化 Firebase / PostgreSQL 个人账户，允许用户自由上传发布自己编撰的二次元世界线，并支持评分点赞。
- ⚔️ 阵营与好感度（Affection Level）系统：增加伙伴羁绊值设定，特殊选项判定需检测与指定美少女/导师角色的好感度阈值。
- 🎵 AI 背景音乐 (BGM) 动态生成：支持根据当前场景（如
Cave/Academy）和剧本主基调，利用 Web Audio 或三方流媒体平台自动切换史诗、欢快或激燃的纯音乐。 - 🎨 视觉立绘拓展：整合 Stable Diffusion 或 Imagen 模型，允许创作者使用 AI 根据故事场景与描绘，在本地实时生成日系赛璐璐/CG动漫厚涂风格的场景底图与大尺寸精致立绘。