logseq多端同步需用git实现双向实时更新，迁移则为一次性操作；同步步骤包括gitee建私仓、电脑初始化推送、安卓termux拉取并绑定路径、配置定时自动提交；roam迁移支持json导入或手动转换；本地迁移只需复制图谱文件夹并确保新设备logseq版本不低于旧版。

你想让Logseq里的笔记在电脑、手机之间实时更新，不丢内容、不乱格式，也不依赖厂商服务器——这需要明确区分“同步”和“迁移”两个动作：同步是持续双向流动，迁移是一次性单向搬运。

用Git实现稳定多端同步（推荐国内用户）

第一步：在Gitee创建私有仓库
登录Gitee → 右上角“+”→“新建仓库”→填名称（如logseq-kb）→务必勾选“私有”→初始化选项留空。

第二步：电脑端初始化并首次推送
打开终端，进入你的Logseq图谱文件夹（例如~/Documents/logseq-graph）→执行：git init && git add . && git commit -m "init" →添加远程地址：git remote add origin https://gitee.com/yourname/logseq-kb.git →推送：git push -u origin main。

第三步：安卓手机端拉取并绑定编辑路径
安装Termux →运行pkg install git && git clone https://gitee.com/yourname/logseq-kb.git ~/logseq-sync →打开Logseq安卓版 →设置→“图谱路径”改为/data/data/io.logseq/files/logseq-sync（注意不是Termux的home路径，而是Logseq应用有读写权限的内部目录）。

第四步：配置自动同步（防漏改）
在电脑端添加定时任务：Mac用launchd，Windows用任务计划程序，Linux用crontab，每5分钟执行一次：cd ~/logseq-graph && git add . && git commit -m "auto-sync-$(date +%s)" && git push。【关键前提：所有设备必须使用同一Git用户名和邮箱，否则提交记录会分裂成多个作者】

从Roam Research迁移到Logseq（一次性操作）

方法一：直接导入JSON文件
在Roam Research中进入Settings → Export Graph → 勾选Include attachments → 下载ZIP包 → 解压后得到graph.json → 打开Logseq桌面端 → 左侧“+” → “Import Roam JSON” → 选择该JSON文件 → 等待完成。

方法二：手动拆解后重建（适合大图谱或含特殊块）
用VS Code打开graph.json，检查是否包含大量"blockId"嵌套结构；若存在，先用社区脚本roam-to-logseq-converter预处理为标准Markdown文件夹 → 再在Logseq中新建图谱 → 将转换后的/pages、/journals等文件夹整体复制进新图谱根目录。

注意：Roam导出的双向链接格式为[[page-name#^block-id]]，Logseq仅识别[[page-name]]，块级锚点会丢失，需手动补全或用插件logseq-block-ref-importer修复。

把旧Logseq图谱迁到新设备（无网络时适用）

直接复制整个图谱文件夹即可。Logseq图谱本质就是一个含config.edn、pages/、journals/、logseq/的普通文件夹。找到原图谱所在路径（Windows通常在C:\Users\XXX\AppData\Roaming\Logseq\graphs\XXX，macOS在~/Library/Application Support/Logseq/graphs/XXX），全选复制 → 粘贴到新设备相同层级目录 → 启动Logseq → 左侧“打开图谱” → 选中该文件夹。

这一步操作起来很简单，直接把文件夹拖进去就行。但【必须确保新设备Logseq版本 ≥ 旧设备版本，否则config.edn中的新字段可能被忽略或报错】。