SuperAPI AI 工具集

matrix-openapi-skill

编程与开发

查看项目

更新于 10-16 08:48

技能介绍

用途:该技能用于通过 uxc + OpenAPI 执行 Matrix Client-Server 操作,复用 uxc 的共享执行、认证与错误处理机制。

前提条件:uxc 已安装并在 PATH 中;可访问目标 homeserver 的 client-server 基础 URL,通常为 https://<homeserver>/_matrix/client/v3;可访问精选 OpenAPI 架构 URL;持有目标 homeserver 的 Matrix 访问令牌。

覆盖范围:令牌所有者查询、已加入房间发现、房间状态查询、/sync 轮询读取(含守护进程支持的 poll subscribe)、用户资料与在线状态查询、房间消息发送。不覆盖:登录、SSO、设备注册或通用令牌获取流程;appservice、federation 或 bot 框架抽象;webhook 或长运行事件接收运行时;完整 Matrix 规范覆盖。

使用方式:默认先创建固定链接命令:uxc link matrix-openapi-cli https://matrix.org/_matrix/client/v3 --schema-url <架构URL>。先查看操作架构,如 matrix-openapi-cli get:/account/whoami -h;优先进行读取验证再写入,如 get:/account/whoami、get:/joined_rooms。执行可用键值或位置 JSON。后台 /sync 轮询可直接用 uxc subscribe start 指向 homeserver 基础 URL。

认证:使用 Authorization: Bearer <access_token>。OAuth 感知 homeserver 可用 uxc auth oauth start/complete 与 uxc auth binding add;已有令牌时可用 uxc auth credential set matrix-access --auth-type bearer --secret-env MATRIX_ACCESS_TOKEN 再绑定。用 uxc auth binding match 校验映射。

限制:uxc auth oauth 仅适用于暴露 Matrix OAuth 元数据的 homeserver;遗留登录与 SSO 回退流程尚未覆盖。许多 homeserver 会依据成员身份与服务器策略限制在线状态可见性及房间状态/事件访问,认证成功不代表所有读取都会成功。发送操作风险高,默认仅 m.room.message 文本发送,每次发送使用唯一 txnId 避免重复。保持 JSON 输出信封,不要使用 --text。