# web-summary-tool

**Repository Path**: guardcode/web-summary-tool

## Basic Information

- **Project Name**: web-summary-tool
- **Description**: 网页摘要插件，用来临时保存网页浏览过程中重要摘要内容
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-18
- **Last Updated**: 2025-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 网页摘要工具 - Firefox扩展

## 项目概述

网页摘要工具是一个功能强大的Firefox浏览器扩展，帮助用户快速保存、管理和导出网页内容摘要。支持文本摘要、图片保存和截图功能，让您轻松收集和整理网页信息。

## 主要功能

### 1. 网页内容摘要
- **自动摘要**：点击扩展图标自动获取当前页面的摘要信息
- **智能提取**：自动提取页面标题、关键内容和元信息
- **时间戳记录**：每条摘要都包含保存时间和页面URL

### 2. 选中文本保存
- **右键菜单**：选中文本后右键选择"摘要选中文本"
- **快速保存**：即时保存选中的重要文本内容
- **上下文保留**：保存文本的同时记录来源页面信息

### 3. 图片摘要功能
- **图片保存**：右键点击图片选择"摘要图片"
- **跨域支持**：支持保存各种来源的图片
- **Base64编码**：图片以Base64格式存储，确保数据完整性
- **错误处理**：无法获取图片时自动保存图片URL

### 4. 截图摘要工具
- **区域截图**：支持自定义选择截图区域
- **交互式选择**：鼠标拖拽选择截图范围
- **实时调整**：支持拖拽移动和8个方向的尺寸调整
- **可视化操作**：半透明遮罩和边框指示器

### 5. 摘要管理
- **弹窗界面**：点击扩展图标查看所有保存的摘要
- **分类显示**：文本和图片摘要分别显示
- **删除功能**：支持单条摘要删除
- **存储限制**：最多保存50条摘要，自动清理旧记录

### 6. 数据导出
- **Markdown格式**：导出为结构化的Markdown文件
- **图片分离**：图片单独保存为PNG文件
- **批量导出**：一键导出所有摘要数据
- **文件命名**：按日期自动命名导出文件

## 技术特性

### 兼容性
- **浏览器支持**：Firefox和Chrome双重兼容
- **API适配**：自动检测并使用相应的浏览器API
- **跨平台**：支持Windows、macOS和Linux

### 数据存储
- **本地存储**：使用浏览器本地存储API
- **数据持久化**：扩展卸载前数据永久保存
- **隐私保护**：所有数据仅存储在本地，不上传服务器

### 性能优化
- **异步处理**：所有操作采用异步模式，不阻塞页面
- **内存管理**：自动清理临时对象和事件监听器
- **存储限制**：智能管理存储空间，防止数据过载

## 安装指南

### 开发者模式安装
1. 打开Firefox浏览器
2. 在地址栏输入 `about:debugging`
3. 点击"此Firefox"
4. 点击"临时载入附加组件"
5. 选择项目文件夹中的 `manifest.json` 文件
6. 扩展安装完成，工具栏出现扩展图标

### 文件结构
```
firefox-extension/
├── manifest.json      # 扩展配置文件
├── background.js      # 后台脚本
├── content.js         # 内容脚本
├── popup.html         # 弹窗界面
├── popup.js          # 弹窗逻辑
└── README.md         # 项目说明
```

## 使用说明

### 基本操作

#### 1. 获取页面摘要
- 点击浏览器工具栏中的扩展图标
- 系统自动提取当前页面摘要
- 摘要保存到本地存储

#### 2. 保存选中文本
- 在网页中选中要保存的文本
- 右键点击选中文本
- 选择"摘要选中文本"菜单项
- 文本自动保存并标记来源

#### 3. 保存图片
- 右键点击网页中的图片
- 选择"摘要图片"菜单项
- 图片自动下载并保存为Base64格式

#### 4. 截图摘要
- 右键点击网页空白处
- 选择"截图摘要"菜单项
- 或点击扩展弹窗中的"截图摘要"按钮
- 拖拽鼠标选择截图区域
- 使用调整手柄精确调整选区
- 点击"确认"保存截图

### 高级功能

#### 截图工具详细操作
1. **选择区域**：鼠标按下拖拽创建选择框
2. **移动选区**：点击选择框内部拖拽移动
3. **调整大小**：拖拽8个调整手柄改变选区尺寸
   - 四角手柄：对角调整
   - 边缘手柄：单向调整
4. **确认截图**：点击"确认"按钮保存
5. **取消操作**：点击"取消"按钮或按ESC键

#### 摘要管理
1. **查看摘要**：点击扩展图标打开管理界面
2. **删除摘要**：点击单条摘要的"删除"按钮
3. **导出数据**：点击"导出摘要"按钮
4. **文件格式**：导出为Markdown文件和图片文件夹

## 权限说明

扩展需要以下权限：
- **storage**：本地数据存储
- **activeTab**：访问当前活动标签页
- **contextMenus**：创建右键菜单
- **<all_urls>**：访问所有网站（用于内容提取）
- **tabs**：标签页操作和截图功能

## 故障排除

### 常见问题

#### 1. 扩展无法加载
- 检查manifest.json文件格式是否正确
- 确认所有文件路径存在
- 查看浏览器控制台错误信息

#### 2. 截图功能不工作
- 确认页面已完全加载
- 检查是否有其他扩展冲突
- 刷新页面后重试

#### 3. 图片无法保存
- 检查图片是否存在跨域限制
- 确认网络连接正常
- 查看是否为受保护的图片资源

#### 4. 摘要数据丢失
- 检查浏览器存储空间是否充足
- 确认扩展未被意外卸载
- 查看浏览器隐私设置

### 调试方法
1. 打开浏览器开发者工具
2. 查看Console面板的错误信息
3. 检查Network面板的网络请求
4. 使用扩展调试页面查看后台脚本

## 开发信息

### 技术栈
- **JavaScript ES6+**：核心开发语言
- **WebExtensions API**：浏览器扩展接口
- **HTML5 Canvas**：图片处理和截图
- **CSS3**：界面样式和动画

### 核心模块
- **background.js**：后台服务和右键菜单
- **content.js**：页面内容交互和截图UI
- **popup.js**：弹窗界面逻辑和数据管理

### 扩展开发
如需修改或扩展功能：
1. 修改相应的JavaScript文件
2. 更新manifest.json配置（如需新权限）
3. 重新加载扩展进行测试
4. 使用浏览器开发者工具调试

## 版本信息

- **当前版本**：1.0
- **兼容性**：Firefox 57+, Chrome 88+
- **更新日期**：2024年

## 许可证

本项目采用开源许可证，允许自由使用、修改和分发。

---

*如有问题或建议，请通过GitHub Issues或邮件联系开发者。*