Disponibilidade de Material de Apoio

Esta cópia do catálogo contém as orientações inline abaixo, mas não inclui os seguintes caminhos de suporte. São pré-requisitos externos, não arquivos empacotados:

• <support-root>/references/matrix-client.md
• <support-root>/references/timeline-handling.md
• <support-root>/references/moly-api-integration.md

Solicite o material de apoio original ou uma instalação existente antes de usar uma etapa que dependa desses caminhos; este catálogo não identifica uma fonte de download verificada para eles. Resolva cada caminho em relação a essa instalação, inspecione seu conteúdo e verifique quaisquer licenças e pré-requisitos de execução aplicáveis. Não execute um comando nem afirme que um procedimento referenciado foi seguido até que seu arquivo necessário exista. Não fabrique os scripts ausentes nem trate um arquivo não relacionado com o mesmo nome como equivalente. Etapas independentes totalmente documentadas aqui podem prosseguir dentro do escopo autorizado do usuário; relate qualquer etapa dependente como indisponível.

Habilidade de Integração Robius Matrix SDK

Melhores práticas para integrar APIs externas com aplicações Makepad baseadas em bases de código Robrix e Moly.

Bases de código fonte:

• Robrix: Integração Matrix SDK - sliding sync, assinaturas de timeline, atualizações em tempo real
• Moly: Integração OpenAI/LLM API - SSE streaming, protocolo MCP, suporte multi-provedor

Quando Usar

Use esta habilidade quando:

• Integrar o Matrix SDK com Makepad
• Construir um cliente Matrix com Makepad
• Implementar funcionalidades do Matrix (salas, timelines, mensagens)
• Lidar com operações assíncronas do Matrix SDK na UI
• Palavras-chave: matrix-sdk, matrix client, robrix, matrix timeline, matrix room, sliding sync

Visão Geral

Robrix usa os crates matrix-sdk e matrix-sdk-ui para se conectar a homeservers Matrix. As principais decisões arquiteturais:

1. Sliding Sync: Usa sliding sync nativo para atualizações eficientes da lista de salas
2. Runtime Separado: O runtime Tokio executa operações Matrix, Makepad lida com a UI
3. Padrão Requisição/Resposta: A UI envia requisições, recebe ações/atualizações de volta
4. Tarefas de Background por Sala: Cada sala tem uma tarefa dedicada de assinatura de timeline

Padrão MatrixRequest

Definição do Enum de Requisição

/// All async requests that can be made to the Matrix worker task
pub enum MatrixRequest {
    /// Login requests
    Login(LoginRequest),
    Logout { is_desktop: bool },

    /// Timeline operations
    PaginateRoomTimeline {
        room_id: OwnedRoomId,
        num_events: u16,
        direction: PaginationDirection,
    },
    SendMessage {
        room_id: OwnedRoomId,
        message: RoomMessageEventContent,
        replied_to: Option<Reply>,
    },
    EditMessage {
        room_id: OwnedRoomId,
        timeline_event_item_id: TimelineEventItemId,
        edited_content: EditedContent,
    },
    RedactMessage {
        room_id: OwnedRoomId,
        timeline_event_id: TimelineEventItemId,
        reason: Option<String>,
    },

    /// Room operations
    JoinRoom { room_id: OwnedRoomId },
    LeaveRoom { room_id: OwnedRoomId },
    GetRoomMembers {
        room_id: OwnedRoomId,
        memberships: RoomMemberships,
        local_only: bool,
    },

    /// User operations
    GetUserProfile {
        user_id: OwnedUserId,
        room_id: Option<OwnedRoomId>,
        local_only: bool,
    },
    IgnoreUser {
        ignore: bool,
        room_member: RoomMember,
        room_id: OwnedRoomId,
    },

    /// Media operations
    FetchAvatar {
        mxc_uri: OwnedMxcUri,
        on_fetched: fn(AvatarUpdate),
    },
    FetchMedia {
        media_request: MediaRequestParameters,
        on_fetched: OnMediaFetchedFn,
        destination: MediaCacheEntryRef,
        update_sender: Option<crossbeam_channel::Sender<TimelineUpdate>>,
    },

    /// Typing/read indicators
    SendTypingNotice { room_id: OwnedRoomId, typing: bool },
    ReadReceipt { room_id: OwnedRoomId, event_id: OwnedEventId },
    FullyReadReceipt { room_id: OwnedRoomId, event_id: OwnedEventId },

    /// Reactions
    ToggleReaction {
        room_id: OwnedRoomId,
        timeline_event_id: TimelineEventItemId,
        reaction: String,
    },

    /// Subscriptions
    SubscribeToTypingNotices { room_id: OwnedRoomId, subscribe: bool },
    SubscribeToPinnedEvents { room_id: OwnedRoomId, subscribe: bool },
}

Padrão de Submissão

static REQUEST_SENDER: Mutex<Option<UnboundedSender<MatrixRequest>>> = Mutex::new(None);

/// Submete requisição da thread da UI para o runtime assíncrono

…