SYSTEM ARCHITECTURE / 03 BOUNDARIES

OpenColt 系统架构

一项任务只有一份执行真相。桌面负责承接与呈现，Runtime 负责执行语义，Server 只扩展团队控制。

EXECUTION MAP / PRODUCER → CONSUMERCONTRACT READY
00 / INPUTHUMANintent
01 / VISIBLE HOSTGPUIprojection
02 / CONTRACT TRUTHRUNTIMEtyped state
03 / TEAM PLANESERVERoptional sync

[ HUMAN ]
    │ intent
    ▼
[ GPUI ] ── typed request ──▶ [ RUNTIME ]
    ▲                              │
    │ visible projection           ├──▶ [ TOOLS / MCP ]
    │                              │
    └──── shared task state ───────┘
                                   │ optional team state
                                   ▼
                               [ SERVER ]
LOCAL EXECUTION / DEFAULTTEAM CONTROL / ON DEMAND

OWNERSHIP LEDGER

三层，不是三套重复产品。

  1. 01VISIBLE HOST

    GPUI

    intent / projection

    接住人的意图，并把确认请求、工具状态、执行进度和最终结果呈现在原生桌面。

    打开公开仓库：OpenColt-GPUI ↗

  2. 02CONTRACT TRUTH

    Runtime

    session / tools / task

    拥有共享执行语义：会话、上下文、工具循环、权限请求与任务终态都在这里定义。

    查看产品架构：OpenColt-Runtime ↗

  3. 03TEAM PLANE

    Server

    identity / audit / sync

    只承接团队控制与持久化：身份、租户、审计、协作以及需要跨设备同步的状态。

    查看产品架构：OpenColt-Server ↗

CONTRACT MAP / SOURCE OF TRUTH

先确认谁生产状态，
再决定谁负责呈现。

消费层读取明确契约，不从文本、颜色或缺失的子状态里猜测业务语义。

SIGNALOWNERCONSUMERVISIBLE RESULT
01USER_INTENT[ GPUI ]→ Runtime结构化任务请求
02SESSION_STATE[ Runtime ]→ GPUI可见进度与最终结果
03TOOL_PERMISSION[ Runtime ]→ GPUI明确的请求与响应
04TEAM_SYNC[ Server ]→ Runtime / GPUI身份、审计与持久化

VISIBLE TRACE / ONE SHARED FACT

同一项任务，留下同一条可验证轨迹。

每个阶段都有来源、所有者和可见结果。桌面不会重写终态，服务端也不会取代本地执行。

opencolt://trace/session-7F2A● LIVE
01[ GPUI ]INTENT_ACCEPTED

任务进入桌面会话

02[ RUNTIME ]TOOL_LOOP_STARTED

执行步骤开始投影

03[ RUNTIME ]RESULT_COMMITTED

结果成为共享真相

04[ SERVER ]TEAM_STATE_SYNCED

按需同步团队状态

STATE / COMMITTEDPROJECTION / VISIBLE

BOUNDARY RULES

所有权不重叠。

GPUI 不创造执行真相
它投影 Runtime 的任务状态，不在桌面层另建一套工具循环或完成语义。
Runtime 不承担团队控制
执行契约保持可复用；租户、审计与长期持久化由 Server 管理。
Server 不取代本地执行
网络同步扩展团队能力，但不会把每一次桌面任务强制变成远程控制流程。