hotplex-setuplisted

# HotPlex 生产环境安装指引 以 `hotplex doctor` 为诊断核心。**先诊断再行动**——不要手动逐项检查依赖，doctor 集成了 25 个 checker（9 个 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 ``` ### 1.3 首次配置向导 ```bash hotplex onboard # 交互式（推荐首次） hotplex onboard --non-interactive --enable-slack --slack-allow-from U0XXXXX # CI/自动化 ``` onboard 自动处理：平台凭据、Worker 选择、config.yaml/.env 生成、Agent 配置模板、STT/TTS 检查。 --- ## 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 | 未安装 → Phase 1 --- ## Phase 3：按分类修复 对每个 `status: "fail"` 项查下表。修复后 `hotplex doctor --j