Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Obsidian Memos Sync

Obsidian Memos Sync 是一款旨在连接 Memos (一款轻量级、自托管的碎片化知识管理工具) 与 Obsidian 的插件。

它可以一键将你在 Memos 中记录的当天的碎片化想法、日记和图片,按照你喜欢的格式同步到 Obsidian 的 Daily Note (日记) 中。

✨ 核心特性

  • 一键同步:快速获取当天的 Memos 记录。

  • 去重更新 (Block Mode):采用标记区块 (<!-- Memos Start -->) 方式写入。多次点击同步只会更新内容,不会导致内容重复堆叠。

  • 高度可定制模板:支持自定义标题和每条 Memo 的格式,提供丰富的时间和元数据变量。

  • 图片鉴权修复:自动为 Memos 的私有图片链接追加 Token,解决 Obsidian 中图片无法加载 (403 Forbidden) 的问题。

  • 独立运行:不依赖第三方日记插件,直接配置路径和日期格式即可精准定位目标文件。

  • 广泛兼容:兼容 Memos 新旧版本 API (v0.1x - v0.22+)。

⚙️ 安装方法

手动安装

  1. 下载本插件的 Release 版本(main.js, manifest.json, styles.css)。

  2. 在你的 Obsidian 仓库中,进入 .obsidian/plugins/ 目录。

  3. 新建文件夹 obsidian-memos-sync。

  4. 将下载的文件放入该文件夹。

  5. 重启 Obsidian,在“第三方插件”中启用 Memos Sync。

使用 BRAT 安装 (推荐测试用)

如果你安装了 Obsidian42 - BRAT 插件:

  1. 打开 BRAT 设置。

  2. 点击 "Add Beta plugin"。

  3. 输入本仓库的 GitHub 地址。

  4. 点击 "Add Plugin"。

🛠 配置指南

启用插件后,请在设置页面进行如下配置:

1. 服务器配置

  • Memos Host URL: 你的 Memos 服务器地址。

    • 示例: https://memos.example.com (末尾无需 /api/v1)
  • Access Token: 在 Memos 网页端 -> 设置 -> 个人 -> Access Token 中获取。

2. Daily Note 设置

无需安装 Daily Notes Interface,直接指定路径:

  • Daily Note 存放路径: 日记文件所在的文件夹路径。

    • 示例: Journal/2024 或 Daily。如果放在根目录,请留空或填 /。
  • Daily Note 日期格式: 对应文件名的日期格式 (Moment.js 语法)。

    • 示例: YYYY-MM-DD (对应 2024-05-20.md)

3. 同步行为

  • 插入模式 (Insert Mode):

    • Block Mode (推荐): 在文档末尾创建固定区域进行同步,支持反复更新。

    • Cursor Mode: 仅在当前光标位置粘贴文本,不做去重处理。

4. 模板变量

你可以使用以下变量自定义 内容模板:

变量 描述 示例
{{time}} 笔记创建时间 (HH:mm) 14:30
{{date}} 笔记创建日期 (YYYY-MM-DD) 2024-05-20
{{datetime}} 完整时间 2024-05-20 14:30:00
{{content}} 笔记正文内容 今天天气不错...
{{id}} Memo ID 1024
{{creator}} 创建者用户名 admin
{{status}} 笔记状态 NORMAL

推荐模板示例:

- `{{time}}` {{content}} [Memos Link](https://memos.example.com/m/{{id}})

🚀 使用方法

  1. 打开你需要同步的那一天的 Daily Note(或者确保该文件已存在)。

  2. 点击左侧边栏的 "Sync Memos" 图标(刷新图标)。

  3. 或者使用命令面板 (Ctrl/Cmd + P),输入 Sync today's memos。

  4. 插件会自动拉取数据并写入文档。

❓ 常见问题 (FAQ)

Q: 同步时提示 "Invalid date"? A: 这是因为部分新版 Memos API 返回的时间字段格式发生了变化。插件 v1.0.0 已修复此问题,自动兼容 Unix 时间戳和 ISO 时间字符串。

Q: 图片显示裂图或 403 Forbidden? A: Memos 的图片通常需要登录才能访问。本插件会自动识别图片链接并在末尾追加 ?token=YOUR_TOKEN,让 Obsidian 可以直接渲染私有图片。请确保 Access Token 正确。

Q: 为什么不同步已归档 (Archived) 的记录? A: 插件默认过滤掉了 row_status != "NORMAL" 的记录,只同步正常的笔记。

Q: 如果当天的日记文件不存在怎么办? A: 插件会弹窗提示“目标 Daily Note 不存在”。请先在 Obsidian 中创建当天的日记文件(或使用日记插件创建),然后再点击同步。

📝 License

MIT License.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages