dsh-audiogen 0.4.12 → 0.4.13

package/README.md

@@ -1,6 +1,6 @@
 # 🎧 dsh-audiogen
 
-**AI audio generation for DeepSeek Harness (DSH)** — turn your DSH web GUI into an audio studio: text-to-speech, music, sound effects and voice design, from a sidebar panel or straight from the Agent.
+**AI audio generation for DeepSeek Harness (DSH)** — turn your DSH web GUI into an audio studio: text-to-speech, music, sound effects and voice design, from the sidebar panel or straight from the Agent.
 
 [English](README.md) | [简体中文](README.zh-CN.md)
 
@@ -13,13 +13,13 @@
 
 ## ✨ Features
 
-- **Four generation modes**: 文本转语音 (TTS) · 音乐生成 (Music) · 音效生成 (Sound effects) · 音色设计 (Voice design)
+- **Four generation modes**: text-to-speech, music, sound effects, and voice design
 - **Multi-vendor channels in one place**: OpenAI-compatible TTS, MiniMax, ElevenLabs, Stability AI, or any custom OpenAI-compatible / generic POST endpoint
-- **Per-channel model & voice catalogs** with one-click discovery, aliases, capability categories and per-model advanced fields (duration, seed, steps, cfg_scale, loop, prompt influence, …)
-- **Model comparison**: same prompt across 2–4 models with per-model parameter overrides — results grouped side by side
-- **✨ Prompt enhancement**: rewrite any rough idea into a ready-to-generate description with an LLM (choose any model from *Settings → Models*; falls back to the agent default model)
+- **Per-channel model & voice catalogs** with one-click discovery, display aliases, capability categories, and per-model advanced fields (duration, seed, steps, cfg_scale, loop, prompt influence, …)
+- **Model comparison**: run the same prompt across 2–4 models at once with per-model parameter overrides — results are grouped side by side
+- **Prompt enhancement**: rewrite a rough idea into a ready-to-generate description with an LLM (pick any model from *Settings → Models*; falls back to the agent default model)
 - **History with one-click restore**: prompt, config, model set *and the original audio* come back into the panel — no regeneration, no extra cost
-- **Resource library**: auto-save generated audio (or opt-in per run), organized by type — voices / music / sfx / TTS — with search, tags, rename, category moves, and full provenance (channel, model, voiceId, prompt, params snapshot). Reuse a voice or music bed instead of regenerating
+- **Resource library**: auto-save generated audio (or opt in per run), organized by type — voices / music / SFX / TTS — with search, tags, rename, category moves, and full provenance (channel, model, voice id, prompt, params snapshot). Reuse a voice or music bed instead of regenerating
 - **Agent tools**: `generate_audio` and `search_audio_library`, plus bundled session skills — the Agent can generate and find audio on demand
 - **Keys stay local**: API keys live in the local DSH settings document and generation is proxied by the local host; the browser and the Agent never touch plaintext credentials
 
@@ -51,18 +51,18 @@ Local development install:
 dsh plugin --profile web add /path/to/dsh-audiogen
 ```
 
-Restart `dsh web` after install — the sidebar will show **AI 音频**.
+Restart `dsh web` after install — the sidebar will show the **AI Audio** entry.
 
 ## 🚀 Quick start
 
-1. Open **Settings → Plugins → AI 音频**
+1. Open **Settings → Plugins → AI Audio**
 2. Add a channel: pick a preset provider (+ Add provider) or a custom endpoint (+ Add custom provider)
 3. Fill in the API URL, API key, and the model/voice catalog (use *Fetch available models* to import them)
-4. Save, then open the **AI 音频** sidebar panel:
-   - choose a mode (TTS / Music / SFX / Voice design)
-   - type your text or prompt (optional: ✨ 增强提示词)
-   - pick a model — or tick 模型对比 for 2–4 models at once
-   - hit **开始生成** and play the results, download them, or add them to the 资源库
+4. Save, then open the **AI Audio** sidebar panel:
+   - choose a mode (Speech / Music / Sound effects / Voice design)
+   - type your text or prompt (optional: ✨ Enhance prompt)
+   - pick a model — or tick **Model comparison** for 2–4 models at once
+   - press **Start generation** and play the results, download them, or add them to the resource library
 
 ## 🎛 Modes supported by each vendor
 
@@ -70,7 +70,7 @@ Restart `dsh web` after install — the sidebar will show **AI 音频**.
 | --- | --- | --- | --- | --- |
 | TTS | ✅ (8 voices) | ✅ (voices + streams) | — | ✅ |
 | Music | ✅ (`music-3.0` / `music-2.6` / `music-cover`) | ✅ (`music_v2`) | ✅ (`stable-audio-*`) | ✅ (generic POST) |
-| Sound effects | — | ✅ (`eleven_text_to_sound_v2`, loop / prompt_influence) | ✅ (`stable-audio-*` — same text-to-audio protocol, auto-detected in music + SFX) | ✅ (generic POST) |
+| Sound effects | — | ✅ (`eleven_text_to_sound_v2`, loop / prompt influence) | ✅ (`stable-audio-*` — same text-to-audio protocol; auto-detected in both Music and SFX) | ✅ (generic POST) |
 | Voice design | ✅ (`/v1/voice_design`) | ✅ (`/v1/text-to-voice/design`) | — | — |
 
 ## 🤖 Agent usage
@@ -83,10 +83,10 @@ Restart `dsh web` after install — the sidebar will show **AI 音频**.
 Typical session commands (skills bundled with the plugin):
 
 ```text
-/audio:tts 用温暖的声音朗读这句话
-/audio:music 生成一段 30 秒的 Lo-fi 背景音乐
-/audio:sfx 生成一声科幻风格的 UI 提示音
-/audio:design 一个温暖复古的合成器音色
+/audio:tts      Read this sentence with a warm voice
+/audio:music    Generate a 30-second lo-fi background track
+/audio:sfx      Create a sci-fi UI cue
+/audio:design   Craft a warm retro synth voice
 ```
 
 ## 🔐 Security & data notes