localVoiceRec

会議を Mac 上で録音し、デバイス内で文字起こし・構造化要約まで完結させる macOS ネイティブアプリ。

音声・文字起こし・要約のすべてを端末内で処理し、データを一切外部に送信しない。 ネットワーク権限を持たないため、技術的に外部通信できません。

ハイライト

• AEC + NS + AGC: マイク側に AUVoiceProcessing IO を有効化し、OS 標準のエコーキャンセル・ノイズ抑制・自動ゲイン調整を適用 (Sources/AudioTapKit/MicCapture.swift)
• 可逆 PCM 保存: 録音は Linear PCM (WAV) で保存。可逆・非圧縮 (Sources/AudioTapKit/WAVFileWriter.swift)。ALAC コードパスも実装済みだが、Voice Processing の Float32 出力との互換性が未対応のため WAV を既定とする
• 1-pass fan-out: 1 つの PCM バッファを「WAV 書き込み / レベルメーター / 録音中文字起こし」に同期 fan-out。バッファコピーを増やさない (Sources/AudioCapture/AudioCaptureServiceImpl.swift の WriterSink)
• 録音と同時進行の文字起こし: SpeechAnalyzer の transcribeLive API に流し込み、isFinal 確定セグメントを逐次返す (Sources/TranscriptionKit/SpeechAnalyzerService.swift)
• SPSC ロックフリーリングバッファ: System Audio 側で採用 (Sources/AudioTapKit/SPSCByteRingBuffer.swift)
• 中断ハンドリング: スリープ / オーディオ HW 切替 / engine 構成変更を観測して安全停止 (AudioCaptureServiceImpl.handleInterruption)
• 小さい配布物: .app 約 1.5 MB / DMG 約 1.0 MB / 実行ファイル 約 1.2 MB (-Osize + LTO + strip)
• 外部依存ゼロ: OS 標準フレームワークのみ。ネットワーク entitlement は付与していない

要件

• macOS 26 (Tahoe) 以降
• Apple Silicon（M1 以降）

技術スタック

レイヤー	採用技術
言語	Swift
UI	SwiftUI（MenuBarExtra）
マイク収音	AVAudioEngine + AUVoiceProcessing IO (AEC/NS/AGC)
システム音声収音	Core Audio process tap + SPSC ロックフリーリングバッファ
録音形式	Linear PCM (WAV)
文字起こし	SpeechAnalyzer（macOS 26 標準・録音中ストリーミング対応）
要約	Foundation Models（オンデバイス・@Generable）
永続化	SwiftData

ドキュメント

• 仕様書
• 配布手順
• Cloudflare Pages サイト構築手順

配布サイト

site/ 配下に静的サイト（HTML/CSS のみ、ビルド不要）。Cloudflare Pages にデプロイして .dmg のダウンロードページとして公開する。詳細は docs/cloudflare-pages-setup.md。

配布版のインストール

1. 配布サイトから localVoiceRec-<version>.dmg をダウンロード
2. 公開されている SHA-256 と一致するか確認:

   shasum -a 256 ~/Downloads/localVoiceRec-<version>.dmg

3. DMG を開き、localVoiceRec.app を Applications フォルダにドラッグ
4. 初回起動で Gatekeeper 警告が出た場合は docs/distribution.md の「初回起動時の Gatekeeper 対応」を参照

リリース担当者向けのビルド・公証・パッケージング手順は docs/distribution.md を参照。

開発フェーズ

フェーズ	内容
Phase 0	システム音声 2ch 取得の技術検証（PoC）
Phase 1	録音 + ローカル保存 + 一覧
Phase 2	SpeechAnalyzer による文字起こし
Phase 3	Foundation Models による構造化要約
Phase 4	セキュリティ硬化・配布・署名/公証

---

すべての処理は端末内で完結します。