Zh Search (汉搜)

Chinese-first full-text search for Obsidian — 为中文而生的 Obsidian 全文搜索插件。

Obsidian 的原生搜索是子串匹配：搜「笔记管理」找不到「笔记 的管理」，没有分词，没有相关度排序。「汉搜」为中文从头设计。

✨ 特性

• 🔤 真正的中文分词索引 — 基于 ICU 分词器（Intl.Segmenter），中英混合内容统一索引
• 🎯 BM25 相关度排序 — 最相关的结果排最前，标题命中加权
• 📝 命中片段预览 — 结果中直接显示上下文片段
• ⚡ 毫秒级查询 — 180 篇 / 67 万字实测：全量索引 575ms，查询 < 5ms
• 🔁 实时增量索引 — 保存即更新，无需手动重建
• 🖥️📱 桌面 + 移动端 — 零原生依赖，纯 JS

🚀 使用

1. 启用插件后，按 Ctrl/Cmd + Shift + K（或命令面板搜索「汉搜」）
2. 直接输入关键词——中文按词搜索，不再要求连续匹配

搜索「笔记管理」，能找到含有「笔记」「管理」分开出现的段落。

📦 安装

• 社区插件市场：搜索 "Zh Search"（审核中）
• 手动安装：从 Releases 下载 main.js、manifest.json、styles.css，放入 .obsidian/plugins/zh-search/

⚙️ 设置

• 结果数量上限（默认 20）
• 排除目录（逗号分隔）
• 手动重建索引

🗺️ Roadmap（Pro）

• 拼音全拼/首字母搜索（输入 bj 找到「笔记」）
• 模糊音容错（z/zh、n/l）
• 大库（万篇级）性能优化

高级功能在 爱发电 订阅「Pro 会员」获取，核心搜索永久免费开源。

🛠️ 开发

npm install
npm test     # 核心逻辑自测（分词/索引/排序）
npm run dev  # watch 构建

MIT License © louis-1448-2

---