Windows 配置迁移到 Mac 完整指南 实现跨平台无缝同步

当您需要将Qoder数字员工的完整工作环境从Windows系统迁移至macOS平台时，可能会遇到配置路径不匹配、会话状态中断、事件监听失效或权限策略错位等问题。这通常源于两大操作系统在文件路径规范、后台服务机制及本地存储策略上的底层差异。遵循本指南提供的系统化步骤，您可以实现Windows到Mac的无缝、精准配置同步，确保数字员工工作的连续性与一致性。

一、统一长期记忆与身份存储路径

Qoder依赖本地文件系统来持久化保存数字员工的长期身份信息与上下文记忆。默认存储位置因系统而异：Windows通常为C:\Users\{用户名}\AppData\Roaming\qoder\memory，而macOS则为/Users/{用户名}/Library/Application Support/qoder/memory。若未预先统一路径，跨平台后将创建独立的记忆库，导致工作上下文断裂与身份重置。

首先，在Windows计算机上，使用文本编辑器打开Qoder安装目录下的config.yaml配置文件。

定位到memory.storage.path配置项，将其值修改为一个可被网络访问的共享路径。例如，可设置为SMB共享路径\\nas-server\qoder\memory，或支持HTTPS协议的远程存储地址https://your-storage.com/qoder/memory。

随后，在Mac电脑上，以相同方式编辑其config.yaml文件，确保memory.storage.path的值与Windows端设置的路径完全相同。

最后，请务必在两端设备上，将配置项memory.cache.enabled设置为false，并确认您所使用的网络附加存储（NAS）或云存储服务已授予正确的读写权限。

二、强制拉齐运行时会话状态

Qoder的会话（Session）账本负责实现崩溃恢复与任务续执行功能，其状态文件session-state.json是保障跨平台连续性的核心。利用Qoder命令行工具（CLI）原生支持的导出与导入功能，可以可靠地同步此状态，且不依赖特定运行时环境。

第一步，在Windows端，以管理员身份启动PowerShell，执行命令：qoder-cli session export --to \\nas-server\qoder\session-state.json。

第二步，在Mac端，挂载相同的网络共享路径（例如/Volumes/nas-server），然后执行命令：qoder-cli session import --from /Volumes/nas-server/qoder/session-state.json。

完成上述操作后，建议在两端分别运行：qoder-cli status --verbose。仔细核对输出信息中的session_id（会话ID）、last_active_at（最后活动时间）及context_hash（上下文哈希值）三个关键字段，确保其完全一致。

三、适配事件触发器注册机制

事件触发器的后台注册机制存在平台级差异：Windows依赖于Windows Service，而macOS则使用launchd服务管理框架（通过plist文件配置）。两者的注册表结构与生命周期管理方式互不兼容，直接迁移将导致事件监听失效。

首先，在Windows端执行命令：qoder-cli trigger list --export > windows-triggers.json，导出所有已注册触发器的元数据定义文件。

接着，在Mac端，需要创建LaunchAgent配置文件：~/Library/LaunchAgents/io.qoder.events.plist。请根据launchd规范格式，重新编写触发器逻辑。关键在于，配置中的ProgramArguments数组需指向qoder-cli trigger exec命令，并传入对应的触发器ID参数。

文件创建后，执行：launchctl load ~/Library/LaunchAgents/io.qoder.events.plist以加载服务。最后，运行launchctl list | grep qoder进行验证，若看到相关进程状态显示为“running”即表示成功。

四、校验并迁移沙盒权限策略

权限策略的同步同样至关重要。Qoder在Windows上通过访问控制列表（ACL）管理插件调用权限，而在macOS上，相同的安全隔离效果是通过sandbox-exec和权利（entitlements）文件实现的。若策略未同步，部分Skill（技能）可能会因权限不足而静默失败。

操作流程简明：首先，在Windows系统中，进入Qoder安装目录下的policy子文件夹，将其内所有*.yaml策略文件复制到前述的网络共享路径中。

然后，在Mac系统上，将这些文件覆盖至目标目录：~/Library/Application Support/qoder/policy/。覆盖完成后，务必执行：qoder-cli policy reload，以强制刷新运行时策略缓存。

为求稳妥，可进一步运行：qoder-cli skill inspect {技能名称}，检查输出结果中granted_permissions（已授予权限）字段，确认其与Windows端的配置完全匹配。

五、启用 Qoder 1.0 云同步开关

事实上，Qoder 1.0版本内置了云端同步模块，能够自动对齐身份（Identity）、记忆（Memory）、会话（Session）、策略（Policy）及触发器（Trigger）这五大核心配置。但此功能需预先完成账户登录并手动开启，否则仍需依赖上述手动步骤。

首先，请在Windows与Mac两端均执行：qoder-cli auth login --email 您的邮箱地址，完成账户绑定认证。

然后，在任意一端执行：qoder-cli cloud enable，即可启用云端同步服务。

最后，执行：qoder-cli cloud status进行状态确认。若看到sync_state显示为active（活跃），且last_sync_time（最后同步时间）为近期时间戳，即表示跨平台配置同步已成功建立。