新增通用的浏览器自动化扩展插件

This commit is contained in:
zyj
2025-11-21 14:09:59 +08:00
parent 87a077d40c
commit b448227d3e
17 changed files with 2156 additions and 2 deletions

View File

@@ -0,0 +1,93 @@
# General Auto 扩展安装说明
## 当前状态
扩展已简化,移除了图标依赖,应该可以正常加载。
## 手动安装测试步骤
1. **打开 Chrome 扩展页面**
- 在浏览器地址栏输入:`chrome://extensions/`
- 或者:菜单 → 更多工具 → 扩展程序
2. **启用开发者模式**
- 在右上角打开"开发者模式"开关
3. **加载扩展**
- 点击"加载已解压的扩展程序"
- 选择目录:`d:\Project\go-account-register\expand\general-auto`
4. **验证扩展**
- 应该看到扩展名称:**General Auto**
- 版本1.0.0
- 状态:已启用
5. **测试扩展是否工作**
- 打开任意网页(如 https://www.google.com
- 按 F12 打开控制台
- 输入:`console.log(window.GeneralAuto)`
- 应该看到扩展对象而不是 undefined
## 程序化加载问题排查
如果通过 Rod 加载仍然失败,可能的原因:
### 1. 路径问题
检查日志输出的"扩展目录"是否正确:
```
扩展目录: d:\Project\go-account-register\expand\general-auto
```
### 2. user-data-dir 冲突
临时用户数据目录可能会影响扩展加载。尝试使用固定目录。
### 3. Chrome 版本兼容性
Manifest V3 需要 Chrome 88+ 版本。
## 替代方案
如果自动加载仍有问题,可以使用以下方法:
### 方案 1: 使用固定的 user-data-dir
```go
userDataDir := "user-data/with-extension"
```
### 方案 2: 手动复制扩展到 user-data 目录
程序启动前,将扩展复制到用户数据目录的 Extensions 文件夹。
### 方案 3: 使用打包的扩展
```bash
# 在 general-auto 目录打包
chrome --pack-extension=d:\Project\go-account-register\expand\general-auto
```
然后使用 .crx 文件加载。
## 调试建议
在 chrome.go 中添加更多日志:
```go
log.Println("扩展目录:", expandPath)
log.Println("用户数据目录:", absPath)
log.Println("Chrome 路径:", path)
// 验证扩展目录是否存在
if _, err := os.Stat(expandPath); os.IsNotExist(err) {
log.Fatal("扩展目录不存在:", expandPath)
}
// 验证 manifest.json 是否存在
manifestPath := filepath.Join(expandPath, "manifest.json")
if _, err := os.Stat(manifestPath); os.IsNotExist(err) {
log.Fatal("manifest.json 不存在:", manifestPath)
}
```
## 当前 manifest.json 配置
已移除图标依赖,使用最小化配置:
- ✅ manifest_version: 3
- ✅ 基础权限tabs, cookies, storage, scripting
- ✅ background service worker
- ✅ content scripts
- ❌ 图标(暂时移除,不影响功能)