工程与设置

3. 首页与工程

新建工程

1. 点击「新建工程」。
2. 填写「工程名称」。
3. 点击「浏览」选择「存储目录」。
4. 点击「创建」后进入工作区。

打开工程

• 点击「打开工程」，选择工程目录中的 project.json。
• 或在「最近工程」列表中点击对应路径。

最近工程

• 列表展示近期打开过的工程路径。
• 右侧 × 表示「从最近列表移除」——不会删除磁盘上的工程文件。

4. 设置

在首页或工作区顶栏进入「设置」。修改会自动保存。

4.1 通用

• 主题：暗色 / 亮色。
• 语言：中文 / English。
• 自动保存：可启用，并设置间隔（秒）。
• 关于与更新：查看版本、检查更新（见下文）。

4.2 模型

1. 点击「添加模型提供商」，可选：
   • OpenRouter：文本 / 图片 / 视频 / 决策（聚合目录，单 API Key）。
   • OpenAI：文本（GPT 系列）/ 图片（gpt-image-1 / gpt-image-2）；需可访问 api.openai.com 的网络与境外账号，文生图走 /images/generations，参考图编辑走 /images/edits（最多 1 张）。
   • DeepSeek：仅文本（deepseek-chat / deepseek-reasoner，OpenAI 兼容）。
   • 智谱：GLM 文本（/chat/completions）+ CogView 文生图 （glm-image / cogview-4 / cogview-3-flash，/images/generations）。
   • Kimi（月之暗面）：文本（kimi-k2 系列 / moonshot-v1 系列，OpenAI 兼容，默认 Base URL https://api.moonshot.cn/v1）。
   • xAI（Grok）：文本（grok-* 对话，OpenAI 兼容，默认 Base URL https://api.x.ai/v1）+ Grok Imagine 文生图（ /images/generations，JSON body，支持 aspect_ratio）+ Grok Imagine Video 异步视频（/videos/generations 提交后轮询 GET /videos/{request_id}，支持 480p / 720p、5–15 秒与首帧图生视频）。
   • Google（Gemini）：文本（gemini-* 对话）+ Nano Banana 系列文生图 / 图生图（/images/generations，JSON body，支持 aspect_ratio / resolution / n / response_format 与 image 参考图字段）+ Veo 3.1 异步视频（/videos 提交后轮询 GET /videos/{id}，支持 720p–4K、4–8 秒与首帧图生视频），均走官方 OpenAI 兼容层 （默认 Base URL https://generativelanguage.googleapis.com/v1beta/openai）。
   • vLLM：本地 OpenAI 兼容服务（默认 http://localhost:8000/v1），无需 API Key； 部署 vLLM-Omni 扩散模型（如 Wan2.2 T2V / I2V）后支持视频生成（异步任务走 /v1/videos，可带首帧图生视频）。
   • Ollama：本地 OpenAI 兼容端点（默认 http://localhost:11434/v1），无需 API Key。
   • LM Studio：本地 OpenAI 兼容端点（默认 http://localhost:1234/v1），无需 API Key。
   • 火山方舟：文本 / Seedream 图 / Seedance 视频用方舟 API Key；声音设计走豆包语音 openspeech（语音控制台 API Key，可与方舟 Key 不同）+ 手填 speaker_id。 视频模型含 Seedance 2.5（doubao-seedance-2-5-260628：单次最长 30s、50 个全模态参考、 时间戳级片段编辑）与 Seedance 2.0 / 2.0 Fast 等。
   • 可灵：图片 / 视频（API Key）。
   • MiniMax：文本 / 图片 / 视频 / 音色设计（同一 API Key；默认 Base URL https://api.minimaxi.com）。
   • 通义千问：文本（兼容模式）/ 万相图 / 万相视频（含 HappyHorse、Wan 3.0-Video 等，百炼 API Key）。Wan 3.0-Video 支持单次 30s、10 图 + 5 视频 + 5 音频参考，公测 / 邀测中， Model ID 以百炼控制台为准。
   • 魔塔：文本 / 文生图（ModelScope 访问令牌，如 ms-…）。
   • ComfyUI：图片 / 视频 / 声音，走 API 2（POST /api/v2/jobs）。 模型 id = userdata 里的 API 格式 workflow 名（不是 checkpoint），模型列表由服务动态拉取。 视频 workflow 支持多模态参考（r2v）、视频 / 音频参考注入与首尾帧（first_frame / last_frame）注入，视频时长上限 15s。 本机默认 Base URL http://127.0.0.1:8189（需先装 comfy-api-proxy，不要直连 8188）； 云端填 https://cloud.comfy.org 并填 Key。本机可空 Key。 完整步骤见 ComfyUI 接入教程。
   • MagicRouter：多供应商聚合网关（OpenAI 兼容），文本 / 图片 / 视频； 需 mr- 开头 API Key，默认 Base URL https://api.magicrouter.ai/v1，模型目录由 /models/live 拉取，视频为异步提交 / 轮询。
   • Meshy：文生 3D / 图生 3D（含多图生 3D，API Key，默认 Base URL https://api.meshy.ai）。
   • Tripo：文生 3D / 图生 3D（API Key，默认 Base URL https://api.tripo3d.ai）。
   • Rodin（Hyper3D）：文生 3D / 图生 3D（API Key，默认 Base URL https://api.hyper3d.com/api/v2）。
   • Luma AI：文生 3D / 图生 3D（API Key，默认 Base URL https://api.lumalabs.ai/dream-machine/v1）。
   • Lux3D：文生 3D / 图生 3D / 多图生 3D（API Key，G1 / G1-Turbo， 默认 Base URL https://api.aholo3d.cn）。
   • World Labs（Marble）：空间世界生成 —— 文生世界 / 图生世界 / 多图生世界 / 视频生世界（API Key，默认 Base URL https://api.worldlabs.ai，鉴权头为 WLT-Api-Key；模型 marble-1.1 标准、marble-1.1-plus 更大世界、marble-1.0 与 marble-1.0-draft 上一代。参考媒体走官方托管上传，无需对象存储）。
   • 自定义：自选端点类型（OpenAI 兼容 / Anthropic / Gemini）并填写 Base URL 与 API Key，用于 NewAPI、one-api 等中转网关或自建服务；支持文本与图片，模型常在目录里拉不到， 需手动填 id —— 完整步骤见 NewAPI 接入教程。
