// 当你需要使用 Docker/Docker Compose 部署 XRK-AGT（含 Python 子服务端、Redis、MongoDB），或排查容器化环境问题时使用。
当你需要开发/调试 AIStream 工作流、RAG 上下文增强、子服务端回退逻辑、MCP 工具注册与作用域控制时使用。
当你需要从“应用视角”看 XRK-AGT（启动流程、Web 控制台、前后端协作、典型技术栈组合）时使用。
当你需要解释/排查 HTTP 或 WebSocket 的 401、127 回环例外、API Key 机制时使用；确保业务层不重复鉴权。
当你需要理解 XRK-AGT 的运行时核心（Bot 主类）、事件总线、HTTP/WS 启动流程与全局对象时使用。
当你需要复用日志/缓存/文件/网络/批处理等基础能力，或为新模块选择合适的工具函数时使用。
当你需要新增/调整配置字段、确保 YAML 与 commonconfig schema 与代码消费一致、或解释配置路径规则时使用。
| name | xrk-docker |
| description | 当你需要使用 Docker/Docker Compose 部署 XRK-AGT（含 Python 子服务端、Redis、MongoDB），或排查容器化环境问题时使用。 |
docs/docker.mddocker-compose.yml、Dockerfilesubserver/pyserver/xrk-agt（主服务）、xrk-subserver（Python 子服务）、redis、mongodb。.env 可选环境变量：XRK_SERVER_PORT、HTTP_PROXY/HTTPS_PROXY/NO_PROXY、MONGO_ROOT_USERNAME/MONGO_ROOT_PASSWORD 等。./data、./logs、./config、./resources 等，避免数据丢失。Dockerfile 使用 node:26；容器内 node -v 应 ≥ 26.0。package.json engines 与 app.js 启动校验一致；勿在文档或示例中写 Node 24 / node-fetch。NODE_COMPILE_CACHE 缩短冷启动（见 docs/node-26-runtime.md §2.2）。docker-compose ps。docker-compose logs -f xrk-agt / xrk-subserver。curl http://localhost:8080/health、http://localhost:8000/health。