设计并实现 MonkeyCode 端点桥接通信协议

CONTEXT.md

@@ -0,0 +1,85 @@
+# MonkeyCode 客户端协作通信
+
+该上下文定义 MonkeyCode 客户端之间发现、寻址与协作时使用的共同语言。
+
+## Language
+
+**端点（Endpoint）**:
+在 MonkeyCode 客户端间通信中可被发现和寻址的原生应用安装实例，与一个 Agent 一一对应。任务是端点管理的资源，不是端点本身。
+_Avoid_: 客户端、设备、任务
+
+**Agent**:
+通过端点参与通信的执行主体，与端点共享一对一身份。
+_Avoid_: 子 Agent、任务、能力
+
+**发现域（Discovery Domain）**:
+允许互相发现的一组端点所构成的安全边界。
+_Avoid_: 团队、项目、租户
+
+**机器标识（Machine ID）**:
+MonkeyCode 首次安装时生成并在本地安全保存的随机 UUID，与用户身份共同标识一个端点。
+_Avoid_: 硬件指纹、MAC 地址、硬盘序列号
+
+**桥接服务（Bridge）**:
+连接端点并负责鉴权、发现和消息路由的中心服务，不参与端点载荷所表达的业务行为。
+_Avoid_: Agent、任务服务
+
+**载荷（Payload）**:
+端点之间交换的业务数据，其语义由通信双方约定，对桥接服务没有领域含义。
+_Avoid_: 路由信息、协议信封
+
+**本地文件（Local File）**:
+由源端点持有和保存、其他端点通过 Agent 自定义协议访问的文件。
+_Avoid_: OSS 对象、远程附件、桥接服务文件
+
+**业务消息（Agent Message）**:
+一个 Agent 明确发送给另一个目标 Agent 的单播消息。
+_Avoid_: 广播、目录快照
+
+**消息标识（Message ID）**:
+由发送方生成、用于唯一识别一条业务消息的 UUID；响应通过引用请求的消息标识建立关联。
+_Avoid_: 请求状态、任务标识、端点标识
+
+**事件消息（Event Message）**:
+发送方不要求目标 Agent 返回结果的业务消息。
+_Avoid_: 目录事件、请求
+
+**请求消息（Request Message）**:
+要求目标 Agent 返回关联结果的业务消息。
+_Avoid_: 事件、通知
+
+**响应消息（Response Message）**:
+引用某个请求并携带其处理结果的业务消息。
+_Avoid_: 新请求、送达回执
+
+**协议错误（Protocol Error）**:
+桥接服务因鉴权、信封校验或路由失败而产生的错误，与 Agent 返回的业务结果无关。
+_Avoid_: 业务失败、Agent 响应
+
+**结果未知（Outcome Unknown）**:
+请求未在发送方等待期限内得到响应，因而无法判断目标 Agent 是否已经执行。
+_Avoid_: 执行失败、未送达
+
+**目录快照（Directory Snapshot）**:
+发现域内全部未撤销端点的当前视图，在连接就绪及目录发生变化时整体发送。
+_Avoid_: 增量事件、目录补丁
+
+**在线路由（Online Routing）**:
+消息只被投递给当前在线的目标端点，目标离线时不会被桥接服务留存等待补发。
+_Avoid_: 离线消息、消息队列、存储转发
+
+**端点目录（Endpoint Directory）**:
+发现域内已登记端点的持久化集合，包含在线和离线端点。
+_Avoid_: 在线连接列表、消息订阅列表
+
+**端点资料（Endpoint Profile）**:
+用于帮助用户辨认端点和判断兼容性的最小公开信息，包括名称、操作系统、架构及客户端与协议版本。
+_Avoid_: 硬件清单、用户信息、网络地址
+
+**在线状态（Presence）**:
+端点当前是否与桥接服务保持有效连接的临时状态，不影响端点在目录中的身份。
+_Avoid_: 端点身份、注册状态
+
+**已撤销端点（Revoked Endpoint）**:
+被暂停桥接连接资格的端点，其身份记录仍被保留以阻止自动重新登记；持有有效用户会话的客户端可以显式恢复。
+_Avoid_: 已删除端点、离线端点