2. 选择或展开提供商后，设置页会显示对应密钥申请页链接（也可直接打开）：
   • OpenRouter： https://openrouter.ai/keys
   • OpenAI API Key： https://platform.openai.com/api-keys
   • DeepSeek API Key： https://platform.deepseek.com/api_keys
   • 智谱 API Key： https://open.bigmodel.cn/usercenter/apikeys
   • Kimi（月之暗面）API Key： https://platform.moonshot.cn/console/api-keys
   • xAI API Key： https://console.x.ai/
   • Google AI Studio API Key： https://aistudio.google.com/apikey
   • vLLM 文档（本地服务无需密钥）： https://docs.vllm.ai
   • Ollama 官网（本地服务无需密钥）： https://ollama.com
   • LM Studio 官网（本地服务无需密钥）： https://lmstudio.ai
   • 火山方舟 API Key（文本 / 图片 / 视频）： https://console.volcengine.com/ark/region:ark-cn-beijing/apiKey
   • 豆包语音控制台（声音设计 API Key / speaker_id）： https://console.volcengine.com/speech/app
   • 可灵开放平台（API Key）： https://app.klingai.com/cn/dev
   • MiniMax 接口密钥： https://platform.minimaxi.com/user-center/basic-information/interface-key
   • 通义千问 / 百炼 API Key： https://bailian.console.aliyun.com/?tab=model#/api-key
   • 魔塔访问令牌： https://modelscope.cn/my/myaccesstoken
   • ComfyUI：本机可空 Key；云端 API Key 见 Comfy 开发者文档 ；本机安装 proxy 与 workflow 见 ComfyUI 接入教程。
   • Meshy API Key： https://www.meshy.ai/
   • Tripo API Key： https://platform.tripo3d.ai/
   • Rodin（Hyper3D）API Key： https://hyper3d.ai/
   • Luma AI API Key： https://lumalabs.ai/
   • Lux3D API Key： https://labs.aholo3d.cn/
   • World Labs API Key（需先在平台的 billing 页充值积分）： https://platform.worldlabs.ai/api-keys
   • MagicRouter API Key（mr- 开头）： https://www.magicrouter.ai/docs/api
