核心组成
- 画布项目：每个项目独立保存节点、连线、视口和画布外观。
- 生成工作台：独立的图片、视频和音频页面，用于快速试做和查看生成记录。
- 我的资产：集中管理保存的图片、视频和文本，可再次插入画布。
- Agent 面板：用自然语言创建、连接、整理节点，或直接发起生成。
1. 先了解 Ember Studio
Ember Studio（火种）是一款以无限画布为核心的创作工作台。文本、参考图片、视频、音频、模型配置和生成结果都可以放在同一张画布中，并通过连线或 Agent 继续推进。
推荐使用顺序
- 注册并验证 QQ 邮箱，完成账户登录。
- 在设置中添加自己的模型渠道和模型名称。
- 进入画布，建立提示词和参考素材节点。
- 连接生成节点，检查参数后运行任务。
- 将结果保存到资产中心，继续迭代或下载。
重要边界：安装包不预置任何生图渠道、模型或 API Key。首次使用必须由用户自己在设置中添加渠道；文档中的示例地址和模型名也不能替代你的实际服务配置。
2. 注册、验证码与登录
当前注册只支持 QQ 邮箱。注册请求在邮箱验证码验证成功后才会创建账户，邀请码不显示在注册表单中，邀请链接会通过地址尾缀自动识别。
2.1 注册账户
打开注册页
访问 注册账户，或在首页点击“免费注册”。
填写 QQ 邮箱
输入 QQ 号即可，输入框会自动补全为 @qq.com；也可以直接填写完整的 QQ 邮箱。系统会检查邮箱格式和是否已注册。
设置密码
密码至少 8 位。验证码按钮位于邮箱和密码之间的同一行：左侧输入邮箱，右侧点击“获取验证码”。
查收并验证
点击获取验证码后检查 QQ 邮箱收件箱和垃圾邮件文件夹，输入 6 位数字验证码并提交。验证码 10 分钟有效，最多连续错误 5 次；重新发送有 60 秒间隔。
完成注册
验证成功后账户才会创建，系统会自动登录并进入账户中心。若通过邀请链接注册，成功创建后邀请人的会员时长才会发放。
2.2 邀请链接
已登录用户可以在 账户中心复制专属链接。链接格式类似 /register?invite=邀请码，收件人直接打开即可，注册表单不会额外显示邀请码输入框。奖励只在新用户完成 QQ 邮箱验证并成功创建账户后发放，同一邮箱不能重复计算。
2.3 登录与找回密码
在 登录页输入 QQ 邮箱和密码，可勾选记住登录状态。忘记密码时点击“找回密码”，输入已注册邮箱并按邮件中的链接设置新密码。完成登录后可从账户中心查看会员状态和服务到期时间；桌面端登录同一账户即可进行权限验证。
验证码安全：不要把验证码转发给他人。若提示发送失败，先确认邮箱服务已由管理员配置，随后等待冷却时间再重试；不要连续刷新造成验证码失效。
3. Web 端与 Windows 桌面端
两种入口使用同一套产品概念，但数据保存位置和本地能力不同。
| 项目 | Web 端 | Windows 桌面端 |
|---|---|---|
| 进入方式 | 浏览器登录站点，适合快速访问。 | 从 下载中心安装，启动后直接进入画布。 |
| 画布与资产 | 保存在浏览器 IndexedDB。 | 由内置 SQLite 和媒体目录保存。 |
| Agent | 使用网页中的 Agent 面板和 Canvas Agent 连接。 | 可连接本地 Canvas Agent，适合本地文件和本地 ComfyUI 工作流。 |
| 更新 | 刷新网页即可获得服务器端页面更新。 | Windows 安装版可通过发布清单检查更新；便携版不支持在线更新。 |
桌面端首次启动会直接进入已有或新建画布，不会回到营销首页。浏览器端打开根路径后也会跳转到画布入口。
4. 进入画布与管理项目
画布是 Ember Studio 的主工作区。左侧管理项目和资产，中央放置节点，右侧是 Agent 对话。
打开与切换项目
启动后选择左侧“画布项目”中的项目；点击项目名称即可打开。使用“新建画布”建立独立项目，项目会保存节点、连线、背景、缩放位置和 Agent 会话。
项目维护
在项目菜单中可以重命名、导出当前画布、批量导出选中项目，或删除项目。删除会同时移除其中的节点和连线，执行前请确认。
4.1 画布视口
- 滚轮或触控板缩放画布；按住空白区域拖动可以平移。
- 使用选择工具点击节点，使用框选一次选择多个节点；按住修饰键可追加选择。
- 缩略图地图用于快速查看大画布位置；工具栏可切换背景显示和节点信息。
- 修改会自动保存；误操作可用撤销/重做恢复。
4.2 多选和批量操作
多选节点后，右侧会显示批量连线的加号入口。点击加号，再选择目标节点即可为多个同类节点建立连接。批量运行时每个节点都有独立的运行状态和暂停/停止控制，单个节点停止不会影响其他任务。
5. 节点、连线与上下文菜单
节点是画布中的最小创作单元。双击空白区域打开创建菜单，双击已有节点可编辑名称或内容。
| 节点类型 | 用途 | 常见输入 |
|---|---|---|
| 文本 | 保存提示词、剧本、分镜、说明和参考描述。 | 文字内容，可连接到图片、视频、音频或文本生成。 |
| 图片 | 放置参考图或生成结果。 | 本地上传、资产中心插入、生成提示词和图像参数。 |
| 视频 | 放置视频参考或视频生成结果。 | 参考视频/音频、时长、分辨率、画幅、声音和水印选项。 |
| 音频 | 放置参考音频或音频生成结果。 | 音色、格式、速度和指令。 |
| 组 | 将相关节点归类，便于移动和整理。 | 节点拖入组后可整体移动。 |
5.1 创建和编辑
双击画布选择文本、图片、视频、音频或组；SVG 和 Markdown 不再出现在双击创建菜单，但已有节点仍可正常渲染。节点标题可双击修改，节点内容编辑后会即时保存。
5.2 连线规则
从节点边缘的连接点拖到目标节点建立连线。连线代表输入关系，生成时会读取上游提示词和参考资产。若无法连接，通常是输入类型不兼容、目标节点已满或节点处于不可用状态；可先查看节点信息再调整。
5.3 右键菜单
选中节点后右键可以查看信息、复制、删除、重新生成、保存资产、下载结果，以及打开裁剪、蒙版、角度、拆分、放大等图片工具。对视频和音频节点可使用对应的预览、下载和停止操作。
6. 图片、视频、音频和文本生成
既可以在画布节点中生成，也可以使用独立工作台快速试做。所有任务都有进行中、成功、失败和取消等状态，结果可以回到画布继续使用。
6.1 图片生成
准备输入
在 /image 图片工作台输入提示词，或在画布中使用文本节点作为提示词。可添加一张或多张参考图片，调整尺寸、质量和生成张数。
处理结果
成功结果可“加入我的资产”“作为参考继续编辑”或下载；失败结果保留错误信息，可单独重试。生成记录会保存提示词、模型、参数和缩略图。
6.2 视频生成
视频节点可从空视频节点开始，或接入文本、图片、视频和音频参考。运行前检查时长、尺寸、分辨率、画幅、生成声音和水印开关。任务开始后，节点会显示进度和停止按钮；批量运行时逐个节点独立控制。云端 ComfyUI 视频任务会轮询进度，完成后导出视频并写回节点。
6.3 音频和文本
音频生成支持音色、格式、速度和指令等参数，生成结果可保存到资产或下载。文本节点主要用于写作、提示词和结构化内容；连接文本模型后，Agent 或生成流程可以读取其内容。
渠道未配置时：点击生成会提示先到设置添加渠道和模型。请先确认模型能力与节点类型匹配，例如图片模型用于生图，视频模型用于视频，OpenAI 兼容渠道用于对应的文本、图片或音频接口。
7. 我的资产
资产中心保存可以跨项目复用的媒体和文本。画布项目本身与资产中心是两个概念：删除项目不会自动把已保存的资产当作项目节点使用。
添加资产
- 在图片、视频或音频结果上点击“加入我的资产”。
- 从左侧资产入口上传本地媒体或新增文本资产。
- 在画布打开资产选择器，选择后直接插入当前项目。
查找和维护
- 按关键词搜索，按类型筛选并预览详情。
- 修改名称、描述或文本内容，便于后续检索。
- 下载单个资产，或导出资产包；不需要的资产可以删除。
7.1 导入和导出
资产中心支持导出资产压缩包和重新导入。迁移电脑前先导出资产包，再在新设备登录后导入；导入失败时检查是否选择了 Ember Studio 导出的有效压缩包。
8. Agent 助手
右侧 Agent 面板可以理解当前项目上下文并执行画布操作。它适合处理多步骤工作，但每次执行前都应检查工具确认内容。
8.1 常用指令
| 目标 | 示例说法 | 执行结果 |
|---|---|---|
| 创建节点 | “创建三个文本节点，分别写人物、场景和镜头。” | 批量创建对应节点并放置到画布。 |
| 创建项目 | “新建一个名为分镜草稿的画布。” | 创建项目并切换到新画布。 |
| 整理画布 | “把当前节点按宫格排列。” | 预览整理结果，等待确认后应用。 |
| 运行生成 | “用当前提示词生成四张图。” | 打开图片工作台并应用参数，可继续确认后运行。 |
| 管理资产 | “把当前选中的结果加入资产。” | 保存或插入资产，并返回执行摘要。 |
8.2 引用当前内容
输入 / 可以选择 Agent 技能或动作；输入 @ 可以引用画布节点和资产。引用后，Agent 会将节点编号、类型和媒体信息作为上下文，不需要把大段内容手动复制到对话框。
8.3 连接状态和权限
面板顶部显示本地 Canvas Agent 的连接状态。未连接时仍可使用部分网页工具，但涉及本地文件、桌面存储或本地 ComfyUI 的操作需要连接成功。创建项目、删除项目、批量整理和生成任务等操作可能出现确认对话框；确认前先检查目标节点、模型和参数。
撤销原则：Agent 的工具执行会返回操作摘要。若整理结果不符合预期，在确认窗口的保留时间内选择撤回，或使用画布撤销；不要连续发送重复指令造成重复节点。
9. 节点整理与可视化布局
当画布节点较多时可以使用自动整理。当前整理支持宫格、水平和垂直三种模式。
选择范围
选中要整理的节点，或让 Agent 根据当前画布执行整理。
选择模式
宫格适合大量同类节点；水平适合从左到右的工作流；垂直适合上下游层级明显的结构。
检查预览
系统会显示整理后的节点位置并进入确认倒计时，检查节点是否遮挡、连线是否清晰。
保留或撤回
确认保留后保存新布局；不满意可在倒计时内撤回，或随后使用撤销恢复。
10. 模型渠道与 API 配置
模型渠道完全由用户自行维护。安装包和网页端不内置你的私人渠道、API Key 或模型配置。
10.1 添加渠道
打开应用设置中的“模型渠道”，点击新增渠道，填写渠道名称、接口格式、接口地址、模型名和 API Key，再为图片、视频、文本、音频能力指定默认模型。接口地址按服务商要求填写，系统会按渠道格式发起请求。
| 字段 | 填写建议 |
|---|---|
| 渠道名称 | 使用容易识别的名称，例如“我的图片服务”或“本地 ComfyUI”。 |
| 接口格式 | 按服务商选择 OpenAI 兼容或 ComfyUI 等现有适配格式。 |
| 接口地址 | 填写服务商提供的原始地址；不要把密钥拼在 URL 中。 |
| 模型名称 | 填写服务商要求的模型标识，不要额外添加渠道前缀。 |
| API Key | 只在本机设置中保存，不要粘贴到公开文档、截图、Agent 对话或 Git。 |
10.2 ComfyUI 渠道
本地 ComfyUI 渠道保持自己配置的端点；云端隧道只作为没有本地地址时的回退。视频工作流需要对应的 API 工作流和模型文件，提交前先确认 ComfyUI 地址可访问、工作流节点名称匹配、参考媒体格式正确。
隐私提示：API Key 存在浏览器本地配置或桌面端本地数据中，Ember Studio 不会替你把密钥写进安装包。迁移或导出配置前请先检查导出文件是否包含敏感字段，并按服务商要求轮换泄露的密钥。
11. 默认设置与运行日志
设置中心集中管理界面、模型、生成参数和本地数据；运行日志用于排查 Agent 连接和任务执行问题。
生成默认值
可设置默认生图张数、图片尺寸和质量；视频默认时长、画幅、分辨率、声音和水印；音频格式、音色和速度。节点中的单次修改只影响当前任务，不会覆盖全局默认值，除非主动保存为默认。
主题和界面
设置中可以调整应用主题和界面偏好。画布页面会使用统一的深色工作区主题，避免节点、工具栏和 Agent 面板出现不一致的颜色。
运行日志
在设置中的运行日志查看 Agent 连接、工具调用、生成请求和错误摘要。日志用于定位问题，不要把包含地址、账户或请求内容的完整日志公开发布。
版本更新
更新弹窗显示当前版本、新版本、下载进度和安装确认。更新日志按版本概括展示，点击版本标题可以展开该版本的功能、完善和修复内容。
12. 本地存储、迁移与备份
| 环境 | 保存内容 | 迁移建议 |
|---|---|---|
| 浏览器版 | 画布项目、资产和生成记录主要保存在浏览器 IndexedDB。 | 使用应用提供的项目/资产导出功能；不要只清理浏览器缓存后再尝试恢复。 |
| 桌面版 | 内置 SQLite、项目数据和媒体文件保存在应用数据目录。 | 在“本地存储”设置中查看当前目录，可切换自定义目录或恢复默认路径；迁移前关闭正在运行的任务并完整复制数据目录。 |
12.1 安全迁移步骤
先导出可移植数据
从项目列表导出画布，从资产中心导出资产包；把导出文件放到备份目录。
记录渠道配置
确认新设备需要的接口地址和模型名。API Key 不要写进共享备份，改为在新设备手动输入。
迁移桌面数据
桌面版按本地存储页面显示的目录复制 SQLite 和媒体文件，保持目录结构完整。
验证结果
新设备登录后打开一个项目、预览一项资产并运行一次小任务，确认数据和渠道都可用，再清理旧设备。
13. 云端算力与 ComfyUI
云端算力页面用于保存管理员维护的推荐平台入口；实际生成仍需要你在渠道设置中配置可用服务或 ComfyUI 实例。
13.1 使用推荐平台
在应用的云端算力入口查看平台名称和注册链接，点击后由系统浏览器打开外部页面。平台账号、费用、实例规格和服务条款由对应平台负责，Ember Studio 不会代管这些账号。
13.2 连接云端 ComfyUI
- 在云端平台启动 ComfyUI 实例，并确认 API 端口可访问。
- 需要 SSH 隧道时，先按平台说明建立隧道，再把本地映射地址填入渠道。
- 导入与项目匹配的 API 工作流，检查模型文件、节点输入和输出类型。
- 在 Ember Studio 发送一次小尺寸测试任务，确认队列、进度轮询、视频导出和下载均正常。
14. 账户中心、会员与邀请返利
登录后访问 账户中心，可以查看当前服务状态、到期时间、会员记录和邀请信息。
会员状态
账户中心显示“访问权限已开启”或“等待管理员开通”、服务到期时间和最近的会员服务记录。管理员变更授权后，桌面端重新登录即可同步最新状态。
邀请返利规则
复制专属邀请链接发送给朋友。新用户完成 QQ 邮箱验证码验证并创建成功后，系统按后台规则发放会员天数；页面会显示已成功邀请人数和当前规则。首次和后续奖励天数由管理员设置。
14.1 会员记录怎么看
记录中会区分账户注册、注册赠送、邀请奖励、管理员授权调整等事件，并显示发生时间、服务状态和到期时间。若账户中心提示服务初始化，通常表示服务端数据库迁移尚未完成，应联系管理员处理。
15. 管理员后台
拥有管理员权限的账户可在 管理员后台完成会员、邮件、邀请返利和云端平台配置。普通用户无法访问管理页面。
| 页面区域 | 可执行操作 | 注意事项 |
|---|---|---|
| 用户列表 | 查看用户、注册时间、会员状态和到期时间。 | 用户明细在工作台弹窗中打开，不再单独跳转页面。 |
| 会员授权 | 开通/暂停会员、设置到期时间、填写操作备注。 | 保存后立即影响桌面端登录验证，并写入会员记录。 |
| 注册赠送 | 设置新用户注册后赠送的小时数或天数。 | 关闭规则时新用户只创建账户，不获得注册赠送时长。 |
| 邀请返利 | 启用规则，设置首次邀请天数和后续每次天数。 | 只统计完成邮箱验证并成功创建账户的新用户。 |
| 邮件服务 | 配置 QQ 邮箱 SMTP、发件地址和测试收件人。 | 授权码由服务端加密保存；不要在截图或文档中公开。 |
| 算力平台 | 维护最多四个推荐平台的名称和注册链接。 | 只填写公开注册链接，平台密钥和实例密码不应保存到这里。 |
| Skill 商店 | 拖拽上传 ZIP 包，填写 Skill 标识、版本、名称、描述和图标，校验后发布。 | 服务端会生成 JSON 包并自动计算 SHA-256；相同标识和版本不能重复发布。 |
15.1 发布官方 Skill
准备一个包含根目录 SKILL.md 的 ZIP 包，文件中的 frontmatter name 必须和表单里的 Skill 标识完全一致。进入后台的“Skill 商店”，拖入 ZIP，填写目录展示信息后提交；发布完成后客户端通过受保护的 Skill 接口读取并校验下载。
准备 ZIP
只放 UTF-8 文本文件，保留 SKILL.md、agents/openai.yaml 和 references 等必要目录，不要放 API Key、密码或本机绝对路径。
后台发布
选择“Skill 商店”，拖拽 ZIP 到上传框，填写标识、版本和描述，点击“校验并发布 Skill”。服务器会拒绝路径穿越、符号链接、重复路径和超大文件，并将已发布包保存到 Laravel 私有存储。
宝塔检查
确认站点根目录为 laravel-app/public，Laravel storage 可由 PHP-FPM 写入，并启用 PHP 的 zip 扩展。发布后用有效会员会话检查 /api/skills/catalog 是否返回目录。
16. 更新日志、在线更新与安装包
站点的 下载中心提供当前 Windows 安装包；应用内更新日志按版本给出概括标题，展开后查看该版本的所有功能、完善、优化和修复。
16.1 Windows 更新
标准安装版启动后会检查发布清单并显示可用版本，下载完成后由用户确认安装。下载过程可查看进度；安装失败时先检查网络、磁盘空间和安全软件拦截。便携版不支持在线更新，请从下载中心手动获取新版本。
16.2 发布信息
开发或部署排查时可查看 发布清单接口，其中包含当前版本和安装包信息。普通用户不需要手动修改清单，也不要把安装包重命名成与清单不一致的文件名。
安装包内容：发行包不包含预置模型渠道或私人 API Key。更新后如果看不到你的配置，先确认是否登录了同一账户、是否切换了本地数据目录，再检查配置备份。
17. 常见问题
收不到 QQ 邮箱验证码怎么办？
检查 QQ 邮箱地址是否完整、垃圾邮件和拦截规则；确认管理员已配置 SMTP；等待 60 秒后再点击重新发送。不要连续发送多个验证码，输入最新一封邮件中的验证码。
为什么输入 QQ 号后邮箱会自动变化？
当前注册只支持 QQ 邮箱，输入纯数字 QQ 号时系统会自动补全 @qq.com。如果你使用的是其他邮箱，请改用 QQ 邮箱注册。
点击生成提示没有可用模型？
打开设置的模型渠道，新增对应能力的渠道和模型，并为图片、视频、文本或音频指定默认模型。检查接口地址、模型名称和 API Key 后再重试。
ComfyUI 任务提交后报连接错误怎么办？
确认本地地址或 SSH 隧道仍在运行，端口没有被防火墙拦截；检查 API 工作流和模型文件。拥有本地地址的渠道会优先使用自己的端点，不会被云端回退地址覆盖。
Agent 面板显示未连接怎么办？
确认 Canvas Agent 已启动并允许当前页面连接，刷新后查看状态。网页工具可能仍可用，但涉及本地文件、桌面 SQLite 或本地 ComfyUI 的操作需要本地 Agent 在线。
批量运行时某个节点没有暂停按钮怎么办？
等待节点进入运行或排队状态后再查看；2.0.10 已为每个任务维护独立状态和停止控制。若界面仍未刷新，先保存画布、重新打开项目，再查看运行日志并记录任务节点。
网页端点击下载没有开始怎么办？
从 Windows 下载入口重新点击，检查浏览器是否拦截自动下载或跳转；也可以在新标签页打开安装包地址。服务器发布清单中的文件名必须与实际安装包一致。
账户中心打不开或显示服务初始化怎么办？
先确认已登录并刷新页面；若仍提示初始化，联系管理员完成服务端会员字段和邀请返利相关迁移，再重新登录。
换电脑后项目和资产不见了怎么办？
浏览器数据不会自动同步到新设备；桌面版也依赖当前本地数据目录。使用项目导出和资产包导入，或复制桌面端完整数据目录后再打开应用。
如何报告问题？
记录 Ember Studio 版本、入口（Web/桌面端）、复现步骤、任务节点类型和错误摘要，隐藏 API Key、邮箱授权码和密码后，通过 联系我们提交。
18. 快速入口
把下面的入口收藏起来，日常使用无需反复查找。
进入应用后常用路径：/canvas 画布、/image 图片工作台、/video 视频工作台、/assets 我的资产、/config 设置。