# CAAC cacheFile

**Repository Path**: Agent_Rich/caac-cache-file

## Basic Information

- **Project Name**: CAAC cacheFile
- **Description**: 一个chrome插件，用来辅助CAAC无人机机构报名时，多学员报名的材料上传工作。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CAAC UOM 学员材料上传辅助

一款 Chrome 浏览器插件，用于辅助飞行培训机构在 [CAAC UOM 系统](https://uom.caac.gov.cn) 中批量上传学员的身份证明、身体情况说明和无犯罪记录文件。

## 功能特性

- **批量加载材料**：选择本地文件夹，自动按命名规则解析并归类到对应学员名下
- **屏蔽上传弹窗**：开启后拦截页面原生文件选择框，由插件接管文件上传流程
- **一键上传**：点击学员条目的上传按钮，自动将三类材料依次填入 UOM 系统的上传组件
- **搜索筛选**：支持按学员姓名实时搜索，快速定位目标学员
- **单条删除 / 全部清空**：灵活管理已加载的学员材料缓存

## 文件命名规范

材料文件需放在同一文件夹内，命名格式为：

```
{姓名}_{文件类型}.{扩展名}
```

其中文件类型为以下三种之一：

| 文件类型 | 对应 UOM 表格行号 |
|---|---|
| 身份证明 | 第 1 行 |
| 身体情况说明 | 第 3 行 |
| 无犯罪记录文件 | 第 4 行 |

支持的扩展名：`pdf`、`jpg`、`jpeg`、`png`

示例：

```
张伟_身份证明.png
张伟_身体情况说明.pdf
张伟_无犯罪记录文件.png
```

## 安装方式

**由于Chrome的最新限制，打包好的.crx文件本店装后无法使用，需要开启开发者模式安装。**

1. 将本项目文件下载至本地（代码列表右上角`克隆/下载`，弹窗里选择`下载zip`），并解压。
2. 打开 Chrome，进入 `chrome://extensions/`
3. 开启右上角「开发者模式」
4. 点击「加载已解压的扩展程序」，选择本项目根目录
5. 插件图标出现在浏览器工具栏即安装成功

## 使用流程

1. 在浏览器中打开 UOM 系统的学员培训信息页面
2. 点击插件图标，打开弹窗面板
3. 点击「选择材料文件夹」，选择包含学员材料的文件夹
4. 进入单个学员的资料上传页面
5. 开启「屏蔽上传弹窗」开关
6. 在学员列表中找到目标学员（可使用搜索框），点击「上传该学员材料」

## 项目结构

```
├── manifest.json      # 插件配置（Manifest V3）
├── background.js      # Service Worker 后台脚本
├── content.js         # 内容脚本（注入 UOM 页面）
├── popup.html         # 弹窗页面
├── popup.css          # 弹窗样式
├── popup.js           # 弹窗逻辑
└── icons/             # 插件图标
```

## 技术说明

- 基于 Chrome Extension Manifest V3
- 使用 `chrome.storage.local`（含 `unlimitedStorage` 权限）缓存学员文件数据
- 通过 `DataTransfer` API 构造文件对象，模拟原生文件选择行为完成上传
- 通过捕获阶段事件拦截 + `HTMLInputElement.prototype.click` 重写实现弹窗屏蔽

## 许可证

[MIT](LICENSE)