# 记忆蜂插件

**Repository Path**: fiagainster/recall-bee-plugin

## Basic Information

- **Project Name**: 记忆蜂插件
- **Description**: 记忆蜂是一款强大的浏览器全文历史记忆增强插件，专为解决用户"看过但找不到"的浏览痛点而生。它能自动为您访问过的网页建立本地全文索引，让您通过关键词瞬时检索所有历史内容，精准定位原文片段并跳转回对应网址。支持中英文混合搜索、跨域聚合查询，且数据100%存储在本地，确保隐私安全。通过简洁的界面和快捷键操作，记忆蜂成为您的"第二大脑"，让知识检索不再受限于浏览器原生历史记录的局限，显著提升信息获取效率。
- **Primary Language**: JavaScript
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-26
- **Last Updated**: 2026-01-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 记忆蜂 - 浏览器全文历史记忆增强插件

## 项目介绍

记忆蜂是一个强大的浏览器扩展插件，旨在解决用户在大量网页浏览后"看过但找不到"的核心痛点。通过本地全文索引技术，为用户访问过的所有网页内容建立私有的、可瞬时检索的"第二大脑"。

## 核心功能

### 1. 无感后台索引
- 用户浏览网页时，插件自动在后台提取页面纯文本内容
- 智能建立本地索引，用户无感知
- 支持单页应用(SPA)的动态内容捕获

### 2. 瞬时全文检索
- 通过快捷键(Ctrl+Shift+K)或图标唤起搜索框
- 输入任意关键词或短语，可瞬间在所有已索引的历史页面中进行全文检索
- 支持中英文混合搜索

### 3. 精准上下文定位
- 返回的结果直接高亮显示关键词所在的原文片段
- 点击后可精准跳转回原网页的对应位置
- 提供详细的搜索结果摘要

### 4. 跨域聚合搜索
- 无视信息来自知乎、GitHub、技术博客等不同网站
- 在统一入口完成聚合搜索
- 打破信息孤岛，实现知识的无缝连接

### 5. 隐私优先设计
- 所有索引数据100%存储在用户本地设备
- 永不发送至云端服务器
- 支持白名单管理，可排除不需要索引的网站

## 安装说明

### 手动安装（推荐）
1. **打开浏览器扩展管理页面**
   - Chrome/Edge: 访问 `chrome://extensions/` 或 `edge://extensions/`
   - Firefox: 访问 `about:addons`

2. **启用开发者模式**
   - Chrome/Edge: 在扩展管理页面右上角开启"开发者模式"
   - Firefox: 无需开发者模式，直接进入下一步

3. **加载扩展**
   - Chrome/Edge: 点击"加载已解压的扩展程序"按钮，选择本插件所在文件夹
   - Firefox: 点击"设置"图标 → "调试附加组件" → "临时载入附加组件"，选择本插件的manifest.json文件

4. **完成安装**
   - 安装成功后，浏览器工具栏会出现记忆蜂的图标
   - 点击图标即可开始使用

### 快捷键
- 默认快捷键：`Ctrl+Shift+K` (Windows/Linux)
- Mac：`Command+Shift+K`

## 使用方法

### 1. 开始搜索
- 点击浏览器工具栏中的记忆蜂图标，或使用快捷键唤起搜索界面
- 在搜索框中输入关键词，点击"搜索"按钮或按回车键
- 等待搜索结果显示

### 2. 查看搜索结果
- 搜索结果会按照相关性排序显示
- 每个结果包含：页面标题、关键词高亮的上下文片段、URL、访问时间
- 点击任意结果可跳转到对应的网页

### 3. 管理索引
- 在搜索界面点击"清除索引"按钮可清除所有索引数据
- 在设置页面可查看存储使用情况

## 配置选项

### 插件状态
- 可在弹出界面或设置页面启用/禁用插件
- 禁用后不会继续建立新索引，但已有的索引数据会保留

### 白名单管理
- 在设置页面可添加不需要索引的网站域名
- 白名单中的网站内容将不会被记忆蜂索引
- 支持批量管理白名单项目

### 存储设置
- 可配置索引数据的保留天数（默认30天）
- 超过保留天数的索引数据会被自动清理
- 可手动清除所有索引数据

## 技术架构

### 核心模块
1. **内容提取模块**：注入到每个页面，负责提取清理后的纯文本内容
2. **索引与存储模块**：实现轻量级倒排索引，使用IndexedDB存储数据
3. **搜索与查询模块**：执行全文检索，实现基础的相关性排序
4. **用户交互模块**：提供简洁的搜索界面和结果展示

### 技术特点
- 采用 Chrome Extensions (Manifest V3) 标准开发
- 支持 Chromium 内核浏览器（如 Edge、Chrome）
- 优化的分词算法，支持中英文混合搜索
- 智能的内容提取策略，确保捕获主要内容

## 注意事项

1. **存储空间**
   - 插件会在本地存储索引数据，可能会占用一定的存储空间
   - 建议定期清理过期索引数据

2. **性能影响**
   - 索引过程在后台进行，对浏览体验影响较小
   - 对于大型页面，可能会有短暂的处理时间

3. **隐私保护**
   - 所有数据存储在本地，不会上传至任何服务器
   - 建议将敏感网站添加到白名单，避免被索引

4. **兼容性**
   - 主要支持 Chrome 和 Edge 浏览器
   - Firefox 浏览器支持临时安装，功能可能有所差异

## 开发者信息

- **版本**：1.0.0
- **开发者**：Fiagainster
- **许可证**：MIT

## 反馈与支持

如果您在使用过程中遇到任何问题，或有任何建议，欢迎通过以下方式联系我们：

- 提交Issue到项目仓库
- 发送邮件至：508125305@qq.com

---

**隐私优先，本地存储** - 记忆蜂致力于为用户提供安全、高效的浏览历史检索体验。