ai-status-light

OpenCode Monitor

OpenCode 状态监控工具，支持实时监控多个 OpenCode 实例的状态，并通过 MQTT 推送状态信息。

功能特性

• 🔍 自动发现 - 自动扫描并发现运行中的 OpenCode 实例
• 📊 实时监控 - 通过 SSE 事件流实时获取状态变化
• 📡 MQTT 推送 - 支持将状态信息推送到 MQTT Broker
• 💾 配置管理 - 使用 SQLite 存储 MQTT 配置
• 🌐 HTTP API - 提供 RESTful API 接口管理配置
• 🔌 WebSocket - 支持通过 WebSocket 实时推送状态到网页
• 🖥️ 跨平台 - 支持 Linux、macOS、Windows

安装

下载预编译版本

从 dist/ 目录下载对应平台的可执行文件：

• opencode-monitor-linux-amd64 - Linux x86_64
• opencode-monitor-linux-arm64 - Linux ARM64
• opencode-monitor-darwin-amd64 - macOS Intel
• opencode-monitor-darwin-arm64 - macOS Apple Silicon
• opencode-monitor-windows-amd64.exe - Windows x86_64
• opencode-monitor-windows-arm64.exe - Windows ARM64

从源码编译

# 克隆项目
git clone <repository-url>
cd AI-Status-Light

# 编译当前平台
go build -o bin/opencode-monitor ./cmd/monitor

# 编译所有平台
make build-all

使用方法

启动监控

# 自动发现并监控所有 OpenCode 实例
./opencode-monitor monitor

# 监控指定端口
./opencode-monitor monitor --ports 4096,4097

# 启动监控 + API 服务 + WebSocket 实时状态页面
./opencode-monitor monitor --api-addr :8080

启动监控服务后，访问 http://localhost:8080 即可查看实时状态页面。

API 服务

# 启动独立的 API 服务
./opencode-monitor serve --addr :8080

配置管理

# 查看 MQTT 配置
./opencode-monitor config list

# 设置 MQTT 配置（无认证）
./opencode-monitor config set --broker tcp://127.0.0.1:1883 --topic opencode/status

# 设置 MQTT 配置（带认证）
./opencode-monitor config set --broker tcp://127.0.0.1:1883 --username user --password pass --topic opencode/status

# 删除配置
./opencode-monitor config delete 1

API 接口

方法	路径	说明
GET	/api/health	健康检查
GET	/api/mqtt	获取所有配置
POST	/api/mqtt	创建配置
GET	/api/mqtt/:id	获取单个配置
PUT	/api/mqtt/:id	更新配置
DELETE	/api/mqtt/:id	删除配置
GET	/	状态监控页面
GET	/ws	WebSocket 连接

请求示例

# 创建 MQTT 配置（无认证）
curl -X POST http://localhost:8080/api/mqtt \
  -H "Content-Type: application/json" \
  -d '{"broker":"tcp://127.0.0.1:1883","topic":"opencode/status"}'

# 创建 MQTT 配置（带认证）
curl -X POST http://localhost:8080/api/mqtt \
  -H "Content-Type: application/json" \
  -d '{"broker":"tcp://127.0.0.1:1883","username":"user","password":"pass","topic":"opencode/status"}'

# 获取所有配置
curl http://localhost:8080/api/mqtt

MQTT 消息格式

消息格式为 JSON：

{
  "port": 4096,
  "status": "忙碌",
  "timestamp": "2026-06-03T14:30:00Z"
}

推送的状态类型

状态	说明
空闲	会话空闲
忙碌	会话忙碌
重试中	会话重试中
修改中	会话修改中
思考中	模型推理中
运行中	工具执行中
完成	工具执行完成
错误	会话错误

命令行参数

monitor 命令

./opencode-monitor monitor [选项]

选项:
  --host string        主机地址 (默认 "127.0.0.1")
  --ports string       端口列表，逗号分隔 (如: 4096,4097,4098)
  --scan string        扫描端口范围 (如: 4096-4100)
  --pid                通过进程号查找端口
  --interval int       动态扫描间隔(秒) (默认 5)
  --db string          数据库路径 (默认 "./data/config.db")
  --api-addr string    API 服务地址 (如: :8080)

serve 命令

./opencode-monitor serve [选项]

选项:
  --addr string    监听地址 (默认 ":8080")
  --db string      数据库路径 (默认 "./data/config.db")

config set 命令

./opencode-monitor config set [选项]

选项:
  --broker          MQTT Broker 地址 (必填)
  --client-id       MQTT 客户端 ID (默认 "opencode-monitor")
  --username        MQTT 用户名
  --password        MQTT 密码
  --topic           MQTT 主题 (默认 "opencode/status")
  --enabled         是否启用 (true/false, 默认 true)
  --db              数据库路径 (默认 "./data/config.db")

项目结构

AI-Status-Light/
├── cmd/monitor/          # 程序入口
├── internal/
│   ├── api/              # HTTP API 模块
│   ├── database/         # SQLite 数据库模块
│   ├── discovery/        # 端口发现模块
│   ├── event/            # 事件处理模块
│   ├── monitor/          # 监控器核心模块
│   └── mqtt/             # MQTT 客户端模块
├── docs/                 # 文档
├── dist/                 # 编译产物
└── Makefile              # 构建脚本

开发

# 安装依赖
go mod tidy

# 运行测试
go test ./...

# 构建
make build

# 构建所有平台
make build-all

许可证

MIT License