stumpwm/mahogany

说明与用途

**项目简介**
stumpwm/mahogany 是一个用 Common Lisp 编写的、类 StumpWM 风格的 Wayland 合成器，旨在为喜欢平铺窗口管理器的开发者提供一个高度可编程、轻量级的 Wayland 运行时环境。

**价值**

• **可编程化**：继承了 StumpWM 的 Lisp 配置模型，用户可以用 Lisp 脚本实时修改窗口行为、布局和快捷键，适合需要深度定制的工作流。
• **轻量且透明**：代码基于 Common Lisp，依赖相对少，便于审计和二次开发；对系统资源的占用也比主流的 GNOME/KDE 合成器要低。
• **原型与内部工具**：因为其灵活的扩展能力，适合作为 UI 原型平台或内部工具的显示层，快速验证交互概念。

**典型接入方式**

1. **源码编译**：克隆仓库后，使用 sbcl（或其他兼容的 Common Lisp 实现）编译生成可执行文件。
2. **配置加载**：在 ~/.config/mahogany/ 目录放置 Lisp 配置文件（类似 StumpWM 的 ~/.stumpwmrc），在启动时自动加载。
3. **Wayland 会话**：在 ~/.xinitrc 或 ~/.profile 中添加 exec mahogany，并在登录管理器中选择 “Mahogany” 会话，或直接在终端执行 mahogany 启动 Wayland 会话。
4. **与外部程序交互**：通过 Lisp 提供的 IPC 接口或 DBus（如有实现）与其他后台服务、窗口程序进行通信，实现自定义的工作流集成。

**生产可用性**

• **成熟度**：项目已有 355 颗星、34 次 fork，且最近一次提交在 2026‑05‑10，活跃度尚可。
• **适用场景**：适合内部原型、实验性平台或对窗口管理高度自定义的团队使用。直接在面向终端用户的生产环境部署仍需评估。
• **风险与准备工作**
• **集成路径不明确**：官方文档和元数据提供的集成信息有限，需自行审查源码并验证与现有 Wayland 框架（如 weston、sway）的兼容性。
• **依赖与维护**：确认项目所依赖的 Common Lisp 实现、Wayland 协议版本以及底层库（如 libwayland-client）在目标系统上可用，并评估后续维护成本。
• **稳定性**：目前标记为 “Medium”，在关键业务系统使用前建议进行完整的功能、性能和安全性测试。

综上，stumpwm/mahogany 为需要 Lisp 可编程窗口管理的团队提供了一个灵活的 Wayland 合成器原型平台，适合在受控环境或内部项目中先行试用，正式投入生产前需完成集成验证和运维准备。

实际用途

stumpwm/mahogany may be useful when its README and activity match a concrete workflow.

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.