Notesnook 笔记归档(Archive)完全指南:归档、取消归档与底层实现原理

原创2026-09-21 22:19:501,371 阅读
文章标签:知识管理知识库富文本前端桌面应用移动开发跨平台密码学应用安全

Notesnook 笔记归档(Archive)完全指南:归档、取消归档与底层实现原理

归档是 Notesnook 中整理笔记清单、保留历史内容的核心功能之一:它能把暂时不需要的笔记移出主 Notes 视图,但又不像删除那样销毁内容——所有被归档的笔记会集中存放在侧边菜单的 Archive(归档)分区中,随时可以找回并恢复。本文将基于官方帮助文档 archive-notes.md 展开,逐平台讲解归档与取消归档的完整操作,并结合当前仓库的源码(packages/core 与各端应用层)深入剖析归档在数据层、查询层与界面层的真实实现,帮助你既会用、又理解其背后的工作原理。

归档是什么:与删除、置顶的区别

在 Notesnook 中,笔记的收纳体系由三个互补的功能构成:

功能 作用 笔记的去向
归档(Archive) 将笔记移出主视图,保留内容 侧边菜单的 Archive 分区
删除(Trash) 移入回收站,可恢复或永久删除 回收站(详见 Trash)
置顶(Pins) 将重要笔记固定在列表顶部 主视图置顶区(详见 Pins)

从源码角度看,归档与删除的根本区别在于状态字段不同。笔记类型在 types.ts 中声明了独立的 archived?: boolean 布尔字段,而删除则通过 deleted、dateDeleted 等字段标记。归档只是翻转一个布尔标志,笔记的标题、正文内容、附件、标签、所属笔记本等关联数据全部原样保留。

此外,归档与置顶、收藏是正交的:你可以同时置顶并归档一条笔记(置顶仅影响排序展示),但归档后的笔记会从收藏(Favorites)视图的过滤结果中剔除,这一点在下面的源码分析中可以看到具体证据。

归档一条笔记

官方文档按照桌面/Web 与移动端分别给出了操作路径,两者入口不同但逻辑一致。

Desktop / Web

  1. 右键点击一条笔记,打开 Note properties(笔记属性)菜单;
  2. 点击 Archive(归档);
  3. 笔记随即被移出主 Notes 视图,进入 Archive 分区。

Mobile

  1. 点击笔记上的 "Three dot"(三点)按钮;
  2. 点击 Archive(归档);
  3. 笔记随即被移出主 Notes 视图,进入 Archive 分区。

界面层的实现印证

桌面/Web 端这条右键菜单项可以在 apps/web/src/components/note/index.tsx 中找到对应实现:菜单项的 title 为 strings.archive(),其勾选状态 isChecked 直接绑定笔记的 note.archived 字段,点击后调用 store.archive(!note.archived, ...ids)——也就是在“归档”与“取消归档”之间切换。

移动端的对应动作位于 apps/mobile/app/hooks/use-actions.tsx:同样根据 item.archived 动态显示 Archive 或 Unarchive 文案,并调用 db.notes.archive(!item.archived, item.id),且菜单项带有 checked 状态反馈。

取消归档(恢复笔记)

取消归档是归档的逆操作,路径与归档完全对称:

Desktop / Web

  1. 从侧边菜单进入 Archive 分区;
  2. 右键点击笔记,打开 Note properties 菜单;
  3. 再次点击 Archive —— 菜单项前的勾选标记消失;
  4. 笔记恢复显示在主 Notes 视图中。

Mobile

  1. 从侧边菜单进入 Archive 分区;
  2. 点击笔记上的三点按钮;
  3. 点击 Unarchive(取消归档);
  4. 笔记恢复显示在主 Notes 视图中。

底层实现:归档在数据层如何工作

理解归档的精髓在于 packages/core/src/collections/notes.ts 这个核心集合类。它以一张二维矩阵清晰地表达了归档语义:

视图 / 方法 过滤条件(节选) 结论
notes.all(主视图) isFalse("dateDeleted")、isFalse("deleted")、isFalse("archived") 归档笔记从主列表消失
notes.archived(归档视图) isFalse("dateDeleted")、isFalse("deleted")、archived == true 归档分区只显示已归档且未删除的笔记
notes.favorites(收藏视图) 排除 dateDeleted、deleted、archived、favorite == true 归档的收藏笔记不再出现在收藏列表中
notes.pinned(置顶视图) 排除删除标记、pinned == true 归档与置顶互不排斥

核心写入方法是 archive(state, ...ids)(notes.ts):

async archive(state: boolean, ...ids: string[]) {
  await this.collection.update(ids, { archived: state });
  if (state) {
    addItems(this.cache.archived, ...ids);
  } else {
    deleteItems(this.cache.archived, ...ids);
  }
}

