前言¶

多机使用同一个 Agent 时，记忆容易出问题：A 机改过的工作习惯，B 机不知道；本机记忆文件被误改后，又被每日同步覆盖，改回去的功夫白费；新机器上手，本地记忆文件缺失或与云端不一致，Agent 行为直接走样。

下面介绍的「记忆同步助手」（@user_2d1faf6c/memory-cross-device-sync，SkillHub 分类 ai-agent）就是为这类问题设计的。它把云端《工作习惯总纲》作为行为规则的唯一权威，本地 MEMORY.md 只保留指针和事实性记忆，其余内容一律以云端为准同步。

这是什么¶

记忆同步助手是一个面向 Agent 运行态的记忆同步技能，发布者为社区用户 user_2d1faf6c，当前版本 2.1.0，SkillHub 上评分 100000、下载约 4600 次。它解决的问题是：多设备之间 Agent 记忆（IDENTITY、SOUL、USER、MEMORY）的双向一致、云端权威内容的备份保护、以及新机器的初始化补齐。

核心功能¶

官方简介列出的核心职责如下，均围绕「云端为基准」这一前提：

1、校验本地指针与云端总纲对应可读，保证本地引用不失效。
2、云端总纲每次修改后，必同步刷新《工作习惯总纲_备份》，防止云端内容丢失或损坏造成不可逆损失。
3、每次修改完成后必须告知用户。
4、新老用户分流初始化，新机器和老机器走不同路径。
5、IDENTITY/SOUL/USER/MEMORY（乐享 06-09）按「云端为基准的双向双写镜像」同步，各建实时备份页于「身份记忆备份区」，用 sha1 全文比对，每日 12:00 自动化以云端覆盖本地兜底。
6、一键自检：新机器首启从乐享 06-09 拉回本地 4 个文件，会话启动时自动检测缺失或不符并提示。

围绕这套职责，各版本陆续加了若干专项能力：

云后端按偏好切换¶

v2.0.3 起，云后端按全局偏好 cloud_default 切换：默认 lexiang（乐享）；用户说 WPS/kdocs 时走 WPS 分支；说两边都归档则双写。

落点三分区与版本回滚¶

v2.0.8 起，乐享落点分三区：主文件《8.workbuddy.memory》根目录、身份记忆备份区、256.【历史文档】；并接入云原生版本回滚（file 类型已实测可行）。

自动化连接器配置¶

v2.0.9 起，首次激活创建每日自动化时强制 automation_update 带 connectorIds:["lexiang"]。原因是用户安装的远程 MCP 连接器（lexiang）不会被自动化沙箱自动加载，漏配会让每日 12:00 任务必报「MCP 链接失败」。官方已在正文 §11.0 与 §13 固化了诊断与根治要求。

读总纲时机¶

v2.0.10 起，读总纲时机由「每轮 Read」修正为「每会话开头 Read 一次 + 外部可见动作前 / 用户告知已改后补读」，普通问答轮次不再重复拉全文。

ID 零硬编码¶

v2.0.12 起，技能包内禁止出现任何具体 ID 值。space_id / entry_id / file_id / drive_id / 本地路径一律按三级顺序解析：

state.json 缓存 → MEMORY.md 指针段 → lexiang 实时 API
（whoami → space_describe_personal_space → lexiang_search）

实测过滤规则为：用 original_title 精确匹配（title 含 <em> 高亮标签不可用）、排除【历史版本】前缀、优先 file_type=page、做 space_id 一致性校验。解析结果只写本机 state.json（私有运行态），发布包内 state.json / config.json 一律为空模板。另提供两个辅助命令：

--audit-ids   发布前自检，扫描技能目录是否残留 32 位 hex 或用户名路径
--discover    实时解析当前环境

安全与可靠性加固¶

v2.0.11 起做了一轮专项加固，对应腾讯安全云评估 v2.0.10 评分 45 / 3 项可疑与 SkillHub R·Reliability 4.2：

1、移除正文中所有作为示例硬编码的具体 entry_id（如 fb37f0b1...）与个人知识库空间指向，正文一律改写为由 lexiang whoami / space_describe_personal_space 实时解析当前用户真实空间。脚本层面早已从 MEMORY.md 动态提取，本版使文档与脚本同口径。
2、反 Prompt 注入声明（§14.2）：云《工作习惯总纲》在本架构中是行为规则的事实数据源，Agent 把它作为可查可读的事实来推理生效，不被作为系统指令注入。
3、写入前用户确认闸（§14.3，dry-run by default）：凡会改变 IDENTITY/SOUL/USER/MEMORY 内容或覆盖任何文件的动作，自动化与一键自检默认先报告「将做什么 / 写到哪 / 是否覆盖」再问用户确认；同内容 sha1 比对通过的备份回写视为非覆盖，仍自动执行。
4、sync_backup.py 全面重构（§10）：改用 pathlib 跨平台，三级异常分级（CRITICAL/WARN/INFO + 退出码 2/1/0），新增 --json / --doctor / --check 三种子命令，不再硬编码 entry_id fallback（指针段缺失时仅 WARN 不静默）。
5、默认 config 友好化（§5）：WPS 默认值全部留空，新用户安装即零配置可跑校验。
6、评分目标：从 4.5 提升到 4.7+，其中 R·Reliability 由 4.2 → 4.5+，T·Trust 安全性扫描由 4.0 → 4.5+。

