工具系统

Qoder 提供广泛的工具来协助编程任务的各个方面，包括文件搜索、文件读取、目录浏览、语义符号检索、文件编辑、错误检查和命令执行。它还集成了模型上下文协议（MCP）服务器，允许开发者配置额外的扩展来增强他们的编码体验。

工具分类

🔍 搜索工具

在 Agent 模式下，Qoder 使用以下工具从项目、代码文件和网络内容中检索信息：

范围	描述	使用场景
代码库	用于代码库探索的代码搜索工具	查找相关函数、类、变量
文件	在项目中搜索文件	定位特定的配置或源文件
代码	在项目中搜索特定代码片段	找到实现特定功能的代码
目录	查看项目目录结构	了解项目组织和架构
网络	执行免费网络搜索，无需 API 密钥	查找技术文档和解决方案
网页内容	从网页检索内容	获取最新的技术信息

搜索工具使用示例

代码库搜索：

搜索查询："用户认证相关的函数"
AI 自动使用代码库工具找到：
- login() 函数
- authenticate() 方法
- UserAuth 类
- 相关的认证中间件

文件搜索：

任务："修改数据库配置"
AI 使用文件搜索工具找到：
- database.config.js
- .env 文件
- docker-compose.yml
- knexfile.js

✏️ 编辑工具

在 Agent 模式下，Qoder 使用以下工具修改代码文件：

功能	描述	应用场景
修改文件	修改特定代码文件	实现新功能、修复 Bug、重构代码
查看文件	显示代码文件的内容	分析现有代码、理解实现逻辑

编辑工具特点

智能修改：

• 保持代码格式和风格一致
• 自动处理导入和依赖
• 智能合并相关修改
• 避免语法错误和冲突

安全保障：

• 修改前自动备份
• 详细的变更差异显示
• 支持撤销和回滚
• 增量修改减少风险

⚡ 执行工具

在 Agent 模式下，Qoder 使用以下工具基于先前条件编写和运行命令：

功能	描述	典型用途
运行命令	在终端中执行命令	构建、测试、部署、安装依赖
获取终端输出	检索先前运行命令的输出	分析执行结果、错误诊断

命令执行特点

智能命令生成：

# AI 根据项目类型自动选择合适的命令
# Node.js 项目
npm install
npm test
npm run build

# Python 项目  
pip install -r requirements.txt
pytest
python setup.py build

安全控制：

• 命令执行前确认机制
• 危险命令警告提示
• 白名单命令自动执行
• 详细的执行日志记录

🔧 问题检测工具

在 Agent 模式下，Qoder 使用以下工具查找代码问题：

功能	描述	检测范围
获取代码问题	在项目中查找代码问题（在问题窗口中）	语法错误、类型错误、警告、建议

问题检测功能

多层次检测：

• 语法错误：编译时错误、语法不符合规范
• 类型错误：类型不匹配、未定义变量
• 代码警告：潜在问题、性能警告
• 风格问题：代码风格不一致、格式问题

智能分析：

• 优先级排序
• 影响范围分析
• 修复建议提供
• 批量修复支持

🧠 内存管理工具

在 Agent 模式下，Qoder 使用以下工具根据您的需求更新内存：

功能	描述	应用场景
更新内存	基于用户输入更新持久内存	学习偏好、记录经验、保存上下文

内存系统特点

智能学习：

• 编码风格偏好记录
• 常用模式和解决方案存储
• 项目特定的上下文保存
• 错误和解决方案的关联

持久化存储：

• 跨会话保持记忆
• 项目级别的上下文
• 用户级别的偏好
• 团队共享的知识库

🔌 MCP 工具

在 Agent 模式下，如果配置了 MCP 工具，Qoder 可以根据给定描述自主使用所需的 MCP 工具。AI 会在执行任何 MCP 相关操作之前要求确认。要跳过这些确认，您可以启用自动运行。

有关详细信息，请参阅 MCP。

工具协作机制

工具链组合

Qoder 能够智能地组合多个工具来完成复杂任务：

任务："优化数据库查询性能"

工具使用流程：
1. 代码搜索 → 找到所有数据库查询代码
2. 文件查看 → 分析现有查询实现
3. 问题检测 → 识别性能瓶颈
4. 网络搜索 → 查找优化最佳实践
5. 文件修改 → 实施优化方案
6. 命令执行 → 运行性能测试
7. 内存更新 → 记录优化经验

智能决策

AI 根据上下文自动选择最适合的工具：

情况分析：
- 如果需要了解项目结构 → 使用目录搜索
- 如果需要找特定功能 → 使用代码搜索
- 如果需要获取最新信息 → 使用网络搜索
- 如果需要执行测试 → 使用命令执行

使用最佳实践

1. 搜索策略优化

精确搜索：

好的搜索：
"JWT token 验证中间件"
"异步文件上传处理"
"Redis 缓存实现"

模糊搜索：
"认证"
"上传"
"缓存"

层次化搜索：

1. 先搜索文件找到相关模块
2. 再搜索代码找到具体实现
3. 最后搜索网络获取参考方案

2. 编辑操作优化

增量修改：

• 每次只修改相关的代码片段
• 避免大范围的代码重写
• 保持修改的原子性

版本控制：

• 修改前检查 Git 状态
• 使用有意义的提交信息
• 定期创建检查点

3. 命令执行策略

安全第一：

# 安全的命令
npm test
git status
ls -la

# 需要确认的命令
rm -rf node_modules
sudo npm install -g
docker system prune

环境管理：

• 确认当前工作目录
• 检查环境变量设置
• 验证依赖和工具版本

4. 问题检测工作流

定期检测：

• 编码过程中实时检测
• 提交前完整检查
• 部署前最终验证

优先级处理：

1. 语法错误（阻塞性）→ 立即修复
2. 类型错误（逻辑性）→ 优先处理
3. 性能警告（优化性）→ 计划处理
4. 风格问题（美观性）→ 批量处理

工具扩展和自定义

MCP 工具集成

常用 MCP 工具：

• GitHub 集成工具
• 数据库连接工具
• CI/CD 流水线工具
• 监控和日志工具

自定义 MCP 工具：

• 企业内部 API 集成
• 专有工具和服务
• 团队特定的工作流
• 自动化脚本执行

工具配置优化

性能调优：

{
  "search": {
    "maxResults": 50,
    "timeout": 5000,
    "cacheEnabled": true
  },
  "edit": {
    "autoSave": true,
    "backupEnabled": true,
    "formatOnSave": true
  },
  "execution": {
    "confirmDangerous": true,
    "logLevel": "info",
    "timeout": 30000
  }
}

安全设置：

{
  "allowedCommands": [
    "npm test",
    "git status",
    "yarn build"
  ],
  "blockedCommands": [
    "rm -rf",
    "sudo",
    "dd if="
  ],
  "requireConfirmation": true
}

工具系统是 Qoder 强大功能的基础，通过智能的工具选择和组合，让 AI 能够高效地完成各种编程任务，真正成为您的编程伙伴。