XRK-AGT

当你需要从“应用视角”看 XRK-AGT（启动流程、Web 控制台、前后端协作、典型技术栈组合）时使用。

当你需要开发或排查 HTTP API（core/*/http/*.js）、理解 HttpApi 基类、HttpApiLoader、业务层约定时使用。

编写或审查 core/*/www 静态页、校园 WebView 兼容、HttpResponse 前端解包时使用。浏览器环境 ≠ Node 26。

编写或审查 core/src 代码时的写法与性能规范（全局裸名、状态、I/O、异步、HTTP）。改 Core 前必读。

当你需要快速理解 system-Core 提供哪些 HTTP API/工作流/插件/Tasker/Web 控制台能力，或定位某个模块在哪实现时使用。

当需要从整体理解 XRK-AGT 的架构、目录、运行流程和技术栈时使用。

当你需要理解 XRK-AGT 的运行时核心（AgentRuntime 主类）、事件总线、HTTP/WS 启动流程与全局对象时使用。

当你需要开发/调试 AiWorkflow 工作流、RAG 上下文增强、MCP 工具注册与作用域控制时使用。

当你需要解释/排查 HTTP 或 WebSocket 的 401、127 回环例外、API Key 机制时使用；确保业务层不重复鉴权。

当你需要新增/调整配置字段、确保 YAML 与 commonconfig schema 与代码消费一致、或解释配置路径规则时使用。

当你需要开发/排查 HTTP 抓取、SSRF、Playwright 受控浏览器、本地字体增强截图，或判断 web_fetch 与 browser 工作流如何选型时使用。

需要快速定位「该看哪份文档/哪段代码/哪份配置」时使用；提供文档导航与权威路径。

当需要理解或扩展基础设施层（加载器、基类、路径、错误处理）等底层开发时使用。

当你需要配置/新增/排查 LLM 提供商（OpenAI/Azure/Gemini/Anthropic/Ollama/各类兼容网关）时使用；确保 YAML/Schema/代码一致。

当你需要理解或扩展 MCP 工具（Model Context Protocol）、工具注册/分组/远程 MCP 连接与 LLM tool calling 的关系时使用。

当你需要理解/开发插件（plugin 基类）、插件加载与规则匹配、上下文和冷却机制时使用。

当你需要理解或修改 Python 子服务端（FastAPI 扩展框架），以及它与主服务端的 HTTP 衔接时使用。

当你需要对接/调试 `/api/v3/chat/completions` 与 SSE 流式输出、multipart 多模态上传、workflow 工具白名单时使用。

当你需要理解 XRK-AGT 的运行时核心（AgentRuntime 主类）、事件总线、HTTP/WS 启动流程与全局对象时使用。

需要快速定位「该看哪份文档/哪段代码/哪份配置」时使用；提供文档导航与权威路径。

当你需要理解/开发插件（plugin 基类）、插件加载与规则匹配、上下文和冷却机制时使用。

受控浏览器：ARIA ref、多标签、弹窗、batch act、路由级 SSRF

检索栈：web_search（13 提供商 + parallel-free 免费通道）、web_fetch、与 office-research 分工

MCP 工具地图：默认工作流、web_search、何时启用 desktop/browser/memory

环境探测、缺依赖降级、能力档位 A–E；run/pip/desktop/web 不可用时的办事路径

在工作区执行命令 run；Python/脚本、pip、格式转换；缺环境降级见 office-env-setup

当需要理解或扩展基础设施层（加载器、基类、路径、错误处理）等底层开发时使用。

编写或审查 core/src 代码时，确保使用 Node 26 稳定 API，禁止旧写法（fetch/exec/错误/二进制）。AI 改 Core 前必读。

当需要从整体理解 XRK-AGT 的架构、目录、运行流程和技术栈时使用。

当你需要复用日志/缓存/文件/网络/批处理等基础能力，或为新模块选择合适的工具函数时使用。

编写或审查 core/src 代码时，确保使用 Node 26 稳定 API，禁止旧写法（fetch/exec/错误/二进制）。AI 改 Core 前必读。

子服插件开发；配置全在主服 CommonConfig，子服只读 data/；AgentRuntime.callSubserver 用 runtimeConfig.subserver。

当你需要使用 Docker/Docker Compose 部署 XRK-AGT（含 Python 子服务端、Redis），或排查容器化环境问题时使用。

当你需要使用 Docker/Docker Compose 部署 XRK-AGT（含 Python 子服务端、Redis），或排查容器化环境问题时使用。

在 GitHub 搜索成熟开源实现、对比方案、读 issue/PR 时使用。架构选型、unfamiliar 领域、找业界最佳实践时主动调用。

当你需要使用/扩展渲染器（HTML 模板渲染、截图输出）或让 AI 生成图片报表/可视化时使用。

网页抓取 web_fetch、受控 browser；SSRF；失败降级

Agent 总控：先结论后步骤、技能路由、缺环境降级、安全确认

工作区 Markdown 记忆 + memory 工作流向量记忆的使用边界

统一回复版式：短、结构化、可复制；减少空话