karyu-tech-news / 華流テック通信 by HAL

中華圏特化AIポッドキャスト「華流テック通信 — HAL Daily Briefing」のリポジトリ。

中国語ネイティブの一次情報・準一次情報・コミュニティ情報を収集し、日本語リスナー向けに平日朝5〜10分で届けることを目的とする。

詳細な背景・意思決定の経緯は docs/meeting.md および docs/meeting2.md を参照。

---

ステータス

• フェーズ: Sprint 3 (配信) main 到達 (2026-07-12, PR #25 マージ) — ロードマップ全スプリント (1A/1B/2/3) のコード完成。v0.5 経路 (mp3 → 波形動画 mp4 → YouTube 限定公開 → 朝確認 → approve 公開) 実装済み。実アップロード smoke は YouTube OAuth セットアップ (#35) 待ち。
• 品質: pytest 538 passed / ruff / mypy strict (82 files) / shellcheck 緑 (2026-07-12 実測)。新規依存ゼロ (httpx + ffmpeg のみ, ADR-0007)。独立レビュー 3 ラウンド + QA PASS。
• 次アクション: 人間判断・作業は全件 Issue 化済み (human-decision ラベル #34〜#41 + バグ #42)。筆頭は #35 YouTube OAuth セットアップ と #34 T32 人間試聴 (docs/PROJECT_STATE.md)

ドキュメント地図

設定とブートストラップ

現在のスコープ要旨

「収集 → LLM 編集判定 → 3-5 本選定 → Markdown 台本生成 → Irodori 600M VoiceDesign + caption による mp3 完パケ → Discord 投稿 → 波形動画 mp4 → YouTube 限定公開 → 朝確認 → approve 公開」 までコード実装済み (v0.5 経路)。variant A で運用中、音声品質の最終判断は T32 の人間試聴、実 YouTube アップロード smoke は OAuth セットアップ (人間) が残る。

Quick start (現時点で動くもの)

uv sync                                            # 基本依存 + Python 3.11+ を用意
uv sync --extra tts                                # produce / 実TTS を使う場合のみ
cp .env.example .env                               # DISCORD_WEBHOOK_URL を埋める
docker compose up -d rsshub                         # 掘金など RSSHub 経由ソース用
uv run python -m karyu_tech_news --help
uv run python -m karyu_tech_news validate-sources  # ソース定義をスキーマ検証
uv run python -m karyu_tech_news init-db           # SQLite 初期化
uv run python scripts/generate_bgm.py              # 暫定BGM (コード生成, algorave風) を assets/bgm/ へ生成 (Issue #36)
uv run python -m karyu_tech_news collect --post    # 収集 → SQLite → Discord 投稿
uv run python -m karyu_tech_news draft --dry-run   # 台本候補の確認 (LLM 不使用)
uv run python -m karyu_tech_news draft --post      # LLM 台本生成 → Discord (要 API キー)
uv run python -m karyu_tech_news produce --dry-run # 保存済み台本 → 音声完パケ (要 --extra tts + TTS 設定)
uv run python -m karyu_tech_news publish --dry-run # 完パケ mp3 → 波形動画 mp4 (要 ffmpeg)
uv run python -m karyu_tech_news publish --post    # mp4 → YouTube 限定公開 + Discord 朝確認 (要 OAuth)
uv run python -m karyu_tech_news approve           # 朝確認 ✅ → 公開へ切り替え (人間のみ)
uv run python -m karyu_tech_news evaluate          # A/B/C 検証の定量サマリー
uv run pytest                                      # テスト

Windows での開発

• 改行コードは .gitattributes で LF 固定 (bash スクリプトが CRLF だと実行不能)。core.autocrlf=true の既存チェックアウトで CRLF になっている場合は git rm -q --cached -r . && git reset --hard で再チェックアウトする。
• scripts/daily_pipeline.sh の契約テスト (smoke) は Windows ネイティブでは skip される (System32 の WSL bash が優先解決されるため)。実行したい場合は WSL / macOS / CI 上で走らせる。

CLI 進捗

Discord 投稿は独立コマンドではなく collect --post / draft --post / produce --post / publish --post に統合。

YouTube 配信セットアップ (人間が一度だけ)

1. Google Cloud Console でプロジェクトを作成し、YouTube Data API v3 を有効化する。
2. 「OAuth 同意画面」を設定 (External / テストユーザーに自分の Google アカウントを追加) し、スコープに youtube.upload / youtube を含める。
3. 「認証情報」→ OAuth クライアント ID (種類: デスクトップアプリ) を作成し、client ID / client secret を .env の YOUTUBE_CLIENT_ID / YOUTUBE_CLIENT_SECRET に設定する。
4. uv run karyu youtube-auth を実行し、表示された URL を配信チャンネルの Google アカウントで認可 → 表示された YOUTUBE_REFRESH_TOKEN=... を .env に貼る。
5. smoke: uv run karyu publish --dry-run (mp4 生成のみ) → uv run karyu publish (限定公開アップロード) → YouTube Studio で確認 → uv run karyu approve (公開する場合のみ)。

アップロードは 1 本あたり 1600 quota units (既定 10,000/日)。自動テストから実 API は叩かない (IMPLEMENTATION_PLAN-3 §8)。

マルチエージェント運用

本リポジトリは docs/WORKFLOW.md で定義されたロール (人間 / Claude Code (Opus) / OpenCode / Codex / Antigravity) によって駆動される。実装は agent/<task-id>-impl ブランチで行い、main への直接 push は禁止。

ライセンスと法務

• 中国メディア記事本文の転載は禁止。要約とHAL自身の解説のみ。
• 実在人物の無断声真似・声クローンは禁止 (Irodori-TTS モデルカード遵守)。
• AI生成音声であることをYouTube動画説明欄に明示。