Mages：跨平台 Matrix 聊天客户端

项目简介

Mages 是一个实验性的 Matrix 聊天客户端，目标是提供一个跨桌面与移动端的客户端，同时不像 Web 应用那样笨重。作者提到最初的动机是：当时能弹出通知、支持屏幕共享、还能常驻系统托盘的 element-desktop 替代品很少。

界面使用 Compose Multiplatform 构建，核心是一个基于 matrix-rust-sdk 的 Rust 库，通过 UniFFI 暴露给 Kotlin 调用（未使用 matrix-sdk-ffi）。

项目明确定位为实验阶段软件，稳定性和功能完整度并不以 Element 等客户端为目标，可能缺少常见功能或存在影响使用的 bug。

主要功能

• 房间列表，带消息预览与未读计数
• 房间与 thread 时间线，支持文本、媒体、投票、实时位置共享
• 端到端加密（由 matrix-sdk 提供）
• Spaces 支持：房间分区；Space 设置较为基础，暂无成员设置
• 简单的在线状态与隐私设置
• 多账号支持，以及语言切换（目前仅有西班牙语）
• 实验性的音视频通话，屏幕共享仅在桌面端可用

各平台情况

• Android：GitHub Releases 提供签名的 APK 与 AAB，也可通过 F-Droid 下载（通常滞后约一周）。GitHub 与 F-Droid 构建使用同一证书 org.mlm.mages，可用 apksigner verify --print-certs <apk> 核对。
• Linux 桌面：提供 x86_64 与 aarch64 的 AppImage，可通过 AUR（mages-bin）、Snap Store、Flathub 获取，AppImage 可用 Gear Lever 一类工具更新。
• 其他平台：Windows 与 Mac 构建未签名、未公证，测试较少；Web 版 可以运行，但功能并不对齐（缺少搜索），主要用于预览未发布的新改动。

从源码构建

需要 JDK 21（Android）、JetBrains Runtime SDK 25（桌面，JAVA_HOME 指向它）、Kotlin/Gradle，以及 Rust stable 工具链；Android 还需要 Android SDK + NDK 与 cargo-ndk。

./gradlew :androidApp:assembleRelease

./gradlew :desktopApp:run

Web 版开发运行：

./gradlew :webApp:wasmJsBrowserDevelopmentRun

另有容器化构建与预构建镜像，详见仓库中的 containers/ReadMe.md。

注意事项

• 项目处于实验阶段，可能缺少常用功能或存在 bug；遇到问题可以向仓库提交 issue。
• 实际持续测试的平台只有 Android 和 Linux AppImage，Windows / macOS 构建未签名，Web 版功能不完整。
• 许可证为 GNU AGPL v3；美术、Logo 与视觉素材采用 CC BY-SA 4.0。

本作品整理自 GitHub 开源项目 mlm-games/Mages，原作者 @mlm-games，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。