明日方舟角色生成器 · 使用教程
本工具通过轮盘随机抽取，按预设流程生成完整 OC 角色档案。你可以直接游玩，也可以在「配置编辑」中自定义轮盘、流程与输出模板。
一、启动与访问
- 双击项目文件夹中的
start.bat，保持弹出的命令行窗口不要关闭。
- 浏览器会自动打开
http://localhost:3456；若未打开，请手动访问该地址。
- 页面顶部显示「已加载: config/character.json」即表示配置加载成功。
请勿直接双击打开 HTML 文件。浏览器在本地文件模式下无法正常运行本程序。
二、主界面说明
- 轮盘区（左侧）
- 显示当前步骤的轮盘，指针指向本次抽取结果。点击「抽取」开始转动。
- 流程模式
- 按配置好的顺序依次抽取，适合生成完整角色。点击「开始流程」后，按钮会变为「暂停流程」。
- 单次模式
- 只抽取某一个轮盘，适合测试选项或单独随机。
- 格式化输出（页面底部）
- 流程进行中会逐步填充角色档案；未完成部分暂时显示为
【占位符】，全部抽完后自动整理成终稿。
- 抽取历史
- 记录每一步的轮盘名与结果，方便回溯。
三、流程模式操作
基本流程
- 点击开始流程。
- 点击抽取（或勾选自动选项，见下文）。
- 若未勾选「自动进入下一步」，抽完后需点下一步再抽下一项。
- 全部完成后，底部输出区生成完整角色档案，可点复制结果。
- 点重新来清空当前进度，重新开始。
自动化选项
| 选项 | 作用 |
|---|
| 自动抽取 |
流程进行中，当前步骤就绪后自动点击抽取。 |
| 抽完后自动进入下一步 |
每次抽取结束后自动进入下一流程步骤（同一步内的重复/分支除外）。 |
| 两者同时勾选 |
全自动跑完全流程，无需手动点击。 |
勾选状态会保存在浏览器中，下次打开自动恢复。流程进行中可点暂停流程停止自动行为，再次点击继续流程恢复。
特殊步骤说明
- 分支步骤：如抽「职业」后会自动进入对应分支轮盘；抽「结局」后进入死亡方式/存活之后等。
- 技能效果循环：先抽「技能效果」，再抽对应「分支技能效果」；抽到「再来一次」会重抽效果，不跳步骤。
- 重复抽取：如「性格」会按「性格数量」的结果重复抽多次。
- 跳过步骤：不满足条件时自动跳过（如四星角色没有技能三、特殊能力选「否」等）。
四、配置编辑
点击右上角编辑配置进入编辑器。修改会自动保存为草稿（存于浏览器），关闭页面后仍可恢复；点应用更改才会写入 config/character.json。
- 基础
- 修改页面顶部显示的项目标题。
- 轮盘
-
管理所有轮盘。左侧选轮盘，右侧编辑选项文字、颜色、权重与数值。
- 权重：数值越大越容易被抽到，扇区面积也越大。
- 数值：用于「1种」「2条」等计数类选项，一般可留空。
- 内部标识：配置文件中的键名，改名后流程与映射引用会自动更新，请勿含空格。
- 流程
-
定义抽取顺序，可添加「普通轮盘步骤」或「技能效果循环」。用 ↑↓ 调整顺序，用「删」移除步骤。
- 重复抽取：指定次数来源轮盘（如性格数量）。
- 跳过条件：数量为 0 或等于某值时跳过本步。
- 执行条件：仅当前置结果匹配时才执行（如六星才有技能三）。
- 抽完后分支：本步结束后根据结果跳转另一轮盘。
- 分支映射
- 维护「选项文字 → 目标轮盘」对照表。例如：职业「术师」→ 术师分支轮盘；整合运动「新整合运动」→ 新组织轮盘。
- 输出
- 编辑角色档案模板与占位符替换规则（详见下一节）。
五、输出模板与占位符
模板中使用 【轮盘显示名称轮盘抽取结果】 作为占位符，流程结束后替换为实际抽取文字。
示例：轮盘显示名称为「出生地」，占位符即 【出生地轮盘抽取结果】。
复合结果（技能）
技能一/二/三在「输出 → 复合结果」中配置，格式选 effectType，会输出为「生存（护盾/屏障/庇护）」这类组合文本。
条件性内容
模板中部分段落会根据抽取结果自动隐藏，例如：非整合运动不显示组织信息、非死亡结局不显示死亡方式、无特殊能力时显示「特殊能力：无」等。无需手动删改模板。
六、保存与备份
| 操作 | 说明 |
|---|
| 应用更改 |
校验配置并写入 config/character.json。需 start.bat 启动的 Python 服务。 |
| 下载配置 |
导出 JSON 文件，可手动替换配置文件（无法连服务器时的备选方案）。 |
| 加载配置 |
从本地 JSON 文件导入，会覆盖当前内存中的配置。 |
| 浏览器草稿 |
编辑未应用时自动保存；下次打开会询问是否继续编辑。 |
七、常见问题
- 应用更改失败 / 连接被拒绝：确认
start.bat 窗口仍在运行，然后刷新页面重试。不要用只读静态服务器。
- 输出里还有【占位符】：流程未跑完，或模板中的名称与轮盘「显示名称」不一致。跑完全流程后仍残留，请检查输出模板。
- 修改后游戏里没变化：需点「应用更改」并回到主界面点「重新来」重新开始流程。
- 顶部红色错误列表：配置校验未通过，按提示修正（常见：流程引用了不存在的轮盘、映射表缺项）。
- 想恢复默认配置：用 Git 还原
character.json，或重新下载项目原始文件。
建议改配置前先「下载配置」备份一份。大幅改动流程时，可先在「单次模式」下测试单个轮盘是否正常。