晚托默写工作流 v1.1

> 上海夸夸教研社 出品，面向晚托老师、家长和家教场景的默写练习自动化工具。输入词语/词表，一键生成可直接打印的练习 PDF（看拼音写汉字 + 书写线 + 夸夸鼓励 logo）+ 配套听写录音 MP3（词语+造句朗读，两遍跟读 + 停顿），覆盖语文和英语两学科，省去人工报默、排版、录音的繁琐工作。

生成语文/英语默写练习PDF + 录音MP3的完整工作流。

启动关键字

用户通过以下关键字触发本技能（任意出现一个即命中）：

• 默写 — 最常见的触发词
• 课后 — 如"课后生字表"、"课后练习"
• 词语表 — 如"词语表16+17"
• 听写 — 如"听写录音"
• 背诵 — 如"背诵检查"
• 复习 — 如"复习综合默写"
• 日积月累 — 如"日积月累快慢词"
• 知识点 — 如"知识要点默写"
• 生字 — 如"第一单元生字"
• 拼写 — 如"拼写检查"
• 其他与"字词练习"、"语文/英语基础训练"相关的泛化表述

触发条件

用户需要为学生生成默写材料时触发，包括：

• "XX学生，语文第X课词语默写"
• "XX学生，英语Unit X默写"
• "XX学生，英语句子默写"
• 任何涉及"默写"、"PDF"、"MP3"、"录音"的需求

执行流程

步骤1：确认信息

从用户输入中提取：

1. 学生姓名（支持多姓名）
2. 课题名称（如"语文第21课词语"、"英语U8句子"）
3. 内容列表（词语或句子）

步骤2：判断模式

步骤3：检查翻译/造句表

关键检查点：

• 英语内容必须有中文翻译（TRANSLATIONS字典）
• 语文内容必须有造句（WORDS_SENTENCES字典）
• 如果缺少，立即补充，不要等用户提醒

步骤4：生成PDF

语文PDF：

• 工具：gen_dictation.py
• ⚠️ 只显示拼音，不显示汉字（学生看拼音写汉字，这才是默写）
• ⚠️ 拼音必须带 Unicode 声调符号（如 hóng shuǐ，不能用 ASCII hong shui），否则 PDF 无法正确显示声调
• 推荐方法：用 pypinyin 自动生成带声调的拼音

```python

from pypinyin import pinyin, Style

py = ' '.join([p[0] for p in pinyin('汉字', style=Style.TONE)])

```

• 字体：用微软雅黑（msyh.ttc），对拉丁扩展字符（声调符号）支持更好
• 备份方案：如果 pypinyin 多音字不准，手动校正到 WORDS 列表
• 严禁：手写 ASCII 拼音（如 hong shui）——这会导致声调丢失
• 布局：两栏，行高22mm，拼音+双书写线
• 底边距≥28mm（留足Logo空间，避免末尾词语被遮挡）
• Logo规范：源文件 D:/logo/logo(1).png，页脚底端居中，等比缩放约80，页眉显品牌名，页脚含logo+标语+页码
• 保存：D:\wtb\语文默写\{姓名}_{课题}_{日期}.pdf

英语PDF：

• 工具：gen_english_pdf.py
• 布局：自动判断
• 单词/短语 → 4列，行高55
• 句子 → 2列，行高90
• 显示：中文翻译 → 学生写英文
• 保存：D:\wtb\英语默写\{姓名}_{课题}_{日期}.pdf

步骤5：生成录音

语文录音：

• 工具：gen_dictation_audio.py
• TTS API格式：使用流式API（req_params + speaker），返回为JSON lines，逐行base64解码拼接
• ⚠️ 录音结构：{词语}。{造句}。 读两遍 → 停顿4秒
• 示例：打猎。猎人在森林里打猎。打猎。猎人在森林里打猎。 → 4秒静音
• 造句要简单、通顺，贴合课文语境
• 开场白：夸夸晚托班——{日期}。课题：{课题}。
• 结束语：听写结束，请认真检查。
• 保存：D:\wtb\语文默写\{姓名}_{课题}_{日期}.mp3

英语录音：

• 工具：gen_english_audio.py
• 单词模式：1. {单词}。{造句}。{造句}。（间隔4秒）
• 句子模式：1. {句子}。{句子}。（间隔5秒）
• 混合模式：先短语（不造句，读2遍）+ 过渡语 + 句子（读2遍）
• 保存：D:\wtb\英语默写\{姓名}_{课题}_{日期}.mp3

步骤6：文件管理

• 文件被占用时自动加后缀 _v2、_v3...
• 记录到 .workbuddy\memory\YYYY-MM-DD.md

核心规则

1. 翻译必须完整

• 所有英语内容必须有中文翻译
• 新内容补充到 TRANSLATIONS 字典
• 翻译要准确、简洁

2. 造句必须人工编写

• 不要用"请用XX造句"模板
• 造句要简单、通顺、便于理解
• 新词语补充到 WORDS_SENTENCES 字典

3. 开场白统一

• 所有录音开场：夸夸晚托班——{日期}。
• 接着：课题：{课题}。

4. 编号统一

• 使用数字编号：1. 2. 3.
• 不用"第X题"

5. 文件路径

• 语文：D:\wtb\语文默写\
• 英语：D:\wtb\英语默写\

技术栈

• PDF生成：reportlab + pypinyin（语文）
• 语音合成：火山引擎豆包语音v3 API
• ⚠️ 必须用 v3 unidirectional 端点：https://openspeech.bytedance.com/api/v3/tts/unidirectional
• ❌ 禁止用 v1：/api/v1/tts 不支持 req_params 嵌套对象，会报 3031 错误
• 凭证：在代码中设置环境变量或替换占位符，不要硬编码在skill文件里

```python

VOLC_APP_ID = os.environ.get("VOLC_APP_ID", "YOUR_APP_ID_HERE")

VOLC_ACCESS_KEY = os.environ.get("VOLC_ACCESS_KEY", "YOUR_ACCESS_KEY_HERE")

```

• 响应处理：逐行解析 JSON，仅当 code == 0 且 obj.get('data') 时才解码 base64，不是 'data' in obj

```python

for line in resp.text.strip().split('\n'):

obj = json.loads(line)

code = obj.get('code', -1)

if code == 20000000: break

if code == 0 and obj.get('data'):

audio_data += base64.b64decode(obj['data'])

```

• 音色：zh_female_vv_uranus_bigtts（Vivi女声）
• headers: X-Api-App-Id, X-Api-Access-Key, X-Api-Resource-Id: seed-tts-2.0, Content-Type: application/json
• ⚠️ 运行TTS脚本必须加 PYTHONUNBUFFERED=1，否则输出缓冲导致看不到进度：

```bash

PYTHONUNBUFFERED=1 python gen_xxx_audio.py

```

• 音频处理：pydub + ffmpeg
• 字体：C:/Windows/Fonts/msyh.ttc（微软雅黑）

关键文件

示例

语文默写

学生：小明
课题：语文第21课词语
均匀、搓、厚实、暖和、决定...

英语单词默写

学生：糖糖
课题：U8英语默写
frog, fish, duck, shark...

英语句子默写

学生：小红
课题：英语知识点U8句子默写
I see a frog by the lake.
Little fish in the river sing a song of "Blub, blub".
...

英语混合默写

学生：小刚
课题：M4U1Mybody英语默写
短语：Touch your shoulder, Touch the knees, Stretch your arms
句子：Can you draw yourself, Danny? ...