Qoder跨平台同步需五步：统一memory.storage.path为网络路径并禁用本地缓存；用qoder-cli export/import session-state.json拉齐会话；重写Windows Service为Mac launchd plist注册事件；同步policy.yaml并reload策略；登录账户启用Qoder 1.0云同步开关。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用 Qoder 数字员工，并希望将 Windows 环境下的全部配置、状态与权限策略无缝迁移到 Mac 平台，但发现记忆路径不一致、会话无法续接、事件触发器失效或沙盒权限错位，则可能是由于系统路径规范、服务注册机制及本地存储策略存在根本性差异所致。以下是实现配置完美同步的具体操作步骤：
一、统一长期记忆与身份存储路径
Qoder 依赖本地文件系统持久化长期身份与上下文记忆，默认路径在 Windows 为 C:Users{user}AppDataRoamingqodermemory，而在 Mac 为 /Users/{user}/Library/Application Support/qoder/memory。若未显式指定统一路径，跨平台后将生成孤立记忆库，导致上下文断裂与身份重置。
1、在 Windows 系统中，使用文本编辑器打开 Qoder 安装目录下的 config.yaml 文件。
2、定位到 memory.storage.path 字段，将其值修改为网络可访问路径，例如 \nasqodermemory（SMB 共享）或 https://storage.example.com/qoder/memory（HTTPS 后端）。
3、在 Mac 系统中，以相同方式编辑同一位置的 config.yaml，确保 memory.storage.path 值与 Windows 完全一致。
4、在两台设备上均将 memory.cache.enabled 设为 false，并验证 NAS 或远程存储服务已开放读写权限。
二、强制拉齐运行时会话状态
Qoder 的 Session 账本用于崩溃恢复与任务续执行，其状态文件 session-state.json 是跨平台同步的核心载体。Windows 与 Mac 上的 CLI 工具可原生导出/导入该文件，且不依赖运行时环境，是唯一可靠的状态对齐手段。
1、在 Windows 系统中，以管理员权限启动 PowerShell，执行：qoder-cli session export --to \nasqodersession-state.json。
2、在 Mac 系统中，挂载同一 NAS 路径（如 /Volumes/nas），执行：qoder-cli session import --from /Volumes/nas/qoder/session-state.json。
3、分别在两台机器上运行：qoder-cli status --verbose，确认 session_id、last_active_at 与 context_hash 三项输出完全一致。
三、适配事件触发器注册机制
Windows 使用 Windows Service 注册后台事件监听器（如邮件新收、工单创建），而 Mac 依赖 launchd plist 配置。二者注册表结构与生命周期管理互不兼容，直接迁移会导致事件丢失。
1、在 Windows 端，执行：qoder-cli trigger list --export > windows-triggers.json，导出当前所有已注册触发器元数据。
2、在 Mac 端，新建 ~/Library/LaunchAgents/io.qoder.events.plist，按 launchd 格式重写触发逻辑，其中 ProgramArguments 指向 qoder-cli trigger exec 并传入对应 ID。
3、执行：launchctl load ~/Library/LaunchAgents/io.qoder.events.plist 加载服务，并运行 launchctl list | grep qoder 验证进程状态为 running。
四、校验并迁移沙盒权限策略
Qoder 在 Windows 上通过 ACL（Access Control List）控制插件调用权限，在 Mac 上则依赖 sandbox-exec 与 entitlements.plist 实现等效隔离。若未同步策略文件，部分 Skill 将因权限拒绝而静默失败。
1、在 Windows 系统中，进入 Qoder 安装目录的 policy 子目录，复制全部 *.yaml 文件至共享路径。
2、在 Mac 系统中，将这些文件覆盖至 ~/Library/Application Support/qoder/policy/ 目录，并执行：qoder-cli policy reload 强制刷新策略缓存。
3、运行：qoder-cli skill inspect {skill-name}，检查输出中 granted_permissions 字段是否与 Windows 端完全匹配。
五、启用 Qoder 1.0 云同步开关
Qoder 1.0 版本内置云同步模块，可自动拉齐 identity、memory、session、policy、trigger 五类核心参数。该功能需显式登录账户并开启开关，否则仅依赖手动同步步骤。
1、在 Windows 与 Mac 两端均执行：qoder-cli auth login --email your@domain.com，完成账户绑定。
2、在任一平台执行：qoder-cli cloud enable，启用云同步服务。
3、执行：qoder-cli cloud status，确认 sync_state 显示为 active，且 last_sync_time 为最近时间戳。
