快速开始

安装

从 Releases 下载对应平台的安装包：

• Linux：.deb 或 .AppImage
• macOS：arm64 / x86_64 .dmg
• Windows：NSIS 安装包、MSI 或便携 .zip

启动

启动 AgentBeacon 桌面应用，或直接运行本地服务：

agent-beacon

然后打开 http://127.0.0.1:6980。

连接状态灯

插入 MLight 或 YH50-RGY-J 状态灯，设备会被自动发现。控制台会显示设备型号、连接方式和支持的能力（亮度 / 蜂鸣器）。

没有硬件时可以选择 mock 设备，验证「上报 → 聚合 → 设备命令」的完整链路。

接入 agent

内置集成随服务分发，可以用 CLI 安装：

agent-beacon integrate install pi        # Pi
agent-beacon integrate install opencode  # OpenCode
agent-beacon integrate install dsh       # DeepSeek Harness

Claude Code 通过 hooks 接入；其他 agent 可以使用 agent-beacon report 或 HTTP API。

下一步

• 设备与能力
• Agent 集成
• 本地服务参考