tts-plugin-edgetts 0.1.0__tar.gz

tts_plugin_edgetts-0.1.0/.gitignore

@@ -0,0 +1,37 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environment
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+
+# Build
+build/
+dist/
+
+# Cache
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+
+# Logs
+*.log
+
+# Coverage
+.coverage
+
+# Generated agent notes
+GEMINI.md
+
+# Environment variables
+.env
+.env.local
+
+

tts_plugin_edgetts-0.1.0/AGENTS.md

@@ -0,0 +1,27 @@
+# tts-plugin-edgetts
+
+**Plugin for Microsoft Edge TTS (edge-tts backend)**
+
+## KEY FILES
+| File | Role |
+|------|------|
+| `tts_plugin_edgetts/connector.py` | EdgeTTSConnector implementation |
+
+## ENTRY POINT
+```python
+# pyproject.toml
+[project.entry-points."tts_bridge.connectors"]
+edgetts = "tts_plugin_edgetts.connector:EdgeTTSConnector"
+```
+
+## USAGE
+```bash
+tts-plugin-bridge synthesize "こんにちは" -e edgetts
+tts-plugin-bridge synthesize "Hello" -e edgetts --pitch +5Hz
+```
+
+## CONVENTIONS
+- Depends on: `tts-plugin-bridge` (core), `edge-tts` (TTS engine)
+- Uses `edge_tts.Communicate` async API
+- Inherits `TTSConnector` ABC
+- Output format: MP3 (24kHz, 48kbps, mono)

