OB-search3.0-自定义加权搜索,智能补全和引用
一个为 Obsidian 设计的智能搜索和补全插件,支持加权搜索、智能补全和快捷输入功能。
功能特点
🔍 智能搜索
- 多维度搜索:支持文件名、目录、标签、标题、内容、引用等多个维度的搜索
- 自定义权重:用户可以自定义各个搜索维度的权重,优化搜索结果
- 实时搜索:输入即搜索,快速响应
- 智能排序:基于权重和匹配度的智能排序算法
⚡ 智能补全
- 块快捷输入 (@@):快速插入内容块,支持中英文多字搜索
- 标题引用 (@@#):快速创建标题链接引用
- 块引用 (@@@):快速创建块链接引用
- 光标跟随:提示框智能跟随光标位置
- 键盘导航:支持方向键选择和回车确认
🎯 高级功能
- 缓存机制:智能缓存搜索索引,提高搜索性能
- 排除文件夹:支持排除特定文件夹,避免搜索不相关内容
- 自定义搜索范围:可配置智能补全的搜索文件夹
使用方法
智能补全功能
1. 块快捷输入 (@@)
@@工具 网页浏览
- 输入 @@ 后跟搜索关键词
- 中文需要2个汉字以上,英文需要4个字母以上
- 直接插入匹配的内容块,不带链接格式
- 支持空格分隔的多关键词搜索
2. 标题引用 (@@#)
@@# 汉波 助手
- 输入 @@# 后跟搜索关键词(注意空格)
- 搜索所有级别的标题
- 插入格式:[[文件名#标题|标题]]
- 点击可跳转到对应标题
3. 块引用 (@@@)
@@@ 效率工具 管理
- 输入 @@@ 后跟搜索关键词(注意空格)
- 搜索内容块并创建引用
- 插入格式:[[文件名#^blockid|块内容]]
- 点击可跳转到对应块
传统搜索功能
- 使用快捷键或命令面板打开搜索模态框
- 选择需要搜索的维度(文件名、目录、标签等)
- 输入搜索关键词
- 查看按权重排序的搜索结果
- 点击结果打开对应文件

设置选项
智能补全设置
- 启用智能补全:开启/关闭智能补全功能
- 搜索文件夹:配置智能补全的搜索范围(支持多文件夹)
- 最小中文长度:中文搜索的最小字符数(默认2)
- 最小英文长度:英文搜索的最小字符数(默认4)
搜索权重设置
- 文件名权重:文件名匹配的权重
- 目录权重:目录匹配的权重
- 标签权重:标签匹配的权重
- 标题权重:各级标题匹配的权重(H1-H4)
- 内容权重:正文内容匹配的权重
- 引用权重:引用内容匹配的权重
其他设置
- 排除文件夹:设置不参与搜索的文件夹列表
- 缓存更新间隔:设置搜索索引的自动更新间隔
- 自动更新缓存:开启/关闭自动更新功能
- 手动更新:提供手动更新搜索索引的按钮
安装方法
- 下载插件文件到 Obsidian 插件目录
- 在 Obsidian 设置中启用插件
- 根据需要调整搜索权重和智能补全设置
功能概述
本插件提供三种智能补全模式:
- 块快捷输入 (@@) - 直接插入内容,不创建链接
- 标题引用 (@@#) - 插入可跳转的标题链接
- 块引用 (@@@) - 插入可跳转的块链接
重要区别
快捷输入 vs 引用
- 快捷输入 (@@): 只插入纯文本内容,无法跳转
- 引用 (@@# 和 @@@): 插入 [[]] 格式的链接,可以点击跳转到原文件
测试步骤
1. 块快捷输入测试 (@@)
- 输入:@@测试
- 预期:显示包含"测试"的内容建议
- 选择后:直接插入内容文本,例如:这是一个测试内容
- 结果:纯文本,无链接,无法跳转
2. 标题引用测试 (@@#)
- 输入:@@# 使用方法 (注意:@@# 后必须有空格)
- 预期:显示包含"使用方法"的标题建议
- 选择后:插入链接格式,例如:[[三人聚智效率工具(sanrenjz-tools)使用说明#使用方法|使用方法]]
- 结果:可点击的链接,能跳转到对应文件的标题位置
- 完全替换:@@# 使用方法 会被完全替换,不留残余字符
3. 块引用测试 (@@@)
- 输入:@@@ 重要内容 (注意:@@@ 后必须有空格)
- 预期:显示包含"重要内容"的块建议
- 选择后:插入链接格式,例如:[[文件名#^blockid|完整的块内容,不管多长都会完整插入]]
- 结果:可点击的链接,能跳转到对应文件的具体块位置
- 完整内容:插入完整的块内容,不使用省略号截断
- 完全替换:@@@ 重要内容 会被完全替换,不留残余字符
许可证
MIT License
👨💻 作者信息
余汉波 - 编程爱好者-量化交易和效率工具开发
- GitHub: @yuhanbo758
版权声明:
作者:余汉波
链接:https://www.sanrenjz.com/2025/10/08/ob-search3-0-%e8%87%aa%e5%ae%9a%e4%b9%89%e5%8a%a0%e6%9d%83%e6%90%9c%e7%b4%a2%ef%bc%8c%e6%99%ba%e8%83%bd%e8%a1%a5%e5%85%a8%e5%92%8c%e5%bc%95%e7%94%a8/
文章版权归作者所有,未经允许请勿转载。
THE END