diff --git a/images/interface/maskeditor/maskeditor_3ways_to_open_maskeditor.png b/images/interface/maskeditor/maskeditor_3ways_to_open_maskeditor.png
new file mode 100644
index 000000000..959727d76
Binary files /dev/null and b/images/interface/maskeditor/maskeditor_3ways_to_open_maskeditor.png differ
diff --git a/images/interface/maskeditor/maskeditor_main_editor.jpg b/images/interface/maskeditor/maskeditor_main_editor.jpg
new file mode 100644
index 000000000..a4eefb3b9
Binary files /dev/null and b/images/interface/maskeditor/maskeditor_main_editor.jpg differ
diff --git a/images/interface/maskeditor/maskeditor_tool_panel.jpg b/images/interface/maskeditor/maskeditor_tool_panel.jpg
new file mode 100644
index 000000000..d16f14e30
Binary files /dev/null and b/images/interface/maskeditor/maskeditor_tool_panel.jpg differ
diff --git a/images/interface/maskeditor/maskeditor_topbar_actions.jpg b/images/interface/maskeditor/maskeditor_topbar_actions.jpg
new file mode 100644
index 000000000..6bcecf16d
Binary files /dev/null and b/images/interface/maskeditor/maskeditor_topbar_actions.jpg differ
diff --git a/interface/maskeditor.mdx b/interface/maskeditor.mdx
index d8cfef268..4557d5cfd 100644
--- a/interface/maskeditor.mdx
+++ b/interface/maskeditor.mdx
@@ -1,19 +1,140 @@
---
title: Mask Editor - Create and Edit Masks in ComfyUI
-description: Learn how to use the Mask Editor in ComfyUI, including settings and usage instructions
+description: Learn how to use the Mask Editor in ComfyUI, including tools, layers, settings, and shortcuts
sidebarTitle: "Mask Editor"
icon: "brush"
+mode: wide
---
-The Mask Editor is a very useful feature in ComfyUI that allows users to create and edit masks within images without needing to use other applications.
+The Mask Editor is a built-in tool in ComfyUI that lets you create and edit masks directly on your images — no external image editor needed. It supports multiple drawing tools, layer management, undo/redo, canvas transformations, and GPU-accelerated brush rendering.
-The Mask Editor is currently triggered through the `Load Image` node. After uploading an image, you can right-click on the node and select `Open in MaskEditor` from the menu to open the Mask Editor.
+---
+
+## How to Open
+
+There are three ways to open the Mask Editor:
+
+1. **Selection Toolbox** — Select a Load Image node, then click the Mask icon button in the selection toolbar above the node.
+2. **Image Overlay** — Hover over the image preview (gallery mode), then click the **Edit or mask image** button (mask icon) that appears in the top-left corner.
+3. **Right-Click Menu** — Right-click a Load Image node and select `Open in Mask Editor` from the context menu.
+
+> The Mask Editor is available in both **Graph Mode** and **App Mode**.
+
+
+
+---
+
+## Interface Overview
+
+
+
+The Mask Editor opens as a modal dialog with four main areas:
+
+| # | Area | Location | Description |
+|---|------|----------|-------------|
+| 1 | **Top Bar** | Top | Header with undo/redo, canvas transforms, invert/clear, save/cancel |
+| 2 | **Tool Panel** | Left | Tool selection and zoom info |
+| — | **Pointer Zone** | Center | The main canvas area for drawing and editing |
+| 3 | **Side Panel** | Right | Tool-specific settings and layer controls |
-
+---
+
+## Tools
+
+The tool panel on the left side offers five tools. Select a tool to activate it, and the right panel will show its settings.
+
+
+
+| # | Tool | Layer | Description |
+|---|------|-------|-------------|
+| 1 | **Mask Pen** | Mask | Primary tool for drawing mask regions. Left-click and drag to paint mask on the image. |
+| 2 | **Paint Pen** | RGB (Paint) | Paint directly onto the image's RGB layer. Useful for inpainting or touching up the base image. |
+| 3 | **Eraser** | Mask / RGB | Erase parts of an existing mask or paint layer. |
+| 4 | **Paint Bucket** | Mask | Flood-fill tool based on color similarity. Click a pixel to fill the connected region with a mask; click an already-masked area to erase from the mask. Tolerance controls how broadly the fill spreads. |
+| 5 | **Color Select** | Mask | Selectively mask all pixels matching a target color, with advanced matching algorithms (Simple HSL / LAB).
+
+---
+
+## TopBar Actions
+
+
-
+The top bar provides canvas-wide operations:
-You can then click with your mouse on the image to create and edit masks.
+| # | Action | Description |
+|---|--------|-------------|
+| 1 | **Undo** (Ctrl+Z) | Revert the last action |
+| 2 | **Redo** (Ctrl+Shift+Z / Ctrl+Y) | Reapply a reverted action |
+| 3 | **Rotate Left** | Rotate all layers 90° counter-clockwise |
+| 4 | **Rotate Right** | Rotate all layers 90° clockwise |
+| 5 | **Mirror Horizontal** | Flip all layers horizontally |
+| 6 | **Mirror Vertical** | Flip all layers vertically |
+| 7 | **Invert** | Invert the mask (black ↔ white) |
+| 8 | **Clear** | Clear the entire mask |
+| 9 | **Save** | Save the mask and close the editor |
+| 10 | **Cancel** | Close without saving |
+
+> **Note**: Rotate and mirror operations affect all three layers (mask, paint, and base image) simultaneously. GPU-accelerated textures are recreated after transforms.
+
+---
+
+## Layers
+
+The right panel includes a **Layers** section where you can toggle visibility of each layer independently:
+
+- **Mask Layer**: The mask overlay. You can adjust its **opacity** and **blending mode**:
+ - `Black` — Mask renders as black overlay
+ - `White` — Mask renders as white overlay
+ - `Negative` — Inverted mask rendering
+- **Paint Layer**: The RGB paint layer (visible when using Paint Pen)
+- **Base Image Layer**: The original source image
+
+Click **Activate Layer** on a layer to switch drawing focus to it.
+
+Refer to the main editor screenshot above — the right panel includes brush settings and the Layers section at the bottom.
+
+---
+
+## Brush Settings
+
+When a brush-based tool (Mask Pen, Paint Pen, or Eraser) is active, the side panel shows brush settings:
+
+| Setting | Range | Description |
+|---------|-------|-------------|
+| **Shape** | Arc / Rect | Round brush or square brush |
+| **Color** | Any hex color | The paint color (for Paint Pen) or mask color |
+| **Thickness** | 1–250 | Brush diameter in pixels |
+| **Opacity** | 0–1 | Brush stroke transparency |
+| **Hardness** | 0–1 | Edge softness. 1 = hard edge, 0 = very soft |
+| **Step Size** | 1–100 | Spacing between brush dabs. Lower values give smoother strokes |
+
+Use **Reset to Default** to restore the default brush parameters.
+
+---
+
+## Canvas Navigation & Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| **Space + Drag** | Pan the canvas |
+| **Ctrl + Scroll** | Zoom in/out |
+| **Click zoom %** | Reset zoom to 100% |
+| **Ctrl + Z** | Undo |
+| **Ctrl + Shift + Z** or **Ctrl + Y** | Redo |
+| **Alt + Right-click + Drag** | Adjust brush: left/right changes **size**, up/down changes **hardness** |
+
+---
+
+## Settings
+
+In the ComfyUI Settings panel, you can configure the following Mask Editor options:
+
+| Setting | Category | Default | Description |
+|---------|----------|---------|-------------|
+| **Brush adjustment speed multiplier** | Mask Editor → Brush Adjustment → Sensitivity | 1.0 (0.1–2.0) | How quickly the brush size and hardness change when using Alt+Right-click drag |
+| **Lock brush adjustment to dominant axis** | Mask Editor → Brush Adjustment → Use Dominant Axis | On | When enabled, the adjustment affects only size OR hardness based on your dominant movement direction |
+
+---
## Video Tutorial
@@ -21,3 +142,5 @@ You can then click with your mouse on the image to create and edit masks.
Your browser does not support the video tag.
+
+> **Note**: This video demonstrates an older version of the Mask Editor (Nodes 1.0 UI) showing brush size adjustment and mask preview creation. The overall workflow remains the same in the current version.
diff --git a/ja/interface/maskeditor.mdx b/ja/interface/maskeditor.mdx
index 0485f5ca7..7a37f8673 100644
--- a/ja/interface/maskeditor.mdx
+++ b/ja/interface/maskeditor.mdx
@@ -1,25 +1,146 @@
---
title: マスクエディター - ComfyUI 内でマスクの作成と編集を行う
-description: ComfyUI のマスクエディターの設定や使用方法を含め、その使い方について学びます
+description: ComfyUI のマスクエディターの使い方を学びます。ツール、レイヤー、設定、ショートカットを網羅
sidebarTitle: "マスクエディター"
icon: "brush"
-translationSourceHash: 3f296e3a
-translationFrom: interface/maskeditor.mdx, zh/interface/maskeditor.mdx
+mode: wide
---
-マスクエディターは、他のアプリケーションを使用せずに画像内でマスクを作成および編集できる、ComfyUI の非常に便利な機能です。
+マスクエディターは ComfyUI に組み込まれたツールで、外部画像編集ソフトを使わずに画像上で直接マスクを作成・編集できます。複数の描画ツール、レイヤー管理、元に戻す/やり直し、キャンバス変換、GPU アクセラレーションによるブラシ描画をサポートしています。
-マスクエディターは現在、`Load Image` ノードを介して起動されます。画像をアップロードした後、ノードを右クリックし、メニューから `Open in MaskEditor` を選択してマスクエディターを開くことができます。
+---
+
+## 開き方
+
+マスクエディターを開くには 3 つの方法があります：
+
+1. **選択ツールバー** — Load Image ノードを選択し、ノード上部の選択ツールバーにある Mask アイコンボタンをクリックします。
+2. **画像オーバーレイ** — 画像プレビュー（ギャラリーモード）にマウスを乗せ、左上に表示される「Edit or mask image」ボタン（mask アイコン）をクリックします。
+3. **右クリックメニュー** — Load Image ノードを右クリックし、メニューから「マスクエディタで開く」を選択します。
+
+> マスクエディターは**グラフモード**と**アプリモード**の両方で使用できます。
+
+
+
+---
+
+## インターフェース概要
+
+
+
+マスクエディターはモーダルダイアログとして開き、4 つの主要エリアで構成されています：
+
+| # | エリア | 位置 | 説明 |
+|---|-------|------|------|
+| 1 | **トップバー** | 上部 | 元に戻す/やり直し、キャンバス変換、反転/クリア、保存/キャンセル |
+| 2 | **ツールパネル** | 左側 | ツール選択とズーム情報 |
+| — | **キャンバスエリア** | 中央 | 描画・編集を行うメインキャンバスエリア |
+| 3 | **サイドパネル** | 右側 | ツール固有の設定とレイヤーコントロール |
-
+---
+
+## ツール
+
+左側のツールパネルには 5 つのツールがあります。ツールを選択すると、右側パネルに対応する設定が表示されます。
+
+
+
+| # | ツール | レイヤー | 説明 |
+|---|-------|---------|------|
+| 1 | **Mask Pen** | マスクレイヤー | マスク描画の主要ツール。左クリック＋ドラッグで画像上にマスクを描きます。 |
+| 2 | **Paint Pen** | ペイントレイヤー（RGB） | 画像の RGB レイヤーに直接描画します。インペイントやベース画像の修正に便利です。 |
+| 3 | **Eraser** | マスクレイヤー / ペイントレイヤー | 既存のマスクやペイントレイヤーの一部を消去します。 |
+| 4 | **Paint Bucket** | マスクレイヤー | 色の類似性に基づく塗りつぶしツール。ピクセルをクリックすると接続領域にマスクを塗りつぶします。マスク済み領域をクリックするとマスクを消去します。許容値（Tolerance）で塗りつぶしの広がりを制御します。 |
+| 5 | **Color Select** | マスクレイヤー | ターゲット色に一致する全ピクセルを選択的にマスクします。高度なマッチングアルゴリズム（Simple / HSL / LAB）に対応。 |
+
+---
+
+## TopBar 操作
+
+
-
+上部バーではキャンバス全体に対する操作が行えます：
-その後、マウスで画像上をクリックすることで、マスクの作成と編集が行えます。
+| # | 操作 | 説明 |
+|---|------|------|
+| 1 | **元に戻す**（Ctrl+Z） | 最後の操作を元に戻す |
+| 2 | **やり直し**（Ctrl+Shift+Z / Ctrl+Y） | 元に戻した操作をやり直す |
+| 3 | **左に回転** | 全レイヤーを反時計回りに 90° 回転 |
+| 4 | **右に回転** | 全レイヤーを時計回りに 90° 回転 |
+| 5 | **左右反転** | 全レイヤーを水平反転 |
+| 6 | **上下反転** | 全レイヤーを垂直反転 |
+| 7 | **反転** | マスクを反転（黒 ↔ 白） |
+| 8 | **クリア** | マスク全体をクリア |
+| 9 | **保存** | マスクを保存してエディターを閉じる |
+| 10 | **キャンセル** | 保存せずにエディターを閉じる |
+
+> **注**：回転と反転操作は 3 つのレイヤー（マスク、ペイント、ベース画像）すべてに同時に適用されます。変換後に GPU テクスチャが再作成されます。
+
+---
+
+## レイヤー
+
+右側パネル下部の **レイヤー** セクションでは、各レイヤーの表示/非表示を個別に切り替えられます：
+
+- **マスクレイヤー**：マスクオーバーレイ。**マスク不透明度**と**マスク合成オプション**を調整可能：
+ - `黒` — マスクを黒のオーバーレイとして表示
+ - `白` — マスクを白のオーバーレイとして表示
+ - `ネガティブ` — マスクを反転表示
+- **ペイントレイヤー**：RGB ペイントレイヤー（Paint Pen 使用時に表示）
+- **ベース画像レイヤー**：元のソース画像
+
+レイヤーの **レイヤーを有効化** をクリックすると、そのレイヤーに描画フォーカスが切り替わります。
+
+上のメインエディターのスクリーンショットを参照 — 右側パネルにはブラシ設定と下部のレイヤーセクションが含まれています。
+
+---
+
+## ブラシ設定
+
+ブラシベースのツール（Mask Pen、Paint Pen、Eraser）がアクティブな場合、サイドパネルにブラシ設定が表示されます：
+
+| 設定 | 範囲 | 説明 |
+|------|------|------|
+| **ブラシ形状** | Arc / Rect | 丸ブラシまたは四角ブラシ |
+| **カラーピッカー** | 任意の 16 進色 | ペイント色（Paint Pen 用）またはマスク色 |
+| **太さ** | 1–250 | ブラシ直径（ピクセル） |
+| **不透明度** | 0–1 | ブラシストロークの透明度 |
+| **硬さ** | 0–1 | エッジの柔らかさ。1 = 硬いエッジ、0 = 非常に柔らかい |
+| **ステップサイズ** | 1–100 | ブラシの打点間隔。値が低いほど滑らかなストローク |
+
+**デフォルトにリセット** でブラシパラメーターをデフォルトに戻せます。
+
+---
+
+## キャンバス操作とショートカット
+
+| ショートカット | 操作 |
+|--------------|------|
+| **Space + ドラッグ** | キャンバスのパン |
+| **Ctrl + スクロール** | ズームイン/アウト |
+| **ズーム％をクリック** | ズームを 100% にリセット |
+| **Ctrl + Z** | 元に戻す |
+| **Ctrl + Shift + Z** または **Ctrl + Y** | やり直し |
+| **Alt + 右クリック + ドラッグ** | ブラシ調整：左右で**サイズ**、上下で**硬さ**を変更 |
+
+---
+
+## 設定
+
+ComfyUI の設定パネルで、以下のマスクエディターオプションを設定できます：
+
+| 設定 | カテゴリー | デフォルト | 説明 |
+|------|-----------|-----------|------|
+| **Brush adjustment speed multiplier** | Mask Editor → Brush Adjustment → Sensitivity | 1.0 (0.1–2.0) | Alt+右クリックドラッグ時のブラシサイズ・硬さ変更速度。値が大きいほど速い |
+| **Lock brush adjustment to dominant axis** | Mask Editor → Brush Adjustment → Use Dominant Axis | オン | 有効にすると、移動の主軸方向に応じてサイズ**または**硬さのみが調整される |
+
+---
## 動画チュートリアル
\ No newline at end of file
+
+
+> **注**：この動画は旧バージョンのマスクエディター（Nodes 1.0 UI）を示しており、ブラシサイズ調整とマスクプレビュー作成の基本フローをデモンストレーションしています。現在のバージョンでも基本的なワークフローは同じです。
diff --git a/zh/interface/maskeditor.mdx b/zh/interface/maskeditor.mdx
index afbd62ad3..02d74e56f 100644
--- a/zh/interface/maskeditor.mdx
+++ b/zh/interface/maskeditor.mdx
@@ -1,19 +1,140 @@
---
title: 遮罩编辑器 - 在 ComfyUI 中创建和编辑遮罩
-description: 讲解 ComfyUI 中遮罩编辑器（Mask Editor）的使用方法，以及对应设置等
+description: 讲解 ComfyUI 中遮罩编辑器（Mask Editor）的使用方法，包括工具、图层、设置和快捷键
sidebarTitle: "遮罩编辑器"
icon: "brush"
+mode: wide
---
-遮罩编辑器是 ComfyUI 中一个非常实用的功能，它可以帮助用户在图像中创建和编辑遮罩，而不需要在其它应用程序中进行操作。
+遮罩编辑器是 ComfyUI 内置的一个实用工具，让你可以直接在图像上创建和编辑遮罩，无需借助外部图像编辑软件。它支持多种绘图工具、图层管理、撤回/重做、画布变换以及 GPU 加速的笔刷渲染。
-遮罩编辑器目前通过 `Load image` 节点来触发，当你上传图像后，可以在节点上右键通过菜单 `Open in MaskEditor` 来打开遮罩编辑器。
+---
+
+## 如何打开
+
+有三种方式可以打开遮罩编辑器：
+
+1. **选择工具栏** — 选中一个 Load Image 节点，然后点击节点上方选择工具栏中的 Mask 图标按钮。
+2. **图像叠加层** — 悬停在图像预览（gallery 模式）上，点击左上角出现的「Edit or mask image」按钮（mask 图标）。
+3. **右键菜单** — 右键点击 Load Image 节点，从菜单中选择「在蒙版编辑器中打开」。
+
+> 遮罩编辑器在**图形模式**和**应用模式**下均可使用。
+
+
+
+---
+
+## 界面概览
+
+
+
+遮罩编辑器以模态对话框打开，包含四个主要区域：
+
+| # | 区域 | 位置 | 说明 |
+|---|------|------|------|
+| 1 | **顶部栏** | 顶部 | 标题栏，包含撤回/重做、画布变换、反转/清除、保存/取消 |
+| 2 | **工具面板** | 左侧 | 工具选择和缩放信息 |
+| — | **画布区域** | 中央 | 主画布区域，用于绘制和编辑 |
+| 3 | **侧边面板** | 右侧 | 工具专属设置和图层控制 |
-
+---
+
+## 工具
+
+左侧工具面板提供了五种工具。选择工具激活后，右侧面板会显示对应的设置项。
+
+
+
+| # | 工具 | 图层 | 说明 |
+|---|------|------|------|
+| 1 | **Mask Pen** | 遮罩层 | 主要遮罩绘制工具。左键拖拽在图像上绘制遮罩。 |
+| 2 | **Paint Pen** | 绘画层（RGB） | 直接在图像的 RGB 层上绘制。适用于局部重绘或原图修补。 |
+| 3 | **Eraser** | 遮罩层 / 绘画层 | 擦除已有遮罩或绘画层的部分内容。 |
+| 4 | **Paint Bucket** | 遮罩层 | 基于颜色相似性的洪水填充工具。点击像素填充连通区域创建遮罩；点击已有遮罩的区域则擦除遮罩。阈值（Tolerance）控制填充扩散范围。 |
+| 5 | **Color Select** | 遮罩层 | 选择性地遮罩与目标颜色匹配的所有像素，支持高级匹配算法（Simple / HSL / LAB）。 |
+
+---
+
+## TopBar 操作
+
+
-
+顶部栏提供了画布级别的操作：
-然后你就可以通过鼠标在图像上点击来创建和编辑遮罩了。
+| # | 操作 | 说明 |
+|---|------|------|
+| 1 | **撤回**（Ctrl+Z） | 撤回上一步操作 |
+| 2 | **重做**（Ctrl+Shift+Z / Ctrl+Y） | 重做被撤回的操作 |
+| 3 | **向左旋转** | 将所有图层逆时针旋转 90° |
+| 4 | **向右旋转** | 将所有图层顺时针旋转 90° |
+| 5 | **水平翻转** | 水平翻转所有图层 |
+| 6 | **垂直翻转** | 垂直翻转所有图层 |
+| 7 | **反转** | 反转遮罩（黑白互换） |
+| 8 | **清除** | 清除整个遮罩 |
+| 9 | **保存** | 保存遮罩并关闭编辑器 |
+| 10 | **取消** | 关闭编辑器，不保存 |
+
+> **注意**：旋转和翻转操作会同时影响所有三个图层（遮罩层、绘画层和原图层）。GPU 加速纹理会在变换后重新创建。
+
+---
+
+## 图层
+
+右侧面板底部包含 **图层** 区域，可以独立控制每个图层的显示/隐藏：
+
+- **遮罩层**：遮罩叠加层。可调整**遮罩不透明度**和**遮罩混合设置**：
+ - `黑` — 遮罩以黑色叠加显示
+ - `白` — 遮罩以白色叠加显示
+ - `负面` — 反转遮罩渲染
+- **绘画层**：RGB 绘画层（使用 Paint Pen 时可见）
+- **基础图像层**：原始源图像
+
+点击图层上的 **活跃层** 可切换绘制焦点到该图层。
+
+参照上方主界面截图 — 右侧面板包含笔刷设置和底部的图层区域。
+
+---
+
+## 笔刷设置
+
+当基于笔刷的工具（Mask Pen、Paint Pen 或 Eraser）激活时，侧边面板显示笔刷设置：
+
+| 设置项 | 范围 | 说明 |
+|--------|------|------|
+| **笔刷形状** | Arc / Rect | 圆形笔刷或方形笔刷 |
+| **色彩选取** | 任意十六进制颜色 | 绘制颜色（Paint Pen 用）或遮罩颜色 |
+| **厚度** | 1–250 | 画笔直径（像素） |
+| **不透明度** | 0–1 | 画笔笔触透明度 |
+| **硬度** | 0–1 | 边缘柔和度。1 = 硬边缘，0 = 非常柔和 |
+| **间距** | 1–100 | 画笔点之间的间距。值越低笔触越平滑 |
+
+使用 **重置为默认** 恢复默认画笔参数。
+
+---
+
+## 画布导航与快捷键
+
+| 快捷键 | 操作 |
+|--------|------|
+| **Space + 拖拽** | 平移画布 |
+| **Ctrl + 滚轮** | 放大/缩小 |
+| **点击缩放百分比** | 将缩放重置为 100% |
+| **Ctrl + Z** | 撤回 |
+| **Ctrl + Shift + Z** 或 **Ctrl + Y** | 重做 |
+| **Alt + 右键拖拽** | 调整笔刷：左右改变**大小**，上下改变**硬度** |
+
+---
+
+## 设置
+
+在 ComfyUI 的设置面板中，可以配置以下遮罩编辑器选项：
+
+| 设置项 | 分类 | 默认值 | 说明 |
+|--------|------|--------|------|
+| **Brush adjustment speed multiplier** | Mask Editor → Brush Adjustment → Sensitivity | 1.0 (0.1–2.0) | 控制 Alt+右键拖拽调整笔刷时的速度，值越大变化越快 |
+| **Lock brush adjustment to dominant axis** | Mask Editor → Brush Adjustment → Use Dominant Axis | 开启 | 开启后，调整仅基于移动的主轴方向影响大小或硬度 |
+
+---
## 演示视频
@@ -21,3 +142,5 @@ icon: "brush"
你的浏览器不支持 video 标签。
+
+> **说明**：该视频展示的是旧版遮罩编辑器（Nodes 1.0 UI），演示了笔刷粗细调整和遮罩预览创建的基本流程。当前版本的核心工作流与此相同。