【openscreen】エクスポートに4K品質ボタンを追加する

[nanameru]

課題 / 目的

OpenScreenのMP4エクスポートには720p・1080p・Sourceしかなく、4Kを明示的に選べない。利用者がエクスポート画面から4Kを選択し、UHD相当の解像度で動画を書き出せるようにする。

利用者

高解像度ディスプレイ、YouTube、プレゼン動画向けに高解像度で書き出したいOpenScreen利用者。

対象範囲

• エクスポート画面へ「4K」品質ボタンを追加
• 16:9は3840×2160、9:16は2160×3840
• その他の縦横比は短辺2160を基準に比率を維持
• 元素材より大きい場合は既存のアップスケール警告を表示
• CLIの --quality 4k と型・永続化の互換性を整備
• 日本語を含む品質ラベルを更新

対象外

• 録画自体を常に4Kへアップスケールする変更
• 既存プロジェクトの品質設定を強制変更
• 4Kを既定値にする変更
• エンコーダー全面刷新

UIモード

small-change。既存の品質ボタン群へ同一スタイルの選択肢を1つ追加するだけで、主要導線・情報構造・ブランド・共通コンポーネントは変更しないためFigma工程を省略する。

完了条件

• MP4エクスポート画面に4Kボタンと実際の出力寸法が表示される
• 16:9の4K設定が3840×2160を返す
• 9:16の4K設定が2160×3840を返す
• 小さい素材ではアップスケール警告が表示される
• 720p・1080p・Sourceの既存挙動が維持される
• --quality 4k が受理され、既存の不正値検証も維持される
• 関連テスト、lint、typecheck、buildが成功する
• Draft PRを作成し、マージ前で停止する

実装計画

1. 品質型と4K寸法計算の失敗テストを追加
2. エクスポート画面へ4K選択肢を追加
3. CLI・永続化・翻訳を更新
4. test-boardへ回帰ケースを追加
5. 全品質ゲートと実機エクスポートを確認
6. Checker確認後にDraft PRを作成

テスト / CI計画

• mp4ExportSettings.test.ts: 横・縦・既存品質
• ExportDialogテスト: 4K選択肢と警告表示
• CLI引数テスト: --quality 4k
• project/user preferencesの正規化テスト
• 全体test / lint / typecheck / build
• 可能なら短い4K MP4の実機生成とffprobe確認

リスク / 依存関係

• 低解像度素材の4K化は細部を増やさず、処理時間と容量が増える
• 4K 60fpsやH.265は端末・エンコーダー性能に依存
• 元素材より小さい場合は警告で明示する

停止条件

• 同一原因で品質ゲートが2回失敗
• 4Kがネイティブエンコーダーで生成不能
• マージ・公開・削除・権限変更は人間承認前に行わない

ナレッジログ

• 2026-09-03: 要件確定。既存UIへの軽微な追加としてFigma省略。Cursor scoutはAPIキー未設定のため利用できず、ローカル検索へフォールバック。

[nanameru]

実装・検証ログ

実装判断

• 品質値 4k を追加。
• 16:9は3840×2160、9:16は2160×3840。その他も既存の720p/1080pと同じく短辺2160を基準に縦横比を維持。
• 1080pなど小さい素材では既存の「アップスケール」警告を表示。
• 4Kの内部ビットレート目安は80Mbps。
• 既存の720p・1080p・Sourceと既定値1080pは変更しない。
• --quality 4k、ユーザー設定、プロジェクト正規化、13言語の4Kラベルを更新。

テスト

• 実装前: 寸法・UI・CLI・ユーザー設定・プロジェクト設定の5テストが期待どおり失敗。
• 対象テスト: 5ファイル、69件成功。
• 全体テスト: 187ファイル、2243件成功、2件skip。
• TypeScript: 成功。
• lint: 成功（既存warning 15件）。
• build-vite: 成功。
• test-board: TC-007〜TC-011をdone、impactで5件検出。

Beads TODO

• Epic: herdr-6k3
• Tasks: herdr-6k3.1〜herdr-6k3.6
• Epic/子タスク作成は成功。実行順依存の追加は embeddeddolt: store is read-only で失敗したため、Issue記載順を正本として継続。

[nanameru]

実機4K出力結果

Issue #4の録画保存修正、Issue #5のオレンジ背景・余白0、Issue #6の4K出力を統合したアプリを /Applications/OpenScreen.app へインストール。

• 2秒録画保存: 成功
• CLI: --quality 4k を受理
• 出力: /tmp/openscreen-e2e/issue-6-4k.mp4
• ffprobe: H.264 / 3840×2160 / 60fps / 2.083秒 / 4.0MB
• 背景・余白: /wallpapers/wallpaper2.jpg / 0 を維持
• 直前のIssue 【openscreen】macOS録画終了時に有効なMP4を保存失敗として取り残さない #4+#5版は /Applications/OpenScreen.issue5-backup-20260903.app に退避

補足: ビットレートはネイティブエンコーダーが自動決定する。4K品質は出力解像度を保証する選択肢として実装。

[nanameru]

Beads完了更新の制約

完了後に herdr-6k3.1〜.6 とEpicをcloseしようとしたが、全子タスクが embeddeddolt: store is read-only で更新不能。GitHub Issue、commit、Draft PR、test-boardの完了記録は正常。Beadsだけopen表示のまま。