3. 填写显示名称、Base URL、密钥（可显示/隐藏）。
4. 启用该提供商后，点击「拉取可用模型」（可灵 / MiniMax 部分模态 / 百炼图视频 / OpenAI 与智谱图片等为本地静态目录；vLLM / Ollama / LM Studio / ComfyUI 等本地服务无需密钥，直接拉取）。
5. 用筛选、全选/清空勾选需要的模型；也可手动添加模型 ID。
6. 按模态配置：文本 / 图片 / 视频 / 声音 / 3D 模型 / 空间世界 / 决策（OpenRouter 支持文本 / 图片 / 视频 / 声音 / 决策，决策页签走 output_modalities=decisions 拉取；TypeSafe 直连仅「决策」页签，目录走 GET /v1/models、判定走 POST /v1/systemone，与 OpenRouter 的决策协议一致但不经其中转；方舟声音页签会提示语音控制台链接，并手填 speaker_id；可灵仅图片与视频页签；MiniMax 支持文本 / 图片 / 视频 / 音色设计； OpenAI 支持文本 / 图片 / 声音；ElevenLabs 支持「声音」与「音乐」两个页签（语音合成 / 多说话人对话 / 音效生成走「声音」，音乐生成走「音乐」）； DeepSeek 仅文本；Kimi（月之暗面）仅文本；xAI（Grok）支持文本 / 图片 / 视频（视频为异步轮询）；Google（Gemini）支持文本 / Nano Banana 图片 / Veo 3.1 视频（异步轮询）；智谱支持 GLM 文本与 CogView 图片；vLLM 支持文本与视频（Wan T2V / I2V）；Ollama / LM Studio 仅文本（多模态理解可在文本节点传图）； 魔塔仅文本与图片，文生图为异步任务；ComfyUI 支持图片 / 视频 / 声音，无文本页签；MagicRouter 支持文本 / 图片 / 视频；Meshy / Tripo / Rodin（Hyper3D） / Luma AI / Lux3D 仅 3D 模型页签；World Labs（Marble）仅空间世界页签；自定义提供商的页签由端点类型决定 —— OpenAI 兼容 / Gemini 为文本 + 图片，Anthropic 仅文本，且图片模型必须手动填 id，见 NewAPI 接入教程）。
7. 声音（TTS）：OpenAI / OpenRouter 的声音页签走 POST /audio/speech， 请求体是 model + input + voice（可选 response_format / speed）—— 这是 OpenAI 的 TTS 协议形状，各类聚合器（new-api / one-api / 自建网关）都按它对接，把 Base URL 换成网关地址即可直接使用。 模型目录：OpenRouter 走 /models?output_modalities=speech（能拿到 supported_voices）， OpenAI 用本地静态表（GET /models 只给 id、不给音色列表）；聚合器上的模型也可手填 id。 ElevenLabs 走自己的协议：POST /v1/text-to-speech/{voice_id} （鉴权头 xi-api-key），模型目录 GET /v1/models、音色目录 GET /v1/voices。 它的 voice_id 是不透明字符串，所以面板里显示的是音色名 （如 Sarah - Mature, Reassuring）；音色目录公开可读，没填 Key 也能先看模型与音色。 同一把 Key 还接了两条既有管线：语音转文字（Scribe，时间线的「配音转字幕」）与 音乐生成（BGM / 音效）。这三个端点混在同一份模型目录里，声音节点的下拉只列 TTS 模型。 音色在声音生成节点的指令面板里填（不在这里）：音色是按节点生效的参数， 同一张图里不同配音节点本就该用不同音色；候选来自接口返回的 supported_voices （OpenRouter 文档页不列，但 /models?output_modalities=speech 会返回，实测 23 个语音模型里 18 个有， 最长的微软 MAI Voice 有 97 个），可按应用语言优先排序。 留空则用模型自己的默认音色（我们不会替你猜一个音色名发给上游 —— 各家的音色命名并不通用）。 少数模型（如 bytedance-seed/seed-audio-1-0）没有音色列表： 它的音色由提示词描述决定，留空即可。
8. 另外两个声音类节点（ElevenLabs 专属端点，产物同样是声音资产）：
   • 多说话人对话：一次合成整段对白。指令框里按行写 说话人: 台词（中英文冒号都认），例如 A: 你终于来了。 / B: 路上堵车。； 没有冒号的行沿用上一段的说话人（旁白 / 连续独白）。 每个说话人在节点指令面板里绑定一个音色（未绑定的回退到节点默认音色）， 缺音色会明确报出是第几段、哪个说话人。
   • 音效生成：走 POST /v1/sound-generation， 描述的是声音本身（如「雨落在铁皮屋顶上」），而不是台词。 指令面板里可选「可无缝循环」（环境音长播时必开：接缝不再咔嗒）、 「期望时长」（规范范围 0.5–30 秒）与「提示词影响力」 （0–1，默认 0.3）；落盘到 Cache/Sfx。 那个端点的模型是唯一取值（eleven_text_to_sound_v2）， 所以卡片上的下拉实际是在选用哪个提供商实例（多账号 / 多 Key 时才有意义）， 标题已写明「模型固定为 …」。没有可用提供商时会明确报错，不会退回语音合成。
   这两个节点与「配音转字幕」一样，都复用同一把 ElevenLabs Key。
