跳到主要内容

3.12.5 配置导入与导出

配置导入导出用于跨机器同步、团队共享、Studio 升级后恢复等场景。所有可导出的配置统一打包为 JSON 文件。

可导出的配置项​

内容是否包含敏感字段
AI 引擎所有模型条目含明文 API Key（导出时可勾选"脱敏"，将 Key 替换为占位符）
飞书 / 微信通道凭据含 App Secret 等敏感信息
设备列表与 SSH 凭据如使用密码认证，含明文密码
外观与体验设置不含敏感信息
微信绑定列表不含（每台机器独立绑定）

导出操作​

路径配置中心 → 顶部 → 导出配置
选项选择要导出的内容范围（全部 / 仅 AI 引擎 / 仅设备等）
脱敏选项勾选后导出文件中的 API Key、密码等替换为占位符 __REDACTED__
输出下载为 rdk-studio-config-<时间戳>.json

团队协作的最佳实践​

场景推荐方式
加密分享给可信同事导出含敏感字段，通过加密通道（公司加密邮件、加密 IM）传输
分发给团队（不传敏感凭据）导出时勾选"脱敏"，导出占位符模板，由使用方自填 API Key
备份到团队私有 Git 仓库务必脱敏后再提交，并确保仓库访问受限

绝对避免：

  • 把含敏感字段的 JSON 通过公开聊天群、邮件附件传输
  • 把含敏感字段的 JSON 提交到公开 Git 仓库
  • 在 Slack、企业微信群等多人可见的地方分享

导入操作​

路径配置中心 → 顶部 → 导入配置
操作选择 JSON 文件 → 确认 → 自动合并到本机配置
冲突处理同名条目会提示是否覆盖；可选择"全部覆盖"或"逐个确认"
跨版本兼容自动迁移大多数字段；个别字段在跨大版本（如 1.0 → 1.1）时可能需要手动调整

导出文件格式​

导出的 JSON 结构示例（已脱敏）：

{
  "version": "1.1",
  "exportedAt": "2026-04-19T14:00:00Z",
  "aiEngine": {
    "thinkingModel": "claude-sonnet",
    "quickModel": "qwen-turbo",
    "models": [
      {
        "label": "Claude Sonnet 4",
        "provider": "anthropic",
        "model": "claude-sonnet-4-20250514",
        "apiKey": "__REDACTED__",
        "baseUrl": ""
      }
    ]
  },
  "devices": [
    {
      "name": "RDK-X5-工位1",
      "ip": "192.168.128.10",
      "user": "root",
      "auth": "password",
      "password": "__REDACTED__"
    }
  ]
}

开发者可以手动编辑这份 JSON（例如改 IP、改注释），然后导入回 Studio。

跨版本兼容性​

升级方向兼容性
同小版本（1.1.0 → 1.1.5）完全兼容，配置无需任何调整
跨小版本（1.1 → 1.2）大多兼容，少量字段可能需要手动设置默认值
跨大版本（1.x → 2.x）自动迁移大部分字段，可能有不兼容的旧字段需要清理

如果导入失败提示"格式不兼容"，建议在新版 Studio 中重新创建配置而不是强行导入旧 JSON。

最后于 更新