功能手册
AI 客户端通过 MCP 工具操作你的工作区。全部工具在客户端里自动列出(含参数说明),本文是能力总览。
核心工具
| 工具 | 能力 |
|---|---|
read | 单文件/多文件读取(带版本校验)、目录列表 |
edit | 行级安全编辑(Safe Edit)、多文件补丁 |
write | 创建/覆盖整文件 |
bash | 一次性命令与长任务:输出分页、stdin、取消、等待 |
文件与搜索
| 工具 | 能力 |
|---|---|
move_file | 移动/重命名文件与目录,经 LSP 自动更新代码引用 |
read_image | 读取图片元数据或图像内容 |
batch_file_tools | 并发执行多个只读工具 |
find_files | glob 模式查文件 |
search_files | ripgrep 全文搜索(安装包已附带 rg) |
read_link | 抓取任意 URL 返回原始 HTML 与元数据 |
语言智能(LSP)
诊断与符号工具通过语言服务器工作,按扩展名自动路由、懒启动:
| 工具 | 能力 |
|---|---|
get_diagnostics_code | 文件诊断(错误/警告) |
search_symbols_code | 工作区符号搜索 |
get_symbol_definition_code | hover 定义信息 |
get_document_symbols_code | 文件大纲 |
在配置中为语言注册语言服务器即可启用,例如:
json
"lsp": {
"servers": {
"typescript": { "command": "typescript-language-server", "args": ["--stdio"], "extensions": [".ts", ".tsx"] },
"python": { "command": "pyright-langserver", "args": ["--stdio"], "extensions": [".py"] },
"go": { "command": "gopls", "args": [], "extensions": [".go"] }
}
}未配置的语言返回空结果,不会报错。
项目记忆
memory 工具组为每个工作空间维护独立的项目记忆:
memory_context:任务开始时读取历史经验(此前做过什么、踩过什么坑);memory_record_summary:任务结束后显式记录值得复用的总结。
记忆按工作空间 UUID 隔离,保存在本机;面板可逐条查看、删除或整段清空。是否启用由你在面板控制。
Skills 与 Agents
工作区(或资源目录)下的 skills/*/SKILL.md 与 agents/*.md 会自动热注册为同名 prompt,改动即时生效——把团队的工程规范、部署流程写成 markdown,AI 就能按规程工作。
Safe Edit 引擎
edit 的行级模式不是简单字符串替换,而是一条防护流水线:
- 快照当前文件;
- 应用修改;
- 风险分析(大段删除、括号失衡、重复声明——达到阈值直接拒绝并回滚);
- 语法校验(TS/JS 经 esbuild,Vue SFC 内置解析);
- 失败自动回滚,并返回结构化报告(新增/删除行、各校验器结果)。
工具分组开关
面板「工具开关」可按分组(core / file / shell / diagnostics / symbol / search)启停工具,写配置即时热更新,不需要重启。
环境诊断
命令行执行 aeasymcp doctor 输出环境体检:配置文件实际位置、端口占用、ripgrep 可用性、语言服务器注册等——排查问题第一步。
监控与日志
面板提供:调用日志与统计(每个工具的成败/耗时)、资源状态、错误详情;日志文件位于数据目录 logs/ 下。