安装指南

📋 系统要求

浏览器支持

• Chrome (推荐)：版本 88+
• Firefox：版本 90+
• Edge：版本 88+
• Safari：版本 14+

操作系统

• Windows：10/11
• macOS：10.14+
• Linux：Ubuntu 18.04+, CentOS 8+

网络要求

• 支持 HTTPS 协议
• 稳定的互联网连接（用于网页截图）

📥 安装浏览器扩展

从 Chrome 商店安装（推荐）

1. 打开 Chrome 浏览器

   💡 提示：确保使用 Chrome 88 或更高版本以获得最佳体验。

2. 访问 Chrome 扩展商店

   • 打开 Chrome Web Store
   • 搜索 "FullPageScreenshot"

3. 安装扩展

   • 点击 "添加到 Chrome" 按钮
   • 在确认弹窗中点击 "添加扩展"

4. 验证安装

   • 浏览器右上角应该出现 FullPageScreenshot 图标 📸
   • 点击图标测试扩展是否正常工作

从 Firefox 附加组件商店安装

1. 打开 Firefox 浏览器

   • 确保使用 Firefox 90 或更高版本

2. 访问 Firefox 附加组件商店

   • 打开 Firefox Add-ons
   • 搜索 "FullPageScreenshot"

3. 安装扩展

   • 点击 "添加到 Firefox" 按钮
   • 在确认弹窗中点击 "添加"

4. 验证安装

   • 浏览器工具栏应该出现 FullPageScreenshot 图标
   • 点击图标测试扩展功能

开发者版本安装

如果你想安装开发版本进行测试：

1. 下载源代码

   git clone https://github.com/your-repo/fullpagescreenshot.git
   cd fullpagescreenshot/browser_extension

2. 安装依赖

   npm install

3. 构建扩展

   npm run build

4. 加载扩展

   • 打开 chrome://extensions/
   • 开启 "开发者模式"
   • 点击 "加载已解压的扩展程序"
   • 选择 build/chrome-mv3-prod/ 文件夹

🔧 基本配置

首次设置

1. 启动扩展

   • 点击浏览器工具栏中的 FullPageScreenshot 图标
   • 首次使用时会显示欢迎界面

2. 设置偏好

   • 选择默认截图模式
   • 配置保存位置（本地文件夹）
   • 设置快捷键（可选）

权限配置

FullPageScreenshot 需要以下权限：

• 存储权限：保存截图和用户设置
• 标签页权限：访问当前网页进行截图
• 脚本权限：注入必要的 JavaScript 代码
• 下载权限：保存截图到本地

🔍 验证安装

扩展版本验证

1. 检查扩展状态

   • 打开 chrome://extensions/ (Chrome) 或 about:addons (Firefox)
   • 找到 FullPageScreenshot
   • 确保状态为 "已启用"

2. 测试基本功能

   • 打开任意网页
   • 点击扩展图标
   • 尝试进行可见区域截图

3. 检查权限

   • 确保所有必要权限都已授予
   • 测试存储功能

功能测试

1. 测试不同截图模式

   • 可见区域截图
   • 全页面截图
   • 元素选择
   • 区域选择

2. 测试保存功能

   • 检查截图是否保存到正确位置
   • 验证文件名格式
   • 测试不同文件格式

🚨 常见安装问题

扩展无法安装

问题：浏览器提示 "扩展程序无效"

解决方案：

1. 确保下载的是最新版本
2. 检查文件完整性
3. 尝试从官方商店重新安装

权限被拒绝

问题：扩展无法获得必要权限

解决方案：

1. 手动在扩展管理页面开启权限
2. 检查浏览器安全设置
3. 检查是否有其他安全软件阻止

扩展图标不显示

问题：安装后工具栏中没有显示图标

解决方案：

1. 检查扩展是否已启用
2. 点击浏览器菜单中的扩展图标
3. 将 FullPageScreenshot 固定到工具栏

截图功能异常

问题：截图显示空白或错误

解决方案：

1. 刷新网页后重试
2. 检查网页是否有特殊安全设置
3. 尝试不同的截图模式
4. 检查浏览器权限设置

🛠️ 故障排除

基本故障排除步骤

1. 重启浏览器

   • 完全关闭浏览器
   • 重新启动浏览器
   • 测试扩展功能

2. 清除缓存

   • 清除浏览器缓存和Cookie
   • 重新测试扩展功能

3. 禁用其他扩展

   • 临时禁用其他扩展
   • 测试是否为扩展冲突

4. 更新浏览器

   • 确保使用最新版本的浏览器
   • 重新测试扩展功能

调试模式

如果问题仍然存在，可以启用调试模式：

1. 打开开发者工具

   • 按 Ctrl+Shift+I (Windows) 或 Cmd+Opt+I (Mac)
   • 切换到 Console 标签

2. 查看错误信息

   • 操作扩展功能
   • 查看控制台中的错误信息

3. 报告问题

   • 记录错误信息和复现步骤
   • 通过 GitHub Issues 报告问题

📱 移动设备支持

限制说明

FullPageScreenshot 目前主要专注于桌面浏览器，移动设备支持有限：

• Android：Chrome 移动版支持部分功能
• iOS：Safari 和 Chrome 支持基础功能
• 平板设备：功能与桌面版类似

移动设备使用建议

1. 使用桌面版浏览器

   • 在移动设备上使用桌面版浏览器
   • 请求桌面网站

2. 截图替代方案

   • 使用系统内置截图功能
   • 使用其他移动截图应用

🎉 安装完成

恭喜！你已经成功安装了 FullPageScreenshot。现在可以开始使用强大的截图功能了。

下一步：

• 阅读 快速开始指南
• 尝试拍摄你的第一张截图
• 探索不同的截图模式

---

需要帮助？请查看我们的故障排除指南或通过 GitHub Issues 获得支持