photocraft

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Rust 工具链（项目为纯 Rust 实现，需自行准备编译环境）
• 可访问 GitHub 的网络，用于克隆源码
• 桌面图形环境（提供原生桌面应用，也支持无头 CLI 模式）
• 磁盘空间用于存放 Rust 编译产物

安装与启动步骤

1. 1克隆项目仓库

   从 GitHub 拉取 photocraft 源码到本地，README 未给出安装包，从源码获取是唯一明确路径。

   git clone https://github.com/storytold/photocraft.git

   复制

2. 2进入项目目录

   切换到克隆下来的代码目录，后续命令都在此目录中执行。

   cd photocraft

   复制

3. 3准备 Rust 环境

   README 未写明具体安装命令，需先按 Rust 官方方式装好工具链，再编译项目。

4. 4编译并构建

   Rust 项目通常用 cargo 构建；README 未给出具体命令，此处为通用编译方式，产物为桌面程序与 CLI。

   cargo build --release

   复制

5. 5以 MCP 模式运行 CLI

   README 明确给出的命令：让 AI Agent 通过 MCP 驱动它，支持无头运行或桥接到正在运行的桌面应用。

   photocraft-cli mcp

   复制

6. 6开启桌面控制通道

   README 明确给出的命令：桌面应用提供经过鉴权、仅限本机回环的控制通道，可查看 UI 状态、用指针事件驱动工具并离屏截图。

   photocraft --control

   复制

如何确认成功

执行 photocraft-cli mcp 后进程正常驻留、未报错，即表示 MCP 模式已启动；用 MCP 客户端连接可确认。

常见问题

注意事项

• README 节选缺少完整安装步骤，cargo build 等构建命令为 Rust 项目通用做法，请以仓库实际文档为准。
• 控制通道细节需查阅 docs/control-protocol.md，README 未展开参数说明。
• 项目处于快速迭代阶段，接口与命令可能变动，建议对照官网与仓库最新说明。
• 项目自称 clean-room 重写，不基于现有代码封装，使用前请自行确认许可条款。