核心用法
本技能通过 mcporter 工具桥接像素蛋糕（PixCake）桌面客户端，实现项目生命周期管理的自动化。核心流程分为四步：
1. 接入检查：确认 pixcake 进程已启动，运行环境脚本验证 mcporter 与配置状态；
2. 项目操作：调用 pixcake.get_project_list 查询项目，pixcake.create_projects 创建项目并可选导入图片；
3. 修图处理：读取 retouch.md 应用预设或执行模糊修图指令；
4. 导出交付：通过 export.md 发起指定项目、图片或目录的导出任务。
参数传递遵循「标量用 key=value，对象/数组用 function-call」原则，Windows 平台需特别注意引号与转义问题。
显著优点
- 官方原生支持：像素蛋糕团队维护，与客户端 9.0.0+ 深度集成，功能对齐产品迭代；
- 批量自动化：突破 GUI 单线程限制，支持多项目并行创建、千级图片批量导入与导出队列管理；
- 跨平台一致：macOS 与 Windows 共享统一 MCP 接口，脚本可移植；
- 非侵入式架构：通过
mcporter调用，不直接操作数据库或私有文件结构，降低误操作风险。
潜在缺点与局限性
- Shell 转义门槛：Windows PowerShell 中复杂 JSON 参数极易因引号层级错误导致解析失败（常见报错「参数必须是非空数组」）；
- 版本刚性依赖：仅支持 9.0.0 及以上客户端，旧版本或 beta 分支可能完全不可用；
- 预设资源边界：修图能力受限于客户端本地预设库，无法动态加载外部 LUT 或 AI 模型；
- 调试信息有限：mcporter 报错时缺乏上下文堆栈，需手动对照
capabilities.md排查。
适合人群
- 职业摄影师：婚礼、肖像、电商摄影的高频次批量出图场景；
- 后期工作室：需将像素蛋糕接入内部 TMS（任务管理系统）或自研 Python/Node 流水线的技术团队；
- 自动化爱好者：希望用脚本替代重复点击操作的高级用户。
常规风险
1. 数据误覆盖：create_projects 若传入已存在项目名称，行为取决于客户端策略（可能静默复用或报错），建议先查询再创建；
2. 路径注入隐患：image_paths 虽经 JSON 封装，但若从不可信来源拼接 shell 命令，仍可能触发参数注入；
3. 进程依赖故障：客户端崩溃或 pixcake-mcp 未随主进程启动时，所有调用将失败，需监控进程健康；
4. 导出磁盘压力：批量导出高分辨率 RAW/JPG 时，需预留足够存储空间并监控 I/O 阻塞。