创作助手和你自己的 AI

画布上有一个内置的 创作助手，你也可以把自己平时用的 Claude、ChatGPT、Cursor 接进来改卡。

创作助手

点画布右上角的 创作助手，右边会打开它的对话框。跟它说你想要什么就行，说话随意一点没关系：

「加一个叫 Vex 的狡猾商人，喜欢用谜语说话，有信任障碍」

「做一个饥饿系统，随时间递减，降到零的时候玩家死亡」

「搭一个暗黑奇幻的界面，要有生命、魔力和背包格子」

「战斗太简单了，让敌人伤害高一点，再加一个伤口系统」

它能写设定和开场白、加变量和行为、开情境、加 AI、搭玩家界面、检查哪里接错了、在整张卡里搜东西。它改的东西会实时出现在画布上。

两种模式

新对话默认进入 构思。方案成熟后，助手会主动弹出本次搭建范围；点 开始搭建 才切换并执行，自动带上刚讨论好的方案。选 继续构思 会留在讨论，同一版方案不会反复弹出，可通过 查看搭建方案 再次打开。

输入框下面也可以手动切换：

• 构思：还没想好做什么的时候用。它会跟你聊，帮你把想法理成一份 创作简介，先不动卡
• 搭建：动手改卡。确认方案后，按创作简介把第一版搭出来

只改某几块

先在画布上选中你想改的那几块（Ctrl + 点可以多选），再跟助手说话，它就只盯着这几块改。选中的东西会以小标签的样子出现在输入框上面。

每一块上也有 帮我写这一块，点一下就是让助手只写这一块。

便签

助手会读画布上所有的便签，也知道每张便签贴在什么东西上。想法太多一时说不完，可以先贴便签，最后跟它说「照便签把这些都做了」。

上网查资料

做同人卡、IP 卡时，助手会自己上网查它拿不准的设定（名字、年龄、关系、能力、剧情先后），优先看萌娘百科、B 站 wiki、Fandom、维基百科这类资料站，回复里会附上出处链接。你也可以直接贴网址让它读。原创设定它不会去搜。

• 每次搜索约 8 蘑菇币，从你的余额扣（用自己的 API 时也一样，因为搜索走的是 Yumina）；读网页免费
• 一次请求最多搜 12 次、读 24 个网页
• 有些网站不让服务器读（比如百度百科），助手会改用搜索摘要或别的来源
• 不想让它联网：点输入框下面的 构思 / 搭建，取消勾选 联网搜索（这台浏览器会记住）
• 卡里附了原著时，它以原著为准，网上的说法只作补充

改坏了怎么办

助手每改完一轮，画布底下会出现 AI 这一回合 的小条子，写着新增、修改、删除了几样。不满意就点 撤销这一回合，整轮一起撤掉。

小提示

• 一层一层来。 先搞定角色和设定，再加机制，最后打磨界面。别想一条消息说完整个世界
• 让它检查。 改了好几轮之后，跟它说「检查一下现在有没有接错的地方」
• 它在后台也会继续干活。 发完需求可以离开 Studio、去改别的卡。做完了、需要你拿主意、或者停下来的时候，应用里会弹一条提醒，点它就回来了
• 用助手会消耗额度，开始一个大活之前它会告诉你大概要多久、花多少

连接你自己的 AI

如果你更习惯用自己的 AI 工具，可以让它直接登录你的 Yumina 账号来改卡。支持 Claude、ChatGPT / Codex、Cursor、Claude Code、Codex 终端版。

点右上角 ⋮ 菜单里的 连接你的 AI（新卡要先保存一次），选你用的那个，照着步骤做就行。大概是这样：

1. 在你的 AI 工具里加一个连接器 / MCP 服务器，地址填 https://yumina.io/mcp
2. 它会弹出 Yumina 的页面让你登录，点 允许
3. 回到弹窗，跟着 发一句话试试：比如在 Claude 里发「用 Yumina 打开我的卡「蘑菇酒馆」，告诉我里面现在都有什么」。弹窗看到它连上了，会告诉你 (๑•̀ㅂ•́)و✧

Claude Code 和 Codex 终端版是在终端里加，弹窗里会给你一行可以直接复制的命令。Codex 终端版还要在 ~/.codex/config.toml 的 [mcp_servers.yumina] 下面加一行 tool_timeout_sec = 300：Codex 默认只给工具 60 秒，试玩和生图可能更久。

DeepSeek（DeepSeek Harness）暂时不能登录，所以它那一栏会给你正在编辑的这张卡生成一个令牌，再给你一份现成的配置文件和一行命令。这个令牌只能改这一张卡。

连上以后，它能做的和创作助手差不多：读卡、写设定和变量、加行为和情境、改玩家界面、生图、试玩。改的东西会实时出现在你开着的画布上。它也会读你的便签。

几件要知道的事：

• 它不能发布。 发布永远是你自己点
• 每次改卡之前会自动存档。 在 ⋮ → 改动记录 里能看到「Before: 某某 AI」，不满意就撤回到那一刻
• 试玩和生图照常扣你的蘑菇币，和你自己在画布上点一样
• 有一些防手滑的上限：每小时最多试玩 30 回合、生图 20 张，一天最多新建 20 张卡
• 弹窗里 已连接的 AI 列着都有谁连着，点 断开 就收回权限
• 登录一直不成功的话，点 无法登录？给这张卡生成令牌，会生成一个只能改这一张卡、90 天后失效的令牌，把地址和请求头填进你的工具就行。令牌只显示一次，记得马上复制

手机上暂时没有这个入口，要在电脑上连。

World Spec

如果你的 AI 工具不支持连接器，也可以下载 World Spec，一份写给 AI 看的完整技术说明。让 AI 读它，按你的描述写出卡的 JSON，再导入 Yumina。

→ 下载 World Spec