القائمة
HotPlex 二进制更新。完整工作流：构建 → 安装 → 服务重启 → 验证 → 错误处理和回滚机制。支持用户级和系统级服务，跨平台兼容（Linux/macOS/Windows）。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
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。