RshaCuDeVidro/larperCord

项目介绍

larperCord 是用 Zig 编写、基于 SDL3 与 Dear ImGui 绘制的原生 Discord 客户端，目标用户是希望用比 Electron 版官方客户端更省内存的 Linux 和 Windows 用户。README 给出的日常使用内存约 130 MB、Linux 二进制约 15 MB README lines 42–56。它最有辨识度的设计是界面完全由一个 .kdl 主题文件描述：内置 11 套主题各有明暗两版，保存主题文件即通过 inotify 触发现窗重载 README lines 57–140。

除聊天外，它实现了 Discord 网关与 session RESUME、限速的 REST 请求、基于 UDP/RTP 的 Opus 语音通话与 DAVE 端到端加密、子区与论坛、回应、回复、收件箱、离线缓存与搜索、多账号、Lua 插件和系统托盘 README lines 57–140。主题语法和插件 API 分别见主题指南与插件指南。

快速使用

1. 下载预编译二进制：Linux x86_64 或 Windows x86_64 压缩包，也可浏览全部版本。Linux 上执行 chmod +x larpercord-linux-x86_64 后运行；Windows 解压后打开 larpercord.exe。Windows 版本未签名，首次运行会触发 SmartScreen 警告 README lines 159–182。
2. 也可以用安装脚本，它会下载最新版本并用 SHA256SUMS 校验：Linux 上执行 curl -fsSL https://raw.githubusercontent.com/RshaCuDeVidro/larperCord/main/install.sh | sh（安装到 ~/.local，无需 sudo），Windows 在 PowerShell 中执行 irm https://raw.githubusercontent.com/RshaCuDeVidro/larperCord/main/install.ps1 | iex README lines 159–182。
3. 不配置 token 时应用以演示模式运行。连接真实账号可把 token 存入系统密钥环，例如 secret-tool store --label='larperCord' service larpercord，或设置 LARPER_TOKEN，或写入 ~/.config/larpercord/token 并 chmod 600 README lines 183–204。
4. 想改界面就把自己的 .kdl 主题文件替换进主题目录，保存即生效；启动时可用 larpercord --theme vidro 指定主题 README lines 227–258。

从源码构建需要 Zig 0.17、SDL3、FreeType、fontconfig 和支持 WebSocket 的 libcurl（7.86+）；可选 FFmpeg 7–9 用于应用内视频播放。Arch 上的命令：

sudo pacman -S zig sdl3 freetype2 fontconfig curl inter-font ttf-jetbrains-mono noto-fonts-emoji
zig build -Doptimize=ReleaseFast
./zig-out/bin/larpercord --theme vidro

README lines 236–242

使用约束

• 第三方 Discord 客户端违反 Discord 服务条款，账号可能被封；README 建议使用小号，并列出频繁加入/退出服务器、反复重启等可能触发锁号的场景 README lines 22–35。
• 屏幕共享、摄像头、通过邀请加入服务器、Linux 上的 D-Bus 原生通知尚未实现；语音与通知依赖系统能力 README lines 183–204。
• Linux 二进制要求 glibc 2.34+（约 2022 年之后的发行版），FreeType、fontconfig、libwebp、Opus 和 zlib 需由系统提供。Windows 版本未签名，可能因 Discord 相关字符串被杀毒软件误报 README lines 159–182。
• 项目尚未确定许可证，只有第三方组件各自保留许可证（Dear ImGui 与 dear_bindings 为 MIT，RNNoise 为 BSD）README lines 300–303。
• 按住说话只在应用窗口获得焦点时有效，因为 SDL 没有可移植的全局快捷键 README lines 57–140。

HotRepo 点评

HotRepo 对该项目只有一条记录：2026-11-06 的新项目榜，127 stars、9 forks，在 UTC 20:45 至 22:45 约两小时内新增 26 stars；采集样本从 101 涨到 127 stars。没有全语言日榜名次记录，因此能确认的只是早期极短窗口内的增长，无法据此判断持续采用情况。对于一个以主题文件驱动界面为卖点的 Zig 原生客户端，读者真正能带走的是主题与插件文档以及源码；未签名的 Windows 二进制和用管道直接执行的安装脚本值得按常规保持谨慎，但不能据此认定安全与否。