Qoder跨设备配置同步需启用云服务或手动迁移：一、登录账号开启Cloud Sync并勾选同步项；二、导出/导入JSON配置包；三、同步scripts目录；四、迁移CLI配置文件；五、强制拉取团队仓库最新快照。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已在多台设备上安装 Qoder，但各端的偏好设置、自定义脚本、快捷指令或 Agent 任务模板未能保持一致，则可能是由于本地配置未主动同步或云端通道未启用。以下是实现 Qoder 跨设备无缝迁移的具体操作路径：
一、启用 Qoder 内置云同步服务
Qoder 支持通过绑定统一账号将用户级配置加密上传至专属云空间，包括 settings.json 中的界面偏好、快捷键映射、默认模型选择及 CLI 环境变量模板。该服务默认关闭，需手动激活并完成身份核验。
1、启动 Qoder，在 JetBrains IDE 右侧工具栏点击 Qoder 图标 打开主面板。
2、点击右上角齿轮图标进入 Settings & Sync 页面。
3、在 Account 区域点击 Sign in with Qoder ID，使用邮箱+验证码登录已有账户或注册新账户。
4、登录成功后，Cloud Sync 开关自动变为可点击状态，将其开启。
5、勾选需同步的项目：包括 Preferences、Custom Scripts、Agent Task Templates 和 Quick Commands。
二、手动导出导入 JSON 配置包
当目标设备无法联网或账号未获同步权限时，可通过结构化 JSON 文件完成离线迁移。该方式保留全部字段语义与嵌套逻辑，适用于企业内网或高安全隔离环境。
1、在源设备 Qoder 设置面板中，点击 Export Configuration 按钮。
2、系统生成包含 preferences.json、scripts.json、tasks.json 的 ZIP 压缩包，保存至本地可信路径。
3、将 ZIP 文件通过 U 盘、加密邮件或内网传输工具移至目标设备。
4、在目标设备 Qoder 设置面板中，点击 Import Configuration，选择该 ZIP 文件。
5、确认弹窗中列出的文件类型与数量无误后，点击 Apply & Restart 完成覆盖式加载。
三、同步自定义脚本目录（文件系统级）
Qoder 允许用户在 ~/.qoder/scripts/（Linux/macOS）或 %APPDATA%\Qoder\scripts\（Windows）下存放 Python/Shell 脚本，供 Agent 模式调用。此目录不参与云同步，需通过外部同步机制维持一致性。
1、确认源设备脚本目录完整路径，执行命令获取校验值：sha256sum ~/.qoder/scripts/*（Linux/macOS）或 certutil -hashfile %APPDATA%\Qoder\scripts\* SHA256（Windows）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、将整个 scripts/ 目录压缩为 ZIP，并上传至共享存储（如 NAS、OneDrive 同步文件夹或腾讯微云指定目录）。
3、在目标设备对应路径下清空原 scripts/ 目录，解压新包覆盖所有内容。
4、检查文件权限：Linux/macOS 下执行 chmod +x ~/.qoder/scripts/*.py；Windows 下确认脚本扩展名未被系统追加 .txt。
5、重启 Qoder，进入 Agent 模式输入 list scripts 命令，验证列表是否与源设备完全一致。
四、迁移 CLI 配置与凭证文件
Qoder CLI 使用独立于 GUI 的配置体系，存储于 ~/.qoder/cli/config.yml，其中含 API 密钥、默认 host、代理设置等敏感字段。该文件需单独处理，不可混入通用配置包。
1、在源设备终端执行：qoder cli export-config > cli-backup.yml，生成脱敏备份（密钥字段已加密）。
2、将 cli-backup.yml 通过安全信道传输至目标设备。
3、在目标设备执行：qoder cli import-config --file cli-backup.yml，系统自动解密并写入本地 config.yml。
4、运行 qoder cli status，确认显示 Connected to Qoder Cloud 且 Auth Status: Valid。
五、同步团队协作套件中的 Repo Wiki 与规则集
若使用 Qoder 团队协作套件，Repo Wiki 页面、自定义 lint 规则、代码模板库均托管于云端 Git 仓库。本地仅缓存副本，需强制拉取最新快照以保证多端行为一致。
1、打开 Qoder 设置面板，进入 Team Collaboration 标签页。
2、点击 Sync Repository 按钮旁的下拉箭头，选择 Force Pull Latest。
3、等待进度条完成，观察日志中是否出现 Wiki updated: X pages, Rules reloaded: Y files。
4、在任意项目中右键调出 Qoder 上下文菜单，点击 Show Repo Wiki，确认页面内容与团队主干分支完全一致。
5、新建一个测试文件，触发 Auto-lint，验证所应用的规则编号与团队文档中公布的版本号匹配。
