# Photoshop Beta Control

> 智能体控制 PS 插件：让 Codex 接管本地 Photoshop，自动新建画布、图层编辑、可编辑路径、质感换色和批量导出。

- **Type:** MCP server
- **Install:** `agentstack add mcp-kiki348-photoshop-beta-control`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kiki348](https://agentstack.voostack.com/s/kiki348)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [kiki348](https://github.com/kiki348)
- **Source:** https://github.com/kiki348/photoshop-beta-control

## Install

```sh
agentstack add mcp-kiki348-photoshop-beta-control
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 智能体控制 PS 插件 | Photoshop Beta Control

> 让 Codex 真的接管本地 Photoshop：新建画布、放图、加字、改色、画可编辑路径、批量导出，一套面向设计和办公自动化的本地 MCP 插件。

让 Codex 通过本地 MCP 插件控制 Windows 上的 Adobe Photoshop / Photoshop Beta，完成图片打开、画布创建、图层编辑、可编辑路径绘制、质感换色、批量导出等真实办公和设计自动化任务。

> 这是本地自动化桥接工具，不是 Adobe 官方插件。它依赖 Photoshop 的 Windows COM 自动化能力和 ExtendScript。

## 能做什么

- 检查本机 Photoshop 状态、当前文档尺寸、分辨率和模式。
- 打开本地图片，新建指定尺寸画布。
- 放置图片为新图层，设置位置、尺寸、透明度和混合模式。
- 添加可继续编辑的文字图层。
- 创建可编辑 Photoshop 路径，并可用当前画笔描边成可见线稿层。
- 列出、选择、重命名、隐藏、删除图层，设置透明度和混合模式。
- 进行常见图片处理：裁切、缩放、亮度、对比度、锐化、导出。
- 进行更自然的局部换色：用多边形蒙版保留纹理、褶皱、高光和阴影。
- 执行批处理工作流，一次完成“新建画布 -> 放图 -> 加字 -> 导出”等操作。
- 在结构化工具不够时运行自定义 JSX。

## 工具矩阵

| 工具 | 用途 |
| --- | --- |
| `photoshop_status` | 查看 Photoshop 是否可用、当前文档信息 |
| `photoshop_find_progids` | 查找本机注册的 Photoshop COM ProgID |
| `photoshop_open_image` | 打开本地图片 |
| `photoshop_create_document` | 新建画布 |
| `photoshop_place_image` | 放置图片为新图层 |
| `photoshop_add_text_layer` | 添加可编辑文字层 |
| `photoshop_layer_ops` | 列出/选择/重命名/隐藏/删除/调整图层 |
| `photoshop_draw_paths` | 创建可编辑路径，可选描边 |
| `photoshop_adjust_image` | 裁切、缩放、亮度、对比度、锐化、导出 |
| `photoshop_texture_recolor` | 局部真实换色，保留纹理 |
| `photoshop_apply_overlay` | 精确放置透明叠加层 |
| `photoshop_export_active` | 导出当前文档 |
| `photoshop_batch` | 顺序执行多个工具步骤 |
| `photoshop_run_jsx` | 运行自定义 Photoshop ExtendScript |

## 安装到 Codex

### 1. 克隆项目

```powershell
cd $env:USERPROFILE\.codex\plugins
git clone https://github.com/kiki348/photoshop-beta-control.git
```

也可以把本目录复制到任意 Codex 可加载的本地插件目录。

### 2. 确认 Photoshop COM 可用

打开 Photoshop 或 Photoshop Beta，然后在 PowerShell 中运行：

```powershell
cd $env:USERPROFILE\.codex\plugins\photoshop-beta-control
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\photoshop_bridge.ps1 -Action find_progids
```

如果默认 ProgID 无法连接，可以在启动 Codex 前设置：

```powershell
$env:PHOTOSHOP_PROG_ID = "Photoshop.Application"
```

常见候选值包括：

- `Photoshop.Application`
- `Photoshop.Application.2026`
- `Photoshop.Application.2025`
- `Photoshop.Application.BETA`
- `Photoshop.Application.Beta`

### 3. 在 Codex 中启用插件

Codex 识别插件根目录下的 `.codex-plugin/plugin.json` 和 `.mcp.json`。安装后重新打开 Codex，或在插件管理界面选择本地插件。

如果你维护自己的 marketplace，可以参考：

```json
{
  "name": "photoshop-beta-control",
  "source": {
    "source": "local",
    "path": "./plugins/photoshop-beta-control"
  },
  "policy": {
    "installation": "AVAILABLE",
    "authentication": "ON_INSTALL"
  },
  "category": "Productivity"
}
```

## 怎么让 Codex 操作 Photoshop

先告诉 Codex 你要它使用 Photoshop 控制能力，例如：

```text
用 Photoshop 新建一个 1024x1024 白底画布，画一幅富士山线稿。要求线条后续能编辑，最后导出 PNG。
```

Codex 应该先调用 `photoshop_status`，确认 Photoshop 可用，然后组合 `photoshop_create_document`、`photoshop_draw_paths`、`photoshop_export_active` 等工具。

更偏办公批量处理的例子：

```text
打开这个产品图，把它放到 1920x1080 画布中央，加上可编辑标题“新品上市”，导出一张 JPG 和一份 PSD。
```

更偏修图的例子：

```text
把当前 PS 文档里发饰区域换成深红色，但保留布料纹理和高光，不要做成一块死红。
```

这类任务应优先使用 `photoshop_texture_recolor`，而不是简单覆盖色块。

## 示例批处理

`examples/social-post.batch.json` 展示了一个可复用流程：

1. 新建 1920x1080 画布。
2. 放置产品图。
3. 添加可编辑中文标题。
4. 导出 JPG。

`examples/editable-line-art.paths.json` 展示了如何用点数据创建可编辑路径线稿。

## 自定义扩展

推荐从这几个位置扩展：

- `scripts/mcp_server.py`：添加新的 MCP 工具 schema、参数校验、批处理逻辑。
- `scripts/photoshop_bridge.ps1`：添加新的 PowerShell action，并生成对应 JSX。
- `skills/photoshop-control/SKILL.md`：告诉 Codex 什么时候该优先使用新工具，而不是直接写 JSX。
- `examples/`：沉淀可复制的工作流。

扩展原则：

- 能结构化就不要直接让 Codex 写长 JSX。
- 对可逆/可编辑任务，优先创建新图层、文字层、路径或 PSD，而不是直接破坏原图。
- 对局部换色，优先保留原始纹理和光影。
- 对批量办公任务，把步骤封装进 `photoshop_batch`，方便复用。

## 隐私

插件只在本机运行，通过本机 PowerShell 调用 Photoshop COM 和 ExtendScript。它不会主动上传图片、PSD、浏览器数据或账号信息。你让 Codex 处理的本地文件仍然会被当前 Codex 会话读取和写入，请按自己的数据安全要求使用。

## 局限

- 仅支持 Windows。
- 依赖 Photoshop/Photoshop Beta 的 COM 注册状态。
- Adobe 新版本可能改变 COM ProgID 或 ExtendScript 行为。
- `photoshop_draw_paths` 创建的是 Photoshop 路径对象；如果选择 `stroke: true`，可见墨迹层是普通像素层，路径本身仍可编辑。
- 复杂选择、生成式填充、滤镜参数等能力可能仍需要 `photoshop_run_jsx` 或人工确认。

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kiki348](https://github.com/kiki348)
- **Source:** [kiki348/photoshop-beta-control](https://github.com/kiki348/photoshop-beta-control)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-kiki348-photoshop-beta-control
- Seller: https://agentstack.voostack.com/s/kiki348
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.