MemoFlow

简体中文

English

简体中文

English

Appearance

Obsidian 同步组件（OB） ​

1. 这是什么 ​

MemoFlow 同步桥用于把 MemoFlow 本地库内容同步到 Obsidian。
当前实现是局域网本地模式，通过 Obsidian 插件暴露本地桥接接口。

插件目前还未上架 Obsidian 社区市场，需要手动安装。
插件仓库：https://github.com/hzc073/memoflow_obsidian_plugin

2. 入口 ​

设置 -> 组件 -> MemoFlow 同步桥

在该页面可完成：

  • 扫码配对
  • mDNS 发现
  • 手动输入 Host / Port / Pair Code 配对
  • 健康检查
  • 启用/关闭同步桥

3. Obsidian 插件安装（手动） ​

  1. 打开你的 Obsidian Vault 目录。
  2. 创建插件目录：.obsidian/plugins/memoflow-sync-bridge/。
  3. 从仓库 memoflow_obsidian_plugin 拷贝至少这两个文件到目录中：
    • main.js
    • manifest.json
  4. 在 Obsidian 中进入 Settings -> Community plugins，打开该插件。

说明：

  • 插件是 desktop-only（桌面端插件）。
  • 插件默认端口是 3000，可在插件设置中修改。

4. 配对流程（推荐） ​

方案 A：扫码配对（移动端推荐） ​

  1. 在 Obsidian 插件中显示配对二维码。
  2. 在 MemoFlow 的同步桥页面点击“扫码配对”。
  3. 扫码后会调用 /bridge/v1/pair/confirm 获取 token 并保存。

方案 B：mDNS 发现 + 手动输入 ​

  1. 点击“mDNS 发现”，选择发现到的服务。
  2. 输入配对码（Obsidian 插件页面可复制）。
  3. 点击“确认配对”。

方案 C：纯手动输入 ​

直接填写 Host、Port、Pair Code 后确认配对。

5. 配对后的同步 ​

你有两种常用方式：

  1. 在 同步队列 页面点击“同步到 Obsidian”：
    • 会把当前本地库 memo（含附件）批量推送到已配对 Obsidian。
  2. 正常使用本地同步流程：
    • 在桥已启用且已配对时，客户端会尝试把 memo 上传到桥接接口 /bridge/v1/memo/upload。

6. 常见问题 ​

找不到服务 / 无法配对 ​

  • 确认手机和电脑在同一局域网。
  • 防火墙未拦截 Obsidian 插件端口（默认 3000）。
  • 配对码过期（默认有效期 120 秒）后需重新生成。

健康检查失败 ​

  • 配对成功后先点“健康检查”验证 /bridge/v1/health。
  • 若失败，优先检查 Host/Port 是否变化、插件是否已启用。

扫码不可用 ​

  • 当前扫码仅支持 Android / iOS。
  • 其他平台请改用手动配对（Host + Port + Pair Code）。

相关文档 ​