英语 | 中文

功能特性

[!TIP] 本项目正处于快速开发中。建议使用带有自动更新功能的 Docker（如 Watchtower），以保持最新版本。

功能	描述
🤖 AI内容处理	利用AI进行摘要生成、翻译以及智能内容分析，并支持自定义快捷键
🔌 MCP & Agent Skills	MCP服务器 + Agent Skills，用于AI助手搜索您的知识库、RSS订阅源、推文及亮点内容。可通过 npx skills add lcomplete/huntly 安装
📚 网页存档	自动保存并归档网页，借助 Defuddle 和 Mozilla Readability 提取内容
📡 RSS订阅管理	集中管理所有RSS订阅，具备智能分类、OPML导入导出及全文检索功能
🔍 强大的全文检索	基于Apache Lucene与IK Analyzer实现中文文本分词，支持布尔运算符及模糊搜索
🐦 社交媒体集成	特别针对Twitter/X进行处理，自动重建推文线程并保留媒体内容
⭐ GitHub集成	同步并整理您的GitHub星标，附带仓库元数据及README提取
🔒 隐私与自托管	100%自托管，采用SQLite数据库、Docker部署，完全掌控数据所有权
💻 多平台支持	Web应用、Chrome扩展（Manifest V3）以及桌面应用（Tauri）

路线图

• 将所有保存内容导出为Markdown
• 灵活的组织方式：收藏集
• 增强扩展功能，实现独立AI处理（无需服务器）

截图

快速开始

第一步：安装浏览器扩展

浏览器扩展是自动保存网页和Twitter内容的关键。

Chrome:

• 从Chrome网上应用店安装

第二步：运行服务器

选择以下任一方法来运行Huntly服务器：

方案A：Docker Compose（推荐）

创建一个 docker-compose.yml 文件：

version: '3.8'

services:
  huntly:
    image: lcomplete/huntly
    container_name: huntly
    restart: always
    ports:
      - "8088:80"
    volumes:
      - ~/data/huntly:/data
    labels:
      - "com.centurylinklabs.watchtower.enable=true"

建议使用Watchtower进行自动更新，以便及时获取最新功能。

然后运行：

docker-compose up -d

方案B：桌面客户端

从Releases下载适用于您操作系统的安装包，安装后即可运行。

如果您在macOS上遇到错误提示 "Huntly.app" is damaged and can't be opened，请运行：

sudo xattr -r -d com.apple.quarantine /YOUR_PATH/Huntly.app

更多选项请参阅运行服务器wiki。

第三步：配置扩展并登录

1. 点击Huntly扩展图标，设置服务器地址。对于远程访问，强烈建议使用HTTPS以保护隐私。
2. 首次打开Huntly网站以注册管理员用户。
3. 注册完成后，您将自动登录，扩展程序只会将相关浏览数据（如已保存的页面和推文）发送到服务器。

尽情享受吧！

参与贡献

[!IMPORTANT] 所有Pull Request必须提交至dev分支。

成为赞助商

如果您觉得Huntly很有帮助，请考虑支持它的开发！

赞助商

感谢所有赞助商的慷慨支持！

augment code

jetbrains

TARESKY

抹茶

jtsang4

Huntly 快速上手指南

Huntly 是一个自托管的 AI 驱动信息中心，通过浏览器插件捕获、处理并组织网页内容，将浏览转化为可操作的知识库。

环境准备

• 操作系统：支持 Linux, macOS, Windows。
• 运行方式：
  • 推荐：Docker & Docker Compose（需安装 Docker Engine）。
  • 备选：桌面客户端（Tauri 构建，支持主流桌面系统）。
• 浏览器：Chrome 或其他基于 Chromium 的浏览器（用于安装扩展程序）。
• 网络：若使用远程访问，建议配置 HTTPS 以保障隐私。

安装步骤

1. 部署服务端 (推荐 Docker Compose)

创建 docker-compose.yml 文件：

version: '3.8'

services:
  huntly:
    image: lcomplete/huntly
    container_name: huntly
    restart: always
    ports:
      - "8088:80"
    volumes:
      - ~/data/huntly:/data
    labels:
      - "com.centurylinklabs.watchtower.enable=true"

提示：配置中已包含 Watchtower 标签，可实现自动更新。

启动服务：

docker-compose up -d

(备选方案：也可从 Releases 下载桌面客户端安装包。macOS 用户若遇报错 "Huntly.app" is damaged，请运行 sudo xattr -r -d com.apple.quarantine /YOUR_PATH/Huntly.app)

2. 安装浏览器扩展

前往 Chrome 网上应用店安装官方插件：

• 安装链接：Huntly - Chrome Web Store

3. 初始化配置

1. 注册管理员：在浏览器访问 http://localhost:8088 (或你部署的域名)，首次打开时注册一个管理员账号。
2. 配置插件：
   • 点击浏览器工具栏中的 Huntly 插件图标。
   • 在设置中输入服务端地址（本地部署通常为 http://localhost:8088）。
   • 登录刚才注册的账号。

基本使用

完成上述步骤后，即可开始构建你的知识库：

1. 保存网页：浏览任意网页时，点击插件图标或使用快捷键，即可将当前页面内容（经 AI 清洗和摘要）保存至 Huntly 库中。
2. 管理 RSS：在 Huntly 网页端导入 OPML 文件或添加 RSS 订阅源，系统将自动抓取并全文索引。
3. AI 交互：
   • 在网页端对已保存的内容进行智能总结、翻译或分析。
   • 进阶用法：通过 MCP (Model Context Protocol) 将 Huntly 接入其他 AI Agent。在终端运行以下命令安装技能：

     npx skills add lcomplete/huntly
     

     安装后，你的 AI 助手可直接搜索 Huntly 中的知识库、RSS feed 和高亮内容。

现在，你可以尽情享受由 AI 驱动的个性化信息枢纽了！