refactor: 重组目录结构

- src/ 存放源代码
- docs/ 存放文档
- scripts/ 存放工具脚本
- 移除临时文件
This commit is contained in:
empty
2025-12-03 17:06:53 +08:00
parent 130d280d7a
commit 6059865523
17 changed files with 27 additions and 1056 deletions

87
docs/INSTALL.md Normal file
View File

@@ -0,0 +1,87 @@
# LLM Content Extractor 离线安装指南
## 系统要求
- Chrome 88+ / Edge 88+ / Brave / Arc 等 Chromium 内核浏览器
- 开发者模式权限
## 安装步骤
### 方式一:从源码安装
1. **下载项目**
```bash
git clone git@git.let5see.xyz:let5see/web2mcp.git
cd web2mcp
```
2. **打开扩展管理页面**
- Chrome地址栏输入 `chrome://extensions/`
- Edge地址栏输入 `edge://extensions/`
3. **开启开发者模式**
- 点击页面右上角的 **开发者模式** 开关
4. **加载扩展**
- 点击 **加载已解压的扩展程序**
- 选择项目中的 `src/browser-extension` 文件夹
5. **完成**
- 扩展图标会出现在浏览器工具栏
- 如果没有显示,点击拼图图标 🧩 将其固定
### 方式二:下载 ZIP 安装
1. 从仓库下载 ZIP 包并解压
2. 按照方式一的步骤 2-5 操作
## 更新扩展
1. 拉取最新代码
```bash
git pull origin main
```
2. 在扩展管理页面点击 **刷新** 按钮 🔄
## 常见问题
### Q: 扩展无法使用?
刷新目标页面后重试。首次安装需要刷新已打开的页面。
### Q: 框选模式无响应?
检查页面是否有 CSP (Content Security Policy) 限制,部分网站可能禁止注入脚本。
### Q: 如何卸载?
在扩展管理页面点击 **移除** 按钮。
## 文件说明
```
src/browser-extension/
├── manifest.json # 扩展配置(权限、入口等)
├── popup.html # 弹出窗口界面
├── popup.js # 弹出窗口逻辑
├── content.js # 注入页面的内容脚本
├── content.css # 框选样式
└── icons/ # 图标文件
├── icon.svg # 矢量源文件
├── icon16.png # 16x16 图标
├── icon48.png # 48x48 图标
└── icon128.png # 128x128 图标
```
## 权限说明
| 权限 | 用途 |
|------|------|
| `activeTab` | 访问当前标签页内容 |
| `scripting` | 注入内容提取脚本 |
| `clipboardWrite` | 复制提取结果到剪贴板 |
| `storage` | 保存历史记录和配置 |
## 隐私声明
- 本扩展完全离线运行,不向任何服务器发送数据
- 提取的内容仅保存在本地浏览器存储中
- 不收集任何用户信息