# pku_ccl_frequency

**Repository Path**: qfr_bz/pku_ccl_frequency

## Basic Information

- **Project Name**: pku_ccl_frequency
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-30
- **Last Updated**: 2025-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PKU CCL 词频查询工具

## 简介

本工具是一个用于查询**北京大学CCL语料库**中词汇出现频率的Chrome浏览器扩展。可以帮助您批量查询大量词汇的使用频率，并导出为Excel文件，适合语言学研究、教学等场景使用。

## 解决的问题

在CCL语料库网站上查询词频时，只能一个一个手动输入查询。当你需要查询几十个甚至上百个词汇的频率时，手动操作非常耗时且容易出错。

使用本工具可以：

- ✅ 批量查询词汇频率，一次处理上百个词汇
- ✅ 自动从Excel文件读取词汇列表
- ✅ 自动导出查询结果为Excel文件
- ✅ 实时显示查询进度
- ✅ 节省大量时间，提高工作效率

## 功能特点

- 📊 批量查询词汇在CCL语料库中的出现频率
- 📁 支持Excel文件导入（单列文本格式）
- 📥 一键导出Excel结果（包含词汇和出现次数）
- 🎨 清爽的界面设计
- 📈 实时进度显示，随时了解查询状态

## 安装方法

### 第一步：下载扩展文件

**[点击这里下载](../../archive/main.zip)** 扩展文件压缩包，下载完成后解压到你电脑上的合适位置（建议放在桌面或文档文件夹）。

### 第二步：安装Chrome扩展

1. **打开Chrome浏览器**

2. **进入扩展管理页面**
   - 点击浏览器右上角的三个点菜单 ⋮
   - 选择 "扩展程序" → "管理扩展程序"
   - 或者直接在地址栏输入：`chrome://extensions/` 然后按回车

3. **开启开发者模式**
   - 在扩展程序页面的右上角，找到 "开发者模式" 开关
   - 点击开启（开关变为蓝色表示已开启）

4. **加载扩展**
   - 点击左上角的 "加载已解压的扩展程序" 按钮
   - 在弹出的文件选择窗口中，找到并选择你刚才解压的文件夹（选择整个文件夹，不是里面的单个文件）
   - 点击 "选择文件夹" 按钮

5. **确认安装成功**
   - 扩展安装成功后，你会在扩展列表中看到 "PKU CCL词频查询"
   - 浏览器右上角的扩展图标区域也会出现本扩展的图标

### 第三步：准备图标文件（可选）

如果扩展图标显示不正常，可以按以下步骤生成图标：

1. 在浏览器中打开项目文件夹中的 `icons/create_icons.html` 文件
2. 页面会自动下载三个尺寸的图标文件（16x16、48x48、128x128）
3. 将下载的图标文件放在项目的 `icons` 文件夹中
4. 在扩展管理页面点击本扩展的刷新按钮

## 使用方法

### 第一步：准备Excel文件

创建一个Excel文件，**在第一列输入你要查询的词汇**，每行一个词。例如：

```
| 词汇   |
|--------|
| 养不教 |
| 教育   |
| 学习   |
| 思考   |
```

保存为 `.xlsx` 格式。

### 第二步：开始查询

1. **打开扩展**
   - 点击浏览器右上角的扩展图标（拼图图标）
   - 在弹出的列表中找到 "PKU CCL词频查询" 并点击

2. **上传Excel文件**
   - 在弹出的窗口中点击 "选择Excel文件" 按钮
   - 选择你准备好的Excel文件

3. **开始查询**
   - 点击 "开始查询" 按钮
   - 扩展会自动开始批量查询，并显示进度（例如：1/50）
   - 查询过程中请不要关闭窗口

4. **下载结果**
   - 查询完成后，点击 "下载结果" 按钮
   - 结果Excel文件会自动下载到你的电脑

### 查询结果格式

下载的Excel文件包含两列：

```
| 文本   | 出现次数 |
|--------|----------|
| 养不教 | 253      |
| 教育   | 15234    |
| 学习   | 8921     |
| 思考   | 6542     |
```

## 注意事项

⚠️ **重要提醒：**
- 查询过程中请保持网络连接稳定
- 大量数据查询可能需要较长时间，请耐心等待
- 每次查询间隔500毫秒，避免请求过快被服务器拒绝
- 建议每次查询的词汇数量控制在200个以内
- 如果查询中断，可以重新上传文件从头开始

## 常见问题

**Q: 扩展安装后找不到图标怎么办？**

A: 点击浏览器右上角的拼图图标，在扩展列表中找到本扩展，点击图钉图标固定到工具栏。

**Q: 上传Excel文件后没有反应？**

A: 请确保Excel文件格式正确，词汇列表应该在第一列（A列），并且是 `.xlsx` 格式。

**Q: 查询过程中出现错误怎么办？**

A: 可能是网络问题或查询过快，可以稍等片刻后重新尝试。如果持续出现问题，请检查网络连接。

**Q: 可以查询多少个词汇？**

A: 理论上没有限制，但建议每次查询控制在200个词汇以内，以保证查询稳定性和速度。

**Q: 查询结果的"出现次数"是什么意思？**

A: 表示该词汇在CCL语料库中出现的总次数。数字越大，说明这个词汇使用越频繁。

## 技术信息

- Chrome Extension Manifest V3
- SheetJS (xlsx) - Excel 文件处理
- 原生 JavaScript
- CSS3 渐变和动画

## 许可证

MIT License

---

*本工具开源免费，仅供学习和研究使用*