# OpenCode Monitor

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

## 功能特性

- 🔍 **自动发现** - 自动扫描并发现运行中的 OpenCode 实例
- 📊 **实时监控** - 通过 SSE 事件流实时获取状态变化
- 📡 **MQTT 推送** - 支持将状态信息推送到 MQTT Broker
- 💾 **配置管理** - 使用 SQLite 存储 MQTT 配置
- 🌐 **HTTP API** - 提供 RESTful API 接口管理配置（详见 [API 文档](docs/api.md)）
- 🔌 **WebSocket** - 支持通过 WebSocket 实时推送状态到网页（详见 [API 文档](docs/api.md)）
- 🖥️ **跨平台** - 支持 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

### 从源码编译

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

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

# 编译所有平台
make build-all
```

## 使用方法

### 启动监控

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

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

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

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

### API 服务

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

API 接口详情请参阅 [API 文档](docs/api.md)。

### 配置管理

```bash
# 查看 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
```

## MQTT 消息格式

消息格式为 JSON：

```json
{
  "port": 4096,
  "status": "工作中",
  "code": "busy",
  "timestamp": "2026-06-03T14:30:00Z"
}
```

### 推送的状态类型

| status | code | 说明 |
|--------|------|------|
| 空闲 | idle | 会话空闲 |
| 工作中 | busy | 会话工作中 |
| 重试中 | retry | 会话重试中 |
| 修改中 | pending | 会话修改中 |
| 思考中 | reasoning | 模型推理中 |
| 使用工具中 | using_tool | AI 正在使用工具 |
| 等待中 | pending | 工具等待执行 |
| 运行中 | running | 工具执行中（可附带工具名，如 `运行中: read`） |
| 工具执行完成 | completed | 工具执行完成（可附带工具名，如 `工具执行完成: read`） |
| 会话完成 | session_completed | 会话执行完成 |
| 等待权限 | permission | AI 向用户申请权限 |
| 错误 | error | 会话错误 |

## 命令行参数

### monitor 命令

```bash
./opencode-monitor monitor [选项]

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

### serve 命令

```bash
./opencode-monitor serve [选项]

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

### config set 命令

```bash
./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/                 # 文档
├── scripts/              # 构建脚本
└── Makefile              # 构建配置
```

## 开发

```bash
# 安装依赖
go mod tidy

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

# 构建
make build

# 构建所有平台
make build-all
```

## 许可证

MIT License