该方法只做两件事:一是通过 collection.update 批量把笔记的 archived 字段更新为目标布尔值;二是同步维护内存中的 cache.archived 缓存列表,避免每次渲染都重新查询数据库。这也解释了为什么批量归档多条笔记非常高效——一次调用即可处理多个 ID。

值得注意的是,notes.archived 过滤器显式排除了 deleted 与 dateDeleted,意味着先归档后删除的笔记只会出现在回收站,而不会出现在归档分区,两个状态互不干扰、边界清晰。

归档视图的查询与展示

服务端/Web 端的存储层字段

归档字段在数据层被声明为可持久化字段之一。在 packages/core/src/database/index.ts 的字段列表中,"archived" 与 pinned、locked、readonly、favorite、localOnly 等一同被纳入数据库映射,作为笔记的行级属性随同步与迁移流程处理。

归档分区的导航与计数

桌面/Web 端的归档入口在 apps/web/src/navigation/routes.tsx 中注册(标题同样来自 strings.archive()),侧边菜单在 apps/web/src/components/navigation-menu/index.tsx 渲染该项,并实时显示归档笔记数量(navigation-menu/index.tsx 通过 db.notes.archived.count() 统计)。

移动端同样维护了一个独立的归档屏幕 apps/mobile/app/screens/archive/index.tsx,其数据源来自 db.notes.archived 分组查询;侧边菜单项的数量徽标则在 apps/mobile/app/components/side-menu/menu-item.tsx 中通过 db.notes.archived.count() 获取。

归档分区支持分组显示

归档视图不是简单的平铺列表,而是支持与主视图一致的分组能力。移动端的 apps/mobile/app/stores/use-archived-store.ts 展示了这一点:它通过 db.notes.archived.grouped(db.settings.getGroupOptions("archive")) 读取名为 "archive" 的分组设置(如按修改日期、创建日期等分组),并按用户的偏好渲染归档列表。也就是说,你可以在设置中为归档分区单独配置分组方式。

进阶场景:归档与搜索、导入、拖拽

在搜索/过滤中指定归档状态

归档状态可以作为查询条件参与过滤。在 packages/core/src/utils/query-transformer.ts 中,查询解析器将 archived: 关键字映射到 parseBooleanField("archived", ast),与 pinned、favorite、locked、tagged、colored 等过滤条件并列。这意味着你可以在支持该语法的过滤/搜索界面中通过 archived:true 或 archived:false 精确筛选归档状态(字段解析实现见同文件 query-transformer.ts 附近的 parseBooleanField 辅助函数)。

导入时还原归档状态

归档状态是可迁移、可还原的元数据。Web 端导入器 apps/web/src/utils/importer.ts 在导入外部备份时检查笔记的 archived 字段,若为真则调用 db.notes.archive(true, noteId) 恢复其归档状态——这印证了归档信息会随笔记一起备份/导出,跨设备迁移后依然保留。

拖拽归档

Web 端还支持通过拖拽完成归档操作:在 apps/web/src/common/drop-handler.ts 的拖放处理器中,将笔记拖入归档目标会调用 archive(true, ...noteIds),实现与右键菜单完全一致的底层行为。

常见问题与最佳实践

  • 归档后笔记去哪了? 它进入了侧边菜单的 Archive 分区,不再出现在主 Notes 列表、收藏视图,但仍保留全部内容与关联元数据,也仍会参与同步。
  • 归档和删除可以叠加吗? 可以。归档笔记被移入回收站后只出现在回收站;从回收站恢复时,其 archived 状态会一并保留。
  • 归档能批量操作吗? 能。底层 archive(state, ...ids) 支持传入多个笔记 ID 批量更新;在支持多选的界面中可选中多条笔记后统一归档/取消归档。
  • 适合归档什么内容? 适合存放已完成但不想删除的笔记(如结课资料、归档项目、历史账单),让主视图保持干净;若笔记完全不需要了,应使用回收站并定期清理(见 Trash)。
  • 搭配其他整理手段:归档负责“收起”,置顶负责“置前”(Pins),笔记本负责“分层”(Notebooks),搜索负责“直达”(Search & navigation),四者结合即可构建完整的个人笔记管理体系。

小结

归档是 Notesnook 中“低成本保留、高效率收纳”的关键机制:一次布尔字段的翻转,就能让笔记从主视图隐退到侧边栏的 Archive 分区,且随时可一键恢复。通过本文,你既掌握了桌面/Web 与移动端的完整操作路径,也了解了从 db.notes.archive() 到 archived 字段、再到查询过滤器与界面视图的完整调用链——下次遇到“笔记不见了”或“想批量收起旧笔记”的场景,你就能自信地定位并解决问题。

登录后查看全文
notesnook