Skill: jasperdon/pixcake (version 1.3.0)

--- name: pixcake description: | 像素蛋糕桌面客户端技能，覆盖项目查询与创建、预设修图、导出任务等真实客户端操作。 当用户明确在使用 PixCake / 像素蛋糕，并希望查看项目、创建项目、导入图片、应用预设、发起导出或查询导出任务状态时，则必须阅读该技能。 metadata: openclaw: os: - "darwin" - "win32" --- ## 触发条件 - 用户明确指向 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` 确认正确的调用语法，再排查参数格式 - 出现明确不兼容信号时，停止重试，提示升级客户端或联系工作人员


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)