Lzh on GitHub

导入、导出和重置设置

通过导出、导入或重置为默认值来管理你的 Roo Code 设置。

Roo Code 允许你通过导出、导入和重置选项有效地管理你的配置设置。这些功能对于备份你的设置、与他人共享配置或在需要时恢复默认设置非常有用。

你可以在 Roo Code 设置页面的底部找到这些选项，通过 Roo Code 聊天视图中的齿轮图标 ⚙️ 访问。

导出设置

点击 “导出” 按钮会将你当前的 Roo Code 设置保存到 JSON 文件中。

  • 导出内容： 该文件包含你配置的 API 提供商配置文件和全局设置（UI 偏好、模式配置、上下文设置等）。
  • 安全警告： 导出的 JSON 文件包含你所有配置的 API 提供商配置文件和全局设置。至关重要的是，这包括明文形式的 API 密钥。将此文件视为高度敏感。不要公开或与不信任的人分享，因为它授予了对你 API 账户的访问权限。
  • 过程：
  1. 点击“导出”。
  2. 出现文件保存对话框，建议文件名为 roo-code-settings.json（通常在你的 ~/Documents 文件夹中）。
  3. 选择一个位置并保存文件。

这会创建你的配置备份或你可以共享的文件。

导入设置

点击“导入”按钮允许你从之前导出的 JSON 文件中加载设置。

  • 过程：
  1. 点击“导入”。
  2. 出现文件打开对话框。选择你想要导入的 roo-code-settings.json 文件（或类似命名的文件）。
  3. Roo Code 读取文件，根据预期模式验证其内容，并应用设置。
  • 合并： 导入设置会合并配置。它会根据文件内容添加新的 API 配置文件并更新现有的配置文件和全局设置。它不会删除你当前设置中存在但导入文件中缺少的配置。
  • 验证： 只有与内部模式匹配的有效设置才能被导入，从而防止配置错误。完成后会显示成功通知。

自动配置导入

每次启动 VS Code 时，自动从文件中导入你的 Roo Code 设置。这是一种在多台机器上同步你的配置或为整个团队标准化设置的强大方式。

主要功能

  • 轻松同步： 在不同的工作区和设备上保持你的设置一致。
  • 团队标准化： 共享一个配置文件，以确保你的整个团队使用相同的设置。
  • 灵活的路径： 支持绝对路径，或相对于你的主目录的路径（例如，~/Documents/roo-settings.json）。
  • 静默且安全： 如果找不到文件或文件包含错误，Roo Code 会正常启动，不会阻塞你的工作流程。

使用案例

之前： 每次你换新机器或想分享你的设置时，都手动导出和导入设置。

  • 手动打开设置面板。
  • 将你当前的设置导出到文件。
  • 将文件发送给队友或新机器。
  • 手动导入文件。

有了此功能后： 只需配置一次路径，Roo Code 就会在每次启动时处理其余的事情。

工作原理

当 VS Code 启动时，Roo Code 会检查一个特定的设置：roo-cline.autoImportSettingsPath。如果此设置包含指向有效 Roo Code 配置文件（.json）的路径，Roo Code 将自动加载它。

  • 成功导入后，你将看到一条通知：Successfully imported settings from [your-file-name.json].（已成功从 [your-file-name.json] 导入设置。）
  • 如果文件无效或找不到，你会收到一个非侵入式警告，并且扩展将使用你上次已知的设置启动。autoImportSettings 函数旨在永远不会阻止扩展激活。

配置

要使用此功能，请将以下内容添加到你的 VS Code settings.json 文件中：

  1. 打开你的 settings.json 文件：
  • 使用命令面板（Ctrl/Cmd + Shift + P）并搜索“Preferences: Open User Settings (JSON)”。
  1. 添加设置：
  • 添加 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": ""
}

常见问题解答

“如果我的文件有错误会发生什么？”

  • Roo Code 将显示一条包含错误详细信息的警告通知。扩展将继续使用你之前保存的设置正常加载。

“Roo Code 在哪里查找相对路径？”

  • 为了安全和一致性，不是绝对路径或基于主目录的路径都将相对于你的主目录解析。

“我可以使用它来管理我的团队的设置吗？”

  • 是的。将配置文件放在一个共享位置（如同步的云文件夹或共享网络驱动器），并让每个团队成员指向该文件。

重置设置

点击红色的“重置”按钮会完全清除所有 Roo Code 配置数据，并将扩展恢复到其默认状态。这是一个破坏性操作，旨在用于故障排除或从头开始。

  • 警告： 此操作不可逆。它会永久删除所有 API 配置（包括存储在机密存储中的密钥）、自定义模式、全局设置和任务历史记录。
  • 过程：
  1. 点击红色的“重置”按钮。
  2. 出现确认对话框，警告此操作无法撤消。
  3. 点击“是”以确认。
  • 重置内容：
    • API 提供商配置文件： 所有配置都从设置和机密存储中删除。
    • 全局设置： 所有偏好（UI、模式、批准、浏览器等）都重置为默认值。
    • 自定义模式： 所有用户定义的模式都被删除。
    • 机密存储： 所有 API 密钥和 Roo Code 管理的其他机密都被清除。
    • 任务历史记录： 当前任务堆栈被清除。
  • 结果： Roo Code 返回到其初始状态，就像刚安装一样，具有默认设置且没有用户配置。

仅当你确定要删除所有 Roo Code 数据或在故障排除期间被指示时，才使用此选项。如果你以后可能想要恢复它们，请考虑先导出你的设置。