tts_plugin_edgetts-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vox4ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tts_plugin_edgetts-0.1.0/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: tts-plugin-edgetts
+Version: 0.1.0
+Summary: Microsoft Edge TTS 向け TTS Plugin (edge-tts backend)
+Project-URL: Homepage, https://github.com/vox4ai/tts-plugin-edgetts
+Project-URL: Repository, https://github.com/vox4ai/tts-plugin-edgetts
+Project-URL: Issues, https://github.com/vox4ai/tts-plugin-edgetts/issues
+Author-email: utenadev <utena.cross+pypi@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: edge,edgetts,microsoft,speech,synthesis,tts,tts-plugin,voice
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: edge-tts>=7.0
+Requires-Dist: tts-plugin-bridge
+Description-Content-Type: text/markdown
+
+# tts-plugin-edgetts
+
+<p align="center">
+  <img src="https://via.placeholder.com/1200x400/1a1a1a/ffffff?text=tts-plugin-edgetts" alt="tts-plugin-edgetts Banner" width="1200">
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/pypi-latest-blue.svg" alt="PyPI version">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+  <img src="https://img.shields.io/badge/python-3.10%2B-yellow.svg" alt="Python Version">
+  <img src="https://img.shields.io/badge/maintained%3F-yes-brightgreen.svg" alt="Maintained">
+</p>
+
+<p align="center">
+  <a href="https://github.com/vox4ai/tts-plugin-edgetts">Website</a> •
+  <a href="https://github.com/vox4ai/tts-plugin-edgetts/issues">Report Bug</a> •
+  <a href="https://github.com/vox4ai/tts-plugin-edgetts/contributing">Contributing</a>
+</p>
+
+---
+
+## 🚀 Overview
+
+[edge-tts](https://github.com/rany2/edge-tts) (Microsoft Edge TTS) を `tts-plugin-bridge` で利用するためのプラグインです。
+APIキー不要で多言語対応のTTSが利用できます。
+
+## 📦 インストール
+
+```bash
+uv add tts-plugin-bridge tts-plugin-edgetts
+```
+
+## ⚙️ 前提条件
+
+- インターネット接続 (Microsoft Edge TTSサービスにアクセス)
+- ローカルサーバー不要
+- 再生には [ffplay](https://ffmpeg.org/ffplay.html) または `paplay` / `aplay` がPATHに存在すること
+  - ffplay がある場合: ストリーミング再生（受信しながら即時再生）
+  - ffplay がない場合: 全取得後に paplay / aplay で再生
+
+## 🛠 Usage
+
+### 🧩 Python API
+
+```python
+from tts_plugin_bridge import TTSSkill
+
+async with TTSSkill(default_engine="edgetts") as skill:
+    # save / synthesize — ファイル保存やBase64取得用
+    res = await skill.save(
+        text="こんにちは、エッジティーティーエスのテストです。",
+        speed=1.2,
+        model="ja-JP-KeitaNeural",
+    )
+
+    # say / play — 直接再生（ffplayストリーミング → paplay/aplay）
+    res = await skill.say(
+        text="ストリーミングで即時再生します。",
+        speed=1.0,
+    )
+```
+
+### 🎤 CLI（vox4ai 推奨）
+
+```bash
+# 直接再生（自動ストリーミング）
+vox4ai say "こんにちは" -e edgetts
+
+# 男性声で再生
+vox4ai say "こんにちは" -e edgetts --model ja-JP-KeitaNeural
+
+# ファイル保存（MP3）
+vox4ai save "こんにちは" -e edgetts -o output.mp3
+
+# 環境診断
+vox4ai --doctor
+```
+
+### ⌨️ CLI（tts-plugin-bridge 後方互換）
+
+```bash
+tts-plugin-bridge synthesize "こんにちは" -e edgetts -o output.mp3
+tts-plugin-bridge play "こんにちは" -e edgetts
+tts-plugin-bridge play "こんにちは" -e edgetts --model ja-JP-KeitaNeural
+```
+
+## 🔧 サポートパラメータ
+
+| パラメータ | 型 | 説明 |
+|---|---|---|
+| `speed` | float | 話速 (1.0=標準, >1.0=速い) → edge-tts `rate` に自動変換 |
+| `volume` | float | 音量倍率 → edge-tts `volume` に自動変換 |
+| `model` | str | 音声名 (例: `ja-JP-KeitaNeural`) → edge-tts `voice` にマッピング |
+| `extra.pitch` | str | ピッチ (例: `+5Hz`, `-10Hz`) |
+| `extra.rate` | str | 話速の直接指定 (例: `+50%`, `-20%`)。speed変換より優先 |
+| `extra.volume` | str | 音量の直接指定 (例: `+100%`)。volume変換より優先 |
+| `extra.voice` | str | 音声名の直接指定。modelより優先 |
+| `extra.proxy` | str | プロキシURL |
+
+### 🗣️ 主な音声一覧
+
+| 音声名 | 性別 | 言語 |
+|---|---|---|
+| `ja-JP-NanamiNeural` | 女性 | 日本語 (デフォルト) |
+| `ja-JP-KeitaNeural` | 男性 | 日本語 |
+| `en-US-EmmaMultilingualNeural` | 女性 | 英語 (多言語対応) |
+| `en-US-AndrewNeural` | 男性 | 英語 |
+
+全音声一覧: `uv run edge-tts --list-voices`
+
+### 📁 出力フォーマット
+
+MP3 (24kHz, 48kbps, mono)
+
+## 🔍 検証環境
+
+- **OS**: Windows 11 + WSL2 (Ubuntu)
+- **確認日**: 2026-05-09
+- **依存**: edge-tts v7.2.8, bridge / vox4ai CLI
+- **確認内容**:
+  - `vox4ai say` によるストリーミング再生（ffplay 経由）
+  - `vox4ai save` による MP3 ファイル保存
+  - `vox4ai --doctor` 環境診断
+  - `tts-plugin-bridge` CLI 後方互換維持
+  - 全ユニットテスト 22件 パス
+
+## 📜 ライセンス
+
+MIT License

tts_plugin_edgetts-0.1.0/README.md

@@ -0,0 +1,129 @@
+# tts-plugin-edgetts
+
+<p align="center">
+  <img src="https://via.placeholder.com/1200x400/1a1a1a/ffffff?text=tts-plugin-edgetts" alt="tts-plugin-edgetts Banner" width="1200">
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/pypi-latest-blue.svg" alt="PyPI version">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+  <img src="https://img.shields.io/badge/python-3.10%2B-yellow.svg" alt="Python Version">
+  <img src="https://img.shields.io/badge/maintained%3F-yes-brightgreen.svg" alt="Maintained">
+</p>
+
+<p align="center">
+  <a href="https://github.com/vox4ai/tts-plugin-edgetts">Website</a> •
+  <a href="https://github.com/vox4ai/tts-plugin-edgetts/issues">Report Bug</a> •
+  <a href="https://github.com/vox4ai/tts-plugin-edgetts/contributing">Contributing</a>
+</p>
+
+---
+
+## 🚀 Overview
+
+[edge-tts](https://github.com/rany2/edge-tts) (Microsoft Edge TTS) を `tts-plugin-bridge` で利用するためのプラグインです。
+APIキー不要で多言語対応のTTSが利用できます。
+
+## 📦 インストール
+
+```bash
+uv add tts-plugin-bridge tts-plugin-edgetts
+```
+
+## ⚙️ 前提条件
+
+- インターネット接続 (Microsoft Edge TTSサービスにアクセス)
+- ローカルサーバー不要
+- 再生には [ffplay](https://ffmpeg.org/ffplay.html) または `paplay` / `aplay` がPATHに存在すること
+  - ffplay がある場合: ストリーミング再生（受信しながら即時再生）
+  - ffplay がない場合: 全取得後に paplay / aplay で再生
+
+## 🛠 Usage
+
+### 🧩 Python API
+
+```python
+from tts_plugin_bridge import TTSSkill
+
+async with TTSSkill(default_engine="edgetts") as skill:
+    # save / synthesize — ファイル保存やBase64取得用
+    res = await skill.save(
+        text="こんにちは、エッジティーティーエスのテストです。",
+        speed=1.2,
+        model="ja-JP-KeitaNeural",
+    )
+
+    # say / play — 直接再生（ffplayストリーミング → paplay/aplay）
+    res = await skill.say(
+        text="ストリーミングで即時再生します。",
+        speed=1.0,
+    )
+```
+
+### 🎤 CLI（vox4ai 推奨）
+
+```bash
+# 直接再生（自動ストリーミング）
+vox4ai say "こんにちは" -e edgetts
+
+# 男性声で再生
+vox4ai say "こんにちは" -e edgetts --model ja-JP-KeitaNeural
+
+# ファイル保存（MP3）
+vox4ai save "こんにちは" -e edgetts -o output.mp3
+
+# 環境診断
+vox4ai --doctor
+```
+
+### ⌨️ CLI（tts-plugin-bridge 後方互換）
+
+```bash
+tts-plugin-bridge synthesize "こんにちは" -e edgetts -o output.mp3
+tts-plugin-bridge play "こんにちは" -e edgetts
+tts-plugin-bridge play "こんにちは" -e edgetts --model ja-JP-KeitaNeural
+```
+
+## 🔧 サポートパラメータ
+
+| パラメータ | 型 | 説明 |
+|---|---|---|
+| `speed` | float | 話速 (1.0=標準, >1.0=速い) → edge-tts `rate` に自動変換 |
+| `volume` | float | 音量倍率 → edge-tts `volume` に自動変換 |
+| `model` | str | 音声名 (例: `ja-JP-KeitaNeural`) → edge-tts `voice` にマッピング |
+| `extra.pitch` | str | ピッチ (例: `+5Hz`, `-10Hz`) |
+| `extra.rate` | str | 話速の直接指定 (例: `+50%`, `-20%`)。speed変換より優先 |
+| `extra.volume` | str | 音量の直接指定 (例: `+100%`)。volume変換より優先 |
+| `extra.voice` | str | 音声名の直接指定。modelより優先 |
+| `extra.proxy` | str | プロキシURL |
+
+### 🗣️ 主な音声一覧
+
+| 音声名 | 性別 | 言語 |
+|---|---|---|
+| `ja-JP-NanamiNeural` | 女性 | 日本語 (デフォルト) |
+| `ja-JP-KeitaNeural` | 男性 | 日本語 |
+| `en-US-EmmaMultilingualNeural` | 女性 | 英語 (多言語対応) |
+| `en-US-AndrewNeural` | 男性 | 英語 |
+
+全音声一覧: `uv run edge-tts --list-voices`
+
+### 📁 出力フォーマット
+
+MP3 (24kHz, 48kbps, mono)
+
+## 🔍 検証環境
+
+- **OS**: Windows 11 + WSL2 (Ubuntu)
+- **確認日**: 2026-05-09
+- **依存**: edge-tts v7.2.8, bridge / vox4ai CLI
+- **確認内容**:
+  - `vox4ai say` によるストリーミング再生（ffplay 経由）
+  - `vox4ai save` による MP3 ファイル保存
+  - `vox4ai --doctor` 環境診断
+  - `tts-plugin-bridge` CLI 後方互換維持
+  - 全ユニットテスト 22件 パス
+
+## 📜 ライセンス
+
+MIT License

tts_plugin_edgetts-0.1.0/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tts-plugin-edgetts"
+version = "0.1.0"
+description = "Microsoft Edge TTS 向け TTS Plugin (edge-tts backend)"
+requires-python = ">=3.10"
+dependencies = [
+    "tts-plugin-bridge",
+    "edge-tts>=7.0",
+]
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "utenadev", email = "utena.cross+pypi@gmail.com"},
+]
+keywords = ["tts", "tts-plugin", "edgetts", "microsoft", "edge", "voice", "speech", "synthesis"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://github.com/vox4ai/tts-plugin-edgetts"
+Repository = "https://github.com/vox4ai/tts-plugin-edgetts"
+Issues = "https://github.com/vox4ai/tts-plugin-edgetts/issues"
+
+[project.entry-points."tts_bridge.connectors"]
+edgetts = "tts_plugin_edgetts.connector:EdgeTTSConnector"
+
+[tool.uv.sources]
+tts-plugin-bridge = { path = "../tts-plugin-bridge", editable = true }
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.3",
+    "pytest-asyncio>=1.3.0",
+    "ruff>=0.15.12",
+    "build>=1.0",
+    "twine>=6.0",
+]

tts_plugin_edgetts-0.1.0/reports/edgetts_01_design.md

@@ -0,0 +1,97 @@
+# edgetts_01: tts-plugin-edgetts 設計
+
+## 概要
+Microsoft Edge TTS サービスを利用するプラグイン。
+`edge-tts` Python パッケージを内部で呼び出し、`tts-plugin-bridge` の `TTSConnector` に準拠する。
+
+## アーキテクチャ
+
+```
+tts-plugin-bridge (TTSSkill / ConnectorFactory)
+        │
+        ▼ entry_point: tts_bridge.connectors = edgetts
+tts-plugin-edgetts (EdgeTTSConnector)
+        │
+        ▼
+    edge-tts (Communicate / list_voices)
+        │
+        ▼
+    Microsoft Edge TTS WebSocket API
+```
+
+## ディレクトリ構成
+```
+tts-plugin-edgetts/
+├── pyproject.toml
+├── AGENTS.md
+├── reports/
+├── tests/
+│   └── test_connector.py
+└── tts_plugin_edgetts/
+    ├── __init__.py
+    └── connector.py
+```
+
+## EdgeTTSConnector 仕様
+
+### クラス定義
+```python
+class EdgeTTSConnector(TTSConnector):
+    ENGINE_NAME = "edgetts"
+    SUPPORTED_PARAMS = ["voice", "rate", "pitch", "proxy"]
+```
+
+### コンストラクタ
+- `voice: str` — デフォルト `"ja-JP-NanamiNeural"`
+- `rate: str` — デフォルト `"+0%"` (形式: `[+-]N%`)
+- `pitch: str` — デフォルト `"+0Hz"` (形式: `[+-]NHz`)
+- `proxy: Optional[str]` — デフォルト `None`
+
+### TTSRequest マッピング
+| TTSRequest フィールド | EdgeTTS パラメータ | 変換ロジック |
+|---|---|---|
+| `text` | `Communicate(text=...)` | そのまま |
+| `speed` | `rate` | `speed` → パーセント形式 (1.0→"+0%", 1.5→"+50%", 0.5→"-50%") |
+| `volume` | `volume` | `volume` → パーセント形式 (1.0→"+0%", 2.0→"+100%") |
+| `pitch` | `pitch` | そのまま (Hz形式の文字列を想定) |
+| `model` | `voice` | `model` を voice 名として使用 |
+| `extra["voice"]` | `voice` | voice の直接指定 |
+| `extra["rate"]` | `rate` | rate の直接指定 (直接指定優先) |
+| `extra["pitch"]` | `pitch` | pitch の直接指定 (直接指定優先) |
+| `extra["proxy"]` | `proxy` | proxy URL |
+
+### synthesize() フロー
+1. TTSRequest からパラメータを変換
+2. `edge_tts.Communicate(text, voice, rate=, volume=, pitch=)` を生成
+3. `stream()` で音声チャンクを収集 (MP3)
+4. 全チャンクを結合して `TTSResponse.ok(audio_data=mp3_bytes)` を返す
+
+### is_available() フロー
+1. `edge_tts.list_voices()` を呼び出し
+2. 例外なくレスポンスが返れば `True`、例外なら `False`
+
+### 出力フォーマット
+- edge-tts は MP3 (24kHz, 48kbps, mono) を出力
+- `TTSRequest.output_format` が "wav" の場合、`pydub` なしでは変換不可
+- 初期実装では MP3 のまま返却 (metadata に format="mp3" を記録)
+
+## 依存関係
+- `tts-plugin-bridge` (path dependency)
+- `edge-tts>=7.0`
+- `aiohttp` (edge-tts 経由)
+
+## テスト方針 (TDD / t_wada)
+1. **Red**: 失敗するテストを先に書く
+2. **Green**: テストを通す最小実装
+3. **Refactor**: リファクタリング
+
+### テストケース
+- test_connector_is_available_true
+- test_connector_is_available_false
+- test_connector_synthesize_basic
+- test_connector_speed_to_rate_conversion
+- test_connector_volume_to_percent
+- test_connector_model_as_voice
+- test_connector_extra_params_override
+- test_connector_error_handling
+- test_connector_context_manager

tts_plugin_edgetts-0.1.0/reports/edgetts_02_worklog.md

@@ -0,0 +1,135 @@
+# edgetts_02: 作業ログ 2026-05-08
+
+## 作業概要
+vox4ai リポジトリに `tts-plugin-edgetts` を新規作成し、`tts-plugin-bridge` にストリーミング再生機能を追加した。
+
+---
+
+## Phase 1: 調査・設計
+
+### コードベース調査
+- `tts-plugin-piperplus` — `PiperPlusConnector` (TTSConnector実装、aiohttp HTTP通信)
+- `tts-plugin-bridge` — `TTSConnector` ABC / `ConnectorFactory` (entry_points発見) / `TTSSkill` (Agent向けラッパー+CLI)
+- `edge-tts` v7.2.8 — `Communicate` クラスの async stream API、`list_voices()`、rate/volume/pitch パラメータ
+
+### br (beads-rust) の試行
+- `br init` → SQLite "file-backed pager not available on this platform" エラー
+- Windows環境でbrが動作しないため、`reports/` ディレクトリで代替管理
+
+### 設計書
+- `reports/edgetts_01_design.md` にアーキテクチャ・パラメータマッピング・テスト方針を記載
+
+---
+
+## Phase 2: tts-plugin-edgetts 実装 (TDD)
+
+### プロジェクトスケルトン
+```
+tts-plugin-edgetts/
+├── pyproject.toml          # entry_point: tts_bridge.connectors = edgetts
+├── AGENTS.md
+├── README.md
+├── .gitignore
+├── LICENSE
+├── reports/
+│   └── edgetts_01_design.md
+├── tests/
+│   ├── test_connector.py
+│   └── test_integration.py
+└── tts_plugin_edgetts/
+    ├── __init__.py
+    └── connector.py
+```
+
+### TDD Red → Green → Refactor
+
+**Red**: 14テストを先に記述 (importエラーで失敗確認)
+**Green**: `EdgeTTSConnector` 最小実装で14/14通過
+**Refactor**: `_build_params()` 抽出、ruff format適用
+
+### EdgeTTSConnector 仕様
+| パラメータ | デフォルト | 変換ロジック |
+|---|---|---|
+| `voice` | `ja-JP-NanamiNeural` | `TTSRequest.model` or `extra["voice"]` で上書き |
+| `rate` | `+0%` | `speed` → `round((speed-1)*100)` → `±N%` |
+| `volume` | `+0%` | `volume` → `round((volume-1)*100)` → `±N%` |
+| `pitch` | `+0Hz` | `extra["pitch"]` で直接指定 |
+| `proxy` | None | `extra["proxy"]` で指定 |
+
+---
+
+## Phase 3: 結合試験
+
+`test_integration.py` で bridge 経由の動作を6テスト検証:
+- `ConnectorFactory.list_available()` に "edgetts" が含まれる
+- `ConnectorFactory.create("edgetts")` → `EdgeTTSConnector` インスタンス
+- `TTSSkill.synthesize()` → base64音声データ返却
+- speed/volume パラメータ変換の確認
+- エンジン unavailable 時のエラーハンドリング
+- entry_points 登録の確認
+
+### 実発声テスト
+3パターンのMP3生成 + Windowsプレーヤーで再生確認:
+- edge-tts直接: 24KB
+- EdgeTTSConnector経由: 28KB
+- speed=1.3, volume=1.5, KeitaNeural: 14KB
+
+---
+
+## Phase 4: ストリーミング再生対応 (要望対応)
+
+### 追加要件
+1. bridge が ffplay を subprocess で呼んで再生
+2. edgetts のストリーミング再生を活かしたパイプ渡し
+
+### tts-plugin-bridge 変更点
+
+**protocol.py**:
+- `TTSConnector.synthesize_stream()` 追加 — デフォルト実装(一括yield)付きasync generator
+- 型ヒントに `AsyncGenerator` 追加
+
+**skill.py**:
+- `TTSSkill.play()` 追加 — ストリーミング合成→ffplay stdin パイプ再生
+- `shutil.which("ffplay")` で自動検索、`player` 引数で上書き可能
+- `FileNotFoundError` ハンドリング追加
+- CLI `play` サブコマンド追加
+  ```
+  tts-plugin-bridge play "こんにちは" -e edgetts
+  ```
+
+### tts-plugin-edgetts 変更点
+
+**connector.py**:
+- `_build_params()` にリファクタリング (synthesize/synthesize_stream 共用)
+- `synthesize_stream()` オーバーライド — edge-ttsの `Communicate.stream()` からaudioチャンクを直接yield
+- バッファなしでffplayにストリーミング
+
+### データフロー
+```
+TTSSkill.play()
+  → EdgeTTSConnector.synthesize_stream()
+    → edge_tts.Communicate.stream()
+      → MP3チャンク yield (720B/チャンク)
+    → subprocess.stdin.write(chunk)
+  → ffplay -nodisp -autoexit -i pipe:0
+```
+
+### ストリーミングテスト追加
+- bridge: `test_play.py` 5テスト (Popenモック、ffplay不在、エンジン不可、デフォルトストリーム)
+- edgetts: `test_connector.py` 2テスト追加 (チャンクyield確認、パラメータ引継ぎ)
+
+---
+
+## 最終テスト結果
+
+| パッケージ | テスト数 | 結果 |
+|---|---|---|
+| tts-plugin-bridge | 16 | 16 passed |
+| tts-plugin-edgetts | 22 | 22 passed |
+| **合計** | **38** | **38 passed** |
+
+lint: ruff check 全通過 / format: ruff format 適用済み
+
+### 実発声確認
+- `skill.play()` → ffplay経由で35チャンクストリーミング再生 OK
+- CLI `tts-plugin-bridge play "..." -e edgetts` → 36チャンク再生 OK