导入、导出和重置设置

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

您可以在 itBuilder 设置页面的底部找到这些选项，通过 itBuilder 聊天视图中的齿轮图标 () 访问。

图片：导出、导入和重置按钮。

---

导出设置

点击导出按钮将您当前的 itBuilder 设置保存到 JSON 文件中。

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

这将创建您配置的备份或您可以分享的文件。

---

导入设置

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

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

---

自动配置导入

每次启动 VS Code 时自动从文件导入您的 itBuilder 设置。这是在多台机器之间同步配置或为整个团队标准化设置的强大方法。

主要功能

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

使用场景

之前：每次移动到新机器或想要分享设置时手动导出和导入设置。

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

使用此功能：配置路径一次，itBuilder 在每次启动时处理其余部分。

工作原理

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

• 成功导入后，您将看到通知：Successfully imported settings from [your-file-name.json]。
• 如果文件无效或找不到，您会收到非侵入性警告，扩展将使用您最后已知的设置启动。autoImportSettings 函数设计为永远不会阻止扩展激活。

配置

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

1. 打开您的 settings.json 文件：

   • 使用命令面板（Ctrl/Cmd + Shift + P）并搜索"Preferences: Open User Settings (JSON)"。

2. 添加设置：

   • 添加 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": ""
  }

常见问题

"如果我的文件有错误怎么办？"

• itBuilder 将显示带有错误详情的警告通知。扩展将继续正常加载，使用您之前保存的设置。

"itBuilder 在哪里查找相对路径？"

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

"我可以使用这个来管理团队的设置吗？"

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

---

重置设置

点击重置按钮完全清除所有 itBuilder 配置数据并将扩展恢复到默认状态。这是一个破坏性操作，用于故障排除或重新开始。

• 警告： 此操作不可逆。它永久删除所有 API 配置（包括存储在密钥存储中的密钥）、自定义模式、全局设置和任务历史记录。

• 过程：

  1. 点击红色的重置按钮。
  2. 出现确认对话框，警告该操作无法撤销。
  3. 点击"是"确认。

• 重置内容：

  • API 提供商配置文件： 所有配置都从设置和密钥存储中删除。
  • 全局设置： 所有偏好（UI、模式、批准、浏览器等）都重置为默认值。
  • 自定义模式： 删除所有用户定义的模式。
  • 密钥存储： 清除 itBuilder 管理的所有 API 密钥和其他密钥。
  • 任务历史记录： 清除当前任务堆栈。

• 结果： itBuilder 返回到初始状态，就像刚安装一样，具有默认设置且没有用户配置。

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