Design Decisions ja

設計判断 — 「browsa はなぜ X をしないのか」

English | 中文 | 日本語 | 한국어 | Español | Português | Русский

これらの判断は確定済み。それぞれの背後に、実際の失敗／議論の履歴がある。新しい事実なしに再提案しないこと。正式な記録は docs/adr にあり、このページは人間が読めるインデックス。

製品の境界

判断	一行の理由	記録
メディアダウンロード UI は削除済み、復活させない	chrome.downloads リクエストへのヘッダ注入は信頼できない + YouTube は PO トークンのアンチボット。browsa ユーザーには cat-catch/yt-dlp がある。ASR パイプライン自身の fetch 機構は影響なし	ADR-0001
タブ毎のセッション自動切替はしない	タブ切替で会話を切り替えるのは、ユーザーから制御を奪うこと。グローバルな単一会話 + 明示的な新セッションがデフォルト	ADR-0002
メッセージ毎の「コンテキスト受領書」はしない	役に立たないとして作り、削除した。送信内容の検査は、添付チップの 检查/撤销 ボタンだけが残る	同一 ADR
tabCapture の「再生しながら録音」ASR フォールバックは却下	リアルタイム取得の長さ = 再生時間。一時停止／スキップ区間は無音 — 未再生の動画は文字起こしできず、核心ケースが死ぬ	AGENTS.md 2026-09-28
汎用ページの「書く/操作する」方向は棚上げ	コピペの基線で単一塊の書き込みはカバーされる。残りは散発的。「做好太复杂」— 再始動には、コピペでは扱えない具体的なフォーム／バッチフローが要る	プロジェクトロードマップノート
学習方向は YES、「クイズ/理解度バー」の形式は NO	却下されたのは方向ではなく「形式」。再始動するときは、まず形式で合意する	learning-pivot ノート

データとプライバシー

判断	一行の理由	記録
保存済みの画像ピクセルは決して破棄されない	バブルは送信したものを表示する（ユーザーレポート駆動）。圧縮はリクエスト側のみ（imagesSeen ラベル）	ADR-0013
セッションスナップショットは画像バイトを保持する（剥がさない）	復元セッションの最初のターンが実際のピクセルを再送するため、ピクセルレベルの追問に答え続けられる	ADR-0005

プロトコルとアーキテクチャ

判断	一行の理由	記録
thinking のデフォルトは omit。runs のエコーガードは正しい	reasoning.available は回答をリプレイする — 表示すると二重になる	ADR-0004
ディテールスレッドはターンリクエストのラダーから意図的に分岐する	隔離セッション／スコーピングは製品の約束であって、技術的負債ではない	ADR-0007
入力サーフェス毎に 1 つの入力履歴リコールスコープ	フォローアップカードの ↑ がリコールするのはフォローアップだけ。メインチャットの送信は決してない	ADR-0006
MAIN ワールドの注入関数はヘルパーをネストさせ続ける	executeScript は 1 個の関数をシリアライズする。実 Chrome の ReferenceError がこれを教えた	ADR-0009
ベンダー読み込みの制約（Mol* は RAW コピー / office wasm はプリウォームしない / 実拡張での検証）	常設規則 3 つ	ADR-0008
CAPABILITY_HINTS のサイズは凍結。レンダラは自動で描画、ボタンなし	ヒントは few-shot ではなくインターフェース契約。ボタンは装飾	ADR-0010
ストリーミングはブロックコミット。ベンダーのインクリメンタルパーサは使わない	HTML 形状をバイト単位で同一に保つ。O(n) を達成	ADR-0011
効率監査の wontfix リスト	トレードオフは確定済み（getAll キーリストなど）。再報告しない	ADR-0012
移植規則: 技法は YES、シグネチャ機能は NO	youtube-digest の二重字幕ビューは作られ、差し戻された — 学習ツールのシグネチャは browsa のものではない	ADR-0003
モデル出力契約は、学習事前分布のあるフォーマットを優先する	nn の教訓: 発明されたスペックには事前分布がなく → モデルは推測し → 沈黙の劣化。dot に置換済み	描画契約ノート

サイドパネル機能の常設規則 2 つ

1. 独自に LLM 呼び出しを行うパネル機能は、4 つの apiStyle すべてをサポートするか、目に見える形で失敗せよ — 論文リーディング補助カードは Hermes を黙ってスキップしたため削除された（プロトコル分岐のコスト > 限界的価値）。
2. 誰も要望しない設定トグルを作らない: autoCleanBeforeExtract はユーザー判断で明示的に削除された — 挙動は単に固定。

---

権威版: Design-Decisions（英語） / Design-Decisions-zh（中文） — AI による初翻スナップショット、同期日 2026-10-01。