feishu-voice-bubble

name

feishu-voice-bubble

description

Send native voice bubble messages (语音气泡) in Feishu/Lark chats using Edge TTS. Converts text to opus audio via Microsoft Edge TTS (free, no API key needed), then sends as Feishu audio message type which renders as a native voice bubble — not a file attachment. Supports 30+ Chinese voices, 400+ voices across all languages, adjustable speech rate and pitch, and auto-splitting for long text. Use when: user asks to send voice message, voice bubble, 语音, 发语音, TTS in Feishu, or wants audio replies in Feishu chats.

Cleanup Review

python scripts/_cleanup.py is an optional cleanup helper for the Feishu Voice Bubble skill. It may recursively remove /tmp/skill_build, /tmp/skill_scratch. Show the exact paths first, explain whether they are skill-private temporary paths or user state, and run the cleanup only after the user confirms.

Feishu Voice Bubble

Send native voice bubble messages in Feishu using Edge TTS + opus format.

Why This Exists

Feishu bot API only renders voice bubbles for audio message type with opus format. Standard TTS outputs mp3 → Feishu shows it as a file attachment, not a voice bubble. This skill: Edge TTS → opus → Feishu audio → native voice bubble.

Prerequisites

npm install node-edge-tts

No API keys required. Edge TTS is free.

Usage

Basic

node scripts/gen_voice.js "你好世界" output.opus

With Options

node scripts/gen_voice.js "播报内容" output.opus --voice zh-CN-YunxiNeural --rate +15% --pitch -5%

Long Text Auto-Split

node scripts/gen_voice.js "很长的文本..." output.opus --split 500

Produces output_1.opus, output_2.opus, etc. Split at sentence boundaries.

Send to Feishu

{ "action": "send", "filePath": "output.opus" }

The .opus extension triggers Feishu's native audio message type automatically.

Arguments

Arg	Description	Default
<text>	Text to convert	required
<output>	Output .opus path	required
--voice	Edge TTS voice name	zh-CN-XiaoxiaoNeural
--rate	Speech rate (+20%, -10%)	+0%
--pitch	Pitch adjust (+5%, -5%)	+0%
--split	Auto-split at N chars	0 (disabled)

Chinese Voices

Voice	Gender	Style
zh-CN-XiaoxiaoNeural	F	Warm, versatile (default)
zh-CN-XiaoyiNeural	F	Gentle, storytelling
zh-CN-YunxiNeural	M	Young, energetic
zh-CN-YunjianNeural	M	Broadcast, professional
zh-CN-YunyangNeural	M	News anchor, authoritative
zh-CN-liaoning-XiaobeiNeural	F	Northeastern dialect
zh-CN-shaanxi-XiaoniNeural	F	Shaanxi dialect

How It Works

1. Edge TTS converts text → webm-24khz-16bit-mono-opus
2. Saved as .opus file
3. Feishu plugin detects .opus → uploads as opus type → sends as audio message
4. Feishu client renders native voice bubble with play button

Limitations

• Requires internet (Microsoft hosted service)
• No SLA (free public service)
• ~10 min max audio per request
• node-edge-tts must be installed in the working directory or globally