使用教程

01 / 安装与升级

1. Windows 运行安装程序；Android 安装 APK；Debian / Ubuntu 打开 deb 包安装。
2. 首次启动设置主密码，创建记忆库。妥善保存主密码，恢复备份时需要使用。
3. Windows 可勾选“下次自动解锁”，或在设置中开启“启动时自动解锁”。
4. 应用内按 Ctrl + Shift + L 锁定；启用设备解锁后，在锁定页按同一快捷键打开。
5. 升级前导出加密备份、关闭程序，再安装新版。

02 / 记下一条，再看变更

在首页输入：“我的 Acme 主账号用 [email protected] 注册，用日本备用号码找回。”点击“整理预览”，检查记忆、属性和关联，再点击保存。

03 / 选择整理方式

• Windows 本地模型：设置 → 模型，选择模型并下载。
• Ollama：填写本地地址和模型名，先测试连接。
• 自带 API Key：填写兼容接口、模型和 Key。供应商直接向你计费。
• 官网账户：设置 → 官网账户 → 登录，在浏览器中登录并核对设备码，批准后返回应用。

04 / 备份与恢复

设置 → 记忆与备份 → 导出加密备份，保存到其他磁盘。恢复前先备份当前数据，再选择“恢复备份”，打开备份文件并输入它的主密码。

需要分享部分数据时，选择“脱敏导出”。完整备份请选择“导出加密备份”。

05 / 浏览器扩展

Windows 安装目录有 extension 文件夹。打开 chrome://extensions 或 edge://extensions，启用开发者模式 → 加载已解压扩展 → 选择 extension。打开并解锁络笺，在网页中点击“加入络笺”，选择登录身份。

06 / GitHub 私密备份

1. 打开备份模板。创建自己的新仓库，可见性选择 Private，再 clone 到本机。
2. 安装 Git 和 GitHub CLI，执行 gh auth login。
3. 桌面设置 → 记忆与备份 → 导出加密备份。打开私密仓库文件夹中的终端，执行下方命令，把路径换成刚导出的文件。

powershell -NoProfile -ExecutionPolicy Bypass -File .\backup.ps1 -Backup "C:\Users\YourName\Downloads\atlas-encrypted-backup.json"

每次导出新的备份后，运行这条命令上传。

恢复前先备份当前数据。运行 restore.ps1，或下载 vault/latest.atlas-backup.json，在软件里恢复并输入原主密码。

07 / 多端同步

1. 设置 → 同步 → 自建服务器，填写域名或 https://IP:端口，点击“保存并同步”。
2. 在打开的浏览器中登录服务器，核对设备码并允许连接，然后回到软件。
3. 另一台设备也连接同一地址。若提示另一份记忆库，选择“导入远端记忆库”，输入它的主密码。

用自己的网盘：选择“网盘 / WebDAV”，填写文件夹地址、用户名和应用密码。

保持“自动同步”开启。应用打开、回到前台或恢复网络时自动同步；冲突时选择保留本机或远端。

电脑在“设置 → 同步”点击“浏览器打开”，进入 localhost:5011；Linux 独立网页版解压后运行 ./relakeep-web，打开终端给出的链接。

08 / 自建服务器

下载 Docker 部署包并解压；服务器安装 Node.js 24 和 Docker Compose。域名指向服务器，开放 80/443 端口，然后执行：

node scripts/init-selfhost.mjs selfhost.env https://atlas.example.com
docker compose -f compose.yaml -f compose.https.yaml up -d --build

打开自己的域名，使用 selfhost.env 中的 RELAKEEP_SETUP_TOKEN 创建登录账户，再创建或导入记忆库。

网页“设置 → 服务器登录”可开启验证器两步验证、添加通行密钥、选择是否记录登录环境，以及退出已连接设备。保存好两步验证的恢复码。

IP 连接请先配置设备信任的 HTTPS 证书；通行密钥使用 HTTPS 域名。网页版会在自己的服务器解密记忆库。