# english-bilingual-study-notes

**Repository Path**: linziguan/english-bilingual-study-notes

## Basic Information

- **Project Name**: english-bilingual-study-notes
- **Description**: english-bilingual-study-notes 一个英汉双语学习的SKILL，大家可以导入到WorkBuddy，然后将网上想要学习的英文复制到对话框，让AI帮你自动生成学习笔记、语音等成果，学习笔记里包包含了翻译、重点词句、语法学习等，语音清晰。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-23
- **Last Updated**: 2026-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# english-bilingual-study-notes

#### 介绍

english-bilingual-study-notes 是一个英汉双语学习的 SKILL，可以导入到 WorkBuddy 使用。把网上想要学习的英文文章复制到对话框，AI 会自动帮你生成学习笔记、语音等成果：

- **学习笔记（Word 文档）**：包含逐段英中对照翻译、重点词汇、重点句子解析、语法要点、学习建议，排版规范可直接打印。
- **听力语音（MP3）**：基于微软神经网络语音合成，音质清晰，可调语速与段间留白，适合精听、跟读、听写。

#### 功能特性

| 产出 | 内容 | 说明 |
| --- | --- | --- |
| 精读资料 `.docx` | 五节固定结构：① 英中对照译文 ② 重点词汇表（15～25 条，含短语搭配、音标、构词法、易混词提醒）③ 重点句子解析（8～12 句，标注语法结构）④ 语法要点梳理（8～12 项，例句全部取自原文）⑤ 学习建议 | 通过 `assets/study-notes-template.html` 模板生成规范 HTML，再转换为排版统一、深蓝表头 + 中英双字体的 Word 文档 |
| 听力音频 `.mp3` | 免费神经网络语音（无需 API Key），可选美音/英音男女声多种音色，语速 `-30%`～`+15%` 可调，段间留白 `0.8s`～`2.0s` 可调 | 按段落合成后用 ffmpeg 无损拼接，输出 `mp3 / 24000 Hz / mono`，段落与译文编号一一对应，可边听边翻 |

两类产出按需组合：只说「翻译」就只给译文；说「精读 / 学习资料」就出完整 Word；说「听力 / 朗读 / MP3」就只出音频；都要就一并交付。

#### 目录结构

```
english-bilingual-study-notes/
├── SKILL.md                              技能操作手册（AI 的执行说明）
├── assets/
│   └── study-notes-template.html         学习笔记 HTML 模板
├── references/
│   ├── html-docx-conventions.md          HTML 写法约定与 docx 转换排障
│   ├── tts-audio.md                      语音方案选型、安装、音色清单、参数建议
│   ├── install-and-share.md              依赖清单、安装位置、分享前检查表
│   └── walkthrough-wright-brothers.md    一次真实全流程实录（标准答案参照）
└── scripts/
    ├── check_env.py                      环境自检（跨平台、仅标准库，每次会话先跑）
    ├── build_docx.py                     HTML → DOCX 转换封装
    ├── tts_article.py                    文章 → 听力 MP3（分段合成 + 段间静音 + 无损拼接）
    ├── voice_preview.py                  候选语音试听样本生成
    ├── fetch_wheels.py                   pip 无法联网时经 curl 抓轮子离线安装
    └── pack_skill.py                     打包技能为可分发的 zip
```

#### 安装教程

1. 环境要求：Python 3.9+、ffmpeg（音频产出需要）、WorkBuddy（Word 产出依赖其内置 tencent-docx 插件）。
2. 把整个 `english-bilingual-study-notes/` 目录复制到技能目录（**目录名保持不变**，触发词靠它关联）：
   - 用户级（推荐，跨项目可用）：`~/.workbuddy/skills/english-bilingual-study-notes/`
   - 项目级：`<项目根>/.workbuddy/skills/english-bilingual-study-notes/`
3. 跑一次环境自检，它会报告该用哪个解释器、缺什么依赖、怎么补：

```bash
python "<SKILL>/scripts/check_env.py"
```

缺 Word 依赖只影响 Word 产出，缺 edge-tts 只影响音频产出，两者互不阻塞。`check_env.py --json` 中的 `ready.docx` / `ready.tts` 可直接判断当前环境能做哪类产出。

#### 使用说明

导入后，把想学的英文文章（新闻、课文、演讲稿、VOA/BBC/外刊文本均可）粘贴到 WorkBuddy 对话框，直接说明需求即可：

| 你说 | AI 做 |
| --- | --- |
| 「翻译一下」/「英中对照」 | 只给逐段对照译文（纯文本回复） |
| 「帮我精读 / 做成学习资料 / 导出 Word」 | 完整五节学习笔记 + Word 文档 |
| 「做成听力 / 朗读成 MP3」 | 听力音频 |
| 「都做」 | Word + 音频一并交付 |

也可以先只要译文，随后追加「把重点词句语法也列出来，导出 Word」，AI 会沿用已产出的译文补齐内容。

#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

---

#### 赞助支持

如果您也喜欢这个 Skill，觉得它帮您省下了学习整理的时间，可以请作者喝一杯咖啡 ☕

<div align="center">
  <img src="docs/skm.jpg" alt="微信收款码" width="260" />
  <p><sub>微信扫码 · 请作者喝杯咖啡</sub></p>
</div>