Sable Legacy：Matrix 聊天客户端

项目简介

Sable Legacy 是一个 Matrix 客户端，从 Cinny 分支而来，目标是在基础聊天之外提供更多实用功能、外观定制与顺手的小工具。项目以 TypeScript 编写，采用 AGPL-3.0 许可证。

稳定网页版托管在 app.sable.moe，跟随最新 GitHub Release；每晚构建（nightly）在 dev.sable.moe。

注意：Sable Legacy 已不再积极维护，开发工作已转移到重写版 Sable v2：https://git.sable.moe/SableClient/Sable-next。

主要功能

• 在 Cinny 基础上加入提升使用体验的 quality-of-life 功能、外观装饰与实用工具。
• 提供网页版、桌面端（Windows / Linux / macOS）、Android APK 与 iOS IPA 多种分发形式。
• 桌面版发布产物附带构建证明（build attestations）；AppImage 与 Windows 安装包自动更新，.deb、.rpm 和 AUR 安装通过包管理器更新。
• 可通过 config.json 修改默认 homeserver、feature rooms/spaces，开关账户切换器、开启实验性的 simplified sliding sync 支持。
• 可在 config.json 中通过顶层 settingsDefaults 覆盖新登录用户的默认客户端设置。
• 支持自托管：官方发布预构建 Docker 镜像 ghcr.io/sableclient/sable。

安装与使用

直接访问网页版

打开 app.sable.moe 即可使用稳定版，dev.sable.moe 为 nightly 构建。

桌面端

Windows 与 Linux 安装包从 releases 下载，Linux 也可通过 Flathub 安装。macOS 通过 Homebrew tap 安装（必须使用完整包名，否则非官方 tap 需要额外 brew trust）：

brew install --cask SableClient/sable/sable

Linux nightly 构建有独立的 Flatpak 源，与 Flathub 稳定版以不同应用 ID 并存：

flatpak remote-add --if-not-exists sable-nightly https://sableclient.github.io/Sable/sable-nightly.flatpakrepo
flatpak install sable-nightly moe.sable.client.Nightly

Android（Obtainium）

每次发布都会附带 APK 和 obtainium.json 配置，可用 Obtainium 直接从 GitHub 跟踪更新；nightly 渠道需开启预发布版本并按日期跟踪版本。稳定版可直接使用 Add to Obtainium 按钮，或用 obtainium.json 通过 Import/Export → Import from file 导入。

iOS（AltStore / SideStore）

每次发布同时提供未签名 IPA 与 altstore-source.json 源清单，稳定版指向 latest release，nightly 指向 nightly release。在设备上配置好 AltStore Classic 或 SideStore 后添加对应源即可安装。

自托管

官方预构建镜像发布在 ghcr.io/sableclient/sable，latest 跟随最新版本发布，dev 跟随 dev 分支，另有 X.Y.Z 与 X.Y 版本标签。运行：

docker run --rm -p 8080:8080 ghcr.io/sableclient/sable:latest

然后打开 http://localhost:8080。如需替换内置的 config.json，可将自己的文件挂载到 /app/config.json：

services:
  sable:
    image: ghcr.io/sableclient/sable:latest
    ports:
      - '8080:8080'
    volumes:
      - ./config.json:/app/config.json:ro

自行构建（产物输出到 dist/，可拷贝到服务器用 nginx 等服务托管）：

pnpm i # Installs all dependencies
pnpm run build # Compiles the app into the dist/ directory

注意事项

• Sable Legacy 已停止积极维护，后续开发在 Sable v2；本仓库适合留档与既有部署继续使用。
• iOS 的 IPA 未签名，需由 AltStore / SideStore 在安装时用个人开发者证书重签，免费账号通常需要每 7 天刷新一次。
• 若要部署到子目录（如 https://sable.moe/app），需要先修改 build.config.ts 中的 base 路径再重新构建。
• settingsDefaults 中的非法或未知键会被忽略。

---

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