工作方式
-
本地编辑
在任意设备的 Markdown 记忆文件中记录内容,编辑不要求联网,离线也可以进行。
-
执行同步
运行 memory-sync sync,客户端先拉取服务器事件,再推送本地变更,重复执行结果一致。
-
冲突保留
同一文件在两端同时修改时,服务器副本保存到 conflicts 目录,本地文件不会被覆盖。
安全
- 设备密钥
- 每台设备生成独立的 Ed25519 密钥对,公钥登记到账户。
- 请求签名
- 每次同步请求携带设备 ID、时间戳、随机数和签名,服务端校验签名,拒绝过期与篡改的请求。
- 本地配置
- 令牌与密钥保存在当前用户目录的配置文件,Windows 上通过 ACL 限制为仅当前用户可读。
- 账户隔离
- 账户与设备相互隔离,各账户的同步空间彼此独立。
文档
快速开始,三步完成首次同步。
-
安装或更新客户端
Windows 需要 Python 3.10 或更高版本。在 PowerShell 运行下面一条命令即可安装或覆盖更新,无需下载、解压或删除旧 ZIP。
py -m pip install --upgrade --force-reinstall "https://sync.chuanpiao.ltd/downloads/memory-sync-windows.zip" py -m memory_sync_client.cli --help -
登录并登记设备
新账户使用 register 命令,已有账户改用 login 命令。首次执行会自动生成设备密钥并登记设备。
py -m memory_sync_client.cli register --server https://sync.chuanpiao.ltd --email <你的邮箱> --display-name <昵称> --invite-code <邀请码> -
开始同步
先查看本地状态,再指定记忆目录执行同步。
py -m memory_sync_client.cli status py -m memory_sync_client.cli sync --sync-root C:\Users\<你>\Memory遇到冲突时,sync 命令返回非零退出码,服务器副本保留在同步目录的 conflicts 文件夹。
需要更完整的安装、部署和运维说明?前往 官网文档中心。
下载客户端
目前提供 Windows 客户端,其他平台正在规划中。
Agent Skill(推荐)
纯源码 Skill,不包含自制 EXE。使用设备上已获批准的 Python,并内置离线依赖;不访问 GitHub、PyPI,也不需要翻墙。
SHA-256: 58fccdb1a5192f641071f96264a237baa1167d3bda75a322e56566e0211e69b4
Windows 客户端
源码包 ZIP,包含客户端与测试。推荐复制上方命令直接安装或更新;这里也保留手动下载入口。
SHA-256: 4ef1569f4b636ae321d916edecb67b2f713106d69bc74083dc3ca901b7b176b9