hotplex-setup

# HotPlex 生产环境安装指引 以 `hotplex doctor` 为诊断核心。**先诊断再行动**——不要手动逐项检查依赖，doctor 集成了 26 个 checker（10 个 category），让它先跑。 整个流程幂等，重复运行只处理缺失项。 ## 流程概览 ``` 安装二进制 → onboard → doctor → 按需修复 → service install → 验证 ``` --- ## Phase 1：安装 `hotplex` 已在 PATH 中 → 跳到 Phase 2。 ### 1.1 快速安装脚本 ```bash # macOS / Linux curl -fsSL https://raw.githubusercontent.com/hrygo/hotplex/main/scripts/install.sh | bash -s -- --latest --prefix ~/.local # Windows (PowerShell) Invoke-WebRequest -Uri https://raw.githubusercontent.com/hrygo/hotplex/main/scripts/install.ps1 -OutFile install.ps1 .\install.ps1 -Latest ``` ### 1.2 源码构建（需 Go 1.26+） ```bash git clone https://github.com/hrygo/hotplex.git && cd hotplex make quickstart # check-tools + build + test-short hotplex install # 安装二进制到 PATH（默认 ~/.local/bin，source 构建后推荐执行） ``` ### 1.3 首次配置向导 ```bash hotplex onboard # 交互式（推荐首次） hotplex onboard --non-interactive --enable-slack --slack-allow-from U0XXXXX # CI/自动化 ``` onboard 自动处理：平台凭据、Worker 选择、config.yaml/.env 生成、Agent 配置模板、STT/TTS 检查、系统服务安装（可选）、二进制安装到 PATH。 --- ## Phase 2：诊断 ```bash hotplex doctor --json ``` 参数：`--json`（机器可读）| `-v`（详细）| `-C <category>`（仅指定类别）| `--fix`（自动修复带 FixFunc 的 fail 项） **报告结构**： ```json { "summary": { "pass": N, "warn": N, "fail": N }, "diagnostics": [{ "name": "category.check_name", "status": "pass|warn|fail", "message": "...", "fix_hint": "..." }] } ``` **Exit codes**：0 = 全部通过 | 1 = 有 fail | 3 = 自动修复失败 **分支**：`fail: 0` → Phase 4 | `fail: N` → Phase 3 ...