xrk-subserver 是 XRK-AGT 体系中的一个子服务端说明型技能，聚焦 “Node 主服务 + Python 子服务” 的双端架构，帮助使用者理解并修改 Python 子服务端（LangChain/LangGraph + 向量服务），以及它与主服务 v3/AIStream 的衔接关系。
用途与定位 该技能用于解释和定位 XRK-AGT 子服务端、向量服务与 Agent 编排相关实现，不替代其他子系统的实现说明。适用场景包括：需要定位该子系统的实现路径与配置入口，或需要快速给出改动落点与兼容性注意事项。
主要能力与权威入口 技能给出以下权威入口：文档位于 docs/subserver-api.md；子服务端根目录为 subserver/pyserver/；默认配置位于 subserver/pyserver/config/default_config.yaml。项目概览见 PROJECT_OVERVIEW.md，代码入口对应 src/ 与 core/ 下的相关子目录，相关主题文档位于 docs/ 下。
核心职责 子服务端提供向量服务接口：/api/vector/embed|search|upsert；提供 LangChain/LangGraph Agent 接口：/api/langchain/chat，该接口内部再调用主服务的 /api/v3/chat/completions。子服务端与主服务通过 HTTP 通信，主服务通过 aistream.subserver 配置 host/port/timeout。
常见问题的回答方向 对于 “RAG 是在哪里做的”，应解释 AIStream 调用子服务端向量接口并结合 memory/database 工具工作流；对于 “多步工具链 Agent 在哪一侧”，应说明 LangChain Agent 在 Python 子服务实现，Node 侧只提供统一 LLM/MCP 入口。
使用方式与执行步骤 先确认需求属于该技能的职责边界，再给出代码路径、配置路径与关键字段，最后补充风险点、验证步骤与回归范围。
限制与常见陷阱 不在缺少证据时臆造路径或字段；文档与代码冲突时应标注以代码为准；避免只给概念而不给具体文件路径；注意配置、Schema 与消费代码的一致性。