关于 Scumble
Scumble 是面向图像创作者的 AI 图像编辑桌面应用,可进行修补、编辑、放大和生成,并保留可编辑结果。每次生成都作为独立图层,Agent 也可通过 MCP 操作命令。
主要功能
- 01将生成结果保留为独立图层
- 02选择区域并描述修改内容
- 03使用方框和参考图像
- 04通过 ComfyUI、Comfy Cloud 或 API 密钥运行模型
- 05导出分层 PSD 和 OpenRaster 文件
- 06向 Agent 提供编辑器命令
适用场景
- 01修补选定区域并保留编辑能力
- 02描述画布区域中要放置的对象
- 03使用现有 ComfyUI 工作流编辑图像
- 04导出分层作品以便继续编辑
MCP 相关
Scumble 通过 MCP 服务提供编辑器命令,MCP 客户端可使用 116 种工具,在应用内打开、选择、生成、匹配和导出内容。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Scumble
一款面向 ComfyUI 和你现有模型的 AI 原生图像编辑器。
修补、编辑、放大和生成,每次编辑都会作为独立图层返回。
⭐ 在 GitHub 上点星 · 下载 · Microsoft Store
获取 Scumble
| 平台 | 获取方式 | 备注 |
|---|---|---|
| Windows | Microsoft Store,或 winget install scumble | 由 Microsoft 签名,不会出现 SmartScreen 警告,由 Store 更新 |
| Windows | 安装程序:Scumble-Setup-<version>.exe | 自动更新;尚未进行代码签名,因此 SmartScreen 会提示一次 |
| Windows,便携版 | Zip:Scumble-<version>-portable-win-x64.zip | 无需安装;数据保存在程序旁边的文件夹中 |
| Linux(x64) | AppImage 或 .deb | 由 CI 构建的早期版本,作者尚未运行测试;欢迎反馈 |
| macOS | 尚未提供 | 计划中,尚未开始 |
Scumble 免费使用,无需注册自己的账号。详情以及渲染所需内容,请参阅 安装。
它能做什么?
Scumble 是一款围绕 AI 模型打造的桌面图像编辑器。选中图片的一部分,或在空白画布上画出方框,描述其中应该出现什么,生成结果就会作为独立图层返回;图层边缘会淡化,并与周围图像匹配颜色。你可以像处理其他图层一样为它添加蒙版、混合、滤镜并导出。它可以通过你自己的 ComfyUI(运行在本机或远程设备上)、Comfy Cloud,或你可能已经拥有的 FLUX、GPT Image、Nano Banana、Seedream 等 API 密钥进行渲染:只需密钥,无需 ComfyUI。它是免费软件(GPL-3.0),目前可在 Windows 上运行,且还很新(0.1.x),因此可能不够完善,请务必备份图片。
五项出色功能
每个结果都是独立图层
生成结果会作为新图层置于选区上方,边缘经过淡化,并与周围图片匹配颜色。图层行中的 Match 滑块可随时调整匹配程度,而且其他效果也不会被烘焙进图层:你可以为图层添加蒙版、擦除部分内容、更改混合模式,以及在其上方添加滤镜和文本。只有合并图层后,图片才会变成单一图层。状态栏和历史记录中的结果行会显示运行位置(“通过 Comfy Router 使用 FLUX 3 Image,23 秒”,或“通过你的 ComfyUI”)。如果生成结果稍有偏移或缩放,程序会根据图片边缘对齐;之后也可以在图层菜单中使用 与下方图层边缘匹配,达到相同效果。

