Thanks to visit codestin.com
Credit goes to docs.qoder.cn

Skip to main content
功能说明

数据导入

把 Qoder CN IDE(Quest)和 QoderWork CN 中的任务记录、定时任务、记忆与能力导入 Qoder CN。

把 Qoder CN 家族其他产品里的工作带进来,在 Qoder CN 中接着用。 数据导入位于设置 › 个人 › 数据导入,读取本机 Qoder CN IDE(Quest)QoderWork CN 的数据,只读复制到当前 Qoder CN。它是一次性动作:不建立自动同步,也不修改或删除来源产品里的任何数据。

判断是否需要手动导入

首次启动 Qoder CN 并登录后,引导流程会带你走一遍将你的工作带入 Qoder CN,默认已勾选全部可导入内容,你只需要确认。以下情况需要回到设置页手动导入:
  • 引导时点了跳过
  • 引导之后又在来源产品里产生了新的任务记录、定时任务或记忆。
  • 首次启动时来源数据还读不到,之后才在那台电脑上登录使用过。
导入只认本机数据。来源产品需要在同一台电脑上安装并登录使用过,且与当前 Qoder CN 属于同一区域:Qoder 读取 Qoder 的数据,Qoder CN 读取 Qoder CN 的数据,两者不交叉。

可以导入哪些内容

页面按来源分组,每个分组内固定按任务记录定时任务记忆能力的顺序排列。
来源可导入内容说明
Qoder CN IDE(Quest)任务记录Quest 模式的任务记录
定时任务任务定义与历史执行记录
记忆长期记忆,写入 Qoder CN 的记忆目录
MCP 连接器Skill、子智能体、Hook 和全局规则共用配置目录,已默认继承,只需迁移 MCP 连接器
QoderWork CN任务记录QoderWork CN 下的所有用户会话记录
定时任务任务定义与历史执行记录
记忆转换为 Qoder CN 的标准记忆格式
Skill、MCP 连接器和插件用户级 Skill、MCP 连接器与已安装插件

不会导入的内容

  • 接入凭据:模型 API Key、OAuth 授权和 SSH 凭据需在 Qoder CN 中重新配置。
  • 项目代码:只保留任务记录和关联工作目录的指向,不复制项目文件。
  • 非用户级插件:QoderWork CN 的项目级、本地级插件由企业或工作区下发;只迁移用户级插件。
QoderWork CN 只发布 macOS 与 Windows 版本,Linux 上不会显示 QoderWork CN 分组。

导入数据

导入期间请保持 Qoder CN 运行,尤其不要在迁移记忆和能力时退出客户端。任务记录可以在后台导入;退出或被系统强制结束后,需要重新打开并点击继续导入。无需关闭来源 Qoder CN IDE 或 QoderWork CN,导入只读取它们的数据。

首次启动时导入

1

确认内容

登录 Qoder CN 后,在将你的工作带入 Qoder CN页面检查来源与内容。可导入项目默认全部勾选;如需排除某项,展开对应来源并取消勾选。引导页按来源列出对话数据定时任务MCP 连接器Memory(记忆)等项目。
2

开始导入

点击继续。数据会在后台导入,关闭引导窗口不会中断任务。
3

查看结果

完成提示会显示在主窗口。任务记录及其原有工作目录会出现在左侧栏;内容较多时可能需要等待一段时间。
引导时选择跳过不会丢失数据。之后可在设置 › 个人 › 数据导入中执行相同的导入流程。

从设置中导入

1

检查新增内容

打开设置 › 个人 › 数据导入。页面自动检测本机来源,每行只显示尚未成功导入的新增数量,不是历史总量。某个来源暂时没有数据时,不影响其他行。
2

开始导入

点击导入数据,重新检测并确定本次要导入的内容。之后新增的记录留到下次;没有新增内容时不会启动空的导入。
3

查看进度

页面显示「正在导入 N / M」。任务记录在后台逐条处理,数量较多时请耐心等待。离开页面再回来,进度仍会保留,不会重复启动导入。
4

