| name | xrk-config |
| description | 当你需要新增/调整配置字段、确保 YAML 与 commonconfig schema 与代码消费一致、或解释配置路径规则时使用。 |
docs/config-base.md、core/system-Core/commonconfig/*.js、src/infrastructure/config/config-constants.js
| 类型 | 路径 | 示例 |
|---|---|---|
| 全局 | data/server_bots/<name>.yaml | agt、redis、mongodb |
| 随端口 | data/server_bots/{port}/<name>.yaml | server、aistream、chatbot |
| 工厂 LLM | data/server_bots/{port}/<name>.yaml | openai_llm、*_compat_llm |
| 模板 | config/default_config/<name>.yaml | 缺失时自动复制 |
config/default_config/<name>.yamlcommonconfig/<name>.js 或 system.js 内 schema.gitignore 白名单（若新增 commonconfig 文件）aistream.yaml：embedding、mcp、agentWorkspace、tools 等见 docs/aistream.md。
xrk-node-runtime（fetch/exec/判错/二进制）。node-fetch、promisify(exec)。当你需要开发/调试 AIStream 工作流、RAG 上下文增强、子服务端回退逻辑、MCP 工具注册与作用域控制时使用。
当你需要从“应用视角”看 XRK-AGT（启动流程、Web 控制台、前后端协作、典型技术栈组合）时使用。
当你需要解释/排查 HTTP 或 WebSocket 的 401、127 回环例外、API Key 机制时使用；确保业务层不重复鉴权。
当你需要理解 XRK-AGT 的运行时核心（Bot 主类）、事件总线、HTTP/WS 启动流程与全局对象时使用。
当你需要复用日志/缓存/文件/网络/批处理等基础能力，或为新模块选择合适的工具函数时使用。
当你需要开发/排查 HTTP 抓取、SSRF、Playwright 受控浏览器、本地字体增强截图，或判断 web_fetch 与 browser 工作流如何选型时使用。