附件管理

笔记里可以插图、贴视频、放音频，甚至插 PDF。这些文件都跟着你的笔记存在本地，不会跑到网上去 ☁️

支持的格式

类型	格式
图片	PNG、JPG、GIF、SVG、WebP
视频	MP4、WebM
音频	MP3、WAV、OGG
文档	PDF

插入附件 ✚

通过工具栏

1. 点击工具栏中的插入按钮
2. 选择附件类型（图片/视频/音频/PDF）
3. 在弹出的文件选取器中选择文件
4. 附件插入到编辑器光标位置

通过斜杠菜单

在空行输入 /，选择附件类型，然后选取文件。

存储机制 🗄️

望舒使用自定义的 attachment:// 协议管理附件：

• 插入附件时，文件被复制到数据目录下的 attachments/{page_id}/ 文件夹
• 元数据（文件名、大小、MIME 类型等）存储在 SQLite 的 attachments 表中
• 编辑器中用 attachment://{uuid} 引用附件，展示时自动映射为 blob URL

优势

• 可靠引用：附件通过 UUID 引用，不受原始文件路径变化影响
• 完整存档：附件与页面数据存放在同一数据目录中，便于备份
• 自动清理：删除页面时附件一并通过级联清理

附件与页面关系 🔗

• 附件归属于页面（page_id 关联）
• 删除页面时，其附件也会被清理
• 从回收站恢复页面时，附件也会恢复

永久删除页面会导致附件文件从磁盘中移除，且不可恢复。删除前请确认。

附件渲染 🖼️

页面加载时，编辑器会批量解析所有附件的 blob URL，确保图片、视频等媒体内容正确显示。在编辑模式和只读模式下均可正常渲染。

版本历史中的附件 📜

页面版本快照中包含附件的引用信息。恢复历史版本时，会使用当前页面的附件，不会复制历史版本的附件文件。