处理大型代码库
浏览和处理大型代码库的策略
处理大型代码库需要特定的策略来管理上下文限制并保持工作效率。本指南提供了实用的工作流，帮助你使用 Verdent for VS Code 高效地浏览、理解和修改大型项目。
使用 Explorer 智能体进行代码库探索
假设你刚接触一个大型代码库，需要找到特定功能的实现位置。
提出宽泛的探索性问题
Where is user authentication handled in this codebase?Verdent 会自动委派给 Explorer 智能体——一个用于代码库搜索的高 token 效率专家。
Explorer 高效搜索
Explorer 智能体会：
- 搜索文件名和路径
- 在代码内容中检索关键词
- 分析架构模式
- 返回带有文件路径和代码片段的结果
优化你的搜索
Show me all files that import the authentication moduleExplorer 可以执行后续搜索以缩小结果范围。
并行处理复杂搜索
为了进行全面探索，Verdent 可以并行运行多个 Explorer 智能体：
- Explorer 1：查找认证逻辑
- Explorer 2：查找授权逻辑
- Explorer 3：查找会话管理
通过并行搜索，结果到达得更快。
提示：
- Explorer 智能体在大型代码库中高效工作，不会占满主上下文
- 多个 Explorer 智能体可以同时搜索不同方面
- 使用 Explorer 进行模式匹配和架构探索
- 结果包含文件路径和相关代码片段以提供上下文
将任务拆分为可管理的小块
假设你正在处理一个大型代码库，需要添加一个涉及许多文件的功能。
识别自然的任务边界
与其一次性请求所有内容：
Phase 1: Add the data models for the notification system先专注于一个独立的组件。
完整完成该阶段
在进入第二阶段之前，完整地完成第一阶段，包括测试。这会创建一个干净的检查点。
提交你的进度
git add .
git commit -m "feat: add notification data models"提交会创建一个安全的回滚点。
为下一阶段清空上下文
对于复杂任务，在进入下一阶段之前清空上下文。这能确保 Verdent 有足够的上下文容量来保持最佳性能。
Phase 2: Build the notification API endpoints using the data models开启一个仅专注于第二阶段的全新会话。
提示：
- 自然的断点可以防止上下文耗尽
- 每个阶段都应能够独立测试
- 在各阶段之间提交可实现安全的实验
- 全新的会话能保持上下文干净且专注
利用 Plan Mode 进行大规模变更
假设你需要重构一个分散在大型代码库数十个文件中的功能。
从 Plan Mode 开始
Switch to Plan Mode: Refactor the payment processing logic to use a new payment provider across all filesPlan Mode 允许进行只读分析，而不会因文件修改消耗上下文。
使用 Explorer 查找所有受影响的文件
Use the Explorer agent to find all files that reference payment processing确保你发现所有需要更新的位置。
审查全面的计划
Verdent 会呈现一个计划，显示：
- 所有需要变更的文件（已识别 25 个文件）
- 需要纳入主上下文的最小文件集
- 操作顺序
- 变更之间的依赖关系
在确定方案前进行审查。
批准执行
对计划满意后，批准执行。Verdent 会有条不紊地完成这些变更。
提示：
- Plan Mode 有助于在执行前识别最小文件集
- Explorer 确保在大规模重构中不遗漏任何文件
- 计划在消耗上下文前清晰地显示范围
- 将计划保存到文件中以供文档记录和团队审查
在多个文件间进行协调一致的变更
假设你需要重命名一个在大型代码库中 50 多个文件里使用的函数。
使用 Explorer 查找所有用法
Use the Explorer agent to find all files that use the calculateTotal function识别每个需要更新的文件。
在 Plan Mode 中审查范围
In Plan Mode: Rename calculateTotal to computeFinalTotal across all files在进行变更前查看完整范围。
验证没有遗漏文件
Verdent 会显示所有 52 个需要更新的文件。审查该列表以确保完整性。
执行协调一致的变更
批准计划。Verdent 会系统地更新所有文件，确保各处的重命名保持一致。
运行测试以验证
Run the full test suite to verify all references were updated correctly测试能捕获任何遗漏的引用。
提示：
- Explorer 确保在大规模变更中不遗漏任何文件
- Plan Mode 在执行前显示完整范围
- 系统化的更新可在所有文件间保持一致性
- 大规模重构后进行全面测试
分阶段进行跨多个文件的协调变更更安全：先更新一层，验证，然后再处理依赖它的各层。
常见问题
我如何知道自己快要接近上下文限制了？
迹象包括响应时间变慢、会话已运行数小时，或加载了许多大文件。监控你的会话时长和文件数量。当你注意到性能下降时，完成当前任务，提交进度，然后用干净的上下文开启全新会话。
让 Verdent 一次性修改数十个文件安全吗？
正确使用时是安全的。始终先使用 Plan Mode 审查完整范围，确保你有全面的测试覆盖，并在各阶段之间频繁提交。这样你就可以逐步验证变更，并在需要时轻松回滚。
我应该在什么时候使用 Explorer 智能体，而不是直接加载文件？
对于探索和搜索任务，使用 Explorer 智能体可避免消耗主上下文。仅当你需要修改文件时，才使用 @ 提及直接加载文件。Explorer 非常适合"查找所有……的文件"这类问题，而 @ 提及则用于"更新这个特定文件"这类任务。
哪个模型预设最适合大型代码库工作？
对于复杂的多文件操作和重构，使用 Performance 预设。对于简单的搜索和探索任务，使用 Efficiency 预设。Performance 为协调一致的变更提供更强的推理能力，而 Efficiency 在探索时更快、更具成本效益。