SuperAPI AI 工具集

robius-matrix-integration

通用与其它

查看项目

更新于 10-16 04:33

技能介绍

用途:在 Makepad 应用中集成 Matrix SDK,参考 Robrix(Matrix SDK 集成)与 Moly(OpenAI/LLM API 集成)的代码实践。适用于构建 Matrix 客户端、实现房间/时间线/消息功能,以及在 UI 中处理 Matrix SDK 异步操作。关键词:matrix-sdk、matrix client、robrix、matrix timeline、matrix room、sliding sync。

主要能力:采用滑动同步(Sliding Sync)进行房间列表更新;Tokio 运行时处理 Matrix 操作,Makepad 负责 UI;UI 发请求、接收动作/更新回传;每个房间有独立的时间线订阅任务。

必要用法:通过 MatrixRequest 枚举定义异步请求(登录、分页、发送/编辑/删除消息、加入/离开房间、成员与用户资料、媒体抓取、输入状态、已读回执、表情回应、订阅等);用 submit_async_request 从 UI 线程提交;在 matrix_worker_task 中 match 处理并 spawn 独立任务;用 TimelineUpdate 与 RoomsListUpdate 枚举回传更新,更新后调用 SignalToUI::set_ui_signal() 触发 UI 信号;UI 在 Event::Signal 中轮询 try_recv 消费更新。客户端构建使用 Client::builder() 配 sqlite_store、sliding_sync_version_builder、加解密设置与请求超时。

最佳实践:始终 spawn 任务避免阻塞;每房间用 crossbeam 通道;房间未就绪则跳过请求;房间关闭时 Drop 中中止后台任务;结果用 Cx::post_action 回传;高频房间列表更新用 SegQueue。

限制:本目录未内置支持文件 references/matrix-client.md、references/timeline-handling.md、references/moly-api-integration.md,使用依赖它们的步骤前需先获取原始支持材料或已有安装,并验证许可与执行前提。缺失的事实(如具体安装命令、下载来源)暂未提供。仅在任务明确匹配上述范围时使用;不替代环境验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。