OB-search3.0-自定义加权搜索,智能补全和引用



一个为 Obsidian 设计的智能搜索和补全插件,支持加权搜索、智能补全和快捷输入功能。

功能特点

🔍 智能搜索

  • 多维度搜索:支持文件名、目录、标签、标题、内容、引用等多个维度的搜索
  • 自定义权重:用户可以自定义各个搜索维度的权重,优化搜索结果
  • 实时搜索:输入即搜索,快速响应
  • 智能排序:基于权重和匹配度的智能排序算法

⚡ 智能补全

  • 块快捷输入 (@@):快速插入内容块,支持中英文多字搜索
  • 标题引用 (@@#):快速创建标题链接引用
  • 块引用 (@@@):快速创建块链接引用
  • 光标跟随:提示框智能跟随光标位置
  • 键盘导航:支持方向键选择和回车确认

🎯 高级功能

  • 缓存机制:智能缓存搜索索引,提高搜索性能
  • 排除文件夹:支持排除特定文件夹,避免搜索不相关内容
  • 自定义搜索范围:可配置智能补全的搜索文件夹

使用方法

智能补全功能

1. 块快捷输入 (@@)


@@工具 网页浏览
  • 输入 @@ 后跟搜索关键词
  • 中文需要2个汉字以上,英文需要4个字母以上
  • 直接插入匹配的内容块,不带链接格式
  • 支持空格分隔的多关键词搜索

2. 标题引用 (@@#)


@@# 汉波 助手
  • 输入 @@# 后跟搜索关键词(注意空格)
  • 搜索所有级别的标题
  • 插入格式:[[文件名#标题|标题]]
  • 点击可跳转到对应标题

3. 块引用 (@@@)


@@@ 效率工具 管理
  • 输入 @@@ 后跟搜索关键词(注意空格)
  • 搜索内容块并创建引用
  • 插入格式:[[文件名#^blockid|块内容]]
  • 点击可跳转到对应块

传统搜索功能

  1. 使用快捷键或命令面板打开搜索模态框
  2. 选择需要搜索的维度(文件名、目录、标签等)
  3. 输入搜索关键词
  4. 查看按权重排序的搜索结果
  5. 点击结果打开对应文件

设置选项

智能补全设置

  • 启用智能补全:开启/关闭智能补全功能
  • 搜索文件夹:配置智能补全的搜索范围(支持多文件夹)
  • 最小中文长度:中文搜索的最小字符数(默认2)
  • 最小英文长度:英文搜索的最小字符数(默认4)

搜索权重设置

  • 文件名权重:文件名匹配的权重
  • 目录权重:目录匹配的权重
  • 标签权重:标签匹配的权重
  • 标题权重:各级标题匹配的权重(H1-H4)
  • 内容权重:正文内容匹配的权重
  • 引用权重:引用内容匹配的权重

其他设置

  • 排除文件夹:设置不参与搜索的文件夹列表
  • 缓存更新间隔:设置搜索索引的自动更新间隔
  • 自动更新缓存:开启/关闭自动更新功能
  • 手动更新:提供手动更新搜索索引的按钮

安装方法

  1. 下载插件文件到 Obsidian 插件目录
  2. 在 Obsidian 设置中启用插件
  3. 根据需要调整搜索权重和智能补全设置

功能概述

本插件提供三种智能补全模式:

  1. 块快捷输入 (@@) - 直接插入内容,不创建链接
  2. 标题引用 (@@#) - 插入可跳转的标题链接
  3. 块引用 (@@@) - 插入可跳转的块链接

重要区别

快捷输入 vs 引用

  • 快捷输入 (@@): 只插入纯文本内容,无法跳转
  • 引用 (@@# 和 @@@): 插入 [[]] 格式的链接,可以点击跳转到原文件

测试步骤

1. 块快捷输入测试 (@@)

  • 输入:@@测试
  • 预期:显示包含"测试"的内容建议
  • 选择后:直接插入内容文本,例如:这是一个测试内容
  • 结果:纯文本,无链接,无法跳转

2. 标题引用测试 (@@#)

  • 输入:@@# 使用方法 (注意:@@# 后必须有空格)
  • 预期:显示包含"使用方法"的标题建议
  • 选择后:插入链接格式,例如:[[三人聚智效率工具(sanrenjz-tools)使用说明#使用方法|使用方法]]
  • 结果:可点击的链接,能跳转到对应文件的标题位置
  • 完全替换:@@# 使用方法 会被完全替换,不留残余字符

3. 块引用测试 (@@@)

  • 输入:@@@ 重要内容 (注意:@@@ 后必须有空格)
  • 预期:显示包含"重要内容"的块建议
  • 选择后:插入链接格式,例如:[[文件名#^blockid|完整的块内容,不管多长都会完整插入]]
  • 结果:可点击的链接,能跳转到对应文件的具体块位置
  • 完整内容:插入完整的块内容,不使用省略号截断
  • 完全替换:@@@ 重要内容 会被完全替换,不留残余字符

许可证

MIT License

👨‍💻 作者信息

余汉波 - 编程爱好者-量化交易和效率工具开发

THE END