cigen

KO | EN

gitlite — search

#javascript #python #go #golang #rust #deep-learning #windows #awesome #kubernetes #awesome-list #vue #security #ios #openai

(★ 9)

词根词缀记忆工坊 - 基于 PDF 自动提取词根词缀数据，支持检索、拆解联想、闪卡训练和选择题巩固

cigen Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 词根词缀记忆工坊

> **🙏 致谢**
>
> 本项目基于 [@jesselaunz](https://x.com/jesselaunz) 的原始项目 [jesselau76/cigen](https://github.com/jesselau76/cigen) 改造而来。
>
> 感谢原作者的创意和开源分享！本 fork 版本主要增加了 **Vercel 一键部署支持**，让更多人能轻松部署自己的词根词缀记忆工坊。
>
> - **原项目地址**: https://github.com/jesselau76/cigen
> - **原作者 X**: [@jesselaunz](https://x.com/jesselaunz)

---

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/joeseesun/cigen)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub stars](https://img.shields.io/github/stars/joeseesun/cigen?style=social)](https://github.com/joeseesun/cigen/stargazers)

### [🚀 立即体验 →](https://cigen.qiaomu.ai)

**或一键部署你自己的词根词缀记忆工坊 👆**

</div>

---

用[`https://pdfresources.com/`](https://pdfresources.com/)搜索到了一个词根PDF,从而引发这个idea，从其中自动抽取词根词缀与例词，构建交互式记忆 Web App。

## 🆕 本 Fork 版本的改进

相比原项目，本版本增加了以下功能：

| 改进项 | 说明 |
|--------|------|
| 🚀 **Vercel 一键部署** | 添加 `vercel.json` 配置，支持 30 秒快速部署 |
| ⚡ **全球 CDN 加速** | 通过 Vercel 边缘网络，全球访问速度更快 |
| 🔒 **自动 HTTPS** | 无需配置，自动获得 SSL 证书 |
| 📚 **完善的文档** | 详细的本地开发、部署、贡献指南 |
| 📦 **项目元数据** | 添加 `package.json` 和 `LICENSE` 文件 |
| 🎨 **专业 README** | 徽章、特性表格、Star History 等 |

**原项目依然优秀**，如果你只需要 GitHub Pages 部署，推荐直接使用[原项目](https://github.com/jesselau76/cigen)。

---

## 🚀 在线体验

- **本 Fork 自定义域名**: [https://cigen.qiaomu.ai](https://cigen.qiaomu.ai) ⚡️ (推荐)
- **本 Fork Vercel 域名**: [https://cigen-vercel.vercel.app](https://cigen-vercel.vercel.app)
- **原作者 GitHub Pages**: [https://jesselau76.github.io/cigen/](https://jesselau76.github.io/cigen/)

## ✨ 功能特性

| 功能 | 描述 |
|------|------|
| 🔍 **智能检索** | 支持词根、词缀、中文含义多维度搜索 |
| 📖 **词根详情** | 展示例词、拆解规则、中文释义 |
| 🎴 **闪卡训练** | 科学记忆法，支持"显示答案"、"记住"、"再看" |
| 📝 **选择题练习** | 自动生成选择题，本地记录正确率 |
| 💾 **进度保存** | 使用 localStorage 本地保存学习进度 |
| 🎲 **随机词根** | 一键随机学习，让背单词不枯燥 |

## 🛠️ 技术栈

- **前端**: 原生 HTML + CSS + JavaScript（零依赖）
- **数据提取**: Python 3 + PyMuPDF
- **部署**: Vercel / GitHub Pages
- **存储**: localStorage（本地进度）

---

## 📂 项目结构

```
cigen/
├── index.html              # 主页面
├── styles.css              # 样式文件
├── app.js                  # 应用逻辑
├── data/
│   └── roots_affixes.json  # 词根词缀数据
├── scripts/
│   └── extract_pdf_data.py # PDF 数据提取脚本
└── vercel.json             # Vercel 部署配置
```

## 💻 本地开发

### 1. 克隆项目

```bash
git clone https://github.com/joeseesun/cigen.git
cd cigen
```

### 2. 启动本地服务器

**使用 Python**：
```bash
python3 -m http.server 8080
```

**使用 Node.js** (需先安装 `http-server`):
```bash
npm i -g http-server
http-server -p 8080
```

**使用 VS Code**：安装 [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer) 插件，右键 `index.html` → `Open with Live Server`

### 3. 访问应用

打开浏览器访问: `http://localhost:8080`

---

### 🔧 重新生成数据（可选）

如果需要从新的 PDF 提取数据：

```bash
# 确保已安装 PyMuPDF
pip3 install PyMuPDF

# 运行提取脚本
python3 scripts/extract_pdf_data.py
```

## 🚀 部署

### 方式一：一键部署到 Vercel（推荐）

点击页面顶部的 **"Deploy with Vercel"** 按钮，或点击下方链接：

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/joeseesun/cigen)

**优势**：
- ✅ 零配置，30秒完成部署
- ✅ 全球 CDN 加速，访问更快
- ✅ 自动 HTTPS，安全可靠
- ✅ 每次 Push 自动重新部署

---

### 方式二：使用 Vercel CLI 部署

1. **安装 Vercel CLI**：
   ```bash
   npm i -g vercel
   ```

2. **登录 Vercel**：
   ```bash
   vercel login
   ```

3. **部署到生产环境**：
   ```bash
   vercel --prod
   ```

---

### 方式三：GitHub Pages 部署

1. Fork 本仓库到你的 GitHub 账号
2. 进入仓库 `Settings → Pages → Build and deployment`
3. 选择 `Deploy from a branch`，分支选择 `main` / `root`
4. 等待 1-2 分钟，通过 `https://你的用户名.github.io/cigen/` 访问

---

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

### 贡献方式

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交改动 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

---

## 📄 License

本项目采用 [MIT License](LICENSE) 开源协议。

---

## 📱 关注作者

如果这个项目对你有帮助，欢迎关注我获取更多技术分享：

- **X (Twitter)**: [@vista8](https://x.com/vista8)
- **微信公众号「向阳乔木推荐看」**:

---

## ⭐ Star History

如果觉得项目不错，请给个 Star ⭐️ 支持一下！

[![Star History Chart](https://api.star-history.com/svg?repos=joeseesun/cigen&type=Date)](https://star-history.com/#joeseesun/cigen&Date)

cigen

cigen Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

cigen

cigen Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README