DeskVocab

KO | EN

gitlite — search

#python #llm #go #machine-learning #deep-learning #windows #awesome #kubernetes #awesome-list #security #mcp #ios #openai #open-source

(★ 19)

是摸鱼壁纸，也是你的职业词库

DeskVocab Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DeskVocab — 桌词   摸鱼时学英语，老板还以为你在干活

> 透明桌面单词卡 · AI 场景化生词 · 文档导入提词 · SM-2 间隔复习 · 全程鼠标穿透不影响操作

---

## 🌟 它能干什么？

上班摸鱼刷词汇。

SpeedDic 把 AI 生成的单词卡以**透明浮层**的形式贴在你的 Windows 桌面壁纸上。默认状态下鼠标可以穿透它点击桌面图标，看起来和正常工作毫无区别。想复习时按一下快捷键，按钮出现，打个分，再按一下，消失——整套流程 **3 秒内完成**。

你只需要告诉它你的"当前场景"，比如：

- `互联网架构` → 学 microservice、idempotent、circuit breaker
- `西餐礼仪` → 学 amuse-bouche、sommelier、mise en place
- `健身房` → 学 hypertrophy、compound lift、progressive overload
- `投资银行` → 学 underwriting、due diligence、covenant

或者直接**导入一篇文档**（PDF / Word），AI 自动提取高频词、过滤停用词，生成专属词条。

AI 按场景定制词条，SM-2 算法决定今天该复习哪些——**你只管上班，单词自己跑进脑子里**。

---

## 📦 核心特性

- **透明桌面嵌入**：单词卡置于桌面图标之上，默认鼠标穿透，完全不影响正常操作
- **AI 场景化生成**：输入任意场景，DeepSeek / OpenAI / Kimi / Qwen / GLM 等 OpenAI 兼容模型均可驱动
- **文档导入提词**：上传 `.pdf` / `.docx` / `.doc`，AI 从原文提取有价值的高频词，自动排除虚词
- **SM-2 间隔复习**：科学安排复习周期；四档评分自动调整下次出现时间（详见下表）
- **全局热键 `Ctrl+Alt+S`**：一键切换交互 / 穿透模式，3 秒完成一轮复习
- **本地优先**：学习记录与 API Key 均存于本地 SQLite，无数据上传，离线照常显示已有词库

---

## 🎯 四档评分说明

| 按钮 | 含义 | 下次复习 | Dashboard 状态 |
|------|------|----------|----------------|
| 已掌握 | 基本记住，进入长期队列 | SM-2 算法拉长间隔 | 熟练 |
| 模糊 | 有点印象，需要巩固 | 约 1 天后 | 模糊 |
| 不清楚 | 完全没印象 | 约 10 分钟后 | 不清楚 |
| 跳过 | 早就会了，无需复习 | 不再出现 | 牢记 |

---

## 🛠️ 技术栈

| 模块 | 技术 |
|---|---|
| 核心语言 | Python 3.9+ |
| 图形界面 | PyQt6 |
| 数据库 | SQLite3 |
| AI 协议 | OpenAI Compatible API |
| 热键监听 | pynput |
| 数据校验 | Pydantic |
| PDF 解析 | pdfplumber |
| Word 解析 | python-docx |

---

## 🚀 快速上手（Windows）

### 1. 安装依赖

确保已安装 Python 3.9+（安装时勾选 **Add Python to PATH**）：

```powershell
pip install -r requirements.txt
```

### 2. 启动

建议以**管理员身份**打开 PowerShell / CMD，在项目根目录执行：

```powershell
python src/main.py
```

### 3. 生成单词

**首次使用（配置模型）**

1. 右键系统托盘图标 → **"模型配置"**
2. 选择提供商，填入 API Key 与 Base URL（如 DeepSeek：`https://api.deepseek.com`）
3. 点击"验证连接"确认可用 → 保存

**方式一：场景关键词**

1. 右键系统托盘图标 → **"生成单词"**
2. 在"当前场景"填写你想学的领域
3. 点击"生成" → 后台异步生成，完成后桌面自动展示

**方式二：导入文档**

1. 右键系统托盘图标 → **"生成单词"**
2. 点击"浏览…"选择 `.pdf` / `.docx` / `.doc` 文件，设置生成数量（默认 10 个）
3. 点击"导入并生成单词" → AI 从文档中提取高频词，完成后桌面自动更新

### 4. 日常使用

| 操作 | 效果 |
|---|---|
| 什么都不做 | 单词卡静静显示在壁纸上，鼠标穿透，正常办公 |
| `Ctrl+Alt+S` | 激活交互模式，标题栏变绿，按钮可点击 |
| 点击评分按钮 | SM-2 记录本次复习，自动安排下次出现时间 |
| 点击"跳过" | 标记为牢记，不再参与复习 |
| 再按 `Ctrl+Alt+S` | 恢复穿透，回到摸鱼状态 |

---

## 注意事项

- **管理员权限**：若前台有以管理员身份运行的程序（任务管理器、某些游戏），SpeedDic 也需要管理员权限才能捕获 `Ctrl+Alt+S`
- **高分屏模糊**：如界面模糊，请在系统显示设置中调整缩放比例
- **`.doc` 格式**：需额外安装 `textract` 或系统工具 `antiword`；推荐优先使用 `.docx`

---

## 📋 更新日志

### v1.2
- 模型配置独立：新增「模型配置」托盘菜单，与「生成单词」窗口分离，首次配置流程更清晰

### v1.1
- 新增**文档导入生词**：支持 `.pdf` / `.docx` / `.doc`，AI 自动提取高频词
- 新增**跳过**按钮：直接标记为"牢记"，不再参与复习调度
- SRS 优化："不清楚"复习间隔从 1 天缩短至 **10 分钟**
- 掌握程度状态细化为四档（牢记 / 熟练 / 模糊 / 不清楚），与评分操作一一对应

### v1.0
- 本地数据库管理、AI 场景化单词生成、桌面透明浮层展示

DeskVocab

DeskVocab Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

DeskVocab

DeskVocab Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README