跳到主要内容

导入与导出数据

Elftia 支持多种数据格式的导入和导出，方便你在不同设备之间迁移数据、备份配置，或与他人分享设置。

可导入/导出的数据类型​

数据类型导出格式导出位置导入方式
LLM 提供商配置JSON设置 → 提供商设置设置 → 提供商设置
MCP 服务器配置JSON设置 → MCP设置 → MCP
Agent 定义Markdown (.md)Agent 页面Agent 页面
角色卡PNG (带元数据) / JSON角色扮演设置角色扮演设置
对话记录JSON侧边栏右键菜单侧边栏导入
主题配置JSON设置 → 外观设置 → 外观
诊断信息JSON / ZIP设置 → 系统不支持导入

LLM 提供商配置​

导出提供商配置​

当你配置了多个 LLM 提供商后，可以将所有配置导出为 JSON 文件，便于备份或迁移。

  1. 打开 设置 → 提供商设置。
  2. 点击提供商列表上方的 导出 按钮。
  3. 选择保存位置，文件将以 JSON 格式保存。

导出的 JSON 包含以下信息：

  • 提供商 ID 和名称
  • Base URL 配置
  • 启用状态
  • 模型列表和参数配置
警告

出于安全考虑，导出的配置 不包含 API Key。导入后你需要重新输入每个提供商的 API Key。

导入提供商配置​

  1. 打开 设置 → 提供商设置。
  2. 点击提供商列表上方的 导入 按钮。
  3. 选择之前导出的 JSON 文件。
  4. 系统会显示导入预览，确认后应用配置。
  5. 为每个提供商重新输入 API Key 并测试连接。

MCP 服务器配置​

导出 MCP 配置​

  1. 打开 设置 → MCP（或功能栏中的 MCP 页面）。
  2. 在 MCP 服务器列表中，找到导出功能。
  3. 配置将以 JSON 格式保存，包含所有 MCP 服务器的连接信息。

导入 MCP 配置​

Elftia 支持从标准的 MCP 配置 JSON 文件导入服务器定义。

  1. 打开 MCP 管理页面。
  2. 点击 导入 JSON 按钮。
  3. 选择 MCP 配置 JSON 文件。格式示例：
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@my-org/my-mcp-server"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}
  1. 系统会解析并添加配置中定义的 MCP 服务器。
提示

Elftia 兼容 Claude Desktop 格式的 MCP 配置文件（claude_desktop_config.json），可以直接导入。

Agent 定义​

导出 Agent​

Agent 定义以 Markdown 文件存储，你可以直接导出：

  1. 打开 Agent 页面。
  2. 选择要导出的 Agent。
  3. 使用导出功能将 Agent 定义保存为 .md 文件。

Agent 的 Markdown 文件包含：

  • Agent 名称和描述
  • 系统提示词
  • 工具权限配置
  • MCP 服务器分配
  • 其他行为设置

导入 Agent​

  1. 打开 Agent 页面。
  2. 点击创建按钮旁边的导入选项。
  3. 选择 Agent 的 .md 文件。
  4. 系统会解析文件并创建对应的 Agent。

角色卡​

Elftia 支持标准的角色卡格式，兼容社区常见的角色卡规范。

导出角色卡​

  1. 在角色扮演对话中，打开 RP 设置面板。
  2. 找到角色卡导出功能。
  3. 选择导出格式：
    • PNG（推荐）：图片文件，元数据嵌入在 PNG 的文本块中。可以直接作为图片分享，同时包含完整的角色信息。
    • JSON：纯文本格式，包含角色的所有定义数据。

导入角色卡​

  1. 在角色扮演设置中，点击 导入角色卡。
  2. 选择 PNG 或 JSON 格式的角色卡文件。
  3. 系统会自动解析角色信息并填充到表单中。
  4. 你可以在导入后修改角色的各项设置，然后保存。

对话记录​

导出对话​

  1. 在侧边栏中，右键点击要导出的对话。
  2. 选择 导出。
  3. 选择保存位置，对话将以 JSON 格式保存。

导出的对话包含：

  • 所有消息（用户消息和 AI 回复）
  • 分支信息
  • 消息时间戳
  • 使用的模型信息
  • 附件的引用信息

批量导出​

  1. 在侧边栏中，进入批量选择模式。
  2. 选中多个对话。
  3. 使用批量操作栏中的导出功能，一次性导出所有选中的对话。

导入对话​

  1. 在侧边栏中，使用导入功能。
  2. 选择之前导出的对话 JSON 文件。
  3. 对话将被还原到会话列表中。

主题配置​

导出主题​

如果你自定义了满意的主题配置（包括主题模式、强调色、字体、壁纸、自定义 CSS），可以将其导出为主题配置文件。

  1. 打开 设置 → 外观。
  2. 找到 主题配置 区域。
  3. 点击 导出主题 按钮。
  4. 选择保存位置，配置以 JSON 格式保存。

导出内容包含：

  • 主题模式（浅色/深色/跟随系统）
  • 强调色设置
  • 字体覆盖
  • 壁纸配置（模糊度、遮罩透明度等参数）
  • 自定义 CSS 代码
信息

壁纸的图片文件本身不会包含在导出中，只导出壁纸的配置参数。如果使用本地壁纸图片，你需要在导入后重新设置壁纸图片路径。

导入主题​

  1. 打开 设置 → 外观 → 主题配置。
  2. 点击 导入主题 按钮。
  3. 选择主题 JSON 文件。
  4. 系统会预览导入的主题差异，确认后应用。

诊断信息导出​

诊断信息用于排查问题时提供给技术支持，不支持导入。

  1. 打开 设置 → 系统。
  2. 点击 Export Diagnostics 按钮。
  3. 系统会收集运行时信息、日志、配置等，生成诊断文件。
  4. 你可以选择导出为单个 JSON 文件或完整的 ZIP 压缩包。

详见 诊断工具。

注意事项​

  • API Key 安全：任何导出功能都不会导出 API Key 等敏感凭据。导入配置后需要手动重新输入。
  • 版本兼容：导出的数据文件包含版本信息。较新版本导出的文件可能无法在旧版本中导入。
  • 文件大小：包含大量附件引用的对话导出可能产生较大的文件。附件文件本身不包含在导出中。
  • 字符编码：所有导出文件使用 UTF-8 编码，确保跨平台兼容。

如果在导入导出过程中遇到问题，请参阅 常见问题。