# Mateclaw Source Index

> 将用户问题映射到 MateClaw 文档路径与源码入口，减少盲目搜索。回答'XX 功能在哪里实现'、'怎么修改 YY 逻辑'等源码定位问题。

- Skill: `mateaix/mateclaw-source-index` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mateaix/mateclaw-source-index`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mateaix/mateclaw-source-index/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: mateaix (https://skillmd.com/u/mateaix)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mateaix/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 获取最新架构描述