指定内容放置位置:框和 @img1
在图片上绘制方框,并描述每个方框:新增内容、保留内容、移动或移除的内容、放置的参考图片、渲染的文字。Black Forest Labs 的 FLUX 3 Image(Scumble 在其支持的每个服务商上都可运行;也可在你自己的 ComfyUI 上运行其开放的 Klein 模型)会连同提示词一起接收方框,并获知每项内容的放置位置;fal 上的 Ideogram 4 会接收新增、保留和文字方框;而你自己的 ComfyUI 上的 MOSS-Image 则会根据新增和文字方框排布一张新图片。参考图层在提示词中命名为 @img1、@img2,每张图片都会以所选模型识别的名称传入。
使用你的 ComfyUI、Comfy Cloud,或只用你的密钥
使用配方而非节点图:你可以选择模型和运行位置。在你自己的 ComfyUI 上(无论是在本地还是 RunPod 等租用的机器上),任何包含 Inpaint Canvas 节点的工作流都会成为配方,而 ComfyUI 按钮会在编辑器旁打开你自己的 ComfyUI 页面,让你修改配方的节点图并保存回来。Comfy Cloud 通过 Comfy 官方 SDK 使用你的 Comfy 密钥运行,内含 13 个来自 Comfy 自有模板的配方,同一密钥也可通过 Comfy Router 使用合作伙伴模型。或者在 Settings › API providers 中粘贴密钥:Black Forest Labs、OpenAI、Google、fal.ai、Replicate、OpenRouter 等。密钥会存入系统的凭据存储区,不会写入设置文件。
Agent 可以操控它
每项功能都是一条命令,而这些命令构成一个 MCP 服务:使用 Help › Copy MCP registration(或者,对于 Claude Desktop,使用每个版本随附、可一键安装的 .mcpb 文件),Claude Code、Claude Desktop 或任何其他 MCP 客户端就能在同一个窗口中使用 116 个工具来打开、选择、生成、匹配和导出,并共享同一套撤销记录。(此外还内置了一个可使用你自己的密钥的聊天助手;请参阅助手。)
为实际文件而打造
支持带图层和蒙版的 PSD 导出,以及带图层的 OpenRaster;两种格式重新打开时都会保留图层。采用已编译 Rust 内核的分块引擎可让 15,000 × 10,000 像素的文档在绘制、选择和导出时不会卡住窗口;宽高最大达 65,535 像素的 PNG 也能以分条方式打开和保存。滤镜也可以作为图层使用,并在 GPU 上运行:46 种胶片效果、颗粒、曲线、LUT 等。

