Roo Code 3.10 版本解析：分块读取大文件、建议回复与 Gemini 2.5 Pro 支持全指南

Roo Code 3.10 版本解析分块读取大文件、建议回复与 Gemini 2.5 Pro 支持全指南【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code导读Roo Code 3.102025-03-25 发布是围绕上下文管理与交互体验的一次重要迭代它引入了大文件分块读取partial file reads、提问建议回复suggested responses、服务端 提及查找、动态指令获取、Gemini 2.5 Pro 模型支持等核心能力并同步修复了大量稳定性问题。本文将基于官方发布说明结合仓库源码与配置实现逐项拆解 3.10 的每个特性它们解决什么问题、底层如何实现、参数如何配置帮助你在升级后立刻用上这些能力并理解其工作原理。一、增强的上下文管理大文件分块读取1.1 特性背景在 3.10 之前读取超大文件往往会一次性占用大量上下文窗口导致 Token 消耗激增甚至超出模型上限。3.10 起 Roo Code 支持按块chunk读取大文件让处理超大文件成为可能并让模型能够以更精确的行范围读取所需内容。1.2 源码级实现两种读取模式从 ReadFileTool 实现 可以看到当前read_file工具支持两种读取模式Slice 模式默认通过offsetlimit读取连续行区间。offset为 1 起始的行号内部会转换为 0 起始后交给readWithSlice处理见 ReadFileTool.ts 中的模式分发逻辑Indentation 模式基于缩进层级提取语义代码块通过anchor_line、max_levels、include_siblings、include_header、max_lines等参数控制提取范围见 IndentationReader 相关实现。默认行数上限DEFAULT_LINE_LIMIT 2000定义在 read_file 工具参数定义。当内容被截断时工具会在返回内容顶部输出明确提示IMPORTANT: File content truncated. Status: Showing lines 1-2000 of 54321 total lines. To read more: Use the read_file tool with offset2001 and limit2000.这种提示 下一块偏移量的设计让模型可以像翻页一样连续读取文件的后续部分而无需一次性载入全文。1.3 兼容性与修复3.10 同步修复了分块读取的行号问题thanks samhvw8确保偏移量计算准确分块读取被设计为与自定义系统提示词向后兼容不会因覆盖 system prompt 而失效3.10 还修复了读取和 提及二进制文件如 PDF时的 bug。现在二进制文件会走 handleBinaryFile 分支图片类格式经processImageFile转为 data URL 交给视觉模型PDF/DOCX 等格式则通过 extract-text 模块 提取文本并自动加行号。二、建议回复Suggested Responses更快地回答 Roo 的提问2.1 特性背景当 Roo 需要澄清信息时会调用ask_followup_question工具提问。3.10 让 Roo 在提问时同时提供建议回复用户点击按钮即可完成回答无需手动输入显著加快人机协作节奏。2.2 工作机制与交互方式完整交互流程记录在 建议回复功能文档问题出现Roo 通过ask_followup_question工具提出问题建议展示Roo 提供的建议以按钮形式显示在问题下方三种交互方式直接选择点击按钮选中内容立即作为回答发送给 Roo键盘快捷键使用roo.acceptInput命令需自行配置快捷键自动选中第一个主建议先编辑再发送按住Shift点击按钮或悬停后点击铅笔图标把建议文本复制到输入框修改后回车发送。2.3 源码级参数契约从 ask_followup_question 工具定义 可以看到建议回复的完整 JSON Schemaquestion必填清晰、具体的问题文本follow_up必填2-4 条建议答案每条必须包含text必填完整、可执行、不含占位符的答案mode可选选中该建议后要切换到的模式如code、architect可为null。官方示例{ question: What is the path to the frontend-config.json file?, follow_up: [ { text: ./src/frontend-config.json, mode: null }, { text: ./config/frontend-config.json, mode: null }, { text: ./frontend-config.json, mode: null } ] }带模式切换的示例{ question: Would you like me to implement this feature?, follow_up: [ { text: Yes, implement it now, mode: code }, { text: No, just plan it out, mode: architect } ] }注意 Schema 约束为minItems: 1、maxItems: 4且每个建议的text必须完整自洽——这保证了点击按钮后无需补充即可直接作为回答。2.4 对非流式模型的兼容3.10 修复了非流式模型不显示问题与建议以及建议难以阅读的问题保证该能力在各类模型下均可正常展示。三、更一致的 提及与更清爽的代码操作3.1 服务端 提及查找3.10 重设计了文件和文件夹的 提及查找逻辑改为服务端处理并支持gitignore规则详见 3.10.0 发布说明带来两点提升一致性不同平台、不同界面下 提及的匹配结果保持一致准确性遵循 gitignore 忽略规则后提及结果不再包含被忽略的构建产物或依赖目录。同时修复了Windows 下的上下文提及问题以及打开标签页open tabs在上下文提及建议中的支持。3.2 代码操作Code Actions整合为子菜单此前分散在编辑器右键菜单中的代码操作项3.10 起统一归入一个子菜单界面更清爽thanks samhvw8。四、Provider 与 API 增强4.1 Gemini 2.5 Pro 加入 Google Gemini Provider3.10 在 Gemini Provider 中新增了Gemini 2.5 Pro模型thanks samsilveira并随后修正了gemini-2.5-pro-03-25的 max tokens 取值thanks linegel。从仓库证据看Gemini 2.5 Pro 已被视为混合/预算推理模型hybrid/budget reasoning model在 gemini.ts Provider 实现 中对其尊重用户配置的推理预算在 OpenRouter Provider 中也有google/gemini-2.5-pro的专门处理相关测试覆盖了该模型的参数与识别逻辑见 lite-llm 测试。你可以在 Gemini Provider 设置中选择该模型并按需配置推理预算。4.2 动态获取指令Dynamically Fetched Instructions创建/编辑自定义模式custom modes和MCP 服务器时的指令说明3.10 起改为动态获取thanks diarmidmackenzie保证指令内容始终与当前版本能力一致不再依赖硬编码的静态文案。4.3 OpenRouter 集成改进Token 用量追踪改用更直接的方式追踪 OpenRouter 的 token 用量与花费计费数据更准确定价修正修复了 OpenRouter 免费模型的定价信息thanks Jdo300错误提示优化更好地展示 OpenRouter overloaded过载错误信息相关逻辑可参考 OpenRouter 模型端点获取与测试。4.4 更多 Provider 相关更新OpenAI Compatible Provider 新增 R1 支持开关为 QWQ 类模型增加 R1 支持复选框thanks teddyOOXXBedrock 应用推理配置新增application-inference-profile支持thanks maekawataikiOutbound Provider修复了 maxTokens 问题thanks pugazhendhi-mSonnet 3.7 非思考模型修正了最大输出 token 数OpenAI 模型supportsPromptCache修正了取值thanks PeterDaveHellomaxTokens 上限更新了gemini-2.5-pro-03-25的取值thanks linegel跨区域推理在 ap-xx 区域反映跨区域推理选项thanks Yoshino-Yukitaro。4.5 API 新增taskCreated事件3.10 在 API 中新增了taskCreated事件thanks wkordalski开发者可以监听任务创建时机用于日志、统计或联动逻辑。仓库测试中已有对该事件的引用见 single-open-invariant 测试。五、QOL 体验改进欢迎页升级提供针对 LLM 路由器的1 键 OAuth 登录流thanks dtrugman配置第三方路由服务更快捷New Task 命令命令面板Command Palette新增New Task命令thanks qdaxb可以快速开启新任务聊天输入框 UX更新聊天文本区域的交互体验thanks chadgauth自定义任务存储路径支持为任务配置自定义存储路径thanks Chenjiayuan195MCP 基础设施新增watchPaths选项用于文件变更检测thanks 01Rian重命名并迁移了全局 MCP 与 modes 配置文件thanks StevenTCramer支持从 MCP 调用中读取图片响应thanks nevermorec。六、Bug 修复清单3.10 修复了大量影响日常使用的问题类别修复内容MCP修复 MCP 错误日志记录thanks aheizi搜索改进search_files工具的格式化与逻辑thanks KJ7LNW历史记录修复 WSL 下任务历史丢失的问题流式输出修复非流式模型不显示问题/建议、建议难以阅读的问题设置面板修复设置下拉菜单的不透明度thanks KJ7LNW二进制文件修复读取与提及 PDF 等二进制文件的 bugOpenRouter修复免费模型定价信息thanks Jdo300测试修复 Windows 下的单元测试问题thanks diarmidmackenzieProvider修复 Outbound Provider 的 maxTokens 问题thanks pugazhendhi-m分块读取修复分块读取的行号问题thanks samhvw8提及修复 Windows 下上下文提及、打开标签页提及问题本地化修复德语翻译thanks cannuri、遥测横幅国际化、数字格式后缀国际化thanks feifei325完成事件修复任务完成事件的触发逻辑输出 token修正 Sonnet 3.7 非思考模型的最大输出 token发布修复 GitHub Releases 中 changelog 格式thanks pdecat七、杂项改进与工程化测试基础设施新增用于集成测试的fake providerthanks franekp让集成测试不依赖真实 API系统提示兼容建议回复被设计为可选项避免与用户覆盖的 system prompt 冲突3.10.1 补丁也专门针对这一点加固见 3.10.1 发布说明多块 diff 实验对实验性的 multi-block diff 做了一系列修复与改进thanks KJ7LNW系统提示预览修复浏览器工具在系统提示预览中的可见性thanks cannuri文档修复 README 指向文档的链接thanks kvokka依赖安全对依赖库执行了npm audit fix设置项建议回复提供开关便于关闭后完全沿用自定义提示词。八、升级与验证建议升级后先验证分块读取找一个大型文件让 Roo 读取观察返回内容顶部的IMPORTANT: File content truncated提示与offset续读建议确认行号连续、无跳行体验建议回复让 Roo 提出澄清问题测试直接点击roo.acceptInput快捷键Shift点击后编辑三种交互方式并确认自定义 system prompt 场景下开关可正常关闭该特性切换到 Gemini 2.5 Pro在 Gemini Provider 中选择gemini-2.5-pro按需设置推理预算通过 openrouter.ts 的模型处理逻辑 可看到该模型在路由器下的路由偏好同样被识别使用taskCreated事件API 消费者可监听该事件在任务创建瞬间执行自定义逻辑参考 single-open-invariant 测试 中对该事件的用法。结语Roo Code 3.10 的核心价值在于在不牺牲上下文质量的前提下让大文件、澄清提问与多 Provider 协作变得更高效。分块读取解决了上下文窗口的物理瓶颈建议回复缩短了人机问答的往返成本Gemini 2.5 Pro 与 OpenRouter 的增强则拓展了模型选择与计费精度。配合大量稳定性修复3.10 是一个适合放心升级、并在日常工作中充分使用新能力的里程碑版本。【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考