Menu
HotPlex 二进制更新。完整工作流：构建 → 安装 → 服务重启 → 验证 → 错误处理和回滚机制。支持用户级和系统级服务，跨平台兼容（Linux/macOS/Windows）。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
HotPlex 架构深度审计。覆盖架构分析、SOLID/DRY 合规、并发安全、性能优化、安全扫描、存量 issue 审计与清理。自动创建 GitHub Issue，支持 `/loop` 循环执行。**核心流程**：选定模块 → 静态分析 → 产出结构化发现 → 自动建 issue → 闭环修复。
HotPlex issue 批量管理与合并 PR 交付。将分散的 GitHub issues 转化为一个合并 PR——对传统一个-issue-一个-PR 工作流的刻意替代，减少合并冲突和审查疲劳。覆盖 issue 优先级排列、批量修复规划与实施、ROI 计算。
HotPlex Worker Gateway 标准化发布流程。**立即使用此 skill**：当需要发布新版本、创建 GitHub Release、管理版本号、生成 Changelog、收集变更或验证版本一致性时。自动化版本发布流程，确保完整的变更记录和跨所有组件的版本统一。无论是在 main 分支正式发布，还是在 feature 分支准备发布材料，此 skill 都能指导你完成正确的流程。
HotPlex Slack 与 Cron CLI 命令示例参考。当需要执行 hotplex slack 子命令（发消息、上传/下载文件、更新/定时消息、频道、书签、表情回复）或 hotplex cron 子命令（创建/列出/查看/更新/删除/触发/历史定时任务）时使用。
HotPlex 生产环境安装、配置、部署与故障排查。以 `hotplex doctor` 诊断驱动，覆盖 onboard 向导、4 种 Worker 配置、STT/TTS、系统服务。当用户提到安装、配置、部署、doctor、onboard、环境检查、setup、启动失败、连接问题、凭证错误、服务无法启动时触发——即使用户只是描述了运行异常，也应先跑 doctor 诊断再排查。
HotPlex 文档中心变更驱动巡逻。检测代码变更对文档的影响并执行精准维护：版本发布后审查、重大 PR 合并后检查、文档腐烂检测。先理解代码世界发生了什么变化，再判断文档世界需要哪些响应——像专业技术文档工程师一样思考，而非跑检查清单。
| name | hotplex-update |
| description | HotPlex 二进制更新。完整工作流：构建 → 安装 → 服务重启 → 验证 → 错误处理和回滚机制。支持用户级和系统级服务，跨平台兼容（Linux/macOS/Windows）。 |
hotplex service restart 原子指令stop → sleep 2 → cp → start，因为服务管理器需要时间释放文件句柄hotplex CLI、make 和 go 1.26+hotplex service install，支持 user/system 级别）~/.local/bin/）的写入权限make build
构建失败：检查编译错误、确认 Go 版本（1.26+）、检查缺少的依赖。
ls -lh ./bin/hotplex-$(go env GOOS)-$(go env GOARCH) ~/.local/bin/hotplex
确认新构建的时间戳比当前运行的版本更新。
hotplex service stop
sleep 2 # 重要：服务管理器需要 1-2 秒释放文件句柄
服务未运行是正常的（命令幂等）。停止失败：检查 hotplex service status 和 hotplex service logs -n 20。
cp -f ./bin/hotplex-$(go env GOOS)-$(go env GOARCH) ~/.local/bin/hotplex
"Text file busy" → 服务未完全停止，返回步骤 3 等待更长时间。"Permission denied" → 检查 ~/.local/bin/ 写入权限。
hotplex service start
启动失败：检查 hotplex service logs（常见问题：端口 8888/9999 被占用、配置语法错误、运行时错误、缺少依赖）。严重问题考虑回滚。
hotplex service status
确认状态为 active，PID 与更新前不同（证明确实重启了）。
sleep 2 && hotplex service logs | tail -20
成功标志：Gateway banner 正确显示、无 panic/error、至少一个适配器连接成功、Gateway 在端口 8888 监听。
对安全策略更新：测试 /cd 命令。对错误消息改进：测试触发场景。对新功能：按更新内容设计验证用例。
更新失败时快速恢复：
# 1. 停止服务
hotplex service stop
# 2. 恢复先前二进制（有备份时）
cp /tmp/hotplex.backup.<timestamp> ~/.local/bin/hotplex
# 或从 Git 历史重新构建
git log --oneline -5
git checkout <previous-commit-hash>
make build
cp -f ./bin/hotplex-$(go env GOOS)-$(go env GOARCH) ~/.local/bin/hotplex
# 3. 重启并验证
hotplex service start
hotplex service status
hotplex service logs | tail -20
回滚后：如切换了 git commit，记得切回正确分支；记录问题原因以便修复。
# 带备份的完整流程（推荐生产环境）
cp ~/.local/bin/hotplex /tmp/hotplex.backup.$(date +%s)
make build && \
hotplex service stop && \
sleep 2 && \
cp -f ./bin/hotplex-$(go env GOOS)-$(go env GOARCH) ~/.local/bin/hotplex && \
hotplex service start && \
sleep 2 && hotplex service logs | tail -20
cp ~/.local/bin/hotplex /tmp/hotplex.backup.$(date +%s) — 几秒钟，但节省大量回滚时间hotplex service 命令跨平台通用（Linux → systemd，macOS → launchd，Windows → SCM）。不要直接调用 systemctl/launchctl/sc.exeText file busy、服务启动失败、旧版本残留、新功能不工作、服务频繁重启——诊断和解决方法见 references/troubleshooting.md。