高级
- 作者仓库星标 5
- 许可证 MIT
- 作者仓库 00bx-photoshop-mcp
- 领域
- 设计与多媒体
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 94 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @00bx · MIT
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# §8 TOOL REFERENCE & WIND TABLE
## 8.1 WIND DIRECTION MASTER TABLE
Wind only blows horizontally. Use canvas rotation for vertical effects.
**Now uses dedicated tool: `apply_wind`**
| Desired Effect | Canvas Rotation | Wind Call | Rotate Back | Result |
| -------------- | --------------- | --------------------------------------------------- | ----------- | ---------------- |
| Drips DOWN | -90 (CCW) | `apply_wind(method="wind", direction="left")` x5-7 | +90 (CW) | Streaks downward |
| Flames UP | +90 (CW) | `apply_wind(method="wind", direction="left")` x3-5 | -90 (CCW) | Streaks upward |
| Streaks RIGHT | None | `apply_wind(method="wind", direction="left")` x3-5 | None | Horizontal right |
| Streaks LEFT | None | `apply_wind(method="wind", direction="right")` x3-5 | None | Horizontal left |
**"left" = FROM the left = pushes pixels RIGHT. "right" = FROM the right = pushes pixels LEFT.**
**Wind method comparison:**
- "wind" = controlled thin streaks — **USE THIS** for drip/fire effects
- "blast" = thick aggressive splatter — TOO MUCH for most effects
- "stagger" = randomized jagged streaks — good for lightning/electricity
## 8.2 FILTER PARAMETER RANGES
| Filter | Parameter | Range | Default |
| ------------- | ------------------------------- | --------------------------- | ------------- |
| Gaussian Blur | radius | 0.1-10000px | 2.5 |
| Motion Blur | distance | 1-2000px | 30 |
| Radial Blur | amount | 1-100 | 10 |
| Surface Blur | radius/threshold | 1-100 / 2-255 | 5/15 |
| Lens Blur | radius | 0-100 | 15 |
| Noise | amount | 0.1-400% | 5 |
| Wave | generators/wavelength/amplitude | 1-999 / 1-999 / 1-999 | 5/10-120/5-35 |
| Unsharp Mask | amount/radius/threshold | 1-500% / 0.1-1000px / 0-255 | 100/1.0/0 |
| High Pass | radius | 0.1-1000px | 10 |
| Wind | method | wind/blast/stagger | wind |
| Liquify | brush_size | 1-15000px | 64 |
---
# §9 DESIGN PRINCIPLES
## 9.1 COLOR RULES
**60-30-10 Rule:** 60% dominant, 30% secondary, 10% accent
## 9.2 TYPOGRAPHY RULES
- **Max 2 fonts** per design (3 absolute max)
- **Title: 2-3x body size** minimum
- **ALL CAPS: add tracking +50 to +200**
- **Never use Thin/Light below 24pt**
## 9.3 COMPOSITION
- Rule of Thirds: focal point at grid intersections
- Z-Pattern: Logo top-left → headline top → image bottom-left → CTA bottom-right
## 9.4 CONTRAST & READABILITY
- Body text: minimum 4.5:1 contrast ratio
- Text on images: 50-70% black overlay, or blur background
- Dark bg: off-white (224,225,221) not pure white
## 9.5 DIMENSIONS
| Platform | Size |
| -------------------- | --------- |
| Instagram Post | 1080x1080 |
| Instagram Story/Reel | 1080x1920 |
| Twitter/X | 1600x900 |
| YouTube Thumb | 1280x720 |
| LinkedIn | 1200x627 |
| A4 Print (300dpi) | 2480x3508 |
---
# §10 WORKFLOW TEMPLATES
## 10.1 POSTER CREATION
```
1. Create canvas (correct dimensions + DPI)
2. Place background image
3. Color grade: curves + color_balance + vibrance
4. Cut out subject: select_subject → mask OR remove_background
5. Add main text → apply text effects (§5)
6. Add secondary text (subtitle, credits)
7. Final color harmony: unified color overlay SOFT_LIGHT 10-20%
8. Verify with get_document_image
9. Export: save_document_as
```
## 10.2 PHOTO EDIT
```
1. Open → duplicate background
2. auto_tone / auto_color OR manual curves+levels
3. Skin retouch: apply_spot_healing_brush or frequency separation (§6.12)
4. Color grade (§7)
5. Local adjustments: apply_dodge_tool / apply_burn_tool
6. Sharpen: apply_high_pass OVERLAY (§11.1)
7. Vignette (§6.8)
8. Optional apply_noise 2-3% OVERLAY
9. Export
```
## 10.3 COMPOSITE
```
1. Background plate
2. Subject (select_subject or remove_background)
3. Match lighting: harmonize_layer OR manual curves
4. Cast shadow: duplicate → flip vertical → blur → MULTIPLY 30-40%
5. Color unification: photo_filter or solid fill SOFT_LIGHT 10-15%
6. Final adjustments
```
---
# §11 ADVANCED TECHNIQUES
## 11.1 HIGH-PASS SHARPENING
`stamp_visible` → `apply_high_pass(radius=2-5)` → `set_layer_properties(blend_mode="OVERLAY")` → opacity 50-80%
## 11.2 DODGE & BURN (non-destructive)
`create_pixel_layer(fill_neutral=true, blend_mode="OVERLAY")` → paint WHITE to dodge, BLACK to burn, opacity 10-15% per stroke
## 11.3 ORTON EFFECT (dreamy glow)
`stamp_visible` → `apply_gaussian_blur(radius=20-40)` → SCREEN 40-60%
## 11.4 BLEND-IF COMPOSITING
`set_layer_blend_if` for seamless tone-based blending:
- Remove dark bg: this_layer_black=20, black_feather=50
- Show in bright areas: underlying_white=180, white_feather=220
## 11.5 LUMINOSITY MASKING
Load RGB as selection via batchplay → save as Highlights channel → invert for Shadows
## 11.6 STAMP VISIBLE
`stamp_visible` = flattened copy of all visible layers as new layer on top. Use BEFORE destructive effects.
---
# §12 CRITICAL TOOL GOTCHAS — 17 VERIFIED
These are verified bugs/behaviors that WILL cause failures if ignored:
1. **`select_layer` CAN DELETE LAYERS** — Use `set_layer_properties` or `execute_batchplay` to target layers instead
2. **`set_layer_properties` RESETS clipping mask** — Always pass `is_clipping_mask=false` (or true if clipped) to preserve state
3. **`place_image` always throws error** — But the layer IS created. **Ignore the error and continue.**
4. **`VIVID_LIGHT` blend mode is rejected** — MCP tool doesn't support it. Use batchplay.
5. **`scale_layer` fails silently on Smart Objects** — Use `free_transform` instead
6. **`generate_image`/`generative_fill` return success but produce nothing** — Adobe Firefly AI tools unreliable in MCP
7. **Canvas rotation affects ALL layers** — Every layer rotates. Plan accordingly.
8. **`apply_wind` only blows HORIZONTALLY** — Use canvas rotation for vertical effects (see §8.1)
9. **Filters require rasterized layers** — Text, shape, Smart Object layers will fail. Always rasterize first.
10. **`translate_layer` Y axis** — Positive Y moves DOWN (standard screen coords)
11. **SCREEN blend requires BLACK background** — White on transparent + SCREEN = invisible.
12. **Wind "blast" method is TOO aggressive** — Use "wind" method for controlled streaks.
13. **Global Light is shared** — Bevel and Drop Shadow share angle by default.
14. **File tokens required for file paths** — batchPlay won't trust raw file paths in some contexts.
15. **All modifying batchPlay in UXP needs executeAsModal** — Direct execution without modal wrapper will fail silently.
16. **Blur Gallery may force dialog** — Field/Iris/Tilt-Shift/Spin/Path blur may open dialog despite suppression.
17. **Camera Raw Filter NOT scriptable headless** — Always requires dialog. Use Curves + Levels + Color Balance instead.
---
# §13 FAILED ATTEMPTS LOG — DO NOT REPEAT
| # | What Went Wrong | Correct Approach |
| --- | --------------------------------------- | --------------------------------------- |
| 1 | Wave distorted entire text horizontally | Use Wind (directional) not Wave |
| 2 | Stretch 400% + blur + wave = sideways | Wind + canvas rotation |
| 3 | Motion blur 90 = streams UP and DOWN | Wind is one-directional (not symmetric) |
| 4 | Rotate +90 CW + Wind right = UP | -90 CCW + Wind left = DOWN |
| 5 | White on TRANSPARENT + SCREEN | White on BLACK + SCREEN |
| 6 | Wind "blast" x10 = off-canvas | "wind" method x 5-7 |
---
# §14 OUTER GLOW PARAMETER REFERENCE
| Parameter | Range | Default | Notes |
| --------- | ------- | ------- | --------------------------------------- |
| BlendMode | any | SCREEN | SCREEN for glow, MULTIPLY for dark halo |
| Opacity | 0-100% | 75 | |
| Noise | 0-100% | 0 | Adds texture to glow |
| Color | RGB | yellow | Single color |
| Spread | 0-100% | 0 | Higher = more solid center |
| Size | 0-250px | 5 | Blur radius of glow |
---
# §15 QUALITY CHECKLIST
Before finalizing ANY design:
- [ ] Text is readable at target viewing distance
- [ ] Color palette has max 3-5 colors (60-30-10 rule)
- [ ] Visual hierarchy is clear (title → image → details)
- [ ] White space is sufficient
- [ ] All effects look intentional (not overdone)
- [ ] No artifacts from filter operations
- [ ] Layer order is logical (bg → subject → text → effects → adjustments)
- [ ] Canvas dimensions match target platform
- [ ] Verified with `get_document_image` or `get_layer_image`
---
章节与文件索引
按说明文件中的顺序排列。
8.1 风向主表
8.2 滤波器参数范围
9.1 颜色规则
9.2 版式规则
9.3 组成
文件/命令 -> apply_wind · apply_wind(method="wind", direction="left") · apply_wind(method="wind", direction="right") · stamp_visible · apply_high_pass(radius=2-5) · set_layer_properties(blend_mode="OVERLAY") · create_pixel_layer(fill_neutral=true, blend_mode="OVERLAY") · apply_gaussian_blur(radius=20-40)
内容校验值 -> c8f257d6b3d9
当前原文的自动摘译,尚未人工审校。
8.1 风向主表
风只水平吹。使用画布旋转以获得垂直效果。现在使用专用工具:
apply_wind所需效果 · 画布旋转 · 风声呼唤 · 向后旋转 · 结果向下滴落 · -90 (CCW) ·apply_wind(method="wind", direction="left")x5-7 · +90 (CW) · 向下条纹 火焰向上 · +90 (CW) ·apply_wind(method="wind", direction="left")x3-5 · -90 (CCW) · 向上条纹8.2 滤波器参数范围
滤镜·参数·范围·默认高斯模糊·半径·0.1-10000px·2.5 运动模糊·距离·1-2000px·30 径向模糊·数量·1-100·10 表面模糊·半径/阈值·1-100 / 2-255·5/15
9.1 颜色规则
60-30-10 规则:60% 为主导音,30% 为次要音,10% 为重音
9.2 版式规则
每个设计最多 2 种字体(最多 3 种绝对) 标题:最小 2-3 倍正文大小 全大写:添加跟踪 +50 至 +200 切勿使用低于 24pt 的 Thin/Light
9.3 组成
三分法:网格交叉点的焦点 Z 形图案:徽标左上角 → 标题顶部 → 图像左下角 → CTA 右下角