码流（CodeFlow）— 指令成流，智能随行

May 11, 2026 · View on GitHub

把 Cursor AI 自动化团队方法论变成了一个真正能用的产品。下载、运行，然后用手机指挥你的 AI 团队。

📜 项目宪法 — 码流 = 面向多 Agent 协作开发的轻量级 AI Runtime / AI OS，用 @cursor/sdk 驱动、应用 fcop-mcp（消费方，不定义 fcop）。 ADMIN 5/9 10:48 + 10:51 两条原话见设计文档 §0.0。

🚀 CodeFlow v2 — 重新定位为 AI Runtime / AI OS（草稿中）： 5 分钟速读 · 完整设计文档

码流 — 指令成流，智能随行码流 — AI 驱动协作中枢码流 — 手机驭 AI

本仓与 FCoP 的关系（先读这段不混）

	本仓库（Bridgeflow / CodeFlow 工具线）	FCoP（独立 GitHub 仓）
是什么	工具项目：Desktop、PWA、中继、手机与 PC 联调等产品实现。	协议 + MCP：文件驱动多 Agent 协作的规范与 PyPI 双包（`fcop` 库 + `fcop-mcp` 服务），与任何具体产品代码分仓维护。
Git	本工作区 / `codeflow-pwa` 等，跟「卖什么功能」走。	仅 FCoP 仓，跟「协议与库怎么演进」走。

把边界写死以后：FCoP 的规范、Python 包、MCP 发版与 PR 只在 FCoP 仓；本仓通过安装或文档链接使用，不再把 FCoP 当成混在本树里的第二套主工程。更细的说明见 docs/integrations/fcop-standalone-zh.md。

码流是什么？

码流是你的 AI 编程团队遥控器。它把你的手机和运行 Cursor IDE 的电脑连起来，让你能：

用手机给 AI 角色派任务
实时看他们干活
干完了收到报告

不需要搭服务器，不需要注册账号。只需要两样东西：

你需要	它干什么
码流 Desktop（EXE）	在你的 PC 上运行，桥接手机和 Cursor IDE
码流 PWA（手机网页应用）	在手机上打开，发任务、看状态

3 分钟上手

第一步：下载桌面端 EXE

国内（推荐）：https://gitee.com/joinwell52/cursor-ai/releases
GitHub：https://github.com/joinwell52-AI/codeflow-pwa/releases

双击 CodeFlow-Desktop.exe（约 35MB）。首次运行选择你的项目文件夹。

第二步：手机打开 PWA

在手机浏览器打开：

https://joinwell52-ai.github.io/codeflow-pwa/

点"添加到主屏幕"安装成 App。

第三步：扫码绑定

桌面端面板上会显示二维码
在 PWA 里点我的 → 扫码绑定 PC
扫一下二维码 — 搞定！绿灯亮了就是连上了

现在你可以用手机发任务，看 AI 团队干活了。

工作原理

手机（PWA）──→  中继（WebSocket）──→  PC 桌面端  ──→  Cursor IDE
  发任务          转发事件            写文件         AI 角色执行
  看状态    ←──   推送更新      ←──   读取报告  ←──   写回报告

每条任务变成一个 Markdown 文件：TASK-20260413-001-ADMIN-to-PM.md

文件名告诉系统谁发的、发给谁、什么时候。不需要数据库，不需要消息队列 — 只有文件。

手机上能做什么

功能	说明
发任务	写内容，选角色（PM/DEV/QA/OPS），发送
看任务列表	分类：任务单 / 报告 / 问题 / 归档
看任务详情	完整 Markdown 原文、流转路径、状态
监控巡检	实时看巡检器在 Cursor 里的动作
远程控制巡检	手机上启动/停止巡检
团队状态	看每个角色是忙碌、空闲还是等待
中英切换	完整的中英文双语界面

你的 AI 团队

码流内置 3 套团队模板，初始化项目时选一套：

模板	角色	适合
dev-team	PM + DEV + QA + OPS	软件开发项目
media-team	PUBLISHER + COLLECTOR + WRITER + EDITOR	自媒体内容创作
mvp-team	MARKETER + RESEARCHER + DESIGNER + BUILDER	创业 MVP

每个角色是一个 Cursor Agent，有独立的规则和职责。桌面端的巡检器自动在角色之间切换、派发任务、卡住了还会催。

自动故障恢复

桌面端持续监控 Cursor IDE，常见问题自动修：

问题	码流怎么处理
Cursor 连接错误	自动 Reload Window
Extension Host 卡死	自动 Reload Window
Agent 卡住或超时	Reload + 发催促消息
Agent 等待确认	自动发送"继续"
WebSocket 断连	自动重连

不用盯着 Agent 干活。去喝咖啡吧。