与你的 AI 协作

连接你的账户

AI 助手是右侧停靠栏中的一个标签页。打开后你会看到一个聊天面板，底部是输入框；如果你还没有连接任何账户，会有一条琥珀色提示让你添加密钥。

1. 打开 AI 助手设置 点击面板标题栏中的齿轮图标。当你第一次在未设置密钥的情况下尝试发送消息时，它也会自动打开。
2. 选择一个提供商 左侧导航列出了 Anthropic (Claude)、Google Gemini、OpenAI 和 Claude Code (local)，另外还有一个单独的图像生成入口。
3. 粘贴你的密钥 每个提供商面板都可以填入你自己的 API 密钥，可选填模型 id；兼容 OpenAI 的提供商还可以填 base URL。Anthropic 默认使用 claude-opus-4-8，Gemini 默认 gemini-2.0-flash，OpenAI 默认 gpt-4o。
4. 保存并使用该提供商 密钥设置好后，标题栏副标题会变成绿色的 Ready。琥珀色表示仍需要设置密钥。

这里没有后端。密钥存放在你浏览器的本地存储中，请求从页面直接发往提供商。Rayzia 永远看不到它，也不存在会被用完的共享密钥。相应地，账单是你的，速率限制也是你的。

如果你在本地运行 Claude Code，还有第四条完全不需要 API 密钥的路径。Claude Code (local) 面板提供一个桥接端口、一个 Connect 按钮和一份供你复制过去的 SKILL.md。它只通过环回地址与本地 MCP 服务器通信，并使用按浏览器生成的能力令牌，该令牌已嵌入你交出的那份 SKILL.md 中。

它究竟能做什么

助手通过一层语义动词工作，共四十一个，全部在真实引擎上执行。大致分组如下：

• 绘制与选择：select、useTool、createShape、drawPath、freehand、spray、group、clearCanvas。
• 文本：createText、setText、areaText、textOnPath、touchType、listFonts、loadFont。
• 上色：setPaint、addGradient、widthProfile。
• 效果：applyEffect、applyPathEffect、applyFilter、applyBlend、transformEffect、applyEnvelopeWarp。
• 图像：generateImage、placeImage、placeImageFromUrl、searchImages。
• 素材库：searchAssets、previewAssets、placeAsset。
• 素材：saveAsset、listAssets、applyAsset、generateAsset、validateAsset，以及文件夹相关操作。
• 整理：setLocked、setHidden、batch、runCommand。

它并不局限于这份清单。它可以枚举编辑器的工具和命令并加以驱动：useTool 可以激活工具栏上的任何工具，runCommand 则直接调用引擎命令。它还能读取文档、请求画布渲染并查看结果，并枚举可用的效果，所以当你说「让它看起来别那么扁平」时，得到的是深思熟虑的答案，而不是瞎猜。

AI 做的每件事都记入历史记录。它调用的每个动词都是一个带有操作说明标签的撤销步骤。一批多个操作会折叠为一次撤销。自由手绘和钢笔式绘制会通过真实工具重放，因此可能落成多个步骤。无论哪种情况，Ctrl+Z 都能带你回去。

如何写好提示词

这个助手能干且照字面执行。大多数令人失望的结果，都源于提示词在关键之处含糊不清。

• 先选中，再说话。 如果已经选中了某个对象，说「把选中内容重新配色为暖色调」，它就会精确地作用于该对象。没有选中时说「给它换个颜色」，它只能靠猜。
• 有数字就给数字。 「三个矩形，120 乘 40，垂直堆叠，间距 16px」是一项任务。「画几个方块」则是邀请它即兴发挥。
• 说出想要的结果，而不是手法。 它能枚举自己的工具。「让徽章边缘看起来像手工描墨」给了它挑选合适效果的余地；当你确切知道自己要什么时，「应用 Roughen，强度 2」也完全可以。
• 小步迭代。 先要布局，看一眼，再要配色。一条冗长的指令比四条短指令更难干净地撤销。
• 让它用 batch。 五十个相似形状放进一个 batch，只占一个撤销步骤和一次往返。对你的密钥来说也更省钱。

每条消息最多十六步。如果达到上限，你会看到相应提示。这通常说明这个请求本该拆成两个。

它不会做什么

AI 边界带有一份拒绝清单，且无法通过聊天协商。助手不能打开、保存、导出、导入、置入文件，不能打印、关闭或重新加载文档，也不能调用内部命令。普通编辑操作（包括删除和清空）依然允许，因为这些都可以撤销，整个设计正是建立在这一点之上。

图像处理被刻意收窄。生成的图像直接嵌入。从网络获取的图像在进入文档前会被重新编码，因此不会有任何远程 URL 被写进你的文件。

审阅权仍在你手里。这个助手速度很快，偶尔也会自信地出错，和其他所有模型一样。盯着画布，而不是聊天记录。

Generate 是另一回事

还有第二个标签页叫 Generate，它不是助手。它生成的是素材库素材，而不是画布上的作品。描述你想要什么，从 Brush、Swatch、Gradient、Symbol、Filter、Stylize、Path Effect 或 Marker 中选一个 Kind，结果会先经过一道校验关卡，然后落到 素材 的 Yours 下的 AI Generated 文件夹里。

关卡会检查模式、大小、数值范围和净化处理，然后实际短暂应用该素材以确认其可用。失败时会依据关卡自身的报告自动重试一次。它复用聊天提供商的密钥，所以连接一次即可覆盖两个界面。

经验法则：AI 助手改动你的文档，Generate 充实你的工具箱。

Agent Marks：画出来，让智能体照做

Agent Marks 适用于你通过 Agent Connect 连接的智能体。不必写很长的提示词，直接画出东西该放在哪里。打开 Agent Connect 列，点击 Marks 标签。画布上方会出现一条栏，里面有钢笔、圆形、矩形和文字，一圈细框表示此刻在画布上按下就会生成一个 mark。

1. 画一个区域 用圆形或矩形拖出来，或用钢笔围一圈。钢笔线回到起点就是一个区域；留着不闭合的是一条草图，智能体会沿着它做。每个 mark 都有一个编号。
2. 写下这里放什么 按 Enter 输入，或在画布上点击文字。每个 mark 有自己的备注，你还可以在它那一行里加上工具或风格。
3. 点击 Run 智能体按顺序逐个处理 mark，每次只在对应区域内操作。拖动各行可以调整顺序。

画在已有对象上的 mark 会变成编辑，并勾选其中的对象，这样智能体只能改动这些。每条命令之后，Rayzia 都会把改动与区域做对比。如果智能体超出边缘，你能看到超出多少，而且不会裁掉任何内容。如果它改动了没有交给它的东西，你同样能看到，并可以单独撤销那一处改动。

每个 mark 是一步撤销，所以 Ctrl+Z 会撤回整个 mark。Finish 会清除 mark，作品保留。失败的 mark 有重试按钮，它只运行那一个 mark。

mark 是备注，不属于你的设计。它们不会出现在任何导出、打印或分享链接里，会随文件一起保存，方便你以后接着做。包含在 Pro 和 14 天试用里。

常见问题