Notesnook 侧边菜单快捷方式(Side Menu Shortcuts)完全指南:如何固定笔记本与标签、管理配额并理解底层实现
Notesnook 侧边菜单快捷方式(Side Menu Shortcuts)完全指南:如何固定笔记本与标签、管理配额并理解底层实现
侧边菜单快捷方式(Side menu shortcuts)是 Notesnook 在侧边栏主页面上提供的"手动置顶"机制:与绝大多数笔记应用不同,Notesnook 不会在你创建标签或笔记本时自动把它们塞进侧边菜单,而是把"侧边菜单上显示什么"的决定权完全交还给你。通过本指南,你将学会在 Desktop/Web 与移动端上为最常用的笔记本、标签创建快捷方式、移除不再需要的快捷方式、理解免费与付费账户的配额差异,并顺着源码看清快捷方式在 packages/core 数据层与各端 UI 层之间是如何落库、解析与排序的。
为什么 Notesnook 不自动把笔记本和标签放进侧边菜单
大多数笔记应用在创建标签或笔记本时会自动将其添加到侧边栏。但正如官方文档(side-menu-shortcuts.md)所指出,当你拥有成百上千个标签时,所有标签都堆在侧边菜单上会让管理和查找变得异常痛苦。随着笔记收藏不断增长,这种"全自动"的侧边栏很快就会变得不可用。
因此 Notesnook 采用了**显式快捷方式(shortcut)**机制:只有你主动添加为快捷方式的笔记本和标签才会出现在侧边菜单主页面上,从而保持导航区域精简、可控、可预测。
快捷方式的类型在核心代码中有严格限定。在 packages/core/src/collections/shortcuts.ts 中定义了
ALLOWED_SHORTCUT_TYPES = ["notebook", "topic", "tag"],任何不在此范围内的itemType在调用db.shortcuts.add()时都会抛出"Cannot create a shortcut for this type of item."错误。也就是说,除了笔记本、主题(topic)和标签,其他类型的条目无法成为侧边菜单快捷方式。
免费与付费账户的快捷方式配额
快捷方式数量受账户套餐限制,这一点在官方文档中有明确说明,并同时被 plans-and-limits.md 中的配额表所印证:
| 项目 | Free | Essential | Pro | Believer |
|---|---|---|---|---|
| Side menu shortcuts | 10 | Unlimited | Unlimited | Unlimited |
- Free(免费)账户:最多可保留 10 个快捷方式。
- Essential、Pro、Believer 账户:快捷方式数量不限。
从 apps/web/src/dialogs/buy-dialog/features.tsx 的源码可以看出,"Side menu shortcuts" 被列为 Pro 计划解锁的高级功能之一(id: "side-menu-shortcuts"),这也是为什么免费账户在快捷方式数量上存在硬性上限。
为笔记本创建快捷方式
以下操作步骤直接来自官方文档的 Creating a shortcut for a notebook 章节,并按平台分别说明。
Desktop/Web
- 进入笔记本(notebooks)区域:点击侧边菜单顶部的笔记本图标。
- 右键单击目标笔记本。
- 在右键菜单中点击 "添加到快捷方式"(Add to shortcuts)。
- 该笔记本随即出现在侧边菜单的主页面上(即快捷方式区域)。
Mobile(Android/iOS)
- 进入笔记本区域:点击侧边菜单底部的笔记本图标。
- 长按目标笔记本。
- 在弹出的菜单中点击 "添加到快捷方式"(Add to shortcuts)。
- 该笔记本随即出现在侧边菜单的主页面上。
为标签创建快捷方式
操作方式与笔记本基本一致,区别仅在于进入标签区域的入口。以下步骤来自 Creating shortcut for a tag。
Desktop/Web
- 进入标签(tags)区域:点击侧边菜单顶部的
#图标。 - 右键单击目标标签。
- 点击 "添加到快捷方式"(Add to shortcuts)。
- 该标签随即出现在侧边菜单的主页面上。
Mobile
- 进入标签区域:点击侧边菜单底部的
#图标。 - 长按目标标签。
- 点击 "添加到快捷方式"(Add to shortcuts)。
- 该标签随即出现在侧边菜单的主页面上。
移除快捷方式
当你不再需要某个快捷方式时,可以从侧边菜单主页面上将其移除。以下步骤来自 Removing a shortcut。
Desktop/Web
- 在侧边菜单的主页面上,右键单击一个快捷方式。
- 点击 "移除快捷方式"(Remove from shortcuts),该快捷方式即从侧边菜单中消失。
Mobile
- 在侧边菜单的主页面上,长按任意快捷方式。
- 点击 "移除快捷方式"(Remove from shortcuts) 即可将其移除。
源码视角:快捷方式的底层实现
数据模型与集合:packages/core/src/collections/shortcuts.ts
快捷方式的核心实现在 packages/core/src/collections/shortcuts.ts,它基于 SQLCachedCollection<"shortcuts", Shortcut> 持久化存储,包含以下关键能力:
add(shortcut):插入一条快捷方式记录。源码强制要求itemId与itemType必须存在(否则抛出"Cannot create a shortcut without an item."),并且itemType必须属于ALLOWED_SHORTCUT_TYPES。落库时记录dateCreated、dateModified,并将sortIndex置为-1(源码注释表明该字段原本打算使用await this.collection.count()计算)。exists(id):判断某个条目是否已经是快捷方式。这正是 UI 层用来决定菜单项显示"添加到快捷方式"还是"移除快捷方式"的依据。resolved(type):将快捷方式记录解析为真实对象——根据itemType收集笔记本 ID 和标签 ID,再分别通过db.notebooks.all.items()与db.tags.all.items()批量加载,最后按dateCreated升序排列。这意味着侧边菜单上的快捷方式默认按添加先后顺序展示。remove(...ids):通过collection.softDelete()执行软删除,将快捷方式从集合中移除。
前端状态:apps/web/src/stores/app-store.ts
Web 端的快捷方式状态由 apps/web/src/stores/app-store.ts 中的 addToShortcuts 统一管理,它采用切换(toggle)语义:
- 若
db.shortcuts.exists(item.id)为真,则调用db.shortcuts.remove(item.id)并弹出 "Shortcut removed" 提示; - 否则调用
db.shortcuts.add({ itemType, itemId })并弹出 "Shortcut created" 提示; - 随后调用
refreshNavItems()刷新侧边菜单,并根据类型刷新对应的notebookStore或tagStore。
refreshNavItems()(app-store.ts)通过 await db.shortcuts.resolved() 拉取全部已解析的快捷方式并写入 state.shortcuts,驱动侧边菜单渲染。
侧边菜单渲染与排序:apps/web/src/components/navigation-menu/index.tsx
在 apps/web/src/components/navigation-menu/index.tsx 中,Shortcuts 组件读取 useAppStore((store) => store.shortcuts),并用 ReorderableList 渲染快捷方式列表:
- 排序状态持久化在
sidebarOrder:shortcuts这一设置键中,通过db.settings.getSideBarOrder("shortcuts")读取、db.settings.setSideBarOrder("shortcuts", order)写入——拖拽排序不会影响shortcuts集合本身的顺序,而是独立保存在设置里; - 每个快捷方式项(
ShortcutItem)的右键菜单包含"移除快捷方式"按钮(key: "removeshortcut"),点击后执行db.shortcuts.remove(item.id)并刷新导航项。
移动端入口:apps/mobile/app/hooks/use-actions.tsx
移动端的长按操作在 apps/mobile/app/hooks/use-actions.tsx 定义的 Action 类型中注册了 "add-shortcut" 动作。组件挂载时通过 db.shortcuts.exists(item.id)(use-actions.tsx)判断当前条目是否已置顶,从而在"添加到快捷方式"与"移除快捷方式"之间切换菜单文案。这也解释了为什么文档中移动端的操作是"长按笔记本/标签"后点击对应菜单项。
常见问题与使用建议
- 快捷方式和收藏(Favorites)有何区别? 快捷方式把笔记本或标签固定到侧边菜单主页面,便于快速导航;而收藏(Favorites)用于组织笔记内容本身(参见 pin-notes.md 与 organize-notes-using-favorites.md)。两者服务于不同层级:快捷方式管"导航入口",收藏管"内容可见性"。
- 为什么我添加的快捷方式不见了? 快捷方式不是对原始笔记本/标签的复制,而是指向其 ID 的引用(
itemId)。如果对应的笔记本或标签被删除,快捷方式在resolved()解析时找不到目标对象,就不会被渲染出来。 - 如何控制侧边菜单的整体外观? 快捷方式只是侧边菜单定制的一部分。你还可以在侧边菜单中隐藏不常用的条目、调整各分区的顺序,详见 customizing-notesnook.md(其中也包含对侧边菜单"reorder and hide items"能力的介绍,见 plans-and-limits.md)。