编辑器截图中的照片(蓝色汽车上的女子)是一张用于展示功能的示例图片;其中没有任何内容是用 Scumble 生成的。顶部和下方的咖啡馆图片则是在 Scumble 中使用 FLUX 3 Image 制作的。
前 / 后对比
左侧是在空白画布上绘制并描述的三个方框;右侧是 FLUX 3 Image 使用 Generate new 根据这些内容生成的图片。
安装
Windows(10 和 11,64 位)
-
**Microsoft Store:**在 Microsoft Store 中的 Scumble 获取,或在 终端中运行:
winget install scumble(winget 安装的是同一个 Store 版本,可能会先要求你接受 Store 的条款。)Store 版本由 Microsoft 签名,因此安装时不会出现 SmartScreen 警告,且 Store 会让它保持最新。Microsoft 完成认证后,新版本才会在 Store 上架,因此有时会比 GitHub 发布晚一些。Store 版本使用独立的设置、密钥和文件(
%APPDATA%\Scumble Store),因此可以与 GitHub 版本并存。 -
**从 GitHub 下载安装程序:**从最新发布版本下载
Scumble-Setup-<version>.exe。目前尚未进行代码签名,因此 SmartScreen 会显示一次“Windows 已保护你的电脑”:点击 更多信息,然后点击 仍要运行。之后,应用会自行下载更新,并在重启以应用新版本前征求你的同意。 -
**便携版 zip:**从同一发布页面下载
Scumble-<version>-portable-win-x64.zip。将其解压到你有写入权限的文件夹中,例如C:\Tools(不要放在 Program Files 或 OneDrive 同步的文件夹中),然后启动其Scumble文件夹中的Scumble.exe(与安装程序一样,SmartScreen 会提示一次)。所有数据都会保存在旁边的data文件夹中,因此它可以与已安装的 Scumble 并行运行。 它不会自动更新:有新版本时会通知你,你只需将新 zip 解压到旧版本上(data文件夹会保留)。API 密钥会针对 Windows 账户加密,因此在另一台电脑上必须重新输入(之后,也可能需要在第一台电脑上重新输入)。
Linux
同一发布版本还包含 scumble-<version>.AppImage 和 scumble-<version>.deb(x64)。**这些版本由 CI 构建,作者尚未运行测试;欢迎在
问题跟踪页反馈。**详细信息请见下文的 Linux 说明。
macOS
已列入计划,但尚未开始。
渲染所需条件
-
**只需一个 API 密钥:**在 设置 › API providers(Ctrl+,)中粘贴密钥并点击 Save。无需 ComfyUI 或服务器;你直接向服务提供商付费。助手和提示词增强共用这些密钥。
-
**你自己的 ComfyUI:**在其中安装节点包 ComfyUI-InpaintCanvas,并安装所选配方所需的模型。使用 git 将该包安装到 ComfyUI 的
custom_nodes文件夹中,然后重启 ComfyUI(该包不需要额外的 Python 包):cd ComfyUI/custom_nodes git clone https://github.com/DenRakEiw/ComfyUI-InpaintCanvasComfyUI Manager 目前尚未列出该节点包;之后如果列出了,你也可以从那里安装。然后在 Scumble 顶栏中输入服务器地址并点击 Connect。Scumble 会在连接时检查该节点包是否存在,并在缺少时告知你;它不会为你安装。FLUX 3 Image Klein 的节点需使用 GitHub 上的当前版本(Comfy Registry 的 0.3.4 版本目前还没有该节点):在其文件夹中运行
git pull来更新克隆版本,若安装的是 Registry 版本,则用上面的克隆版本替换,然后重启 ComfyUI。 -
**Comfy Cloud:**在 设置 › API providers 中填写你的 Comfy 密钥;同一密钥也可用于 Comfy Router。
即使没有上述任何条件,Scumble 仍可打开、绘画、选择、分层、应用滤镜、保存和导出;下载后,其内置模型(对象选择、背景移除、Remove、深度图)也会在你的本机上运行。
演示:视频和手册
- 视频: 共 4 集,由两位讲述者录制,其中一位持怀疑态度,均在应用中录制:"Scumble,由一位并未主动要求介绍的人讲解"(4:40)和 "Scumble,第二集:他还有更多问题"(4:03),使用 0.1.28 版本;"Scumble,第三集:客户端有一些意见"(5:34,0.1.42:FLUX 3 Image 的框、提示词中的参考照片);以及 "Scumble,第四集:周五演出"(5:18,0.1.46:深度图、镜头模糊和雾霾、27 种混合模式)。
- 手册: 从第一张图片到导出。应用内也附带了同一份手册:按 F1 可在图片旁打开手册,支持搜索且可离线使用;使用任何 API 密钥,聊天功能都能根据手册回答问题。手册源文件位于 docs/MANUAL.md。
⭐ 如果你喜欢它
如果 Scumble 对你有用,可以在 GitHub 上点个星标,帮助其他人发现它。遇到问题?请提交 issue,说明你做了什么以及发生了什么;Ctrl+Shift+L 可打开控制台,其中会显示日志文件的路径。正在构建什么、测量了什么以及哪些功能尚未奏效,都记录在开发博客中;CHANGELOG.md 列出了每个版本。
已进行的实测
Scumble 目前处于 0.1.x 阶段,并非每项功能都经过端到端测试。目前已使用真实服务运行测试的功能包括:通过 ComfyUI 进行本地渲染(包括带框的 FLUX 3 Image Klein)、应用内辅助模型、胶片包、命令核心、MCP 服务、大型文档的平铺引擎和自动更新;API 提供商方面包括 Black Forest Labs 上的 FLUX 3 Image(带框)、OpenRouter 和 Comfy Router(从 0.1.49 起也通过 Comfy Router 的 SDK);通过 OpenRouter 使用 GPT Image 2.5;通过 Comfy Router 使用 GPT Image 2 和 Nano Banana 2;通过 Comfy 的 Partner API 使用 HY Image 3.5;fal 上的 Ideogram 4(带框);Comfy Cloud 上的 Qwen Image 2.1 Edit;通过 Comfy Cloud 的 SDK 和 API v2 使用 Z-Image Turbo、Flux.2 Klein 9B 和 Nano Banana 2 的一次编辑(在 Comfy Cloud 上取消任务后,Comfy 端也停止了任务);以及 Magnific 上的放大器 Magnific Precision 和 Creative、fal 上的 Topaz Precision;本地 ComfyUI 上的 Realism Pass(仅限 Windows 和 RTX)和 RTX Video Super Resolution,后者也在 Comfy Cloud 上进行了测试。其他 API 接入方式是根据提供商的文档构建的,尚未在实际服务上运行测试;relight 的模型接入、助手的模型调用、在第二台电脑上的便携 zip,以及 Linux 构建也尚未测试。
功能详解
选择、提示词、生成

