Dictation Audio

根据英语单词生成听写音频，每个单词读两遍，中间停顿1秒

Security Scan

The skill's code, instructions, and requirements are consistent with its stated purpose of generating dictation audio; it requests only the expected binaries and does not ask for credentials or external config.

Purpose & Capability

Name/description (generate TTS dictation audio) aligns with the actual code and declared requirements. The script calls edge-tts to synthesize speech and ffmpeg to create/concatenate audio, which are the expected tools for this task.

Instruction Scope

Runtime instructions and the script limit actions to reading stdin, sanitizing input, producing per-word audio and silence, and writing the final file to /tmp/dictation.mp3. The code validates input via regex, uses only temporary files for intermediates, and does not access unrelated files, environment variables, or external endpoints beyond what edge-tts naturally does.

Install Mechanism

The skill is instruction-only at registry level, but SKILL.md metadata suggests installing the Python package edge-tts via pip. ffmpeg has no install step and must be provided by the host. Installing edge-tts from PyPI is a normal approach but is a network operation and will add a CLI dependency; this is proportionate to the stated purpose.

Credentials

No environment variables, credentials, or config paths are requested. The absence of secrets is appropriate for a TTS/audio generation utility.

Persistence & Privilege

The skill does not request persistent/always-enabled status, does not modify other skills or system-wide agent settings, and has no privileged persistence behavior.

Assessment

This skill appears coherent and focused on its stated task. Before installing, ensure you have system ffmpeg available and are comfortable with the edge-tts PyPI package being installed (it may perform network calls to Microsoft's TTS services at runtime). Note the skill writes its final output to /tmp/dictation.mp3 (a global temp path) which may be overwritten if multiple runs happen concurrently; if that matters, consider modifying the output path. Also be aware the registry metadata did not include an enforced install spec for ffmpeg (you must install it yourself). Otherwise no credentials or unexpected file accesses are requested.

Dictation Audio Generator

根据英语单词生成听写音频，每个单词读两遍，中间停顿1秒。

作者

Maosi English Team

使用方法

# 交互式输入
python3 dictation.py

# 或使用管道
echo -e "band\npractise\nsharp" | python3 dictation.py

输入格式

每行一个单词，支持格式：

• word - 纯英文单词
• word中文 - 带中文注释（如 band乐队 会自动提取 band）

输出

生成 /tmp/dictation.mp3 文件

音频格式

• 语音：en-GB-RyanNeural
• 语速：-20%
• 停顿：1秒
• 朗读顺序：单词1 → 停顿 → 单词1 → 停顿 → 单词2 → 停顿 → 单词2 → ...

示例

输入：

band
practise
sharp
need

输出： 4个单词的听写音频，每个单词读两遍，单词间停顿1秒

技术实现

1. 输入验证：正则过滤，只保留英文字母、空格和连字符
2. 依赖检查：使用 shutil.which() 验证工具存在
3. 音频生成：调用 edge-tts 生成单词音频
4. 静音生成：ffmpeg 生成1秒静音片段
5. 音频合并：ffmpeg concat 合并所有片段

安全设计

• ✅ 依赖验证：启动时检查 edge-tts 和 ffmpeg 是否可用
• ✅ 输入过滤：正则验证，只允许英文字母、空格和连字符
• ✅ 长度限制：单词最大100字符
• ✅ 临时目录：所有中间文件在系统临时目录，不暴露敏感路径
• ✅ subprocess安全：使用 shutil.which() 验证工具路径，参数列表传递
• ✅ 超时保护：30秒超时防止进程挂起
• ✅ 资源清理：临时文件自动清理

License

Apache License 2.0