Quick Memo

English: Quick Memo is a Markdown-native Obsidian plugin for fast daily capture of records (记录), flash thoughts (闪念), and todos (待办). It is database-free — the Daily Note Markdown file is the single source of truth. The plugin reads and writes one ## Quick Memo section per day and keeps a rebuildable in-memory index for search, filters, and a 90-day activity heatmap. Records are stored in dedicated yyyy-MM-dd-quick-memos.md files, so your regular yyyy-MM-dd.md daily notes are never touched. Full English README →

中文： 一个 Markdown 原生的 Obsidian 插件，用于日常快速记录「记录 / 闪念 / 待办」，类似 Thino 的轻量捕获体验，但不依赖任何数据库——Daily Note 的 Markdown 文件就是唯一数据源，插件只读写其中一个 ## Quick Memo 二级标题段落，并维护一个可随时重建的内存索引用于搜索、筛选和热力图。

一、它是什么

Quick Memo 让你在 Obsidian 里：

• 一键打开总览面板，快速输入并保存「记录 / 闪念 / 待办」；
• 所有内容以纯 Markdown 列表项写入专属文件 yyyy-MM-dd-quick-memos.md，不会动你原有的 yyyy-MM-dd.md 日记；
• 自动维护内存索引，支持按类型筛选、按标签筛选、按关键词搜索；
• 提供近三个月的活动热力图（绿色深浅随当天记录条数变化）；
• 待办可勾选完成，并同步回写 Markdown 的 - [ ] / - [x]；
• 支持编辑、删除、复制块链接、打开源文件。

数据完全可重建：索引是缓存，删掉也能从 Markdown 一键重建。

二、安装方式

方式 A：手动安装（本压缩包已包含运行所需文件）

本压缩包内的 swz-quick-memos 文件夹已经包含 Obsidian 加载插件所需的全部文件：

swz-quick-memos/
├── manifest.json
├── main.js
└── styles.css

安装步骤：

1. 解压本压缩包，得到 swz-quick-memos 文件夹；
2. 把这个文件夹整个复制到你 vault 的插件目录：

   <你的vault>/.obsidian/plugins/swz-quick-memos/
   

   如果 .obsidian/plugins 目录不存在，手动创建即可；
3. 打开 Obsidian → 设置 → 第三方插件（Community plugins）；
4. 关闭「安全模式」（如果尚未关闭）；
5. 在已安装插件列表里找到 Quick Memo，打开开关启用它；
6. 启用后，左侧栏会出现一个笔记本图标（notebook-pen），点击即可打开 Quick Memo 总览面板。

说明：main.js、styles.css、manifest.json 这三个文件必须放在同一个名为 swz-quick-memos 的文件夹里，文件夹名要与 manifest.json 中的 id 一致，否则 Obsidian 无法识别。

方式 B：从源码构建（开发者）

npm install
npm run build          # 生成 main.js

然后将 manifest.json、main.js、styles.css 复制到 vault 的插件目录即可。

三、使用方式

1. 打开面板

• 点击左侧栏的 Quick Memo 图标；
• 或执行命令 Quick Memo: Open Quick Memo overview（可用 Ctrl/Cmd + P 调出命令面板搜索）。

2. 新建一条记录

1. 在中间输入区选择类型：记录 / 闪念 / 待办；
2. 输入 Markdown 内容（输入框本身是源码编辑，不实时渲染）；
3. 点击「保存」，或按 Cmd/Ctrl + Enter 保存。

保存后内容会写入当天对应的 Quick Memo 文件，并立即显示在下方时间线里。

3. 记录的 Markdown 格式

所有记录都写在当天文件的 ## Quick Memo 标题下，例如：

## Quick Memo

- 09:12 [闪念] 突然想到的点子 #灵感 ^oqm-20260621-091200-a1b2
  多行正文：缩进续行也算同一条记录
- [ ] 10:20 [待办] 完成某件事 #todo ^oqm-20260621-102000-c3d4
- [x] 11:00 [待办] 已完成的事 #todo ^oqm-20260621-110000-e5f6

