Roo Code 设置管理完全指南导入、导出、重置与自动同步实战【免费下载链接】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 提供了完整的配置管理能力让你可以通过导出Export、导入Import、重置Reset和自动导入四种方式高效管理扩展设置。本指南将围绕 Roo Code 设置页面底部的管理按钮、VS Code 命令面板相关命令、roo-cline.*配置项以及底层实现原理展开帮助你在多机同步、团队标准化、排障重置和存储路径自定义等真实场景中熟练掌控自己的配置数据。设置管理入口从哪里找到这些功能Roo Code 的设置管理功能集中在设置页面底部Settings → About 区域。打开方式在 Roo Code 聊天视图中点击齿轮图标进入设置页面页面底部即为Export / Import / Reset三个按钮。从源码看这三个按钮由 About.tsx 渲染分别通过vscode.postMessage向扩展主机发送exportSettings、importSettings、resetState三种消息Button onClick{() vscode.postMessage({ type: exportSettings })} {t(settings:footer.settings.export)} /Button Button onClick{() vscode.postMessage({ type: importSettings })} {t(settings:footer.settings.import)} /Button Button variantdestructive onClick{() vscode.postMessage({ type: resetState })} {t(settings:footer.settings.reset)} /Button对应的消息处理逻辑位于 webviewMessageHandler.tsresetState分支调用provider.resetState()与 ClineProvider.ts。此外首次使用的欢迎页WelcomeView也提供了「Import Settings」入口便于新用户快速恢复已有配置参见 WelcomeViewProvider.tsx。导出设置Export Settings点击Export按钮Roo Code 会把当前全部配置保存为一个 JSON 文件。导出的内容导出的 JSON 文件结构包含两部分对应 importExport.ts 中exportSettings的实际写入逻辑{ providerProfiles: { currentApiConfigName: default, apiConfigs: { default: { id: xxx, apiProvider: openrouter, openRouterModelId: xxx } }, modeApiConfigs: {} }, globalSettings: {} }providerProfiles你配置的全部 API Provider Profiles提供商配置档案包括各模式的 API 配置映射modeApiConfigs、当前激活配置名currentApiConfigName等globalSettings全局设置包括 UI 偏好、模式配置Mode、上下文设置Context等。安全警告导出文件包含明文 API Key导出的 JSON 中包含全部已配置的 API Provider Profiles 与全局设置其中包含明文 API Key。该文件等同于你 API 账户的访问凭证必须视为高度敏感数据切勿公开分享或交给不可信的人。导出配置建议保存到本机安全位置。值得说明的是Provider 配置实际存储于 VS Code 的 SecretStorage见 ProviderSettingsManager.ts 中的secretsKey而导出操作将其序列化到明文 JSON 文件因此在分享前务必留意脱敏。导出操作步骤点击设置页面底部的Export按钮系统弹出保存对话框默认文件名为roo-code-settings.json默认目录通常为~/Documents源码中 fallback 目录为~/Downloads见 importExport.ts选择保存位置并确认。导出既可作为配置备份也可作为与他人共享配置的载体。Roo Code 会记住上次导出路径lastSettingsExportPath下次导出/导入时默认定位到该路径方便重复操作。导入设置Import Settings点击Import按钮可从先前导出的 JSON 文件恢复配置。操作步骤点击Import按钮在文件选择对话框中选择roo-code-settings.json或类似命名文件Roo Code 读取文件、按预期 Schema 校验内容然后应用配置。底层调用链为importSettings先打开文件对话框再调用importSettingsFromPath完成解析与合并见 importExport.ts。合并策略只增不删导入采用合并merge策略文件中的新 API Profile 会被新增同名 Profile 会被更新全局设置按文件内容覆盖但不会删除当前配置中存在而导入文件中缺失的配置。从源码看合并通过对象展开实现见 importExport.tsconst providerProfiles { currentApiConfigName, apiConfigs: { ...previousProviderProfiles.apiConfigs, // 保留本地已有 Profile ...validApiConfigs, // 合并文件中的 Profile }, modeApiConfigs: { ...previousProviderProfiles.modeApiConfigs, ...rawProviderProfiles.modeApiConfigs, }, }校验策略宽容校验带警告成功导入会对文件内容进行 Schema 校验但采取「宽容解析lenient parsing」策略部分 Profile 无效若某些 API Profile 引用了已不存在的 Provider或格式非法Roo Code 会跳过或修正这些 Profile导入其余有效部分并报告警告。例如sanitizeProviderConfig会把非法apiProvider字段剔除并提示 Invalid provider was removed. Please reconfigure this profile.见 importExport.ts全部 Profile 无效只有所有Profile 均无效时才判定导入失败并返回错误信息 No valid profiles could be imported当前激活 Profile 失效若导入文件中currentApiConfigName指向的 Profile 无效Roo Code 会自动回退到第一个有效导入 Profile并给出警告见 importExport.ts。导入成功后若存在警告会以 toast 通知提示如 1 profile had issues during import完整警告详情会输出到 Developer Tools 控制台便于排查见 importExport.ts。自动配置导入Automatic Configuration Import自动导入是「导出/导入」的进阶能力配置一次路径后每次启动 VS Code 时 Roo Code 都会自动从指定 JSON 文件加载设置无需任何手动操作。核心特性无感同步在不同工作区、不同设备间保持设置一致团队标准化团队共用一份配置文件确保所有人使用相同设置灵活的路径支持绝对路径也支持以~开头的主目录相对路径如~/Documents/roo-settings.json静默且安全文件不存在或内容出错时Roo Code 正常启动绝不阻塞工作流。典型场景使用前每次换机器或分享配置都要手动操作——打开设置面板、导出文件、传输文件、再手动导入。使用后配置一次路径Roo Code 每次启动自动完成导入。工作原理VS Code 启动时Roo Code 检查设置项roo-cline.autoImportSettingsPath若该设置指向一个有效的 Roo Code 配置文件.json则自动加载它。核心实现在 autoImportSettings.ts读取roo-cline.autoImportSettingsPath配置第 22 行通过resolvePath解析路径~/开头展开为主目录、绝对路径原样使用、其他相对路径一律按主目录解析第 71-84 行文件存在则调用importSettingsFromPath导入导入成功显示通知Successfully imported settings from [文件名].json失败则显示非侵入式警告扩展仍以最后一次有效设置启动——autoImportSettings被设计为永不阻塞扩展激活整个函数包裹在 try/catch 中见 第 16-66 行。配置方法打开settings.json使用命令面板Ctrl/Cmd Shift P→ 输入并选择Preferences: Open User Settings (JSON)添加roo-cline.autoImportSettingsPath键值为配置文件路径。示例一绝对路径推荐{ roo-cline.autoImportSettingsPath: /Users/your-username/Documents/dev-configs/roo-code.json }示例二主目录路径使用~{ roo-cline.autoImportSettingsPath: ~/roo-code-settings.json }禁用自动导入将路径留空或删除该配置项即可{ roo-cline.autoImportSettingsPath: }FAQ如果我的文件有错误会发生什么Roo Code 会显示包含错误详情的警告通知扩展随后继续以之前保存的设置正常加载。Roo Code 如何解析相对路径出于安全与一致性考虑非绝对路径、非~开头的路径一律相对于**主目录home directory**解析。我可以用它为团队管理设置吗可以。将配置文件放在共享位置如云同步文件夹或共享网络驱动器让每位团队成员将该设置指向同一文件即可。重置设置Reset Settings点击Reset按钮会彻底清空 Roo Code 的全部配置数据将扩展恢复为出厂默认状态。这是一个用于排障或重新开始的破坏性操作。警告操作不可逆该操作不可撤销会永久删除API Provider Profiles设置与 SecretStorage 中的全部 API 配置全局设置Global SettingsUI、模式、审批approvals、浏览器等全部偏好恢复默认自定义模式Custom Modes所有用户自定义模式被删除密钥存储Secret Storage所有 API Key 及其他由 Roo Code 管理的密钥被清空任务历史Task History当前任务栈被清空。操作步骤点击红色的Reset按钮弹出模态确认对话框提示该操作无法撤销点击Yes确认。底层实现resetState由 ClineProvider.ts 实现弹出模态确认框showInformationMessage{ modal: true }确认后依次调用await this.contextProxy.resetAllState() // 清空全局设置ContextProxy await this.providerSettingsManager.resetAllConfigs() // 删除 SecretStorage 中的 Provider 配置 await this.customModesManager.resetCustomModes() // 删除自定义模式 await this.removeClineFromStack() // 清空任务栈其中resetAllConfigs直接调用context.secrets.delete()删除存储密钥见 ProviderSettingsManager.ts印证了「密钥存储被清空」的行为。结果Roo Code 回到初始状态如同全新安装——默认设置、无任何用户配置。请仅在确定要删除所有 Roo Code 数据、或排障流程明确要求时使用此选项。若日后可能恢复请先执行Export备份。命令面板命令Command Palette Commands除了设置界面按钮Roo Code 还提供若干命令面板命令供键盘党与自动化流程使用。命令在 registerCommands.ts 中注册。设置自定义存储路径Set Custom Storage Path命令roo-cline.setCustomStoragePath打开对话框为 Roo Code 数据指定自定义存储目录。默认情况下Roo Code 将任务历史、设置等数据存放在 VS Code 扩展标准存储位置该命令允许你改存到其他位置。典型用途团队协作将数据放在共享网络文件夹团队成员可访问相同的任务历史与设置磁盘管理将数据放在指定磁盘如更大的副盘而非主 SSD云同步将数据放在云同步文件夹Dropbox、OneDrive 等跨多机同步备份策略把数据放在纳入常规备份流程的位置。使用步骤打开命令面板Ctrl/Cmd Shift P输入 Set Custom Storage Path 或搜索roo-cline.setCustomStoragePath选择该命令在文件选择对话框中选定目录重启 VS Code 使更改生效。实现细节promptForCustomStoragePath见 storage.ts会弹出输入框校验输入必须为绝对路径否则提示 enter absolute path写入全局配置roo-cline.customStoragePath并测试目录可读写。运行时getStorageBasePath会优先使用自定义路径若路径不可用则回退到默认路径并弹错见 storage.ts。注意该设置也可以直接在 VS Code 设置中配置为roo-cline.customStoragePath详见下文「VS Code 设置参考」。从文件导入设置Import Settings from File命令roo-cline.importSettings通过命令面板从 JSON 文件导入 Roo Code 设置是设置界面 Import 按钮的等价替代。使用步骤打开命令面板Ctrl/Cmd Shift P输入 Import Settings 或搜索roo-cline.importSettings选择该命令在文件选择对话框中选择设置 JSON 文件设置将被导入并与当前配置合并。该命令与前面「导入设置」一节的 Import 按钮功能完全一致。注册代码见 registerCommands.ts命令支持可选filePath参数可直接以编程方式如被其他命令调用指定文件路径完成导入。UI 设置系统提示词上下文开关与消息折叠设置页面中的部分 UI 选项直接影响发送给模型的系统提示词内容与对话展示方式。系统提示词上下文开关System Prompt Context Toggles控制哪些上下文信息出现在系统提示词中Include Current TimeSettings → General启用时在系统提示词中加入当前时间戳禁用时省略时间信息。默认启用。Include Current CostSettings → General启用时在系统提示词中加入当前任务成本禁用时省略成本信息。默认启用。示例效果两者均启用时系统提示词中包含# Current Time Current time in ISO 8601 UTC format: 2025-10-28T23:06:08.458Z User time zone: America/Edmonton, UTC-6:00 # Current Cost $0.14两者均禁用时上述段落被省略。当你不需要这些上下文时可减少 Token 消耗。该段落的注入逻辑在核心提示词组装流程中实现相关环境信息生成参见 getEnvironmentDetails.ts。默认折叠思考消息Collapse thinking messages by default位置Settings → UI默认启用思考消息默认折叠行为启用默认思考块保持折叠直到你手动展开禁用思考块默认展开备注全局适用于所有对话文本已本地化不同语言下标签可能不同。VS Code 设置参考VS Code Settings ReferenceRoo Code 通过 VS Codesettings.json暴露了大量可细粒度控制的配置。可在 VS Code 设置Ctrl/Cmd ,中搜索 roo-cline 配置或直接编辑settings.jsonCtrl/Cmd Shift P→ Preferences: Open User Settings (JSON)。以下配置均已在 src/package.json 的configuration.properties中注册。命令与执行Command Executionroo-cline.allowedCommands类型字符串数组默认[git log, git diff, git show]说明无需审批即可自动执行的命令白名单。当 Roo Code 请求执行与列表匹配的命令时将直接执行、不弹出审批提示。适合安全的只读命令。roo-cline.deniedCommands类型字符串数组默认[]说明始终禁止执行的命令黑名单。任何与列表匹配的命令都会被拒绝执行用于防止潜在危险操作。roo-cline.commandExecutionTimeout类型数字秒默认0范围0-600说明命令执行超时时间。设为大于 0 时运行超过该时长的命令会被终止0表示无超时命令可无限运行。参见commandTimeoutAllowlist可豁免特定命令。roo-cline.commandTimeoutAllowlist类型字符串数组默认[]说明不受执行超时限制的命令白名单。匹配列表的命令不受commandExecutionTimeout限制可无时限运行。适用于构建流程、部署脚本等已知的长时运行操作。任务管理Task Managementroo-cline.newTaskRequireTodos类型布尔默认false说明启用后通过 boomerang/子任务创建新任务时强制要求提供 todo 列表确保复杂工作先做结构化规划。roo-cline.preventCompletionWithOpenTodos类型布尔默认false说明存在未完成 todo 项时禁止任务完成。启用后若 todo 列表仍有待办项Roo Code 不允许将任务标记为完成。API 与网络API Networkroo-cline.apiRequestTimeout类型数字秒默认600范围0-3600说明API 请求超时时间。决定 Roo Code 等待 AI Provider API 响应的最长时间0表示无超时。存储与导入Storage Importroo-cline.customStoragePath类型字符串默认空说明Roo Code 存储目录的自定义路径。默认情况下数据存放在扩展标准存储位置使用该设置可将任务历史、设置等数据存到其他目录。运行时行为见 storage.ts。roo-cline.autoImportSettingsPath类型字符串默认空说明启动时自动导入设置的配置文件路径。配置后每次 VS Code 启动 Roo Code 都会从该 JSON 文件自动导入设置。详细用法见上文「自动配置导入」一节。代码索引Code Indexroo-cline.maximumIndexedFilesForFileSearch类型数字默认10000范围5000-500000说明文件搜索可索引的最大文件数控制语义搜索功能的索引上限。值越大覆盖越广但可能影响性能。roo-cline.codeIndex.embeddingBatchSize类型数字默认60范围1-200说明代码索引时 embedding 操作的批大小决定生成语义搜索向量时每批处理的代码块数量。较小值降低内存占用但增加耗时较大值更快但更耗内存。编辑器集成Editor Integrationroo-cline.enableCodeActions类型布尔默认true说明控制 Roo Code 操作是否出现在编辑器右键菜单和灯泡lightbulb中。启用后可右键选中代码或通过灯泡菜单以上下文提示快速发送给 Roo Code。roo-cline.vsCodeLmModelSelector类型对象默认{}说明VS Code Language Model API Provider 的选择配置。可通过指定vendor与family属性控制在选择 VS Code LM API Provider 时使用哪个语言模型。详见 VS Code LM API 文档。规则与指令Rules Instructionsroo-cline.useAgentRules类型布尔默认true说明是否加载 AGENTS.md 文件作为 Agent 专属指令。启用后Roo Code 会在项目目录中查找并加载AGENTS.md文件为 AI 提供上下文相关的指导。如需阻止自动加载这些指令文件可将其禁用。调试Debugroo-cline.debug类型布尔默认false说明启用调试模式以输出更多日志。启用后 Roo Code 会向控制台输出详细调试信息便于排查问题或理解内部行为。roo-cline.debugProxy.enabled类型布尔默认false说明启用调试代理以拦截 API 请求。启用后所有 API 请求将经由调试代理服务器转发便于检查与调试 API 通信。roo-cline.debugProxy.serverUrl类型字符串默认http://127.0.0.1:8888说明调试代理服务器地址。当debugProxy.enabled为 true 时使用mitmproxy、Charles Proxy 等常见代理工具通常运行在此默认地址。roo-cline.debugProxy.tlsInsecure类型布尔默认false说明允许通过调试代理建立不安全的 TLS 连接。启用后忽略证书校验错误使用自签名证书的调试代理必须开启。仅应在开发环境启用。结语选择适合你的设置管理策略临时备份 / 迁移设备使用 Export / Import 按钮或roo-cline.importSettings命令长期多机同步 / 团队标准化配置roo-cline.autoImportSettingsPath一次配置、每次启动自动生效且失败时静默回退、绝不阻塞启动数据位置管理使用roo-cline.setCustomStoragePath命令或roo-cline.customStoragePath设置配合共享盘、云同步目录或备份策略彻底排障 / 重新开始使用 Reset操作前务必先 Export 备份。无论选择哪种方式都要牢记两点导出文件包含明文 API Key务必妥善保管Reset不可逆操作前请先确认。基于 importExport.ts 与 autoImportSettings.ts 的源码实现这些功能在底层共享同一套 Schema 校验与合并逻辑行为一致、可预测完全可以放心地纳入你的日常工作流。【免费下载链接】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），仅供参考
