PhotoFresco

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install photofresco
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 photofresco。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

PhotoFresco 是一款类似 Photoshop 的基于浏览器的图像编辑软件，通过其 MCP 服务器进行控制。此 Openclaw Skills 工作流支持分层和非破坏性编辑、调整、蒙版、选区、修饰、裁剪和调整大小、滤镜、预览、撤消以及图像导出——所有这些都在用户计算机上的 PhotoFresco 窗口中进行。
用户批准每个连接并选择权限，同时编辑内容会显示在编辑器的历史记录中。该技能专为透明、迭代的图像工作而设计：检查文档、进行有针对性的更改、查看预览，然后保留或撤消结果。文件访问权限仅限于用户配置的文件夹。

应用场景

使用色阶、曲线、曝光度、亮度/对比度、色彩平衡和色相/饱和度等调整图层进行照片色彩校正。
将编辑效果蒙版到选定区域——例如，调暗天空而无需将调整应用到整个图像。
在 PhotoFresco 中查看每个更改的同时，进行修饰、合成、裁剪、调整大小或以其他方式精炼图像。
检查图像预览、详细区域、蒙版、直方图或采样的像素颜色以评估编辑效果。
导入受支持的图像文件并导出拼合的 PNG、分层 PSD 或无损 PhotoFresco PFD 文档。
当任务涉及一系列已知操作时，运行可重复、经过验证的编辑工作流。
对于需要可见的用户批准和有界文件访问权限的图像编辑任务，请使用 Openclaw Skills。

工作原理

在获得用户批准的情况下连接。 使用所需的功能和简短原因调用 photofresco_connect。用户在 PhotoFresco 中验证配对码并批准连接和请求的权限。
选择或打开文档。 对于授予 --read 权限的文件夹中的图像，使用 photofresco_import_file、创建文档或附加到活动文档。操作针对会话的活动标签页。
检查起点。 读取文档状态，包括尺寸、图层树、活动图层、选区、文档 ID 和版本。在编辑前渲染预览。
进行有针对性的编辑。 一次应用一个操作——例如，添加调整图层、创建选区、添加蒙版或更改图层属性。坐标使用从左上角开始的文档像素。
审查结果。 使用完整预览、详细比例区域、蒙版渲染或像素采样来检查实际结果，而不仅仅依赖于成功的工具响应。
保留或撤消。 使用历史记录的撤消或重做来精炼结果。如果用户可能进行了编辑，请重新检查文档状态，因为他们的更改也会显示在历史记录中，并且版本会随着每次编辑而改变。
导出并断开连接。 使用所需的导出权限保存到允许的 --write 文件夹，然后调用 photofresco_disconnect。编辑内容保留在文档的历史记录中。

配置指南

要求：Node.js 22 或更新版本、PhotoFresco MCP 服务器 (photofresco)，以及用户计算机上的 Chrome、Edge 或 Chromium 120+。用户配置智能体可以读取和写入的文件夹。如果没有这些文件夹授权，智能体仍然可以创建文档、编辑和预览，但无法访问文件。
对于 Claude Code，用户可以通过以下方式注册 MCP 服务器：
claude mcp add photofresco -- npx -y photofresco@0.1.0 mcp --read ~/Pictures --write ~/Pictures/PhotoFresco
对于使用 command 和 args 的 Claude Desktop、Cursor 或其他客户端，添加如下所示的 MCP 服务器配置：
{
"mcpServers": {
"photofresco": {
"command": "npx",
"args": ["-y", "photofresco@0.1.0", "mcp", "--read", "/Users/you/Pictures", "--write", "/Users/you/Pictures/PhotoFresco"]
}
}
}
将示例路径替换为用户的实际文件夹。可以使用 node /path/to/photofresco/src/bin/photofresco.js mcp 和所需的文件夹参数来运行源码检出。可选服务器设置包括 --tools essentials|all|、--profile |ephemeral 和 --browser
；PHOTOFRESCO_BROWSER 也可以指定浏览器。在替换现有文件之前，必须在服务器上启用 --overwrite，并在导出时提供 overwrite: true。
服务器设置完成后，通过 MCP 工具进行连接，并让用户验证显示的代码并单击“允许”。会话启动时没有任何权限；仅请求任务所需的功能。读取（Read）用于检查文档，编辑（Edit）用于更改，导出（Export）用于保存文件。发送（Send）和花费（Spend）仅在用户请求云端或付费 AI 功能时才需要。如果 photofresco npm 包不可用，技能文档还介绍了安装 PhotoFresco 插件或从源码克隆运行的方法。

