扩展同步这件事情，看似简单，但如果某一步操作没做到位，换设备时就会非常头疼——插件列表消失、配置参数丢失、绑定关系也无影无踪。如果你在QoderWake中反复尝试后，发现扩展状态和设置仍未自动恢复，那多半是因为同步机制没有激活，或者账号绑定存在问题。别着急，下面这套完整操作指南，能帮你一步步排查并解决问题。
前提是：必须使用同一个阿里云主账号登录所有设备，并且手动开启扩展同步开关。仅仅登录还不够，还需要手动触发一次全量同步，最后验证授权和功能是否真正闭环。
一、确保使用同一阿里云主账号登录所有设备
QoderWake 的扩展同步依赖于阿里云主账号作为身份锚定。所有扩展的启用状态、配置参数和绑定关系，都是通过该账号在云端进行持久化存储。如果你使用了子账号、临时邮箱或未经认证的账号，扩展元数据将无法触发同步。
具体操作分为三步：
1、先在旧设备上打开QoderWake，点击右上角头像进入账户中心。确认页面上显示的是“阿里云主账号”标识，并且带有实名认证状态图标。这一步很容易被忽略，但却是最关键的一步。
2、在新设备上安装最新版本的QoderWake后，切记：必须退出当前会话，然后点击“切换账号”。手动输入与旧设备完全一致的阿里云手机号或邮箱。这里有个注意事项——不要为了省事使用扫码快捷登录，那很可能降级为子账号，导致同步失败。
3、登录成功后，进入设置页找到「账户与同步」，检查是否显示“已绑定：阿里云主账号（尾号XXXX）”，同时下方的同步状态栏不能出现感叹号警告。如果提示异常，请先暂停操作，回头检查账号是否一致。
二、开启扩展同步开关并校验同步范围
很多人以为登录之后就万事大吉了——其实不然。QoderWake 默认只同步核心配置，扩展相关数据需要在同步策略中显式开启。否则，插件列表、启用开关、自定义配置项（比如GitHub仓库白名单、Slack Webhook URL等），都不会被迁移。
操作路径：
1、进入「设置」→「账户与同步」，点击「管理同步项目」。
2、在弹出的面板中，向下滚动到「高级同步项」区域。找到三个关键项目：扩展启用状态、扩展配置参数、扩展绑定关系，确保它们右侧的滑块均为蓝色开启状态。这三项缺一不可。
3、特别留意一点：如果你曾经手动修改过某个扩展的JSON配置文件（比如settings.json中的"qoder-connector.github"字段），那么一定要确认该字段所属的扩展在同步项中已被选中，否则配置值在同步时会丢失，一切努力都白费。
三、手动触发全量扩展同步并验证加载结果
扩展同步属于高优先级的结构化数据同步，但云端快照更新存在缓存延迟。自动轮询周期最长可能达到10分钟，因此必须强制刷新一次，才能确保最新状态立即生效。
具体做法如下：
1、在任意已登录设备的「账户与同步」页面，点击立即同步所有状态这个按钮——注意，不是“同步设置”或“同步主题”等子项按钮，必须是这个按钮。
2、等待进度条跑完，观察提示文字。如果显示的是“同步成功：扩展配置、启用状态、绑定关系已更新”，那就代表操作正确。如果只显示“用户设置同步完成”，则说明扩展数据没有同步上，需要重新排查。
3、同步完成后，重启QoderWake。然后进入「扩展中心」页面下拉刷新，检查之前安装的所有扩展（包括Qoder Connector、Qoder Bridge、Notion Sync等）是否都显示为已启用状态。同时，右下角状态栏中，对应的扩展图标旁边应出现绿色对勾标记。
四、修复扩展配置错位问题
有些扩展，比如GitHub Connector、Slack Integration，它们依赖本地加密凭证和云端令牌的双向绑定。如果在同步时旧设备尚未完成首次授权，或者新设备网络环境受限，就可能导致配置字段为空或校验失败。
修复步骤：
1、在新设备的扩展中心，找到出现问题的扩展，点击右侧的「设置」齿轮图标，进入配置页。
2、检查关键字段是否为空：GitHub扩展应显示“已连接 · 组织名”，Slack扩展应显示“Webhook 已验证”，Notion扩展应显示“Database 已同步”。如果某个字段是空的，说明存在问题。
3、哪个字段为空，就点击对应的重新授权按钮。系统会自动跳转到对应平台的OAuth流程。授权完成后，返回QoderWake扩展页，确认状态栏更新为绿色就绪标识。
五、验证扩展功能闭环是否完整
同步完成并不代表功能完全可用。需要实际测试扩展与外部系统的联动链路是否畅通，否则可能因权限沙盒隔离或API密钥过期导致静默失效——你甚至不知道问题出在哪里。
建议进行三个简单的功能验证：
1、在GitHub仓库发起一次Pull Request，等待约30秒，观察QoderWake右下角是否弹出“PR 已就绪 · 触发代码评审”的通知。弹出即表示GitHub扩展正常工作。
2、在Slack的绑定频道中发送消息“/qoder status”，查看能否收到结构化的响应卡片，卡片内应包含当前数字员工运行状态和最近任务摘要。
3、在Notion Database中新增一条测试记录，然后在QoderWake控制台执行一次记忆归档操作。检查Notion页面是否在2分钟内自动追加了新条目，并且字段值与原始执行摘要一致。
```