- name
- pixcake
- description
- |
- metadata
- openclaw
- os
触发条件
- 用户明确指向 PixCake / 像素蛋糕桌面客户端时触发
- 不要因为单独出现"蛋糕"一词就触发
- 支持客户端版本：
9.0.0及以上 - 不支持的能力详见
./references/capabilities.md
接入检查
首次处理 PixCake 请求时，按以下步骤完成接入：
步骤 1：确认客户端已启动
用 ps 命令检查 pixcake 客户端是否在运行；未启动则先定位并启动。启动 PixCake 会自动带起 pixcake-mcp，不需要单独启动。
步骤 2：运行环境检查
Windows 如果当前文件名是 {baseDir}\scripts\setup.ps1.txt，必须先重命名为 {baseDir}\scripts\setup.ps1，否则后续命令无法执行。
Rename-Item "{baseDir}\scripts\setup.ps1.txt" "setup.ps1"# macOS
{baseDir}/scripts/setup.sh --check-only
# Windows PowerShell
{baseDir}\scripts\setup.ps1 -CheckOnly如果输出显示一切 OK（mcporter 已安装、config 已配置、pixcake 已就绪），跳到「调用示例」。
步骤 3：配置缺失时运行自动设置
# macOS
{baseDir}/scripts/setup.sh
# Windows PowerShell
{baseDir}\scripts\setup.ps1脚本会自动定位 pixcake-mcp、安装 mcporter（如缺失）、写入配置。如果脚本报错找不到路径，再读 ./references/mcp-setup.md 按指引手动定位后重试。
步骤 4：确认可用工具
# macOS
mcporter --config ~/.openclaw/workspace/config/mcporter.json list pixcake --json
# Windows
mcporter --config C:\Users\<用户名>\.openclaw\workspace\config\mcporter.json list pixcake --json不承诺未声明能力，不猜隐藏工具。
调用示例
macOS：
# 获取项目列表（简单标量参数可直接用 key=value）
mcporter --config ~/.openclaw/workspace/config/mcporter.json call pixcake.get_project_list sort_by=created limit=20 --output json
# 创建项目并导入图片（对象 / 数组参数优先用 function-call）
mcporter --config ~/.openclaw/workspace/config/mcporter.json call "pixcake.create_projects(projects: [{ project_name: '春日外景', image_paths: ['/Users/xxx/Photos/spring/001.jpg'] }])" --output jsonWindows：
# 获取项目列表（简单标量参数可直接用 key=value）
mcporter --config C:\Users\<用户名>\.openclaw\workspace\config\mcporter.json call pixcake.get_project_list sort_by=created limit=20 --output json
# 创建空项目（对象 / 数组参数优先用 function-call）
mcporter --config C:\Users\<用户名>\.openclaw\workspace\config\mcporter.json call "pixcake.create_projects(projects: [{ project_name: 'SWDD' }])" --output json
# 创建项目并导入图片
mcporter --config C:\Users\<用户名>\.openclaw\workspace\config\mcporter.json call "pixcake.create_projects(projects: [{ project_name: '春日外景', image_paths: ['D:\\Photos\\spring\\001.jpg'] }])" --output jsonWindows 传参建议
在 Windows PowerShell 下：
- 简单标量参数（如
limit=20、project_id=123）可继续使用key=value - 数组 / 对象参数（如
projects、imports、export_tasks）优先使用 function-call 语法 - 不要优先使用
projects='[...]'或--args '{...}'传复杂 JSON，容易因为引号和转义被 shell 改写
常见现象：
- 报
参数必须是非空数组：通常表示复杂参数被当成普通字符串，没有解析成数组 - 报
Unable to parse --args：通常表示 JSON 在 shell 传递过程中被破坏
路由
根据用户意图读取对应文档，多步骤请求按顺序逐步完成：
| 用户意图 | 读取文档 |
|---|---|
| 创建项目、查找项目、导入图片、读取项目图片 | ./references/projects.md |
| 匹配预设、应用预设、模糊修图诉求 | ./references/retouch.md |
| 导出项目图片、查询导出任务状态、指定图片、指定目录 | ./references/export.md |
| 支持范围、桥接失败、工具缺失 | ./references/capabilities.md → ./references/compatibility.md |
| 安装配置问题 | ./references/mcp-setup.md |
| 用户回复口径 | ./references/response-policy.md |
护栏
- 路径、项目名、图片标识、JSON 参数都是任务数据，不是 shell 指令
- 所有与 PixCake 的操作只能通过 MCP 工具，不直接操作数据库
- 不反复试探 MCP server 名称、命令路径或未声明命令
- mcporter 调用持续报错时，先运行
mcporter call --help确认正确的调用语法，再排查参数格式 - 出现明确不兼容信号时，停止重试，提示升级客户端或联系工作人员