常见问题
创作过程中最常遇到的问题解答。
Q：我需要会写代码吗？
不需要。可以使用可视化编辑器和工作时里的AI助手 来构建一切。自定义 UI 是唯一涉及代码的功能，这会让一切，尤其是和前端有关的东西简单很多(●'◡'●)。
Q：构建一个世界需要多长时间？
一个带几个变量的简单角色用 Studio AI 大约 10-15 分钟。一个有自定义 UI、音频和详细机制的复杂世界可能需要几小时到几天。
Q：Yumina 支持哪些 AI 模型？
开箱即用的官方阵容分四个价格档：
- 经济档 — 默认是 Claude 3 Haiku（每条消息约 5 mushies）。还有 DeepSeek V4 Flash、V3.2、Gemini 2.5 Flash Lite、Yumina Free。
- 标准档 — Gemini 3 Flash、DeepSeek V4 Pro 等。
- 高级档（Gold 套餐起） — Claude Haiku 4.5、Grok 4.20、Gemini 3.1 Pro。
- 旗舰档（Platinum 起） — Claude Sonnet 4.6、Claude Opus 4.7。
模型由玩家在游玩时选择，完整列表和选型说明见玩家教程：AI 设置。
你也可以在「设置 → AI 配置 → 私有密钥」自带 API 密钥，支持 Anthropic、OpenAI、Google、OpenRouter、Ollama，以及任何 OpenAI 兼容端点 —— DeepSeek、xAI (Grok)、Mistral、Groq、Together、Fireworks、Moonshot 都有一键预设。BYOK 上下文不限，账单直接走你自己的服务商而不是消耗 mushies。
Q：我的世界数据存在哪里？
你的世界数据保存在 Yumina 的服务器上。你可以随时从编辑器的概览部分导出世界 JSON 文件作为本地备份。
条目与知识库
Q：条目太多了，怎么整理？
使用文件夹。编辑器支持创建文件夹按逻辑分组——按角色、按场景、按功能。文件夹纯粹是组织工具，不影响运行时行为。同时善用 tags 字段进行过滤和搜索。参见写好条目的技巧中的「文件夹组织」部分。
Q：alwaysSend 条目和关键词触发的条目有什么区别？
alwaysSend: true 的条目无论玩家说什么都会包含在每次 prompt 中——适合核心角色档案和基础世界规则等需要始终生效的内容。关键词触发的条目只在最近消息中出现匹配词时才激活——适合特定场景、地点、NPC 和其他按需内容。根本区别是「始终在线」vs.「按需触发」。策略性地组合使用两者可以大幅节省 token 预算。参见写好条目的技巧。
Q：怎么写有效的示例对话？
用 <START> 分隔不同的对话段落，用 {{user}}: 和 {{char}}: 标记说话者。每个示例应该展示角色独特的说话风格、语气和反应——不只是信息交换。两三个高质量的示例远比十个平庸的有价值。将条目的角色设为 example，分区设为 examples。参见写好条目的技巧中的示例对话格式部分。
变量与指令
Q：AI 没有按正确格式写指令，怎么办？
引擎已经自动告诉 AI 指令格式了，所以问题通常不是「AI 不知道格式」而是「AI 不确定什么时候该用」。几个解决方法：1) 让 条件更具体——「受到伤害时减少；每次命中扣 10-30」比「受伤时减少」好；2) 在 post-history 分区添加一个提醒条目告诉 AI 别忘了输出指令；3) 降低 temperature（如 0.5-0.7）让 AI 更可靠地遵守规则；4) 不同模型在指令遵从方面差异很大——换模型也值得尝试。
Q：变量突然出现了奇怪的值，怎么调试？
先看 AI 在原始回复中写了什么指令——有时 AI 会写出你没预料到的操作。然后检查是否有规则在后台悄悄修改这个变量（通过 modify-variable 动作）。对于数值变量，确认你设了合理的 min 和 max 值——引擎自动把超出范围的值限制回来。如果还找不到，在编辑器中检查每个引用了这个变量的规则和条目。
Q：我可以有多少个变量？有限制吗？
引擎层面没有硬性限制。但每个变量的当前值都会包含在发送给 AI 的 prompt 中，所以变量太多会消耗 token 预算并缩短 AI 能「看到」的对话历史。实际使用中，大多数世界 5-20 个变量就能运转良好。如果你需要存储大量数据，考虑把相关数据打包进一个 JSON 变量——比一堆独立变量更高效。
规则引擎
Q：行为没有触发，怎么调试？
按顺序检查：1) 行为是否已启用——是否被其他行为禁用了？2) WHEN 触发器类型是否正确——比如你选了「变量越过阈值」但变量从未越过该阈值；3) 所有 ONLY IF 条件是否通过（检查 conditionLogic 是 "all" 还是 "any"）；4) 是否在冷却中（cooldownTurns）；5) 是否达到最大触发次数（maxFireCount）。参见行为与自动化中的评估流程部分。
Q：多个行为同时触发时，执行顺序是什么？
按 priority 从高到低排序。数字越大的行为越先被评估和执行。例如，priority 100 的「死亡检查」行为在 priority 50 的「低血量警告」之前运行。如果两个行为 priority 相同，按定义顺序执行。给重要行为设置更高的 priority 值。参见行为与自动化中的优先级部分。
Q：行为可以互相控制吗？
可以。「启用/禁用行为」动作可以开关其他行为。典型模式：行为 A 监听「进入地牢」关键词，触发时启用行为 B（一个初始禁用的怪物遭遇规则）。当玩家离开地牢时，行为 A 关闭 B。你可以构建「休眠直到被激活」的行为链。参见行为与自动化中的规则交叉控制部分。
组件与渲染
Q：我不会写 TSX，还能做自定义 UI 吗？
可以试试。几个入手方式：1) 在编辑器中使用进入 Studio，让 AI 助手帮你生成代码；2) 向外部 AI（如 Claude）描述你想要的效果让它生成 TSX 代码，然后粘贴到编辑器中；3) 从文档中的模板示例复制粘贴并调整颜色和文字。编辑器实时编译并在底部显示错误（Compile Status），你可以边调边看。参见自定义 UI 指南。
发布与分享
Q：发布后还能修改吗？
可以。发布后你随时可以回到编辑器修改世界内容——保存即时生效，新玩家看到最新版本。要临时下架，将状态改为 unpublished，活跃玩家会看到只读提示。注意：如果你修改了变量定义（比如删除一个变量），引擎会自动处理对现有玩家存档的向后兼容——新变量填入默认值，删除的变量被过滤掉。现有玩家不会受影响。参见发布、导出与 Bundle。
Q：怎么让更多玩家发现我的世界？
要点：1) 上传一个吸引人的封面图——Hub 中没有封面的世界几乎不会被点击；2) 写一段引人入胜的描述，解释世界是什么以及为什么好玩；3) 添加 3-5 个相关标签——想想玩家会搜什么；4) 写好开场消息（问候语）——第一印象决定玩家是否继续玩下去；5) 发布前自己完整玩一遍确保体验流畅。参见发布、导出与 Bundle中的「发布前检查清单」。
Q：Bundle 和完整世界导出有什么区别？
完整世界导出是完整的 WorldDefinition JSON——每个条目、变量、规则、组件和设置一个不漏。适合备份或将整个世界分享给别人。Bundle 是一个「组件包」——你挑选一部分内容（比如一套战斗规则系统 + 相关变量 + 组件）打包。别人可以将这个包安装到自己的世界里。简单来说：完整导出是「整辆车」；Bundle 是「发动机总成」。参见发布、导出与 Bundle中的「Bundle 系统」部分。
收益与打赏
Q：金钱打赏 Yumina 抽多少？
20% 平台费，然后 Stripe 再单独扣它的收单费。$10 的打赏大概是这样：Yumina 拿 $2，Stripe 拿 ~$0.59（2.9% + $0.30），你净到手 ~$7.41。具体每一笔的拆分在你的收益面板里都能看到。
Mushie 礼物平台费 0% —— 全额立即进你钱包。但 mushies 不能换成钱，它们是平台内货币，只能花在你自己的 AI 使用上。
Q：为什么打赏有 7 天冻结期？
Stripe 给玩家 7 天的卡交易撤销/退款窗口。我们在这 7 天里把每笔打赏放在「冻结中」，避免给你打钱后又被追回。7 天后这笔进入「可用余额」，计入 $10 最低提现门槛。Mushie 礼物不冻结。
Q：最低提现金额是多少？
$10 可用余额起。达到门槛后 Stripe 按其常规节奏打款（一般 2–7 个工作日，取决于国家和银行）。低于 $10 余额会持续累积，不收任何「闲置费」。
Q：我不在美国，怎么收款？要给美国交税吗？
Stripe Connect Express 支持 40+ 国家的非美国创作者。入驻时会让你填一份 IRS W-8BEN（个人）或 W-8BEN-E（实体）。这不是让你给美国交税，而是证明你是外国创作者，从而避免美国默认按 30% 预扣。提交了有效 W-8 之后，大多数非美国创作者依据本国与美国的税收协定享受 0% 美国预扣。你仍然要在自己国家依法纳税。W-8 直接走 Stripe 的流程，Yumina 看不到也不经手。
Q：能给自己打赏 / 用小号刷收益吗？
不能。自己的世界上根本不显示 Support 按钮，平台也会定期检测对刷模式（同一支付方式、反复整数金额、新账号只打赏一个创作者等）。确认的操纵 = 收益冻结 + 撤销创作者身份，详见使用条款。真实的边界情况（比如家人用自己的钱支持你）没问题 —— 上面说的是刻意欺诈的模式，不是诚实支持。
Q：支持者退款了，我的收益怎么算？
如果退款发生在 7 天冻结期内（大多数情况），很遗憾，那笔钱将会直接消失。
Q：能看到具体哪个世界谁打赏了我吗？
Q：我取消发布了一个世界，那它给我赚的打赏还在吗？
还在。打赏和 mushie 礼物绑定的是你的创作者账号，不是世界本身。取消发布甚至删除世界都不会撤销过去的收益。在世界上线期间打赏过你的人钱已经付了，结算完毕。