Robius Matrix SDK Integration 是一个面向 Makepad 应用开发者的集成技能，主题是把外部 API 接入 Makepad 应用，方法提炼自 Robrix 与 Moly 两个代码库。
用途 该技能用于以下场景：将 Matrix SDK 与 Makepad 集成；用 Makepad 构建 Matrix 客户端；实现 Matrix 功能（房间、时间线、消息）；在 UI 中处理 Matrix SDK 的异步操作。触发关键词包括 matrix-sdk、matrix client、robrix、matrix timeline、matrix room、sliding sync 等。
来源代码库 Robrix：Matrix SDK 集成，涵盖滑动同步（sliding sync）、时间线订阅与实时更新。 Moly：OpenAI/LLM API 集成，涵盖 SSE 流式传输、MCP 协议与多提供商支持。
主要架构与能力 Robrix 使用 matrix-sdk 与 matrix-sdk-ui crate 连接 Matrix homeserver，关键架构决策为：
- 滑动同步：使用原生滑动同步以高效更新房间列表。
- 独立运行时：Tokio 运行时执行 Matrix 操作，Makepad 负责 UI。
- 请求/响应模式：UI 发送请求，接收返回的 action/update。
- 每房间后台任务：每个房间有专属的时间线订阅任务。
请求/响应与更新机制 文档给出 MatrixRequest 枚举定义，覆盖登录登出、时间线操作（分页、发送消息、编辑消息、删除消息）、房间操作（加入、离开、获取成员）、用户操作（获取资料、忽略用户）、媒体操作（获取头像、获取媒体）、输入/已读指示、表情回应与订阅等。通过 submit_async_request 从 UI 线程向异步运行时提交请求。worker 任务循环接收请求并按类型处理，必要时为具体操作 spawn 专属任务，并通过 channel 把结果或状态回传 UI。
TimelineUpdate 枚举描述时间线更新，包括新条目、分页状态变化、消息编辑结果、房间成员列表获取、未读计数更新与用户权限等级获取。每房间更新流程中，JoinedRoomDetails 持有房间 ID、时间线、更新发送通道与订阅任务句柄，并在 Drop 时中止后台任务与清理订阅。房间列表更新通过 RoomsListUpdate 枚举与 SegQueue 无锁队列实现，包含已加载房间、受邀/已加入房间、最新事件、未读消息数、房间名与头像更新、移除房间、状态与滚动到房间等。
客户端构建 build_client 展示了用 Client::builder 配置 homeserver、SQLite 存储与随机口令、滑动同步版本、解密与加密设置、请求超时等步骤，并返回客户端与会话持久化信息。
最佳实践 文档列出若干实践要点：始终 spawn 任务，避免阻塞 worker 接收循环；每房间更新使用 crossbeam channel；入队任何更新后始终调用 SignalToUI::set_ui_signal()；处理房间尚未就绪的情况；房间关闭时清理并中止后台任务；使用 Cx::post_action 投递结果；高频更新使用 SegQueue。
参考文件 references/matrix-client.md（Matrix 客户端设置与登录模式，Robrix）、references/timeline-handling.md（Matrix 时间线订阅模式，Robrix）、references/moly-api-integration.md（Moly API 集成模式：OpenAI 客户端与 SSE 流式传输、平台无关异步流、MCP 集成、工具审批流程、本地服务器的 MolyClient、多提供商支持的 BotContext）。
限制 本资料未提供该技能的安装命令、收费方式、价格、平台支持范围与效果数据；上述内容以来源文档中明确的代码与说明为准，未提及的功能与步骤暂未提供。