asciimoo/hister

Hister – 您的个人私有搜索引擎

它是什么

• 一个自托管的搜索引擎，为您访问的网页和添加的任何本地文件建立全文索引。它作为一个您控制的小型服务器运行，无需云组件。

工作原理

1. 安装单个二进制文件（或使用Homebrew、Docker、Nix）。
2. 运行hister listen启动服务器。
3. 添加浏览器扩展（Firefox/Chrome）——您浏览的每个页面都会发送到服务器并存储在全文索引中。
4. 通过Web界面、终端界面、命令行或AI助手客户端（MCP）进行搜索。
5. 可选：配置嵌入端点以启用语义（基于含义）搜索。

主要功能

• 隐私优先 – 无遥测，无强制云同步；数据保留在您运行的服务器上。
• 对访问的页面和本地文档（文件夹、书签、历史记录、文件）进行全文索引。
• 强大的查询语言 – 字段过滤器、短语、通配符、否定、别名、结果加权。
• 通过官方扩展实现自动浏览器索引。
• 多用户支持 – 在共享服务器上为每个用户提供独立的索引。
• 多个客户端 – Web UI、TUI/终端、CLI和兼容MCP的AI助手。
• 使用您自己的嵌入服务进行可选的语义搜索。

适用人群

• 希望对自己的浏览历史和文档进行个人“类似Google”搜索的知识工作者。
• 需要共享、自托管搜索中心而不将数据暴露给第三方服务的团队。
• 偏好本地控制搜索索引的注重隐私的用户。

开始使用

• 从GitHub发布页面下载最新二进制文件，使其可执行，然后运行./hister listen。
• 在浏览器中打开http://127.0.0.1:4433，安装扩展，然后开始索引。
• 通过提供的配置选项导入现有浏览器历史/书签或索引本地目录。

技术栈

• 后端使用Go 1.26编写（部分依赖使用CGO）。
• 前端使用Vite（JavaScript/TypeScript）构建，由Go服务器提供。
• 开发工作流使用npm管理UI，使用air进行Go实时重新编译。

社区与贡献

• 在IRC（IRCNet上的#hister）和Discord上聊天。
• 通过拉取请求贡献；指南见CONTRIBUTING.md。
• 问题和安全报告在GitHub上跟踪。

许可证

• AGPL-3.0（或更高版本），确保任何公开部署都必须共享源代码更改。

---

Hister为您的数据提供类似Google的搜索体验，将所有内容置于您的控制之下。