疑难解答

修复:

• 确保 Photoshop 安装在默认位置，或在客户端配置中用 PHOTOSHOP_PATH 指向自定义路径：

{
  "env": {
    "PHOTOSHOP_PATH": "C:\\Custom\\Path\\Adobe Photoshop 2025\\Photoshop.exe"
  }
}

修复:

• 确保 Photoshop 正在运行——服务器会尝试启动它，但已运行的实例连接更快、更可靠。
• 检查 Photoshop 首选项中是否启用了脚本功能。
• 在 Windows 上，确认 COM 自动化未被安全设置阻止。

修复:

• 在浏览器中：用 photoshop-mcp-ui 打印的 URL 重新加载页面。
• 在脚本中：从 ~/.photoshop-mcp/ui-session.json 读取令牌，并作为请求头发送：

TOKEN=$(node -p "require('$HOME/.photoshop-mcp/ui-session.json').token")
curl -H "x-psmcp-token: $TOKEN" http://127.0.0.1:5174/api/status

Authorization: Bearer <token> 同样有效。启动服务器前设置 PSMCP_UI_TOKEN 可以固定一个已知令牌。

修复:

• 通过 CLI 打印的完整 URL（http://127.0.0.1:<port>）打开界面——不要用仅仅指向你机器的主机名，也不要从其他端口提供的页面访问。

修复:

• 在脚本中添加显式 return：

photoshop_execute_script({
  code: `
    app.activeDocument.activeLayer.name = "Updated";
    return { ok: true };
  `
})

详情见「可用工具」中的 photoshop_execute_script 一节。

修复:

• 把复杂操作拆成更小的步骤，按顺序执行。