全局搜索技巧：Ctrl+K 快速找到一切

收藏了几百个书签之后，如何在几秒钟内找到你需要的那一个？答案是全局搜索。MarkStackAI 内置了强大的全局搜索功能，通过一个快捷键就能搜遍所有书签、笔记和导航项目。本文将带你掌握全局搜索的全部技巧，让你的信息检索效率提升数倍。

唤起搜索

全局搜索的入口是 SearchOverlay 组件——一个覆盖在页面上的搜索弹窗。你可以通过以下方式打开它：

系统会自动检测你的操作系统平台，在搜索框的提示文字和顶栏按钮中显示正确的快捷键组合。macOS 显示 ⌘K，其他平台显示 Ctrl+K。

搜索范围

全局搜索会同时在以下内容中检索：

书签搜索

搜索匹配书签的标题（title）、网址（URL）和描述（description）三个字段。无论书签位于哪个目录层级，只要内容匹配就会出现在结果中。搜索结果会展示书签的 favicon 图标、标题和所属目录路径，帮助你快速辨别。

笔记搜索

笔记搜索覆盖标题（title）和 Markdown 正文内容（content_md）。这意味着你可以通过搜索笔记中的任意关键词找到它——无论是标题中的项目名称，还是正文中的某个技术术语。搜索结果会展示笔记标题和所属笔记本。

导航项搜索

公开导航页中的导航分类和书签也在搜索范围内。如果你使用导航分类功能组织了精选资源，通过全局搜索可以快速定位到导航页中的内容。

键盘导航

MarkStackAI 的全局搜索完全支持键盘操作，你可以不碰鼠标完成整个搜索和打开流程：

当搜索弹窗打开时，光标自动聚焦在输入框中，你可以立即开始输入。搜索结果会即时更新——每次击键后，结果列表会立刻刷新显示匹配的内容。当前选中的结果会有高亮背景，按上下箭头可以切换选中项。按 Enter 键会直接打开选中的书签链接或导航到对应的笔记页面。

搜索技巧

使用关键词组合

搜索支持多关键词匹配。输入 react hooks 会匹配标题或内容中同时包含「react」和「hooks」的结果。利用关键词组合可以大幅缩小搜索范围，快速定位目标。

搜索 URL 片段

如果你记得某个网站的域名但忘了具体标题，可以直接搜索域名。输入 github.com 会列出所有来自 GitHub 的书签。类似地，搜索 docs 可以找到所有文档类链接。

利用描述字段

在添加书签时养成填写描述的习惯。描述可以包含标题中没有的关键词——比如书签标题是「RFC 7519」，你可以在描述中写上「JWT 规范文档」，这样搜索「JWT」也能找到这个书签。

中文搜索

全局搜索完全支持中文关键词。无论是中文标题、中文描述还是笔记中的中文内容，都可以准确匹配。输入单个汉字也能返回结果，但建议输入至少两个字以获得更精准的匹配。

搜索笔记内容

当你想找回某篇笔记中提到的具体信息时，全局搜索比逐个翻阅笔记本高效得多。输入笔记中的关键术语，搜索结果会直接展示匹配的笔记标题。点击结果即可跳转到笔记编辑器查看完整内容。

搜索实现原理

了解搜索的技术实现有助于你更好地利用它。MarkStackAI 后端使用 SQLite 数据库，搜索通过 SQL LIKE 查询实现。为了安全性，搜索关键词中的特殊字符（%、_、\）会先被转义，然后再拼接为 LIKE 模式，防止 SQL 注入和通配符滥用。

搜索查询的基本流程：

1. 用户输入关键词，前端通过防抖处理避免频繁请求（通常是 300ms 延迟）
2. 前端发送搜索请求到后端 API，携带关键词和搜索类型
3. 后端对关键词进行转义处理，构建 LIKE 查询
4. 同时搜索书签表（title、url、description）和笔记表（title、content_md）
5. 结果按相关性排序返回前端，即时渲染在搜索弹窗中

对于大规模书签库（数千条以上），SQLite 的 LIKE 查询性能完全足够。如果未来需要更高级的搜索能力（如模糊匹配、拼写纠正），可以扩展为 SQLite FTS5 全文搜索引擎。

页面内搜索

除了全局搜索弹窗，MarkStackAI 的多个页面还提供了局部搜索功能：

• 书签页面工具栏搜索：在 BookmarksToolbar 中有搜索输入框，用于在当前目录及其子目录中过滤书签。这个搜索是即时的前端过滤，不发送网络请求
• 笔记页面搜索：NotesView 的搜索框用于在所有笔记中搜索。搜索时会跳过笔记本过滤，直接在全部笔记中匹配，确保搜索结果不会被笔记本分类限制
• 公开导航页搜索：PublicHomeView 的搜索框用于在公开的导航书签中实时过滤，帮助访客快速找到目标链接
• 健康检测页面：HealthView 支持按检测状态过滤（全部、有效、无效、待检测），配合搜索快速定位问题链接

搜索效率对比

为什么全局搜索值得养成习惯？以下是不同查找方式的效率对比：

• 目录浏览：需要记住书签所在的目录路径，逐级展开，适合对目录结构非常熟悉的场景。平均耗时 10-30 秒
• 浏览器地址栏历史：依赖浏览器的访问记录，如果很久没访问过就找不到。无法搜索描述和笔记内容
• 全局搜索：按下快捷键，输入关键词，即时获得结果。平均耗时 2-5 秒。支持跨类型搜索，覆盖所有收藏内容

当你的书签库超过 100 个时，全局搜索就会成为你最常用的功能。建议将 ⌘K / Ctrl+K 快捷键变成肌肉记忆——这是提升 MarkStackAI 使用效率最直接的方式。