# image-detector

**Repository Path**: luozp/image-detector

## Basic Information

- **Project Name**: image-detector
- **Description**: 一个强大的 Firefox 浏览器插件，可以探测网页上的所有图片，并提供多种便捷的操作功能。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-03-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 图片探测器 - Firefox 浏览器插件

一个强大的 Firefox 浏览器插件，可以探测网页上的所有图片，并提供多种便捷的操作功能。

## 功能特性

✨ **图片探测**
- 自动扫描页面中的所有图片
- 支持检测 `<img>` 标签
- 支持检测 CSS 背景图片
- 支持检测 `<picture>` 元素
- 支持检测 `srcset` 响应式图片
- 自动去重，避免重复项

📊 **图片信息**
- 显示图片缩略图预览
- 显示图片尺寸（宽度 × 高度）
- 显示文件大小估算
- 显示完整 URL 路径

🎯 **快速操作**
- 👁️ **在新标签页打开** - 在新标签页中查看完整图片
- 📋 **复制 URL** - 一键复制图片链接到剪贴板
- ⬇️ **单个下载** - 下载单个图片文件
- 📦 **批量下载** - 一次性下载所有图片

🔍 **搜索和筛选**
- 按 URL 关键字搜索
- 按文件大小筛选（小于100KB、100KB-1MB、大于1MB）
- 实时搜索和筛选

## 安装方法

### 方式一：本地调试安装（推荐开发者）

1. 在 Firefox 地址栏输入 `about:debugging`
2. 点击"此 Firefox"
3. 点击"加载临时扩展"
4. 选择项目文件夹中的 `manifest.json` 文件
5. 插件即可激活使用

### 方式二：打包成 XPI 文件

```bash
# 确保项目目录中包含所有必要文件
# 打包成 ZIP 格式，然后重命名为 .xpi
cd /Users/roy/Code/FF_Download
zip -r image-detector.xpi . -x "*.git*"
# 在 Firefox 中打开 XPI 文件进行安装
```

## 项目结构

```
FF_Download/
├── manifest.json          # 插件配置文件
├── popup.html            # 弹窗 UI
├── popup.css             # 弹窗样式
├── popup.js              # 弹窗逻辑
├── content.js            # 内容脚本（在网页中运行）
├── background.js         # 后台脚本
├── icons/                # 图标文件夹
│   ├── icon-16.png
│   ├── icon-48.png
│   └── icon-128.png
└── README.md             # 本文件
```

## 文件说明

| 文件 | 说明 |
|------|------|
| `manifest.json` | Firefox 扩展的配置文件，定义权限、脚本和资源 |
| `popup.html` | 点击工具栏图标打开的弹窗界面 |
| `popup.css` | 弹窗的美观样式表 |
| `popup.js` | 弹窗的交互逻辑处理 |
| `content.js` | 注入到网页中的脚本，负责探测图片 |
| `background.js` | 后台常驻脚本，处理后台任务 |

## 使用方法

1. **安装插件**：按照上述安装方法安装
2. **打开网页**：访问任何包含图片的网站
3. **点击图标**：在 Firefox 工具栏点击"图片探测器"图标
4. **扫描图片**：点击"扫描图片"按钮
5. **查看结果**：等待扫描完成，查看所有发现的图片
6. **操作图片**：
   - 点击 👁️ 在新标签页打开图片
   - 点击 📋 复制图片链接
   - 点击 ⬇️ 下载单个图片
   - 点击"下载全部"批量下载

## 权限说明

本插件需要以下权限：

- `activeTab` - 在活跃标签页中运行
- `scripting` - 注入脚本到网页
- `<all_urls>` - 访问所有网页的资源
- 下载权限 - 用于下载图片

## 技术栈

- **JavaScript** - 核心逻辑
- **WebExtensions API** - Firefox 扩展 API
- **CSS3** - 现代样式

## 开发指南

### 调试插件

1. 打开 `about:debugging`
2. 选择"此 Firefox"
3. 找到"图片探测器"，点击"调试"
4. 在开发者工具中查看日志和调试

### 修改图标

将 PNG 图标文件替换到 `icons/` 文件夹：
- `icon-16.png` - 16×16px
- `icon-48.png` - 48×48px
- `icon-128.png` - 128×128px

### 提升性能

- 增加扫描超时时间
- 优化图片去重算法
- 缓存已扫描页面的图片列表

## 常见问题

### Q: 为什么有些图片没有被检测到？
A: 某些通过 JavaScript 动态加载的图片可能需要等待页面完全加载后再扫描。

### Q: 下载失败怎么办？
A: 检查网络连接，某些跨域图片可能无法直接下载。

### Q: 如何卸载插件？
A: 在 `about:addons` 中找到"图片探测器"，点击删除按钮。

## 更新日志

### v1.0.0 (2024)
- ✅ 初始版本发布
- ✅ 支持多种图片源检测
- ✅ 完整的图片管理功能
- ✅ 美观的 UI 设计

## 许可证

MIT License

## 反馈和建议

如有问题或建议，欢迎提交反馈！

## 开发者

Roy

---

**注意**：此插件完全开源且不收集任何用户数据。所有操作都在本地进行。