类型标签为中文：记录 / 闪念 / 待办。待办使用 - [ ] / - [x] 标记完成状态。^oqm-… 是可选的块 ID，用于稳定编辑、勾选和块链接。

4. 卡片操作

每条记录右上角有一个 ⋮ 按钮，点击展开操作菜单：

• 标记完成 / 标记未完成（仅待办）
• 编辑
• 复制块链接
• 打开源文件
• 删除

待办卡片左侧的勾选框也可直接点击切换完成状态（会同步回写文件）。

点击菜单外的任意区域会自动关闭菜单。

5. 筛选与搜索

左侧侧边栏提供：

• 类型筛选：全部 / 记录 / 闪念 / 待办 / 已完成待办 / 未完成待办；
• 关键词搜索：输入关键词后回车或失去焦点时触发搜索（不会边输入边搜索，避免中文输入法被中断）；
• 标签筛选：点击标签按该标签筛选；再次点击已选中的标签可取消筛选；
• 右键标签：弹出菜单，可选择「删除标签」，从所有记录中移除该标签。

6. 热力图

侧边栏中部显示近三个月（固定 90 个方块）的活动热力图：

• 每个方块代表一天；
• 有记录的日期显示为绿色，记录条数越多绿色越深；
• 鼠标悬浮可查看该日期与记录条数；
• 点击某天的方块可跳转到该日期的时间线。

热力图独立于当前选中日期，始终以「今天」为基准。

7. 跨午夜自动刷新

面板会每分钟检查一次本地日期；如果你正停留在「今天」，跨过午夜后会自动滚动到新的一天，不会打断你正在浏览的历史日期。

四、设置项

设置 → Quick Memo：

修改文件夹、日期格式、标题等设置后会自动重建索引并刷新面板，立即生效。

五、特点

• Markdown 原生，无数据库：文件即数据，索引可随时重建，迁移、备份、版本管理都跟着 Markdown 走。
• 专属文件，互不干扰：只写入 yyyy-MM-dd-quick-memos.md，绝不触碰你原有的 yyyy-MM-dd.md 日记。
• 可配置路径：文件夹和日期格式可自定义，支持 YYYY/MM/YYYY-MM-DD 这种嵌套年月目录结构。
• 轻量启动：只索引 -quick-memos.md 文件，并对 vault 文件事件做了过滤与防抖，避免大 vault 启动卡顿。
• 本地日期：所有日期使用本地时间，不会出现 UTC 导致的跨天错位。
• 主题自适应：样式只使用 Obsidian 主题变量，自动跟随亮色 / 暗色主题。
• 可测试：核心逻辑（解析器、解析路径、索引、仓库、渲染）都有单元测试覆盖，不依赖 Obsidian 运行时。

六、命令

七、数据存储位置

记录文件默认写入（取决于你的设置）：

<vault>/每日工作/YYYY/MM/YYYY-MM-DD-quick-memos.md

示例：

<vault>/每日工作/2026/06/2026-06-21-quick-memos.md

插件自身配置存放在：

<vault>/.obsidian/plugins/swz-quick-memos/data.json

卸载插件后，你已经写下的 Markdown 记录仍然保留在文件里，不会丢失。

八、技术信息

• 最低 Obsidian 版本：1.5.0
• 桌面端 / 移动端均可使用
• 作者：songwz
• 版本：见 manifest.json

九、常见问题

Q：为什么我的记录没显示出来？ A：插件只索引文件名为 yyyy-MM-dd-quick-memos.md 的文件。请确认记录确实写入了这类文件，而不是普通 yyyy-MM-dd.md 日记。可通过命令面板执行 Quick Memo: Rebuild Quick Memo index 强制重建索引。

Q：能否支持普通 yyyy-MM-dd.md 日记？ A：当前版本有意只处理 -quick-memos.md 文件，以避免读写你原有的日记文件。

Q：勾选待办后文件里会同步吗？ A：会。勾选会自动把文件里对应的 - [ ] 改写成 - [x]（需要记录有块 ID）。

Q：卸载插件会丢数据吗？ A：不会。所有记录都是普通 Markdown，留在文件里。