用户指南

快速找到文档所需的一切。另见 GitHub 上的 完整 README。

搜索模式

用右上角的切换按钮选择 关键词、语义 或 两者(默认)。按 Enter 执行搜索;清空输入框会再次显示所有文档。

• 关键词: 通过 SQLite FTS5 的逐字搜索。每个词按前缀匹配并以 OR 组合,因此 budget report 会找到包含 budget… 或 report… 的文档。标题和作者中的匹配高于正文和标签。当你知道文档中的某个词、名称或代码时最合适。
• 语义: 通过 AI 嵌入按含义搜索。即使没有你的确切词语,也能找到 关于 你查询的文档。最适合"关于 X 的文档"。
• 两者: 同时运行,并为每份文档保留较强的分数(两者都命中时有小幅加成)。文档要出现,需要有关键词命中或有意义的语义分数,因此微弱的语义噪声不会淹没扎实的关键词匹配。

不同词语组合的效果

引号表示精确短语

用 "..." 包住词语,可在任意模式下要求该连续短语的精确匹配(不区分大小写)。在语义和两者模式中,它先作为存在过滤器,再按含义对匹配排序。可以混用:golang "import fmt" 表示短语 import fmt 或松散词 golang。语义模式中只有冠词(a/an/the)和连词被当作填充词,因此当确切措辞重要时请用引号括住短语。

深度链接

语义搜索找出 哪些 文档匹配。深度链接 找出其中的 哪里。点击任一结果上的按钮,即可列出匹配段落,每个都按页、行或章节标注。点击其一即可打开,匹配文本以黄色高亮。它按需运行,无需重建索引。

模式跟随你的搜索:语义按含义找段落,关键词或混合按词项找。适用于 PDF、TXT、HTML、Markdown、DOCX、RTF、ODT、电子书、DjVu、XML 家族、LaTeX、邮件、源代码等。电子表格和演示文稿会回退到在各自的阅读器中打开。

AI 摘要

点击任意文档标题,即可获得由 dolphin3:latest 在本地生成、首次运行后缓存的"书封式"摘要。在仅有 CPU 的硬件上,第一次摘要可能较慢;之后的请求是即时的。

界面

• 深色与浅色主题切换
• 分页结果(每页 50 条),带上一页和下一页
• 用于快速跳转的 A–Z 和 0–9 索引栏;Home 重置
• 按主题筛选的标签云
• 每条结果的相关度徽章(0–100%)
• 打开用默认应用启动文件;📋 复制路径;🗑 从磁盘和索引中删除文件(带确认)
• 点击文件已不存在的文档会显示可关闭的弹窗,并从索引中移除它。如果只是驱动器未挂载,则出现一个提示,索引不变。

为文档建立索引

运行 docubrowser rescan 进行扫描、索引和嵌入。支持的格式包括:

• PDF、DOCX、PPTX、XLSX、RTF、CSV/TSV、邮件(.eml)
• OpenDocument(ODT、ODS、ODP 及模板)
• EPUB、MOBI、AZW3、AZW、DjVu
• Visio(VSDX、旧版 VSD)、draw.io、PlantUML、Mermaid、SVG
• HTML、Markdown、XML/SGML、DocBook、RSS/Atom/OPML、reST、AsciiDoc、LaTeX、配置和日志文件、源代码

标题、作者和主题从文档元数据读取,标签由目录结构和内容生成。摄入后的 PII 扫描器 会移除并永久拉黑包含 SSN、信用卡、银行路由与账户号码、出生日期、MRN、驾照或护照模式的文档,并做结构性验证以减少误报。点文件和隐藏目录按设计被跳过。

用 docubrowser duplist 和 docubrowser dupclean 查找并清理重复项。

设置

打开齿轮图标,或访问 /settings。常规 面板设置文档目录(带实时目录浏览器)、任意数量的额外扫描目录、工作目录、端口和语言。忽略的目录 面板将文件夹排除在扫描之外,并在清除任何已索引内容前进行确认。

语言

一次安装服务一种语言,界面、搜索分词器、嵌入模型和摘要模型都随之而定。当前支持:英语(默认)、日语、韩语、简体中文和繁体中文。不支持混合语言的集合。

选择语言

• 首次启动。 DocuBrowse 以英语启动。你在终端中首次运行 docubrowser start 时,它会询问你想要的语言并保存你的回答。照提示操作即可。
• 之后随时。 打开设置页面(齿轮图标),在常规面板的下拉菜单中选择语言。

已知限制