Pixcake Skills

触发条件#

• 用户明确指向 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，否则后续命令无法执行。

powershell

Rename-Item "{baseDir}\scripts\setup.ps1.txt" "setup.ps1"

bash

# macOS
{baseDir}/scripts/setup.sh --check-only

# Windows PowerShell
{baseDir}\scripts\setup.ps1 -CheckOnly

如果输出显示一切 OK（mcporter 已安装、config 已配置、pixcake 已就绪），跳到「调用示例」。

步骤 3：配置缺失时运行自动设置#

bash

# macOS
{baseDir}/scripts/setup.sh

# Windows PowerShell
{baseDir}\scripts\setup.ps1

脚本会自动定位 pixcake-mcp、安装 mcporter（如缺失）、写入配置。如果脚本报错找不到路径，再读 ./references/mcp-setup.md 按指引手动定位后重试。

步骤 4：确认可用工具#

bash

# 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：

bash

# 获取项目列表（简单标量参数可直接用 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 json

Windows：

powershell

# 获取项目列表（简单标量参数可直接用 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 json

Windows 传参建议#

在 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 确认正确的调用语法，再排查参数格式
• 出现明确不兼容信号时，停止重试，提示升级客户端或联系工作人员