Multi-agent collaboration.
Files as protocol.多 Agent 协作。
文件即协议。

Create, reconnect, read.创建后，换个客户端仍能读取。

In an active Python 3.10+ virtual environment:在已激活的 Python 3.10+ 虚拟环境中：

python -m pip install "fcop==4.0.3"

Save as demo.py, then run python demo.py.保存为 demo.py，运行 python demo.py。

from pathlib import Path
from tempfile import TemporaryDirectory

from fcop import Project

with TemporaryDirectory(prefix="fcop-demo-") as directory:
    root = Path(directory) / "workspace"
    project = Project(root)
    workspace = project.create_workspace(protocol_version="4.0")
    request = dict(
        workspace_id=workspace["workspace_id"],
        operation_id="demo-create-1",
        sender="ME", recipient="ME",
        subject="Inspect this handoff",
        body="Read the task and check the evidence before accepting delivery.",
    )
    first = project.create_task(**request)

    next_client = Project(root)
    state = next_client.inspect_state(task_id=first["task_id"])
    retry = next_client.create_task(**request)

    assert Path(state["path"]).is_file()
    assert retry["existing"] and retry["task_id"] == first["task_id"]
    print("State read from disk:", state["stage"])
    print("Same task after retry:", retry["task_id"] == first["task_id"])

State read from disk: inbox
Same task after retry: True

The demo cleans up its temporary directory. Reusing the same create operation and payload returns the existing task.示例会清理临时目录。相同创建身份和载荷的重试，会返回已有任务。

Let the agent use the protocol.让 Agent 使用同一套协议。

Install in the same active environment:在同一已激活环境中安装：

python -m pip install "fcop==4.0.3" "fcop-mcp==4.0.3"

Or use uvx to obtain an isolated installation automatically. Configure Cursor or Codex using the examples below; the client starts the server.也可以用 uvx 自动准备隔离安装环境。按下方示例配置 Cursor 或 Codex，由客户端启动服务。

First install uv and confirm uvx --version works in a new terminal. The first connection downloads packages and can take longer.先安装 uv，在新终端确认 uvx --version 可用。首次连接需要下载依赖，可能稍慢。

After connecting, call init_solo(role_code="ME", protocol_version="4.0") for a new workspace, then create and inspect a task.连接后，用 init_solo(role_code="ME", protocol_version="4.0") 初始化新工作区，再创建与检查任务。

Parallel work is available through create_branch, inspect_family and merge_branches: create independent Branch tasks, inspect current REPORT evidence and the canonical family digest, then commit one explicit convergence decision through the Core atomic merge operation.并发工作由 create_branch、inspect_family 和 merge_branches 支持：创建独立 Branch、检查当前 REPORT 证据与规范 family digest，再通过 Core 原子合并提交一次明确的收敛决定。

create_branch → REPORTs → inspect_family → merge_branches