asciimoo/hister · 上手攻略

  • 仓库：asciimoo/hister
  • 链接：https://github.com/asciimoo/hister
  • 分类：个人工具 · 隐私优先搜索
  • 作者：Jay
  • 更新：2026-09-29

是什么

Hister 是一个本地运行的私人搜索引擎，用于索引和检索你访问过的网页、书签和本地文件。全程数据保存在你自己控制的机器上，不需要任何云端账号或第三方服务。

通过浏览器插件自动收集页面内容，配合 Hister 内置的查询语言或 MCP 接口，可以从 Web UI、终端或 AI 助手侧查询你的个人知识库。

解决什么问题

日常上网我们会访问大量页面，但浏览器自带的搜索功能只能按标题/URL 搜索，无法搜索页面正文内容。Google/DuckDuckGo 等公共搜索引擎也无法搜索你自己访问过的私有内容。

Hister 解决了三个场景：

  • 个人页面回忆：记得看过某篇文章某个段落，但忘了 URL，用 Hister 搜索关键词直接找到原始页面。
  • 隐私敏感的本地检索：不想把个人浏览数据同步到任何云端，全部留在本机。
  • AI 助手接入：通过 MCP 接口让 AI 助手直接搜索你的浏览历史和本地文件，扩展 AI 的上下文来源而不泄露隐私。

快速安装

方式一：直接下载二进制（推荐）

# 1. 下载对应平台最新 release
# https://github.com/asciimoo/hister/releases/latest
# Linux: hister
# macOS: hister
# Windows: hister.exe

# 2. 添加执行权限（Linux/macOS）
chmod +x hister

# 3. 启动服务器
./hister listen
# Windows 在 PowerShell 中运行：
# .\hister.exe listen

服务器启动后监听 http://127.0.0.1:4433。

方式二：Homebrew

brew install hister
hister listen

方式三：Docker

# 参考 https://hister.org/docs/installing 中的 Docker 说明
docker pull hister/hister:latest
docker run -p 4433:4433 hister/hister:latest listen

方式四：Nix

nix-env -iA hister
hister listen

浏览器插件安装

  1. Chrome/Chromium：访问 Chrome Web Store - Hister 安装
  2. Firefox：访问 Firefox Add-ons - Hister 安装（也支持 Firefox Mobile）
  3. 安装后点击插件图标，确认服务器地址默认已填充为 http://127.0.0.1:4433

打开 http://127.0.0.1:4433 进入 Web 界面。访问几个网页后，再搜索页面正文里的词语，即可看到第一批索引结果。

核心用法

基础搜索

在 Web 界面（http://localhost:4433）直接输入关键词搜索，会返回所有索引页面中包含该词的页面。

查询语言（高级搜索）

Hister 支持比普通关键词丰富得多的查询语法：

# 精确短语搜索
"exact phrase"

# 字段过滤
title:python       # 只搜索标题
url:github.com     # 只搜索特定域名
content:keyword    # 只搜索正文

# 通配符
test*              # 匹配 test, testing, testcase 等

# 否定
-python            # 排除含 python 的结果

# 布尔组合
(title:ai AND content:agent) OR (title:llm AND content:inference)

# 优先级
(title:python OR title:ruby) AND content:tutorial

详细语法见 hister.org/docs/query-language。

从浏览器地址栏搜索

将 Hister 实例添加为浏览器自定义搜索引擎，即可在地址栏直接输入 h <关键词> 跳转到 Hister 搜索。

从终端搜索（CLI/TUI）

Hister 提供 TUI 客户端，无需打开浏览器即可搜索：

# 启动 TUI 客户端（具体命令以实际 CLI 为准）
hister search "your query"

MCP 接口（AI 助手接入）

Hister 提供 MCP（Model Context Protocol）接口，可接入支持 MCP 的 AI 助手，让 AI 直接搜索你的浏览历史和本地文件：

# MCP 配置方式参考 https://hister.org/docs （具体端点和认证参看文档）
# 连接后 AI 助手可发送查询请求，Hister 返回匹配的索引结果

本地文件索引

除了浏览器页面，Hister 还可以索引本地目录：

# 在配置文件中指定本地目录路径，Hister 会递归索引
# 具体配置参看 https://hister.org/docs/configuration#local-directory-indexing

导入已有数据

  • 导入浏览器历史记录：https://hister.org/docs/import#importing-browser-history
  • 导入书签：https://hister.org/docs/import#importing-browser-bookmarks
  • 导入文件：https://hister.org/docs/import#importing-files

典型适用场景

  1. 重拾遗忘的网页：某天看过一篇文章有参考价值，但没收藏，通过 Hister 搜索当时看过的关键词就能找到。
  2. 隐私优先的长期知识管理：不需要任何账号，所有浏览记录和文件索引完全在本地，适合对隐私要求高的用户。
  3. 给 AI 助手喂个人上下文：通过 MCP 让 AI 助手在回答问题时可以查阅你自己的阅读历史，而不需要把浏览记录发给第三方 API。
  4. 团队内部知识库（多用户模式）：Hister 支持多用户，可以在共享服务器上部署，每个人的文档和搜索结果相互隔离。
  5. 本地文档检索：索引本地工作文档（Markdown、PDF 等），通过 Hister 的语义搜索功能快速定位内容。

坑与注意

  1. ⚠️ 服务器必须保持运行：只要希望 AI 客户端、TUI 或浏览器插件能正常工作，Hister Server 进程就不能关闭。关闭终端即终止服务，需要配置为 systemd 等守护进程才能长期运行。
  2. Go 1.26 + npm + C 编译器是源码构建的必要依赖：从源码编译需要 Go 1.26、npm 和 C 编译器（CGO 依赖），不是所有系统开箱就有。
  3. 语义搜索会外发数据：可选的语义搜索（embeddings）功能会将文档内容发送到你配置的 embeddings 端点（可能是第三方 API），需确认该端点的隐私政策。
  4. 默认无认证，仅本机访问：./hister listen 默认只监听 127.0.0.1:4433，不会暴露到网络。若需远程访问或多人使用，需要按文档配置认证和网络暴露。
  5. 浏览器插件仅读取已加载页面内容：插件不会主动访问你正在访问的网站的网络请求（只读取浏览器已加载的内容），对目标网站完全透明，无隐私侵犯风险。
  6. 索引需要时间：新访问的页面不会立即可搜索，取决于插件后台同步频率。

与同类对比

方案 存储位置 全文索引 浏览器插件 MCP 支持 部署难度
Hister 本地 ✅ ✅ Chrome/Firefox ✅ 低
Papar.zero 云端/本地混合 ✅ ❌ ❌ 中
siufficientlysecure/document-viewer 本地 仅本地文件 ❌ ❌ 中
Raycast Notes 云端 ✅ ❌ ⚠️ 有限 低
native macOS Spotlight 本机 ✅ N/A ❌ 无（系统自带）
Logseq 本地文件 ✅ ❌ ⚠️ 有限 中
Neovim/Alfred 等本地检索 本机 ⚠️ 有限 ❌ ❌ 低

结论：Hister 是目前唯一在「本地全文索引」+「浏览器插件自动收集」+「MCP 接口」+「多客户端（Web/TUI/CLI/MCP）」四个维度同时满足的方案，且完全免费开源（AGPLv3），适合注重隐私且需要统一检索个人数字足迹的用户。

一句话推荐结论

想找回「明明看过但忘了在哪」的网页内容，同时不想让任何第三方接触你的浏览记录——Hister 是最干净的选择，五分钟装好、本机运行、MCP 还能让 AI 助手直接查阅你的个人知识库。