9. 音乐（BGM）走另一个页签：ElevenLabs 的 POST /v1/music 归在「音乐」页签下（与「声音」分开）—— 音乐是编曲（prompt + 歌词 / 纯音乐）， 语音合成是 TTS（text + voice），两边的端点与模型体系都不同。 同一页签下还能勾 OpenRouter（Google Lyria 3）、MiniMax（music-3.0）与 通义千问 · 百炼（fun-music-v1）的音乐模型；音乐节点下拉只列音乐模型， 不会出现 TTS 模型。升级前把音乐模型勾在「声音」页签的旧设置会自动迁移过来。
10. 设置默认生成模型（如需要）。提供商卡片可折叠以节省空间。

4.3 对象存储

用于将本地参考视频等上传为可公网访问的 URL（私有桶时使用签名链接）。

• 「添加对象存储」→ 选择其一：
  • 火山引擎 TOS：AccessKey / SecretKey、Region、Endpoint、Bucket。
  • 阿里云 OSS：AccessKey / SecretKey、Region、Endpoint、Bucket。
  • 腾讯云 COS：SecretId / SecretKey、Region、Bucket（通常为 BucketName-APPID）。
  • 兼容 Amazon S3：Endpoint、Region、Access Key、Bucket。填写方法见 Yandex Object Storage 示例。Cloudflare R2、Backblaze B2、Wasabi、MinIO、Amazon S3 用同一张表单。
• 密钥申请页（设置中亦有外链）：
  • 火山引擎： https://console.volcengine.com/iam/keymanage
  • 阿里云 RAM： https://ram.console.aliyun.com/manage/ak
  • 腾讯云 API 密钥： https://console.cloud.tencent.com/cam/capi
