mcpField
S
Scumble

Scumble

本地服务
github.com媒体与设计1554 天前更新

关于 Scumble

Scumble 是面向图像创作者的 AI 图像编辑桌面应用,可进行修补、编辑、放大和生成,并保留可编辑结果。每次生成都作为独立图层,Agent 也可通过 MCP 操作命令。

主要功能

  1. 01将生成结果保留为独立图层
  2. 02选择区域并描述修改内容
  3. 03使用方框和参考图像
  4. 04通过 ComfyUI、Comfy Cloud 或 API 密钥运行模型
  5. 05导出分层 PSD 和 OpenRaster 文件
  6. 06向 Agent 提供编辑器命令

适用场景

  1. 01修补选定区域并保留编辑能力
  2. 02描述画布区域中要放置的对象
  3. 03使用现有 ComfyUI 工作流编辑图像
  4. 04导出分层作品以便继续编辑

MCP 相关

Scumble 通过 MCP 服务提供编辑器命令,MCP 客户端可使用 116 种工具,在应用内打开、选择、生成、匹配和导出内容。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库
安装包
mcpbscumble-0.1.51.mcpb

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Scumble

一款面向 ComfyUI 和你现有模型的 AI 原生图像编辑器。
修补、编辑、放大和生成,每次编辑都会作为独立图层返回。

⭐ 在 GitHub 上点星  ·  下载  ·  Microsoft Store

在 GitHub 上为 Scumble 点星 下载最新版本 从 Microsoft Store 获取 许可证:GPL-3.0

在空白画布上画出三个方框并描述内容,然后使用 FLUX 3 Image 的“生成新内容”功能生成一张咖啡馆图片,每样东西都在各自的方框中(等待过程加速了 16 倍)

获取 Scumble

平台获取方式备注
WindowsMicrosoft 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”)。如果生成结果稍有偏移或缩放,程序会根据图片边缘对齐;之后也可以在图层菜单中使用 与下方图层边缘匹配,达到相同效果。

颜色匹配:同一结果图层在 Match 0 % 时显示为明显偏冷的矩形,在 Match 100 % 时与地面融合;下方为带有 Match 滑块的图层行

指定内容放置位置:框和 @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 根据这些内容生成的咖啡馆图片。

左侧是在空白画布上绘制并描述的三个方框;右侧是 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-InpaintCanvas
    

    ComfyUI 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、深度图)也会在你的本机上运行。

演示:视频和手册

Scumble,由一位并未主动要求介绍的人讲解:视频,4:40

  • 视频: 共 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-vfx 0.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 的 获取密钥 链接包含作者的推荐码。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。