- 可通过画笔、矩形、椭圆、套索、魔棒、悬停对象或框选(应用内使用 SAM2)、深度、亮度或颜色范围,或文本(在你的 ComfyUI 上使用 SAM3)进行选择;还可扩展、收缩、羽化、反选、从图层创建,以及使用已保存的选区。
- 图片的深度图由应用计算(Depth Anything V2 Small,选择 › 深度),并随文档保存:可用于选择、限制滤镜图层,以及控制镜头模糊、雾霾和 Relight。
- 模型:Black Forest Labs 的 FLUX 3 Image、FLUX.2(max、pro、flex、klein)和 FLUX.1 Fill;GPT Image 2.5 Flare / Sunburst 和 GPT Image 2;Nano Banana 2.1、2、2 Lite 和 Pro;Seedream 5 和 4.5;Qwen Image Edit 和 Qwen Image 2.1;Ideogram 4 和 4.5;Grok Imagine、Krea 2、Recraft V4、Reve、Z-Image 和 HY Image 3.5;Magnific 的 Mystic、Ideogram 图像修复和 Image Expand 扩图。Scumble 提供模型自有 API 时,便会通过该 API 运行;也可通过 ToAPIs、fal.ai、Replicate、WaveSpeedAI、Comfy Cloud、Comfy Router、OpenRouter、Oxen.ai 和 Magnific 运行。API 运行会按提供方实际接受的尺寸发送,并附上你的参考图层。
- 在你自己的 ComfyUI 上使用:FLUX 3 Image Klein,Black Forest Labs 的开源模型(ComfyUI 0.41 或更高版本;可使用最多另外三张图片编辑选区,使用 生成新图 创建新图片,并支持框选;Black Forest Labs 的提示词扩写器会先扩写你的提示词,前提是其文件位于你的 ComfyUI 上;其权重遵循 Black Forest Labs 自有许可);Flux.2 Klein 4B / 9B、Qwen Image Edit 2.1 及其 Turbo,以及 MOSS-Image(ComfyUI 0.42 或更高版本;使用 生成新图 创建新图片,并根据你框选的内容生成 JSON 布局;Apache-2.0);下方还提供放大、真实感处理和重打光配方。
- 只要工作流中包含 Inpaint Canvas 节点,就能将其用作配方。ComfyUI 窗口(Ctrl+Shift+K)会显示你的 ComfyUI 页面或 Comfy Cloud;在 ComfyUI 中编辑 会在那里打开配方的图形,而 保存到配方 或 另存为新配方 则会将其带回。
- 除了 本地 和 API 模式,Comfy Cloud 还有自己的模式。Scumble 附带来自 Comfy 模板的 13 个配方(用于图像编辑,以及使用「生成新图」创建新图);Cloud 副本 可将你的 ComfyUI 配方转换为可在 Comfy Cloud 运行的配方,而在 Comfy Cloud 上创建的工作流则会原样导入。Comfy Cloud 和 Comfy Router 通过 Comfy 官方 TypeScript SDK(
@comfyorg/sdk)运行。取消 可在 Comfy 一侧停止 Comfy Cloud 或 Comfy Router 作业;状态行中的进度条会逐节点显示 Cloud 运行进度。如果 Scumble 关闭或崩溃时 Cloud 作业仍在运行,Scumble 会在下次启动时查询该作业,并将其图片作为独立文档打开。 - 生成新图 仅根据提示词创建基础图片,可在本地生成,也可通过提供方生成,然后再以此为基础进行编辑。顶部栏中的 新建 可为模型创建空白画布,并采用模型支持的宽高比和尺寸等级(1k、2k、4k),这样绘制的框选就会符合最终图片的形状;随后打开的「生成新图」会沿用该选择。
- FLUX 3 Image、你自己的 ComfyUI 上的 FLUX 3 Image Klein 和 MOSS-Image(需使用 Inpaint Canvas 节点的当前版本,参见渲染所需条件),以及 fal 上的 Ideogram 4 均支持在提示词中使用框。使用框工具(X)绘制框,双击可直接在图片上描述该框;提示词下方的一个开关可启用或禁用这些框,框会随文档保存。启用开关后,如果没有绘制任何框,选区就会作为一个框发送。Ideogram 4 支持新建框、保留框和文本框(不支持移动框、移除框或参考框)。
- 可通过已保存的 API 密钥或本地 OpenAI 兼容服务器扩写提示词,并可使用自己的 Markdown 模板编写提示词规则。
修饰、放大、精修
- 克隆、修复、涂抹、减淡和加深、液化,以及用于处理整个区域的 Patch。Remove 和 Content-aware move 使用 LaMa 填充,这是一个在 Scumble 内运行的模型:无需提示词、无需密钥、无需 ComfyUI(在 Settings › Helpers (in-app models) 中下载一次即可)。
- 对象蒙版(SAM2)、背景移除(BiRefNet、RMBG)和深度图(Depth Anything V2 Small)通过 ONNX Runtime 在应用内运行。
- Upscale 可处理选区(结果会作为图层返回)或整张图片(图片会成为新的底图,所有图层和蒙版也会一并缩放,且只需一步撤销)。可通过各自的提供方使用 Topaz、Clarity、SeedVR2、Recraft 和 Magnific;也可使用你自己的 ComfyUI 中的放大模型;还可在你的 ComfyUI 或 Comfy Cloud 上使用 RTX Video Super Resolution,放大 1 到 4 倍(在你的 ComfyUI 上使用时,需要 RTX 显卡和节点包 Nvidia_RTX_Nodes_ComfyUI;该节点包的当前版本需要
nvidia-vfx0.2 或更高版本;安装命令见 docs/RECIPES.md)。 - Realism Pass(仅限 Windows、仅限 RTX),用于生成图片的精修器:它会将图片发送到你自己的 ComfyUI,并将返回结果作为新图层添加,使生成图片中的皮肤、头发和织物看起来更自然;在 1.5× 到 3× 下,它会在同一步骤中放大图片。需要在装有 RTX 30、40 或 50 系列显卡的 Windows 设备上运行 ComfyUI,并在那里安装带运行时的社区节点包;Scumble 不附带这些组件,也没有 Comfy Cloud 版本。请参阅手册中同名章节的操作步骤。
图层、滤镜、文本
- 完整的图层堆栈:绘画、图像、文本和滤镜图层、组、蒙版、27 种混合模式(从正片叠底和滤色到强光混合、除法和明度;在画布、导出文件和 PSD 文件中的效果一致)、不透明度、变换、裁切和扩展(这是扩图的起点)、在标签页之间复制和粘贴整个图层,以及将 SVG 文件作为图层。
- 按图层进行非破坏性颜色匹配,可与图层周围的图片或下方内容匹配。
- 通过 GPU(WebGL2,也可回退到处理器)运行的滤镜图层:带胶片预设的颗粒、曲线、色阶、色彩平衡、色彩分级、八通道 HSL、自然饱和度、渐变映射、阈值、色调分离、LUT(.cube)、暗角、锐化、模糊、基于深度图的镜头模糊、雾化和去雾等;每种滤镜都可限制在特定的深度、亮度或颜色范围内。胶片包插件新增 46 种胶片效果、卤化效应、辉光、漂白旁路、交叉处理、分离色调、漏光、边框和控制点;效果包新增色差偏移和玻璃位移效果。
- Relight(Layer › New Relight Layer):一种滤镜图层,可通过深度图重新为图片打光;使用 Lights 工具(L)可放置最多四个点光、聚光或太阳光源,每个光源都可设置色温或颜色、强度和柔和度;还支持柔和阴影、光泽、聚光灯图案和八种预设。Render 则会通过模型处理图片(Magnific Relight、fal 上的 IC-Light v2 或 Bria、你自己的 ComfyUI 或 Comfy Cloud 上带 relight LoRA 的 Qwen Image Edit 2509),并将结果作为像素图层添加。Agent 可使用
relight命令,也可以按名称指定预设。 - 形状工具、从
.abr文件导入的自定义画笔,以及可在图片中放置并自带光源的 3D 对象(.glb)。 .scumble文档会保留所有可编辑内容(图层、滤镜、文本、3D 对象、提示词和结果)。可按比例或指定尺寸的画框导出为 PNG、JPEG、WebP、TIFF、PSD 和 ORA;AI label 面板可添加欧盟针对 AI 生成内容的标签。
助手
画布旁的聊天栏(Ctrl+Shift+A),使用你自己的密钥:Anthropic、OpenAI、Google,或任何兼容 OpenAI 的端点(OpenRouter、DeepSeek、Moonshot / Kimi、Z.ai / GLM、ToAPIs、WaveSpeed、Oxen.ai,或本地服务)。它通过与 MCP 客户端相同的命令驱动编辑器。任何会产生费用、在你的 ComfyUI 上排队、清空撤销栈或触及它未创建的图层的操作,都会先征求确认。Ctrl+Z 可撤销它的每一步;聊天会连同截图一起保存,Settings › Assistant 可删除它保存的所有内容。各提供商会发送哪些数据,以及费用详情:docs/ASSISTANT.md。
大图、插件、Agent
- 瓦片引擎会以瓦片形式保存图片、每个图层和每个蒙版,像素内核则以编译后的 Rust 在工作线程中运行。超出浏览器画布限制的 PNG(每边最多 65,535 px,约 10 亿像素)会分条打开和保存。
- JavaScript 插件(带 GPU 和处理器路径的滤镜、面板、菜单操作、工具、命令),以及包含 116 条文档化命令的命令核心,其中 96 条为核心命令,20 条来自内置插件(docs/COMMANDS.md、docs/PLUGINS.md)。
- 可供任何 MCP 客户端使用的 MCP 服务(每次发布都会附带一个
.mcpb包,供 Claude Desktop 使用),另有供脚本使用的--headless和--cmd(docs/MCP.md)。 - 状态栏会以红色显示错误,旁边还有一条细进度条,会跟踪每次运行:显示 ComfyUI 上的节点和采样器步数、Comfy Cloud 上的节点,以及其他提供商上的耗时秒数。
- 支持会话恢复的标签页、本地文件镜像(无需服务即可重新打开作品)、控制台和日志文件;可从 GitHub Releases 更新,并会在重启前显示发布说明。
Linux 说明
AppImage:为其运行 chmod +x 后启动;它会像 Windows 应用一样自动更新(.deb 不会:请将新版安装到旧版上)。在 Ubuntu 23.10 及更高版本中,AppArmor 对非特权用户命名空间的限制可能会阻止 Electron 沙箱启动,从而导致 AppImage 无法启动;.deb 会正确安装沙箱辅助程序。在 Linux 上,辅助模型在处理器上运行。API 密钥会保存到桌面环境的密钥环中(GNOME Keyring、KWallet);如果没有密钥环,Settings › API providers 会提示密钥仅经过混淆处理。
入门
使用 API 模型时,请将其密钥填入 Settings › API providers(Ctrl+,)。使用自己的 ComfyUI 时,请在顶部栏输入其 URL(默认值为 http://127.0.0.1:8188)并按下 Connect;如果该地址没有 ComfyUI 在运行,圆点会保持灰色并显示“No ComfyUI running”,只有 ComfyUI 配方和通过文本进行选择才需要连接。然后打开图片(Ctrl+O、拖放或粘贴)、绘制选区、输入提示词并点击 Generate(Ctrl+Enter)。Ctrl+S 会将文档保存为 .scumble 文件,Ctrl+Shift+E 会导出图片。每个文档都是一个标签页(Ctrl+T 新建、Ctrl+W 关闭、Ctrl+Tab 切换到下一个);即使另一个标签页显示在前台,运行也会继续。Ctrl+Shift+A 可打开助手,F1 可打开手册。
编辑器上传或接收的每张图片都会保存在 %APPDATA%/Scumble/files/ 下(便携版副本中则保存在 Scumble.exe 旁的 data/files/),并存放于与 ComfyUI 目录结构一致的 input/ 和 output/ 文件夹中。服务只保存副本:每次运行前,应用都会上传服务端缺少的文件,因此新建或重启后的 ComfyUI(RunPod)无需重新加载文档也能正常工作;即使没有连接服务端,上次会话也会在下次启动时恢复。
从源代码运行
npm install
npm start
npm run dist 会构建安装程序(dist/Scumble Setup <version>.exe,NSIS,未签名),随后 npm run dist:portable
会从同一构建生成便携版 zip(dist/Scumble-<version>-portable-win-x64.zip)。发布版本由 GitHub
Actions 构建:与 package.json 中版本匹配的 v<version> 标签会构建一个草稿发布版本,其中包含安装程序、其 blockmap、
latest.yml(自动更新源)、便携版 zip、.mcpb 捆绑包,以及 Linux AppImage、.deb 和
latest-linux.yml;发布说明取自 CHANGELOG.md 中该版本对应的部分,如果没有则停止构建。
发布草稿后,应用即可看到该版本。Rust
像素内核已提交为 renderer/editor/px/px.wasm;运行 python tools/build_px.py 可重新构建。
测试位于 tools/ 中(docs/TESTING.md 说明了每项测试的覆盖内容),tools/run_gates.sh 会在全新实例上运行
其中一组测试。关于发布构建方式、审批人员以及应用通过网络发送的内容,请参阅代码签名政策。开发说明见 CLAUDE.md。
目录结构
electron/main/ main process: window, scumble:// scheme with the ComfyUI proxy, websocket, menu, dialogs, settings,
file mirror, keys.js (safeStorage), recipes.js, llm.js + llm_custom.js (prompt upsampling, the user's
own models), providers/ (one adapter per API provider), onnx/ (SAM2, matting), plugins.js,
updater.js (GitHub releases), bridge.js + local.js + mcp/ (agents), assistant/ (the loop, the
policy, the four model adapters, the chat store), comfyview.js (the ComfyUI window),
documents.js + docfile.js (.scumble files)
electron/preload.js
renderer/ shell.js (connection bar, recipe picker, tabs, settings), commands.js (the command core),
plugins.js (plugin loader and the `scumble` API), assistant.js (the chat panel)
renderer/editor/ the editor, shared with the ComfyUI node (docs/BUILD_NODE.md); host.js is the app side of it,
inpaint_filters_gl.js the WebGL2 filter path, stitch.js the in-app crop / stitch for provider runs,
inpaint_tiles.js + inpaint_arena.js + inpaint_pool.js the tile engine and its workers, px/ the Rust
kernels (wasm), inpaint_bands.js the strip writers
crates/px/ the Rust source of the pixel kernels
recipes/ ComfyUI recipes, Comfy Cloud recipes and model recipes (one per model, a variant per provider),
docs/RECIPES.md
plugins/ built-in plugins: sample, film (the film pack), effects (chromatic shift and glass),
glb (3D objects), ailabel (the EU AI label), boxes (boxes in the prompt), and two skins
docker/runpod/ Dockerfile + provision.sh for a ComfyUI box on RunPod (draft, docs/RUNPOD.md)
tools/ build_node.py (the node's editor), build_px.py (the kernels), cdp.py (DevTools driver), the tests,
run_gates.sh
docs/ MANUAL.md, BRIEF.md (vision, decisions, phases), ASSISTANT.md, COMMANDS.md, PLUGINS.md, FILM.md,
MCP.md, RECIPES.md, HELPERS.md, TESTING.md, CODE_SIGNING_POLICY.md and more, images/
.github/workflows/ build.yml (Windows installer, portable zip and .mcpb, Linux AppImage and .deb, draft release on a
version tag)
编辑器与 ComfyUI 节点 Inpaint Canvas 使用相同的代码: 如果你在 ComfyUI 中工作,也可以在那里使用相同的画布。
许可证
GPL-3.0,与 Inpaint Canvas 节点和 ComfyUI 使用相同的许可证。请参阅 LICENSE。可免费使用、修改和
再分发;修改后的版本必须以相同许可证发布。捆绑字体采用 OFL / Apache 许可证,
请参阅 renderer/editor/fonts/licenses;FLUX 3 Image Klein 配方附带 Black Forest Labs 的提示词上采样指南
(Apache-2.0),请参阅 recipes/licenses。颗粒预设和胶片包中的胶片名称是其
所有者的商标;这些效果是 Scumble 自行近似制作的效果,并非授权产品。ToAPIs 和
WaveSpeedAI 的 获取密钥 链接包含作者的推荐码。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
