# excel-importer-extension

**Repository Path**: kangSri/excel-importer-extension

## Basic Information

- **Project Name**: excel-importer-extension
- **Description**: 亚马逊amazon自动化操作王爷插件
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-11-15
- **Last Updated**: 2025-12-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 亚马逊自动化 - 浏览器插件

这是一个专为亚马逊合规中心设计的Chrome浏览器插件，可以导入Excel文件并自动化处理TRF（测试请求编号）相关操作。

## 功能特性

- 📊 **Excel文件导入**: 支持 .xlsx 和 .xls 格式
- 🔍 **TRF自动搜索**: 从Excel第二行开始自动搜索TRF编号
- 🎯 **一键自动处理**: 自动化完成搜索、点击、选择实验室位置等操作
- 📋 **智能数据标记**: 成功处理的数据显示绿色，失败的显示红色，未处理的显示黄色
- 🏭 **实验室位置选择**: 根据Excel中的Location自动选择测试实验室
- 📈 **处理结果跟踪**: 详细记录每行数据的处理状态和结果
- 💾 **数据持久化**: 导入的数据和处理结果会保存在浏览器中
- 📤 **结果导出**: 支持将处理结果导出为CSV文件

## 安装方法

1. **下载插件文件**
   - 确保所有文件都在 `excel-importer-extension` 文件夹中

2. **在Chrome中安装**
   - 打开Chrome浏览器
   - 访问 `chrome://extensions/`
   - 开启右上角的"开发者模式"
   - 点击"加载已解压的扩展程序"
   - 选择 `excel-importer-extension` 文件夹

3. **验证安装**
   - 在Chrome工具栏中应该能看到插件图标
   - 点击图标打开插件弹窗

## 使用方法

### 1. 导入Excel文件

- 点击Chrome工具栏中的插件图标
- 在弹出的窗口中点击"选择文件"或直接拖拽Excel文件到上传区域
- 插件会自动解析文件并显示数据预览

### 2. 查看数据

- 导入成功后，可以在插件弹窗中查看数据预览
- 显示文件名、工作表名、行数和列数信息
- 预览前10行数据内容

### 3. 在亚马逊合规中心使用

- 访问亚马逊合规中心页面后，右上角会出现一个蓝色的📊按钮
- 点击按钮可以查看已导入的Excel数据
- 点击"一键自动处理"开始自动化操作：
  - 自动搜索Excel中的TRF编号
  - 点击搜索结果中的测试请求编号
  - 根据Location选择相应的测试实验室位置
- 点击"查看处理结果"查看详细的处理状态

### 4. 数据管理

- 点击"清除数据"可以删除已导入的数据
- 数据会自动保存，下次打开插件时会自动加载

## 文件结构

```
excel-importer-extension/
├── manifest.json          # 插件配置文件
├── popup.html             # 插件弹窗界面
├── popup.js               # 插件弹窗逻辑
├── content.js             # 网页内容脚本
├── lib/
│   └── xlsx.full.min.js   # Excel解析库
└── README.md              # 说明文档
```

## 技术特性

- **Manifest V3**: 使用最新的Chrome扩展API
- **SheetJS**: 使用专业的Excel解析库
- **现代UI**: 响应式设计，支持拖拽上传
- **数据持久化**: 使用Chrome存储API保存数据和处理结果
- **自动化操作**: 模拟人工操作，支持搜索、点击、选择等功能
- **智能匹配**: 支持精确匹配和模糊匹配的位置选择
- **状态跟踪**: 实时跟踪每行数据的处理状态

## 支持的文件格式

- Microsoft Excel (.xlsx)
- Microsoft Excel 97-2003 (.xls)

## 浏览器兼容性

- Chrome 88+
- Edge 88+
- 其他基于Chromium的浏览器

## 注意事项

1. **专用性**: 插件专为亚马逊合规中心设计，在其他网站可能无法正常工作
2. **数据格式**: Excel第一行应为标题行，TRF和Location数据从第二行开始
3. **网络延迟**: 自动化操作会添加适当延迟，避免请求过快被系统拦截
4. **数据安全**: 所有数据存储在本地浏览器中，不会上传到服务器
5. **处理顺序**: 按Excel行顺序依次处理，失败的项目可以单独重试

## 故障排除

**问题**: 文件上传失败
- 确保文件是有效的Excel格式
- 检查文件是否损坏
- 尝试重新保存Excel文件

**问题**: 数据显示不正确
- 确保Excel文件中的数据格式正确
- 检查是否有合并单元格或特殊格式

**问题**: 自动化处理失败
- 确保在亚马逊合规中心页面使用插件
- 检查TRF编号格式是否正确
- 确认Location信息与系统中的选项匹配
- 查看处理结果中的详细错误信息

**问题**: 无法找到测试实验室位置
- 检查Excel中的Location数据是否准确
- 确认页面已完全加载
- 尝试手动选择一次位置，确认选择器正常工作

## 更新日志

### v1.0 (2025-11-15)
- 初始版本发布，专为亚马逊合规中心设计
- 支持Excel文件导入和数据解析
- 实现TRF自动搜索功能（从第二行开始）
- 自动点击测试请求编号进入详情页
- 根据Location自动选择测试实验室位置
- 智能数据标记：成功(绿色)、失败(红色)、未处理(黄色)
- 处理结果跟踪和CSV导出功能
- 添加浮动按钮和数据面板