记忆同步

Windows 使用指南

本指南适合已经从管理员获得服务器地址和邀请码的使用者。邀请码只在首次注册时使用；不要把它发到群聊、截图或写进 Markdown 记忆。

开始前

你需要：

  1. Windows 电脑与网络连接。
  2. Python 3.10 或更新版本；安装时勾选 Add Python to PATH。
  3. 管理员给你的服务器地址，例如 https://sync.example.com，以及邀请码。
  4. 一个只保存个人 Markdown 记忆的目录，例如 C:\Users\你的用户名\Documents\memory。不要选择公司代码、聊天导出或含密码的目录。

如果 PowerShell 提示找不到 py，先运行以下命令安装 Python 3.11：

winget install -e --id Python.Python.3.11

若命令显示 Winget 软件源 403 或下载错误，依次运行下面两条命令后重试一次：

winget source reset --force
winget source update

仍失败时，直接从 Python 官方 Windows 下载页 下载 64-bit installer；安装时选择 Add Python to PATH，完成后重新打开 PowerShell。

安装结束后关闭当前 PowerShell、重新打开一个窗口，并确认：

py --version

第一次安装与注册

推荐：安装 Agent Skill（无需自制 EXE 或翻墙）

从正式服务下载 Windows 记忆同步 Skill，将压缩包里的 memory-sync 文件夹解压到以下任一目录：

  • Codex：%USERPROFILE%\.codex\skills\memory-sync
  • DSH：%USERPROFILE%\.dsh\skills\memory-sync

Skill 内含客户端源码以及 Python 3.10–3.14 的 Windows 离线依赖，不包含自制 EXE。它只使用设备上已经安装且获白名单批准的 Python，日常使用只连接阿里云杭州的 sync.chuanpiao.ltd，不访问 GitHub 或 PyPI，也不需要代理。若设备没有获批准的 Python，需要先让管理员安装或加入白名单；Skill 不会绕过企业应用管控。安装后重启或新建 Agent 会话，然后让 Agent“使用 memory-sync Skill 同步我的记忆”。

备选：使用 Python 安装

  1. 打开 PowerShell，直接从正式服务安装客户端。无需手动下载、解压或删除旧 ZIP；以后更新也运行同一条命令：
py -m pip install --upgrade --force-reinstall "https://sync.chuanpiao.ltd/downloads/memory-sync-windows.zip"
  1. 确认安装成功：
py -m memory_sync_client.cli --help
  1. 注册账号和这台设备。以下命令会在终端中安全地要求你输入密码；不要添加 --password：
py -m memory_sync_client.cli register --server "https://sync.example.com" --email "you@example.com" --display-name "你的名字" --invite-code "管理员给你的邀请码"

如果你已经下载过旧 ZIP 或解压过旧目录，可以保留它们；上述安装和更新命令不依赖这些旧文件。

将示例服务器地址、邮箱和邀请码替换为自己的真实值。成功后，本机配置保存于 %APPDATA%\memory-sync\config.json；其中含登录凭据和设备私钥，不要复制给别人。

每天怎么同步

py -m memory_sync_client.cli sync --sync-root "C:\Users\你的用户名\Documents\memory"

成功时会显示拉取与推送的数量。第一次同步前，建议先备份该目录一次。

两台电脑怎么用

在第二台电脑重复“第一次安装与注册”，但使用同一账号登录：

py -m memory_sync_client.cli login --server "https://sync.example.com" --email "you@example.com"
py -m memory_sync_client.cli sync --sync-root "C:\Users\你的用户名\Documents\memory"

每台电脑都会登记为独立设备；不需要、也不应该复制第一台电脑的配置文件。

可选：定时同步

daemon 需要下载包包含该子命令。若运行 py -m memory_sync_client.cli --help 时没有看到 daemon，说明官网仍在提供旧包；先使用“每天怎么同步”中的手动命令，不要执行本节命令，并请管理员更新官网部署。

以下命令每 5 分钟同步一次，并且会一直占用当前终端。保持窗口打开；要停止时按 Ctrl+C。

py -m memory_sync_client.cli daemon start --sync-root "C:\Users\你的用户名\Documents\memory" --interval 300

py -m memory_sync_client.cli status
py -m memory_sync_client.cli daemon status

冲突、离线与常见问题

  • 冲突： 两处同时改同一个文件时，命令会报告 conflict；请到 <记忆目录>\conflicts\ 查看服务端副本，再手动合并。原本地文件不会被覆盖。
  • 离线： 断网时照常编辑；联网后再次运行 py -m memory_sync_client.cli sync。
  • 登录失效： 运行 py -m memory_sync_client.cli login --server "服务器地址" --email "你的邮箱"，然后按提示输入密码。
  • 提示找不到 py： 运行 winget install -e --id Python.Python.3.11。若 Winget 报 403，先执行 winget source reset --force 和 winget source update；仍失败则使用 Python 官方 Windows 安装器。
  • 提示找不到 memory-sync： 不必修改 PATH，统一改用本文的 py -m memory_sync_client.cli ... 命令。
  • 只同步 Markdown： 隐藏目录、conflicts 目录和非 .md 文件都会被忽略。