• 公网访问域名（CDN / 自定义域名）可选；未填时使用签名 URL（约 24 小时有效）。
• 同时只能启用一个对象存储；勾选启用会自动关闭其它项。卡片支持折叠。

以 Yandex Object Storage 为例配置兼容 Amazon S3

「兼容 Amazon S3」使用标准 Amazon S3 API（Signature V4）。下面用 Yandex Object Storage 走一遍。Cloudflare R2、Backblaze B2、Wasabi、MinIO、DigitalOcean Spaces 和 Amazon S3 本身也是这一张表单，只改 Endpoint、Region 和路径样式。

1. 在 Yandex Cloud 控制台创建一个 Object Storage 桶。步骤见 创建桶。
2. 创建一个服务账号，授予角色 storage.editor。应用会上传，也会删除对象，这个角色两项都包含。
3. 为该服务账号创建静态访问密钥，记下 Access Key ID 和 Secret。Secret 只显示一次。创建入口见 静态密钥。
4. 回到应用：设置 → 对象存储 →「添加对象存储」→ 选择兼容 Amazon S3。
5. 按下表填写，勾选启用。

路径样式保持开启后，对象地址是 https://storage.yandexcloud.net/<桶名>/<对象键>。桶名里带点（例如 example.ru）时，HTTPS 也使用这个地址。

公网访问域名留空时，私有桶会生成约 24 小时有效的签名链接，模型可以直接拉取。桶已公开，或绑定了自己的域名时，再填写公网域名，例如 https://<桶名>.storage.yandexcloud.net。

换到其它兼容 Amazon S3 的服务时，仍选「兼容 Amazon S3」，只改下面三项：

4.4 扩展

应用内部扩展走 Cordis（ctx.editor.*），可贡献节点、卡片、检查器、Skill 与执行器覆盖等；开发说明见仓库 GRAPH_PLUGINS.md。 设置页只读列出用户数据目录 plugins 下的声明式扩展。当前不会执行外部任意脚本，仅展示已声明的扩展信息。 正式安装包默认不加载「图插件示例」演示。

4.5 MCP 工具服务

应用内置 MCP 工具服务，供 Claude Code / Codex 等外部 AI Agent（以及内置 AI 对话面板）调用——规划并落盘工作流、运行生成、读写资产与节点图。 详细接入步骤见 MCP 接入教程。

• 启动 / 重启：设置页显示运行状态与端口；端口默认 43110，被占用时依次尝试 43110–43119。修改端口或点击「重启」后应用工具服务会以新端口拉起。
• Token：可显示 / 复制 / 编辑；跨重启保持不变，配置一次即可长期使用。 怀疑泄露时点「重置 Token」——重置后旧 token 立即失效，客户端需用新 token 重新注册。
• 接入命令：一键复制 claude mcp add --transport http … 命令， 在终端执行即可把应用注册为 Claude Code 的 MCP server（HTTP 直连，无需 Node.js）。

设置面板另提供 「stdio 桥」可视化配置：可改 stdio 桥命令（默认仍是 node + 仓库内 scripts/mcp-bridge.mjs 或安装包内置 <安装目录>/resources/mcp-bridge.mjs）、桥 HTTP 监听端口、Blender addon 的 BLENDER_HOST / BLENDER_PORT 透传。 修改即时落盘，外部 Agent 重连即生效，不需要重启应用。

同一设置面板还支持 「反向桥」：注册任意外部 stdio MCP server（如 Blender addon / 其它本地 MCP 服务），让应用内 ◈ AI 对话面板（DeepSeek Harness / dsh）也能直接消费 它们的工具 —— 不再需要它们额外暴露 socket 端口。详见 MCP 接入教程里的反向桥段。

另外，第三方 MCP 服务（HTTP 远程 / stdio 本地命令）也可以在 插件市场的 MCP 页签里添加与管理。