HotPlex
July 7, 2026 · View on GitHub
HotPlex 是一个 AI Coding Agent 统一管理平台。通过飞书、Slack 或 WebChat 远程遥控你的 AI Agent，支持定时任务、多项目管理、企业级安全。
快速入口
| 你是谁 | 从哪里开始 |
|---|---|
| 我想快速体验 | 5 分钟快速开始 |
| 我是普通用户，想用飞书/Slack 和 AI 聊天 | 与 AI 对话 |
| 我是开发者，想通过 WebSocket 集成 | WebSocket 对接指南 |
| 我是开发者，想远程控制 Coding Agent | 远程 Coding Agent 指南 |
| 我是企业管理员，需要部署到生产环境 | 企业部署指南 |
| 我想在线测试 API 接口 | API 控制台 |
| 我想为 HotPlex 贡献代码 | 开发环境搭建 |
| 我在评估 HotPlex 是否适合我 | 为什么选择 HotPlex |
教程
手把手引导，从零开始完成一个具体目标。
| 教程 | 目标读者 | 时间 |
|---|---|---|
| 5 分钟快速开始 | 全部 | 5 min |
| Slack 集成 | 开发者 | 15 min |
| 飞书集成 | 开发者 | 15 min |
| AI 人格定制 | 开发者 | 10 min |
| Bot 话术定制 | 开发者 | 10 min |
| 定时任务 | 开发者/用户 | 10 min |
指南
目标导向，解决特定场景的问题。
普通用户
| 指南 | 说明 |
|---|---|
| 与 AI 对话 | 飞书/Slack 中使用 AI 助理的完整指南 |
| 命令速查表 | 所有聊天命令一览，可打印 |
| 移动端访问 | 通过手机使用 HotPlex AI 助理 |
| 使用技巧 | 高效使用 AI 助理的进阶技巧 |
开发者
| 指南 | 说明 |
|---|---|
| WebSocket 对接 | AEP 协议、认证、Session 管理、重连机制 |
| 远程 Coding Agent | 远程控制 AI Agent 编程的最佳实践 |
| Session 管理 | 5 状态机、/gc vs /reset、Resume 机制 |
| Context Window 管理 | /compact、/clear、B/C 通道 token 消耗 |
| WebChat 设置 | 嵌入式 Web UI 配置和使用 |
| 多 Agent 协作 | 多 Worker 类型、多项目管理 |
| Cron 自动化 | 三种调度模式、常见场景、Silent 模式 |
| 安全模型 | 7 层安全体系、权限控制、最佳实践 |
| 语音功能 | STT 语音转文字 + TTS 语音回复配置 |
企业
| 指南 | 说明 |
|---|---|
| 企业部署 | 生产环境部署、安全加固、资源管理 |
| 安全加固 | 7 层安全体系详解 |
| 可观测性 | 日志、Prometheus、OpenTelemetry、告警 |
| 多租户隔离 | Bot 级隔离、Bot ID 路由、会话配额 |
| 合规与审计 | 用户行为审计、不可变存储、跨渠道追踪、凭证管理 |
| 灾备恢复 | RTO/RPO、自动重启、备份策略 |
| 配置管理 | 5 层优先级、热重载、多环境策略 |
| 集成模式 | 反向代理、CI/CD、SDK 集成 |
| 资源限制 | 全局/用户/Worker 限制、调优建议 |
贡献者
| 指南 | 说明 |
|---|---|
| 开发环境搭建 | Go 1.26+、make quickstart、IDE 配置 |
| 架构概览 | 单进程架构、6 大核心包、数据流路径 |
| 测试指南 | testify、表驱动测试、覆盖率目标 |
| PR 工作流 | 分支命名、Conventional Commits、CI 要求 |
| 扩展 HotPlex | Worker 适配器、消息平台、AEP 事件、CLI 命令 |
| 添加 Worker 适配器 | BaseWorker 嵌入、接口实现、注册流程 |
| 添加消息适配器 | PlatformAdapter 嵌入、5 步初始化、Hub 注册 |
参考
权威、完整的技术细节。
| 参考 | 说明 |
|---|---|
| CLI 命令参考 | 全部 38 个 CLI 子命令和参数 |
| 配置参考 | 全部 14 个配置段的字段级文档 |
| Admin API 参考 | 管理端点、Scope 权限、请求/响应格式 |
| API 控制台 | 交互式 Scalar 控制台，可在线测试所有端点 |
| AEP 协议参考 | Agent Exchange Protocol v1 完整规范 |
| 事件参考 | 全部 AEP 事件类型和数据结构 |
| 安全策略参考 | API Key、Bot ID、SSRF、命令白名单、工具控制 |
| Metrics 参考 | Prometheus 指标、scrape 配置 |
| 术语表 | HotPlex 核心术语解释 |
| Go SDK 参考 | Go 客户端 SDK API 文档 |
| TypeScript SDK 参考 | TypeScript SDK API 文档 |
| Python SDK 参考 | Python SDK API 文档 |
| Java SDK 参考 | Java SDK API 文档 |
概念解释
理解设计背后的原因。
| 文档 | 说明 |
|---|---|
| 为什么选择 HotPlex | 痛点、解法、架构哲学、适用场景 |
| Session 生命周期 | 5 状态机、UUIDv5、GC 策略、背压机制 |
| Agent 配置系统 | B/C 双通道、命中即终止、热更新 |
| Brain LLM 编排 | Chat 接口、CircuitBreaker、输出脱敏 |
| Cron 调度器设计 | AI-native 调度、并发槽、投递机制 |
| Phrases 系统设计 | 加权随机话术池、cascade-append 策略 |
| 安全模型 | 7 层安全体系设计决策和权衡 |