Kyormar 客户端架构

Kyormar 是客户端。IM 与 Agent 可以分别启动，也可以按需连接并交换明确的数据。

CLIENT MAP / INDEPENDENT ↔ LINKEDMODULE READY

01 / COMMUNICATIONIMstandalone

00 / MODULE HOSTCLIENTcomposable

02 / TASK EXECUTIONAGENTstandalone


[ KYORMAR CLIENT ]
    ├── [ IM ] ........ communication / standalone
    ├── [ AGENT ] ..... tasks + tools / standalone
    └── [ IM ] ◀── explicit data ──▶ [ AGENT ]
                       │
                       └──▶ [ DEVTOOLS / READ ONLY ]

[ RUST SERVICE ] ...... closed / remote capabilities only

IM ONLY / READYAGENT ONLY / READYLINKED / ON DEMAND

CLIENT MODULES

一个客户端，不要求两个模块同时存在。

01MODULE HOST
Kyormar Client
desktop / modules / visible UI
提供原生桌面、模块生命周期和可见工作区，让 IM 与 Agent 拥有统一入口但不互相绑死。
打开公开仓库：Kyormar-GPUI
02COMMUNICATION MODULE
IM
messages / people / collaboration
可以单独作为沟通客户端运行；连接 Agent 后，只接收明确的进度、确认请求和结果。
查看通信边界：IM 数据交换
03TASK MODULE
Agent
context / tools / results
可以单独处理任务、上下文和工具；连接 IM 后，只输出可消费的任务状态和结果。
查看通信边界：Agent 数据交换

COMPOSITION MODES / OPT IN TO LINK

需要哪种能力，
就启动哪种模块。

这里的“可插拔”指产品模块可以独立启停和组合使用，不承诺在任意执行中间点热卸载二进制组件。

MODEACTIVEEXCHANGEUSER RESULT

01IM_ONLY[ IM ]NONE独立消息与协作

02AGENT_ONLY[ AGENT ]NONE独立任务与工具执行

03LINKED[ IM + AGENT ]EXPLICIT EVENTS消息、进度、确认与结果互通

04OBSERVED[ CLIENT ]DEVTOOLS只读事件、状态与工具轨迹

DATA EXCHANGE / EXPLICIT EVENTS

组合不是状态混在一起，
而是明确地发送和接收。

每条数据都有发送方、事件类型和可见结果。IM 不接管 Agent 的任务状态，Agent 也不复制 IM 的完整会话。

kyormar://trace/session-7F2A● LIVE

09:41:0801[ IM ]TASK_REQUESTED

把明确消息发送给 Agent

09:41:0902[ AGENT ]WORK_STARTED

任务开始并返回可见进度

09:41:1203[ IM ]APPROVAL_RETURNED

用户确认回到 Agent

09:41:1804[ AGENT ]RESULT_SHARED

最终结果进入 IM 协作

MODULE BOUNDARIES

独立时完整，组合时克制。

IM 可以独立运行: 只使用沟通与协作时，不需要启动 Agent，也不会创建任务或工具状态。
Agent 可以独立运行: 只使用任务与工具时，不需要启动 IM；结果可以留在 Agent 的可见入口中。
组合不等于合并状态: 两边只交换明确的数据与事件，各自保留生命周期、存储和失败边界。
DevTools 只做开放观测: 开源工具读取事件、状态、工具调用和通信轨迹，用于复现与调试，不成为第二个业务状态源。
另有 Rust 服务端: 它承接必要的账号与远端团队能力，客户端不依赖它才能启动；服务端不开源，官网不展示其内部架构。

Kyormar Client

IM

Agent