文档

搜索、引用,以及语义检索

统一搜索面板、文稿引用、前进后退,以及桌面端如何把本地向量交给 /rag/search。

桌面版有两条搜索。⌘K 搜的是标题和正文,选中后打开文稿或插入引用。语义检索在索引完成后,用本机向量和关键词一起排序。两条不要混用。

统一的搜索 / 引用面板

点击顶栏的搜索按钮(或 ⌘K)打开面板。在文稿里输入 @ 会打开同一个面板,只是选中文稿时会插入引用而不是打开它。

输入框右侧有三个范围:

  • 最近打开:最近打开过的文稿(最多 200 篇,向下滚动自动加载),每行显示所属空间;在空间内还可以筛选「所有空间 / 当前空间」。
  • 当前空间:按目录逐级浏览当前空间,面包屑可以返回上级。
  • 所有空间:先列出空间,再逐级进入目录。

直接输入即搜索标题和正文:结果先列出名称匹配的空间,再列出文档。选中空间会在面板里进入它的目录;有子文档的文档可以按 → 进入下一级。输入「空间名/」可以只在某个空间里搜索。Tab 或 ← → 切换范围,面板会记住上次使用的范围。输入框里的 Aa / ab / .* 分别是区分大小写、全词匹配和正则表达式。

最近打开

逐级浏览空间

文稿引用

用 @ 选中一篇文稿,就会插入一个引用:前面有文档图标,文字是完整路径「空间 / 父文档 / 标题」,样式和普通链接一致。改名或移动目标文稿后,路径会自动更新。

  • 按住 ⌘(Windows 上是 Ctrl)点击即可打开引用或链接;直接点击只会放置光标,方便编辑。
  • 目标被删除时,引用显示为灰色删除线。
  • 没有权限的引用显示锁图标和「无权访问」,不会泄露标题。

引用与普通链接

复制链接与右键菜单

在目录中把鼠标移到某一行,会出现「+」(新建子文档)和「⋯」菜单;在该行点右键也会打开同一个菜单:重命名、新建子文档、复制链接、删除。空间卡片和回收站卡片同样支持右键。

复制链接会复制 https://memwork.okayok.ai/d/<文稿 ID> 以及标题。粘贴到 Memwork 文稿里会自动变成引用;在浏览器打开该链接时,未登录会先跳转登录,登录后如果你有权限就能看到文稿,否则显示「无权访问」。

目录右键菜单

前进与后退

顶栏最左侧是后退 / 前进,在文稿、空间和回收站之间切换。也支持鼠标侧键,以及 macOS 触控板的滑动手势(需要在系统设置中开启)。

前进后退

语义检索

索引在桌面完成之后,查询走 POST /rag/search。桌面先用本地 EmbeddingGemma 算出 768 维向量,请求体里同时带上:

  • q:查询原文,最多 500 字
  • vector:768 个数
  • model:模型id@版本,必须和服务器上正在生效的那一行一致
  • limit:返回条数,默认 8

服务器用关键词(中文分词 BM25)和向量距离两路结果做融合,每篇文档只留最相关的一块。模型标签对不上时,这次只返回关键词命中。

没有查询向量、服务器也没有另配嵌入服务时,接口返回 503,正文是 embed_unavailable。先确认右侧任务面板里这篇的索引已经完成,再搜。本机 MCP 的 memwork_search 不走这条接口,它只做标题和正文的关键词搜索。

块从哪来

索引读的是 TipTap 正文,不是导出的 HTML。按标题分成节,节内按句子装箱,相邻块大约重叠 12%。表格和代码尽量整块保留;只有长到放不进模型上限时才按行拆开。图片单独成块:能读到图就嵌入图片,读不到也留下说明文字。单块若仍超过 1024 个 token,任务面板里的索引会失败。

AI(MCP)也能使用引用

通过 MCP 连接的 AI 助手读取文稿时,引用会以 [空间 / 父文档 / 标题](https://memwork.okayok.ai/d/<id>) 的形式出现;写入时,只要使用同样格式的链接,就会保存为引用(只对你自己的文稿生效)。工具 memwork_get_doc_by_link 可以直接打开一个文稿链接。标题、列表、任务列表、引用块、代码、表格、图片和 YouTube 视频都有对应的 Markdown 写法,读出再写回不会丢掉这些块。