浏览器插件安装指南
概述
本指南将帮助您快速安装和配置我们的浏览器扩展插件。该插件支持 Chrome、Edge 等基于 Chromium 的浏览器。
目录
系统要求
- 浏览器版本：Chrome 88+ / Edge 88+ 或其他 Chromium 内核浏览器
- 操作系统：Windows 10+、macOS 10.13+、Linux
- 网络：需要访问互联网进行初始配置
安装方式
方式一：Chrome Web Store 安装（推荐）
这是最简单的安装方式，适合普通用户。
步骤 1：访问 Chrome Web Store
打开浏览器，访问插件页面：https://chrome.google.com/webstore
步骤 2：搜索插件
在搜索框中输入插件名称，点击搜索按钮。
步骤 3：添加到浏览器
点击 "添加至 Chrome" 按钮。
步骤 4：确认安装
在弹出的确认对话框中，点击 "添加扩展程序"。
步骤 5：安装完成
安装成功后，浏览器右上角会显示插件图标。
方式二：本地开发版安装
适合开发人员或需要使用最新开发版本的高级用户。
步骤 1：获取源代码
克隆项目仓库或下载源代码压缩包：
git clone https://github.com/yourname/yourproject.git
cd yourproject/browser-ext
步骤 2：安装依赖
npm install
步骤 3：构建插件
npm run build
构建完成后，会在 dist 目录生成插件文件。
步骤 4：加载未打包的扩展程序
- 打开浏览器，在地址栏输入：
chrome://extensions/ - 开启右上角的 "开发者模式"
- 点击 "加载已解压的扩展程序"
- 选择项目的
browser-ext/dist目录
步骤 5：验证安装
插件成功加载后，会在扩展列表中显示。
配置说明
首次使用配置
1. 打开插件设置
点击浏览器右上角的插件图标，选择 "设置" 或 "选项"。
2. 配置服务器地址
在设置页面中，输入您的服务器地址：
服务器地址：http://your-server.com:3000
API 密钥：your-api-key-here
3. 测试连接
点击 "测试连接" 按钮，确保配置正确。
4. 保存设置
确认配置无误后，点击 "保存" 按钮。
功能使用
登录账号
- 点击插件图标打开主界面
- 输入用户名和密码
- 点击登录按钮
主要功能
Cookie 管理
插件可以帮助您管理和同步浏览器 Cookie。
代理设置
支持配置代理服务器，实现网络流量管理。
常见问题
Q1: 插件无法加载？
解决方案：
- 确保浏览器版本符合要求（Chrome 88+）
- 检查是否开启了开发者模式
- 尝试重新构建项目：
npm run build - 重启浏览器后再次加载
Q2: 插件图标不显示？
解决方案：
- 点击浏览器工具栏的扩展程序图标（拼图图标）
- 找到插件并点击图钉图标，将其固定到工具栏
Q3: 连接服务器失败？
解决方案：
- 检查服务器地址是否正确
- 确认网络连接正常
- 验证 API 密钥是否有效
- 查看浏览器控制台是否有错误信息（F12 打开开发者工具）
Q4: 如何更新插件？
Chrome Web Store 版本：
- 浏览器会自动更新插件到最新版本
开发版本：
cd browser-ext
git pull origin main
npm install
npm run build
然后在 chrome://extensions/ 页面点击插件的刷新按钮。
Q5: 如何卸载插件？
- 打开
chrome://extensions/ - 找到对应的插件
- 点击 "移除" 按钮
- 在确认对话框中选择 "移除"
技术支持
如果您遇到其他问题，请通过以下方式联系我们：
- GitHub Issues：https://github.com/yourname/yourproject/issues
- 邮箱：support@example.com
- 文档：https://docs.example.com
更新日志
v1.0.0 (2026-02-13)
- ✨ 首次发布
- 🎨 全新的用户界面
- 🔧 Cookie 管理功能
- 🌐 代理服务器支持
许可证
本插件基于 MIT 许可证开源。详见 LICENSE 文件。
注意：截图中的界面可能因版本更新而有所差异，请以实际界面为准。