mateclaw-source-index

# MateClaw 源码导航 当用户询问"XX 功能在哪里实现"、"Agent 流程入口在哪"、"如何修改 YY 逻辑"等源码定位问题时使用本技能。 ## 工作流程 ### 第一步：查文档索引 ``` readMateClawDoc(action="list") ``` 根据用户问题关键词在文件列表中找到最相关文档。 ### 第二步：读取架构文档 ``` readMateClawDoc(action="read", path="zh/architecture.md") ``` 或直接读 CLAUDE.md（项目根目录，包含最完整的包结构说明）： ``` read_file(filePath="CLAUDE.md") ``` ### 第三步：返回定位结果 回答格式：**文件路径 : 行号范围 + 一句话说明入口作用** 示例： > `agent/graph/StateGraphReActAgent.java` — ReAct 循环图的组装入口，连接 ReasoningNode → ActionNode → ObservationNode ## 核心路径速查表 ### Agent 运行时 | 功能 | 文件路径 | |------|---------| | ReAct 图组装 | `agent/graph/StateGraphReActAgent.java` | | Plan-Execute 图组装 | `agent/graph/plan/StateGraphPlanExecuteAgent.java` | | 推理节点 | `agent/graph/node/ReasoningNode.java` | | 动作节点 | `agent/graph/node/ActionNode.java` | | 观察节点 | `agent/graph/node/ObservationNode.java` | | 最终答案节点 | `agent/graph/node/FinalAnswerNode.java` | | Agent 图构建器 | `agent/AgentGraphBuilder.java` | | 上下文注入 | `agent/context/RuntimeContextInjector.java` | | Token 估算 / 裁剪 | `agent/context/TokenEstimator.java` | ### 工具 & 审批 | 功能 | 文件路径 | |------|---------| | 工具注册中心 | `tool/ToolRegistry.java` | | MCP 适配器 | `tool/mcp/` | | 工具守卫规则 | `tool/guard/` | | 人工审批流程 | `approval/ApprovalWorkflowService.java` | | 审批 Controller | `approval/ApprovalController.java` | ### 渠道 & 对话 | 功能 | 文件路径 | |------|---------| | 渠道适配器接口 | `channel/ChannelAdapter.java` | | Web SSE 聊天 | `channel/web/ChatController.java` | | 渠道 Webhook | `channel/ChannelWebhookController.java` | | 流追踪器 | `channel/web/ChatStreamTracker.java` | ### 记忆 & Wiki | 功能 | 文件路径 | |------|---------| | 记忆生命周期协调者 | `memory/MemoryLifecycleMediator.java` | | Dream 引擎 | `memory/dream/DreamService.java` | | Dream 报告 Controller | `memory/controller/DreamController.java` | | Wiki 处理流水线 | `wiki/service/WikiProcessingService.java` | | Wiki Controller | `wiki/controller/WikiController.java` | ### 技能运行时 | 功能 | 文件路径 | |------|---------| | 技能运行时服务 | `skill/runtime/SkillRuntimeService.java` | | 技能安全扫描 | `skill/security/SkillSecurityService.java` | | 技能 Controller | `skill/controller/SkillController.java` | ### 数据库 & 配置 | 功能 | 文件路径 | |------|---------| | Flyway 迁移（H2） | `resources/db/migration/h2/` | | Flyway 迁移（MySQL） | `resources/db/migration/mysql/` | | 种子数据（中文） | `resources/db/data-mysql-zh.sql` | | 系统设置 | `system/service/SystemSettingService.java` | ## 注意 - 路径均相对于 `mateclaw-server/src/main/java/vip/mate/`（Java 文件）或 `mateclaw-server/src/main/resources/`（资源文件） - 如找不到精确文件，先用 `readMateClawDoc` 搜索，再用 `read_file` 读取 CLAUDE.md 获取最新架构描述