Pixcake

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