需要时暂停或取消

点击暂停导入后,当前一条处理完成才会停止后续导入;点击取消导入则停止处理本次剩余内容。两者都会保留已导入的内容。
5

中断后继续

退出 Qoder CN 或客户端被系统强制结束后,重新打开并点击继续导入,只处理当时选定的剩余内容。重新打开后,页面显示「上次导入未完成 · 已导入 N 个,剩余 M 个」。继续导入不会重新全选或产生重复记录;暂停期间来源新增的数据留待下次导入。
同一时间只能进行一项导入,包括不同来源。请等当前导入完成后再开始另一项。

核对导入结果

导入结束后,回到数据导入页面查看成功、跳过和失败的数量,再按下表检查内容是否可用。显示「已开始导入」时,导入仍在进行中。
内容完成后如何确认需要注意
任务记录页面显示「发现 N 个任务记录 · 已全部导入」;左侧栏中可以打开记录单条失败不会终止整批
定时任务页面显示定时任务及执行记录已完成导入新导入的任务不会自动运行
记忆页面显示已导入数量同名文件会改名保存,不覆盖已有文件
Skill、MCP 和插件页面分别显示迁移、跳过、不支持及待授权数量OAuth 连接器需要重新授权
失败时会显示具体数量与原因,例如「已导入 N 个,M 个因文件不存在,无法导入」。单条失败不会终止整批,其余内容会继续导入。

导入后,让内容可用

定时任务

所有导入的定时任务默认关闭,避免同一任务在两个产品中重复运行。请先检查调度时间和任务内容,再手动开启。
  • 任务输出方式:定时任务沿用来源产品的独立任务输出。如需把后续执行集中到同一条时间线,可编辑任务并改为合并任务输出;从下次执行起生效,已导入的历史记录不会合并。
  • 工作目录:虚拟目录或本机不存在的目录不会保留,需要在任务编辑中重新指定。
  • 数量上限:Qoder CN 最多保存 50 个定时任务,已有任务与待导入任务合计超过 50 个时,超出部分会跳过并计入结果。

连接器、插件与记忆

  • 连接器授权:按导入结果提示,为 OAuth 连接器重新授权后再使用。
  • 同名能力:已有同名 MCP 连接器或插件时直接跳过,不比较内容或版本,不覆盖、不改名。QoderWork CN 中已禁用的连接器导入后仍保持禁用。本机启用开关保持原状。
  • 记忆文件:同名记忆会使用其他文件名保存,不覆盖现有内容。
  • 历史正文:来源记录缺少解密密钥时仍可导入,但部分正文会降级显示,导入前会提示。

处理导入失败

提示含义与处理
读不到该应用的本机数据,请确认它已在本机登录使用过来源产品没有在这台电脑上登录使用过,或数据目录当前不可读。先在来源产品中登录一次,再点击重新检测
可导入内容检测失败,请重新检测检测过程出错,点击重新检测重试
没有发现新增的任务记录来源中没有未导入过的记录,已经导入过的内容不会重复导入
部分正文缺少解密密钥,导入后会降级显示可以照常导入,只是部分历史正文不完整
当前宿主不支持读取本机来源应用的数据,请在桌面版 Qoder CN 中导入数据导入只在桌面版 Qoder CN 提供
另一项迁移正在进行,完成后可继续等待当前批次结束后再发起
导入结果里被跳过的 Skill 会单独列出名称与来源目录,来源文件未被修改。检查这些目录后可以重新迁移。

再次导入

数据导入采用增量方式。来源产品后续出现新内容时,可再次点击导入数据创建新批次。
  • 已成功导入的任务记录、定时任务和记忆不会重复导入。
  • 来源任务记录后来新增的消息不会自动追加到已导入记录中,请直接在 Qoder CN 中继续对话。
  • 确认迁移完成后,建议关闭或清理来源产品中不再使用的定时任务,避免重复执行。
之后请在 Qoder CN 中修改定时任务、记忆与能力。来源产品的后续变化不会自动同步过来。