# 快速开始

推荐 Windows 用户直接运行：

```bat
START-CODEFLOWMU-OPEN.bat
```

启动器会检查 Node.js 和 npm，创建本地 `.venv`，安装 Python 依赖，安装 Node 依赖，并启动本地面板。

默认地址：

```text
http://127.0.0.1:18765/
```

首次启动会清理公开版运行态缓存，让界面进入干净初始化状态。它不会清理源码、Git 仓库、`node_modules` 或 `.venv`。

## 第一步：添加你的项目

公开版的 `CodeFlowMu-open` 是工具安装目录，受保护，不能作为开发目标。

启动后进入：

```text
设置 → 项目 → 添加项目
```

选择你自己的产品或代码目录，然后设为当前项目。之后：

- FCoP 初始化写入你的项目根；
- TASK / REPORT / REVIEW 写入你的项目根；
- 附件、聊天上下文和 Agent 会话绑定你的项目根；
- CodeFlowMu-open 自身不会被 Agent 当成任务目标修改。

如果你还没有切换到外部项目根，公开版会拒绝创建任务、初始化 FCoP 或运行 Agent 会话。

手动启动：

```bash
npm install
npm start
```