┌────────────────────────────────────────┐
│           AI Client (MCP Host)          │
│  Claude Desktop / CodeBuddy / VS Code   │
│  Cursor / Windsurf / Continue / Cline   │
│  Crayfish / Hermes / Trae / Kiro ...     │
└──────────────┬─────────────────────────┘
               │  MCP Protocol (stdio)
┌──────────────▼─────────────────────────┐
│           OmniFlow MCP Server           │
│  ┌───────────────────────────────────┐  │
│  │         MCP Tools Layer           │  │
│  │  window / image / text / input    │  │
│  │  / binding / memory / system ...  │  │
│  └──────────────┬────────────────────┘  │
│  ┌──────────────▼────────────────────┐  │
│  │        Automation Engine          │  │
│  │     Win32 API / COM / ctypes      │  │
│  └──────────────┬────────────────────┘  │
└─────────────────┼───────────────────────┘
┌─────────────────▼───────────────────────┐
│          Windows 系统底层               │
│     GDI / DX / Win32 API               │
└─────────────────────────────────────────┘

# 1. 克隆仓库
git clone <this-repo-url>
cd OmniFlow

# 2. 创建虚拟环境
python -m venv .venv
.venv\Scripts\activate   # Windows
# source .venv/bin/activate  # Linux/Mac (部分功能不支持)

# 3. 安装依赖（关键：必须 `pip install -e .`，让 omniflow 包可被 `python -m omniflow` 导入）

# 方式一：使用 requirements.txt + editable install（推荐）
pip install -r requirements.txt
pip install -e .

# 方式二：一行搞定
pip install -r requirements.txt && pip install -e .

{
  "mcpServers": {
    "omniflow": {
      "command": "<venv-python>",
      "args": ["-m", "omniflow"],
      "cwd": "<本地 OmniFlow 仓库路径>"
    }
  }
}

OmniFlow/
├── .gitignore               # Git 忽略配置
├── README.md                # 项目说明
├── OmniFlow 使用示例.md      # 使用示例（按场景组织：PS / 截图 / 画图）
├── requirements.txt         # Python 依赖
├── pyproject.toml          # 项目元数据
├── scripts/                 # 辅助脚本
├── src/
│   └── omniflow/
│       ├── __init__.py
│       ├── __main__.py       # 入口 (python -m omniflow)
│       ├── server.py         # MCP Server 主逻辑
│       ├── engine/
│       │   ├── __init__.py
│       │   ├── com.py        # COM / Win32 API 封装
│       │   └── types.py      # 类型定义
│       └── tools/
│           ├── __init__.py
│           ├── window.py     # 窗口相关 Tools（含 window_close）
│           ├── binding.py    # 绑定相关 Tools
│           ├── image.py      # 图色识别 Tools
│           ├── ocr.py        # 文字识别 Tools
│           ├── input.py      # 键鼠模拟 Tools
│           ├── memory.py     # 内存操作 Tools
│           ├── system.py     # 系统相关 Tools（含 run_program）
│           ├── workflow.py   # 工作流 Tools（v2 引擎：IF / WAIT_FOR_WINDOW / 变量系统）
│           └── plugin.py     # 插件系统 Tools
├── examples/
│   ├── open_photoshop.py    # Photoshop 自动化示例
│   └── workflows/
│       └── infinite_fish_auto_sell.json   # v2 引擎完整工作流示例（自包含）
└── tests/
    ├── __init__.py
    ├── test_tools.py        # 工具基础测试
    └── test_workflow_v2.py  # workflow v2 引擎回归测试（8 个 case）

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest

# 代码格式化
ruff format src/
ruff check src/