Roo Code 3.1.6 版本解析Mistral 供应商接入与 VSCode Language Models 配置保存修复【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-CodeRoo Code 3.1.6 是一个聚焦于接入新模型生态 修复配置可靠性的补丁版本一方面为编辑器内 AI Agent 引入了 Mistral 官方 API 供应商支持让codestral-latest、mistral-large-latest等模型可以直接作为 Roo Code 的推理后端使用另一方面修复了 VSCode Language ModelsCopilot配置 Profile 无法正确保存的问题。读完本文你将理解 Mistral Provider 在 Roo Code 中的完整实现链路模型注册、消息转换、流式工具调用掌握 VSCode LM 模型选择器的保存机制以及如何正确配置与验证这两项能力。一、版本定位一次补丁版本的增能与排雷3.1.6 发布说明见 v3.1.6.md将本次更新归纳为两条核心变更新增 Mistral 供应商支持致谢 Cline 项目修复 VSCode Language ModelsCopilot配置 Profile 保存 bug致谢 samhvw8虽然条目不多但两项变更分别触及 Roo Code 体系的两个关键层面Provider 抽象层模型接入能力与配置持久化层用户 Profile 可靠性。下文将逐一深入源码进行拆解。二、Mistral Provider从模型注册到流式工具调用的完整链路2.1 供应商在架构中的位置Roo Code 的 API 供应商通过src/api/providers/目录下的BaseProvider子类实现统一抽象每个供应商都实现createMessage流式对话、completePrompt单次补全、getModel模型元信息等核心接口。3.1.6 新增的 mistral.ts 中的MistralHandler正是遵循这一抽象加入的同时它实现了SingleCompletionHandler接口用于标题生成等轻量补全场景。从 ProfileValidator.ts 可以看到mistral与anthropic、openai-native、bedrock、vertex等供应商一样被纳入组织级模型白名单校验体系其模型 ID 取自profile.apiModelId。这意味着 Mistral 供应商一接入即具备完整的配置校验与组织治理能力。2.2 支持的模型清单与关键参数模型注册表位于 packages/types/src/providers/mistral.ts共收录 9 个 Mistral 系列模型全部为maxTokens: 8192、supportsPromptCache: false模型 ID上下文窗口输入价格$ / 1M tokens输出价格$ / 1M tokens支持图片codestral-latest默认256,0000.30.9否magistral-medium-latest128,0002.05.0是devstral-medium-latest131,0000.42.0是mistral-medium-latest131,0000.42.0是mistral-large-latest131,0002.06.0否ministral-8b-latest131,0000.10.1否ministral-3b-latest131,0000.040.04否mistral-small-latest32,0000.20.6否pixtral-large-latest131,0002.06.0是值得注意的设计细节默认模型是codestral-latestmistralDefaultModelId对应 Mistral 面向代码生成的 Codestral 系列256K 上下文价格显著低于 large 系列。默认温度常量为MISTRAL_DEFAULT_TEMPERATURE 1用户可通过modelTemperature配置覆盖见 mistral.ts。模型元信息价格、上下文直接进入 Roo Code 的 token 计数与成本统计体系。2.3 双端点设计通用 API 与 Codestral 专用端点MistralHandler的构造函数包含一个关键分支逻辑见 mistral.tsthis.client new Mistral({ serverURL: apiModelId.startsWith(codestral-) ? this.options.mistralCodestralUrl || https://codestral.mistral.ai : https://api.mistral.ai, apiKey: this.options.mistralApiKey, })即当所选模型 ID 以codestral-开头时SDK 客户端自动指向https://codestral.mistral.aiCodestral 专用推理端点可通过mistralCodestralUrl自定义其余模型走https://api.mistral.ai标准端点。对应的测试用例should use custom base URL if provided验证了自定义 URL 的兼容性见 mistral.spec.ts。同时构造函数强制要求 API Key 存在缺失时抛出Mistral API key is required——这一点与仓库中其他需要密钥的供应商行为一致。2.4 消息转换层Anthropic 格式到 Mistral 格式Roo Code 内部统一使用 Anthropic 风格消息结构因此 mistral-format.ts 的convertToMistralMessages负责把text、image、tool_use、tool_result等 content block 翻译为 Mistral 的system/user/assistant/tool四种消息角色。两个实现要点1工具调用 ID 规范化normalizeMistralToolCallIdMistral 对工具调用 ID 有严格约束仅允许字母数字、长度恰好为 9 位。而 Anthropic 生态的 ID 形如toolu_xxx长度和字符集都不符合。该函数通过提取字母数字 → 截断或补零至 9 位实现确定性归一化const alphanumeric id.replace(/[^a-zA-Z0-9]/g, ) if (alphanumeric.length 9) { return alphanumeric.slice(0, 9) } return alphanumeric.padEnd(9, 0)这保证了同一 ID 在多次转换时结果稳定避免多轮工具对话中 ID 漂移。2严格的角色交替顺序Mistral 要求消息顺序为user → assistant → tool → assistant不允许在 tool 消息之后插入 user 消息。因此转换器在遇到带tool_result的用户消息时主动丢弃同批的普通用户文本内容只发送 tool 消息源码注释明确说明了这一限制。图片则转换为data:...;base64,...形式的image_url内容块。2.5 流式处理thinking 块、工具调用与用量统计MistralHandler.createMessage基于 Mistral SDK 的chat.stream异步迭代器实现见 mistral.ts逐事件消费并转译为 Roo Code 的ApiStream事件文本块delta.content为字符串时直接产出text块思考过程delta.content为数组时识别type: thinking的ThinkChunk将其内部文本产出为reasoning块从而把 Mistral 模型的思考过程透传到 Roo Code 的 UI 展示工具调用从delta.toolCalls读取流式工具调用片段按索引产出tool_call_partial块与 OpenAI 兼容格式一致由上层聚合成完整工具调用用量统计每个事件携带usage时产出inputTokens/outputTokens。请求侧还有一个值得注意的强制行为requestOptions.toolChoice any见 mistral.ts即始终要求模型执行工具调用。测试用例should always set toolChoice to any when tools are provided甚至验证了即使元数据中传入tool_choice: auto也会被覆盖为any。这是为了确保 Roo Code 的 Agent 工作流先调用工具、再生成结果不会因为模型跳过工具直接回答而中断。工具定义本身通过convertToolsForMistral从 OpenAI 格式转换仅保留function类型工具参数缺失时回退为空对象。2.6 测试覆盖印证src/api/providers/tests/mistral.spec.ts 对上述行为提供了完整验证覆盖构造函数初始化、缺失 API Key 报错、自定义 URLgetModel返回正确模型信息supportsPromptCache为 false流式文本、thinking→reasoning 块转换、混合内容数组的次序保持流式工具调用的单发与多发含tool_call_partial的 index/id/name/arguments 断言toolChoice恒为anycompletePrompt非流式补全以及从结果中过滤 thinking 内容、仅拼接 text 内容的行为。这些用例使得新增供应商的行为有据可查也为后续 Mistral 模型升级提供了回归保障。三、VSCode Language ModelsCopilot配置保存修复3.1 什么是 VSCode Language ModelsVSCode 内置的 Language Model APIvscode.lm允许扩展访问用户已登录的模型服务典型如 GitHub Copilot。Roo Code 通过 vscode-lm.ts 中的VsCodeLmHandler接入该能力使用户可以直接用 Copilot 订阅内的模型运行 Roo Code而无需额外申请第三方 API Key。3.2 模型选择器selector机制VSCode LM 通过LanguageModelChatSelector筛选可用模型Roo Code 将其封装为vsCodeLmModelSelector配置项含vendor、family、version、id等字段并提供一个字符串化工具 vsCodeSelectorUtils.tsexport const SELECTOR_SEPARATOR / export function stringifyVsCodeLmModelSelector(selector: LanguageModelChatSelector): string { return [selector.vendor, selector.family, selector.version, selector.id].filter(Boolean).join(SELECTOR_SEPARATOR) }运行时VsCodeLmHandler会通过vscode.lm.selectChatModels(selector)选取第一个匹配模型作为客户端如果没有任何可用模型则回退到一个输出提示信息的最小实现保证流程不崩溃见 vscode-lm.ts。此外代码中还维护了一个静态黑名单VSCODE_LM_STATIC_BLACKLIST当前包含claude-3.7-sonnet、claude-3.7-sonnet-thought在getVsCodeLmModels拉取模型列表时将这些注定无法工作的模型过滤掉见 vscode-lm.ts。3.3 修复的 Bug 及其意义3.1.6 修复的问题是使用 VSCode Language ModelsCopilot作为供应商时保存配置 Profile 会失败。结合仓库代码可以还原其技术背景配置保存入口位于 webviewMessageHandler.ts前端提交apiConfiguration后由providerSettingsManager.saveConfig或upsertProviderProfile持久化在保存前系统会通过 checkExistApiConfig.ts 的checkExistKey判断当前配置是否完整可用——vscode-lm供应商既没有传统 API Key其关键配置又保存在vsCodeLmModelSelector对象中。若该对象在序列化/校验环节未正确纳入有效配置判定或白名单模型 ID 提取逻辑就会导致 Profile 保存被拒绝或配置丢失。从 checkExistApiConfig.ts 可以看到vsCodeLmModelSelector与awsRegion、ollamaModelId等并列作为无需密钥但需保留的非密钥配置被显式识别而 ProfileValidator.ts 也为vscode-lm分支单独处理了模型 ID 提取profile.vsCodeLmModelSelector?.id。这两处正是确保 VSCode LM 这类无密钥供应商在保存、校验、组织白名单三套机制中都不被遗漏的关键代码路径——3.1.6 的修复正是让这类配置 Profile 在保存与回读时保持完整一致。对用户而言本次修复意味着在 Roo Code 中选用 Copilot / VSCode LM 作为模型供应商后可以将完整的选择器配置持久化为 Profile之后切换、共享配置时不再丢失模型选择。四、实践如何配置与验证 3.1.6 的两项能力4.1 配置 Mistral 供应商将 Roo Code 升级到 3.1.6 或更高版本在 Provider 设置中选择Mistral填入 Mistral API Key在 Mistral 控制台创建构造函数会校验其存在性选择模型默认codestral-latest自动路由至https://codestral.mistral.ai选择其他模型如mistral-large-latest、pixtral-large-latest时自动走https://api.mistral.ai如需自定义 Codestral 端点可设置mistralCodestralUrl需要时可设置温度modelTemperature默认 1。4.2 配置 VSCode Language ModelsCopilot在 Provider 设置中选择VSCode LM / Copilot通过vsCodeLmModelSelector指定vendor/family/version/id或在选择器中留空以自动匹配保存 Profile——3.1.6 修复后该选择器配置会作为有效配置被checkExistKey正确识别并持久化运行任务时VsCodeLmHandler会请求授权justification 消息中会包含模型名称与厂商批准后即可使用。4.3 验证方式查看任务输出的用量统计Mistral 请求的usage事件会透传inputTokens/outputTokens观察工具调用toolChoice恒为any模型应始终先调用工具而非直接作答对 Mistral 思考型模型可在响应中看到reasoning块由 thinking chunk 转换而来对 VSCode LM切换 Profile 后确认模型选择仍然保留即为保存修复生效的直接体现。五、小结Roo Code 3.1.6 以两项精准改动完成了接入新供应商 巩固配置可靠性的目标。Mistral 的接入并非简单的 SDK 调用而是完整落地了模型注册表9 个模型、价格与上下文元信息、双端点路由、Anthropic→Mistral 消息转换含 9 位工具 ID 规范化与严格角色顺序、thinking→reasoning 流式转换以及恒为any的工具调用策略并通过 mistral.spec.ts 固化为可回归的测试资产。VSCode LM 配置保存修复则补齐了无密钥供应商在配置持久化与校验链路中的缺口让 Copilot 用户获得与第三方 API 供应商一致的配置体验。对于希望扩展 Roo Code 模型生态或排查供应商配置问题的开发者本文涉及的源码路径providers/mistral.ts、mistral.ts、vscode-lm.ts、checkExistApiConfig.ts可作为直接的阅读起点。【免费下载链接】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），仅供参考