基础知识
- 作者仓库星标 5
- 许可证 MIT
- 作者仓库 00bx-photoshop-mcp
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 94 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @00bx · MIT
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# PHOTOSHOP DESIGNER SKILL — FUNDAMENTALS & RULES
Execute ANY Photoshop design effect perfectly on first try — zero trial-and-error.
## WHEN TO USE THIS SKILL
Load this skill FIRST for any Photoshop operation. It contains the mandatory rules and core concepts needed before using any other Photoshop skill.
---
# MANDATORY WORKFLOW RULES
<rules>
<rule id="R1" severity="CRITICAL">
ALWAYS use a DEDICATED TOOL when one exists. NEVER use execute_batchplay for an operation that has its own tool.
There are 323 dedicated tools. Check this catalog FIRST.
</rule>
<rule id="R2" severity="CRITICAL">
ALWAYS verify visual results after multi-step operations using get_layer_image (single layer) or get_document_image (full composite).
Do NOT assume success from return status alone.
</rule>
<rule id="R3" severity="CRITICAL">
ALWAYS pass layer_id when calling execute_batchplay. The tool has an optional layer_id parameter that ensures the correct layer is targeted.
Without it, batchPlay may silently operate on the wrong layer.
</rule>
<rule id="R4" severity="HIGH">
For ROUNDED CORNERS on any element: use draw_rectangle_shape(corner_radius=N) + set_layer_properties(is_clipping_mask=true).
Do NOT attempt rounded rect selections via batchPlay — the corner radius keys are unreliable.
</rule>
<rule id="R5" severity="HIGH">
RASTERIZE layers before applying filters. Text, Shape, and Smart Object layers will fail silently with most filters.
Always duplicate_layer first (preserve original), then rasterize_layer on the copy.
</rule>
<rule id="R6" severity="HIGH">
SCREEN blend mode requires BLACK background, not transparent.
White on TRANSPARENT + SCREEN = invisible. White on BLACK + SCREEN = correct.
</rule>
<rule id="R7" severity="MEDIUM">
execute_batchplay is the LAST RESORT escape hatch. Use it only when:
- No dedicated tool exists for the operation
- You need to combine multiple atomic operations in one call
- A dedicated tool has a known limitation for a specific parameter
</rule>
</rules>
---
# §1 FUNDAMENTALS
## 1.1 COORDINATE SYSTEM
- Origin (0,0) = **top-left** corner of canvas
- X increases RIGHT, Y increases DOWN
- Layer bounds: `{left, top, right, bottom}` in pixels from origin
- Center of canvas: `(width/2, height/2)`
## 1.2 LAYER STACK ORDER
- Layers are drawn **bottom-up** — bottom layer renders first, top layer renders last
- `move_layer(position="TOP")` = above all (visually on top)
- `move_layer(position="BOTTOM")` = below all (visually behind)
- New layers appear ABOVE the currently active layer
- **Adjustment layers affect ALL layers below them** unless clipped
## 1.3 CANVAS ROTATION RULES
- `rotate_canvas` rotates the **entire document** including all layers
- Rotation is **destructive** — pixels are resampled
- Always rotate back by the exact negative amount
- **Plan filter directions BEFORE rotating** — see Wind direction table §7.2
## 1.4 SELECTION FUNDAMENTALS
- Selection = marching ants defining which pixels are affected
- Feather = soft edges (pixels partially selected)
- **Selection MUST exist before:** fill_selection, delete_selection, content_aware_fill, generative_fill, add_layer_mask_from_selection
- `select_all` = entire canvas, `clear_selection` = deselect everything
- Selections are per-document, not per-layer
## 1.5 MASK FUNDAMENTALS
- Layer mask = grayscale image controlling layer visibility
- **White = fully visible**, Black = fully hidden, Gray = partially visible
- `add_layer_mask_reveal_all` = white mask (everything shows)
- `add_layer_mask_hide_all` = black mask (everything hidden)
- `fill_mask_with_gradient` = smooth transition between visible/hidden
- To paint on mask: `select_layer_mask` → brush/fill → `select_layer_rgb` to go back
- **Gradient mask direction:** start point = BLACK (hidden), end point = WHITE (visible)
## 1.6 SMART OBJECTS vs RASTERIZED LAYERS
- Smart Objects preserve original data but BLOCK most filters
- **Rasterize BEFORE applying:** Wind, Wave, Twirl, Spherize, Crystallize, Noise, Sharpen, etc.
- Text layers must be rasterized before ANY filter
- `rasterize_layer` is irreversible — always duplicate first
## 1.7 FILL OPACITY vs LAYER OPACITY
- **Layer Opacity** = affects layer content + ALL layer styles
- **Fill Opacity** = affects ONLY layer content, NOT layer styles (drop shadow, glow, bevel stay at full)
- **Key trick:** Fill 0% + layer styles = invisible content with visible effects (used for glass text)
- Set via: `set_layer_properties(layer_id=X, fill_opacity=0)`
---
章节与文件索引
按说明文件中的顺序排列。
何时使用此技能
1.1 坐标系
1.2 层堆叠顺序
1.3 画布旋转规则
1.4 选择基本原则
文件/命令 -> {left, top, right, bottom} · (width/2, height/2) · move_layer(position="TOP") · move_layer(position="BOTTOM") · rotate_canvas · select_all · clear_selection · add_layer_mask_reveal_all
内容校验值 -> 4e3d89da1773
当前原文的自动摘译,尚未人工审校。
何时使用此技能
对于任何 Photoshop 操作,请首先加载此技能。它包含使用任何其他 Photoshop 技能之前所需的强制性规则和核心概念。强制性工作流程规则 <rules> <rule id="R1" succession="CRITICAL"> 如果存在专用工具,则始终使用专用工具。切勿将execute_batchplay 用于具有自己工具的操作。
1.1 坐标系
原点 (0,0) = 画布的左上角 X 向右增加,Y 向下增加 图层边界:
{left, top, right, bottom},距原点以像素为单位 画布中心:(width/2, height/2)1.2 层堆叠顺序
图层自下而上绘制 - 底层首先渲染,顶层最后渲染
move_layer(position="TOP")= 最上面(视觉上位于顶部)move_layer(position="BOTTOM")= 最下面(视觉上位于后面) 新图层出现在当前活动图层上方 调整图层会影响其下方的所有图层,除非被剪裁1.3 画布旋转规则
rotate_canvas旋转整个文档,包括所有图层 旋转具有破坏性 - 像素被重新采样 始终向后旋转精确的负量 在旋转之前规划过滤器方向 - 请参阅风向表 §7.21.4 选择基本原则
Selection = 行进蚂蚁定义受影响的像素 Feather = 软边缘(部分选择的像素) Selection 必须存在于以下位置之前: fill_selection、delete_selection、content_aware_fill、generative_fill、add_layer_mask_from_selection
select_all= 整个画布,clear_selection= 取消选择所有内容 选择是针对每个文档的,而不是针对每个图层