Macro Deck：可定制的宏键盘控制面板

项目简介

Macro Deck 是面向 Windows、macOS 和 Linux 的开源宏键盘（macro pad）软件，可以用来搭建完全自定义的控制面板。你可以用配置文件和文件夹组织自己的操作布局，再往里放入各种交互式小部件，例如操作按钮、滑块、媒体控制、天气显示等，然后用手机、平板或兼容硬件在一个地方控制应用程序、服务和设备。

主要功能

• 灵活的组织方式：可创建多个 profile，用文件夹整理，并由按钮、滑块、媒体播放器、天气信息等小部件组成控制面。
• 基于 Web 的架构：在局域网内用任意现代浏览器配置和控制，也可以作为浏览器游戏内覆盖层使用；Web 客户端无需安装原生伴侣应用就能直接当宏键盘用，启用 HTTPS 后还能安装为 PWA。
• 伴侣应用（可选）：原生伴侣应用相比 Web 客户端性能更好、功能更多，需要一次性授权费用；Android 版在 Google Play，iOS 版在 App Store。原生伴侣应用和兼容硬件都可以连接到同一个 Macro Deck 主机。
• 安全优先的插件生态：官方 Macro Deck Store 上架前会审核插件、图标包、模板等内容，通过审核的包由 Store 签名，安装时会校验签名；不是来自可信 Store 渠道的包会明确提示。手动安装和开发第三方插件仍然可行。
• 面向开发者：提供公开的插件 SDK、工具与文档，包括开发者文档、插件模板和面向编码智能体的 Agent skills。

安装与使用

Macro Deck 主机端支持 Windows、macOS 和 Linux。Debian / Ubuntu 的 64 位 x86 系统可通过官方 APT 仓库安装：先添加 GPG 密钥与软件源（https://packages.macro-deck.app，Suites: stable），然后执行：

sudo apt install macro-deck

后续升级使用 sudo apt upgrade。如需接收预发布版本，把软件源中的 Suites 改为 beta。

安装后在浏览器中打开 Macro Deck 的 Web 界面即可开始配置控制面板，也可以安装伴侣应用连接同一主机。

注意事项

• README 说明 Macro Deck 3 目前仍在积极开发中，可能包含不完整或不稳定的功能。
• 伴侣应用为可选的付费应用，需要一次性授权费用。
• Macro Deck 以 Apache-2.0 许可证开源，但项目名称、logo 和其他品牌资产不在该许可证范围内；派生作品需要使用自己的名称和品牌并替换相关素材。

本作品整理自 GitHub 开源项目 Macro-Deck-App/Macro-Deck，原作者 @Macro-Deck-App，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。