工具总览
AggRoot 通过插件系统提供丰富的内置工具。每个插件聚焦一个领域,工具按风险等级分为三级:
| 风险等级 | 说明 | 行为 |
|---|---|---|
| safe | 只读操作 | 无需确认 |
| medium | 有副作用的写操作 | 需要确认 |
| dangerous | 高风险操作 | 强制确认 |
完整工具表
| 工具 | 所属插件 | 说明 | 风险等级 |
|---|---|---|---|
| Read | @aggroot/core-code-tools | 读取文件,支持分页、大纲、搜索、图片分析 | safe |
| Write | @aggroot/core-code-tools | 创建或覆盖文件 | medium |
| Edit | @aggroot/core-code-tools | 精确文本替换,diff 级编辑 | medium |
| Glob | @aggroot/core-code-tools | 按文件名/路径模式搜索文件 | safe |
| Grep | @aggroot/core-code-tools | 按内容搜索文件(ripgrep 后端) | safe |
| AnalyzeImage | @aggroot/core-code-tools | 使用视觉模型分析图片内容 | safe |
| AskUser | @aggroot/core-code-tools | 向用户提问并获取回复 | safe |
| DirectoryTree | @aggroot/core-code-tools | 快速扫描目录结构 | safe |
| EnterPlanMode | @aggroot/core-code-tools | 进入规划模式(只读探索) | safe |
| ExitPlanMode | @aggroot/core-code-tools | 退出规划模式并提交方案 | medium |
| CodeExecute | @aggroot/code-tools | 执行 JavaScript 代码 | dangerous |
| CodeValidate | @aggroot/code-tools | TypeScript 类型检查(tsc --noEmit) | safe |
| CodeFormat | @aggroot/code-tools | 格式化代码 | safe |
| CodeAnalyze | @aggroot/code-tools | 深度代码分析(符号、复杂度、ESLint) | safe |
| CodeRefactor | @aggroot/code-tools | 代码重构(提取函数、重命名、整理导入) | medium |
| CodeIndex | @aggroot/code-tools | 索引项目目录 | safe |
| CodeStats | @aggroot/code-tools | 查看代码索引统计 | safe |
| CodeDependencies | @aggroot/code-tools | 分析文件依赖关系和影响范围 | safe |
| GitStatus | @aggroot/git-tools | 查看工作区状态 | safe |
| GitDiff | @aggroot/git-tools | 查看代码差异 | safe |
| GitLog | @aggroot/git-tools | 查看提交历史 | safe |
| GitBranch | @aggroot/git-tools | 列出、创建、删除分支 | medium |
| GitCheckout | @aggroot/git-tools | 切换分支或恢复文件 | medium |
| GitShow | @aggroot/git-tools | 查看提交详情 | safe |
| GitAdd | @aggroot/git-tools | 添加文件到暂存区 | medium |
| GitCommit | @aggroot/git-tools | 提交更改 | dangerous |
| GitPush | @aggroot/git-tools | 推送到远程仓库 | dangerous |
| GitPull | @aggroot/git-tools | 拉取远程代码 | medium |
| GitRemote | @aggroot/git-tools | 管理远程仓库 | medium |
| GitStash | @aggroot/git-tools | 暂存/恢复更改 | medium |
| GitRepoFetch | @aggroot/git-tools | 获取远程仓库概览/目录/文件 | safe |
| Shell | @aggroot/shell-tools | 执行 Shell 命令 | dangerous |
| WebSearch | @aggroot/web-tools | 搜索网页(Bing,Playwright 后端) | safe |
| WebFetch | @aggroot/web-tools | 获取网页内容(多 URL 自动重试) | safe |
| HttpRequest | @aggroot/web-tools | 发送 HTTP 请求 | medium |
| ImageSearch | @aggroot/web-tools | 搜索图片 | safe |
| FileDownload | @aggroot/web-tools | 从 URL 下载文件 | medium |
| TodoWrite | @aggroot/todo-tools | 创建和管理任务列表 | safe |
| TodoRead | @aggroot/todo-tools | 查看任务列表和进度 | safe |
| Skill | @aggroot/skill-tools | 调用技能(可复用提示词模板) | safe |
| ListSkills | @aggroot/skill-tools | 列出所有可用技能 | safe |
| MCP (动态) | @aggroot/mcp-tools | 自动发现并注册 MCP 服务器工具 | 取决于工具 |
| ListMcpResources | @aggroot/mcp-tools | 列出 MCP 服务器资源 | safe |
| ReadMcpResource | @aggroot/mcp-tools | 读取 MCP 服务器资源 | safe |
| SiteRecon | @aggroot/risk-control-tools | 站点侦察(HTTP头/SSL/DNS/WHOIS/技术栈) | safe |
| ContentAnalysis | @aggroot/risk-control-tools | 内容分析(隐藏iframe/可疑脚本/外部资源) | safe |
| RedirectTracker | @aggroot/risk-control-tools | 跳转追踪(HTTP重定向/JS跳转/Meta刷新) | safe |
| PaymentFlowAnalysis | @aggroot/risk-control-tools | 支付流程分析 | safe |
| SecurityScan | @aggroot/risk-control-tools | 安全扫描(敏感路径/CMS漏洞/CSRF) | medium |
| FraudIndicatorCheck | @aggroot/risk-control-tools | 欺诈指标检查 | safe |
| SimulatedPurchase | @aggroot/risk-control-tools | 模拟购买流程 | medium |
| DomainWhois | @aggroot/risk-control-tools | 域名注册信息查询 | safe |
| DomainReputation | @aggroot/risk-control-tools | 域名信誉检查 | safe |
| ZapScan | @aggroot/risk-control-tools | OWASP ZAP 安全扫描 | medium |
| PhishingDetect | @aggroot/risk-control-tools | 钓鱼网站检测 | safe |
| DeviceFingerprint | @aggroot/risk-control-tools | 设备指纹检测 | safe |
| PaymentRisk | @aggroot/risk-control-tools | 支付风控增强 | safe |
| ContentSecurity | @aggroot/risk-control-tools | 内容安全增强 | safe |
| StockQuote | @aggroot/stock-tools | 股票实时行情查询 | safe |
| StockFinancial | @aggroot/stock-tools | 财务数据查询 | safe |
| StockNews | @aggroot/stock-tools | 股票新闻资讯 | safe |
| MarketOverview | @aggroot/stock-tools | 市场概览 | safe |
| StockTechnical | @aggroot/stock-tools | 技术指标分析 | safe |
| StockCompare | @aggroot/stock-tools | 股票对比分析 | safe |
工具选择原则
- 优先使用专用工具:Read >
cat,Edit >sed,Glob >find,Grep >grep - 优先使用 Git 工具:GitStatus >
git status,GitCommit >git commit - Shell 仅作为兜底:只有在专用工具无法满足时才使用 Shell
- 风控工具成套使用:SiteRecon → ContentAnalysis → SecurityScan 形成完整分析链
- WebSearch + WebFetch 搭配:搜索后用 Fetch 获取详细内容