内置工具一览
内置工具是 DesireCore 自带的基础能力，随客户端一起安装，无需额外配置即可使用。以下是所有内置工具的完整列表。
文件操作类
Read — 读取文件
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
读取指定路径的文件内容。支持文本文件的行号显示和分页读取，能自动检测图片文件并以视觉方式呈现。对超大文件可以指定读取范围（offset + limit）。
典型场景：查看代码文件、阅读文档、查看配置文件、预览图片。
Write — 写入文件
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 是 |
将内容写入指定路径的文件。如果目录不存在会自动创建。此操作会覆盖现有文件内容。
典型场景：创建新文件、保存生成的内容、更新配置文件。
Edit — 编辑文件
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 是 |
精确文本替换工具。通过指定要替换的原文和新文本来修改文件，比整文件覆盖更安全。支持智能匹配（如自动处理引号风格差异）。
典型场景：修改代码中的特定函数、更新配置项、修复文档中的错误。
NotebookEdit — 编辑 Jupyter Notebook
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 是 |
编辑 Jupyter Notebook（.ipynb）文件的指定单元格。支持替换、插入和删除三种模式。
典型场景：修改数据分析脚本、更新实验代码、整理 Notebook 结构。
搜索与浏览类
Glob — 搜索文件名
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
在目录中按模式搜索文件。支持 glob 通配符模式（如 **/*.ts）。优先使用高性能的 fd 工具，自动尊重 .gitignore 规则。
典型场景：查找特定类型的文件、定位项目中的配置文件、搜索测试文件。
Grep — 搜索文件内容
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
在文件中搜索匹配的文本内容。支持正则表达式和上下文行数。优先使用高性能的 ripgrep，自动尊重 .gitignore 规则。
典型场景：在代码中搜索函数调用、查找特定的错误信息、在文档中定位关键词。
Ls — 列出目录内容
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
列出指定目录下的所有文件和子目录。显示文件大小，支持递归模式。默认跳过隐藏文件。
典型场景：浏览项目结构、查看目录下的文件列表、了解项目组织方式。
命令执行类
Bash — 执行命令
| 属性 | 值 |
|---|---|
| 风险等级 | 高 |
| 需要确认 | 是 |
执行 shell 命令。支持管道、重定向等 shell 特性。跨平台支持（macOS/Linux 使用 bash，Windows 使用 Git Bash）。有超时保护和输出截断机制。
典型场景：运行构建命令、执行测试、安装依赖、查看系统状态。
命令执行是高风险操作，每次使用都需要你的确认。智能体会在确认对话框中展示要执行的完整命令，请仔细阅读后再确认。
Which — 检查命令是否可用
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
检查一个或多个命令行工具是否安装在系统中，并返回可执行文件路径。
典型场景：在执行命令前检查工具是否已安装。
网络类
WebFetch — 获取网页
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
获取网页内容并转换为 Markdown 格式。支持智能正文提取（自动去除广告和导航栏），内置 15 分钟缓存。
典型场景：查阅在线文档、获取博客文章内容、查看 API 参考。
WebSearch — 网页搜索
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
搜索互联网获取最新信息。支持域名白名单和黑名单过滤。
典型场景：查找最新技术资料、搜索问题解决方案、获取实时信息。
智能体协作类
spawn_agent — 启动子智能体
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 是 |
启动一个临时的子智能体处理特定子任务。子智能体拥有独立的上下文和工具集，适合将复杂任务分解为独立的子问题。
典型场景：并行处理多个独立子任务、将复杂问题拆分给专门的子智能体。
handoff — 转交会话
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 是 |
将当前会话转移给另一个智能体，并携带上下文摘要。当前智能体认为其他智能体更适合处理你的需求时使用。
典型场景：问题超出当前智能体的专业范围、需要另一个智能体的专门工具。
request_help — 请求协助
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 是 |
向另一个持久智能体请求专业协助。与 spawn_agent 不同，被请求的智能体有自己的记忆和专业知识——类似于"请教同事"。
典型场景：需要其他领域专家的意见、跨智能体协作完成复杂任务。
工作空间管理类
ManageWorkDirs — 管理工作目录
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 是 |
管理用户的工作目录配置。支持列出、添加、移除和设置主目录。
典型场景：切换项目工作区、添加新的项目目录。
GenerateUUID — 生成唯一标识
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
生成 UUID v4 唯一标识符，用于需要唯一 ID 的场景。
典型场景：创建新智能体、生成会话标识。
记忆与技能类
recall_conversation — 检索对话历史
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
检索对话历史中的话题记录。可以搜索特定主题，也可以按时间范围浏览。
典型场景：回顾之前讨论的方案、查找过去的决策记录、引用历史对话。
Skill — 加载技能
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
加载并执行指定的技能包。技能包包含完整的指令，智能体会严格遵循执行。
典型场景：执行预定义的工作流程、应用专业技能。
CreateSchedule — 创建调度任务
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 否 |
创建定时任务。支持延迟执行、指定时间、周期性调度等多种模式。
典型场景：设置定时提醒、创建周期性报告任务、配置自动检查。
MCP 资源类
McpListResources — 列出 MCP 资源
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
列出已连接的 MCP Server 暴露的可读资源。
McpReadResource — 读取 MCP 资源
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
读取 MCP Server 提供的指定资源内容。
McpListPrompts — 列出 MCP Prompt 模板
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
列出 MCP Server 提供的 prompt 模板。
McpGetPrompt — 获取 MCP Prompt
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
获取并展开 MCP Server 的指定 prompt 模板。