数据架构

文档与操作状态
文档状态： 尺寸、图层树和图层 ID、活动图层、选区边界、document_id 和 revision。
操作结果： 包括文档 ID 和版本；每当有人更改文档时，版本就会增加。工具参数架构定义了接受的参数和范围。
预览数据： PNG 预览可以代表整个图像、细节区域、单个图层、蒙版或选区。颜色采样返回确切的像素值。
权限与路径： 文件导入仅限于配置的 --read 文件夹；导出仅限于 --write 文件夹。用户控制功能授权并可以撤消它们。
支持的文件处理
用途 格式与限制 说明
导入 PNG、JPEG、WebP、GIF、BMP、AVIF、PSD/PSB 和 PFD；最大 32 MiB 必须来自授予读取权限的文件夹。
导出 PNG、PSD 和 PFD PNG 默认拼合，并带有导出单图层的选项。PSD 是分层的，但 PhotoFresco 专有功能可能会被近似处理并在 loss 中报告。PFD 是 PhotoFresco 的原生无损格式。
制品检索 photofresco://artifact/ 资源链接；最大 6 MiB 通过 MCP resources/read 读取；可用 10 分钟。
成功的文件导出将报告写入路径、字节数和 SHA-256 校验和。除非服务器和操作的覆盖设置都允许，否则不会替换现有文件。工作流是带有类型化输入的、可移植的、带有版本的操作步骤列表；验证无需运行即可检查工作流。

高级特性

非破坏性编辑：
使用调整图层和图层属性，然后通过编辑器的历史记录调整参数或撤消。
精确蒙版与选区：
创建选区、羽化边缘、蒙版图层，并使用覆盖信息渲染蒙版以供验证。
可扩展的工具组：
从基础工具开始，然后根据需要列出并启用用于绘画、文本、自动化、工作区、云和其他操作的组。
经过验证的工作流：
在执行前验证工作流、使用类型化输入运行它、检查以前的运行并回滚运行。导出、发送数据、花费积分或打开和关闭标签页可能需要特定步骤的事先同意。
MCP 与 CLI 访问：
使用 MCP 工具或
photofresco
CLI 进行连接、状态查看、文档操作、工作流执行和文件传输。CLI JSON 模式提供结构化的成功和错误结果。
权限与会话控制：
仅在需要时请求额外的访问权限；用户的编辑会暂停智能体的租约，直到用户恢复，并且用户可以随时停止会话。
感知版本的恢复：
通过重新读取文档状态来处理过时的版本，并在重试结果未知的操作之前检查状态。
用户可见的执行：
每个文档编辑都会显示在 PhotoFresco 中并记录在历史记录中；智能体无法批准对话框、绕过用户的决定或编辑其他标签页。

name: photofresco description: Edit photos and images in PhotoFresco, a Photoshop-class editor, through its MCP server - layered editing, retouching, adjustment layers (levels, curves, exposure, hue/saturation, brightness/contrast), masks, selections, crop and resize, filters, previews, undo, and PNG/PSD export into folders the user allows. Use when the user wants an image edited, color-corrected, masked, composited or exported with PhotoFresco, or when photofresco_* tools are available. The user watches every edit in a PhotoFresco window on their computer and approves the connection and each permission. license: MIT
compatibility: Needs the PhotoFresco MCP server (npm package photofresco, Node.js 22 or newer) and Chrome, Edge or Chromium 120+ installed on the user's computer.