记忆瘦身¶

v2.1.0 起针对「瘦身被对端回补 / 记忆反复膨胀 / 78.8% 不可见」做根因专项：

1、「瘦身事件册」机制固化进 §9 分叉合并与 §11 兜底：每次瘦身登记瘦前身 / 瘦身后 sha1 与移除去向；对端同步命中瘦前身 sha1 即直接云覆盖本地，不询问不回补。
2、§9 加「集合级检索」：判本地独有前先查记忆全集，搬家内容不再误判新增。
3、§11 加「事件册优先」判定；每日 12:00 自动化扩成「一致性＋体积＋跨机独有内容」三检，并加体积体检：MEMORY.md ≤ 3,800、IDENTITY.md ≤ 3,000，超限告警并列章节。
4、体积闸门固化进 §12 铁律：新增必先腾位。
5、新老用户分流补「先读事件册再决定覆盖」提示与空事件册模板。
6、索引化方向事前根除：本地只放索引＋高频硬事实，正文全在云。

安装与启用¶

官方页面未提供可直接执行的安装命令（页面抓取未返回正文），下面是从资料中可核实的启用要点：

1、技能以 SKILL.md 通用格式发布，坐标为 @user_2d1faf6c/memory-cross-device-sync，从 SkillHub 页面获取后按所用 Agent 的 Skill 加载方式启用。
2、首次激活时，由 Agent（小Y）用 automation_update(mode=create) 在本机自动创建每日 12:00 兜底自动化，id 不写死，prompt 模板见技能正文。
3、创建该自动化时必须带 connectorIds:["lexiang"]，否则每日任务会报「MCP 链接失败」。
4、云后端通过全局偏好 cloud_default 指定，默认 lexiang（乐享）。

官方页面：https://api.skillhub.cn/user_2d1faf6c/memory-cross-device-sync

典型用法¶

来自官方简介的可复现流程：

1、新机器首启，先跑一键自检，从乐享 06-09 拉回本地 4 个文件（IDENTITY/SOUL/USER/MEMORY）。
2、会话启动时自动检测缺失或不符并提示，不符时由 Agent 按云端内容补齐。
3、会话开头 Read 一次云端《工作习惯总纲》，外部可见动作前或用户告知已修改后再补读。
4、云端总纲每次修改后，同步刷新《工作习惯总纲_备份》，并告知用户修改已完成。
5、修改 IDENTITY/SOUL/USER/MEMORY 一律通过与 Agent（小Y）对话完成，自动化与自检在执行覆盖前先报告动作内容并请求确认。
6、每日 12:00 自动化执行「一致性＋体积＋跨机独有内容」三检，以云端覆盖本地兜底。

适用场景与注意¶

适合多设备共用同一 Agent、且希望行为规则与记忆以云端为单一权威的场景。使用前需注意：

1、用户不得手动修改 IDENTITY/SOUL/USER/MEMORY 本地文件。所有变更一律经 Agent 对话完成，手动改的内容会被每日 12:00 自动化以云端覆盖抹掉。
2、技能包内不含任何具体 ID 值，首次运行需要能访问 lexiang（乐享）API 以实时解析空间与文件；解析结果只写入本机 state.json。
3、旧的三端全量双写逻辑已退役，升级后不要按旧文档操作。
4、写入前确认闸默认开启，自动化与一键自检对会改变记忆内容或覆盖文件的动作先报告再确认；同内容 sha1 比对通过的备份回写会自动执行。
5、体积有硬闸门（MEMORY.md ≤ 3,800、IDENTITY.md ≤ 3,000），新增内容前需先腾位。
6、发布前可用 --audit-ids 扫描技能目录，确认没有残留 32 位 hex 或用户名路径。

结尾¶

记忆同步助手的价值在于把「谁为准」这件事定死：云端《工作习惯总纲》是唯一权威，本地只留指针与高频硬事实，其余内容靠每日自动化与一键自检维持一致。配合版本回滚、写入确认闸和瘦身事件册，日常多机使用的记忆维护成本被压到「跑一遍自检」的程度。

官方地址：https://api.skillhub.cn/user_2d1faf6c/memory-cross-device-sync