安装说明
本文档将指导你如何安装和配置 AI-SideChat 浏览器扩展。
系统要求
- Chrome 浏览器版本 >= 88
- 支持 Manifest V3 的浏览器
- 访问 Google Gemini 或 OpenAI ChatGPT
从源码安装（开发版）
1. 克隆项目
bash
git clone https://github.com/yourusername/AI-Clip.git
cd AI-Clip2. 安装依赖
bash
npm install项目使用以下主要依赖：
- Vite 5.0.0：现代化构建工具
- @crxjs/vite-plugin：Chrome 扩展开发插件
3. 构建扩展
开发模式（支持热重载）：
bash
npm run dev生产构建：
bash
npm run build构建产物会输出到 dist/ 目录。
4. 加载到浏览器
- 打开 Chrome 浏览器
- 访问
chrome://extensions/ - 开启右上角的"开发者模式"
- 点击"加载已解压的扩展程序"
- 选择项目的
dist/目录
5. 验证安装
安装成功后，你应该能在：
- 扩展栏看到 AI-SideChat 图标
- Gemini/ChatGPT 页面看到悬浮坞按钮
- 用户提问旁看到收藏按钮
从 Chrome 商店安装（待发布）
开发中
Chrome Web Store 版本正在准备中，敬请期待。
未来你可以直接从 Chrome Web Store 搜索"AI-SideChat"并安装。
配置说明
权限说明
AI-Clip 需要以下权限：
| 权限 | 用途 |
|---|---|
storage | 存储收藏的对话数据 |
tabs | 实现智能跳转功能 |
host_permissions | 访问 Gemini 和 ChatGPT 页面 |
所有数据都存储在本地，不会上传到任何服务器。
数据存储
- 存储位置：Chrome 本地存储（
chrome.storage.local） - 数据格式：JSON
- 存储大小：受 Chrome 限制（通常为 5MB）
查看存储数据：
- 访问
chrome://extensions/ - 找到 AI-SideChat
- 点击"服务工作进程"下的"检查视图"
- 在控制台执行：
javascript
chrome.storage.local.get(null, (data) => console.log(data))卸载说明
保留数据卸载
- 访问
chrome://extensions/ - 找到 AI-Clip
- 点击"移除"
数据会保留在 Chrome 存储中，重新安装后可恢复。
完全卸载
如需清除所有数据：
- 在卸载前，打开扩展的后台页面
- 在控制台执行：
javascript
chrome.storage.local.clear()- 然后卸载扩展
故障排除
扩展无法加载
问题：提示"清单文件无效"
解决：
- 确保已构建项目（
npm run build） - 检查
dist/manifest.json是否存在 - 尝试重新构建
页面上看不到按钮
问题：在 AI 平台上看不到收藏按钮
解决：
- 确认访问的是支持的平台（gemini.google.com 或 chatgpt.com）
- 刷新页面
- 检查浏览器控制台是否有错误
- 确认扩展已启用
收藏数据丢失
问题：之前的收藏不见了
解决：
- 检查是否意外清除了浏览器数据
- 查看存储数据是否存在（见上文）
- 检查是否有备份
更新扩展
开发版更新
bash
git pull origin master
npm install
npm run build然后在 chrome://extensions/ 点击刷新按钮。
商店版更新
Chrome 会自动更新商店版本的扩展。