Obsidian Moments

一个 Obsidian 插件，在笔记里实现类似微信朋友圈的体验。可以一个人用作生活日记，也可以两个人各自用自己的身份发动态、点赞、评论。所有数据以 Markdown 文件的形式保存在本地。

功能

发动态

• 支持正文、标题、地点，最多附带 9 张图片
• 图片自动九宫格排版，单图按原始比例展示
• 创建和编辑时都可以拖拽调整图片顺序

互动

• 点赞，点了之后 UI 立刻响应，不用等文件写完
• 评论和回复，点击某条评论自动进入回复模式
• 删除评论（桌面 hover 出现删除按钮，手机上直接显示）

图片浏览

• 点击图片全屏查看，支持左右切换
• 桌面端键盘方向键 + 鼠标滚轮缩放
• 手机端滑动切换、双指缩放、双击放大

搜索和筛选

• 搜索框支持关键词搜索（正文、标题、地点、评论内容）
• 按作者筛选（全部 / 玩家1 / 玩家2）
• 按时间筛选（预设时间段 + 自定义日期范围选择）

双人 / 单人模式

• 设置两个人的昵称和 emoji，选择"我是谁"
• 一个人用也可以，只用一个身份发动态就行
• 不同身份用不同颜色区分（橙色 / 金色）

桌面端和移动端

• 桌面 680px 居中，有 hover 效果和快捷键
• 移动端全宽适配，触摸拖拽、手势操作都做了处理
• 文件变动时 feed 自动刷新

安装

手动安装

1. 下载 main.js、manifest.json、styles.css 三个文件
2. 放到 Obsidian 库的 .obsidian/plugins/obsidian-moments/ 目录下
3. 重启 Obsidian，在设置 → 第三方插件里启用 Obsidian Moments

移动端

把 obsidian-moments.zip 解压到上面那个目录就行。

配置

在设置 → 第三方插件 → Obsidian Moments 里配置：

设置项	说明	默认值
当前用户	选择你是谁（每台设备各自选）	玩家 1
玩家 1 名称 / Emoji	第一个人的昵称和头像	Player 1 / 🐱
玩家 2 名称 / Emoji	第二个人的昵称和头像	Player 2 / 🐶
Moments 存储路径	动态文件保存的目录	Moments/记录/
图片附件存储路径	上传图片保存的目录	Moments/Attachments/
展示顺序	时间排序方向	倒序

使用

展示 feed

在任意笔记里加一个代码块：

```moments
```

切到阅读模式或实时预览就能看到 feed 了。

发布

• 点击 feed 右上角的 + 按钮
• 或者点左侧边栏的图标
• 或者 Ctrl/Cmd + P 搜索"创建 Moments"

操作对照

操作	桌面端	移动端
点赞	点击心形	点击心形
评论	点击评论图标，输入后回车或点发送	一样
回复	点某条评论，自动变成回复模式	一样
删除评论	hover 出现 x，点击后弹窗确认	直接显示 x
看大图	点击图片	点击图片
切换大图	键盘左右箭头 / 点击两侧箭头	左右滑动
缩放大图	鼠标滚轮	双指捏合 / 双击
关闭大图	ESC / 点背景 / 右上角 x	单击
编辑动态	点 ⋯ → 编辑	一样
删除动态	点 ⋯ → 删除	一样

数据格式

每条动态就是一个普通的 Markdown 文件：

---
标题: 姑娘山一日游
地点: 四川.甘孜
作者: Player 1
创建时间: 2026-03-01 12:47:14
更新时间: 2026-03-01 14:27:00
点赞:
  - Player 2
---

## 正文
太棒了从来没有这样体验过

## 图片
![[Moments/Attachments/IMG-20260301-124714-3847.png]]

## 评论区
- 2026-03-01 14:27 | Player 2 | 下次还来！
- 2026-03-01 14:30 | Player 1 | @Player 2 | 好的好的

没有 作者 字段的旧文件会显示为"未知"，旧格式评论（时间 - 内容）也能正常读取。

同步

数据都在你的 Obsidian 库里，两台设备之间可以用这些方式同步：

• iCloud / OneDrive / Google Drive（Obsidian 原生支持）
• Obsidian Sync（官方付费）
• obsidian-git 插件
• Syncthing

两个人在各自设备上把"当前用户"选成自己就好。

开发

git clone https://github.com/Br1an67/obsidian-moments.git
cd obsidian-moments
npm install
npm run build     # 构建
npm run dev       # 开发模式，改了自动重新构建

├── main.ts          # 插件逻辑
├── styles.css       # 样式
├── manifest.json    # 插件元数据
├── esbuild.config.mjs
└── package.json