From 7706b560748625b4fd0a0f667207ecca6b674848 Mon Sep 17 00:00:00 2001 From: ci-check Date: Tue, 10 Nov 2026 11:19:59 +0800 Subject: [PATCH 01/17] docs: add Japanese translations for identity & protocol docs (#6072) --- docs/identity-channels.ja.md | 53 ++++++++++++++++++ docs/index.md | 10 ++-- docs/index.zh-CN.md | 10 ++-- docs/msgid-infrastructure.ja.md | 74 +++++++++++++++++++++++++ docs/opencode-responses-websocket.ja.md | 35 ++++++++++++ docs/session-identity-resolution.ja.md | 62 +++++++++++++++++++++ 6 files changed, 234 insertions(+), 10 deletions(-) create mode 100644 docs/identity-channels.ja.md create mode 100644 docs/msgid-infrastructure.ja.md create mode 100644 docs/opencode-responses-websocket.ja.md create mode 100644 docs/session-identity-resolution.ja.md diff --git a/docs/identity-channels.ja.md b/docs/identity-channels.ja.md new file mode 100644 index 0000000000..760f282d1d --- /dev/null +++ b/docs/identity-channels.ja.md @@ -0,0 +1,53 @@ +# アイデンティティチャネル配線(#5825) + +クロスクライアント「安定会話 + メッセージ ID」配線のための 1 ページ:アイデンティティを誰が bili に運び、どこで消費され、すべての新規レーンが何をしなければならないか。設計法(オーナー裁定 2026-11-07):**すべてのクライアントレーンは 1 つの統一消費シームに配線する——利用箇所は決して自分でクライアントストレージを読まない。** AGENTS.md KDD #18 が規範的記述;このページはそのマップ。姉妹ページ(*判定*側——ID が到着した後 bili が何を決めるか):`docs/session-identity-resolution.md`。 + +## 1. シーム + +リクエスト毎、1 か所(`src/server/handle.ts`、会話アイデンティティ解決の後、resolve の前)でアイデンティティレジストリがスナップショットされる: + +``` +stamped inbound ids (body fields / turn envelope) ──▶ same consumer path ◀── harvested ids + (msgid-pin validation → + #5719 attribution rung → + pin/row pipeline on + anthropic wire) +``` + +- **スタンプレーン**(dsh など):ホストが正規 ID(`acp_summary_*`)を発行し、ボディフィールドや `/__bili/plugin/turn` エンベロープにスタンプ;送出前にプロトコル剥離。 +- **スタンプヘッダレーン**(opencode V2):拡張の http-request フックが*このターン自身の*構造化メッセージを読む(競争なし)で、その送信リクエストヘッダーに `x-bili-msg-ids` を設定;証明できない ID を持つ任意の変種はリスト*全体*を汚染する。Handle はボディフィールド > ヘッダー > ハーベストの優先順で消費;両 prepare は送出前に内部フィールドを無条件剥離。 +- **ハーベストレーン**(本配線):ローカルストアに安定メッセージ毎 ID を持つクライアントからのループバックリクエストは自己完結アダプタを通じて一致させられる;判定不能なものは*ターン全体*を配線前パスに劣化させる——部分的マッピングも、静かな再キー付けも絶対にしない。 + +ハーベストゲート(リクエスト毎すべて成立必須):(env `BILI_IDENTITY_HARVEST` が空でない(`all` またはカンマ区切りソースリスト)または rollout `identityChannelHarvest` ON —— いずれかの有効化子が十分、両者既定 OFF、無関係な `pluginLaneServerHistory` のオーバーライダー)× リクエストソースアドレスループバックのみ × アダプタ結合キー一致。許可された ID の行ピンニング(openai-parity ステップ以降は両ワイヤで追加で)は引き続き `pluginLaneServerHistory` でゲートされる;帰属階段証拠には不要。許可された ID は*両ワイヤ*でフルパイプラインに乗る:#5719 帰属階段、および——`pluginLaneServerHistory` が ON の間——ピン/ストレージ行リンク(`prepare-anthropic` + `prepare-openai`、ウォーターマーク高速パスターンは除外:ヒットビューは短いウィンドウであり、構造的に不一致になる)。 + +## 2. レーントーブル(#5825 クライアント毎調査から) + +| クライアント | セッションキー | メッセージ ID | アダプタ | ステータス | +|---|---|---|---|---| +| claude-code | `x-claude-code-session-id`(+transcript ファイル名) | transcript `.jsonl` 行の `uuid`;sidechain + summary 行は除外 | `src/identity-claude.ts` | 配線済み(anthropic ワイヤ:行ピンニング含むフルパス) | +| codebuddy | `x-conversation-id`(= transcript ファイル名、再起動安定、計測 2.181.0) | JSONL 行の `id`+`parentId`;system/draft 行は除外 | `src/identity-codebuddy.ts` | 配線済み(openai ワイヤ:帰属階段);認識は `conversationHeaderSource` 低信頼ティアに統合 | +| mcode / mavis | `x-mavis-session-id`(`mvs_…`、既に認識済み #1050) | runtime-state.sqlite `local_runtime_message_rows.msg_id` | `src/identity-mcode.ts` | 配線済み(sqlite 例示;ターン毎読み取りプローブ、open→query→close) | +| goose | `agent-session-id`(= sqlite sessions.id、再起動安定;BYOK/カスタムプロバイダパス含む;ユーザー上書き名はこのレーンのみ劣化) | sessions.db `messages.message_id`(`msg_`、再利用なし);ORDER BY created_timestamp,id;圧縮は再親付け ⇒ 圧縮後ターンはターン全体劣化、次のターンに自己修復 | `src/identity-goose.ts` | 配線済み | +| qwen-code | ユーザー customHeaders `${session_id}` 経由の `x-opencode-session`(公式 BYOK ドキュメントの例名 = bili が既に認識するもの 1 つ;他の選択名は認識されるまで劣化) | `\|~/.qwen/projects//chats/.jsonl` git-log 行の `uuid`;sidechain ファイル + 圧縮チェックポイント + rewind 記録はターン全体を安全に劣化 | `src/identity-qwen.ts` | 配線済み(結合はユーザーオプトイン——ステータス注記参照) | +| opencode V1 | `x-opencode-session-id` | `opencode-msgids` ハーベスト(既存) | 不変 | 稼働中 | +| opencode V2 | `x-bili-msg-ids`(自身のフックがこのターンの構造化メッセージから全モデルリクエストで設定) | 同じイベント読み取り——ゼロ捕捉競争;union 変種の ID オプション性 ⇒ *欠落 ID はスタンプ全体を落とす* | `src/agent/opencode-v2-msgids.ts`(+ handle 消費、両ワイヤ strip+pin) | 配線済み(スタンプヘッダレーン) | +| crush | 結合キーはセッション UUID とストアの XXH3 16進ダイジェスト(プロジェクトローカル、プロキシはクライアント cwd を列挙できない) | sqlite uuid PK が安定と証明済み | — | クローズメモ:アダプト前にクライアント側 xxh3 結合値または文書化された data-dir 規約が必要 | +| gemini-cli | 最も近いアイデンティティはインストールレベル(`installationId`、セッション毎ではなくマシン毎;テレメトリー切替依存) | transcript uuid は存在するがセッション毎安定ワイヤキーがない | — | セッション毎ワイヤキーが存在するまでクローズメモ | +| hermes-agent | ワイヤアイデンティティ信号が全くない(ブランディングヘッダーのみ)、強力な sqlite スキーマにもかかわらず | id AUTOINCREMENT + active/compacted 列 | — | クローズメモ:クライアント変更なしでは結合対象がない | +| iflow | ワイヤ可能セッションヘッダー + claude 風 JSONL を持っていた | ダブル ID 空間の曖昧性(ワイヤ getSessionId vs `session-` ファイル名) | — | クローズメモ:製品終了(repo README 閉鎖通知;npm 最終リリース)——表面の価値なし | +| antigravity / qoder / copilot | クライアント毎キー(antigravity はワイヤ上にない) | transcript レイアウトは部分的に証明済み(#5825 スレッド) | — | アダプト前にログイン済み計測ラン 1 回が必要 | +| zcode | `x-zcode-*` 帰属セット(今日は memory aux レーン用に認識) | 証明されたメッセージ毎ワイヤ半分はまだない | — | アダプト前にログイン済み計測ラン 1 回が必要 | +| grok-shell / kiro | 認識済み | モデルワイヤ上に使えるメッセージ毎エンティティなし(ソース証明) | n/a | セッション半分のみ——クローズノート付きでクローズ | +| aider / jcode / kimi | 安定のものなし | 使えるものなし | n/a | コンテンツハッシュフォールバックこそ最適解——クローズ | +| codex | セッション既知 | item.id はプロバイダネームスペース;自己発行 ID は本番で 2 度拒否(#242/#1474) | n/a | #5643 裁定待ちで保留 | +| trae / amp | — | — | n/a | ブロック:外部から成果物を取得できない | + +## 3. 信頼境界 + +- ハーベストされた ID は**サーバー派生証拠**であり、許可されるとスタンプ ID と同等信頼(同じ正規バリデータ、同じ階段セマンティクス)——同じクライアント(リクエストを送ったもの自身)の*ローカル*ファイル/sqlite から来て、ループバック*のみ*だから。リモートソースのリクエストは決してハーベストできない。 +- 各アダプタは自分のスナップショット内で自分のレイアウト前提を検証する;共有規律はコアにある(`expectedLen` 対の行数対称、両側がロールを公開する場所での境界ロールスポットチェック最大 4 位置、正規 msgid 検証、ソース毎 warn-once 劣化)。 +- 消費者はクライアント非依存のまま:シームより下流でクライアント名を言及するものはない。 + +## 4. 変更チェックリスト + +新規ハーベストレーン:`src/identity-.ts` を追加(自己完結;node builtins のみ)→ `src/identity-sources.ts` に登録 → `tests/identity-harvest.test.ts` にフィクスチャテストを追加 → 上記 §2 に 1 行 + AGENTS.md ステータスを追加。禁止事項:レジストリ以外の場所でクライアントストレージを読むこと、ゲートをバイパスすること、判定不能ターンで 1 つのレーンが部分的マッピングを持ち越すことを許すこと。 diff --git a/docs/index.md b/docs/index.md index b7a6e07243..af10545c81 100644 --- a/docs/index.md +++ b/docs/index.md @@ -7,7 +7,7 @@ | Doc | What it is | |---|---| -| [README](../README.md) / [中文](../README.zh-CN.md) | Project entry: what it is, quickstart, architecture overview | +| [README](../README.md) / [中文](../README.zh-CN.md) / [日本語](../README.ja.md) | Project entry: what it is, quickstart, architecture overview | | [architecture](architecture.md) / [中文](architecture.zh-CN.md) | **System architecture hub** (LIVE doc, owner ruling 2026-11-08): overall diagram + per-module pages, each with its own diagram — see `docs/architecture/` | | [configuration](configuration.md) / [中文](configuration.zh-CN.md) | Full configuration reference (generated from `website/config-reference/*.yaml` by `tools/gen-config-docs.mjs`; hand-written sections are drift-guarded) | | [clients](clients.md) / [中文](clients.zh-CN.md) | Per-client integration deep dives: how each mode (launcher / `/bili/` / native plugin) wires traffic in | @@ -20,10 +20,10 @@ |---|---| | [message-identity](message-identity.md) / [中文](message-identity.zh-CN.md) | Message identity doctrine: content hash as cross-turn join key, order > hash, msgid rung, snapshot render | | [session-identity](session-identity.md) / [中文](session-identity.zh-CN.md) | Which session an *anonymous* request belongs to | -| [session-identity-resolution](session-identity-resolution.md) / [中文](session-identity-resolution.zh-CN.md) | Which *conversation* a known client session id belongs to (same id, different conversations) | -| [identity-channels](identity-channels.md) / [中文](identity-channels.zh-CN.md) | Cross-client stable conversation+message id wiring (#5825): who carries identity in, where it is consumed | -| [msgid-infrastructure](msgid-infrastructure.md) / [中文](msgid-infrastructure.zh-CN.md) | Where sessionid+msgid is produced, validated (six copies), pinned, and consumed | -| [opencode-responses-websocket](opencode-responses-websocket.md) / [中文](opencode-responses-websocket.zh-CN.md) | OpenCode V2 Responses-over-WebSocket integration (#1844) | +| [session-identity-resolution](session-identity-resolution.md) / [中文](session-identity-resolution.zh-CN.md) / [日本語](session-identity-resolution.ja.md) | Which *conversation* a known client session id belongs to (same id, different conversations) | +| [identity-channels](identity-channels.md) / [中文](identity-channels.zh-CN.md) / [日本語](identity-channels.ja.md) | Cross-client stable conversation+message id wiring (#5825): who carries identity in, where it is consumed | +| [msgid-infrastructure](msgid-infrastructure.md) / [中文](msgid-infrastructure.zh-CN.md) / [日本語](msgid-infrastructure.ja.md) | Where sessionid+msgid is produced, validated (six copies), pinned, and consumed | +| [opencode-responses-websocket](opencode-responses-websocket.md) / [中文](opencode-responses-websocket.zh-CN.md) / [日本語](opencode-responses-websocket.ja.md) | OpenCode V2 Responses-over-WebSocket integration (#1844) | | [plugin-protocol](plugin-protocol.md) | Cooperative plugin protocol v2 (experimental) | | [wire-contracts](wire-contracts.md) / [中文](wire-contracts.zh-CN.md) | WC ledger: permanent upstream wire constraints behind the declared custom-wire endpoints (#1295); entries are never deleted, only superseded | diff --git a/docs/index.zh-CN.md b/docs/index.zh-CN.md index 89dcb47d9d..9878867660 100644 --- a/docs/index.zh-CN.md +++ b/docs/index.zh-CN.md @@ -7,7 +7,7 @@ | 文档 | 说明 | |---|---| -| [README](../README.md) / [English](../README.zh-CN.md) | 项目入口:是什么、快速上手、架构总览 | +| [README](../README.md) / [English](../README.zh-CN.md) / [日本語](../README.ja.md) | 项目入口:是什么、快速上手、架构总览 | | [architecture](architecture.zh-CN.md) / [English](architecture.md) | **系统架构总览**(实时维护,owner 裁定 2026-11-08):整体架构图 + 每模块一页(各配图),见 `docs/architecture/` | | [configuration](configuration.zh-CN.md) / [English](configuration.md) | 全量配置参考(由 `website/config-reference/*.yaml` 经 `tools/gen-config-docs.mjs` 生成;手写部分有漂移守卫) | | [clients](clients.zh-CN.md) / [English](clients.md) | 各客户端接入深潜:launcher / `/bili/` / 原生插件三种模式如何接线 | @@ -20,10 +20,10 @@ |---|---| | [message-identity](message-identity.zh-CN.md) / [English](message-identity.md) | 消息身份教义:内容哈希作跨轮 join 键、顺序 > hash、msgid 层、快照渲染 | | [session-identity](session-identity.zh-CN.md) / [English](session-identity.md) | 匿名请求归属哪个会话 | -| [session-identity-resolution](session-identity-resolution.zh-CN.md) / [English](session-identity-resolution.md) | 已知客户端 session id 归属哪个会话(同 id 不同会话的裁决) | -| [identity-channels](identity-channels.zh-CN.md) / [English](identity-channels.md) | 跨客户端稳定会话/消息 id 接线(#5825):谁带身份进来、在哪里消费 | -| [msgid-infrastructure](msgid-infrastructure.zh-CN.md) / [English](msgid-infrastructure.md) | sessionid+msgid 的生产、校验(六份副本)、钉住与消费 | -| [opencode-responses-websocket](opencode-responses-websocket.zh-CN.md) / [English](opencode-responses-websocket.md) | OpenCode V2 Responses-over-WebSocket 集成(#1844) | +| [session-identity-resolution](session-identity-resolution.zh-CN.md) / [English](session-identity-resolution.md) / [日本語](session-identity-resolution.ja.md) | 已知客户端 session id 归属哪个会话(同 id 不同会话的裁决) | +| [identity-channels](identity-channels.zh-CN.md) / [English](identity-channels.md) / [日本語](identity-channels.ja.md) | 跨客户端稳定会话/消息 id 接线(#5825):谁带身份进来、在哪里消费 | +| [msgid-infrastructure](msgid-infrastructure.zh-CN.md) / [English](msgid-infrastructure.md) / [日本語](msgid-infrastructure.ja.md) | sessionid+msgid 的生产、校验(六份副本)、钉住与消费 | +| [opencode-responses-websocket](opencode-responses-websocket.zh-CN.md) / [English](opencode-responses-websocket.md) / [日本語](opencode-responses-websocket.ja.md) | OpenCode V2 Responses-over-WebSocket 集成(#1844) | | [plugin-protocol](plugin-protocol.md) | 协作插件协议 v2(实验性,无中文版) | | [wire-contracts](wire-contracts.zh-CN.md) / [English](wire-contracts.md) | WC 台账:可声明自定义 wire 端点(#1295)背后的上游 wire 约束永久账本;条目只被取代(SUPERSEDED),不删除 | diff --git a/docs/msgid-infrastructure.ja.md b/docs/msgid-infrastructure.ja.md new file mode 100644 index 0000000000..afade96f52 --- /dev/null +++ b/docs/msgid-infrastructure.ja.md @@ -0,0 +1,74 @@ +# メッセージ ID レーンインフラストラクチャ:sessionid+msgid の生産/消費マップ + +> ステータス:#5826 リリースレビューが命じたギャップ修正の姉妹ドキュメント(オーナー裁定 2026-11-07)。アイデンティティラダー教義は message-identity.md(kernel)と session-identity.md(セッション側)にある;このファイルは*1 つだけ*の仕事——クロスレーン公共基盤である sessionid+msgid がどこで生産され、どう運ばれ、誰が検証するか(6 コピー)、どこにピンされ、その 5 つの消費者と宣言された信頼境界を説明すること。これらに触れる前にこれを読むこと。 + +## 1. 何ものか + +4 つのプラグインレーン(dsh / omp / opencode / pi)はホストが全メッセージに安定 UUID(**msgid**)をスタンプし、各リクエストとともに上流に乗る;bili はメッセージアイデンティティをそこにピンする(書き換え/並べ替え/圧縮を生存)。サーバー側 **sessionid** = ホスト会話 ID(persona 分割ルール後 `|sub:` サフィックスを持つことがある、KDD #9)。両者合わせで台帳トリプル `(session_id, msg_id, content_hash)` の最初の 2 次元:msgid がアイデンティティを固定し、コンテンツハッシュが誤ペアリングを守る(KDD #11/#13 がラダーとスナップショットレンダリング教義を持つ;ここでは繰り返さない)。 + +## 2. 生産(誰が ID を作るか) + +| レイヤー | 内容 | 場所 | +|---|---|---| +| ホスト発行 | ホストが会話スコープ内でメッセージ毎安定 UUID を割り当てる(圧縮後再利用なし);`acp_summary_*` ネームスペースは kernel 合成アンカーに属する——ホスト ID はこれをクレームしてはならない | dsh: `options.messages[].id`;pi/opencode/omp は各自のホストフィールド経由 | +| dsh 薄集約器 | `hostMsgIdsOf`(全有無)+ `pfSlotIdsOf`(スロット毎変種、悪いスロットは `?` で乗る) | src/agent/dsh-native.ts (~:1186/:1202) | +| pi パーサー | `laneMsgIdsForWire` / `laneMsgIdsForOpenAiWire`;**正規バリデータを直接呼ぶ**(ミラーではなく);設定組み立て先頭 system スロットは枝エントリなし → 合成 `bili-ps-N` 位置トークン | src/agent/pi.ts | +| opencode / omp | 同じ既に検証済みリストを再利用(transform フック / `ompTurnMsgIds` fetch レイヤー整列、anthropic ワイヤターンのみ) | src/agent/opencode-native.ts / omp レーン | + +規律:集約器は「取得と前選別」のみ;アイデンティティ裁定権を持たない——裁定は §4 バリデータと §5 ストレージにある。 + +## 3. トランスポート形状(ID がどう上流に乗るか) + +4 つのキャリア、**すべてモデルアップストリーム転送前に剥離される**——モデルワイヤはまだメッセージレベル ID を持たない(#2821 教義): + +1. **エンベロープフィールド** `biliMsgIds`:フルリセットモデルボディ上の並列配列、messages に長さロック、同じライフサイクル(ingress で剥離、src/server/prepare-anthropic.ts など)。 +2. **増分ターンペイロード** `msgIds`:`POST /__bili/plugin/turn` のエンベロープ(src/agent/incremental-client.ts);サーバーが `biliMsgIds` を再スタンプ(src/incremental-lane.ts)。 +3. **ウォーターマークヘッダー** `x-bili-pf-tail-ids`(v2-v4、#5403/#5418):ウィンドウ区間のみ = 最後のアンカー要素 + K 以降追加された全要素、セグメント毎パーセントエンコード、カンマ区切り(ID 内のカンマは `%2C` で乗る、セパレーターは文字のまま);兄弟 `x-bili-pf-count` カウントスタンプ。pf-* ヘッダーは**プロトコルヘッダーでありホップヘッダーではない**:`UPSTREAM_HOP_HEADERS` 経由で上流前に剥離。 +4. **台帳 seq 兄弟** `biliLedgerSeqs` / `ledgerSeq` スタンプ(#4316 L3 PR2/3):1 始まり正整数並列配列、`validateMsgSeqs` で検証、同じ厳密検証後劣化ライフサイクル。 + +## 4. 検証コピー(なぜ 6 つか、どう同期を保つか) + +構造制約:**注入されたホストバンドルは外部ランタイム内で動いてサーバーモジュールを import してはならない**(src/agent/dsh-native.ts ~:1177、src/agent/incremental-client.ts ~:227 の制約コメント)。ミラーリングはしたがって怠慢ではなく構造的必然。6 コピーとその選別面: + +| コピー | 場所 | 役割 | 厳密性プロファイル | 劣化方向 | +|---|---|---|---|---| +| **正規** `validateMsgIds` | src/msgid-pin.ts | ingress ゲート(フルリセット + 増分ターンゲート) | 厳密全有無 + 正確な長さ;拒否:非文字列/空/長すぎる(>512)/予約プレフィックス/\s/\p{C}/重複 | フィールド破棄 → ターンがコンテンツハッシュ/ID にフォールバック | +| 寛容受信変種 `incomingMsgIdsOf` | src/msgid-pin.ts | #5719 最後の手段階段入力 | 幅契約なし、**重複排除ゲートなし**;制御クラス = `\s`+C0/Del のみ(U+200B は通過) | undefined → #5719 前パス | +| dsh ホストミラー | hostMsgIdsOf / pfSlotIdsOf (src/agent/dsh-native.ts) | ホスト側収集 | 全有無 / スロット毎 `?`;完全 \p{C} クラス | ターンが非増分にフォールバック / スロットが ? で乗る | +| incremental-client ミラー `screenMsgIds` | src/agent/incremental-client.ts | エンベロープに乗る前の前選別 | 全有無ブール | 「no field」フォールバック(400 で全リクエストを殺すのを回避) | +| pf チャネルインライン選別 | src/agent/pf-channel.ts (capture ~:99) | ウォーターマーク ID 捕捉状態機械 | スロット毎 `?` + `MAX_IDS=2048` 上限 + 解決失敗が保存リストをクリア | カウントのみモード | +| ワイヤデコード `parseTailIds` | src/server/fastpath.ts | tail-ids ヘッダーのサーバー側デコード | 全セグメント無効化;#5826 レビュー時点で完全な正規拒否集合を強制(予約プレフィックスゲートクローズ) | このターンカウントのみ、ブレーカークレジットなし | +| 証拠のみ寛容 `collectRequestIds` | src/request-membership.ts | #4805 決済メンバーシッププローブ入力 | 悪いエントリをスキップ(無効化しない)、制御文字スクリーニングなし、再送 toolCallIds にフォールバック | 空証拠 → このサイクルメンバーシップ未解決 | + +**機械的ロック:`tests/msgid-rule-parity.test.ts`。** すべての拒否クラスが全コピーに通され、現在の判定がコピー毎アサートされる。意図的分岐は*分岐として*ピンされる(例:U+200B が `incomingMsgIdsOf`/`collectRequestIds` を通過——両者は純粋証拠役割;そのような ID は厳密ピンされた保存 ID と決して重複しないので誤アンカーできない)。いかなるコピーのルール変更も、理由付きマトリクスを意図的に再ピンするまで CI が赤になる。「同期を保つ」コメントは今や CI backed。 + +レビューからの一回きりのクローズ:`parseTailIds` だけがデコード側に予約プレフィックスゲートを欠いていた;ここでクローズ。すべての本番エミッターは既に前選別済みなので、これは単一サーバーチョークポイントでの防御の多層化で、より保守的(リスト全体無効 → 劣化)、ゼロの動作表面。 + +## 5. 永続化の唯一の真実源 + +統一ストアの `messages.msg_id` 列が唯一の ID 真実:ingestion が検証済み ID を行にピンする(T5 裁定:並列台帳なし;スケルトン行は ID を持たない)。台帳主キー `(session_id, msg_id, content_hash)`;正規行は**コンテンツハッシュではなく MSGID** でキー付け(#4491);フォーク複製が番号を保持(#4316 L3 PR3/3 `cloneSessionRows`)。 + +## 6. 消費者(5 つ;それぞれが ID に何を尋ねるか) + +| 消費者 | 場所 | 答えられる質問 | ID 使用境界 | +|---|---|---|---| +| ① ストレージ列アイデンティティ | 統一ストア `messages.msg_id` | 全決済/reconcile パスの結合キー | 単一のアイデンティティ空間入口点;他の 4 つの ID 証拠は最終的にここに折り込まれる | +| ② session-resolve 最後の手段階段 #5719 | tryMsgIdRescue (src/session-resolve.ts ~:324;フォーク出口呼び出し箇所 ~:432/:481/:501) | バイト/tag 証拠が破壊された後(圧縮がセル削除、system 書き換えがフラグメント削除)、このリクエストは*同じ*セッションか? | 同じ raw キー下で*任意*の ID 重複 ⇒ 同じセッション;注:レーン帰属なし(§7 境界 B) | +| ③ 決済メンバーシッププローブ #4805 | probeRequestMembership (src/request-membership.ts;呼び出し箇所 src/server/prepare-openai.ts:597, prepare-anthropic.ts:640;消費 cache-ledger.ts:1866) | この ID はこのセッションの台帳に許可されたか? needle = 最新許可 ID | **純粋証拠——アイデンティティ空間に入らない**、再キー付け/フォークしない;最悪 1 サイクル未決済、自己修復 | +| ④ 増分レーン正規行 #4491/#4834 | src/incremental-lane.ts (validateMsgIds :623, claim-reuse 400 :628, cache-control rekey :631-635;dsh 側 burned-claim 前選別 ~:2584) | このデルタターンはどの正規行を追加したか? | claim セマンティクス:再送された claim ID = リトライ嵐信号、ターンが 400 | +| ⑤ ウォーターマーク末尾連続 v2-v4 #5403/#5418 | PF_TAIL_IDS_HEADER (src/server/fastpath.ts:48) | クライアントのデルタウィンドウはまだサーバーシードが言う場所から始まっているか? | v4 幅自己整合(len=T−K+1、サーバー側再検証)下でカウントエコーは診断のみへ劣化;ID は*ウィンドウ起源のみ*を証明し、プレフィックス整合性を決して証明しない(オーナー裁定 2026-11-02;§7.4 ブラインドスポットは存続、§7 境界 A) | + +## 7. 信頼境界(バグではなく契約の一部として宣言) + +- **A. §7.4 ウォーターマークブラインドスポット:** 要素数を不変にするプレフィックスタイプ編集は検出不能。人間レビューゲート、決して自動マージ;マルチモーダル末尾がキャッシュに入ると、その履歴は永久に legacy ターンへ劣化する。 +- **B. #5719 最後の手段階段にレーン帰属がない:**「任意 ID 重複 ⇒ 同じセッション」はメイン vs 補助レーンを区別しない。ホストが persona/review サイドディスパッチに重複 ID をスタンプする場合(共有 ID 空間、または親ターン ID を埋め込む review)、フローはメインセッションにアンカーし `record()` がスケルトンの tag/model をフォーク自身のものに上書きする。ホストが本当にそうするかは repo から証明不可能——条件付きリスク、処置はオーナー裁定待ち(トレースログ提案は #5826 コメント内)。素朴な tag 等値前提は拒否:dsh はターン毎 system プロンプトをローテーションするので、*同じ*レーンの隣接ターンは異なり、その前提は救助自体を殺す。 +- **C. membership needle が aux 埋め込みで貫通可能:** 親ターン ID を埋め込むサイドリクエストはプローブ needle を古い行に着地させうる → そのサイクル決済未解決(次のメイン規模リセットで自己修復)。証拠のみ役割下で最大 1 ロストサイクル;許容。 +- **D. ホスト発行前提:** ID は会話スコープ内で安定かつ一意、圧縮後再利用なし。封じ込め:誤ペアリングは自分の raw キー下の記録を汚染するだけで、それ以外は汚染しない。 + +## 8. 変更規則(これらに触れる前のチェックリスト) + +1. いかなる拒否クラスの追加/変更/削除も → 厳密ファミリーの全コピー(`validateMsgIds`、`incomingMsgIdsOf`*、dsh ミラー両方、`screenMsgIds`、pf-channel インライン、`parseTailIds`)と tests/msgid-rule-parity.test.ts のマトリクス行を、1 つの変更で更新。(*`incomingMsgIdsOf`/`collectRequestIds` の寛容性は意図的;変更にはオーナーレベルの正当化が必要。) +2. 新規消費者はコードを書く前に §6 に 1 行登録する。 +3. ホストバンドルはサーバーモジュールを import してはならない(§4 構造制約);新規ミラーは対称テストに自分の行を得る。 +4. ID は上流可視ボディ/ヘッダーに到達しない(strip 規律、§3);pf-* ヘッダーはプロトコルヘッダー地位を維持。 +5.「ID 不一致 / destroyed 誤診 / キャッシュ壊れ」系バグを議論する前に、message-identity.md ラダーとここ §6 を確認し、そのセッションがどの消費者パスを通るか確立する。 diff --git a/docs/opencode-responses-websocket.ja.md b/docs/opencode-responses-websocket.ja.md new file mode 100644 index 0000000000..65e67cf928 --- /dev/null +++ b/docs/opencode-responses-websocket.ja.md @@ -0,0 +1,35 @@ +# OpenCode V2 Responses WebSocket 統合(#1844) + +## 承認済みスコープ + +ユーザーは 2026-10-01 に、以前議論していた双方向 WebSocket ACP 統合の実装を承認した。OpenCode V2 は WebSocket 経由で bili に接続し、bili は選択された Responses アップストリームに WebSocket 経由で接続する。これには OpenAI API と ChatGPT OAuth/Codex エンドポイントを含む。Realtime、汎用の不透明 WebSocket パススルーは実装せず、ユーザーの OpenCode 設定も変更しない。 + +## 設計上の判断 + +- V2 ハンドシェイクフックは、サポートされる Responses ソケットをプラグインアイデンティティとモデルメタデータ付きで既存の明示プロトコルトンネル経由でルーティングする。他のプロトコル、無効化されたプラグイン、古いホストは既存の挙動を維持する。 +- 初期はループバックのみ、協調的な OpenCode Responses アップグレードだけを許可する。宛先の許可は既存のトンネルガードを再利用する。未引受のアップグレードも引き続き既存の即時 426 を受け取る(PR #1472 と独立)。 +- Responses フレームはネットワーク HTTP ホップではなく、プロセス内の HTTP 形状エンベロープを経て既存のリクエストパイプラインに入る。非同期スコープの fetch トランスポートがモデルリクエスト、リトライ、プリフライトリクエストをアップストリーム WebSocket 上で実行する。既存の ACP ポリシー、ツール実行、使用量集計、散文フィルタリングが唯一の権威であり続ける。ツール引数字符列は決してクリーンアップされない。 +- クライアントとアップストリームの継続チェックポイントは別物:クライアントは元の履歴と可視出力を見る、アップストリームは ACP 処理済み履歴を見る。受信デルタは ACP 前に展開される。送信デルタは処理済み入力があるがままアップストリームチェックポイントを拡張する場合にのみ使われる。フォールドや他の履歴変更では previous_response_id なしの完全な処理済み入力を送る。これにより新しいソケットを必要とせずに新しいレスポンスチェーンを開始できる。`view=ws-expanded` とマークされたリクエストサイズログは再構築されたパイプラインエンベロープを記述するもので、増分 WebSocket ワイヤバイトではない。 +- 完了したレスポンスだけが継続チェックポイントを確立する。切断、キャンセル、失敗/不完全なレスポンス、未知のレスポンス ID は成功履歴を捏造しない。チェックポイントとキューイングされたペイロードには上限がある。 +- 両方のチェックポイントは出力インデックスごとに `response.output_item.done` アイテムを累積する。空・欠落・部分的な終端 `response.output` は完了済みツールコールを消去して次のデルタで孤立結果を残してはならない。終端アイテムはアイテム ID でマージされ、ストリーミングフレームは不変。デバッグログは復元されたチェックポイントアイテム数を報告し、内容は記録しない。 +- WS 診断はローカルソケットとセッション、失敗フェーズ(`handshake`、`await-first-event`、`stream`、または `dispatch`)、数値クローズコード、フル/デルタリクエストモード、チェックポイントのリセット/回復理由を識別する。認証ヘッダー、URL、クローズ理由テキスト、ペイロード、アップストリームエラーメッセージは省略する。正常なライフサイクル/回復の詳細は debug、失敗は warn を使う。 +- 設定フィールド、環境変数、パッケージバージョン、永続化形式、acp-kernel バージョンを追加も変更もしない。ソケットチェックポイントは接続ローカルであり、ACP 永続化は不変。ws 実装はバンドルされたビルド時依存であり、外置ランタイム要件ではない。 + +## アーキテクチャ:汎用 WebSocket ブリッジ(#1467 phase-2 シェル) + +WebSocket インターセプトはプロトコル非依存シェルとプロトコル毎のコーデックに分割される: + +- `src/ws-bridge.ts`(シェル)は許可(ループバックソース、`x-bili-plugin` レーンマーカ、`x-bili-plugin-conversation` セッションヘッダー、トンネル宛先ガード)、アップグレードハンドシェイク、接続毎の簿記、シャットダウン時のティアダウンを所有する。どんなワイルプロトコルも知らない。 +- `src/responses-ws.ts`(コーデック)は Responses 固有のすべてを所有する:フレーム検証、`previous_response_id` クライアント履歴契約、継続チェックポイントを持つアップストリーム WebSocket トランスポート、SSE レスポンスシンク。単一の配線箇所のコーデックテーブルに登録される(`src/server.ts` の `installWebSocketBridge(server, dispatch, log, [responsesCodec, codexResponsesCodec])`)。 + +第 2 のワイルプロトコルは新しいコーデックファイル + テーブルエントリ 1 つ——シェルは変更しない。シェル契約は `WsBridgeCodec`(名前、プラグインマーカ、URL クレーム、セッションファクトリ)と `WsBridgeSession`(message/close/shutdown)。セッションはラベル付きロガー、アップグレードされたピア、アップグレードリクエスト、クレームされたアップストリーム URL、ACP パイプライン入口(`dispatch`)を受け取り、プロセス内でワイルプロトコル形状のエンベロープを再構築することが期待される。`tests/ws-bridge.test.ts` は合成の第 2 コーデックでシェルを駆動し、コーデックテーブルを誠実な状態に保つ。 + +第 2 の実コーデックは既にここにある:**`codexResponsesCodec`** は codex CLI の Responses-over-WebSocket ダイアル(`/bili//responses`、会話ヘッダー `session-id`、`stream:true` フレーム、パイプライン前後で逐語中継される `generate:false` の接続毎プレウォームプローブ)をクレームする。プレフィックスレーン:ワイヤにプラグインマーカがなく、許可はループバック + 会話ヘッダー + トンネルガードに基づく——プレフィックスモード HTTP と同じ信頼レベル。Codex は毎ターン完全な履歴を再生する(`previous_response_id` は送信されない)ので、フォールドは次の再生を単純に縮小する;`tests/codex-responses-ws.test.ts` を参照。 + +未知のプロトコルは圧縮できない(フォールディングには履歴がワイル形式のどこにあるかを知らなければならない);それらは #1472 の透明パススルーレーンにとどまり、このブリッジには触れられない。 + +## 検証 + +乱数ループバックポートと偽の Responses WebSocket アップストリームを使い、実際の認証情報やモデル使用量なしで。双方向が WebSocket の上にとどまること、通常の継続が増分であること、実際の ACP フォールドがアップストリーム履歴をリセットすること、ツール引数ペイロードが不変で生存すること、使用量が既存セッションに届くこと、終端出力が疎でもフォールド後も連続するツールコール/結果が履歴を進めること、未知のアップグレードが 426 を維持することを証明する。アップストリームプロキシルーティング、エラー、キャンセル、再接続、チェックポイントミス、セッション分離を検証する。隔離設定と成功した偽 WebSocket アップストリームで本物の OpenCode V2 バイナリを動かす;HTTP へフォールバックしただけの利用不能なソケットは許容できる証拠ではない。人間のレビュー対象 PR を提出する前に typecheck、完全なユニットスイート、ビルド、必要な Responses クライアント E2E を実行する。 + +失敗組合せのカバレッジには、切断前に届けられたツール引数、失敗/不完全な終端イベント、ローテーションした合成認証情報での新接続への直後のキャンセル、重複 create、有界リトライを伴う連続する継続/接続上限エラー、回復を伴うハンドシェイク拒否が含まれる。疎出力の実フォールドテストはさらにチェックポイント欠落、アイドル切断、接続上限ローテーションを連鎖させ、サマリーが生存し各完了コール/結果がアップストリームにちょうど 1 回ずつ現れることをアサートする。これらはトランスポート/履歴のアサーションであり、任意のホストツールの厳密なちょうど一度実行や実際の OAuth リフレッシュライフサイクルの証明ではない。 diff --git a/docs/session-identity-resolution.ja.md b/docs/session-identity-resolution.ja.md new file mode 100644 index 0000000000..b60ccefbd5 --- /dev/null +++ b/docs/session-identity-resolution.ja.md @@ -0,0 +1,62 @@ +# セッションアイデンティティ解決(同じクライアント ID、異なる会話) + +セッション ID(クライアント発行の会話識別子)が判明した時点で、billion-context がそのリクエストが**どの会話に属するか**をどう決めるかの設計記録。姉妹ページ:`session-identity.md`(姉妹——*匿名*レーン:リクエストが ID を全く持たない場合の対応)、`message-identity.md`(メッセージ単位のアイデンティティ教義)、`docs/identity-channels.md`(そもそも ID を誰が bili に運ぶか)。規範的記述:AGENTS.md KDD #11(アイデンティティ階層)と KDD #18(チャネル配線法)。 + +## 二つの識別子とその役割 + +- **セッション ID**(コードでは `rawId`)。クライアントが毎リクエスト送る安定文字列(例:`x-claude-code-session-id`、`agent-session-id`、`x-conversation-id`)。認識(`src/session-id.ts`)は順序付き候補名リストから値を選ぶ——クライアント固有の高信頼名を裸の汎用名より先——その文字列がベースキーになる。リクエストを一山にまとめるだけ;山の中のどの会話かは決して言わない。 +- **メッセージ ID**(ホスト発行のメッセージ毎 UUID、例:dsh の正規スタンプ)。存在する場合、同じセッション ID を共有する会話同士の仲裁者になる。正規形ルールは `src/msgid-pin.ts`(長さ ≤512、予約 `acp_summary_` プレフィックス拒否、制御文字拒否);対称ピン `tests/msgid-rule-parity.test.ts` が手動同期コピーを固定する。 + +両者はクライアントと bili 間の簿記にすぎない:すべての内部フィールド/ヘッダー(`biliMsgIds`、`x-bili-msg-ids`)はプロキシを出る前に剥離される(`UPSTREAM_HOP_HEADERS`)。どちらもモデルエンドポイントに到達することはない。 + +## 解決ラダー(`src/session-resolve.ts`、`resolveSessionOrder`) + +各セッション ID の下、リゾルバは**スケルトン**を保つ:メッセージ種順列、先頭フラグメントハッシュ、system/persona テキストの sha256("" = アンカー非)、宣言モデル——デバウンス永続化され、再起動でコールドスタートクレーム競争が再実行できない(#3397)。到着する各リクエストは以下を順に踏む: + +1. **ディスパッチレーントークン**(#5095):ディスパッチ毎トークン(claude サブエージェント)は自分の決定論キーを即座にクレーム——裏付け不要。 +2. **ID 下での初認**。メイン形状の履歴が生のキーをクレーム。タグなし浅い履歴(単一 user blob、assistant ターンなし)は決してクレームしない——`|sub:aux` を得る;散文を一切読まずに #1916 の review-steals-raw 競争が死ぬ場所。 +3. **バイトレベル継続**。プレフィックス整列 + 末尾フラグメント検証。ほぼ全ターンをカバーする高速パス。 +4. **persona テキスト変更(同じ ID、異なる system プロンプト)**。脱出階段、各々が*逐語*の内容証拠を要求——「新しいプロンプトで履歴を継続」vs「共有 ID 下の見知らぬ者」: + - 先頭フラグメントが逐語再生(アンカー移行、#2241/#2250); + - ヘッダーで裏付けられた宣言モデル変更(#2601/#2817); + - 再起動後の永続プレフィックスチェーン連続性(#2156/#2815); + - 同じ履歴のホスト側編集を証明する ≥8 の同インデックス一致ラン(#4778、`CONTINUATION_MIN_RUN`); + - フラグメント検証済み末尾を保持する短い再生(#5686)。 + いずれかの階段を通る → **生のキーへ再アンカー**。すべて失敗 → **派生 persona レーン** `${sessionID}|sub:` —— 決定論サフィックスなので、同じ persona の連続呼び出しは常に同じレーンに着地し、レーン数はトラフィックで増えない。 +5. **同じ persona、分岐した順序**。末尾整列再アンカー(スケルトンは生きた端に従う);本当に整列しない形状 → 派生タスクレーン `${sessionID}|sub:task:`。 +6. **最後の手段メッセージ ID 階段**(#5719、`tryMsgIdRescue`)。バイト証拠が*そのターン内で破壊された*ために全バイトレベル階段が失敗した出口でのみ参照される(クライアント圧縮が system プロンプトフィールド書き換え中に行を削除——#5719 事故)。≥1 個の到着ホスト ID が統一ストア内のセッション ID キー下に記録された行と一致 → 同じ会話、再アンカー。ゼロ重複 → フォークを確認。リクエストに ID なし → フォークは #5719 前と全く同じように進む。 + +下流すべて(ストレージ行、フォールドブロック、ウォーターマークシード、台帳 seq)はラダーが返したキー——生かサフィックス付き——でキー付けされるため、1 つのセッション ID 下の 2 つの会話は独立して保存、フォールド、圧縮される。 + +### なぜメッセージ ID 階段が最後で最初にないか + +ルール自体は無条件:**セッション ID 一致 + ≥1 個重複メッセージ ID ⇒ 同じ会話**、追加条件なし(オーナー教義、`src/session-resolve.ts` `tryMsgIdRescue` で正確に実装されている)。意図的なのはラダー中の位置である。記録された根拠(オーナー議論 2026-11-07;裁定:現状維持): + +1. **意味的非対称性。** *ゼロ*重複は安全な陰性証拠;*陽性*重複は「同じ会話」を証明しない——正当に 1 つのセッション ID を共有しながら別の役割に属するフロー(以前の履歴を埋め込む review/title/派生トラフィック——事故 #150 fresh task、#1916 auto-review、#4438 review rides the raw key through the full pipeline)。重複判定をグローバル第一段階として走らせると、構造チェックが分離する前にそれらのリクエストをメイン会話として分類し、スタンプレーンでは——メインフローが毎ターン ID を付した全過去メッセージを再送するので、重複は*構造的に*成立——多役割分割が恒久的にショートカットされ、以降の全階段がデッドコードになる。正しさは判定自体ではなく、上流クライアントが偶然 ID を省略することに依存することになる。最後に置くことで、同じルールは構造証拠が既に「新しい会話」と言い、かつ既知の良性理由でバイトチェーンが切れた場所で初めて発火する——そこで「ある程度の重複」は他のあらゆる説明を除外する。 +2. **データ局所性。** 継続チェックはメモリ内スケルトン(前のリクエストで満たされる)上で走る;保存されたメッセージ ID セットはデータベースにある。比較は安いもののディスク backed のチェックをメモリ resident のものより前に置くと、ホットパスにターン毎ストア読み取りを加える。 +3. **可用性。** ほとんどのレーンはメッセージ ID を全く持たない(未スタンプ、未配線);そのリクエストには階段自体が存在しない。 + +## 切り替えレイヤー(何が統合され、何がオフのままか) + +| レイヤー | 機構 | 統合後の既定 | +|---|---|---| +| セッション ID 認識(新規名 `x-conversation-id`、`agent-session-id` 含む) | ゲートなし;値はクライアント供給、ローカルキーとしてのみ使用、転送されない | すべてのインストールで有効 | +| メッセージ ID ハーベスト(プロキシがクライアントローカル transcript/sqlite を読む:claude-code、codebuddy、mcode、goose、qwen-code) | `env BILI_IDENTITY_HARVEST` **または** コホート `rollout.features.identityChannelHarvest`(どちらだけでも有効)× ループバックソースのみ | オプトインまで**どこでも off** | +| 行ピンニング(スタンプ/ハーベスト ID を保存行アイデンティティに書き込む、両ワイヤ) | 既存コホート `pluginLaneServerHistory` | 0%(不変) | +| 内部 ID フィールド/ヘッダーの上流転送前剥離 | 無条件 | 中立(フィールドは出ることすら想定されていなかった) | + +レーン毎の完全ステータステーブル(配線済み / クローズメモ / 保留、監査理由付き):`docs/identity-channels.md`。 + +## 信頼境界と劣化契約 + +- **ターン全体劣化、部分的誤ペアリングは絶対にしない。** いかなるステップの失敗(行数不一致、破損ファイル、スキーマドリフト、検証拒否、ロールスポットチェック不一致)も、そのターンの候補リスト全体を破棄し、リクエストは配線前パスと全く同じにフォールバックする。一部のメッセージをマップして残りを見当つけるモードはない。 +- **ループバック限定ハーベスト。** レジストリは有効化されていても非ループバックソースを拒否する;アダプタは信頼されたローカルクライアントを前提とする。 +- **レイアウト知識はソース監査グレード。** アダプタの期待(テーブル、列、順序、どの行がカウント対象か)は上流ソースを読むことから来て、測定インストールからは来ない——ハーベストをオプトインスイッチの後ろに出す理由。 +- **フォーク安全性。** 唯一の誤割り当て前提は、1 つのセッション ID 下で長い*逐語*内容を共有する 2 つの異なる会話;フラグメントはハッシュグレードなので実際には起こらない。文書化されたコーナー:浅い aux 呼び出しが先に到着して空 ID を巡って競争しうる;メイン会話はその後、永続プレフィックスチェーン階段で回復または分離——回帰ピン済み(初認クレーム規則、#316;#1916 aux 分岐)。 +- **#5719 階段の到達可能性注記。** review/aux ディスパッチが親の行と重複するスタンプ ID に乗るか否かはホスト挙動に条件付き——1 行トレースログフォローアップとして追跡(PR #5826 レビュー所見 P1)、推測で故意にクローズしていない。約束されたトレース行は現在存在する:各発火が `[session-resolve][msgid-rescue] hits=N/M exit=` を warn で記録(`src/session-resolve.ts`、#5865 レビュー P2)——≥2 vs ≥1 の閾値決定はそのフィールド証拠から行うべきで、推測によるものではない。 + +## 変更チェックリスト + +- 新規ハーベストレーン:新規 `src/identity-.ts`(自己完結、独自ストレージリーダー、認識済みセッション ID のみで結合)+ `src/identity-sources.ts` の登録行 1 つ + 両チャネルドキュメントの行 1 つ。利用箇所からクライアントストレージを読むことは絶対になし(KDD #18)。 +- 新規認識名:`src/session-id.ts` の正しい信頼ティアに挿入(クライアント固有用汎用より先)+ 優先度テスト。 +- いかなる新規内部 ID キャリアも `UPSTREAM_HOP_HEADERS` と対称ピンのバリデータ表面(`tests/msgid-rule-parity.test.ts`)に加えなければならない。 From 77766ba2533c2d23b9ae3ed4f456e3def03b7aa4 Mon Sep 17 00:00:00 2001 From: ci-check Date: Tue, 10 Nov 2026 11:36:59 +0800 Subject: [PATCH 02/17] docs: align identity-channels.ja diagram indent with EN (byte-identical fence) --- docs/identity-channels.ja.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/identity-channels.ja.md b/docs/identity-channels.ja.md index 760f282d1d..eb8693ee12 100644 --- a/docs/identity-channels.ja.md +++ b/docs/identity-channels.ja.md @@ -8,10 +8,10 @@ ``` stamped inbound ids (body fields / turn envelope) ──▶ same consumer path ◀── harvested ids - (msgid-pin validation → - #5719 attribution rung → - pin/row pipeline on - anthropic wire) + (msgid-pin validation → + #5719 attribution rung → + pin/row pipeline on + anthropic wire) ``` - **スタンプレーン**(dsh など):ホストが正規 ID(`acp_summary_*`)を発行し、ボディフィールドや `/__bili/plugin/turn` エンベロープにスタンプ;送出前にプロトコル剥離。 From 36f683b39db4cd55838529d5ace406e85b54c4f7 Mon Sep 17 00:00:00 2001 From: ci-check Date: Tue, 10 Nov 2026 11:37:12 +0800 Subject: [PATCH 03/17] docs: un-cross README row labels in docs/index.zh-CN.md (English label pointed at the Chinese file) --- docs/index.zh-CN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/index.zh-CN.md b/docs/index.zh-CN.md index 9878867660..3182b2318e 100644 --- a/docs/index.zh-CN.md +++ b/docs/index.zh-CN.md @@ -7,7 +7,7 @@ | 文档 | 说明 | |---|---| -| [README](../README.md) / [English](../README.zh-CN.md) / [日本語](../README.ja.md) | 项目入口:是什么、快速上手、架构总览 | +| [README](../README.zh-CN.md) / [English](../README.md) / [日本語](../README.ja.md) | 项目入口:是什么、快速上手、架构总览 | | [architecture](architecture.zh-CN.md) / [English](architecture.md) | **系统架构总览**(实时维护,owner 裁定 2026-11-08):整体架构图 + 每模块一页(各配图),见 `docs/architecture/` | | [configuration](configuration.zh-CN.md) / [English](configuration.md) | 全量配置参考(由 `website/config-reference/*.yaml` 经 `tools/gen-config-docs.mjs` 生成;手写部分有漂移守卫) | | [clients](clients.zh-CN.md) / [English](clients.md) | 各客户端接入深潜:launcher / `/bili/` / 原生插件三种模式如何接线 | From 2eac884ad2cbf061db0f400ff88fa5656a0eb0e8 Mon Sep 17 00:00:00 2001 From: ci-check Date: Tue, 10 Nov 2026 11:40:47 +0800 Subject: [PATCH 04/17] =?UTF-8?q?fix:=20msgid-infrastructure.ja.md=20?= =?UTF-8?q?=E2=80=94=20space=20after=20'5.'=20so=20item=205=20renders=20as?= =?UTF-8?q?=20a=20list=20item?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/msgid-infrastructure.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/msgid-infrastructure.ja.md b/docs/msgid-infrastructure.ja.md index afade96f52..92a89bd774 100644 --- a/docs/msgid-infrastructure.ja.md +++ b/docs/msgid-infrastructure.ja.md @@ -71,4 +71,4 @@ 2. 新規消費者はコードを書く前に §6 に 1 行登録する。 3. ホストバンドルはサーバーモジュールを import してはならない(§4 構造制約);新規ミラーは対称テストに自分の行を得る。 4. ID は上流可視ボディ/ヘッダーに到達しない(strip 規律、§3);pf-* ヘッダーはプロトコルヘッダー地位を維持。 -5.「ID 不一致 / destroyed 誤診 / キャッシュ壊れ」系バグを議論する前に、message-identity.md ラダーとここ §6 を確認し、そのセッションがどの消費者パスを通るか確立する。 +5. 「ID 不一致 / destroyed 誤診 / キャッシュ壊れ」系バグを議論する前に、message-identity.md ラダーとここ §6 を確認し、そのセッションがどの消費者パスを通るか確立する。 From e4826509c30414a3472e822985d0826631d74fb6 Mon Sep 17 00:00:00 2001 From: ci-check Date: Tue, 10 Nov 2026 11:40:47 +0800 Subject: [PATCH 05/17] =?UTF-8?q?fix:=20opencode-responses-websocket.ja.md?= =?UTF-8?q?=20=E2=80=94=20restore=20dropped=20'responsesCodec'=20registrat?= =?UTF-8?q?ion=20name?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/opencode-responses-websocket.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/opencode-responses-websocket.ja.md b/docs/opencode-responses-websocket.ja.md index 65e67cf928..7c1454a89e 100644 --- a/docs/opencode-responses-websocket.ja.md +++ b/docs/opencode-responses-websocket.ja.md @@ -20,7 +20,7 @@ WebSocket インターセプトはプロトコル非依存シェルとプロトコル毎のコーデックに分割される: - `src/ws-bridge.ts`(シェル)は許可(ループバックソース、`x-bili-plugin` レーンマーカ、`x-bili-plugin-conversation` セッションヘッダー、トンネル宛先ガード)、アップグレードハンドシェイク、接続毎の簿記、シャットダウン時のティアダウンを所有する。どんなワイルプロトコルも知らない。 -- `src/responses-ws.ts`(コーデック)は Responses 固有のすべてを所有する:フレーム検証、`previous_response_id` クライアント履歴契約、継続チェックポイントを持つアップストリーム WebSocket トランスポート、SSE レスポンスシンク。単一の配線箇所のコーデックテーブルに登録される(`src/server.ts` の `installWebSocketBridge(server, dispatch, log, [responsesCodec, codexResponsesCodec])`)。 +- `src/responses-ws.ts`(コーデック)は Responses 固有のすべてを所有する:フレーム検証、`previous_response_id` クライアント履歴契約、継続チェックポイントを持つアップストリーム WebSocket トランスポート、SSE レスポンスシンク。単一の配線箇所のコーデックテーブルに `responsesCodec` として登録される(`src/server.ts` の `installWebSocketBridge(server, dispatch, log, [responsesCodec, codexResponsesCodec])`)。 第 2 のワイルプロトコルは新しいコーデックファイル + テーブルエントリ 1 つ——シェルは変更しない。シェル契約は `WsBridgeCodec`(名前、プラグインマーカ、URL クレーム、セッションファクトリ)と `WsBridgeSession`(message/close/shutdown)。セッションはラベル付きロガー、アップグレードされたピア、アップグレードリクエスト、クレームされたアップストリーム URL、ACP パイプライン入口(`dispatch`)を受け取り、プロセス内でワイルプロトコル形状のエンベロープを再構築することが期待される。`tests/ws-bridge.test.ts` は合成の第 2 コーデックでシェルを駆動し、コーデックテーブルを誠実な状態に保つ。 From 58509921df4f075502cd66f8b84c3bafa2da6fce Mon Sep 17 00:00:00 2001 From: ci-check Date: Tue, 10 Nov 2026 11:48:11 +0800 Subject: [PATCH 06/17] docs: add Japanese translations for message-identity & session-identity (#6072) --- docs/index.md | 4 +- docs/index.zh-CN.md | 4 +- docs/message-identity.ja.md | 419 ++++++++++++++++++++++++++++++++++++ docs/session-identity.ja.md | 255 ++++++++++++++++++++++ 4 files changed, 678 insertions(+), 4 deletions(-) create mode 100644 docs/message-identity.ja.md create mode 100644 docs/session-identity.ja.md diff --git a/docs/index.md b/docs/index.md index af10545c81..959be78944 100644 --- a/docs/index.md +++ b/docs/index.md @@ -18,8 +18,8 @@ | Doc | What it is | |---|---| -| [message-identity](message-identity.md) / [中文](message-identity.zh-CN.md) | Message identity doctrine: content hash as cross-turn join key, order > hash, msgid rung, snapshot render | -| [session-identity](session-identity.md) / [中文](session-identity.zh-CN.md) | Which session an *anonymous* request belongs to | +| [message-identity](message-identity.md) / [中文](message-identity.zh-CN.md) / [日本語](message-identity.ja.md) | Message identity doctrine: content hash as cross-turn join key, order > hash, msgid rung, snapshot render | +| [session-identity](session-identity.md) / [中文](session-identity.zh-CN.md) / [日本語](session-identity.ja.md) | Which session an *anonymous* request belongs to | | [session-identity-resolution](session-identity-resolution.md) / [中文](session-identity-resolution.zh-CN.md) / [日本語](session-identity-resolution.ja.md) | Which *conversation* a known client session id belongs to (same id, different conversations) | | [identity-channels](identity-channels.md) / [中文](identity-channels.zh-CN.md) / [日本語](identity-channels.ja.md) | Cross-client stable conversation+message id wiring (#5825): who carries identity in, where it is consumed | | [msgid-infrastructure](msgid-infrastructure.md) / [中文](msgid-infrastructure.zh-CN.md) / [日本語](msgid-infrastructure.ja.md) | Where sessionid+msgid is produced, validated (six copies), pinned, and consumed | diff --git a/docs/index.zh-CN.md b/docs/index.zh-CN.md index 3182b2318e..d0bd43db8e 100644 --- a/docs/index.zh-CN.md +++ b/docs/index.zh-CN.md @@ -18,8 +18,8 @@ | 文档 | 说明 | |---|---| -| [message-identity](message-identity.zh-CN.md) / [English](message-identity.md) | 消息身份教义:内容哈希作跨轮 join 键、顺序 > hash、msgid 层、快照渲染 | -| [session-identity](session-identity.zh-CN.md) / [English](session-identity.md) | 匿名请求归属哪个会话 | +| [message-identity](message-identity.zh-CN.md) / [English](message-identity.md) / [日本語](message-identity.ja.md) | 消息身份教义:内容哈希作跨轮 join 键、顺序 > hash、msgid 层、快照渲染 | +| [session-identity](session-identity.zh-CN.md) / [English](session-identity.md) / [日本語](session-identity.ja.md) | 匿名请求归属哪个会话 | | [session-identity-resolution](session-identity-resolution.zh-CN.md) / [English](session-identity-resolution.md) / [日本語](session-identity-resolution.ja.md) | 已知客户端 session id 归属哪个会话(同 id 不同会话的裁决) | | [identity-channels](identity-channels.zh-CN.md) / [English](identity-channels.md) / [日本語](identity-channels.ja.md) | 跨客户端稳定会话/消息 id 接线(#5825):谁带身份进来、在哪里消费 | | [msgid-infrastructure](msgid-infrastructure.zh-CN.md) / [English](msgid-infrastructure.md) / [日本語](msgid-infrastructure.ja.md) | sessionid+msgid 的生产、校验(六份副本)、钉住与消费 | diff --git a/docs/message-identity.ja.md b/docs/message-identity.ja.md new file mode 100644 index 0000000000..281e3c625b --- /dev/null +++ b/docs/message-identity.ja.md @@ -0,0 +1,419 @@ +# メッセージアイデンティティ:コンテンツハッシュをターン跨ぎの join キーとする + +billion-context が個々のメッセージをターン跨ぎでどう識別するのか、そしてなぜ +アイデンティティは受入(ingress)時に割り当ててホストが永続化する id ではなく +メッセージの **content(内容)** から導出されるのか —— その設計記録である。 +#1496 のレビュー後に執筆したもので、`session-identity.md`(同じ問いをセッション +粒度で決着させる文書)の姉妹文書。実装アンカー: +`acp-kernel/src/wire/message-id.ts`(`deriveMessageId`)、 +`acp-kernel/src/refs.ts`(`assignRefs`)、`acp-kernel/src/prune.ts` +(`isCovered`/`baseIdOf`)。#2480 はこの問いを二つに分割した:下の +**kernel ledger(台帳)** は引き続き content-hash である一方、**fold-coverage +re-anchoring レイヤー**(`src/fold-reconcile.ts`)は自己保存正規コピー付きの +位置ベースになった —— 下「fold-coverage レイヤーは位置ベースになる」節を参照; +本ドキュメントの ledger 契約は何も変わっていない。#3641 はさらにその上に判定 +レイヤーを追加した —— **どの**チャネルも検証できなかった場合になにが起きるか — +— 下「snapshot-as-session 教義」節を参照;ledger 契約はそのまま健在。 + +## 問いは id ではなく join キーである + +「受入時にメッセージごとの自動採番 id を割り当てる」のは、このシステムに欠け +ている提案ではない —— kernel が既にやっていることだ。すべての受信メッセージに +セッションスコープ・単調増加・再利用されない台帳から `mNNNNN` ref が付く +(リポジトリ AGENTS.md:*Kernel Contract — message ids are never reused*)。 + +本当の問いは、ターン N+1 でステートレスなホストがその **private** ストレージ +から配列全体を再シリアライズしたとき、台帳を新しい配列に再ピン留めするのに +どのキーを使うか、ということ。位置/順序は本番のエビデンス(下記)によって嘘 +だと証明されている。5 つのホストすべてと 4 つのプロトコル車線すべてで安定して +いる唯一のキーは、メッセージの **content バイト**である: + +``` +wire bytes --sha256--> h_ --byRaw join--> mNNNNN (ledger ref) +``` + +`deriveMessageId` は `role | contentType | toolCallId | toolName | text` を +ハッシュ化し;`assignRefs` は ref を first-wins で付ける(`if (map.byRaw[message.id]) +continue`)。ハッシュは自動採番 id を *置き換える* ものでなく —— id を再結合さ +せる **join** である。 + +## handled ≠ authored ≠ stored + +「全メッセージが我々を通るから id を押印できる、つまり 100% カバレッジ」という +誘惑的な推論は、三つの異なる性質を取り違えている。ホストごとに検証済み: + +| Host | ターンごとに private storage から再シリアライズ | 我々が押印した id は往復できる? | +|---|---|---| +| codex (Responses) | yes(rollout ファイル;environment_context アイテムが回転) | **partially** — response 側アイテムのみ(#242) | +| claude-code (anthropic chat) | yes(session JSONL) | no channel | +| pi (chat, MITM/plugin) | yes(`convertToLlm()` が配列を再構築;メッセージモデルに id フィールドなし) | no channel | +| omp | yes(pi 系プラグイン) | no channel | +| hermes plugin | yes(独自の store、`pre_api_request` フック) | no channel | + +カバレッジは ingress ではなく **re-join ポイント**で測らなければならない。 + +## 車線調査:id はどこに置けるのか? + +| Lane | メッセージレベルの id フィールド | 判定 | +|---|---|---| +| anthropic chat | なし(`tool_use.id`/`tool_use_id` のペアリングキーのみ) | no candidate | +| openai chat | なし(`tool_calls[].id` のみ) | no candidate | +| google | なし(`functionCall`/`functionResponse` のペアリング id のみ) | no candidate | +| responses | `input[].id` が存在する | **provider namespace**:#242 — 我々の 66 文字 id が 64 文字上限を超え毎ターン 400;#1474/#1475 — Copilot は `rs` プレフィックス形状を要求;修復は今や我々の `msg-proxy-*` namespace に限定 | + +4 車線のうち 3 つにはそもそもフィールドがなく、存在する 1 つもローカル発行 id +を本番で 2 回拒否している。ingress は再生された `msg-proxy-*` id を削除する +(`src/loop/adapter-responses.ts:62-68`)—— まさにそれらがアイデンティティで +なくラウンドごとの副産だからである。 + +## msgid エンベロープ:ホスト保証の id が bili 車線を走る(#4491/#4834) + +上記の車線調査は、見えてよりも狭い問いに答えている:それは **model wire** +を調査しているものだ。プラグイン車線は、メッセージ id が実際に存在する第二の +チャネルを加えた —— モデルプロバイダには一切転送されない bili 専用エンブロー +プ: + +- `msgIds` — 増分ターンエンベロープ(`POST /__bili/plugin/turn`; + `src/agent/incremental-client.ts` の `buildBody` で構築)における + `messages` と並走する文字列配列。サーバーは組み立てた body に + `biliMsgIds` として再押印し、パイプラインに再投入する( + `src/incremental-lane.ts`);さらに `src/server/prepare-anthropic.ts` は + リクエストが upstream に向かう前にフィールドを剥がし pin を適用する + (`src/msgid-pin.ts` の `applyMsgIdPin`)。 +- セマンティクス:CLIENT がこれらの id が当該ホストの会話ビューに対して安定 + であることを保証する(dsh/omp/opencode/pi のストレージ id)。有効な id は + `msg_id` として ledger 行にピン留めされ —— クライアントのアイデンティティ + が ledger アイデンティティとなり、それらのメッセージでは content 由来 id を + 置き換える。 +- 全有無(all-or-nothing):長さ不一致、スクリーン失敗、すでに主張済みの id + があれば `msgIds` フィールド**全体**を破棄する(部分的・ずれた配列は絶対に + 許さない);増分車線ではそのターンは content 由来アイデンティティに降格す + る。生存中の正規 id の再利用はサイレントな再紐付けではなく 400。 + `resync: true` はフルセットを一括再主張する。 +- #4834:解決は id 優先(id-FIRST)—— コンテンツを再エンコードするモデル横断 + 書き換え(pi `transformMessages` 系)でももはや id を拒否しない;id が + content の変動より優位になる。ledger の主キーは三段組 + `(session_id, msg_id, content_hash)` のまま —— ハッシュは誤紐付けに対する + 安全帯であり続けるが、有効なクライアント id より上位ではなくなる。 +- #4863:id の主張は計画済みターンが実際にディスパッチされたときだけ取得す + る(claim-after-guard)ため、single-flight ガードに却下されたターンはその + id を消費しなくなった。 + +これで変わらないこと:model wire には依然としてメッセージレベルの id がなく +て、tool-call id はこれまでどおり —— クライアントが返すモデル発行のペアリン +グキーであってアイデンティティではない(#2821 は projection 再構築時に再発行 +する)。proxy-mode の全量再送は依然として下記の順序中心ラダー経由で調整され +る。エンベロープは bili プラグイン車線が存在し、ホストがフルセットを保証でき +るところ에만現れる。 + +## 「original bytes never change」が実際に意味すること + +この主張は方向としては正しく、ただ必須の補足がある:**user/assistant が作成 +したバイトは安定;environment が作成したスロットはその場で回転する。** codex +の `environment_context` は毎ターン書き換えられ;匿名 OpenAI ハーネスはイン +ライン system `messages[0]` を回転させる(#1148);nudge テキストは毎ターン +再注入される(#728)。これが `session-identity.md` が environment をアイデン +ティティの外に置く理由であり、#1148 の修正がアフィニティハッシュから先頭 +system ランを剥がす理由でもある。 + +プレフィックスはアイテムよりもさらに安定しない:ローリングウィンドウ切り捨て +(dsh 系クライアント、20–30 アイテム)、フォークとロールバック再生(#1148, +#1102)、1 メッセージのサイドリクエスト(#1307:`ctx==1` → 163/163 圧縮失敗、 +`ctx>1` → 62/62 成功)、その場での書き換え(#1247)、ホスト側の自己圧縮 +(codex `/compact`、claude-code `/compact`)。 + +## 失敗モードの非対称性:誤帰属 vs 非認識 + +- **位置/順序 join が失敗 → 誤帰属。** ref や圧縮ブロックが *間違った* + メッセージに付く;decompress が誤った内容を返す;自己修復できないサイレン + ト破壊。#1307 の元の ≤2 件数ガードはこの種の順序ヒューリスティックの失敗 + そのものだった。 +- **Content-hash join が失敗 → 非認識。** 会話が新しいセッションに分岐して冷 + たキャッシュを再構築する。自己修復できる性能損失(#286 のフォークセマンテ + イクス)。 + +公理は、安い方の失敗モードで選ばれるべきである。 + +## ホストは会話内で tool-call id をバイト単位で安定させなければならない + +ハッシュは `toolCallId` を因子として含み、fold-reconcile レイヤー +(`src/fold-reconcile.ts`、#1921)はそれを第一の主張キーとして使う: +`tool_use.id` / `tool_call_id` は会話内でプロトコル的に一意であり、かつクライ +アントの再シリアライズを逐字で生き残る唯一のフィールド群である。この前提には +外部依存が一つある —— **ホスト自身**が一つの会話を別プロバイダへ投影する際、 +それらの id を書き換えてはならない。#2396 が実際の違反を発見した:Prime +(pi 系ランタイム)が一つの会話を Codex からカスタム Responses プロバイダへ切 +り替え、その foreign-provider 変換器が保存された複合 id を再サニタイズした — +— `call_switch_seed|fc_0_0` が Codex 車線では `call_switch_seed` とシリアライ +ズされるのに、foreign 車線では `call_switch_seed_fc_0_0` として出ていく、ペア +の両側で。両方の claim pass が id をキーにするため、すべての折畳み tool ペア +がマッチングを止めた:~66,525 input token で課金されていたコンテキストが +558,541/562,549 として 500,000-token ウィンドウに対して再投入された。 + +Bili の対応は上記の失敗モード公理に従う:old→new の対応関係を推測しない +(それは非認識を誤帰属に変える —— 見かけ上妥当な id 入れ替えの下で +decompress が誤った内容を返すことになる)。代わりに形を検出する:カバー済み + id が欠落し、その正規アイデンティティ(toolCallId なし)が異なる toolCallId + を持つ受信側の双子と一致すれば、書き換え疑いとして数えられ drift ログに名指 + しされる(#2396)、そのうえオリジナルは正直に fold 解いたまま wire へ再投入 + される。義務はホストにある —— plugin-protocol.md("Obligations of a plugin"、 + item 5)を参照:ペイロードがプロキシに届く前にホスト境界で id を正規化せよ。 + #2396 の回避策(プロキシ処理前に権威ある保存履歴から `call_id` + + `call_output.call_id` を一緒に書き換える)はその義務の参考実装である。 + +#2480 はこのクラスについて検出だけの姿勢を解消した:欠けていたピースは**ホス +トがバイトがかつて何だったかの知識**であり、fold-coverage レイヤーは今やまさ +にそれを保持する —— 自己保存正規コピー(次節を参照)。位置が対応関係を与え、 +保存されたフィンガープリントがそれを検証するため、ホスト書き換え後の id シー +ム横断での主張はもはや推測ではない。drift ログと正直な再投入フォールバックは +コピーがカバーできないケース(構造的編集、ウィンドウ外の履歴)のために両方残 +る。 + +## fold-coverage レイヤーは位置ベースになる(#2480) + +kernel ledger と fold-coverage re-anchor は異なる問いに答えている: + +- **Ledger join**(ターン N+1、再シリアライズされた配列に `mNNNNN` を再ピン + 留め):content hash、上記すべて通り不変。 +- **Fold-coverage re-anchor**(受信メッセージのうち、私の圧縮ブロックがすで + にカバーしているのはどれか?):`src/fold-reconcile.ts` は今これを**位置+ + 自己保存正規コピー**で答える —— 以前から持っていた toolCallId pass と正規 + content pass よりも手前で。 + +仕組み:各 reconcile pass は `foldPositions` を滾らせる —— 位置ごとの +`role | toolName | canonical text` の `sha256-16`(JSON 形状のテキストはキーソ +ート+コンパクト化、散文は raw バイト保持;`toolCallId` と `contentType` リテ +ラルは除外、それらがまさに codec 横断で再エンコードされるトークンだから; +**reasoning は role 単独でフィンガープリント** —— responses アダプタは +provider アイテム id を core text として投影するので、それをハッシュすると +churn の最初の reasoning メッセージですべてのペアリングが壊れる)。Pass 0 は +churn 領域を head-first と tail-first で整列し、**フィンガープリントが整位列 +合で一致した場合のみ**古いカバー済み id を新しい対応物に主張する;最初の不合 +致でスキャン停止のため、履歴中段への挿入と削除は正直にブリッジを拒む。コピー +を持たないセッション(アップグレード時のインストールベース全体)は何も払わな +い:最初の定常 pass がコピーを保存し、*次の* drift が位置ベースで主張される — +— 「認識不能」自体が新しい数列なので、マイグレーションは無償である。 + +なぜこれが下の位置拒否と矛盾しないか:raw 位置は拒否された —— 旧バイトの記憶 +がないとき、位置ベースの主張は**推測**であり誤帰属として失敗するから。コピー +は推測を、整列オフセットでの検証済み等価変換する —— 同じ公理を一段上で: +フィンガープリント不一致 → 正直な非認識(未マッチ、#1001/#1195 車線)、間違 +った主張は絶対にない。検証マトリクスは `tests/identity-proof.test.ts` にある +(メカニズムレベル、judge 課金、`tests/cache-proof.test.ts` の後): +4 wires × 3 phases(fold 確立 → id シーム+シリアライズ churn でもカバレッジ維 +持 → 履歴中段編集は正直に再投入)、レイヤーなしでは churn が再課金することを +示す reconcile-off 対照、wire 横断クライアント交換(anthropic → chat)で端到端 +カバレッジ維持、およびモデル切替フェーズ(#2636):chat 車線が reasoning を +持つ assistant ターンと image を持つ user ターンを持ち、その後異形状モデル +(reasoning は pair→merged にインライン化、image はプレースホルダ化)へ履歴を +再生 —— カバレッジは形状 churn を生き残り、カバー済み thinking が再投入されな +いこと、churn 直後の最初の body で判定(新しいサーバー側 compress が失敗した +再生を再 fold しうる —— 修復された round-2 は保持証明の代役になってはならな +い)、加えてこの churn クラスがレイヤーなしで再課金することを示す独自の +reconcile-off 対照。 + +## snapshot-as-session 教義:id 上の判定クラス(#3641) + +#2480 は fold coverage を検証付き位置ベースにした。#3641 は**どの**チャネルも +検証できなかった場合になにが起きるかを決着させた。反転:**(session id + fold +スナップショット) が会話本体**であり —— wire はそれの整列観測に過ぎない。 +id・ハッシュ・形状はいずれもヒント;「私のブロックはどのメッセージを、どんな +順序でカバーしているか」が事実である。これを強いた本番クラスが三つ:語りは +そのままに全 id を再発行するプロトコル再シリアライズ(#3640)、テキストナシ +ファミリをプレースホルダへ書き換える image オフロード(#3588)、カバー済み +スライスを切り捨てるステートレスクライアント(#2695)—— 三者ともかつては +"substrate destroyed" と診断されていた。 + +仕組み(すべて `src/fold-reconcile.ts` 内+kernel の配置ルール 1 つ;証明テスト +は `tests/fold-anchor-doctrine.test.ts`): + +- **Shape tier**(順序保持):カバー済み id の*大量*が一度に消えたとき + (≥ `SHAPE_MASS_MIN`)、残存散文アンカーは編集誠実性ゲートの下で会話順に受 + 信候補とペアリングする —— word-bag 等価 + simhash ≤ 8 + role + 長さガード + (sim tier が gap に適用するのと同じゲートを、claim に適用)。テキストナシ + アンカー(image ファミリ:構造上 sh/wh なし)は、両側で検証済み flank に挟ま + れかつバケットごとの件数が厳密に一致する場合に第 k 対第 k でペアリングす + る —— byImage 規律を bili 自身のプレースホルダ変種を超えて一般化したもの。 +- **Residual census と判定クラス**:ラダーが主張できないものは*分類*され、破 + 棄されたとは仮定されない。`shapeExplained`(変換:claim か near-dup の証拠 + が質量を持つ)—— info latch 1 つ、streak リセット。`truncationExplained` + (無害な削除:残存物がどこにも不在、near-dup ゼロ、かつ **wire-continuity + witness** —— 凍結された旧順サフィックスが依然として受信側を先頭に据える) + —— reap ではなく snooze(#2695)。その他すべては drift として従来どおりエ + スケレート。 +- **Episode witness**:最初の drift pass で旧順の tail が凍結される + (`foldEpisodeOrder`);同一 session id 下の外国の会話にはそれとの連続性が + ないため、一括置換が truncation を装えない。 +- **Epoch-confirm ゲート**:全面崩壊は `foldEpochConfirmPending` を latch し、 + エラーを 1 回出し、preflight はリクエストを逐字通過させる —— folding は*一 + 時的停止*;何も削除されず、何もサイレントにリセットされない。整列回復(ホ + ストが真の履歴を再送)で latch は自動クリア。 +- **Unresolved-anchor 配置**(kernel `prune.ts`):アンカーがすべて解決失敗し + たブロックは、tail ではなく最後の user メッセージに挿入される —— サマリー + ブロックがユーザーの最新質問の *後* に乗ることがなくなった(#3640 の + 6 つの tail 乗りブロック)。 + +誠実性の境界は意図的なもの:shape tier は**厳密**な word-bag 等価を要求するた +め、系統的な content 変換 —— 例えばホストが履歴に末尾 `` 接 +尾辞を押印し直す —— は同じメッセージとして*主張されない*(曖昧な content +join は decompress で誤帰属する;下 拒否された代替案を参照)。そのようなイベ +ントは truncation か collapse として分類され、snooze/pause パスに乗る —— 何れ +もサイレントな再キー化はしない。一括同一接尾辞の再押印(N 個の順序安定ペアが +まったく同じ delta を共有)に独自の*検証済み*クラスを設ける価値があるかは未 +解決の follow-up で、本番ログに対して規模を決める(#3640/#3588)。 + +互換性:教義はマッチング/判定レイヤーの変更 —— マイグレーションゼロ、新旧 +セッションに一律適用、ストレージ非依存(legacy JSON、shadow と full モードは +挙動同一;簿記は session metadata に乗る)。kernel ledger の content-hash 契 +約には触れていない。 + +## snapshot render エンジン:出站アイデンティティがサーバー側に移る(#3756) + +#3641 はどのチャネルも検証できないときの判定を分類した。#3756 は出站パスに +おいて依存そのものを除去する:`snapshotRender` rollout 機能をオン(既定 0%、 +`BILI_ROLLOUT_SNAPSHOT_RENDER`)にすると、prepare レイヤーはクライアントの再送 +バイトから履歴を再構築しなくなり —— 出站プレフィックスをサーバー自身の統一 +ストレージ transcript から描画する(`src/server/snapshot-render.ts`): + +- **Identity ladder、最終形。** 会話アイデンティティ = session バインディング + (ネイティブ session id が存在するとき常にそれ —— §"Prefer native stable + identifiers")。ライブ会話内のメッセージアイデンティティ = サーバー + スナップショット行(`seq`)、決して再発行されない。Content + ハッシュ/シグネチャは**チェーンフォールバック証拠としてのみ**降格 —— + クライアントの逐字 tail からサーバー prefix への引き継ぎ点(divergence + point)を特定する(id fast path、`role|contentType|toolName|text` + + image-length シグネチャフォールバック —— #3642 の正規形なので、全 id の再発 + 行でもリンクされる)。 +- **カバレッジはエンジンが自己所有。** カバー済み行はブロックの + seq/signature カバレッジセットで抑制され;`acp_summary_*` アンカーはブロッ + ク状態からその場で再描画される。エンジンはこれに reconcile ラダーの再キー化 + ブロック id を信頼しない —— reconcile は正当にブロックを新規発行クライアン + ト id へ再キー化しうる(16384-anchor cap がその後それらを落とした #3752 の + 正確な失敗形状)。 +- **Tail はクライアント逐字のまま。** join 点より上にあるものはすべてクライ + エントが送ったままバイト単位で転送される —— 折り畳んでいない作業セットはク + ライアント自身の言葉のまま、かつプレフィックスキャッシュ安定性がターン跨 + ぎで保たれる。巻き戻された行は join の下にあり決して描画されない。 +- **Degrade、推測しない。** 機能オフ、アクティブブロックなし、ストレージ不可 + 読、またはチェーンがリンクできない —— そのターン全体が legacy パスへ不変 + にフォールバックする。head のクライアント側チェックポイントは 1 ターン遅れで + 採用される(ビューは前ターンの観測)かつカバー済み行を復活させることは絶対 + にない。 +- 構造的にこれで消滅するもの:#3752 anchor-cap 崖(MAX_ANCHORS × id 再発行 × + ステートレス再送)と #3751 image `_N` ファミリ churn —— いずれも折り畳まれ + た履歴を落としたり重複させたりしなくなった、なぜなら描画プレフィックスは + ブロック seq と content シグネチャに従い、クライアントバイトに従わないから。 + +#3641 の reconcile/判定レイヤーは残る:D がオフ・利用不可・降格している車線 +のための安全網であり続け —— 観測チャネル(`reconcileFoldCoverage`)は依然とし +て CLIENT ビューを見ている(render と観測は意図的に別入力)。 + +## Image はペイロードアドレス指定であり、ファミリー番号ではない(#3751) + +上記の `_N` インスタンス規律は、base id がすでに*これはどの content か*を区 +別していると仮定している。Image は #3751 までその仮定を壊していた:全 image +core が同じ正規テキスト(`[image]`)を持ち、会話内の全 image が 1 つの共有 +base にハッシュされ、`_N` ordinal が位置ベースですべての区別をしていた。1 +枚の image が変わった(オフロードプレースホルダ、再エンコード、削除)だけでそ +の全兄弟の ordinal がずれ、毎ターンファミリー全体が再発行された(#3748 の書 +き込み増幅の供給源)。 + +修正は教義を維持しつつ隙間を閉じる:canonical seed に第 6 スロットが増えるが +media core のみ —— data image は `hash(imageBase64)`(両 codec と content CAS +がすでに保持するバイト)、URL 参照 image は URL 文字列(wire にバイトがない — +— 利用可能な唯一のアイデンティティが URL)、希少な legacy plural-sidecar +core は part フィンガープリントの順序付き結合。バイト同一 image が base id を +共有するのは意図的:`_N` は*真の重複*のための ordinal として残る(#459/#463 +のインスタンス規律、本来設計された対象に適用)。1 枚の image が変わってもいま +は自分の core のみ再発行される。Text core はスロットを得ないので、非 image +id はアップグレード前後でバイト同一のまま。 + +## Hash 公理の既知のコスト —— そしてそれがどう修正されたか + +同じバイト ⇒ 同じアイデンティティにはコスト面がある:#1476 —— ユーザーが折り +畳まれた既存 content と同一の短いテキストを再送;bare `h_` id が再導出; +`isCovered()` が新しいメッセージを飲み込む。修正の**方向**に注意:kernel +#459 はインスタンス番号付け(`_1/_2…`)を追加し、#463 は fold 後の**echo** +(id ∈ covered ∧ ∈ previous pass → id 保持、prune が飲み込む)と真の**新イン +スタンス**(id ∈ covered ∧ ∉ previous pass → 空き `_k` に番号付け直し)を区別 +する `lastPassIds` スナップショットを追加した。Content ハッシュは base のまま; +上に重ねられたのはインスタンス識別のみ。Hash 公理自身のバグすら*hash を維持す +る*ことで修復され、位置ベース id への退却不是なのだ。 + +## 存在するがアイデンティティではない部分往復チャネル + +#242 は両刃のエビデンスである。それは実在する store-and-replay チャネルがあ +ることを証明する(codex は response 側 `msg-proxy-*` id を rollout に永続化し +再生する)。同時にそのチャネルがアイデンティティとして使えないことも証明す +る:カバレッジは response 側アイテムのみ(user 側アイテムは id フィールドを持 +たない)、upstream が namespace を制約する(64 文字上限、`rs` プレフィックス) +かつ 4 車線のうち 1 つにしか存在しない。現在の用途 —— round-2 ライフサイクル +整合性+ingress 剥離 —— が局所最適である。 + +## Tag は派生ビューであり、保存されたアイデンティティではない + +`` tag は**egress**(モデル側向き)で ref map から出力され、**in- +gress** でホスト再生バイトから剥離される;`renderMessage()` は再描画前にその +メッセージ自身の古い tag を除去する(冪等)のに対し、外国 tag は content として +生き残る。アイデンティティは往復に乗らない:同じバイト → 同じハッシュ → +同じ ref → 同じ tag、全 pass で。 + +tag-echo 事故(#206/#295、#14、#673)はこれがこうでなければならない理由の実証 +である。モデルは見える散文の中で描画されたマークアップを模することがある; +ホストはそれらのバイトを逐字保存して再生する;模倣が増幅する(1 つの保存メッ +セージが 77 個の echo tag + ~3,300 行の空行を蓄積 —— #14;タイプミスした tag +名 `acip` が 1 ターンの見える散文全体になった —— #673)。marker-to-storage +チャネルは実在するが**汚れている**:タイプミスし、増幅し、namespace づけが不 +適切。あらゆる marker-as-identity 方式はアイデンティティをそのチャネルに賭け +ることになる。設計は漏洩した marker を剥離可能なノイズとして扱い +(`src/loop/tag-echo-filter.ts`、散文のみ —— tool-call arguments は決して剥が +さない、#1039)、アイデンティティをバイトから再導出する。 + +## Upstream が往復を要求する唯一の場所:strict-echo reasoning + +DeepSeek 系のゲートウェイは、ゲートウェイ自身が出した reasoning アイテムをク +ライアントが返すことを要求する("the reasoning content from the previous turn +must be passed back in thinking mode")。これは艦隊内唯一の強制 content 往復 +であり、bili の扱いはパターンを示す:それは**修復可能な形状制約**として扱われ +アイデンティティではない —— #762 は chat wire に空白 `reasoning_content` を注 +入し、#1479/#1482 は Responses wire と loop リトライパスへの修復を拡張、すべて +`isStrictReasoningEcho`(学習済み 400 フラグまたは deepseek origin/model)で +ゲートされ thinking なしセッションはバイト同一のまま。アイデンティティ簿記は +一切関与しない。 + +## 拒否された代替案 + +| Direction | 拒否理由 | +|---|---| +| ホストストレージが運ぶ ingress 割当 id | 3/4 車線に運搬フィールドなし;4 車線目は provider namespace 拒否(#242、#1475);カバレッジは ingress ではなく re-join で測定(上記のホスト別テーブル)。 | +| 位置/シーケンスを join キーに | プレフィックス不安定性は 6 つの事故クラスにわたって文書化済み(#1148、#1102、#1307、#1247、ホスト `/compact`、我々の fold 自身);失敗モードはサイレント誤帰属。**Ledger join** については依然正しい;#2480 は position を**自己保存正規コピー付き**で fold-coverage レイヤーにのみ採用、位置ごとの検証が推測を取り除く —— 上記参照。 | +| Content への near-match 許容 | バイト完全一致が荷重を支えている(`session-identity.md` と同じ論理);曖昧な join は decompress でサイレントに誤帰属する。 | +| `msg-proxy-*` をアイデンティティに昇格 | 単一車線、response 側カバレッジのみ、増幅しやすいチャネル(tag-echo 証拠)、upstream namespace 制約。 | +| Marker-as-identity(ホストが tag を永続化) | tag-echo 事故はそのチャネルが運ぶものを壊すことを示す;現在の設計は両端ですでに剥離済み。 | +| ホスト書き換え tool-call id の暗黙エイリアシング | 欠けたカバー済み id を、異なる toolCallId で同一 content の受信双子と対応づけるにはホスト知識が必要;なければ主張は推測となり decompress で誤帰属する(#2396:Prime が provider 切替で複合 id を書き換え)。検出のみが出荷;修正はホスト境界に属する(plugin-protocol.md obligation 5)。#2480 更新:Pass 0 がそのホスト知識(位置+保存正規フィンガープリント)を供給するので、このクラスはカウントだけでなく主張される;より早く正規化できるホストには plugin-protocol.md obligation 5 が効力を持つ。 | + +## 将来の方向 + +あの問いはプラグイン車線で今は答えられている:安定 id を保証できるホストはそ +れを送る(#4491 msgid エンベロープ、上記);存在するときそれは ledger +アイデンティティとして order と hash より優位になる(#4834 id-first 解決)— +— content-hash は三段組キーの安全帯であり続ける。id を保証できないホスト(そ +して id を持たない model wire 自身)は content-hash base を維持する。将来のホ +ストや車線が真に安定したクライアント側メッセージ id を提供しても、それは hash +ベース車線において**追加の join ヒントとしてのみ**採用されうる —— LEDGER +join の content-hash base の代替としては決してならない。OUTBOUND join は別問 +題でありすでに答えがある:`snapshotRender` オンでは出站プレフィックスはサー +バー スナップショット `seq` でキー化される(#3756、上記)し、content-hash +ラダーは join 点を特定するチェーンフォールバックとして機能するのみ。総括: +bytes がアンカー、hashes が ledger join、`seq` が render join(rollout +gate)、mNNNNN が ledger、tags が view。 + +関連:#1496(本文書の契機)、`session-identity.md`(セッション粒度)、#1476 + +kernel #459/#463(echo 識別)、#242/#1475(Responses id 制約)、#206/#673 +(tag echo)、#1479/#1482(strict-echo 修復)、#1039(tool-call バイト完全一 +致の不変条件)、#2396(provider 切替でのホスト書き換え tool-call id)、#2480 +(位置ベース fold coverage;`tests/identity-proof.test.ts` がその証明マトリク +ス)、#2695/#3588/#3640/#3641(snapshot-as-session 教義; +`tests/fold-anchor-doctrine.test.ts`)、#3642(正規 cross-protocol +アイデンティティ —— チェーンフォールバックのシグネチャ形)、#3756(snapshot +render エンジン;`tests/snapshot-render.test.ts`)。 diff --git a/docs/session-identity.ja.md b/docs/session-identity.ja.md new file mode 100644 index 0000000000..160974d9cb --- /dev/null +++ b/docs/session-identity.ja.md @@ -0,0 +1,255 @@ +# 匿名リクエストのセッションアイデンティティ + +billion-context が**匿名**リクエスト(`session_id` ヘッダも body フィールドも +なし、`prompt_cache_key` もなし)がどのセッションに属するかをどう決めるのか、 +その設計記録。tail-window reattach の撤去(#1115)と、wire-neutral canonical +projection(#2791)の後に将来参照として執筆。実装:`src/prefix-affinity.ts`、 +`src/affinity-neutral.ts`;挙動テスト:`tests/truncation-fork.test.ts`、 +`tests/prefix-affinity.test.ts`、`tests/affinity-neutral.test.ts`。 + +## 原理:content が唯一の不変アンカーである + +クライアント提供の id は逐字で尊重される。クライアントが回転しうるもの — +credentials、中継、プロトコル変換 — でセッションを分割すると、ユーザーが話し +つづけているまさにその瞬間に状態が孤立する(#286 の教訓)。id をまったく持た +ないリクエストに対しては、メッセージ content が双方が共有する唯一の安定したも +のであり、アフィニティは再生された履歴から純粋に計算される。 + +二つの帰結が従う: + +- **Environment はアイデンティティの外。** system プロンプト、tool 定義、モデ + ル名は決してハッシュに入らない。サマリーは以前の environment の下での過去 + ターンを記述する;environment を含めると、ハーネスがプロンプトを回転させる + (一般的な慣行)全セッションが孤立し、機構自体が台無しになる。 +- **バイト完全一致が荷重を支えている。** kernel 内のメッセージ id は content + ハッシュであり再利用されない。このパスでの near-match 許容は decompress で + サイレントに誤帰属するため、マッチングは常にバイト完全一致。唯一の設計の自 + 由は証拠を探しうる *場所* であり —— *どれだけ* あってはならない。 + +## フルプレフィックス一致 —— 唯一の採用パス + +各追跡チェーンは漸進ハッシュ `h_i = sha256(h_{i-1} || canon(msg_i))` を保存す +る。受信リクエストは、その漸進ハッシュが保存済みチェーンの **head** と最も長 +い厳密プレフィックスで等しいとき一致する(`via: "prefix"`)。これは健全だ: + +- アイデンティティ証拠は位置 0 にアンカーされた共有 head 全体であり —— 別の会 + 話はあなたの実際の冒頭ターンを持たずにあなたの位置 0 を引用できない。 +- 分岐は自己修復する(フォークセマンティクス、#286):クライアントが履歴を編 + 集または分岐させると、次のリクエストは一致を止め新しいセッションを発行する + のに対し、旧チェーンは編集されない系統を継続してサーブする。明示的な無効化 + は不要。 +- 安全性:マッチングにはバイト同一の head を持つことを要求するため、折り畳ま + れた状態は要求者がすでに持っていないものを何もしない。 + +## Tail-window reattach —— 歴史と撤去(#316 → #1072 → #1115) + +### 解決した問題 + +再生履歴を切り捨て(drop-oldest、ローリングウィンドウ)るクライアントは、head +からではもはや一致しない。reattach なしでは最初の切り捨て以降毎ターン新しい +セッションを発行し、圧縮ラダーを構築できない。観察された対象クラス:20–30 +アイテムのローリングウィンドウを保持する dsh 系 web クライアント。 + +### メカニズム(撤去済み) + +リゾルバは受信の先頭 `w = min(8, depth)` 個のアイテムハッシュを、各追跡チェー +ンの**任意の中間オフセット**に対してスライドさせ、連続ヒットがちょうど 1 つな +ら保存済みセッションを採用した(`via: "tail-window"`)。 + +### なぜ構造的に弱かったか + +中間連続一致は**対称証拠**である:それは区別できない + +- 「同じ会話、切り捨てられた再生」(意図ケース)と +- 「共有 content を引用する別の会話」—— テンプレート化 tool 出力、標準ファイル + 内容、定型エラーメッセージ。 + +第二のケースには攻撃者は不要:同じコードベースで働く並列エージェントは中間ス +ライスを自然に同一にする(受動的テンプレート衝突)。そして採用はどちらの方向 +でも有害だった: + +- 採用側の再構築 wire が被害セッションの折り畳みサマリーブロックを受け取る + (会話跨ぎの情報漏洩); +- 採用側の新しいターンが被害セッションへ記録される(真の所有者へのコンテキ + スト汚染)。 + +暫定緩和(#1072)は 3 ではなくフル 8 アイテムウィンドウを要求し、8 未満の作製 +ウィンドウを閉じた —— しかし大きな閾値は対称性を壊さない:任意の 8 個の中間 +連続アイテムを持つだけでは依然十分だった。 + +### 撤去前の測定 + +本デーモンのデプロイで 3 日間の本番ログ(2026-09-19 → 2026-09-22)、匿名解決 +~11.5k 件: + +| Outcome | Count | +|---|---| +| full-prefix match | 9,367 | +| new session | 2,106 | +| fork lineage recorded | 142 | +| **tail-window reattach** | **0** | +| ambiguous multi-candidate tail hit | 0 | + +観測された使用はゼロ —— near-miss もゼロを含む。 + +### 決定:中間チェーン採用を全面的に捨てる(#1115 の方向 3) + +切り捨てられた再生は今や新しいセッションへフォークする(`via: "new"`)。受け +入れたコスト:raw 再送 1 回+ラダー再起動 —— すでに instruction-drift フォー +クが接受しているのと同じコストクラス(#1106)。二つの緩和が損失を区切る: + +- **Opt-in block adoption(#629)** は、ソースメッセージが受信再生に残ってい + る圧縮ブロックを持ち渡る(raw-id SET セマンティクス、prefix 系統ではない)。 +- **Kernel reconciliation は健全のまま**:切り捨てられた再生は影響ブロックを + 優雅に非活性化し、フル再生はそれを復活させる(`tests/truncation-fork.test.ts` + でピン留め)。 + +切り捨てランのスキャンは帰属形態としてのみ生存する:先頭 `TRUNCATION_LINEAGE_ +WINDOW = 8` ランが追跡チェーンの内部(offset ≥ 1)に厳密に含まれる NEW +セッションは `lineage: { reason: "truncated", parents }` を記録;共有先頭プレ +フィックス(LCP ≥ `MIN_FORK_PREFIX = 3`)があれば代わりに +`reason: "forked"` を記録し優先される。Lineage は UI/debug 用にログされて保存 +されるが**マッチングには決して影響しない**。 + +## Wire-neutral canonical projection(#2791) + +### 車線横断の盲点 + +上記の漸進ハッシュは各メッセージの **raw wire JSON** 上で計算されていた。*同 +一会話* の異なるプロトコル上の 2 つのレンダリングは決してバイト等価でない — +— OpenAI wire は tool アクティビティを +`{role:"assistant", content:null, tool_calls:[{function:{name, arguments:"…json string…"}}]}` +と `{role:"tool", tool_call_id, content}` でレンダリングする一方、Anthropic +wire は assistant content ブロック `[{type:"thinking"}, {type:"tool_use", name, +input:{…}}]` と次の user メッセージ内にネストした `tool_result` ブロックでレン +ダリングする。したがって dsh セッションが `api` を切替えたとき +(`openai-completions` → `anthropic-messages`、同じ会話、同じ upstream +モデル)、何も一致せず、新しい匿名セッションを発行し、fold ledger を孤立さ +せ、切替ターンでフル再 fold(~182 s)+ キャッシュリセットを支払っていた — +— サイレントに(#2791)。 + +### Projection + +ハッシングは protocol-neutral projection(`src/affinity-neutral.ts`)上で実行 +されるようになった:各メッセージはハッシュに十分単射でありながら wire の装飾 +を落とす規則の下で `NeutralTurn`(`{kind, text}` か `{kind, calls}`)に正規化 +される: + +- 先頭 system/developer ランを剥離(top-level `system` パラメータは projection + に一切入らなかった); +- text content:文字列 ↔ `[{type:"text"}]` ブロックを連結; +- tool アクティビティ:`tool_calls[].function.arguments`(JSON *文字列*)と + `tool_use[].input`(オブジェクト)の両方を解析済み値へ正規化; + `{role:"tool", tool_call_id}` ↔ user `tool_result` ブロックは合成 + `{kind:"tool"}` ターンになる(複数 `tool_result` の user メッセージは分割); +- tool call を持つ assistant ターンは text を落とす(2 つの wire は thinking + が tool call を伴うかで不一致); +- 連続 assistant メッセージを結合(Anthropic は分割する); +- クライアントの `[model changed: …]` マーカーターンと churn キー + (`cache_control`、id、シグネチャ)を破棄; +- 未知形状はメッセージ全体の raw canonical にフォールバック —— マッチングは + v1 挙動へ降格し、偽一致にはならない。 + +ターンごとの canonical 文字列は `canon({content, role})` —— 素の OpenAI text +メッセージの v1 canonical とバイト同一なので、#2265 の simhash hamming +較正が不変に引き継がれる(モデル再押印変異は採用可能バンド内に留まる;元の +fixture で `coverage ≥ 0.9` を検証済み)。 + +### ストレージとマイグレーション + +`ChainEntry.hv` がドメインを区別する:`hv:2` エントリは neutral per-item +ハッシュと simhash sketch を持ち;アップグレード前の `hv:1` エントリは読み取り +可能かつマッチ可能のまま(raw-wire ドメイン、legacy churn 耐性 tail ハッシュ +込み)なので、アップグレードですべての追跡セッションを再発行しない —— 大量フ +ォークのコストは会話が実際に wire を横断する場所でしか支払われ +ず、それはちょうど以前すでにフォークしていたケースである。Simhash 採用と +lineage ランクはドメインごとに動作(採用は `hv:2` のみ)し、クライアント提供 +の append-only ガードは `hv:1` エントリを無条件に再アンカーする(depth はドメ +イン内でのみ比較可能)。 + +### ライブエビデンス + +新規 dsh セッション、`openai-completions` 車線で 45 KB 知識ファイルを読み取り +(fold 発火:~13.5k token 節約)、その後同じ dsh セッションが +`anthropic-messages` へ切替えて折り畳まれた content を質問:anthropic リクエ +ストは openai 車線セッションに prefix depth 9/11 で一致、新しい匿名セッション +なし、再 fold なし、回答は fold サマリーからサーブ、キャッシュヒット 2 ラウン +ド以内に 97 %。キャプチャとログは #2791 スレッドに。 + +## Snapshot render:session id がメッセージアイデンティティ全体になる(#3756) + +上記の匿名採用ラダーが存在するのは、wire バイトが無認証会話の唯一の記録だか +らだ。バインド id を持つセッション(ホストネイティブ session ヘッダまたは +affinity key)かつ統一ストレージが利用可能なら、#3756 はループを閉じる:OUTBOUND +履歴プレフィックスはその session id でキー化されたサーバー自身の transcript +から描画される(`src/server/snapshot-render.ts`、rollout feature +`snapshotRender`、既定 0%)。描画プレフィックスのメッセージアイデンティティは +サーバー行 `seq` —— content ハッシュはクライアントの逐字 tail がサーバー +prefix に結びつく場所のみを特定するチェーンフォールバック証拠へ降格。クライア +ント編集、ホストチェックポイント、プロトコル切替はいずれも折り畳みカバレッジ +を移動・削除・重複できなくなった、なぜならカバレッジはクライアントがたまたま +再送するものではなくブロックの seq/signature セットから計算されるから。上記の +採用ラダーは機能がオフ、ストレージ不可用、またはチェーンがリンクできない車線 +のためのフォールバックとして残る —— degrade、推測しない。完全な仕組みと誠実性 +境界:`message-identity.md` §"The snapshot render engine"。 + +## 拒否された代替案 + +| Direction | 拒否理由 | +|---|---| +| サフィックスアンカー一致(一致は保存 tail で終わらねばならない) | クライアントがちょうどウィンドウ長(K = 8)を保持する場合のみ機能。文書化されたローリングウィンドウは 20–30 アイテムを保持 —— 支配的な正当ケースが壊れる。 | +| 深度スケーリング証拠(ウィンドウは保存チェーンの ≥ 50% をカバーしなければ) | 固定 8 アイテムウィンドウは 16 アイテムより深いチェーンの半分をカバーできない —— 長い会話を殺す、まさに保ちたいはずのもの。 | +| Kernel 検証採用(kernel 全 id チェーンとの突合) | Kernel id は content ハッシュ:より深い深度へ拡張された同じ対称証拠。精度は上がるが所有証明はなく、匿名ホットパスにセッション lookup を追加する。 | +| Tail アンカー最長ラン+底(dir 1+ 変種) | 健全で機能を保持する。測定使用がゼロだったため*当面*辞退;投機的 surface を出荷するのではなく、クライアント側アイデンティティ信号とともに再検討。 | + +## 三層アイデンティティフレームワーク + +変異下での連続性は三つの独立レイヤーに分解される。真の単位はセッションでなく +BLOCK —— 連続性は構造上部分的: + +1. **Attach** —— リクエストがどの保存チェーンに属するか。証拠はクライアント + が明らかに持っているものから来る;#1115 以降は head アンカーのフルプレフィ + ックス一致のみが有効。 +2. **Block validity** —— ブロックごと、kernel がメッセージ id の PRESENCE(位 + 置ではない)から決定:カバー済みメッセージ欠落 ⇒ ブロック非活性;復帰 ⇒ 復 + 活。「セッションの半分」はこのレイヤーの機械的帰結であってポリシーノブでは + ない。 +3. **Environment** —— system prompt / tools / model はアイデンティティの外(上 + 記原理を参照)。変わった environment は未来のターンを変え、過去サマリーの + 真実を変えるのではない。 + +## 派生(子)セッション:誕生時の系統(#1333、#1362) + +エージェントが子セッションを生んだとき —— 親の会話を再送するのではなく空歴 +史から始める subagent またはフォーク —— その子は以前、親で折り畳まれて消えた +content を `decompress` や `search_context` できなかった。各車線は今や誕生時に +系統を報告する:そのアイデンティティ登録は親の会話 id(`parentConversationId`) +を持ち、プロキシは子セッションに読み取り専用リンク(`derivedFrom`)を記録す +る。それ以降: + +- `decompress` / `search_context` は子が自身で見たことのない content について + 親チェーンに沿ってフォールバックする(resident または on-disk の親、サイクル + ガード付き、depth cap 8); +- 子の状態に何もコピーされず親は決して変更されない —— フォールバックヒットは + 読み取り専用なので、子は親がいまだ所有するものを上書きできない; +- リンク記録時に親がプロキシに知られていなければ、子は単に新しく始まる。 + +| Lane | Parent signal | +|---|---| +| **pi** RLM inline spawn | session ヘッダの `parentSession`(親セッションファイルへのパス、その session id に解決) | +| **omp** fork / newSession | session ヘッダの `parentSession`(裸の session id またはファイルパス —— 両方受理) | +| **OpenCode V1**(ネイティブプラグイン) | SDK session info の `parentID`(セッションごとに一度解決、キャッシュ) | +| **OpenCode V2**(ネイティブプラグイン) | `session.created` イベントの `data.parentID` | + +claude/codex/dsh にはここには何も不要:subagent 間で一つの session id を共有 +するか、子セッションの概念自体がない。 + +## 将来の方向 + +持続的な修正は**クライアント側アイデンティティ信号**である:クライアント自身 +が供給する会話ごとの安定 id。クライアントがそれを提供するまで、バイト完全一 +致の head アンカー一致が安全な床であり、suffix/中間チェーン採用のいかなる再導 +入もまず本文書の脅威モデルに対して正当化されなければならない。 + +関連:#1148(OpenAI インライン `messages[0]` system プロンプトがアイデンティ +ティに焼き込まれ、他のプロトコルと非対称 —— 別 issue)。 From e7d30da8094cdb240388cdf056d0fc8fd9557e15 Mon Sep 17 00:00:00 2001 From: ci-check Date: Tue, 10 Nov 2026 12:17:10 +0800 Subject: [PATCH 07/17] =?UTF-8?q?docs:=20session-identity.ja.md=20?= =?UTF-8?q?=E2=80=94=20keep=20TRUNCATION=5FLINEAGE=5FWINDOW=20code=20span?= =?UTF-8?q?=20on=20one=20line?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The constant was wrapped mid-token across a line break inside its code span; CommonMark renders that newline as a space, so the identifier displayed as 'TRUNCATION_LINEAGE_ WINDOW = 8' instead of 'TRUNCATION_LINEAGE_WINDOW = 8'. Re-wrapped the paragraph; no content change. --- docs/session-identity.ja.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/session-identity.ja.md b/docs/session-identity.ja.md index 160974d9cb..3fe0277a2a 100644 --- a/docs/session-identity.ja.md +++ b/docs/session-identity.ja.md @@ -104,10 +104,10 @@ credentials、中継、プロトコル変換 — でセッションを分割す 優雅に非活性化し、フル再生はそれを復活させる(`tests/truncation-fork.test.ts` でピン留め)。 -切り捨てランのスキャンは帰属形態としてのみ生存する:先頭 `TRUNCATION_LINEAGE_ -WINDOW = 8` ランが追跡チェーンの内部(offset ≥ 1)に厳密に含まれる NEW -セッションは `lineage: { reason: "truncated", parents }` を記録;共有先頭プレ -フィックス(LCP ≥ `MIN_FORK_PREFIX = 3`)があれば代わりに +切り捨てランのスキャンは帰属形態としてのみ生存する:先頭 +`TRUNCATION_LINEAGE_WINDOW = 8` ランが追跡チェーンの内部(offset ≥ 1)に厳密に +含まれる NEW セッションは `lineage: { reason: "truncated", parents }` を記録; +共有先頭プレフィックス(LCP ≥ `MIN_FORK_PREFIX = 3`)があれば代わりに `reason: "forked"` を記録し優先される。Lineage は UI/debug 用にログされて保存 されるが**マッチングには決して影響しない**。 From 084cdeee33fea4f53cfdac979dc124f5c63ac773 Mon Sep 17 00:00:00 2001 From: ci-check Date: Tue, 10 Nov 2026 12:17:10 +0800 Subject: [PATCH 08/17] =?UTF-8?q?docs:=20message-identity.ja.md=20?= =?UTF-8?q?=E2=80=94=20close=20full-width=20bracket=20in=20heading=20?= =?UTF-8?q?=EF=BC=88#3641)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Heading line 215 mixed a full-width opening bracket with an ASCII closing paren; made it (#3641) to match the file's other full-width-bracket headings. --- docs/message-identity.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/message-identity.ja.md b/docs/message-identity.ja.md index 281e3c625b..dc5d50474b 100644 --- a/docs/message-identity.ja.md +++ b/docs/message-identity.ja.md @@ -212,7 +212,7 @@ churn 領域を head-first と tail-first で整列し、**フィンガープリ い)、加えてこの churn クラスがレイヤーなしで再課金することを示す独自の reconcile-off 対照。 -## snapshot-as-session 教義:id 上の判定クラス(#3641) +## snapshot-as-session 教義:id 上の判定クラス(#3641) #2480 は fold coverage を検証付き位置ベースにした。#3641 は**どの**チャネルも 検証できなかった場合になにが起きるかを決着させた。反転:**(session id + fold From 06a1c91fcba1c69a6ea049321b3222e11c990ef3 Mon Sep 17 00:00:00 2001 From: ci-check Date: Tue, 10 Nov 2026 12:45:16 +0800 Subject: [PATCH 09/17] docs: add Japanese version of the docs directory landing page (#6072) Faithful complete mirror of docs/README.md; registers the ja link on the directory-landing row of both index files. --- docs/README.ja.md | 24 ++++++++++++++++++++++++ docs/index.md | 2 +- docs/index.zh-CN.md | 2 +- 3 files changed, 26 insertions(+), 2 deletions(-) create mode 100644 docs/README.ja.md diff --git a/docs/README.ja.md b/docs/README.ja.md new file mode 100644 index 0000000000..e0996d1b0e --- /dev/null +++ b/docs/README.ja.md @@ -0,0 +1,24 @@ +# ドキュメント + +**billion-context** のシステム文書はすべてこのディレクトリに集約されています。リポジトリのルートには 4 つの**コア**入口ファイル——`README.md`、`README.zh-CN.md`、`AGENTS.md`、`CHANGELOG.md`——と、承認済みのコミュニティ維持 README 訳本(`README..md`、例 `README.ja.md`、2026-11-09 に承認、#6000)のみを保持します。旧ルート文書パスはルートに一行的なリダイレクト用プレースホルダを残します(追跡は [lifecycle §5](lifecycle.md#5-卫生记录))。 + +> **全カタログ:** [index.md](index.md) / [index.zh-CN.md](index.zh-CN.md) — 全文書を一行説明付きで一覧。このページはディレクトリの落地ページで、何がどこにあるか、そして何を live に保つかというルールを示します。 + +## セクション + +| セクション | 文書 | 中身 | +|---|---|---| +| **ここから始める** | [configuration](configuration.md) · [clients](clients.md) · [how-it-works](how-it-works.en.svg) | 全量設定リファレンス(生成物、ドリフトガード付き) · クライアント別統合の深掘り · フロー全体を一枚の図で | +| **システムアーキテクチャ** | [architecture](architecture.md) / [中文](architecture.zh-CN.md) | **LIVE hub**: 全体図 + モジュール毎の一ページ(pipeline / lanes / kernel / identity / fastpaths / storage / webui / update)、各々に独自の図を掲載 — 鮮度は CI が強制(`architecture-docs` レーン) | +| **アイデンティティとプロトコル** | [message-identity](message-identity.md) · [session-identity](session-identity.md) · [session-identity-resolution](session-identity-resolution.md) · [identity-channels](identity-channels.md) · [msgid-infrastructure](msgid-infrastructure.md) · [opencode-responses-websocket](opencode-responses-websocket.md) · [plugin-protocol](plugin-protocol.md) | アイデンティティ教義(msg id、session id、persona フォーク、#5825 のチャンネル配線)とクライアント別プロトコル注記 | +| **エンジニアリングと運用** | [technical-notes](technical-notes.md) · [lifecycle](lifecycle.md) · [auto-merge-guardrails](auto-merge-guardrails.md) · [unified-loop-spec](unified-loop-spec.md) | 機構の深掘り · 移行/退役台帳(CI 強制) · `AGENTS.md` §7 裏のエビデンス付録 · 歴史的設計(コードにより置き換え済み) | + +## ルール(このディレクトリが読みやすい状態を保つ理由) + +1. **既定バイリンガル** — 英語ベース名 + `*.zh-CN.md` ミラー;単一言語の文書はその理由を [index](index.md) エントリに明記すること。 +2. **新規または移動した文書はすべて同じ PR で [index.md](index.md) + [index.zh-CN.md](index.zh-CN.md) に記載** — 未記載の文書は存在しないものと同じ。 +3. **アーキテクチャ文書は LIVE** — 構造変更は影響するページ・図・hub 台帳行を同じ PR で更新;機械的な部分は CI レーン `architecture-docs` が強制。 +4. **手順は [`../reference/`](../reference/README.md) に置く** — ここではなく。`docs/` は意思決定/レビューア向けのリファレンス;`reference/` は遅延読み込みの how-to 資料(testing / release / git-pr / env-vars / KDD 全文台帳)を保持。 +5. **移動はスタブを残す** — 旧パスに一行的なリダイレクト + [lifecycle.md](lifecycle.md) §5 に明示的な削除条件付きの衛生台帳エントリ。 + +これらのルールの権威ある文言: [`AGENTS.md` §3 "Documentation Layout"](../AGENTS.md)。 diff --git a/docs/index.md b/docs/index.md index 959be78944..57778331f3 100644 --- a/docs/index.md +++ b/docs/index.md @@ -12,7 +12,7 @@ | [configuration](configuration.md) / [中文](configuration.zh-CN.md) | Full configuration reference (generated from `website/config-reference/*.yaml` by `tools/gen-config-docs.mjs`; hand-written sections are drift-guarded) | | [clients](clients.md) / [中文](clients.zh-CN.md) | Per-client integration deep dives: how each mode (launcher / `/bili/` / native plugin) wires traffic in | | [how-it-works](how-it-works.en.svg) / [中文](how-it-works.zh-CN.svg) | One diagram: request flow + the injected context tools | -| [README](README.md) / [中文](README.zh-CN.md) | Directory landing page: section map + the rules that keep this directory live | +| [README](README.md) / [中文](README.zh-CN.md) / [日本語](README.ja.md) | Directory landing page: section map + the rules that keep this directory live | ## Identity & protocol diff --git a/docs/index.zh-CN.md b/docs/index.zh-CN.md index d0bd43db8e..c3ef60539f 100644 --- a/docs/index.zh-CN.md +++ b/docs/index.zh-CN.md @@ -12,7 +12,7 @@ | [configuration](configuration.zh-CN.md) / [English](configuration.md) | 全量配置参考(由 `website/config-reference/*.yaml` 经 `tools/gen-config-docs.mjs` 生成;手写部分有漂移守卫) | | [clients](clients.zh-CN.md) / [English](clients.md) | 各客户端接入深潜:launcher / `/bili/` / 原生插件三种模式如何接线 | | [how-it-works](how-it-works.zh-CN.svg) / [English](how-it-works.en.svg) | 一张图:请求流转 + 注入的上下文工具 | -| [README](README.zh-CN.md) / [English](README.md) | 目录落地页:分区地图 + 保持本目录不再变乱的规则 | +| [README](README.zh-CN.md) / [English](README.md) / [日本語](README.ja.md) | 目录落地页:分区地图 + 保持本目录不再变乱的规则 | ## 身份与协议 From a264448361e97dddd3bf14f81c3b4b2eac672883 Mon Sep 17 00:00:00 2001 From: ci-check Date: Tue, 10 Nov 2026 13:20:29 +0800 Subject: [PATCH 10/17] =?UTF-8?q?fix:=20message-identity.ja.md=20=E2=80=94?= =?UTF-8?q?=20close=20full-width=20bracket=20in=20'=EF=BC=88rollout=20gate?= =?UTF-8?q?)'=20summary=20line?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/message-identity.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/message-identity.ja.md b/docs/message-identity.ja.md index dc5d50474b..f1615cb17f 100644 --- a/docs/message-identity.ja.md +++ b/docs/message-identity.ja.md @@ -406,7 +406,7 @@ join の content-hash base の代替としては決してならない。OUTBOUND バー スナップショット `seq` でキー化される(#3756、上記)し、content-hash ラダーは join 点を特定するチェーンフォールバックとして機能するのみ。総括: bytes がアンカー、hashes が ledger join、`seq` が render join(rollout -gate)、mNNNNN が ledger、tags が view。 +gate)、mNNNNN が ledger、tags が view。 関連:#1496(本文書の契機)、`session-identity.md`(セッション粒度)、#1476 + kernel #459/#463(echo 識別)、#242/#1475(Responses id 制約)、#206/#673 From be0324b18bb3213fb7de64fed13c7d31f8171467 Mon Sep 17 00:00:00 2001 From: ci-check Date: Tue, 10 Nov 2026 13:20:29 +0800 Subject: [PATCH 11/17] =?UTF-8?q?fix:=20README.ja.md=20=E2=80=94=20use=20s?= =?UTF-8?q?tandard=20Japanese=20term=20=E3=83=A9=E3=83=B3=E3=83=87?= =?UTF-8?q?=E3=82=A3=E3=83=B3=E3=82=B0=E3=83=9A=E3=83=BC=E3=82=B8=20for=20?= =?UTF-8?q?'landing=20page'?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/README.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/README.ja.md b/docs/README.ja.md index e0996d1b0e..89d3ed6221 100644 --- a/docs/README.ja.md +++ b/docs/README.ja.md @@ -2,7 +2,7 @@ **billion-context** のシステム文書はすべてこのディレクトリに集約されています。リポジトリのルートには 4 つの**コア**入口ファイル——`README.md`、`README.zh-CN.md`、`AGENTS.md`、`CHANGELOG.md`——と、承認済みのコミュニティ維持 README 訳本(`README..md`、例 `README.ja.md`、2026-11-09 に承認、#6000)のみを保持します。旧ルート文書パスはルートに一行的なリダイレクト用プレースホルダを残します(追跡は [lifecycle §5](lifecycle.md#5-卫生记录))。 -> **全カタログ:** [index.md](index.md) / [index.zh-CN.md](index.zh-CN.md) — 全文書を一行説明付きで一覧。このページはディレクトリの落地ページで、何がどこにあるか、そして何を live に保つかというルールを示します。 +> **全カタログ:** [index.md](index.md) / [index.zh-CN.md](index.zh-CN.md) — 全文書を一行説明付きで一覧。このページはディレクトリのランディングページで、何がどこにあるか、そして何を live に保つかというルールを示します。 ## セクション From 282adfa29d319cfe3506dd4e5828425f807d6355 Mon Sep 17 00:00:00 2001 From: ci-check Date: Tue, 10 Nov 2026 22:39:06 +0800 Subject: [PATCH 12/17] docs: add Japanese version of clients.md (#6072) --- docs/clients.ja.md | 336 ++++++++++++++++++++++++++++++++++++++++++++ docs/index.md | 2 +- docs/index.zh-CN.md | 2 +- 3 files changed, 338 insertions(+), 2 deletions(-) create mode 100644 docs/clients.ja.md diff --git a/docs/clients.ja.md b/docs/clients.ja.md new file mode 100644 index 0000000000..1723430597 --- /dev/null +++ b/docs/clients.ja.md @@ -0,0 +1,336 @@ +# クライアント統合の深掘り解説 + +[README クイックスタート](../README.md#quickstart) で 1 行では収まらないクライアント向けの、クライアントごとの仕組み:各モード(ランチャー / `/bili/` URL プレフィックス / ネイティブプラグイン)がトラフィックをプロキシへどう配線するか、何がどこに書き込まれるか、そして既知の制約。「どのコマンドを打てばいいか」だけ知りたいなら [README](../README.md) から始めてください — このファイルは、何かが思い通りに動かず、その理由を知りたいときに読むものです。 + +--- + +## dsh (deepseek-harness) + +2 つのレーン、同じプラグイン (#941): + +- **ランチャー:** `bili dsh` は `--patch` オーバーレイ(`~/.dsh-bili/.bili-acp.patch.yml`)を通じて完全なネイティブプラグインを注入します — すべてのプロファイルが bili ツールをネイティブ登録した状態で起動し、モデル要求は `x-bili-plugin` + dsh セッション id を帯びる(プラグインモード)、`/acp` はセッションにバインドされます。dsh のネイティブ自動圧縮は同じパッチ内で無効化されます(ホスト平面的な `compaction-basic` → `auto: false`;web プロファイルのプリセットインスタンスは #3354 のオーバーレイによりロード時に無効化される);手動 `/compact` は非 web プロファイルでは利用可能のままです。同じパッチは組み込み DeepSeek ルートのリトライホワイトリストに `MALFORMED_RESPONSE` も追加するため、ツール呼び出し引数の JSON を壊す 1 回のサンプリング乱れはターンを殺すのではなくリトライされます (#2605)。 +- **プロファイルインストール(ランチャーなし)— 1 レーン (#966):** `bili plugin install dsh` は既存のプロファイルすべてに対して `dsh plugin --profile add billion-context` を実行します — pnpm がパッケージを各プロファイル自身の `node_modules` にインストールし、dsh がバンドルされたパッチレイヤー(`dsh.bundle.patch.yml`)を自動的にマウントします — `bili-native` をマウントして dsh の自動圧縮を無効化するほかに、組み込み DeepSeek ルートのリトライホワイトリストに `MALFORMED_RESPONSE` を追加します (#2605);プロファイル自身の `cordis.patch.yml` はその後で適用されるため、そこに書かれた完全な `retryPolicy` はこれを上書きします。spec は bili 自体のインストール方法を踏襲します (#925):npm 形式のインストールはレジストリ名を渡す、チェックアウト/開発ビルドは絶対パスを渡す(`link:` 依存なので、ローカル作業がライブのまま)。レガシーの管理ブロック(`# bili begin` / `# bili end`、#966 以前のインストールが書いたもの)はインストールと削除の際に取り除かれ — ユーザーのエントリとコメントは残され、空になったファイルにはプレースホルダの `[]` が戻る — まず各プロファイルで一度だけ dsh を実行してプロファイルディレクトリが存在させます。プラグインはロード時に独自のプロキシを spawn します(健康なものがあればそれに取り付き二重化しない;親 pid ウォッチドッグ)、グローバル fetch と Codex Responses WebSocket パッチ(#5838)を通じてモデル API トラフィックを `/bili/` に書き換え、マニフェストのツールをそのまま登録し、ツール準備完了を条件にプラグインモードヘッダをゲートします。WS アップグレードは登録完了を待ち、DSH のセッション/モデルヘッダを帯びる;すべての `response.create` は帰属判定とフォーク準備を待って実行されます。キャッシュされたソケットは identity/model、プラグイン有効化、またはプロキシオリジンの変更後の送信を拒否し、再接続が必要になります(あるいはプロバイダーの SSE フォールバック)。他の WebSocket は触れません。オプトアウト:`BILI_NATIVE_DSH=0`。削除は `bili plugin remove dsh` または `dsh plugin --profile remove billion-context` — どちらも同じチャネルを経ます。レジストリからのインストールは `dsh.bundle.patch.yml` を含む公開リリースが必要です;npm 形式を使ってください — GitHub ソースアドレスだと `dist/` なしのソースがインストールされるため(エントリポイントが宙吊りになり dsh はバンドルを黙ってスキップする;代わりにインストール時のガードが明白に失敗する、#2471)。add の直後に `billion-context/dsh` で `ERR_MODULE_NOT_FOUND` が起きて dsh がブートできない場合、プロファイルが古いパッケージメタデータキャッシュからバンドル前のコピーを解決しています (#953) — pin 指定で再追加してください:`dsh plugin --profile add billion-context@latest`。 +- **Codex WebSocket レグ (#5838):** 埋め込まれた pi-ai の `openai-codex` プロバイダーはデフォルトが `transport: auto` で、直接の WebSocket 交換を優先します — 成功した WS ラウンドトリップは決して fetch を呼びません。したがって WS レーンの修正より前に出荷されたビルドでは、そうしたモデル要求が見えることが決してありません:ACP ツールは 404 で応答し、コンテキスト上限まで何も圧縮されません。そのようなビルドでは、DSH の既存の設定 `providers.openai-codex.transport` を `sse` に設定してください(ホット設定;新しい bili 設定キーは不要)するとトラフィックが fetch レグに乗ります;修正リリース以降は WebSocket レグが自動的にインターセプトされてヘッダが押印されます。 +- **境界 — サードパーティの Codex トランスポート:** 自分自身の Codex WebSocket クライアントを組み込むプラグインは、構造上 bili のインターセプトを回避します。2026-11-08 に実在で発見された例:`connectionMode: websocket` の `dsh-codex-subscription` は `ws` パッケージを直接 import し、ホストごとに `globalThis.WebSocket` を Proxy に差し替えるため、モデルフレームはグローバル fetch/WS パッチを通ることが決してなく — プロキシ可視性がなく、ACP ツールは 404 に応答し、ネイティブ圧縮が抑制されているため圧縮パスがまったく存在しません(#5838 の第 2 の原因)。プラグインが CONNECT プロキシエージェントが不要なときに環境の `globalThis.WebSocket` をそのまま通すようになるまで、`connectionMode: sse`(プラグインのデフォルト)を使ってください;host 所有のプロファイルバンドル内部のモジュールスコープの `ws` import を bili がインターセプトすることはできません。 +- **デスクトップアプリ(Electron ホスト):** 同じプラグインは deepseek-harness の**デスクトップ**アプリ内でも動作し、そのアプリ内プラグインマネージャを通じてインストールされます。そこでブートストラップはアプリプロセスの内側からプロキシを spawn しますが、その `process.execPath` は Node ではなく Electron バイナリであり、GUI の PATH には通常のインストール場所が含まれていません — `resolveNodeRuntime` (#819/#1429) はまずよく知られた場所を探索します(`/opt/homebrew/bin`、`/usr/local/bin`、Volta など)し、アプリ自身のバイナリをプレーンな Node として実行すること(`ELECTRON_RUN_AS_NODE=1`、子プロセス環境に強制)にフォールバックするため、PATH に独立した Node がなくてもゼロ設定で圧縮が動作します;特定の Node を強制するには `BILLION_CONTEXT_NODE` を設定してください(両方に優先)。#1429 以前はこのパスは spawn 前に例外を投げ、すべてのセッションが直接送信(非圧縮)に黙って退化しており、bili.log でしか見えませんでした。 +- **自動更新がプロファイルをロックステップに保つ:** リフレッシュには 2 つのトリガーがあります — グローバル自己更新のあと、および**プロファイルコピー自身のプロキシ**から(その定期チェックが新しいレジストリバージョンを見つけたとき;つまりグローバルの bili を走らせない dsh プラグインマーケットユーザーでもリフレッシュされる、#1196)。どちらも `~/.dsh/profiles/*/package.json` をスキャンし、レジストリに pin された `billion-context` 依存を目標バージョンまで引き上げます(グローバルトリガーなら新しいグローバルバージョン、セルフトリガーならレジストリ最新)— いずれも必ず dsh 自身の `plugin add` チャネルを通じて — いつものインプレースコピーではなく — そのためロードされたプラグインとプロキシが再び乖離することがありません (#953);ローカルソースに pin されたプロファイルは触られません。リフレッシュはベストエフォートで、失敗すれば次のサイクルで再試行し、更新やプロキシを失敗させることはありません。 + - **報告済み:profile インストール下で一部のトランスポートにプロキシトラフィックがゼロ (#1158、調査中):** dsh の `llm-pi-ai` レイヤートランスポートの一部によって提供されるセッションでは、モデル要求がプロキシに到達したことが**ない**(`processTurn` のログなし;bili ツールは「no model request has arrived」で 404)一方、同じホスト内の他のプロバイダーは正常に動作します。根本原因はまだランタイム証拠で絞り込まれており — 候補:トランスポートレベルの fetch の形(SDK 注入 fetch / グローバルでないディスパッチャ)か、引き継ぎゲートがトラフィックを未主張のままにするホスト側の帰属ギャップ — 検出方法:プロキシが一時的な `[plugin] NO MODEL REQUESTS seen for conversation …` 警告をログに出し、dsh プラグインが帰属ゲートがプロキシせず通過させた各異なるエンドポイントをログに出します(プロセスごとに 1 回)。当面の確実な回避策:代わりに `bili dsh` 経由で起動する — ランチャーの設定オーバーレイがそうしたプロバイダーの `baseURL` を `/bili/` URL に書き換えるため、トランスポートがどの fetch を使おうと、帰属状態がどうあれ、トラフィックはプロキシに到達します。 + - **web プロファイルの圧縮 (#1772、#3354 で解決):** プロファイルのバンドルに `@deepseek-ai/dsh-web-app` が含まれる場合、稼働中の `compaction-basic` インスタンスはエージェントのプリセット(`preset-standard.config.plugins`)の中にあります。いかなるパッチレイヤーもそのネストされた行を id で指定できません — dsh のパッチエンジンはトップレベルの行と真のグループ子しか索引しない — ため、バンドルの `auto: false` は web-app のすでに無効化されているホスト平面の行に着地して何も変わりません。#3354 以降、bili はこのギャップを**ロード時**に埋めます:常時有効なバンドルエントリ `bili-compaction-gate` — `bili-native` と並ぶ別の cordis エントリで、同じパッチレイヤー群にマウントされるため、`bili-native` が無効化またはキルスイッチされたときも生き残る (#3662) — これは cordis の `internal/config` オーバーレイ(deshark42/dsh-compaction-basic-disable から vendored、MIT)を登録し、bili がレーンを所有している間プリセットの `compaction-basic` と `command-compact` 行を `disabled: true` にマークします。またバンドルパッチのプリセットゲート行により、各 web プリセットはそのオーバーレイのサービスが登録されるまで待つようになります。これらのプロファイルでもネイティブ自動圧縮は OFF です(`/compact` もそこで利用できない — これは**期待どおり**でありバグではありません (#4002):bili がレーン上で圧縮を所有するため、プリセットの compact コマンドとその自動圧縮は両方とも意図的に退いている;設計上再有効化スイッチはありません (#3651/#3666)、configuration.md を参照);ACP 圧縮には影響しません。#4147 以降、オーバーレイは**構造的に**マッチします — 解決後の `config.plugins` が `compaction-basic`/`command-compact` 行をネストしているあらゆるエントリがそれらを無効化され、カスタムやプロファイルローカルのプリセットもファクトリのものと全く同じように扱われます(`dsh.bundle.patch.yml` の 4 つのゲート行 id はファクトリ名簿のための順序保険であり、カバレッジの境界ではありません — 他のプリセット id を出荷するプロファイルは構造的な走査でカバーされます)。一時的な `[dsh-client]` ブート注記はオーバーレイが書き換えた実際のエントリ名を明示します (#3962) ため、名前が変わった名簿でのパッチ行の取りこぼしもホストローダのログを読まなくても見えます。オーバーレイは dsh の**内部**フックに乗っておりバージョンに敏感です — 新しい/古い dsh ビルドで dsh の圧縮チェックポイントが届くのがまだ見える場合は、#2474 の手順にフォールバックしてください:プロファイルレベルのパッチ(あなたのプロファイルの `cordis.patch.yml`、全バンドル後に適用)が id で preset-standard を上書きし、**フルスナップショット**の `config` を与えます — `dsh --profile --dump-config` から完全なプリセット設定をコピーし、その `compaction-basic` 行の下に `config.auto: false` を加え、結果を `cordis.patch.yml` に追記します。設定の置換は**丸ごと**です:部分スニペットだと再言及されていないものはすべて黙って落ちます — プリセット自身の `id`/`order` identity(名簿に認識されなくなる可能性がある)も含み — また同じ id の `- insert:` はマージするのではなく第 2 の死んだ行を追加します。スナップショットは dsh のプリセット更新後に再コピーされるまで名簿を凍結します。そのようなプロファイルではプラグインは一時的な `[dsh-client]` 注記をブート時にログ出し、両方のパスを明示します。 + - **プラグインの無効化 vs 削除 (#3662):** #3662 以前、`bili-native` を無効化すると(dsh プラグインマネージャ、または任意のパッチレイヤーでの `disabled: true`)、ゲートサービスの唯一の提供元が消えながらプリセット行はそれを待ち続けていました — 4 つの web プリセットすべてが永遠に pending のままとなり、すべての新規/再開セッションが `Unknown agent preset: standard` で失敗しました。サービスは現在、別の常時有効な `bili-compaction-gate` エントリに移っています:`bili-native` を無効化またはキルスイッチ(`BILLION_CONTEXT_PLUGIN=0`)しても、レーンは**純正 dsh の挙動**に戻ります — プリセットは正常にブートしネイティブ自動圧縮が復帰し、単に圧縮がオフになるだけです。**`bili-compaction-gate` 自身は無効化しないでください** — それ brick が再現されます。完全にアンインストールするには、プロファイルの `dsh.profile.bundles` から `billion-context`(とその依存)を削除して再起動してください:パッチレイヤー全体が消え、`compaction-basic` は純正の `auto: true` に戻ります。すでにプラグインが無効化済みの #3662 以前バージョンで固まっている場合、アップグレードで自己修復します(パッチレイヤーは bundles に載っているパッケージからマウントされるため、`bili-native` の状態に関係なく);手動の brick 解除は HOME レイヤのパッチ `$DSH_HOME/cordis.patch.yml`(`DSH_HOME` が未設定なら `~/.dsh/cordis.patch.yml`)に 4 行を追記することです — `- id: preset-standard` / `preset-ptc` / `preset-minimal` / `preset-cordis`、それぞれ `inject: null` を付けて。トップレベルのキーは丸ごと置換され、pending ラッチがクリアされます。 + - **グローバルコピーがロード時にプロファイルコピーを影にする (#2891):** dsh は `dsh.profile.bundles` 中の裸の `billion-context` 名をインストールアンカー優先で解決します — プロファイルの `node_modules` よりも自分のインストールツリー(グローバル npm ルート)から先に。つまりマシン全体の `billion-context` がプロファイルローカル版と併存する場合、dsh は**グローバル**コピーを読み、プロファイル側のは黙って無視されます — クラッシュもログエントリもない。両者が異なると、プロファイルが宣言したものとは異なるビルドが動いている可能性があります(例:#1590 以前グローバルには `dsh.client` web フェースがないため、設定ページのメニューが消えただけ)。これはデフォルトですべての場所で目に見えません:`bili doctor` はプロファイルごとに乖離したグローバル-vs-プロファイルペアをフラグ付けします (#2891);dsh が実際に何を読み込んだかは `dsh --profile --dump-config` で確認できます(バンドルの `name:` 行を読む)。 + +`bili dsh` 起動下では、プラグインはランチャーのプロキシに**取り付きます**(第 2 の spawn はなし)。生のアップストリーム URL は spawn モードと同様に `/bili/` に書き換えられます(ループバックのプロキシ目标是決してプロキシされないため、MITM 環境変数は単純にバイパスされる);すでにルーティング済みの `/bili/` プレフィックス付き要求はヘッダ押印を除いてそのまま通過します。既知の制約:手動 `/compact` には dsh 側のイベントフックがないため、その境界はカーネルの自然な ingest diff に委ねられます(自動圧縮はどこでもオフになっています — ホスト平面はバンドルパッチ経由、web プロファイルのプリセットは #3354 のロード時オーバーレイ経由;上記の web プロファイル注記を参照)。 + +**ホスト側のコンテキストメーターは設計上、モデルの視点と乖離します (#2837):** プラグインモードでは、ホストの永続セッションログは意図的にロスレスのままです — 完全な展開済み履歴はプレフィックスキャッシュと厳密エコーのために再送されます(technical-notes.md、「Two compression modes」)。そのためホストやそのプラグインがそのローカルログから計算するめったなメーターは、次の要求が実際に運ぶものではなく**展開済みのローカル表面**を測ります — 圧縮が有効な間にローカル値が実入力よりはるかに高いのは**期待どおり**であり、詰まった圧縮器ではありません。実効サイズはプロキシのものです:ローカルで再導出するのではなく `/acp`(または `GET /__bili/plugin/status` → `contextTokens`、出所は `contextTokensSource`)を読んでください。 + +**dsh クライアントはこのために Context タブを同梱します (#3862):** ネイティブプラグインは dsh の会話ビューにセッションスコープの `Context` タブを登録します(Chat/Trajectory の右)。dsh web アプリからクロスオリジンで `GET /__bili/plugin/status` を読み、`/acp` パネルがライブで計算するのと同じ内訳を描画します:ウィンドウ上限に対する圧縮後送信総量、カテゴリ別セグメント(system+tools / tools / text / code / summaries)、独自のラベル付きスケールでの請求グレードの billing アンカー、そして回収トークンを伴う最近の fold/switch イベント。10 秒ごとに更新されます;稼働中のプロキシがこのビルドより古い場合、タブは推測する代わりに再起動通知 + Web UI 開くボタンの表示に退化します。dsh 自身のランタイムからのプレーン React — iframe なし、追加依存なし。 + +## Kimi Code(Moonshot) + +整列した 3 つのモード:`bili kimi`(ランチャー、cert-MITM — README クイックスタート Option 2)、`/bili/` URL プレフィックス、ネイティブプラグインモード(`bili plugin install kimi`、#963)。Kimi Code v2 のプラグインシステムは宣言型のみです(`kimi.plugin.json`:MCP サーバー、フック、スキル — プロセス内 JS 実行なし)ので、bili は pi/opencode/dsh でやっているようにクライアントの fetch スタックをパッチできません。代わりにプラグインはクライアントの周りで仕事をこなす小さな node スクリプトを 2 つ同梱します: + +- **インストール:** `bili plugin install kimi` は `$KIMI_CODE_HOME/plugins/managed/billion-context/kimi.plugin.json` を書き、stdio MCP サーバー(`node /dist/kimi/native-mcp.js`)と `SessionStart` フック(`node /dist/kimi/bootstrap-hook.js`、タイムアウト 30 秒)を宣言し、プラグインを `$KIMI_CODE_HOME/plugins/installed.json` に登録します。インストーラは `kimi --version` ≥ 2.0.0 を要求し、それ未満では拒否します(ランチャーはどちらでも動作します)。削除は `bili plugin remove kimi`(管理ディレクトリ + レジストリ記録 + 設定の復元)。 +- **セッションごとのブートストラップ:** kimi は各セッションについて MCP サーバーを直接の子プロセスとして spawn します;起動時に健康なプロキシ(`BILLION_CONTEXT_PROXY`)に取り付いたり、エフェメラルポートで独自のものを spawn したりしてから、`~/.kimi-code/config.toml` 内の冪等な行サージカルな管理ブロックでクライアントのルーティングを書き換えます:自身のプロバイダー `[providers.bili]`(`base_url = http://127.0.0.1:/bili/`、アクティブなプロバイダーの `oauth` / `api_key` 参照をそのまま複製)、`[models.bili-kimi]` エイリアス、そして前の値をブロック内に記録したトップレベルの `default_model` リダイレクト。元のファイルは一度だけ `config.toml.bili-bak` にスナップショットされます;すべての書き込みは mkdir ロックファイル下で行われ、ブロック外のユーザー内容は決して触られません。Kimi の設定ホットリロードが変更をライブセッションに適用します。`SessionStart` フックは同じブートストラップを機会的に実行します(attach のみ — spawn は絶対にしない);その非ブロッキングな競合は設計上許容されます:ラウンド 1 が direct/wire モードに乗ってもよく、不変条件は `base_url` を死んだポートに向けないことです。 +- **プラグインモード押印:** ブロックに `custom_headers = { x-bili-plugin = "kimi" }` が加わるのは、ACP ツールリストが生きたプロキシのマニフェストと照合されて検証された**あと**だけです — それまではトラフィックは wire モードに乗ります。`custom_headers` はプロバイダーごとに静的なので、モデル切り替えで古くなることなく要求ごとのウィンドウ/モデルヘッダを運ぶことはできず;そのためランタイム情報の報告はブートストラップ時のみ行われます(存在する限りクライアント自身設定から model + context window + max output)。 +- **ウォッチドッグとライフサイクル:** MCP 子プロセスは 30 秒ごとにプロキシをプローブします。attach モードでは永遠に待ちます(ユーザー所有のプロキシには決して触れない);spawn モードでは死んだプロキシは再起動され、ルーティングは新しいオリジンに書き換えられます。復旧に失敗すると、管理ブロックは削除され、トラフィックは死んだポートに当たるのではなく直接アップストリームへ退化します。セッションが終わると、kimi は MCP 子プロセスを kill し、親 pid ウォッチドッグが spawn したプロキシを解体します。並行する複数の TUI は最初に spawn されたプロキシを共有します;それが消えると残りのセッションは自動的に再起動して再ルーティングします。 +- **既知の制約:** サブエージェントの会話は自分自身の派生プロキシセッションを得ます(kimi は安定したセッション id を公開しない;ツール呼び出しは呼び出しごとの `conversation_id` 引数でバインドされる)、そして kimi のネイティブ自動圧縮は押し出されません — ACP 圧縮はランチャーモードと同様に単に先に発火します。オプトアウト:`BILI_NATIVE_KIMI=0`。 +- **モデル/プロバイダー切り替えでプロキシを外れる (#2954):** ルーティングがカバーするのはブートストラップ時にエイリアス化されたデフォルトモデル(`bili-kimi`)**のみ**です。他のモデルやサードパーティプロバイダーへの `/model` 切り替えは、後のセッションが再びエイリアスでブートストラップするまで bili を完全にバイパスします — 圧縮も統計もなし。単一エイリアス設計の意図的な爆発半径トレードオフ (#963):プロキシが死んでも影響を受けるのはエイリアス化されたモデルだけで、他のすべてのモデルはそのまま直接動作し続ける;完全なマルチプロバイダー引き継ぎならすべてのユーザー所有 `[providers.*]` base_url をその場で書き換え、「マーカー外ユーザー内容に触れない」管理ブロックの不変条件を破る。エイリアス自体はソースモデルの `capabilities` / `support_efforts` / `default_effort` をそのまま継承します (#2954)、そして config.toml のすべての `[models.*]` ウィンドウは spawn 時にプロキシに届く(`BILI_LAUNCHER_MODEL_WINDOWS`)ため、通過するものの要求ごとのウィンドウ解決は正確さを保ちます。 + +## Hermes(Nous Research) + +整列した 3 つのモード:`bili hermes`(ランチャー、cert-MITM — README クイックスタート Option 2)、`/bili/` URL プレフィックス、ネイティブプラグインモード(`bili plugin install hermes`、#958)。hermes CLI エージェントのプラグイン API は Python のみです(`desktop/plugin.js` SDK は別物の Desktop アプリのもの)ので、ネイティブプラグインは npm パッケージの中に同梱される小さな純標準ライブラリの Python モジュールです: + +- **インストール:** `bili plugin install hermes` は `plugin.yaml` + `__init__.py` を `~/.hermes/plugins/billion-context/` にコピーし、グローバルの bili インストール(`dist/index.js` + node パス)を指すマシン所有の `bili.json` サイドカーを書いて、hermes 自身のチャネルを通じてプラグインを有効にします(`hermes plugins enable billion-context` — CLI が PATH にない場合は同じコマンドが表示される代わりに)。新しい hermes セッションを開始すると有効になります。削除は `bili plugin remove hermes`;グローバル更新後は `bili plugin update hermes` でリフレッシュします。インストールまたはリフレッシュされたプラグインは**新しい** hermes セッションでのみ有効になります — 注入コードはホストプロセスに住むため、稼働中のセッションは再起動まで古いコピーを保ったままです(まだ稼働している古いプロキシは通常の stale バナーとして表示されます、README の Self-update を参照)。 +- **ライフサイクル:** ロード時にプラグインは健康な稼働中プロキシに取り付きます — #2905 以降レーン認識:まず自分の hermes レーンインスタンス、他の宣言レーンのインスタンスは**決して**ない(オプトインするには `native.attachLanePriority` に列挙)、8787 ユーザーゾーンデーモンを最後のフォールバックとして — またはエフェメラルポートで独自のものを spawn します(`lane: hermes` を宣言するため他のレーンはそれに乗れない;hermes が終了すると親 pid ウォッチドッグが解体;並行起動はランチャーが使っているのと同じ starting-marker プロトコルで仲裁)。プロキシが健康だと確認できて初めて、`HTTPS_PROXY` / `https_proxy` + `SSL_CERT_FILE`(bili の結合 CA バンドル — 現在の hermes はそこで環境の信頼を解決する;古いビルド向けに `HERMES_CA_BUNDLE` も設定されたまま)を通じて hermes の httpx スタックをそこに向けます — `~/.hermes/config.yaml` は決して触れません。プロバイダーの https ホストは hermes の設定から読み MITM にホワイトリスト化されます;それ以外はすべてランチャーモードと同様にブラインドトンネル化されます。健康なプロキシを作れなければ、プラグインは黙って退き、トラフィックは直接いきます(圧縮も死んだポートもない)。 +- **プラグインモード押印:** `llm_request` ミドルウェアは `x-bili-plugin: hermes` + 会話 id(= hermes セッション id なのでゲートウェイのマルチセッションが安全)+ model を押印し、判明したら `x-bili-plugin-max-output` を押印し、ホスト自身のモデルごとのウィンドウが判明していれば `x-bili-plugin-context-window` も押印します(`HERMES_HOME/context_length_cache.yaml` から読み、キーは `@`;曖昧なエントリは推測しない、#3261)— ただしすべては ACP ツールが生きたプロキシのマニフェストに対して登録された**あと**のみ;ラウンド 1 は wire モードに乗ります。`pre_api_request` フックは実効的な `max_tokens` を捕獲し、ランタイム情報(model + max output + context window)をプロキシにプッシュします。`compress` / `decompress` / `acp_status` は既存のプロキシのプラグインエンドポイントによって提供される真の hermes ツールとして登録されます。 +- **セッション内コマンド (#3697):** プラグインは `/acp` と `/acp-cache` を hermes の `PluginContext.register_command` 経由で登録するため、組み込みのものと同様にスラッシュコマンドのヘルプ/補完に表示されます。`/acp` はこのセッションの ACP ステータスパネルをプロキシからそのまま描画します(ヘッダにバージョン + ビルド);ホストが現在のセッション名を指定できない場合、最近アクティブだったものにフォールバックし、それを最初の行で明示します。`/acp-cache` は `acp_cache` ツールと同じキャッシュレポートを表示します。これは hermes 自身の `hermes acp` CLI サブコマンド(ACP クライアントのエントリポイント)とは**別物**です — 別物で無関係な機能。コマンド登録にはホストに `register_command` が必要(2026.9.x ビルドに存在);古いビルドでは 2 つのコマンドだけがスキップされつつツールは動き続けます。 +- **既知の制約:** hermes の Codex ワイヤートランスポートから出る要求は要求ごとのヘッダ表面を落とす可能性があるため、そうしたセットアップはそのトランスポートがヘッダを公開するまで wire モードのままです。`BILLION_CONTEXT_PROXY` が設定されているとき(ランチャーがプロキシ所有)または `BILI_PROVIDER_REWRITES` が定義されているときは無効。オプトアウト:`BILI_NATIVE_HERMES=0`。 + +## ZCode(Z.ai / bigmodel コーディングプラン) + +整列した 3 つのモード:`/bili/` URL プレフィックス、GUI の Settings → Network(HTTP プロキシ + ルート CA パス)を通じた cert-MITM、ネイティブプラグインモード(`bili plugin install zcode`、#1145)。ZCode のエクステンション表面は Claude-Code 形状ですが宣言型です:`~/.zcode/cli/config.json` のユーザーレベルフックと stdio MCP サーバー、プロセス内 JS シームなし。そのためネイティブレーンはクライアントの周りで仕事をこなす小さな node スクリプトを 2 つ同梱します: + +- **インストール:** `bili plugin install zcode` は `~/.zcode/cli/config.json` を書き、`hooks.enabled = true` を設定し、`SessionStart` プロセスフック(`node /dist/zcode/bootstrap-hook.js`)を追加し、stdio MCP サーバー `mcp.servers.bili`(`node /dist/zcode/mcp-entry.js`)を登録します。既存のユーザー所有 `mcp.servers.bili` エントリは決して上書きされません — インストーラは代わりに明白に拒否します。インストール時に URL は凍結されません;ルーティングはセッションごとに行われます。削除は `bili plugin remove zcode`(bili のエントリのみを取り除き、自分が有効にしたものなら `hooks.enabled` を戻し、スナップショットからプロバイダーストアを復元)。 +- **削除後のオープンセッション (#2155):** `bili plugin remove zcode` はすでに開かれたクライアントウィンドウの中までは到達できません — その MCP 子プロセスは消えたが、プロキシ側のバインド(セッションメタデータ)は生き残っています。そのようなゾンビセッションは、プラグインヘッダなし・ワイヤ上に bili ツールなし・圧縮なしの nudge 付きラウンドが 5 回連続したあとに検出されます:セッションは**proxy モードへの退化**によって自己修復します — ACP ツールは wire 側に再注入され、プロキシが再び圧縮を所有する(nudge は残る)。wire 注入が利用不可(`compress.injectTool=false`)の場合、nudge は圧縮削減が再開するまで代わりに抑制されます。戻ってきたプラグインヘッダ(クライアント再起動 / 再インストール)は最初の要求でプラグインモードを回復します。削除コマンドは直近 10 分間にライブセッションが見られたら注記を表示します;web UI はそうしたセッションにバッジ(「heal」)を付けます。 +- **セッションごとのブートストラップ:** 各 ZCode セッションは MCP 子プロセスを直接のプロセスとして spawn します;起動時に健康なプロキシ(`BILLION_CONTEXT_PROXY`)に取り付いたり、エフェメラルポートで独自のものを spawn したりしてから、mkdir ロックファイル下で冪等な JSON サージェリーによりアクティブなプロバイダーストアを書き換えます:ルーティング可能な各プロバイダーストアエントリの `baseURL` が `http://127.0.0.1:/bili/` になる(自分で設定した任意の baseURL はラッパーの後ろにそのまま保持)。両方のストア世代に対応します:レガシー `~/.zcode/v2/config.json`(`provider..options.baseURL`)と v3.14+ のパーソナルストア `~/.zcode/v2/provider_config.json`(`config.providerConfigRules.providerRules[].config.api.baseUrl`)— 両方が存在するなら新しいストアが優先(どのエントリがルーティングされ、どれがスキップされるかは Routing scope を参照)。元のファイルはユーザー編集ごとに一度だけ `.bili-bak` にスナップショットされます(スナップショットは常にあなたの最後の実際の状態を反映し、決して bili 自身の書き込みを反映しない);他のすべてのキーはバイト単位で同一。レガシー世代のクライアントは起動時にプロバイダ設定を読み込むため、インストール後に ZCode を一度再起動してください;新しいビルドはセッション中にルーティング変更を取得します(約 1 秒ポーリング)。`SessionStart` フックは同じブートストラップを機会的に実行します(attach のみ — spawn は絶対にしない);その非ブロッキングな競合は設計上許容されます:ラウンド 1 が wire モードに乗ってもよく、不変条件は `baseURL` を死んだポートに向けないことです。 +- **プラグインモード押印:** MCP 子プロセスが ACP ツールリストを生きたプロキシのマニフェストと照合して検証したら、ルーティングされたエントリに `headers["x-bili-plugin"] = "zcode"` が加わります — それまではトラフィックは wire モードに乗ります。ツール呼び出しは呼び出しごとの `conversation_id` 引数でバインドされます (#760)。 +- **何がきれいになり、何が決して触られない(統合 ACP 不変条件):** モデル散文では bili のレンダリングタグエコー / マーカー行 / 退化残渣が通過時に除去され得ます;**thinking チャネル**(anthropic `thinking`、google `thought`、openai `reasoning_content`/`reasoning`、responses reasoning summaries)、**ツール呼び出し引数**(モデルが書いたファイル内容)、**ユーザーメッセージ**はバイト単位で触れられません。 +- **ルーティング範囲 (#1622):** ネイティブモードは利用可能な http(s) `baseURL` を持つ**すべての**プロバイダーストアエントリをラップします — プロセス内ネイティブ(pi/dsh)と同じ「全プロバイダーが圧縮に乗る」セマンティクス — bigmodel コーディングプランアカウントだけに限りません。ラップできないエントリは黙って落とされるのではなく、ログ付き理由でスキップされます: + - **クライアント署名アカウント (#1621):** v3.14+ のパーソナルストアではコーディングプランアカウントはそのまま direct(既知の制約を参照);他のすべてのプロバイダーは引き続きルーティングされる。 + - **ループバック対象 (#809):** http ループバック `baseURL`(localhost / 127.x.x.x / ::1)は決して再プロキシされない — ラップすると bili が自分自身や自分のローカル中継の上に積み重なる。 + - **`direct` 免除:** `providers` テーブル(アップストリーム URL をキー — configuration.md を参照)で `"direct": true` を宣言するプロバイダールートは direct に留まる;どのレーンでも尊重できる同じ免除。 + レーンはセルフマネージドポートゾーンでプロキシを起動します (#1660):ゾーンベース `18787`、過去に +1 ラダーでドリフトしても自動的に追従するレーンごとのスティッキー記録、衝突は子プロセスの +1 ラダーで解決、ドリフト時は共有ストアが生きたオリジンに書き換えられる — ハンドオフがなくてもラッパーはセッション再起動を生き残る。`BILI_ZCODE_PORT` は代わりに正確なポートを pin する(strict-port:居座りは明白に拒否、hop なし)。`BILI_ZCODE_ROUTE`(`plans`/`none`)は互換エスケープハッチ、`BILI_ZCODE_SIGNING_FIXED=1` は ZCode ビルドが署名修正を出した時点で #1621 のスキップをオフにする。 +- **ウォッチドッグとライフサイクル:** MCP 子プロセスは 30 秒ごとにプロキシをプローブします。attach モードでは永遠に待ちます(ユーザー所有のプロキシには決して触れない);spawn モードでは死んだプロキシは再起動され、ルーティングは新しいオリジンに書き換えられます。復旧に失敗すると、管理書き換えは削除され、トラフィックは死んだポートに当たるのではなく直接アップストリームへ退化します。セッションが終わると、ZCode は MCP 子プロセスを kill し、親 pid ウォッチドッグが spawn したプロキシを解体します;MCP 子プロセスが終了する前(SIGTERM/SIGINT/正常終了)にロックの下で引き継ぎを行います — 共有プロバイダーストアがまだ自分のプロキシを指している場合、別のライブな互換インスタンスに向け直すか、存在しなければ direct に戻して管理書き換えを削除する (#1623) そのため、死んだインスタンスが共有設定に死んだポートを残しません。ウォッチドッグは毎ティック共有ストアもチェックします:別のインスタンスによる死んだポートが残っている場合(ハンドオフが実行されないハードキルのケース — 例:Windows の TerminateProcess は JS ハンドラーをスキップ)は修復を引き受けます(ライブインスタンス優先、なければ direct に復帰);ストアが死んだポートを指している間のみ行動し、ライブインスタンスからルーティングを奪わない。並行セッションは最初に spawn されたプロキシを共有します;それが消えると残りのセッションは自動的に再起動して再ルーティングします。境界:ZCode はセッションごとにプロバイダの baseURL をキャッシュするため、上記の修復は**新規読み取り**(新しいセッション/クエリ)でのみ効力を発揮します — 進行中のセッションは再読み取りまでキャッシュされた古いポートのリトライを続けます。これを構造的に避けるには、`BILLION_CONTEXT_PROXY` を常駐プロキシ(`bili start`)に pin し、すべてのセッションがそこに attach させます(attach モードはユーザー所有プロキシには触れない)。 +- **既知の制約:** ZCode の不正防止フィンガープリンティング (#661) は `zcode.z.ai` ログイントラフィックの MITM 再構築ボディに適用されます — ネイティブモードはその表面には触れません(モデルトラフィックは GUI プロキシではなくプロバイダーストアを通る);GUI-proxy/MITM セットアップも走らせるなら、`"mitm://zcode.z.ai": { "passthrough": true }` ルートを保ってください。v3.14+ ビルドでは、コーディングプランアカウントの ClientRequestSigningV4 はモデル作成時に非 HTTPS オリジンを拒否し、ハンドシェークパスをオリジンのみから導出する(`/bili/` プレフィックスを落とす)ため、`/bili/` ラップの baseURL は「Client signing handshake requires HTTPS.」で失敗します (#1621)。競合は ZCode 側でハードコードされているため、ネイティブモードは v3.14+ のストア世代を検出し、書き換えをまったくスキップします — 理由をログに出してトラフィックを direct にしておく;これらのアカウントで圧縮するには ZCode が署名修正を出すまで GUI cert-MITM セットアップを使う;出たら `BILI_ZCODE_SIGNING_FIXED=1` を設定すればまたルーティングされる。デフォルトの `route:"all"` ではそうしたアカウントのみがスキップされ — ストアの他のすべてのプロバイダーは引き続きルーティングされる;ストア全体の退化(ルーティングを完全にオフ)は現在 `route:"plans"` の下でのみ適用され、そこでは plan アカウントこそが署名アカウントです。Pre-3.14 レガシーストアのクライアントには影響なし。`BILLION_CONTEXT_PROXY` が設定されているとき(attach モードがプロキシ所有)または `BILI_PROVIDER_REWRITES` が定義されているときは無効。オプトアウト:`BILI_NATIVE_ZCODE=0`。 + +## Codex(OpenAI Codex CLI) + +**一時的なカタログ障害 (#3993)。** Bili を経由してルーティングされる認証付き `GET https://chatgpt.com/backend-api/codex/models` 要求に対して、最後に有効だった完全なカタログがトランスポート失敗と HTTP 500/502/503/504 をカバーできます。これにより、一時的なディスカバリー失敗が Codex の既知のコンテキスト/ツール機能を捨て去ることを防ぎます。プライベートキャッシュは既存の XDG キャッシュディレクトリ配下(`codex-model-catalog-v1`)にあります;完全な URL/クライアントバージョンと credential/account/org/project のフィンガープリントで分離され、生 credential を含まず、カタログごとに 1 MiB・16 エントリ・6 時間に制限されます。オンラインディスカバリーは常に優先されます;オフラインヒットは経過時間を延長しません。利用可能なキャッシュがある場合、ネットワーク/ボディの期限は 4 秒です。呼び出し側のキャンセル、401/403、他の明示的なエラー、無効/空のカタログはキャッシュされた成功になりません。コールド、期限切れ、credential が変わった要求は依然として成功したディスカバリーが必要です。オフライン再生はアップストリームサーキットをクリアせず、推論の到達可能性を証明しません。推論ペイロード、圧縮モード、設定されたコンテキスト上限はいずれも変更されません。 + +**ウィンドウ整合。** クライアントが報告するプラグイン/ランタイムウィンドウとランチャーウィンドウは、バンドルされた Codex モデルテーブルより優先されます。報告がない場合、ローカルプロキシは `CODEX_HOME`(デフォルト `~/.codex`)配下の `models_cache.json` とベースの `config.toml` を読み、`model_context_window` は該当モデルの `max_context_window` で上限が決まり、その後 `effective_context_window_percent`(Codex のデフォルトは 95)で減算されます。キャッシュの変更は後の要求で取得されます。欠落、読み取り不能、無効なメタデータはバンドルテーブルとその既存の 272K 不明モデル上限にフォールバックします。リモートプロキシや別クライアントプロファイルの場合は、クライアントのウィンドウを既存のランチャー/ランタイム報告メカニズムで渡すか、既存の `compress.modelContextLimit` を設定してください;プロキシのローカルキャッシュは別マシンの設定の証拠にはなりません。出力ヘッドルームは依然適用されます。 + +Codex は、プラグインインストールだけでは自己完結できない唯一のクライアントです。シーム行列がその理由を説明します:claude には `SessionStart` フック + 管理設定ブロックがあり、zcode には書き換え可能な `baseURL` を持つプロバイダーストアがある — codex はどちらもありません。そのモデルトラフィックは環境変数のみでルーティングされます(`HTTPS_PROXY` / `SSL_CERT_FILE` — これが `bili codex` の仕組み);デフォルトの ChatGPT ログインプロバイダーには設定ファイルのルーティングシームがなく、管理 `model_providers` ブロックは `env_key` API キー認証を強制し **サブスクリプションログインを落としてしまう**。MCP サーバーは親プロセスに環境を注入できないため、プラグインは codex 自身のトラフィックをルーティングできません。3 つの態勢: + +| 態勢 | 得られるもの | +|---|---| +| `bili codex`(ランチャー) | フル・ゼロ設定:セルフマネージドのレーンプロキシ(#1660 ゾーン、スティッキーポート)+ codex に注入される cert-MITM 環境変数 — ツール*と*圧縮の両方 | +| `bili plugin install codex` + 稼働中の bili + 自分でエクスポートした `HTTPS_PROXY` | 自分自身で環境を管理するパワーユーザー向けにツール+圧縮 | +| `bili plugin install codex` のみ | 4 つのツールは codex に現れるが、プロキシされる会話がないので作用対象がない;何も到達できない場合 `tools/list` は -32003 で失敗する(`bili proxy unreachable … — start bili or set BILI_MCP_PROXY`) | + +**並行セッション (#3203)。** 複数の `bili codex` 起動が同じプロジェクトディレクトリで同じ `CODEX_HOME` を使って同時に動いてもよい:各起動は自分自身のセッションごとのオーバーリースロット(`-bili-s`、プール 16)と自分自身のレーンプロキシを取るため、ルーティング、MCP 会話バインド、圧縮状態はセッション間で決して交わりません。共有状態デフォルト(codex ≥ 0.147.0)では、両セッションの履歴は実 home の**1 つの**ライブ状態 DB に着地し、いかなる終了順序でも生き残ります — configuration.md の `BILI_CODEX_STATE_MODE` を参照。古いバイナリ、または `BILI_CODEX_STATE_MODE=legacy` は home ごとに排他的なオーバーレイを 1 つ保ちます:第 2 の並行起動は `BILI_OVERLAY_BUSY` で拒否されます。 + +インストールは単一の `[mcp_servers.bili]` ブロックを `~/.codex/config.toml` に書き込みます(command = node、args = dist/mcp.js)。#1660 はインストール時のオリジンの焼き込みを削除しました(#403:焼き込まれた URL はドリフト/再起動後に古くなり、ツールを死んだポートに向けたままにした);シェルはセッション開始時にプロキシを解決します — 環境 `BILI_MCP_PROXY` > ライブインスタンス記録(どのレーンのプロキシでもよい、または `bili start` デーモン)> 8787 ユーザーゾーンデフォルト — ためドリフトした再起動したプロキシは死んだ URL を取り残すことがなく、シェルは単に生きているものに attach します。セッションバインドはヘッドレスです:ランチャーは spawn 時に `BILI_CONVERSATION_ID` を渡し、それ以外ではプラグインシェルが次の NEW セッションをバインドします;呼び出しごとの `conversation_id` 上書きはどこでも機能します (#760)。Codex ≥0.160 はさらに `_meta.threadId` を通じてすべての `tools/call` に実際のスレッド id を押印します;シェルは呼び出しごとにそれを消費します(厳密に検証され、spawn 時バインドへ書き戻されることはない)、そしてそれは古い `BILI_CONVERSATION_ID` 残骸とモデル転記の `conversation_id` の両方に優先します (#2024)。 + +**Responses ネイティブチェイニング(注意点)。** bili は完全な `input` を再生して圧縮するため、OpenAI のネイティブ `previous_response_id` チェイニングに従えません:delta のみの継続は、200 を返しながらも以前のターンをアップストリームで失います。今日は codex では非問題です — 観察されたビルドは `store:false` を送り、`previous_response_id` を決して設定しません(観察であり証明ではない;E2E はその形状をカバーしない)。ネイティブチェイニング Responses クライアントを bili に向ける場合は、完全な input/output 履歴を再送するか `ACP_KEEP_RESPONSE_ID=1` を設定してください;bili が空でない `previous_response_id` を除去すると、今は `warn` をログに出します (#1954)。完全なチェイニング対応は #1973 で追跡されています。[公式マイグレーションガイド](https://developers.openai.com/api/docs/guides/migrate-to-responses) を参照。 + +### 実行モード:`bili codex` は embedded を固定する (#1867) + +約 0.156 以降、Codex はマシン全体の共有バックグラウンドサーバーに attach(または自動起動)でき、そのモデルトラフィックはセッション開始時ではなく**デーモン起動時に**存在した環境を使います。ランチャーのプロキシはセッションスコープ(そのポートはプロセスと共に死ぬ)なので、長寿命デーモンが安全にそれを経由してルーティングできません:codex が先に bili の環境なしで起動すると、後の `bili codex` セッションは黙ってそこに attach して圧縮を完全にバイパスする;bili が先に起動すると、生き残ったデーモンは死んだポートを指し続ける。そのためランチャーは明示的に `--no-daemon` を渡します — フラグのために `codex --help` をプローブしてから(古いバイナリは無変更で起動)、ユーザーがすでにモードを pin していないときのみ(`--no-daemon` または `--remote`)。結果:決定的な embedded 実行、起動ごとのフォールバック警告なし、黙ったバイパスなし。#321 の予算 `-c` 引数はそのまま保持されます(embedded モードは同様に尊重する)。共有バックグラウンドサーバーが欲しいならネイティブ `codex` を直接実行してください — 圧縮はないが、ツールは `bili plugin install codex` 経由で引き続き動作する。 + +### Windows 起動パス:ユーザー argv は二度と cmd.exe に戻らない (#2196) + +Windows ではデフォルトの npm インストールが PATH に `codex.cmd` シムを置き、その `%*` 転送はすべてのユーザー引数を cmd.exe の LINE パーサを通じて再パースします — そこにはエスケープ機構がありません:埋め込まれた二重引用符がトークンを分割する(`Please say "hello world" exactly` は 4 つの引数として届く)、`%VAR%` は展開され、`&|<>^()` はコマンド演算子として働き、空引数は消える。空白区切りのプレーンプランプトは生存していたため、#679 のスペース截断修正がそれを露呈させませんでした。#2196 はランチャーがユーザー argv をそのパーサに与えることを拒否するようにします: + +- **解決順序(win32 のみ):** 各 PATH ディレクトリ内ではネイティブ `codex.exe` が `codex.cmd`/`codex.bat` に優先する(最も早いディレクトリが全体で依然優先);`.cmd`/`.bat` ヒットは信頼できる npm レイアウトの隣にある場合に `node ` に格上げされる — package.json が `@openai/codex` と名付けられ解決可能な `"codex"` bin エントリを持つ `/node_modules/@openai/codex`、かつそのパッケージを参照するシムテキスト(無関係なツリーの隣に置かれた手書き `codex.cmd` は起動をハイジャックしてはならない)。Node 上で公式ラッパーを実行するとシムが行うこと(ベンダーバイナリ探索、環境初期化、シグナル転送)を正確に再現しつつ、Node 自身の CreateProcess argv エンコーディングが各引数をそのまま運ぶ。認識できないレイアウト(yarn-classic の `.bin` ツリー、ローカルリンクなし pnpm ストアシムなど)は以下の契約の下でレガシー cmd パスを保つ。 +- **パススルー契約:** 残りの cmd ラップ起動 — いかなるクライアントの `.cmd`/`.bat`/拡張子なしバイナリ、および dsh チャネル spawn — は行パーサがそのまま運べる argv のみを受理する。それ以外(埋め込み引用符、`%VAR%`、メタ文字、空引数、改行、奇妙な末尾バックスラッシュ連続)は、破損して届いたり意図しないコマンドを実行したりするのではなく、プロセス開始*前*に実行可能なエラーで明白に失敗する。直接 spawn の `.exe` 起動には影響ない:Node はそれらの argv を自らロスレスにエンコードする。 +- **回避策 / パワーユーザー用ノブ:** `BILI_CLIENT_BIN=` は依然すべてに優先する — 実際の `codex.exe`(または node 下で実行されるスクリプトエントリ)に向ければシムを完全にバイパスできる。 + +windows-latest CI で実際のグローバル `@openai/codex` インストールに対して検証済み(`tests/win-cmd-argv.test.ts`、`ci-windows-codex.yml` のハードゲート):完全なコーパス — 空引数、プレーンなスペース、埋め込み引用符、TOML `-c` 値、JSON、Unicode、末尾バックスラッシュ、`%COMSPEC%`、`!VAR!`、`&|<>^()` — が呼び出し側配列と項目ごとに同一のまま子プロセスに届く。 + +### Composer 予測(Codex Desktop):カスタムプロバイダーのスレッドは対象外 (#3408) + +Codex Desktop の Composer 予測機能には、予測要求が billion-context に到達し得る**前**に走る**クライアント側の資格ゲート**があります:再開されたソーススレッドの*実際の*プロバイダーをチェックし、組み込み `openai` プロバイダーを要求します — 他のプロバイダーは `unsupported_provider` を選び、クライアントは予測を生成せずに帰る(Desktop 26.1013.3656.0 の静的検査、#3408)。ゲートは*グローバルデフォルト*ではなく*スレッドの*プロバイダーを読む:予測パスはソーススレッドを特別な予測モードでフォークし、その呼び出しは独立した予測プロバイダーを供給しないため、グローバルデフォルトを変更しても既存スレッドの資格は再付与されない。結果: + +- **カスタムプロバイダーのスレッドは予測を表示しない** — クライアントの設計によるもので、bili の欠陥ではない。予測要求は決してプロキシに届かないので、bili 側に修正や設定すべきものはなく;予測に対するゲートウェイトラフィックの不在は期待どおりであり、要求が落ちた証拠ではない。 +- **プロバイダーを保つトランスポートは機械的に資格を保持する。** cert-MITM ルーティング(`bili codex` ランチャーが注入する `HTTPS_PROXY` + `SSL_CERT_FILE`)はプロバイダー層の下でインターセプトする:codex 自身の設定とプロバイダー選択は触れられないため、スレッドは組み込み `openai` プロバイダー identity と公式 ChatGPT 認証を保つ — ゲートが読むのはまさにそれ。Desktop ビルドでのランタイム確認は未だ pending(マッチした A/B なし);このトランスポート下で Desktop の予測を確認または否定できるなら #3408 に報告してください。 +- **カスタムプロバイダーのスレッドで予測を回復するサポートされた設定はない。** カスタム `model_providers` エントリを通るあらゆるルート — API キー認証、サードパーティのワンクリックインストールを含む — は構造上ゲートの対象外側に位置する(そうしたエントリは上記のようにサブスクリプションログインも落とす)。カスタムプロバイダーを `openai` に偽装するリネーム、やクライアントの資格チェックのパッチはサポートされず、回避策として文書化されない。 + +経験則:予測が必要なら組み込み OpenAI プロバイダー経路にとどまる;カスタムプロバイダーが必要なら、そうしたスレッドに予測が表示されないことを受け入れる。 + +## Gemini ファミリー(Gemini CLI / iFlow CLI / Qwen Code / Antigravity) + +gemini-cli アーキテクチャファミリーのための 4 つのランチャー (#1043 tier 1)。4 つのうち 3 つに base-URL 環境フックがある;1 つにはない: + +- **`bili gemini`** — Gemini CLI (`@google/gemini-cli`)。`GOOGLE_GEMINI_BASE_URL=/bili/` を設定する(デフォルトアップストリーム `https://generativelanguage.googleapis.com`;自分で `GOOGLE_GEMINI_BASE_URL` をエクスポートするなら、その値が代わりにプロキシ経由で中継される)。クライアントは `gateway` 認証モードに切り替わり、Google ネイティブワイヤ要求をループバックプロキシに直接送る — MITM なし、CA インストールなし、`~/.gemini` は決して触れない。プロキシはこのワイヤをネイティブで話す(モデル名は URL パスに乗る)。制約:ヘッドレス `-p` 実行は保存済みの認証選択が必要(例:settings の `security.auth.selectedType = "gemini-api-key"` + `GEMINI_API_KEY`)— gemini-cli は非対話モードで純粋に環境由来の gateway 認証を拒否するため;OAuth 個人ログイン(CodeAssist)ユーザーはこのルートでまったくカバーされない — そのパスは base-URL フックを無視する。 +- **`bili iflow`** — iFlow CLI (`@iflow-ai/iflow-cli`)。`IFLOW_BASE_URL` 経由で同じパターン(デフォルト `https://apis.iflow.cn/v1`、設定したら中継);OpenAI chat-completions ワイヤ。 +- **`bili qwen`** — Qwen Code (`QwenLM/qwen-code`)。このフォークは base-URL フックを落とした(`DASHSCOPE_PROXY_BASE_URL` はヘッダ調整ノブであってルーティングではない)が、標準プロキシ環境変数は尊重するので、ランチャーは cert-MITM を使う:`HTTPS_PROXY=` + `NODE_EXTRA_CA_CERTS=`、デフォルトモデルホスト(DashScope / Qwen ゲートウェイ / よくあるサードパーティエンドポイント)の静的ホワイトリスト付き。カスタム中継ホスト:`--mitm-domain ` で追加。ベストエフォートルート — ログの `BLIND TUNNEL WARNING` はホストがホワイトリストから漏れていることを意味する。 +- **`bili antigravity`** — Google Antigravity (#2115)。ランチャーは公式 CLI バイナリ **`agy`** を駆動する(Gemini CLI の後継で、2026-06 に廃止;`PATH` または `~/.local/bin/agy`、Windows `%LOCALAPPDATA%\agy\bin` にある)。そのモデルチャネルはクローズドソースの Go `language_server` の中にあり、**文書化されていない** `CLOUD_CODE_URL` 環境上書きを尊重する(v2.19.1 バイナリで確認:*"Overriding CloudCodeServerURL via CLOUD_CODE_URL environment variable"*)— gemini-cli の base-URL フックと同じ形状。ランチャーは `CLOUD_CODE_URL=/bili/` を設定する(デフォルトアップストリーム `https://daily-cloudcode-pa.googleapis.com` — Antigravity の実際のデフォルト;裸の `cloudcode-pa` ホストは `/v1internal:*` で 400 になる、#3129;自分で `CLOUD_CODE_URL` をエクスポートするなら、その値が代わりにプロキシ経由で中継される)。MITM なし、CA インストールなし。プロキシは**パスで**ワイヤを認識する:`:streamGenerateContent` / `:generateContent` / `:countTokens` 要求は Google ネイティブアダプタにルーティングされ `bili gemini` と同様に圧縮される。サーバーが代わりに gRPC メソッドパス(`/google.internal.cloud.code.v1internal.CloudCode/*`)を使う場合、そうした要求は認識されずそのまま圧縮なしで中継される — グレースフルな退化で、確認次第レーンごとの `protocol` 宣言 (#1909) で修正可能。Google がいつか環境フックを削除した場合のフォールバック:cert-MITM — language_server は `HTTPS_PROXY` を尊重し証明書ピン留めをしないので、`daily-cloudcode-pa.googleapis.com`(Antigravity の実際のデフォルトエンドポイント;裸の `cloudcode-pa` 名は `/v1internal:*` で 400 になる、#3129)を `"mitm".domains` に追加し、bili のルート CA を信頼する。デスクトップアプリと IDE エクステンションはこの同じ language_server チャネルを共有する;ランチャーは具体的には CLI を駆動する — デスクトップユーザーは `CLOUD_CODE_URL` を手動でエクスポートするか、MITM レシピを使える。 + +4 つのいずれにもネイティブモードはない:どれもループ内ツール注入シームを公開しない(gemini-cli のエクステンションはカスタムコマンドにしか到達できない;フォークはその表面を継承;Antigravity はユーザープラグインシステムを同梱する — `plugins//` に `plugin.json`、`hooks.json`、`mcp_config.json`、`skills/`、JS サイドカー — がすべての表面は追加型のみ:ツール、プロンプト、UI、イベントコールバック。その中の何ものもモデル要求/応答ストリームをインターセプトしたり書き換えたりできず、それはクローズドな language_server の内部に完全に留まるため、ワイヤのみ統合が v1 の天井)。設計上ランチャーのみ。 + +## Pi(pi.dev コーディングエージェント) + +Pi は完全なネイティブモード(`bili plugin install pi`、README クイックスタートのオプション 1)を持つ;このセクションは一行テーブルでは伝えきれないことを扱う — **ネイティブインターセプトが実際にカバーするモデルトランスポート**。DSH も Codex Responses WebSocket をインターセプトする (#5838);そのホスト固有のライフサイクルは上記に説明がある。 + +**サブエージェント設定 (#2230)。** 組み込み `acp_delegate` 表面(3 つのデリゲートツール、ロール、フリートインスペクタ — `bili pi` が埋め込みエクステンションを通じて配線する)は bili 自身の設定ファイル、`~/.config/billion-context/billion-context.json` の `pi.subagents` セクションで設定される(ブール短縮形 `"pi": {"subagents": false}` で無効化)。4 つの `~/.pi/acp.json` キー(`delegate` / `delegatePrompt` / `displayUsage` / `debug`)は非推奨フォールバック — セクションが存在しない間のみ読み、存在すれば無視。完全なフィールドテーブルと `PI_ACP_DELEGATE_*` 環境上書き:configuration.md → [`pi`](configuration.md#pi)。 + +**ルーティングの仕組み。** pi エクステンションは自分自身のプロキシをブートストラップ(または attach し)、プロセス内で `globalThis.fetch` をパッチする:すべてのモデル API HTTP 要求は `/bili/` に書き換えられ、エクステンションは pi の `before_provider_headers` イベントを通じて `x-bili-plugin*` ヘッダを押印する。すべての HTTP ベースプロバイダー(Anthropic、OpenAI chat/completions/responses、Gemini、Mistral、OpenRouter、Azure、カスタム中継…)は名前付きプラグインモードセッションとしてこのパスに乗る。 + +**pi-claude-bridge と一緒に:圧縮状態は reopen/resume を生き残らない (#3429)。** pi-claude-bridge は **pi セッション開始ごとに新しい Claude Code サブプロセスを spawn し**、そのサブプロセスはすべてのモデル要求に自分自身の `x-claude-code-session-id` を押印する — pi の安定した会話 id はこの HTTP に決して乗らない。bili は見た id(ここでは `x-claude-code-session-id`)をそのままキーにするので、reopen/resume/fork の後、ブリッジの新しい CC id は空の会話にマッピングされる:折りたたまれた履歴と圧縮の集計は引き継がれず、pi id 宛のランチャー/ネイティブ `compress` は 404(未知のプラグイン会話)を返す — 一つの根本機構であり、二つの bug ではない。これはブリッジ側の identity ギャップであり、bili の欠陥ではない:内容は決して失われ壊れることはなく、圧縮の*状態*だけがリセットされる。適切な修正は pi-claude-bridge に属する(pi 会話 id から CC セッション id を安定して導出する);それまで、コンテキスト管理のために pi+claude-bridge をプレーンプロキシモードとして扱え。 + +**WebSocket カバレッジ (#2073、#2111 で実装)。** WebSocket 接続は決して `globalThis.fetch` を通らないため、ネイティブエクステンションはロード時に `globalThis.WebSocket` もラップする — pi の最初のモデル接続より前に(pi の Node ブランチは呼び出しごとにグローバルを読む;Bun ブランチは初回呼び出しでサブクラスをキャッシュする、これが両ランタイムでインストール時の順序が安全な理由)。サポートされた Codex Responses モデル接続のみが書き換えられる — 他のすべての WebSocket(devtools、サードパーティライブラリ、すでにルーティングされた URL)は無変更で通過する: + +| プロバイダー / トランスポート | 状態 | +|---|---| +| すべての HTTP プロバイダー | ✅ カバー — 名前付きプラグインモードセッション | +| `openai-codex-responses`(ChatGPT backend-api)、`transport: "sse"` | ✅ カバー — いかなる HTTP プロバイダーとも同一 | +| `openai-codex-responses`、`transport: "auto"`(デフォルト)または `"websocket"` / `"websocket-cached"` | ✅ カバー (#2111) — コンストラクタ URL が `/bili/` に書き換えられる(例:`wss://chatgpt.com/backend-api/codex/responses` → `ws://127.0.0.1:/bili/https://chatgpt.com/backend-api/codex/responses`)。コンストラクタ引数、サブプロトコル、要求ヘッダは保持されるため、pi が SSE で送る同じ `session-id` がアップグレードに乗ってトランスポート間でセッション identity はバイト同一;サブエージェントは自分自身の id を保つ。`previous_response_id` 増分継続はレーン上で機能する(プロキシはパイプライン前に delta を展開し、それを上流へ再最適化して戻す) | +| AWS Bedrock(`bedrock-converse-stream`) | ❌ Bedrock トラフィックはすべて WebSocket で、トランスポートオプションもなくアップグレードにカスタムヘッダもない — URL インターセプトだけではカバー不能;専用のプロキシ側 WS コーデックが必要(#2111 のスコープ外、#2073 の下で別途追跡) | + +インターセプトの一つのトポロジー結果:pi のクライアント側ハンドシェイクは今やローカルプロキシをターゲットとする(常に成功するため)、*アップストリーム* WS 拒否は pi の同じターン SSE フォールバックをトリガーするのではなく、ストリーム中のトランスポート失敗として表面化する — そのフォールバックはクライアント側ハンドシェイク失敗でのみ発火する。下の明示的 `sse` レーンが依然として決定的なエスケープハッチである。 + +**codex プロバイダーのための回避策。** pi の設定で SSE レーンを強制する(`~/.pi/agent/settings.json`;プロジェクト `.pi/settings.json` が上書き): + +```json +{ "transport": "sse" } +``` + +デフォルトの `"auto"` は WebSocket を先に試し、ハンドシェイク失敗時のみ SSE にフォールバックする;レガシーのブールキー `"websockets": false` は自動的に移行する。キーはグローバルだが、マルチトランスポートプロバイダー(今日は codex プロバイダー)のみが消費し — HTTP のみプロバイダーは無視する。Windows + Pi 1.0.2 (#2063 owner 再現) で検証済み:明示的 `sse` は正しいセッション id で bili に入る。 + +レーンはエンドツーエンドで検証済み(`tests/e2e/e2e-pi-codex-ws.test.ts`、決定的モックアップストリームを本物のプロキシ経由で本物の pi に対して):明示的 websocket と auto ルーティング、`session-id` == 会話 id によるアップグレードヘッダ押印、compress/decompress ラウンドトリップが後続要求に反映されること、`previous_response_id` 展開、アップストリーム拒否の挙動、明示的 sse の回帰ガード、そしてクロス-talk なしで一つのプロキシを共有する二つの並行サブエージェント風セッション。 + +### サブエージェント(pi-subagents)— ネイティブインストールのカバレッジ (#2185) + +pi-subagents(pi.dev パッケージ)は前景と背景サブエージェント実行のために**子セッション**を spawn する。#2185 より前、ネイティブインストール(`bili plugin install pi` / `pi install npm:billion-context`)はこれらの子に bili エクステンションを確実にロードできなかった: + +- **前景の子**は環境エクステンション探索をオフでプロセス内で実行される(`noExtensions: true`)→ bili エクステンションは決してロードされなかった;そのトラフィックは親プロセスのグローバル fetch パッチを通じてのみプロキシに到達したため、各子は**匿名プロキシモード `pfa-*` 会話**として記録された:圧縮は動作したが、名前付き `x-bili-plugin-conversation` identity も親系譜もなく、ACP ツールはプロキシ側ワイヤ注入としてしか存在しなかった; +- **背景の非同期実行**はデタッチされたランナーを起動し、その子*はもしかして*環境探索を通じてエクステンションをロードできる — デフォルト設定では偶然動作し、エージェント定義が `extensions`(`[]` でも)や `denyExtensions` を設定した場合、または pi-subagents バージョンドリフト / npm ストア同期問題では、直接アップストリーム接続(ゼロのプロキシ可視性)に黙って退化した。 + +**修正。** セッション開始時、pi エクステンションは pi-subagents のグローバル必須子エクステンションレジストリ(`globalThis[Symbol.for("pi-subagents.required-child-extensions.v1")]` で機能検出)に自身を自己登録する。レジストリエントリにより bili は**その親セッションから起動されるすべての子の必須エクステンション**になる;必須エクステンションは `additionalExtensionPaths` を通じて移動し、pi は `noExtensions: true` でも**`cliEnabledExtensions` バケットにロードする** — ため以下のすべてのセルでロードが決定的になる。登録は親セッションごとで、セッション終了時に破棄され、同じセッションの競合では既存のエントリに従う(先着ライター勝ち)。`requireForAllRunners` は意図的に**設定しない**:非 pi ランナー配置は拒否されるのではなく今日の挙動を保つ。レジストリが不在か外部形状(古い/新しい pi-subagents)の場合、エクステンションは修正前の挙動に退化し一度ログを出す。キルスイッチ `BILLION_CONTEXT_PLUGIN=0` / `BILI_NATIVE_PI=0` も登録を抑制する。新しい設定表面なし。 + +修正後マトリクス(実機検証済み:pi 0.83.6 + pi-subagents 0.76.0、HTTP トランスポート;WS 行は #2073 から文書化、ライブセルなし): + +| セル | 修正前 | 修正後 | +|---|---|---| +| ネイティブ × 前景 × デフォルト設定 | 匿名 `pfa-*` プロキシモード;ACP ツールはプロキシワイヤ注入経由のみ | **名前付き child-sid プラグインモードセッション**;ACP ツールは初回要求からローカル登録;圧縮は子の自分の id で記録 | +| ネイティブ × 背景 × デフォルト設定 | 環境の偶然 — 設定パッケージが偶然ロードされたときの名前付きプラグインモード | 同上、今や決定的(子の起動解決エクステンションに `required: ["bili"]`) | +| ネイティブ × 背景 × エージェント定義 `extensions: []` / `denyExtensions` | **黙った直接接続** — ゼロのプロキシ可視性、圧縮なし | 決定的な必須パスロード;名前付きプラグインセッション。(ランタイム能力上限がエクステンションを硬く拒否する場合、pi-subagents 0.76.0 は子起動を明白に失敗させる — fail-fast、黙ったものではなく) | +| ランチャーモード(`bili pi`)× 背景 | 子はプロバイダー書き換えを継承したが (#535)、bili は環境の偶然のみでロード | 登録が有効(意図的に `BILI_PROVIDER_REWRITES` でゲートしない);親と子は継承した書き換えを経てルーティングされる名前付きセッション | +| いずれも × WebSocket のみトランスポート | スコープ外 — 上記 WS ギャップ参照 | 不変:クライアント側 WS インターセプトは依然 owner ゲート (#2073) | + +知っておく価値のある注意点: + +- **制限的な `tools:` ホワイトリストを持つロールは ACP チャネルを自動的に取り戻す (#2268)。** frontmatter の `tools:` リストが ACP ツール名を省略するエージェント定義 — 全 7 つの組み込みロールはこのように出荷される(例:`delegate` は `read,grep,find,ls,bash,edit,write,contact_supervisor` を列挙)— は #2185 の名前付きプラグイン修正の後、インタラクティブ圧縮を失わなくなった。bili はそうした子を要求ごとに検出する(pi-subagents はすべての子セッションのシステムプロンプトに完全な `` マーカーを押印する;検出はシステムプロンプトキャリアにスコープされるため、歴史が単にマーカーを引用しているメインセッションは自分自身のチャネルを保つ (#2694);ゲートはさらに要求の tools 配列 — namespace ラップ宣言を含む — が bili が注入する名前のどれも公開していないことも要求する)し、**プロキシ風圧縮チャネル**を通じて提供:ワイヤ注入 ACP ツール + nudge、サーバー側実行、`acp_summary` キャリア — 一方 #2185 の名前付きプラグインセッション identity を保つ。設定変更不要;ロールの元のホワイトリストはワイヤ上でそのまま残り、セッション中のホワイトリスト変更は次の要求で自己修復する。nicobailon/pi-subagents の子にのみスコープされる(マーカーはそのもの);他のすべてのプラグインホストには影響ない。upstream がいつかマーカーを落とすと、これらのロールは #2268 前挙動(名前付きセッション、ローカル ACP ツールなし)に退化する。 + - ロールが ACP/bili 注入可能名の**どれか**を公開すると純粋プラグインモードにとどまる(重複ツール宣言はプロバイダーに拒否される)ため、**部分付与はサポートされない** — 何も付与するか、すべて付与する(`compress,decompress,search_context,acp_status[,acp_cache]`)。 + - 特定のロールにローカル登録(プラグインキャリア)ツールが欲しい? 手動付与を保て:`tools:` フィールドを省略するか、そこに ACP 名を追加する。 +- **背景の子の one-request 登録レース**(ACP ツールは 2 番目の要求から存在)はすべてのモードで既存。 +- **挙動変更の開示:** 前景の子は匿名プロキシモード(`pfa-*`)から名前付きプラグインモード(child session id + 親系譜)に移る。厳密に多くの情報だが、`pfa-*` identity をキーにしているものは異なる id を観察することになる。 + +## Kiro CLI(AWS) + +`bili kiro [opts --] [args]` はプロキシを起動し `kiro-cli` を起動する(`PATH` から解決、なければ `~/.local/bin/kiro-cli`;`BILI_CLIENT_BIN` が上書き)。`--` の後はすべて `kiro-cli` に渡る、例:`bili kiro -- chat --resume`。 + +**Kiro がモデルと話す方法(kiro-cli 2.37 で観察)。** エージェントのモデル呼び出しは **OpenAI Responses ワイヤ**:`POST https://runtime..kiro.dev/v1/responses`、ペイロード `{ model, input, tools, stream, origin, profileArn, metadata }`、`text/event-stream` としてストリーム返却される。Kiro は**ターンごとに完全な履歴を再生する**(そのシステムプロンプトは `input[0]` に `user` アイテムとして乗る)、bearer トークンで認証する(ボディ署名がないため書き換えられたボディも依然有効)、そして `HTTPS_PROXY` を尊重する。他のランタイム呼び出し(`KiroRuntimeService.*`、`/` の AWS-JSON)はモデルワイヤではなくバイト単位で中継される;ログに一度「unrecognized path」として現れるが、これは期待どおり。 + +**レーンが行うこと。** + +- **cert-MITM、モデルゲートウェイのみ:** `runtime.us-east-1`、`runtime.eu-central-1`、`runtime.us-gov-east-1`、`runtime.us-gov-west-1`(`.kiro.dev`)。管理、認証、テレメトリホストはブラインドトンネルのまま。`--mitm-domain` で他を追加。 +- **CA:** 両方の `SSL_CERT_FILE`(Rust シェルの rustls はルート*を置き換える*ためシステムルートも一緒に載せる必要)と `NODE_EXTRA_CA_CERTS`(バンドルされた Node エージェントサーバー、付加型)への結合バンドル。`NO_PROXY` はループバック(ローカルエージェントサーバー、MCP サーバー)を直接に保つ。 +- **ロール(組み込み互換):** ゲートウェイは `user` / `assistant` メッセージアイテムのみを受け入れる。bili が注入する compress プロンプトは `developer` アイテムで、ゲートウェイは `400 This request contains parameters or input that are not supported`(`param: input[0]`)で拒否する;`system` も同じく失敗。Kiro トラフィック(User-Agent `KiroCLI/…` または `x-amzn-kiro-origin`、`runtime.*.kiro.dev` ホスト上)では bili が自動的に `developer`/`system` → `user` に声を替える。最優先度:設定の `compat.roles` と学習済みロールは依然キーごとに優先。不変量判定者は注入プロンプトを元のロールのまま見るため、誤った I1 警告はない。 +- **セッション identity:** Kiro の最初のアイテム(そのシステムプロンプト)はプロセス間でバイト安定ではないため、内容プレフィックスアフィニティでは `kiro-cli chat --resume` のたびに新しいセッションを鋳造してしまう。bili は `metadata["kiro:conversation_id"]` をセッション id(`kiro-`、内容フィンガープリントの上でのみ、実際の会話ヘッダ / `session_id` / `prompt_cache_key` の上では決して)に昇格するため、圧縮状態が resume を生き残る。 + +**注記。** + +- Kiro 自身のオートコンパクトはバックストップとしてオンに残る;bili はより早く折りたたむため、めったにトリガーしない。bili のみに依存するなら:`kiro-cli settings chat.disableAutoCompaction true`(グローバル Kiro 設定;`false` で元に戻す)。 +- Kiro のストリームには usage 報告がないため、nudge 判定は bili のローカルトークン推定を使う(ログの `upstream success without usage report` は期待どおり)。 +- Kiro の `reasoning` アイテムは署名付き(`encrypted_content`)でそのまま保持される;ターンと共に折りたたまれて消える。 +- ランチャーなしの手動セットアップ:`BILI_MITM_DOMAINS=runtime.us-east-1.kiro.dev` で `bili` を実行し、その後 `HTTPS_PROXY=http://127.0.0.1:8787`、`SSL_CERT_FILE`、`NODE_EXTRA_CA_CERTS` を `~/.local/share/billion-context/ca/combined-ca.pem` に向かせて `kiro-cli` を起動する。 + +## 未リストクライアントの採用(モデル base URL が設定できる任意のクライアント)(#2340) + +**モデルエンドポイントを編集でき API キーを持つ**(ログインではなく)すべてのクライアントは、一行の変更で今日すでに圧縮に乗れる — ランチャー不要、コード不要:base URL の先頭にプロキシオリジン + `/bili/` を前置する(`http://127.0.0.1:8787/bili/https://api.example.com/v1`)、API キーはそのままで、デーモンを実行する(`bili start`)。得られるのは完全な純粋プロキシ処理:圧縮 + ワイヤレベルツール注入。詳細と例:[configuration.md → `/bili/` プレフィックス](configuration.md#bili-prefix-api-key-clients)。 + +検証済みのエントリポイント(コミュニティ維持リスト — メカニズムは汎用的): + +| クライアント | base URL の場所 | +|---|---| +| **Cline / Roo Code / Kilo Code**(VS Code) | プロバイダー設定 —「OpenAI Compatible」Base URL、または Anthropic プロバイダーの base URL | +| **Continue** | `~/.continue/config.yaml` — モデルごとの `apiBase` | +| **OpenHands** | `llm.base_url`(設定または環境変数) | +| **Zed** | `settings.json` — `language_models.openai_compatible.api_url` | +| **Void** | カスタム OpenAI 互換エンドポイント設定 | +| **Cursor**(単一モデルチャネル) | Settings → Models → OpenAI API key → **Override Base URL** | +| **Warp** | カスタムモデル base URL 設定 | +| **Command Code**(`cmd`、commandcode.ai) | `~/.commandcode/providers.json` — プロバイダーごと(およびモデルごと)の `baseURL`(キーは `auth.json` にあり、このファイルには決してない) | + +注記: + +- **Crush** は今やランチャーレーン — `bili crush` を優先(設定は無変更、HTTPS ドメインが自動 MITM)。 +- **Zed** もランチャーレーン — `bili zed` を優先(Linux;設定無変更、モデルドメイン自動 MITM、ループバックプロバイダーは直接のまま)。上記の settings.json `api_url` パスはクロスプラットフォームの代替として残る。 +- **Command Code**:上記の行はその BYOK モデル(標準ワイヤ、今日圧縮)をカバーする。そのカタログ/ゲートウェイモデルはカスタムワイヤ(`POST /alpha/generate`)に乗ってバイト単位で中継される — [下記](#認識されないエンドポイントは直接に通り何も圧縮されない-1290) を参照;宣言可能ワイヤの修正は #1295 で追跡。 +- **ログインする**クライアント(OAuth/サブスクリプション)は通常エンドポイントをハードコードしている — プレフィックス技は適用できない;代わりに[下の MITM セクション](#クライアントが-httpproxy-connect-を使うが何も圧縮されない) を参照。 +- プレーンな **Web アプリ**(ブラウザのみ製品)はインターセプトすべきローカルトラフィックがない。 +- VS Code エクステンションは base-URL フィールドをプレーンテキスト設定に保つがシークレットは OS キーチェーンに — ここでは base URL だけが編集される。 + +## クライアントが `http.proxy` (CONNECT) を使うが何も圧縮されない + +一部のクライアント(VS Code ベース IDE:CodeBuddy、Cursor、Windsurf など)は HTTP **プロキシ**設定(`http.proxy`、`codingcopilot.httpProxyURL` など)しか提供せず — 書き換えられるモデル base URL がない。そうしたクライアントはプレーンな `/bili/…` 要求の代わりに、プロキシを通じて `CONNECT :443` を送る。そのパスはモデルホストが bili の **MITM ホワイトリスト**にあるときのみ復号される;そうでない場合、bili は TLS バイトをブラインドトンネルする(不透明中継)ことで、モデル要求を見ることも圧縮することも決してできない (#897)。 + +この失敗モードは今や黙ったものではなく明白: + +- ログにターゲットホストごとの一回限りの `BLIND TUNNEL WARNING`、修正手順付き; +- `curl -s http://localhost:8787/__bili/health` と `/__bili/stats`(ループバックのみ)の `blindTunnels`(カウント + 正確なターゲットホスト); +- そうしたトンネルが存在する間、`acp_status` 出力の `UNDECRYPTED TRAFFIC (instance-level)` セクション。 + +そうしたクライアントを実際に圧縮するには:そのモデルドメインを `billion-context.json` の `"mitm".domains` に追加する(例:`"mitm": { "domains": ["copilot.tencent.com"] }`)または `BILI_MITM_DOMAINS` 経由、bili を再起動し、クライアントに bili のルート CA を信頼させる(Node ベースクライアントは `NODE_EXTRA_CA_CERTS=~/.local/share/billion-context/ca/root-ca.pem`、またはクライアント自身の CA パス設定)。`/bili/` プレフィックス技はここでは適用されない — 変更すべき URL がない。詳細:[configuration.md → MITM](configuration.md#mitm-transparent-proxy-login-clients)。 + +## 認識されないエンドポイントは直接に通り、何も圧縮されない (#1290) + +bili は既知ワイヤプロトコル(`/chat/completions`、`/llm_raw_chat`、`/v1/messages`、`/responses` など)にパスがマッチする要求のみ圧縮する。他の任意のパスへの要求 — 例:サードパーティプラグインの**カスタムワイヤ**、Command Code の Go プランが `POST /alpha/generate` ようなもの — はバイト単位で中継され**決して圧縮されない**。 + +その結果は今や黙ったものではなく明白 (#1290): + +- クライアント側 fetch フックは各異なる未ルーティング **POST** エンドポイントをプロセスごとに一度ログに出す(`…is not a recognized model endpoint, so bili did not route it through the proxy…`);非 POST トラフィック — npm レジストリ、カタログ JSON、git refs — は設計上黙っている (#1657:GET はプロンプトを載せられない); +- `curl -s http://localhost:8787/__bili/stats`(ループバックのみ)の `unrecognizedPaths`(パスごとのカウント); +- そうした要求が存在する間、`acp_status` 出力の `UNRECOGNIZED PATHS (instance-level)` セクション。 + +二つのシームが今や「カスタムパス、標準ワイヤ」ケースをカバーする — パスが非標準だが要求/応答形状が既知四プロトコルのいずれかであるエンドポイント: + +1. **クライアント側、クライアントごと** — クライアントのモデル base URL を `/bili/` トンネルのプロトコルセグメント形式にする: + + ```text + http://127.0.0.1:8787/bili// + # e.g. http://127.0.0.1:8787/bili/openai/https://relay.example.com/api/custom/complete + ``` + + `` は `anthropic`、`openai`、`responses`、`google` のいずれか。パスに関わらずワイヤプロトコルを強制する — すべてのサーバー側シグナルに**優先**する。クライアントの base URL を制御できるがエンドポイントパスが非標準なときに使う。 + +2. **サーバー側、レーンごと (#1909)** — すでにホスト/パスをルーティングしているプロバイダークーキーに `"protocol"` を宣言する([configuration.md → `protocol`](configuration.md#protocol) を参照)。クライアントの base URL を変更できないとき(ハードコードされたエンドポイント、MITM インターセプトされたホスト)に使う。 + +どちらの方法でも、宣言はワイヤを*識別*するだけ — そのプロトコルとしてパースできないボディは依然そのまま中継される (#1284)。真のカスタムワイヤ(独自の要求/応答形状、例:Command Code の `/alpha/generate`)は依然自分自身のサポートが必要;それの修正はプロバイダーの標準プロトコルエンドポイントを使うこと(Command Code の Provider プランは `POST /provider/v1/chat/completions` に投稿し、これは bili が圧縮する)。 + +## OpenCode + +バンドルされたプラグイン 1 つが OpenCode の**両世代**に効く:エージェントファイルは V1 の `server()` エクスポートを V2 の `setup()` と併せて保持するため、ホスト ≥ 1.18.29 は V1 形状を読み、2.x ホストは V2 の `setup()` を読む。独立した [`opencode-acp`](https://github.com/ranxianglei/opencode-acp) エクステンションは V1 のみで、2.x では読み込まれ**ない** — OpenCode 2.x には billion-context が推奨コンテキストマネージャである。以下すべては `@opencode/cli` 2.1.0(V1 レーン:1.14.46 と 1.18.31)でエンドツーエンド検証済み。 + +| パス | コマンド | いつ | +|---|---|---| +| ランチャー(最易) | `bili opencode` | 1 コマンドでプロキシ+クライアント起動;実設定は無変更 | +| ネイティブ(ランチャーなし) | `bili plugin install opencode` | 実設定への自己起動プラグイン;`opencode` を通常通り起動 | +| 純粋プロキシ(フォールバック) | baseURL `/bili/` プレフィックス | プラグインなし — ワイヤレベルツール注入 | + +これらのパスは**互いに排他** — 各々が同じ要求のルーティングを所有するので、ホストインスタンスごとにちょうど 1 つのみが有効。手書きの `/bili/` プロバイダー baseURL は純粋プロキシパスのマーカ;ネイティブプラグインがインストールされている間にそれを書くと**競合する設定**になる (#1958):ランタイムはセッションごとに一度警告する(オリジンごとに重複除去)+ 修正ガイド付き — プレフィックスを外すかプラグインを外す — そして要求はそのパスがエンコードするプレーンプロキシパスにとどまる(プラグインセッションマーカなし)。サポートされる例外は**同じ**オリジンの明示ピン — URL がすでに載っているプロキシに向く `BILLION_CONTEXT_PROXY` — これは黙ったまま。 + +### ランチャー — `bili opencode` + +HTTPS は cert-MITM、HTTP は `/bili/` を付けた一時 `opencode.json` クローン(JSONC コメント可;opencode 自身がマージする方法でマージ;相対ローカルプラグンスペックはクローン内で絶対パスへ再アンカー — opencode は宣言設定ファイルのディレクトリに対して解決、#826)。ホスト世代は `--version` プロブで検出(プロブ失敗は 1.x に既定):**2.x** ホストには組み込み V2 プラグイン(`dist/agent/opencode.js`)が一時ラッパーディレクトリとして注入され、その `index.js` がプラグインファイルを再エクスポートする(2.x は設定の `plugin` 配列での裸ファイルパスを拒否);**1.x** ホストは裸ファイルパスを受け取る。 + +プラグインが行うこと(両世代):bili ツールをホスト内でネイティブ登録 — compress / decompress / search_context / acp_status (+ absorb) — すべての送信プロバイダ要求にプロキシヘッダを盖章し、ホスト自身のモデルカタログから読むコンテキストウィンドウ/最大出力を含む(`ctx.catalog.model.list()`、60s ごと更新)をランタイム情報としてプロキシに報告 (#955) — 圧縮はプラグインモードで走り、ワイヤレベルツール注入は**一切ない**。ネイティブオートコンパクトは自動的に無効化される(`compaction.auto: false`)。すべての登録は防御的(オプショナルチェーン):シームが欠けているか決して発火しないどんな 2.x ビルドでも、プラグインは不活性のまま透明にプレーンプロキシモードでセッションが走る(壊れる代わりに)— API サーフェスが互いに異なる隣接 `dev` ビルド間で観察済み (#754 review probes)。 + +1.x 固有(検証済み 1.14.46 + 1.18.31):V1 `.server()` フックはすべてのプロバイダー `options.baseURL` をプロセス内で `/bili/…` に書き換え、`compaction.auto: false` をセット;`chat.headers` は要求ごとにプラグインヘッダを盖章;`tool` は bili ツールを実の zod 形状で登録(zod はランタイム依存 — 解決できない場合プラグインは書き換えのみに退化)。明示的な `baseURL` なし**のプロバイダー(SDK 既定、例:裸 `@ai-sdk/openai` → api.openai.com)はグローバル `fetch` パッチで捕捉される(ログ:`v1: fetch patch installed`)— イデムポテント、`/bili/` 包み URL は無変更で通過;OpenAI Responses エンドポイントを含めて検証済み。 + +### ネイティブ(ランチャーなし) — `bili plugin install opencode` + +実 opencode 設定に自己起動プラグインを登録し、`compaction.auto: false` をセット;以降プレーンな `opencode` がそのまま動く。既定では MCP フェースは追加されない(ネイティブプラグインがすでにセッション紐付きの bili ツールを提供)— `--with-mcp` を渡すと 1 つ追加 — そのエントリはオリジンピンを持たないので、プラグインのエフェメラルポートプロキシ再起動を生き残る (#926)。エントリ形式はホスト世代と**この** bili のインストール方法の両方に依存する。**OpenCode 1.x npm インストール**は裸パッケージ名を書く(`"plugin": ["billion-context"]`)— パッケージは `exports["./server"]` → `dist/agent/opencode-native.js` を公開するので、opencode は自身の Npm.add メカニズムで読み、絶対パスゼロ、ポータブル。(その正確な裸名エントリは bili なしの手動インストールとしても機能する — README Quickstart Option 1 参照。)**OpenCode 2.x ホスト**では — およびどんな **git チェックアウト / dev ビルド**でも — インストーラは代わりにローカルシムディレクトリを書く(`/plugins/billion-context/index.js` → このインストールの `dist/agent/opencode-native.js`):2.x は裸パッケージ名をパッケージの `main` フィールド(`dist/index.js`、CLI — プラグイン定義なし)経由で解決するので、裸名はそこで決して読まれない (#3976);install の再実行(または新パスへの再インストール)でシムが現在のルートに向くよう再生成され、2.x 設定内のレガシー裸名エントリは自動的にシムへ移行される。 + +ロード時にプラグインは自身のプロキシをブートストラップする(二重化せず健全なインスタンスにアタッチ;opencode が終了すると parent-pid ウォッチドッグが殺す)、モデル API トラフィックを `/bili/` にルーティングし、ランチャーモードと同じネイティブ bili ツールを公開 — 固定ポートなし、環境変数なし、ランチャーなし。オプトアウト:`BILI_NATIVE_OPENCODE=0`。健全なプロキシを作れない場合、要求は直接(非圧縮)に通り一度限りの警告付き、自動回復。`bili opencode` 起動下ではこのエントリは完全にスキップされる(プロキシはランチャーが所有)。 + +### OpenAI Responses WebSockets (V2) + +V2 プラグインは OpenAI の `experimental.ws.handshake` 要求もインターセプトする。両レグが WebSocket を使う:OpenCode → bili → Responses アップストリーム。これは API キー OpenAI と ChatGPT Pro/Plus ブラウザ/ヘッドレス OAuth の両方を含む;ログイン方法はトランスポートを選ばない。OpenCode 設定書き換えも新しい bili 設定も不要。ソケットはローカル起源で協調プラグイン identity を載せなければならない;汎用または未主張のアップグレードは 426 を維持。 + +ACP 処理、ネイティブツール、usage 計上は有効のまま。クライアント delta は圧縮前に展開される。アップストリーム delta は処理済み履歴が前回の応答を正確に拡張する場合のみ使用される;フォールドは同じソケット上で完全な圧縮入力と共に新しいチェーンを開始する。ref タギングや他の履歴編集も完全入力を必要とすることがあるので、接続再利用はターンごとに増分であることは示さない。実験フックのない古いホストは OpenCode 既存の `providers.openai.settings.transport: "http"` 設定を使わなければならない。リアルタイム、多重化同時応答、リモート WS クライアントはこの統合のスコープ外。検証:ライブ OpenAI/ChatGPT 認証情報ではなく、ローカル Responses WS アップストリームを持つ実 OpenCode V2.0.20。 + +### 純粋プロキシ(プラグインなし) + +他のクライアントと同様に、プロバイダー baseURL をプロキシに向ける: + +```json +{ + "provider": { + "myprovider": { + "npm": "@ai-sdk/openai-compatible", + "options": { + "baseURL": "http://localhost:8787/bili/http://upstream.example/v1", + "apiKey": "sk-any" + } + } + } +} +``` + +注:2.0 AI-SDK プロバイダーはローカルエンドポイント(チェックしないもの)でも `apiKey` フィールドを要求する — いかなる非空値でもセット。 + +このパスは**プラグインなし**を意味する:ネイティブプラグインもインストールされている場合、ランタイムはセッションごとに一度警告する — プロバイダーごとに 1 つのパスを選ぶ (#1958)。 + +### Status: `/acp` と `acp_status` + +`/acp` パネルは全モードでセッション紐付きで、`acp_status` ツールはそのホスト内同等物がどこでも。2.0.x stable では(コマンドエディタがエントリ追加をサポートし(`editor.add`))、V2 プラグインは `/acp` スラッシュコマンドを追加登録する — 合成の非モデルメッセージとしてレンダリングされ、`acp_status` ツールと同じくパネル優先;古い形状では登録は不活性のまま。`opencode run` モードはスラッシュコマンドを一切ディスパッチしないことに注意(モデルに通過)— TUI を使うこと。 + +同じシームが `/acp-cache` (#1146) を載せる — プロンプトキャッシュ調整レポートへの人間エントリポイント(`acp_cache` ツールと同一出力):pi/omp はネイティブ登録(全行一覧は `/acp-cache [full]`);opencode V1 はそれがモデルコンテキストに届く前にプロキシがワイヤから剥奪する無視メッセージとしてレンダリング;opencode V2 は合成メッセージとして(レポートは ~8 KB まで可視);dsh(両レーン)は既定サマリー台帳を表示 — dsh のコマンド API は引数を渡さないので `full` はない。レガシー opencode-acp セッション (#920) は代わりに明示的な利用不可通知を受ける(そのトラフィックはこのプロキシの圧縮状態をバイパス)。Claude Code はインプロセスコマンド API を持たない:`bili plugin install claude` はモデル仲介の `commands/acp-cache.md` マークダウンコマンドを書き、そのプロンプトが `acp_cache` MCP ツールを駆動してレポートを逐語貼り戻す。codex/kimi/hermes はユーザー入力可能なコマンドシームを公開しない — モデルに直接 `acp_cache` ツールを呼び出させること。フォールドごとの損益判定はオプションの `compress.priceProfile`(入力トークン単位の正規化倍率)で価格付けされる;どのレベルもそれをセットしない場合、要求モデルの models.dev 価格行が絶対 $/Mtok で適用される(解不能モデルにのみカーネル比率既定)— よって breakeven/PAID BACK は箱出しのままアップストリームの実経済を反映する;カスタムマークアップのレレーにはプロバイダーごとに上書き(configuration.md, #1279)。 + +同じシームが `/acp-rule` (#1251/#1399) を載せる — 永続ルール機能への人間エントリポイント(`acp_rule` ツールと同一出力):pi/omp はツールの完全操作セットでネイティブ登録 — 裸 `/acp-rule` は記録済みルールのすべてを一覧、`/acp-rule ` は 1 つを直接記録(モデルが呼び出したかのように)、`/acp-rule remove ` は 1 つを削除、裸 `/acp-rule clear` は記録済みルールのすべてを抹消(`clear ` は抹消ではなく記録 — タイポがすべてのルールを破壊してはならない)で。包まれたトランスクリプトメッセージはキャッシュレポートと同様に内容署名でモデルコンテキストから剥奪される — 記録済みルールはシステムプロンプト注入経由でターンごとにモデルに届く。 + +### Legacy opencode-acp セッション (#920) + +1.x ホストでは、移行前の [`opencode-acp`](https://github.com/ranxianglei/opencode-acp) セッションは両レーン下で動き続ける:ランチャーはその一時設定クローンから `opencode-acp` エントリを剥離する(ホストは武装状態で決して読まない)、各レーンはインストール済みパッケージを吸収する(`node_modules` から直接インポート — `.opencode/node_modules`、プロジェクト `node_modules`、グローバル npm ルート、または opencode の設定スコープモジュール、最初のヒットが勝つ)。セッションがレガシーであるとは、opencode-acp の永続化状態ファイルが存在すること(`/opencode/storage/plugin/acp/.json`、または `acp.jsonc` の `storagePath` のディレクトリ): + +- **レガシーセッション** — 圧縮は吸収された opencode-acp を通って走る(自身の ref とブロックストアは動き続ける:`compress` / `decompress` / `search_context` / `acp_status` / `acp_context_recap` がすべてそこで実行)。そのモデル要求は `x-bili-plugin-bypass: 1` を載せ、プロキシはそれらを逐語転送 — ワイヤ注入なし、nudge なし、セッションバインドなし。 +- **新セッション** — bili が所有:ツール呼び出しはプロキシのプラグインエンドポイントへ転送(プラグインモード)。実行者はセッションレーンでルーティングするので、新セッションの `compress` はプロキシに届き、レガシーセッションのそれは opencode-acp に届く。`acp_context_recap` にプロキシ側の対応物はない — 新セッションではプロキシは未知ツールメッセージで応答する。 + +`/acp` と `/dcp` も同じようにルーティングされる。新セッションの opencode-acp レジストリへの取り込みは、そのトランスフォーム(system / messages / text.complete)をレガシー述語でゲーティングすることで防止される。退化:パッケージが欠けているかインポート失敗(または v1 でない)場合、bili は単独で走り、レガシーセッションは読み取り専用アーカイブとして振る舞う(古いタグはレンダリング、`decompress` は `[Block … not found]` を返し、新しい ref は m00001 から再開)。 + +### Caveats + +- 2.x 系は npm パッケージ `@opencode/cli` として公開され、そのプラグイン API サーフェスはビルド間でまだ移動している(隣接 `dev` チャネルビルドは異なる `ctx` 形状を公開)— 上記のフック/ツール詳細はバージョン固有の観察であり、安定契約ではない。 +- 設計注:V2 プラグインは薄いプロトコルクライアントである(内部に acp-kernel なし)。これはプロキシが圧縮権威の単一にとどまるため — エージェントとプロキシ間のカーネルバージョンドリフトを排除する;プラグイン API がコンテキストを変更できないという能力に依存しない(その能力は 2.x ビルドにより異なる)。 diff --git a/docs/index.md b/docs/index.md index 57778331f3..6128f9eb22 100644 --- a/docs/index.md +++ b/docs/index.md @@ -10,7 +10,7 @@ | [README](../README.md) / [中文](../README.zh-CN.md) / [日本語](../README.ja.md) | Project entry: what it is, quickstart, architecture overview | | [architecture](architecture.md) / [中文](architecture.zh-CN.md) | **System architecture hub** (LIVE doc, owner ruling 2026-11-08): overall diagram + per-module pages, each with its own diagram — see `docs/architecture/` | | [configuration](configuration.md) / [中文](configuration.zh-CN.md) | Full configuration reference (generated from `website/config-reference/*.yaml` by `tools/gen-config-docs.mjs`; hand-written sections are drift-guarded) | -| [clients](clients.md) / [中文](clients.zh-CN.md) | Per-client integration deep dives: how each mode (launcher / `/bili/` / native plugin) wires traffic in | +| [clients](clients.md) / [中文](clients.zh-CN.md) / [日本語](clients.ja.md) | Per-client integration deep dives: how each mode (launcher / `/bili/` / native plugin) wires traffic in | | [how-it-works](how-it-works.en.svg) / [中文](how-it-works.zh-CN.svg) | One diagram: request flow + the injected context tools | | [README](README.md) / [中文](README.zh-CN.md) / [日本語](README.ja.md) | Directory landing page: section map + the rules that keep this directory live | diff --git a/docs/index.zh-CN.md b/docs/index.zh-CN.md index c3ef60539f..6b9c8855da 100644 --- a/docs/index.zh-CN.md +++ b/docs/index.zh-CN.md @@ -10,7 +10,7 @@ | [README](../README.zh-CN.md) / [English](../README.md) / [日本語](../README.ja.md) | 项目入口:是什么、快速上手、架构总览 | | [architecture](architecture.zh-CN.md) / [English](architecture.md) | **系统架构总览**(实时维护,owner 裁定 2026-11-08):整体架构图 + 每模块一页(各配图),见 `docs/architecture/` | | [configuration](configuration.zh-CN.md) / [English](configuration.md) | 全量配置参考(由 `website/config-reference/*.yaml` 经 `tools/gen-config-docs.mjs` 生成;手写部分有漂移守卫) | -| [clients](clients.zh-CN.md) / [English](clients.md) | 各客户端接入深潜:launcher / `/bili/` / 原生插件三种模式如何接线 | +| [clients](clients.zh-CN.md) / [English](clients.md) / [日本語](clients.ja.md) | 各客户端接入深潜:launcher / `/bili/` / 原生插件三种模式如何接线 | | [how-it-works](how-it-works.zh-CN.svg) / [English](how-it-works.en.svg) | 一张图:请求流转 + 注入的上下文工具 | | [README](README.zh-CN.md) / [English](README.md) / [日本語](README.ja.md) | 目录落地页:分区地图 + 保持本目录不再变乱的规则 | From b7b2480339f06e18ac1ead26376f90e998082880 Mon Sep 17 00:00:00 2001 From: ranxianglei Date: Thu, 12 Nov 2026 23:37:11 +0800 Subject: [PATCH 13/17] docs: add Japanese version of technical-notes.md (#6072) --- TECHNICAL-NOTES.ja.md | 1 + docs/technical-notes.ja.md | 264 +++++++++++++++++++++++++++++++++++++ 2 files changed, 265 insertions(+) create mode 100644 TECHNICAL-NOTES.ja.md create mode 100644 docs/technical-notes.ja.md diff --git a/TECHNICAL-NOTES.ja.md b/TECHNICAL-NOTES.ja.md new file mode 100644 index 0000000000..1911c3ca5c --- /dev/null +++ b/TECHNICAL-NOTES.ja.md @@ -0,0 +1 @@ +> 移動先 [docs/technical-notes.ja.md](docs/technical-notes.ja.md)。リダイレクト用プレースホルダー。1–2 リリース後に削除予定。 diff --git a/docs/technical-notes.ja.md b/docs/technical-notes.ja.md new file mode 100644 index 0000000000..a09f6d4d36 --- /dev/null +++ b/docs/technical-notes.ja.md @@ -0,0 +1,264 @@ +# 技術ノート + +README に記載されている 3 つの使用オプションの背後にあるメカニズムレベルの詳細です。 +README では各オプションを簡潔に記述しており、「実際の動作原理」に関する内容はオプション間の説明ではなく、ここに記載されています。 + +## 拒否リクエストのトークン測定 + +コンテキストオーバーフローからの回復処理では、アップストリームのコンテキストウィンドウと、拒否されたリクエストの合計トークン数、入力メッセージ数、および補完(completion)予約量を区別します。パーサーは、OpenAI/DeepSeek 形式の括弧付き分割(`requested N tokens (M in the messages, C in the completion)`)と、SGLang/LiteLLM 形式のコロン区切り分割(`requested a total of N tokens: M tokens from the input messages and C tokens for the completion`)の両方を受理します。明示的な入力カウントは既存のキャリブレーションリングに供給され、補完カウントは既存の出力ヘッドルーム予約を有効化します。ウィンドウ情報のみ、または不完全なエラーメッセージからは、捏造されたトークン測定値は提供されません。このパース処理はプラグインモードとプロキシモードで共有されており、宣言されたモデルウィンドウを変更することはありません。 + +## 短いソースビュー後のフォーク回復 + +フォーク採用では、ソースの最後の `active` フラグではなく、子プロセスのリプレイに対して保持された圧縮ブロックを判定します。短いソースリクエストにより、フォールドが一時的に無効化される場合がありますが、その完全な元のスパンは子プロセス内で返ってくる可能性があります。完全に存在する保持スパンはアクティブブロックとしてコピーされますが、明示的に展開されたブロック、消費済みティアの子、およびフォーク境界をまたぐスパンは独立してアクティブ化されません。ティアの子は、採用された祖先とともに無効レコードとして付随します。プランニングと採用処理は、ソースセッションを変更しません。 + +## ネイティブプラグインライフサイクル(オプション 1) + +読み込み時に、プラグインは**独自のプロキシを生成**します(または、正常に実行中の既存プロキシにアタッチします — 親 PID ウォッチドッグがクライアント終了時にそれを破棄します)。モデルトラフィックを `/bili/` に書き換え、`compress` / `decompress` / `acp_status` をネイティブクライアントツールとして登録し(プラグインモード)、`/acp` パネルを現在のセッションにバインドします。また、クライアントの**独自のモデル設定**をプロキシに報告します(ランタイム情報プロトコル、#955)。これにより、圧縮予算がレジストリの推測値ではなく実際のウィンドウを使用します。オプトアウト用の環境変数: `BILI_NATIVE_PI=0`, `BILI_NATIVE_OMP=0`, `BILI_NATIVE_OPENCODE=0`, `BILI_NATIVE_DSH=0`, `BILI_NATIVE_KIMI=0`, `BILI_NATIVE_HERMES=0`, `BILI_NATIVE_ZCODE=0`。 + +## プロキシ再利用とアタッチゲート (#1225, #1335, #1232, #1660) + +ネイティブフックは、独自のものを生成する代わりに、すでに実行中のプロキシにアタッチできます — ただし、以下のライフサイクルゲートを通過した場合に限ります。再利用はアイデンティティベースです(#1225):既存のプロキシは、**同じコード**(エントリスクリプトの sha256、インスタンスファイルに記録)を実行しており、**レーンが互換性がある**場合 — 各ランチャーはクライアントのレーンを宣言し、2 つの*異なる宣言された*レーンは決して共有せず、宣言されたレーンを持たないインスタンスは手動で起動されたユーザーゾーンデーモンであり、その軸ではワイルドカード互換 — **かつライフサイクルゲートを通過している**場合(§以下)にのみアタッチされます。ライフサイクルゲートとは、アームされた親 PID ウォッチドッグ(`watchdog.armed == true`)であり、つまり親 PID を持つランチャーによって生成され、最後にアタッチされたセッションが死んだときに死ぬことを意味します。**または**、ユーザーゾーンインスタンス(レーンなし、ローンチトークンなし)であり、定義上免除されます(#1660)。#1225 以前に書き込まれたインスタンスはコードフィンガープリントを持たないため、決してアタッチされません:再構築または更新されたインストールは、次の起動時に常に新しいプロキシを開始するため、修正が即座に反映され、古いコードを黙って提供することはありません。 + +| リスナー | アタッチ? | 理由 | +|---|---|---| +| このセッションによって生成されたプロキシ | ✅ | 生成時にアーム済み | +| 他のセッションのアーム済み共有プロキシ(ウォッチャー設定済み、#1186) | ✅ | 共有は設計通り | +| 手動で起動された `bili start` デーモン(ユーザーゾーン、#1660) | 🔶 条件付き | **ユーザーゾーン**インスタンス(レーンなし、ローンチトークンなし):**アーム済み**のもの(管理された共有プロキシ、#1225)は、互換性のある任意のクライアントレーンによって利用されます;**アーム未設定**の手動ものは、デフォルト(`attachPolicy: own-lane`、#2877)では、レーン付きフックによって利用されません — 代わりに独自のものを生成します。`attachPolicy: global-fallback`(#2877 以前)または `attachExternal=1` の下では利用されます。いずれの場合も、そのライフタイムとバージョンはあなた自身が管理します | +| アーム未設定の**レーン付き**プロキシ(クラッシュしたセッションの孤児;#1330 以前は検証不能) | ❌ 明確に拒否 | ライフサイクルドリフトの兆候(#1335):これを利用すると、ライブセッションが所有していないプロキシを黙って再利用することになります | + +フックはアタッチ前に各候補の `/__bili/health` をプローブします:アーム済み → アタッチしてウォッチャーを登録(変更なし);**アーム済みユーザーゾーン**候補は、レーンアフィニティポリシーに関係なくアタッチされます(管理された共有プロキシ、#1225);**アーム未設定ユーザーゾーン**(手動)候補は、`attachPolicy: global-fallback`(#2877 以前)または `attachExternal=1` の下でのみアタッチされます — デフォルト(`own-lane`)では、レーン付きフックは独自のものを生成します(#2877);アーム未設定の**レーン付き**候補(クラッシュしたセッションの孤児、または `watchdog` フィールドを全く報告しない #1330 以前のビルド — 検証不能、アーム未設定として扱われる)は**明確に**拒否され、セッションはセルフマネージドポートゾーン(ベース `18787`、またはレーンのスティッキードリフトレコード;生成時にアーム済み、最後のセッションとともに死ぬ、#1186 ウォッチャーセマンティクス)で独自のプロキシを生成します。バージョンズレは固定されます:コードフィンガープリントチェックが最初に実行されるため、再構築または更新されたインストールは、ユーザーゾーン免除であっても古いデーモンを利用しません。コスト:アタッチ可能なものが存在しない場合、セッションごとに 1 つの短命プロキシプロセスが追加されます(セッション状態はディスク上で共有されるため、圧縮の継続性は影響を受けません);マルチインスタンス警告(#394)は対応してより頻繁に表示されます。**エスケープハッチ:** 設定ファイル内の `native.attachExternal: true` または `BILI_NATIVE_ATTACH_EXTERNAL=1` は、ウォッチドッグ状態に関係なく(#1330 以前のビルドを含む)*レーン付き*リスナーへのアタッチを拡張します — その場合、これらのデーモンのライフタイムとバージョンはあなた自身が管理します;`attachExternal` は**レーン付き**デーモンの*ライフサイクルゲート*のみを管理します(ユーザーゾーンアタッチを開閉するものではありません — その軸は `attachPolicy` です);`attachUrl`(環境変数 `BILI_MCP_PROXY` / `--origin`)は明示的なターゲットオリジンを固定します。明示的なユーザー指示によるアタッチ(kimi/dsh 用の `BILLION_CONTEXT_ATTACH` / プリセット `BILLION_CONTEXT_PROXY`)は、発見プロセスを完全にバイパスし、構造上免除されます。 + +アタッチ発見は、**すべての**ライブインスタンスに対してレーン認識です(#1232):ランチャーはインスタンスレジストリの単一のインスタンスファイル(後書き込み優先 — 並行マルチクライアント使用下では、他のクライアントのプロキシを指す可能性があります)だけでなく、すべてのライブエントリをプローブし、すべての候補に上記のゲートを適用します。互換性のある候補の中で、ランチャー自身の宣言されたレーンを持つ最新のインスタンスが勝者となります;レーンを持たないインスタンス(ユーザーゾーンデーモン)は、レーン軸ではワイルドカード互換であり、デフォルトでゲート免除です(#1660)— ただし、レーン付きフックが実際にそれにフォールバックするかどうかは `attachPolicy` によって管理されます:`own-lane`(デフォルト)は*アーム未設定*の手動デーモンを利用しません(#2877)、一方 `global-fallback` は #2877 以前のワイルドカード利用を復元します。`another bili instance is running` 警告(#394)もレーン認識です:同じレーンまたはレーンなしの共存に対して発火しますが、2 つの*異なる*宣言されたレーンの間では沈黙します(それらのセッションファイルは互いに排他です)。 + +**再利用されたプロキシは、独自のプロセスローカルのリゾルバ状態を保持します(#5222)。** アタッチ/再利用はセッションを*長命*プロセスに引き渡します;OS レベルのネットワーク変更(WSL/VPN スイッチ、MagicDNS 引き継ぎ)の後、そのプロセスの libuv スレッドプール — `dns.lookup` と undici のデフォルトコネクタがアウトバウンド接続で共有するもの — が固着し、他のプロセスが正常に解決しているにもかかわらず、その内部でのすべてのルックアップがタイムアウトする可能性があります。*ホスト*(例:DSH Web)を再起動しても、それは更新されません:インスタンスレジストリは同じ PID を黙って再採用します。対策:PROXY プロセスを再起動する(`~/.local/state/billion-context/instances/` に記録された PID を kill する)、またはアウトバウンドをアップストリームプロキシ経由でルーティングする(`-F` / `BILI_UPSTREAM_PROXY`、これはローカル DNS 承認を完全にスキップします)。#5222 以降、トンネル承認も自己防御します:メインプールのルックアップがリトライを使い切った場合、`unresolvable` 判定の前に、新しいワーカースレッドプールで 1 回のプローブが実行されるため、固着したプロキシは健全な宛先を誤って拒否することを止めます(ワーカーの結果によって承認され、完全な回復のためにプロキシを再起動するようオペレーターに警告する大きな警告ログとともに — その時までアウトバウンド接続は固着したプールを共有し続けます)。フェーズ 2(オーナー決定 2026-10-31:検出 + 表面化、自己再起動はしない)は、承認 MAIN プールの結果のみを供給源とする永続固着検出器を追加します(ワーカープローブは承認を緩和しますが、プールを修復しません):THROW するルックアップのみが失敗としてカウントされます(権威的な空の応答はリゾルバが到達可能であることを証明します)、そしてゲート — このプロセスが以前に正常に解決した少なくとも 2 つの異なるホストが、それぞれ現在 ≥5 分間連続して失敗している(`src/resolver-wedge.ts` の `WEDGE_MIN_HOSTS` / `WEDGE_SUSTAIN_MS`;トラッカーは FIFO で 256 個のユーザー指定ホストに上限)— が Web パネルのバナー、`/__bili/status` + `/__bili/overview` 上の追加フィールド `resolverWedge`(健全な間は null)、`acp_status` アラーム行、およびエピソードが持続する間 10 分ごとに再記録される警告ログ行を駆動します;プロセスの動作は変更されません。 + +## 共有状態ディレクトリとマルチインスタンスセキュリティ境界 (#394, #1724) + +ホスト上のすべての bili インスタンスは、**同じ**ホスト毎のストレージを読み書きします:XDG データディレクトリ(`~/.local/share/billion-context/` — セッションレコード、CCR コンテンツストア、プレフィックスアフィニティ)および状態ディレクトリ(`~/.local/state/billion-context/` — ログ、インスタンスレジストリ)。コントロールプレーンはレーン認識です(#1232:アタッチ発見と #394 共存警告の両方が宣言されたレーンを尊重します)、しかし**データプレーンは分割されていません** — ディスク上にセッション毎のオーナーやレーン毎の分離はありません。これにより 2 つの結果が生じます: + +- **インスタンス間セッション可視性。** 各インスタンスの Web UI(`__bili/sessions` リスト / 詳細 / ログ)は共有ストア全体を再スキャンするため、ループバック経由で到達可能な任意のインスタンスは、そのホスト上の他の任意のインスタンス/レーンによって作成された*任意*のセッション — 生のメッセージ、コンテンツストアペイロード、圧縮ブロック — を列挙し、読み取ることができます。 +- **再起動ドレイン競合。** 再起動時、新しいプロセスは古いプロセスがフラッシュを完了する前にストアをハイドレートするため、後書き込み優先により古いプロセスの最終的な書き込みが失われる可能性があります:末尾更新の喪失とプロバイダープレフィックスキャッシュの破棄(アウトバウンドボディがプロバイダーがキャッシュしたものから乖離する)。#1724 の緩和策:#405 スナップショットカウンターガード(古いセッション書き込みを拒否)、プレフィックスアフィニティ書き込み時 Union ガード(#1737:1 つのインスタンスのフラッシュが兄弟チェーンを上書きすることはない)、および自己再起動順序修正(#1742:代替プロセスが生成される前に永続状態がディスクにフラッシュされる)。ホスト主導の再起動(dsh など、#991)は、その kill/spawn 順序が bili によって制御されないため、これらのデータレイヤーガードに依然として依存しています。 + +**セキュリティ姿勢:** 共有状態サーフェスは、管理エンドポイントのループバックゲート(非ループバックソースアドレスは拒否)およびユーザーのホームツリーのファイルシステム権限(両方のディレクトリは $HOME 配下にあります)によって*のみ*保護されています — セッション毎の認可はありません。**シングルユーザホスト**では、それで十分です。**マルチユーザホスト**では不十分です:プロキシのループバックポートに到達できるローカルアカウントは、すべてのユーザーのすべてのセッションを読み取ることができます。そのようなホストは、ホスト毎のストレージを分割する必要があります(ユーザー毎/レーン毎のサブディレクトリ)— #1724 で名付けられた根本修正(方向 #1)であり、まだアーキテクチャ決定としてオープンです;Web UI スコーピング(#1724 方向 #4)はインスタンス間ブラウジングを軽減しますが、この境界を変更しません。 +## Runtime-info プロトコル (#955) + +ネイティブプラグインはクライアントプロセス内で動作するため、クライアント自身が使用するモデル設定を読み取ることができます。この真実(truth)をプロキシに2つのチャネルでプッシュし、コンテキストウィンドウの解決チェーンにおいて、プロキシは models.dev レジストリや組み込みテーブルよりもこれを優先します: + +| チャネル | タイミング | フィールド | +|---|---|---| +| リクエストごとのヘッダー(`x-bili-plugin` でゲート制御) | すべてのモデルリクエスト | `x-bili-plugin-context-window`, `x-bili-plugin-max-output`, `x-bili-plugin-model` | +| `POST /__bili/plugin/runtime-info` (loopback) | プラグインブートストラップ + 報告された設定の変更時 | `{agent, model, contextWindow?, maxOutput?, baseURL?, conversationId?, source}` | + +ウィンドウの解決順序は以下の通りです:`anthropic-beta` のネゴシエーション > リクエストごとのプラグインヘッダー > runtime-info > ランチャー環境変数 > ルート設定 > models.dev レジストリ > 組み込みテーブル。runtime-info ステップでは、リクエストが `x-bili-plugin` ヘッダーを保持している場合、**エージェント単位のエントリ**を読み取ります(agent と model が一致する必要があります)。ヘッダーを持たないリクエストは、`conversationId` で記録された**会話スコープのエントリ**を解決します。このキーは、セッションがバインドするのと同じ会話シグナル(クライアントの会話ヘッダー、カスタムセッションヘッダー、またはボディ内の `prompt_cache_key`)に基づいています。いずれの場合も model は一致する必要があります(#1531: omp は `prompt_cache_key` をスタンプしますがプラグインヘッダーは付与せず、メイン/サブエージェントセッションは異なるモデルを動作させながら同じエージェント名を共有するため)。報告された `maxOutput` は、リクエストボディが独自の出力予算を保持していない場合のみ有効になります。実装:`src/agent/pi.ts`(pi と omp をカバー)、`src/agent/opencode-native.ts` (v1)、`src/agent/opencode-v2.ts`、`src/agent/dsh-native.ts`、`src/kimi/native-mcp.ts`(ブートストラップ時の報告のみ — kimi のプロバイダー `custom_headers` は静的であるため、モデル切り替え時にリクエストごとのヘッダーが古くなるため)、`hermes-plugin/__init__.py`(Python プラグイン:`llm_request` ミドルウェアによるリクエストごとのヘッダー、最大出力およびホストのモデル別コンテキストウィンドウ — hermes 自身の `HERMES_HOME/context_length_cache.yaml` から読み取り、ミス時は fail-open(#3261)— `pre_api_request` フックで捕捉)— 他のクライアント統合も同じプロトコルに従うべきです。 + +**DSH の `maxOutput` 報告は宣言にゲート制御されています — 宣言されていないカスタムモデルは、全体の上限チェーンを空にします(#2904)。** `src/agent/dsh-native.ts` は、ホストの `resolveModelInfo(provider, model)` が正の `defaultMaxTokens` を返す場合**のみ** `maxOutput` を転送し、DSH はモデルアイテムが明示的に `maxTokens` を宣言した場合**のみ**それを設定します — プロバイダーレベルの出力デフォルトは決して報告されません。宣言された `maxTokens` を持たないユーザー追加のカスタムモデルの場合、`defaultMaxTokens` は `undefined` となるため、両方の runtime-info チャネルが空になります。models.dev エントリがなく、bili 設定の `output` もない場合、4ソースの上限チェーン(#1840)は何も解決せず、`restoreOutputBudget` はクライアントで枯渇した予算をセッションのハイウォーターマークまで引き上げます — これは長いセッションでは、小さな正の値を経て汚染された低い値まで減衰しています。その結果、すべてのターンが推論のみで実行され、`length`/`max-tokens` で停止します。既知の上限を持つモデルに切り替えると、これが隠蔽されます(ハイウォーターは上限までフロアアップされるため)、したがって切り替えはトリガーであり、原因ではありません。真の修正箇所は **DSH 側**です:`undefined` ではなく、設定されたプロバイダー/モデルの出力デフォルトを報告すること(即座のユーザー回避策は、モデルアイテムに `maxTokens` を設定することです)。bili は意図的にクォータのフロアを推測しません(#1842)。代わりに #2904 は、`/acp` パネル、Web UI のセッションページ(データソース `/__bili/sessions//detail`)、および `/__bili/plugin/status?conversationId=`(`outputBudgetDegraded`)に、劣化状態を永続的に表示します — 健全な値または上限が到着すると自動的にクリアされます — さらに `degenerateTurnWarning` を `length`/最大出力終了に拡張し、ログ内で切り詰めがその原因と相関付けられるようにします。 + +**omp: OMP の Cowork トランスポートが出口を所有している場合、`prompt_cache_key` のスタンプは保留されます(#2583/#3556)。** ネイティブ omp モードでは、スタンプされた `prompt_cache_key` がリクエストごとのセッションシグナルの唯一であり、その唯一の消費者は bili 自身のフェッチレイヤーインターセプターです(モデル URL を `/bili/` に書き換え、転送前にフィールドを削除します)。最近の OMP ビルドには "Cowork transport" が同梱されています(2026-07-30 に導入、can1357/oh-my-pi `642892ae`;プロキシ処理 `e22a5ff2`)。これはデフォルトの `anthropic`/`anthropic-messages` リクエストを node:https を介して直接送信します — 明示的なプロキシ環境変数(`PI_PROXY` / `PI_PROXY_ANTHROPIC`)がそれらを Bun の fetch に戻さない限り、`globalThis.fetch` に触れることはありません。#3556 以降、`bili omp` ランチャーはこのギャップを自ら閉じます:ユーザーが `PI_PROXY` / `PI_PROXY_ANTHROPIC` を設定していない限り、`PI_PROXY_ANTHROPIC=` をエクスポートするため、デフォルトのランチャーレーンでは Cowork が直接ダイヤルするのではなく、圧縮可能なレーン(スタンプされたキーがプロキシによって消費され削除される)に乗ります。この保留はまた、証明書 MITM レーンにもゲート制御します — #3556 はそれを宛先ルーティングチェックの上に持ち上げましたが、ネストされた配置ではそれが完全にスキップされていました。そこでスタンプすると、フィールドがそのまま Anthropic の厳格なスキーマに乗ることになります(HTTP 400 `prompt_cache_key: Extra inputs are not permitted`)。スタンプゲート(`src/agent/pi.ts` の `stampPromptCacheKey` → `ompCoworkTransportBypassesFetch`)は、OMP 自身のモデル別出口選択を反映しています:プロブンドirectなトラフィックはスタンプされず、プロセスごとにモデルごとに1回の大きな警告が出ます。結果として、これらの直接リクエストはプロキシに対して非圧縮かつ匿名で送信されます(ID/パネル/課金の劣化 — #1403 と同じトレードオフ);他のすべてのレーン(ランチャー `/bili/` 書き換え、MITM ホワイトリスト、他のプロバイダー/API、プロキシ設定ホスト)は変更ありません。既知の残存問題:モデルホストに一致する `NO_PROXY`/`no_proxy` ルールは、`PI_PROXY` / `PI_PROXY_ANTHROPIC` が設定されていても OMP のプロキシ処理を無効にします — その場合、リクエストはスタンプされたまま直接ダイヤルします(同じ 400 クラス);代わりにそのようなホストを `NO_PROXY` から削除してください。逆の非対称性は fail-safe です:OMP の形状ベースのフェッチフォールバック(Request オブジェクト入力、非レコードヘッダー、非サポートボディ)は、プロキシ環境変数がなくても `globalThis.fetch` にルーティングされ、そこで保留されたスタンプは ID を劣化させるだけで、ハードフェールすることは決してありません。完全なカバレッジにはホスト側の変更(Cowork の出口を `globalThis.fetch` 経由にルーティングする)が必要です — #2583 の境界注記を参照。 + +ランチャー環境変数ティアは、純粋なプロキシクライアント(インプロセスプラグインなし)をカバーします: +`bili ` は起動時にクライアント自身のモデル設定を読み取り(codex の場合は `model_context_window` / `model_max_output_tokens`、pi / omp の場合は `contextWindow` / `maxTokens`、opencode の場合は `limit.context` / `limit.output`、codebuddy の場合は `maxInputTokens` / `maxOutputTokens`)、`BILI_LAUNCHER_MODEL_WINDOWS` / `BILI_LAUNCHER_MODEL_MAX_OUTPUTS` を介してプロキシに引き渡します(#971)。プラグイン報告が存在する場合、常にこれよりも優先されます。 + +最初のモデルリクエストの前にセッションはまだ存在しないため、`/acp` パネルは `GET /__bili/plugin/status?conversationId=&fallback=latest` をプローブし、404 ではなくランタイムテーブル(`phase: "pre-first-request"`)から応答します — 報告された設定はすぐに可視化され、トラフィックが着地すると実際のセッションが引き継ぎます。 + +## Claude ネイティブ姿勢 (#964) + +Claude Code にはインプロセスの拡張ポイントがないため、`bili plugin install claude` は `~/.claude/settings.json` に管理ブロックを書き込みます(環境変数 `ANTHROPIC_BASE_URL=http://127.0.0.1:/bili/`、`DISABLE_AUTO_COMPACT=1`、および `SessionStart` フック)、さらに以前と同じユーザースコープの MCP シェルを追加します。フック(claude の最初のモデルリクエストの前に発火)は、すべてのレーンと同様にポートを解決します(#1660):明示的なピン(`BILI_CLAUDE_NATIVE_PORT` > 設定 `claude.nativePort`)は、その正確なポートで**strict-port** を起動します(占有者は明確に拒否され、#964 が保持されます);それ以外の場合は、自己管理ゾーンに乗ります — レーンのスティッキーレコード、なければベース `18787` — 非 strict で、子プロセスの EADDRINUSE +1 ラダーが競合を解決し、決定したポートがスティッキーとして記録されます。ラダーに対する1つの例外(#1723):レーンのポートの保持者が、**異なるビルド**を実行している同じレーンのインスタンスである場合(アップグレード再起動の重複 — 旧バージョンがまだドレイン中)、子プロセスはそれが解放されるのを待ち(最大5秒)、ドリフトする代わりに*同じ*ポートを再バインドします;決して離れない保持者は待機を使い切り、以前と同様に通常のラダーを取得します。プロキシが起動した後、フックは各セッションで管理対象の `ANTHROPIC_BASE_URL` をライブオリジンに再ピンします(`repinClaudeManagedBaseUrl`)、そのためポートがホップしても次の起動時に自己修復され、焼き込まれた URL が実行中のプロキシからデシンクしたままになることはありません。アップストリームオーバーライド:`BILI_CLAUDE_UPSTREAM`(または既存の `claude.anthropicBaseUrl` 設定)。インストールはもはや `claude.nativePort` を永続化しません。`BILI_NATIVE_CLAUDE=0` でオプトアウトできます — その場合、フックは同じ解決ポートで**passthrough** プロキシを起動します(そのまま転送、圧縮オフ)ため、claude は引き続き動作します。ブロックは純粋な JSON マージ/ストリップです:外部キーは決して触れられず、`bili plugin remove claude` は正確に復元します。ネイティブブロックがインストールされたマシンでも `bili claude` は引き続き動作します — それは静的な URL を自身のプロキシでオーバーライドし、フックは休眠状態のままです。 +## 注入優先順位 — 避ける限りファイルは使用しない (#535) + +bili はユーザーデータを所有しません。起動されたクライアントはすべて**実際のホームディレクトリ**で実行されるため、ランタイムの書き込みはユーザーが期待する場所に保存されます。クライアントをプロキシに向ける際、ランチャーは優先順位に基づいて選択します。**まず環境変数**(hermes/dsh/codex 用のプロキシ/CA 環境変数、pi/omp 用の `BILI_PROVIDER_REWRITES` URL マニフェスト。これはロード時にそれらの拡張機能の `registerProvider` によって消費されます)、次に**CLI フラグまたは拡張機能 API**(codex の `-c key=value`、opencode プラグイン)、そして**最後に生成ファイル**です。現在、生成ファイルとして使用されているのは opencode の一時 `opencode.json`(終了時に削除される)と dsh のループバック例外のみです。dsh のフェッチスタックはループバックターゲットに対してプロキシ環境変数を無条件にバイパスするため、ローカルアップストリームは、dsh が設定パスの環境変数やアップストリームループバックのオプトアウト機能を獲得するまで、永続的な `~/.dsh-bili` オーバーレイ書き換えを維持します。旧バージョンによって作成されたオーバーレイディレクトリはそのまま放置され、実際のホームディレクトリにマージされることはありません。 + +## 2つの圧縮モード — `compress` を実行するのは誰か + +プロキシは2つのモードのいずれかで動作し、**モードが `compress` の実行者を決定し、それが要約がモデルにどのように伝達されるか(「キャリア」)を決定します**。この区別は #377 の根本原因です。 + +| | **ランチャー / プラグインモード** (`bili pi`, `bili codex`, …) | **プロキシモード** (プレーンクライアント → `/bili/`) | +|---|---|---| +| クライアント | bili 拡張機能を備えた ACP ネイティブエージェント (pi/omp) | 拡張機能なしの任意の OpenAI/Anthropic クライアント | +| `compress` の実行者 | **エージェント** (pi はローカルで実行) | **プロキシ** (サーバーサイドの圧縮ループ) | +| 再送信履歴内の `compress` ツールコール? | はい — エージェント自身の会話の一部 | いいえ — 一時的なプロキシループのトラフィック | +| プリフライトブロック (ツールコールなし)? | 最終手段のバックストップ — エージェントは通常、自身の `compress` コールで圧縮しますが、入力単体でウィンドウを超える場合 (#470) には両モードで `src/preflight.ts` が発火します | はい — `src/preflight.ts` がクライアントの背後で圧縮を実行 | +| **ワイヤー上の要約キャリア** | **`compress` ツールコール** | **`acp_summary` ユーザーメッセージ** | +| ワイヤー上のシステムメッセージ | 常にちょうど1つ (クライアント + プロンプト) | 常にちょうど1つ (クライアント + プロンプト) — 要約はユーザーメッセージに乗る | +| SGLang "単一システム" 400 (#377) | 発生しない | 発生しない (要約はユーザーメッセージであり、システムではない) | +| プロキシが注入する `compress` ツール | なし — エージェントは4つの ACP ツールをネイティブに登録 | 4つのコンテキストツール (有効化されている場合) | +| プロキシが注入するナッジ | **はい** — エージェントには独自のナッジチャネルがないため、プロキシ側のナッジが能動的な圧縮トリガーになります (プリフライト単体ではハードリミットでのみ発火; #451) | はい (有効化されている場合) | + +**キャリアが異なる理由。** プラグインモードでは、エージェントが圧縮を所有します。`compress` コールとその結果はエージェント自身の履歴に存在し、ターンごとに再送信されるため、要約はツールコールに乗ります。これにより、エージェントのビューはカーネルの `acp_summary` フォールバックをレンダリングしません (`billion-context-pi` の `src/messages.ts` は `acp_summary_*` をスキップします)。プロキシモードでは、クライアントは ACP ネイティブではないため、プロキシがサーバーサイドで `compress` を実行します。ツールコールはクライアントの履歴に入らず、プリフライトブロックにはツールコール自体が存在しないため、カーネルの `acp_summary` メッセージが唯一のキャリアとなります。カーネルはこれをロール `system` としてレンダリングしますが、厳格な OpenAI 互換バックエンド (SGLang) はインデックス 0 にちょうど1つのシステムメッセージを要求するため、`systemToUser` (`src/util.ts`) がこれを `user` メッセージとして再表現し、アンカー位置に留めます。これにより、ヘッドのシステムメッセージ (プレフィックスキャッシュのアンカー) が圧縮ターン間でバイト単位で安定し、新しいブロックが会話全体のプレフィックスを無効化することがなくなります。 + +**なぜ `user` であり、`system` や偽造ツールコールではないのか。** ストリーム中の `system` メッセージは SGLang が拒否するものです (#377)。偽造された `compress` ツールコールは「純粋な」キャリアですが、プロキシモードでは ID によってアシスタントの `tool_calls` と `user` の `tool_result` のペアを捏造し、リクエスト内でツールを宣言し、本物のコールを持たないプリフライトブロックを処理する必要があり、単独のノートを再表現するよりもはるかに侵入的です。`user` メッセージは会話のどこにでも許可されるため、SGLang の単一システムルールとプレフィックスキャッシュの安定性を両立させるための最小限の変更です。受け入れられたトレードオフ: 要約は折り畳まれた履歴の代わりであり、それをユーザーターンとして再表現することは意味論的な不一致ですが、モデルはこれを許容します (明確に `[Compressed conversation section]` とマークされています)。 + +**2つのモードは共存できるか?** + +- **同じプロキシインスタンス: はい、設計上可能です。** 1つのプロキシがプラグインクライアントとプレーンクライアントを同時に処理します。`pluginMode` はリクエストごとに決定され (`x-bili-plugin` ヘッダー)、セッションごとにバインドされます (`session.metadata.pluginAgent`)。ランチャーは実行中のプロキシを再利用します。 +- **同じセッション: モードはスティッキーです。** プラグインモードで作成されたセッションはプラグインモードのままです (メタデータ継承)。プレーンセッションは、一致する会話 ID を持つプラグインリクエストが届いた場合のみ、プラグインモードに*アップグレード*できます (ヘッダーが優先されます) — ダウングレードされることはありません。実際には、プレーン→プラグインのアップグレードには、プラグインクライアントの会話 ID が既存のプレーンセッション ID と一致する必要がありますが、これは発生しません (各クライアントは独自の ID を生成するため)。 +- **モード間ブロックの危険性: 理論上のみです。** 同じ会話 ID がモード切り替えにまたがる必要があります。プラグイン→プロキシは安全です (ツールコールは共有履歴にあります)。プロキシ→プラグインでは、プロキシが作成したブロック要約が孤立する可能性があります (そのツールコールはエージェントの履歴に存在せず、エージェントのビューは `acp_summary` をスキップするため) — しかし、上記の ID 一致が必要であり、それは発生しません。 + +**圧縮が実際に実行されたことの検証。** `compress` を実行した後、プロキシは確認マーカー (`📦 [ACP] Compressed …`) をプレーインのアシスタントテキストとして出力します — しかし、持続的なコンテキスト圧力下では、モデルがツールを一度も呼び出さずに*そのマーカー形式を自分で書き込む*ことが観察されました (#717): 実際の使用率が 89% に上昇する間、約2時間で17回の偽の「圧縮」がありました。したがって、トランスクリプトに表示されるマーカー行は永続性の証明ではありません — 信頼する前に `acp_status` (ブロック数の増加、圧縮可能範囲の開始位置の前進) で検証してください。バックストップとして、プロキシはモデルが独自に出力するマーカー形状の行を除去し、`[marker-echo]` 警告をログに記録します。また、ナッジと注入されたプロンプトの両方が、マーカーはプロキシのみが出力するものであることを明示的に述べています。 +### モード切替は Responses 投影を変更する — 帰属はホストを責めてはならない (#2867) + +Responses レーンでは、2 つのモードは履歴中間の `system`/`developer` アイテムを異なる方法で投影する: プラグインモードはそれらをその場で保持する (`__bili_inplace_sysdev`, #1638 のプレフィックスキャッシュ変動修正) — #3227 以降、ネイティブプロキシモードの Codex クライアントも同様である (`isCodexClient` による UA 検出); その他のプロキシクライアントは、先頭の developer ブロックへのホイスティングを維持する (#1085 のホイスティングとアンカリング)。したがって、セルフヒールによるプロキシへのデグレード (#2155) は、**同一**の受信履歴を異なる転送バイトに再投影する — ホストが何も変更していないにもかかわらず、転送システムフィンガープリント (#2350) が反転し、素朴な台帳はそれを「ホストがシステムプロンプトを書き換えた」として計上してしまう。 +修正: 台帳は現在、投影フィンガープリント (`systemFp`) を、生受信 system/developer ストリームのモード非依存の**正規化**フィンガープリント (`canonicalSysFp`, ロール + コンテンツ + 順序、投影前のキャプチャ) とペアリングする。決済時: 投影が反転し正規化が安定 → 原因は `projection` (独自の次元: `pf` フラグ、`projSwitches` カウンター、コールドウィンドウ、レポートセクション — プロキシ自身の所为); 正規化も変更 → 原因は `prompt` (ホスト側の真の書き換え、#2350 の意図どおり); 正規化のみ変更 (例: プラグインモード中の履歴中間編集、これは先頭ブロックには触れない) は、請求バケットなしで観測的に記録される (`cf`)。不明な正規化側は分類されない (レガシー読み取り)。各サンプルはさらにそのモード (`pm`) を保持し、prepare-responses は理由 (セルフヒールデグレード / リストア / ヘッダー欠如) を伴う 1 行の遷移ログを出力する。記録されるのはハッシュ、長さ、モード、理由のみであり、プロンプト本体は決して記録されない。ワイヤ上の挙動は変更されていない: 両方の投影は以前と全く同じままである; 切替は誤帰属されるのではなく、*記録*されるようになった。 + +## `/bili/` チャネルは直接アドレス可能 — ホストフックがミスした場合のフォールバック (#5907) + +ネイティブレーンの引き継ぎは、ホストプロセス内の `globalThis.fetch` をパッチし、モデル URL を `{proxy}/bili/{original-URL}` に書き換えることで機能する。そのパッチがカバーするのは正確に 1 つのこと: 現在のグローバル fetch を通じた呼び出しである。プラグインインストール前に fetch リファレンスをキャプチャしたモデルクライアント、非 fetch トランスポート (undici ディスパッチャー、生 http、WebSocket) を使用するクライアント、または別の JS レalm またはプロセスでターンを実行するクライアントは、パッチを完全にバイパスする — そしてバイパスは**構造上**不可視である: リクエストはプロキシに到達しないため、そのターンについて bili.log に何も表示されない (セッションなし、転送なし、ゲート拒否なし)。サードパーティによる代入ベースの置換は異なり、**無音ではない**: #1158 以降、ガード付きアクセサはすべての外部インストールをログに記録し、それを下流として再チェーンする (16 回を超えるインストールはログ上限; ルーティング権限は決してガードを離れない)。ホストプロパティが非設定可能である場合、または `BILI_RECLAIM_FETCH_PATCH=0` の場合、代わりにクラシックな直接インストールが適用される — その姿勢は現在、リスクと `/bili/` の救済策を名指しする 1 回限りの警告をログに記録する (#5907)。 + +`/bili/{absolute-upstream-URL}` は単なる URL プレフィックスであるため、ベース URL を制御できる**任意**のクライアントが直接それを使用できる — フックは不要である。プロバイダの `baseURL` を `http://:/bili/` に設定することは、リモートエージェントのサポートされる形状 (configuration.md, `host`) であり、レーンのフックが明らかにターンをミスした場合の推奨フォールバックである: 圧縮、請求、ゲート拒否、ログ記録はすべて同一に適用される。なぜなら、それはフックが書き換えるのと同じチャネルだからである。注意: 直接クライアントはプラグイン帰属ヘッダーを持たないため、そのセッションは匿名 (`pfa-*`) チェーンに配置され、帰属のないトラフィックと同様にウィンドウ解決ラダーによってサイズ決定される (#5907)。 + +## Responses ネイティブチェーンリングはサポートされていない — 履歴は再生されなければならない (#1954) + +Responses ワイヤアダプタ (`src/server.ts` の `prepareResponses`、`src/loop/adapter-responses.ts` の `buildRequest`) は**ステートレスな再生圧縮器**である: それは `parsed.input` を*完全な*会話として扱い、それを圧縮し、その後 `ACP_KEEP_RESPONSE_ID=1` がない限り `previous_response_id` を破棄する。レスポンス系譜ストアを保持しないため、ネイティブチェーンリング継続が参照する履歴を**マテリアライズできない**。 + +OpenAI のネイティブチェーンリング (`store:true` + `previous_response_id`、サーバー保持履歴) と bili のクライアント再生モデルは、相互に排他的なパラダイムである。したがって、デルタのみの継続 (新しいターン + `previous_response_id` のみ、完全な再生なし) は、**参照も参照されたターンも**上流に到達する — 以前のコンテキストは上流で静かに失われるが、リクエストは依然として 200 を返す。それが #1954 の背後にあるメカニズムである。 + +**ここで出荷されるもの (アプローチ A — 可視性のみ)。** 空でない `previous_response_id` が除去された場合、両方のパスは現在、その id を名指しし、結果を述べる `warn` を出力する。トリガーは明示的な `store:true` ではなく、id **単独**に基づいている。なぜなら Responses はデフォルトでレスポンスを保存するため、`store` が省略されていても参照されたレスポンスは上流で解決可能であり、`store` で判断すると一般的なケースを見逃すからである。アプローチ A は転送バイトを変更せず、何も閉じない: デルタリクエストは依然として履歴を失い、依然として 200 を返す。それは単に、損失が無音であるのを止めるだけである。 + +**観察であり、証明ではない。** 現在のビルド/テストでは、codex は `store:false` を送信し、`previous_response_id` を決して設定しないため、これは codex にとって*今日*は何もしない (no-op) である。それは既存の E2E + トラフィックからの観察であり、クライアントが決してチェーンリングしないことの証明ではない — E2E はデルタチェーンリングの形状をカバーしていない。codex はネイティブでチェーンリングをサポートする Responses API に対する OpenAI 自身の CLI であるため、トークンを節約するためにネイティブ継続に切り替える将来のバージョンは合理的な進化である; それまでこれは潜在的な高重大度ギャップのまま留まる。 + +**今日のチェーンリングクライアントのための安全なオプション:** 完全な入力/出力履歴を再送信する (bili は通常通り圧縮/転送する)、または id を保持するために `ACP_KEEP_RESPONSE_ID=1` を設定する — しかし KEEP の下では、参照された履歴はサーバー側に存在し、bili の圧縮/プレフィックスキャッシュ会計はそれを見ることができない。真の修正 (圧縮前に系譜をマテリアライズする) は機能 #1973 として追跡されている。公式移行ガイド: https://developers.openai.com/api/docs/guides/migrate-to-responses +## シングルライター: どのコピーを誰が所有するか (#991) + +マシン上の各 bili の存在には、ちょうど **1 つのライター**(書き手)しか存在しません。インストールしたものが更新も行うものであり、他の何ものもそのコピーをインプレースで上書きすることはありません: + +| レーン | コピーの保存場所 | 更新元 | +|------|---------------|------------| +| グローバル `bili` | npm グローバル (`npm i -g billion-context`) | `bili update` / バックグラウンド自動更新 | +| **pi** | pi のパッケージマネージャー (npm 形式) | **`pi update`** — bili は決して上書きしません | +| **opencode** | opencode のプラグインディレクトリ | **opencode のプラグインマネージャー** — bili は決して上書きしません | +| **dsh** | 各プロファイルの pnpm ストア | 定期チェックにより、プロファイルごとに dsh のプラグインチャネルが再実行されます — グローバルの bili 自己更新によって駆動される **または**、グローバルが実行されていない場合はプロファイルコピー自身のプロキシによって駆動されます (dsh-market インストール, #1196); 手動: `dsh plugin add billion-context@latest`. pnpm のハードリンクストアは決してインプレースでコピー上書きされてはなりません | +| omp / claude / codex / kimi / zcode | コピーなし — エントリはグローバルの bili インストールを指す | グローバルコピーとともに更新される | +| **hermes** | `~/.hermes/plugins/billion-context/` (コピーされたファイル + グローバル dist を指す `bili.json` サイドカー) | **`bili plugin update hermes`** がファイルを再コピーする; サイドカーはグローバルインストールを追跡する | + +これは単なる慣習ではなく、コードで強制されています: 自己更新プログラム (`src/update.ts` → `hostManagedInstall`) は、pnpm 仮想ストア (`.pnpm`) またはホストエージェントツリー (pi / opencode / dsh / kimi / omp のホーム) 配下のインストールディレクトリを検出し、それらを **スキップ** します; `installViaTarball` は構造的にそれらを拒否するため、直接の呼び出し元がストアを破損させることもできません。*コマンド* の混在は問題ありません (`dsh plugin add` ≡ `bili plugin install dsh` — 同じチャネル、同じレコード); ガードが禁止しているのは *ライター* の混在です。`bili plugin update [client]` は、各レーンをその所有者を通じて駆動し、レーンごとの更新パスを表示する唯一のコマンドです (`bili plugin list` は同じレーンごとのチャネルを表示します)。 + +## ストックセッションの自己修復 — 検出定数と対策 (#2155) + +3 つの障害形態は、`src/session-self-heal.ts` 内の 1 つの検出器ファミリーを共有し、リクエストごとに 1 回評価されます (`prepare` の後、ナッジを運ぶレーンのみ; バイパスおよびサイドレーンは決してクレジットを得ません): + +- **D2 ゾンビプラグインレーン** — プラグインがアンインストールされた (またはその MCP 子プロセスが死んだ) にもかかわらず、すでに開かれているクライアントウィンドウがセッションをプラグインバインド状態に保っている場合 (スティッキーな `metadata.pluginAgent`, `src/server.ts`)。シグナル: 5 連続のラウンド (`SELF_HEAL_WINDOW`) がナッジされ、`x-bili-plugin` ヘッダーを **持たず**、ワイヤー上で bili ツールを **宣言せず**、圧縮削減を **生み出さなかった** こと。対策: **プロキシモードへデグレード** — 単一の `pluginMode` フリップ (`pluginAgent !== undefined && !pluginLaneDegraded(session)`) が ACP ツールのワイヤー側注入を再実行し、コンプレッションリライター、CCR スタンピングおよび吸収を再アームし、**ナッジを保持** します (ツールが戻ってくるため)。ワイヤー注入が利用できない場合 (`compress.injectTool=false` → `degradeAvailable` が false)、対策は **ナッジ抑制** にフォールバックします。回復: ライブなプラグインヘッダー (`pluginLaneRestore`, `pluginMode` フリップの前にホイスティングされるため、最初のヘッダー付きリクエストはすでにプラグインモードである — スティッキーな `pluginAgent` を回復シグナルとして使用してはならず、そうするとデグレードがアームされた 1 ラウンド後にクリアされてしまう)。バインドは保持され、決して消去されません。 +- **D1 ナッジアイドル** (非プラグインの一般化) — 5 連続のナッジされたラウンドで、削減がゼロかつ bili ツール使用がゼロであること。「ナッジされた」とは、テキストが実際に注入されたことを意味します — #3004 以降、デシードゲートの判定が配信の事実です (`prepared.nudgeOutcome === "injected"`); 否決されたアームはアイドルストリークにクレジットを与えません (ゲート前の式は、モデルが受信しなかったチャネルで抑制をアームしていました)。対策: 4 つすべての `willInjectNudge` ゲートでナッジを抑制します (`&& !nudgeSuppressed(session)`、緊急パスもカバー)。2 つの境界が、抑制が永久にラッチされるのを防ぎます (#3004): デシードラダーのフォールバックエスケープは、抑制中でも 1 つのレガシーアドバイスを突き抜けて実行します (障害回復パスは抑制より優先順位が高く、`consumeFallback` がカウンターをリセットする)、そしてラッチはアームから `SELF_HEAL_SUPPRESS_CAP_MS` (10 分) のウォールクロック後に期限切れになります — その後再アームするには、新しい完全な `SELF_HEAL_WINDOW` のアイドルラウンドのコストがかかります。回復: いかなる圧縮削減または bili ツール使用でも、抑制を早期に解除します。 +- **D3 ゲートウェイ殺害されたサマリー** — HTTP 524/504 (Cloudflare クラス) で死んだ **非ストリーミング** のプリフライトサマリーは、インプレースで再試行されません (古い一時的な再試行パスは、死んだゲートウェイに対して試行ごとに約 100 秒を消費していました); 代わりに、セッションは **最初の** ヒット時に `metadata.preflightStreamSummary = true` を学習し、サマリーは SSE として再要求されます — 手動の `compress.streamSummary` ノブ (#2133) と同じ学習ストアで、自動アームされます。カスケードは両方向で尊重されます: どこでも明示的な `streamSummary: false` (グローバル → プロバイダー → モデル) はオペレーターのオプトアウトであり、どちらの学習パスもアームせず、古い学習フラグは無視されます (`PreflightDeps` 内の `streamSummaryOff`)。 + +観測可能性: `session.metadata.selfHeal = { detected, action, since }` は `/__bili/sessions` で公開され、Web UI でバッジ表示され ("heal")、すべての遷移で 1 行の `[self-heal]` ログ (検出 + 回復) が出力されます。`bili plugin remove ` はベストエフォートでライブプロキシをクエリします (インスタンスファイル → `GET /__bili/sessions`、2.5 秒タイムアウト、失敗時はサイレント) であり、そのクライアントのセッションが直近 **10 分間** でアクティブだった場合に注記を表示します。 +## 劣化ダイレクトフォールバック — 拒否、自己修復、アナウンス (#4516, #3304, #2924, #4079) + +ネイティブレーンのプロキシが利用できない場合、モデルトラフィックはダイレクト送信 (`directSendOrRefuse`, `src/agent/native-intercept.ts`) にフォールバックします。このパスは劣化モードであり、すべてのレーンで共有される3つの契約があります(ゲートレスレーン pi/omp/opencode-V1 は #4516 以前これらを持っていませんでした — 1.06M トークンの生履歴がそのままプロバイダーに送信されていました): + +- **サイズアーム** — いかなる劣化送信の前にも、ボディは dsh のゲートと同じ doom 計算 (`bodyProvablyOverWindow`) で価格付けされます。ステージ1は生バイトフロアとウィンドウの比較、ステージ2は構造的メディアバイトの除去です(#4111 の方向性: コアテキストが収まるメディア中心のボディは拒否されない)。基準は `MIN_ASSUMED_WINDOW_TOKENS` (1M, #4079 — 宣言されたウィンドウが誤って小さくなることがある) 未満のウィンドウを仮定しません。その帯域のボディはプリフライトに委ねられます。データ欠如(`x-bili-plugin-context-window` ヘッダーなし、ボディ読取不能)はダイレクト送信に対して OPEN に失敗します — ローカルガードは自身の無知によって誤ってブロックしてはなりません。判定: 422 `x-bili-gate: oversize-refusal-fallback`、リトライ可能、アップストリーム方言に従ったワイヤー形状、メッセージはフロア/コア/ウィンドウと利用不能理由 (`bootstrap-failed` vs `dead` — 後者はレーンがオリジンを持っていたが失った場合のみ) を示します。 +- **自己修復** — ブートストラップ失敗はもはやプロセス生存期間中のダイレクト送信を意味しません。ライブオリジンが見つからない各リクエストは、15秒のクールダウンの下でオーナーの `respawn` を発火します(singleFlight — 並行リクエストは1回の試行を共有)。その後、`state.spawnWaitMs ?? readyTimeoutMs ?? 15_000` 以下のインフライト試行を待ちます: pi スパウンレーンは `SPAWN_BUDGET_MS + 10 s` を設定するため、遅いコールドスタート (#4515) は一般的な上限で拒否されるのではなく、待たれます。回復にはホスト再起動は不要です。 +- **アナウンス** — 劣化状態への/からのすべての遷移は、リクエストごとに1行ではなく、bili.log に1行(プロキシ回復 / ダイレクト化 / 拒否)をログ出力します。`state.lastUnavailableReason` は拒否文言に WHY を保持するため、ユーザーは「まだ起動中」と「死んだ」を区別できます。 + +opencode V2 リゾルバーレーン (`createLiveOriginResolver`) は独自のプローブ駆動リトライを維持します。この契約は、それらがカバーしないプレーンインターセプトパスを対象とします。パネルへの帰属レポートは引き続き dsh のみです(#4516 参照)。 + +## 統一 ACP タグエコー是正 — 4つの不変条件 (#2023/#2066/#2190/#2248) + +1つの PR が3つの是正脚(refs-run 残留 #2023、退化クローズ除去 + 出口監査ネット #2190、出力ドロップ + 署名付き思考の逐語 #2066)を、すべてのテキスト書き換えサーフェス(ループアダプター、プラグインパススルー、JSON 除去関数、終了監査)を支配する単一のハードルールセットの下に統合します: + +1. **思考チャネルはバイト逐語です。** Anthropic `thinking`、Google `thought`、OpenAI `reasoning_content`/`reasoning`、および Responses 推論サマリーはそのまま乗ります — エコー形状の推論も含みます。根拠: 推論リプレイ(DeepSeek スタイル)と署名検証はこれらのバイトを検証します。書き換えはそれらをデシンクさせ、セッションを壊します (#1960/KDD#10)。アダプターはこれらのフィールドを `createIdentityStreamFilter` 経由でルーティングし、除去関数 (`stripOpenaiChatText`, `stripResponsesText`) はそれらを無変更のままにします(ディフェンシブインディプス)。注: これは #1881 以前の推論エコー除去を逆転します — 思考チャネルはもはやクリーニングされません。 +2. **モデル散文は管理可能です。** レンダリングタグエコー、マーカー行、bili 内部テキスト、退化オープン/クローズ残留、および(吸収指示がある場合)ツールコール出力全体は、可視テキストチャネルからのみ除去されます。 +3. **ファイル宛のモデル出力はバイト同一です (#1039)。** ツールコール引数は、どのようなバイトを持っていようとも、いかなるフィルターにも入らない。 +4. **ユーザー送信バイトは決して書き換えられない。** ユーザー自身のフラグメントの逐語エコーは、除去が武装していても生存します (#463 免除、形状ではなくリクエストテキストにキーされる)。 + +出口監査ネット (#2248) はログのみのままです: 生出口(未認識フレーム、解析失敗)はそのまま転送され、`[tag-echo] raw exit` をログ出力することで、ワイヤーを変更せずに新しいリーク形状が可視化されます。`tests/unified-acp-invariants.test.ts` (8つのテスト、両レーン) で固定されています。 + +## キャッシュ台帳の累積はカバレッジ条件付き (#2202) + +台帳は各リクエストを経過した各フォールドに対して記録します(サンプルごとに `requestsAfter += 1`)、パネルはそのカウンターを `netSaved = Σ (S − σ) × requestsAfter` に変換します。記録は*このリクエストがフォールドから利益を得たという主張*であり — これはフォールドのカバレッジバイトが実際に再送信ワイヤーに乗っている間のみ真です。ホストが bili の知識の外でそれらを削除した場合(dsh ネイティブコンパクト、#2193)、古いカウンターは破壊された基盤の上で上昇し続けました: #2193 インシデントでは、1510 のカバレッジ ID が永久に消えたにもかかわらず netSaved が 355M を示していました。 + +修正はライター側、主張サイトにあります: `reconcileFoldCoverage` はすでにこの証拠のためにすべての受信パスを検査するため、今後はブロックごとの存在を `session.metadata["foldCoverageByBlock"]` に記録します — ブロック ID ごとに `{p, r, t, e}`(逐語存在 / リアンカー経由で回収 / カバレッジ総量 / かつて存在したラッチ)。台帳は各フォールドをブロックにスパースな `LedgerFold.bid` でリンクします(`recordCacheFoldsFromBlocks` で一度だけ設定、イージープロキシパスとレイジープラグインモードパスの両方の唯一のチョークポイント)、そして測定された割合 `(p + r) / t` で増分をスケーリングします: + +- **1** — 完全カバレッジ、または使用可能な記録なし → #2202 以前のカウンターとバイト同一(健全なセッションとすべてのレガシーエントリ); +- **f** — 部分カバレッジ → 比例累積; +- **0** — カバレッジ喪失が検証済み → カバレッジが戻るまで累積凍結。 + +2つのクラスは `e` ラッチによって自己校正されます: カバレッジ ID が*かつて*存在として見られたフォールドは検証可能であり、完全な不在は喪失を意味します; 作成後に ID が*決して*出現しなかったフォールドは構造的に検証不可能です(生オリジナルではなくフォールドビューを再送信するビューフォールディングホスト)であり、静かにゼロにされるのではなく、現状維持の記録を維持します。カバレッジ喪失はライブ計算されます (`e === 1 && p + r === 0`)、そのためスティッキー状態なしで回復が累積を再開します; 1つの warn/info ログがフリップごとに発火します (`foldCoverageLostLogged` 重複排除キー)。 + +証拠衛生は #1195 ガードを反映します: サイドリクエスト形状のパス(受信メッセージ < 10 — タイトル生成、WebSearch 洗練)は証拠を一切取得しません(記録なし、バックボーンロールなし、ドリフトストリーク移動なし、リセットなし)。短いパスは次のパスの整列を歪め、幻の完全喪失を生み出すためです。 + +パネル表示は喪失したフォールドをヘッドライン数字から除外します: ウェブセッションビューでは、それらを個別のラベル付きセグメントとして表示します(行ツールチップ、概要サブ行、詳細統計) — 喪失前の凍結済み節約は可視のまま、喪失後の成長は停止します。 +## OpenAI チャットワイヤの prompt_cache_key: デフォルトで全箇所にスタンプし、厳格なアップストリームを A/B プローブで保護する (#2218/#2645/#3556) + +dsh プラグインレーンにおいて、ボディキーベースのリレーが読み取れる唯一のアイデンティティシグナルは、チャットボディ内の `prompt_cache_key` です(勝利する会話ヘッダー `x-bili-plugin-conversation` は bili 内部専用であり、その名前で外部に送信されることはなく、ヘッダー読み取り型リレーには `x-session-id` が渡されます)。そこで対立する2つの集団が出会います。**厳格な直接 API** は未知のボディパラメータを 400 で拒否します — 厳格さは同一オリジン内でモデル単位で異なります(#2645: 1つの NVIDIA ゲートウェイモデルはキーを受け入れ、その兄弟モデルは拒否する)— 一方、**アカウントプール**(リモートリレープールを含む)は、そのキーをプレフィックスキャッシュルーティングのシグナルとして読み取ります。そのため、どこかでキーを落としても、それらのセッションのキャッシュアフィニティが静かに劣化します(#1403 の逆パターン)。デスティネーション形状のテストでは裁定できません:ループバック専用のゲート(#2649 の試み)は厳格な API を修正しますが、最大の2つのプール集団(docker-bridge/LAN/VPS/ドメイン名プール)からキーを剥奪してしまいます。 + +決定された設計 = **デフォルトスタンプ + 実証的自己修復(プローブして記憶する)**: + +- スタンプ(`src/session-id.ts` → `resolveRelayAffinityPck`):内部会話ヘッダーが存在する場合 ⇒ すべてのデスティネーションに `` をスタンプ;クライアントが供給したキーは、そのペアがアブレーションされるまでそのまま通過し、その後保持されます(これにより、後のターンで 400 の往復コストを再支払わないようにします)。解析不能なオリジンは失敗オープン(スタンプ維持)になります。設定表面ゼロ — 新しいフィールド、環境変数、CLI フラグはありません。 +- プローブ(`src/server/relay.ts`、#552 互換性ラダーと同じバッファードボディシーム):キーを含むエグレスボディに対する**最初の** 400 で、`prompt_cache_key` を除いた同一ペイロードを一度だけ再送信します。リトライが受理された ⇒ 因果関係が証明された ⇒ プロセスメモリ(`src/pck-probe.ts`)に `origin(+model)` ペアを記憶 — メモリ内のみ、永続化なし、再起動で再プローブ。リトライも失敗した ⇒ このフィールドのせいではない ⇒ リトライを破棄し、元の 400 を無加工で転送し、何も学習しない(400 には多くの原因がある;A/B の裁定のみがアブレーションを許可する)。リクエストごとにプローブは1回のみ。 +- 粒度:origin+model、#2645 で測定された厳格さを反映 — 共有プールオリジン上の1つの厳格モデルは、兄弟モデルのスタンプを維持します。 +- 可視性(オーナー要件):初回アブレーション時に、origin/model、影響を受けるセッション、およびアカウントプールの注意を明示的に示す WARN ログを出力(「このデスティネーションがあなたのリレー/アカウントプールである場合、そのプレフィックスキャッシュアフィニティは劣化する可能性があります」);`acp_status` は現在の抑制リストをセクションとして保持;Web パネルにはセッション付きのバナー(zh/en)を表示;スクリプトは `GET /__bili/status` から `pckSuppressions` を読み取ります。すべてプロセスローカル;再起動でクリアされ、再プローブされます。 +- モード:プラグインレーン(登録エージェント / dsh プラグイン、内部会話ヘッダー存在)のみがスタンプします;プレーンプロキシモードは双方向とも純粋なパススルーであり、バイト単位で不変です。 + +テスト:`tests/issue2645-pck-probe.test.ts`(厳格アップストリームのターン1自己修復、ターン2記憶、寛容プールのプローブなし、汚染アップストリームの 400 転送と学習なし、クライアント所有キーのアブレーション後ドロップ、モデル粒度ペア)+ `tests/issue2218-relay-affinity-signal.test.ts` の書き換え済みマトリクス。 + +### #5079: ポリシー反転 — 自己スタンプはデフォルトで OFF、1つのノブがすべてのワイヤを制御 + +オーナー裁定(#2649 のデフォルトスタンプ裁定を差し替え):このフィールドを含むリクエストを即座に拒否するサービスが**多数**存在し、その集団を事前に列挙することはできない — したがって、要求されない限り bili は独自の `prompt_cache_key` を書き込みません。ゲートは既存の `promptCache.routing` ノブ(`ACP_PROMPT_CACHE_ROUTING`、または Web UI のクイック設定スイッチ)であり、今や両方のワイヤにおける bili 自身の出力を同時に制御します — 新しい設定表面はありません: + +- `"disabled"`(**新しいデフォルト**;認識されないものはすべてここで解析):bili はどこにも独自のキーを書き込みません。このゲートはクライアント供給キーには影響しません — すべてのモードでそのまま転送されます(上記の A/B プローブ&リメンバーは、origin+model ペアが拒否することが証明されたクライアントキーを依然として保持します)。 +- `"auto"`:#5079 以前の動作と完全に一致 — チャットワイヤはプラグインレーンのすべてのリクエストにスタンプし、Responses ワイヤは `api.openai.com` のみで注入します。 +- `"enabled"`:サポートするすべてのレーンでスタンプ/注入(Responses ワイヤ:任意のホスト)。 + +チャットワイヤにおける Bili 所有 vs クライアント所有:プラグインレーンにおいて、バインドされた会話 ID と等しいボディキーは、bili 自身の機構のエコーである可能性があります(クライアントキーが勝利するためのアイデンティティ昇格には、内部会話ヘッダーの不在が必要であるため)、したがって `"disabled"` 下では bili 自身の出力としてカウントされ、剥奪されます;その他の値はクライアント所有として残され、転送されます。Responses ワイヤのミラー:昇格していないアイデンティティ下でセッション ID と等しい明示的なボディキーは bili 所有です(omp/dsh 拡張がスタンプする);昇格アイデンティティはクライアントが供給したことを意味します。 + +アップグレード通知(オーナー要件):`"disabled"` で実行中のインスタンスには、1回限りの通知が表示されます — Web パネルのバナー(閉じ可能、状態ディレクトリの `upgrade-notices.json` にインスタンスごとに永続化)、`acp_status` の行、起動ログ行 — 戻すべき集団(`"auto"`/`"enabled"`)を特定します:workbuddy パネル/ハブなどのリレーや、キーなしでトラフィックがランダムにルーティングされるとプレフィックスキャッシュアフィニティが劣化するアカウントプール。公式 API の直接ユーザーは無視できます。閉じる操作はルーティング値を変更しません。 + +テスト:`tests/issue5079-pck-default-off.test.ts`(解析フォールバック、両ワイヤマトリクス(bili 所有エコー行を含む)、通知モジュール、デフォルトオフ/auto ペアの実プロキシエグレスアサーション)+ `tests/issue2218-relay-affinity-signal.test.ts` の更新済みマトリクス。 + +## 未カバー履歴監査 — 正直な最小判定 (#4331) + +「圧縮可能な範囲が残っていない — コンテキストはすでに最小です」という停止シグナルは、構造的に検証不可能でした:PRE-FOLD OFFER が枯渇したときに発火しましたが(`postCompressTail`、#2404 ピニング)、アクティブブロック範囲の和集合とセッションの参照セットを比較するものは何もありませんでした。ライブ ZCode セッションで、この失敗が大規模に示されました — アクティブブロックにない 138 個の中間履歴参照(約 65K トークン、コンテキストの約 16%)、最大の連続区間は `m00312`–`m00411`(100 メッセージ)、一方レシートは3回連続でグローバル最小を宣言していました。カーネルは、そのようなスパンが提供された場合に見つけることができます(master での再現により検証済み);欠けていたのは、グローバルカバレッジ監査と、最小である場合のみ「最小」と主張する判定でした。 + +設計(`src/uncovered.ts`、ホストサイドのみ、カーネル変更なし): + +- `uncoveredHistoryRuns()`:メッセージ配列を走査し、すべてのアクティブブロックのカバレッジ外(`collectVisible` 述語)のエントリを見つけ、連続区間をグループ化し、各区間を分類します:現在のオファーが一部をカバーしている場合はスキップ(モデルは今すぐアクション可能);そうでない場合は、`structuredClone(state)` に対して `core.processTurn` を2パス実行して差分を比較します — 通常設定 vs 緩和 `{preserveRecentMessages: 0, preserveRecentTokens: 0}` — 緩和パスでのみ提供された参照をゾーン非表示(保護された最近ウィンドウ内)とみなします。実証ゾーン差分は、カーネル自身の保護ゾーンルールを意図的に再利用し、コピーしないため、ルールが進化するにつれて自己維持されます(過大近似は過少報告に傾く)。`VIABLE_RANGE_MIN_TOKENS`(200)未満の区間は沈黙します。通常オファーパスをすでに実行した呼び出し元は、`normalRanges` を渡すことができます(配列 = 信頼して再利用、空でも可;undefined = 呼び出し元データなし、監査が自身のパスを実行)し、acp_status は `processTurn` を1回だけ追加で支払います。関数全体は助言的:任意の throw は「区間が見つからない」にデグレードし、レシートやステータスを壊しません。 +- **acp_status** に追加的な `UNCOVERED HISTORY` セクション(トークン順トップ5区間、残りはカウント)を追加し、すべてのアクティブブロックの外側にあり、かつ上記のライブ Compressible-ranges リストにも存在しない質量を列挙します — カバーされたブロック間の孤立サブゲート区間(マージでは決して折りたたまれない、#4331 / #847 の恒久ホールクラス)を含む。可視性のために命名され、明示的に折りたたみ提案ではありません;行は `scope:"uncompressed"` で不変のままドリルダウンできます。 +- **Tier-2 カバレッジ不変条件(レビュー済み、P4 でピニング)**:監査のカバレッジセットは `coveredMessageIds` = アクティブブロックの `effectiveMessageIds` の和集合(子再帰なし)(kernel/src/state.ts:57-64)。これは安全です。なぜなら、すべてのブロック作成パスは消費された子の `effectiveMessageIds` を新しい親に和集合し(kernel/src/unit-projection.ts:178-183)、子を非アクティブ化するためです(kernel/src/compress.ts:1578-1581)— T2/T3 の親は状態モデルに完全な蒸留スパンを持ち、ハイドレーションがそれを保持します(状態 JSON 全体)。DB サイドの `blocks.payload_json` 走査にはその性質がなく、`directBlockIds` 再帰が必要です(以前の独立試みがそれを保持した理由);状態モデルには不要です。 +- **postCompressTail**:クリーンな全オファー枯渇で階層蒸留がない場合、判定の前に監査を実行します。区間が見つかり、かつ合計が `UNCOVERED_RECEIPT_FLOOR_TOKENS`(10K、レシート専用)以上 → 正直なテキストでそれらを特定(「最小ではない」、acp_status へのポインタ)。フロア未満 — または区間なし — 場合、#1387 契約文字列がバイト安定で発火し、master と完全に一致します:小さな拒否残骸は、すべての折りたたみで再注意を促してはなりません(pi #521 ルール)、一方、実質的な漏れはそれを上書きします。フロアは acp_status セクションには意図的に適用されません:明示的な検査表面は注意を促す表面ではなく、#4331 のオプション1はそこにサイズゲートを指定していません。10K 合計は、オーナー承認待ちのプロダクト値です(レビュアーの独立した選択と一致)。 + +動作変更(開示済み):旧 = オファー枯渇時の無条件「すでに最小です」;新 = グローバル監査が検証し、かつ未カバー質量が 10K レシートフロアをクリアした場合のみその主張 — フロア未満ではレシートは master とバイト同一(したがって `tests/compress-success-tail.test.ts` は master バイトのまま、差分ゼロ)、その #2404/#1387 フロア未満残骸フィクスチャはフロアのピニングとして機能します。サブゲート残骸は acp_status で可視化されました(以前はすべての表面で不可視)。設定/環境表面は追加されません;ナッジプロンプトテキストは不変(カーネル所有)。既知の制限は別の観察として残します:レシートの残り計算は、提出されたスパンが一部でも重複する場合、提供されたバッチ全体を削除するため、部分的に折りたたまれたマージバッチは過大報告ではなく過少報告する可能性があります。 + +テスト:`tests/issue4331-uncovered-history.test.ts`(ホールセッション → 正直な判定 + 特定スパン;排出済みセッション → 契約文字列;フロア未満沈黙;階層優先度;**Tier-2 蒸留カバレッジピニング** — 実際のホストパス経由で1つの T2 親に蒸留された3つの T1 は、子スパンを監査に漏らしてはならない;acp_status の両方向;フォーマッター上限)+ `tests/compress-success-tail.test.ts` は master から不変(その < 10K 残骸フィクスチャがフロアをピニング)、`tests/issue2029-status-baseline-provenance.test.ts`(すべてのステータスリーダーカーネル呼び出しがプロベナンスベースラインに供給)、`tests/issue847-compress-failure-guards.test.ts`(サブゲート残骸が診断で可視、依然として提供されない)。 + +## イベントループウェッジ自己終了と EADDRINUSE ホルダー診断 (#4762) + +長時間実行のスタンドアロンプロキシ(v0.1.208 フィールドレポート:dsh-harness レーン、最後のログ行は 48 MiB セッションの折りたたみ調整再アンカー)は、リスニングソケットを**依然として保持しながら**メインイベントループを15分以上ブロックしました — HTTP は死に、ソケットは開いたまま。外部ハーネスの子プロセス(`BILI_LAUNCH_TOKEN` なし)は、設計上 EADDRINUSE で即座に失敗します(`src/listen-policy.ts`)、そのため約70秒ごとの再起動は、誰かがゾンビを手動で kill するまで `listen failed: EADDRINUSE … exiting before persist` で死に続けました。2つのギャップ:ウェッジしたプロキシにポートを譲らせるものは何もなかったこと、そして死のメッセージが「別のプロセス」を非難しながら、その他のリスナーが実際に**サービング**しているかをチェックしなかったこと — さらに悪いことに、間歇的に accept キューを排出するウェッジゾンビは、起動時のツインヘルスプローブを通過するため、そのインスタンスは何もサービングしていないのに、子プロセスは「サービング中のインスタンスがサービングを続ける」というヒントで終了しました。 + +設計: + +- **ウォッチドッグ**(`src/event-loop-watchdog.ts`):別々のワーカースレッドが時計を**所有**します — メインスレッドが永久にブロックされていても、ワーカー自身のイベントループは刻み続けます。これがすべてです。メインは `WATCHDOG_HEARTBEAT_MS`(5秒)ごとにハートビートを投稿します;ワーカーは5秒ごとにチェックします:ギャップ ≥ `WATCHDOG_SOFT_WARN_MS`(30秒) → 1回の法医学 WARN 行(uptime/RSS);ギャップ ≥ `WATCHDOG_HARD_TIMEOUT_MS`(300秒) → bili.log + stderr に FATAL 行、その後 `process.exit(1)`(終了モード)。しきい値は設計上ハードコードされています(設定表面はオーナーゲート付き):正当な大きな圧縮は数秒から数分で完了し、チャンク間でループを譲渡するため、**連続した**5分の沈黙はデッドロックのみです。`startServer` の**入口**でアームされます(ツインプローブ、エンジン/ストレージ初期化、ハイドレーションはすべてその下で実行 — ウェッジは起動中に到着し得る、#4762 自身の再現クラスは同期 I/O ホットスポット)— スタンドアロンプロセスのみ;プラグイン注入モードではアームされません(HOST プロセスを kill してしまうため)。法医学行は、ファイルレグが設定されている場合常に bili.log にルーティングされます;ワーカーの STDERR レグは、stderr が TTY であるか、ファイルレグが全くない場合にのみ出荷されます — 満杯で排出されていないパイプへのブロッキング書き込みはエラーイベントを発火しません(#5012 クラス)、したがってワーカーがその死んだパイプに FATAL 行を書き込むと、終了を発火させる代わりに**自分自身**がウェッジします;ゲートは構造的であり、防御的ではありません。ワーカーは unref されているため、セーフティネットがクリーンな自然なプロセス終了を人質に取ることができません。ワーカーはインライン `eval` コードとして実行されます。なぜなら `dist/index.js` は参照できる兄弟ファイルのない単一バンドルだからです;その唯一の import はガード付き `require("worker_threads")` です — `parentPort` グローバルは eval ワーカーには存在しません(ReferenceError、Node 22 で検証済み)。ワーカー生成失敗は、1つの warn で監視なしにデグレードし、起動を壊しません(可用性がガードレールより優先)。 +- **ホルダー診断**(`src/port-owner.ts` + `src/server.ts` の両方の EADDRINUSE 死パス):死の瞬間に、既存リスナーの `/__bili/health` を一度再プローブします(2秒予算;ワイルドカードバインドはループバックオリジン経由でプローブ — `holderProbeOrigin`)。応答あり → ヒントはピアがサービング中であり、スポナーがそれに取り付くべきと述べる;応答なし → ヒントはホルダーがウェッジまたは死んでいるように見え、具体的な解放を特定します:pid が既知の場合(レスポンダー pid が古いレジストリエントリに優先;同じレーンのレジストリ pid にフォールバック)、`taskkill /PID N`(Windows)/ `kill N`(POSIX)、それ以外の場合は `netstat/lsof`。`[eaddrinuse-diag]` としてログ出力され、`BILI_LAUNCH_TOKEN` が設定されている場合、スポーンポートログに書き込まれます(この子プロセスの stderr は bili.log にミュートされます、#2864)。両方のパスをカバーします:エンジン前の早期ツイン衝突終了と、バインド後の `server.on("error")` 終端ブランチ。 +- **なぜ起動時の裁定を信頼するのではなく再プローブするのか:** 早期ツインチェック(`findVerifiedSameLaneTwin`)はバインドの数秒前に実行され、遅いパスの `classifySameLanePeer` はレジストリのみです(pid 生存、ヘルスチェックなし)。その間に発生するウェッジ — まさに #4762 の形状 — は両方の真実を反転させます。そして1つの浅いプローブでは、遅いが生存と、ウェッジだが排出中(ゾンビは一部のプローブに応答した)を区別できないため、文言は「ウェッジのように見える」と述べ、kill の決定をオペレーター/スポナーに委ね、それに基づいて行動しません。 +- **スコープ外(文書化済み):** 繰り返し EADDRINUSE 後の親側強制 kill は、このリポジトリではなく**スポナー**(DeepSeek Harness)に属します — 診断行は今や正確に何をすべきかを伝えます。 + +動作変更(開示済み):旧 = ウェッジしたスタンドアロンプロキシはポートを保持したまま永遠に生き、すべての再起動は不透明な EADDRINUSE で死んだ;新 = メインループの連続沈黙 ≥ 5分 ⇒ 30秒で1つの warn、1つの FATAL ログ行、その後 `process.exit(1)` によりスポナーの通常の再起動がポートを回復し、すべての終端 EADDRINUSE メッセージにサービング/ウェッジ裁定 + kill ガイドが追加されます。新しい設定/環境/CLI 表面はありません — しきい値はモジュール定数です。プラグインモードの動作は不変(ウォッチドッグはそこにアームされません)。 + +テスト:`tests/event-loop-watchdog.test.ts`(裁定境界テーブル(warn-once 意味論を含む);デフォルトピニング;**実ワーカー**ウェッジ統合 — 同期スピンがメインループをハードしきい値を超えてブロックし、トリップが発火し、両方の法医学行が `[v=…]` タグ付きでログファイルに到達;健全なストリームはトリップしない;生成失敗シームがクリーンにデグレード)+ `tests/port-owner.test.ts` 追加(ワイルドカードオリジン書き換え;サービング/ウェッジ/匿名ヒント文言;ライブレスポンダー pid が古いレジストリ pid に優先;死んだホルダーは非サービングとして読まれる;登録前「starting」は非サービングとして読まれる)。 + +## 依存関係監査 — zod アドバイザリ GHSA-mrhx-c7xc-m3w5 と jimp のネスト zod 誤検出 (#4820) + +新規インストールの `npm audit` は、高重大度のアドバイザリ GHSA-mrhx-c7xc-m3w5(CVE-2023-54404、CVSS 7.5 High、**可用性/DoS のみ** — 機密性または完全性の影響なし)を、異なる処理が必要とされる2つの異なるチェーンに対して報告します: + +- **直接 `zod`**(`package.json` `dependencies.zod`、KDD #1 による正確なピン)。真に影響を受けています:脆弱なコードは `v4/core/schemas.js` の `$ZodArray.handleArrayResult` にあり、制約なしの配列スキーマに対して過大配列を検証する際、要素ごとの検証問題を上限や早期終了なしに蓄積します。`4.1.8 → 4.6.7` に更新(パッチ済み行は 4.6.6 から始まり、`abortEarly` ゲートの早期 break と、4.1.8 にない `capSize` 登録を追加)。ピンは**正確**(範囲ではない)のままです。これにより npm は opencode ホストと1つの共有インスタンスにデデュプでき、KDD #1 の相互運用保証を維持し、`tests/opencode-native-v1.test.ts` でカバーされます。私たちのツリーでは、このコピーは `src/agent/opencode-native.ts`(OpenCode V1 プラグインツール、遅延不透明 import)のみによって消費されます;Pi/プロキシレーンでは読み込まれません。 +- **Jimp のネスト `zod@3.x`**(`optionalDependencies.jimp`;各 `@jimp/*` は `zod ^3.23.8` を宣言するため、npm はすべての `node_modules/@jimp/*/node_modules/zod` 下に 3.x コピーをネストします)。これは**私たちの jimp 使用法に対する誤検出**であり、semver 範囲から仮定するのではなく、ソースレベルで確立されました:脆弱な関数は zod の v4 実装(`v4/core/schemas.js`)にのみ存在し、v3 には決してありません;3.25.x インストールでの `import "zod"` は v3 コアに解決されます;そして `@jimp/*` はプレーンな `"zod"` を import します(決して `zod/v4` を import しません)。したがって、jimp を通じてバグは到達不可能です。したがって、jimp の zod 3→4 を強制オーバーライドしません(パッチ済み 3.x に収束するものがないクロスメジャーオーバーライドで、jimp 自身の検証セマンティクスをリスクにさらす);代わりにアップストリームを追跡します。到達可能性の制限は明示的に保たれます:jimp は任意であり、遅延読み込み(`src/image-rescale.ts`)、不在時はパススルーにデグレードし、画像処理中にのみ到達可能です。境界:3.25.x ターボール**内部**のバンドル v4 プレビュー自体が修正前です — 将来の `@jimp` が `zod/v4` を import する場合、この結論を再評価してください。 + +ハード CI/ランタイム監査ゲートは意図的に延期されています:jimp チェーンのために赤のままになるため、例外を追加しない限り、そして例外は狭くスコープされ、説明され、再訪問可能でなければなりません — 全面的な抑制ではありません。直接 zod の更新が着地し、アップストリーム jimp が追跡された時点で再検討してください。 + +## フルリサンダムウォーターマークファストパス (#5403 / #5418) + +プラグインレーンホスト(dsh スレッドモデルと、すべてのリクエストで**完全な**履歴と新しいテールを再送信するクライアント)は、ターンごとに、完全なボディの `JSON.parse`、完全な `openaiToCore` 変換、および結果 AST の `session.lastMessages`(`snapshotMessages`)へのターン間ピンを支払いしていました。#5403 の規模(20k メッセージ、ターンあたり約 81 MiB 受信)では、そのペアが2時間で6回 JavaScript ヒープを上限を超えさせました。 + +レーンは今やウォーターマークを保持します。すべての成功したプラグインレーンチャットコンプリートレスポンスは、そのリクエストの `messages` 配列のサーバー測定要素数 T を `x-bili-pf-seq` にスタンプします。T は `src/server/fastpath-scan.ts` によって測定されます。これは単一パス構造スキャナ(文字列状態機械を持つ文字列ウォーク)です:信頼できるほど十分な JSON を検証しながら、スパンオフセットのみを割り当てます — AST なし、完全な解析なし。クライアントサイドは1つの状態機械(`src/agent/pf-channel.ts`)で、1つのチョークポイントで給水されます:`src/agent/native-intercept.ts` の `globalThis.fetch` インターセプトは、すべてのプラグインレーンモデルリクエストに `x-bili-pf-count`(および以下の v2 テール ID)をスタンプします — `/bili/` ルーティングブランチ、生プロバイダー URL 書き換えブランチ(attach モード、V1 fetch パッチ)、**そして**プロキシ直結セルフブランチ(プロバイダー URL がプロキシルートに直接ダイヤルするホスト、例:dsh プロファイルバンドル;これはコンテナ化ゲート実行がそのレーンが静かにチャネルをシードしないことを発見した後に追加されました)— そしてすべての成功レスポンスからスタンプを学習するため、どのレーンもハンドシェイクを再実装しません。 + +増分レーン(#3248/#4491)との関係 — **一緒に実行安全**、二度処理しません:両方のメカニズムは同じ痛点(プラグインホストの完全履歴再送信)に攻撃しますが、ターンごとにリクエスト形状で分割します。dsh シムの divert は ANTHROPIC-WIRE ボディ(`wireMessagesLookAnthropic`;OpenAI ツール形状 `role:"tool"`/`tool_calls` は常にフルリサンダムに乗る、#3433)でのみ作動します — そして #5403 の形状はまさに逆のワイヤ(chat-completions / openai プロファイル)であり、そこでは増分レーンは決して divert しません。したがって、2つのレーンは競合ではなく補完です:anthropic-wire プラグインセッションは増分レーンによってサーブされ、OpenAI chat-completions プラグインセッションはウォーターマークファストパスによってサーブされます。1つのリクエストは**正確に1つの**パスを歩きます(シムがターンごとに選択);サーバーサイドでは、`x-bili-plugin-turn` マーカーを持つ任意のリクエストはウォーターマーク評価を完全にスキップします(混合スタンプなし — ゲートマトリクスの `incrementalTurn` 行)、そして divert されたレスポンスは `x-bili-pf-seq` を決して持ちません(代わりに `x-bili-applied-seq` を持ちます)。レーンが構築する合成再エントリリクエストは、pf-* 名のない明示的なヘッダー許可リスト(`PASSTHROUGH_HEADERS`)を持ち、したがってハンドシェイクヘッダーはそのパス経由でも漏れません。残りの無害ケース:混合セッションでは、古い `x-bili-pf-count` が1つの非 divert ターンに伴う可能性があります — それは最大で1回の検証ラウンドのコストしかなく、その後レスポンスが真を再スタンプします。 + +アイデンティティチャネル v2/v3(オーナーラダー msgid > order > hash、#11):裸のカウントは境界を**位置**のみで固定します — 要素を書き換えつつカウントを一定に保つクライアントは不可視のままです。私たちのシムがループ内にある場合、リクエストはさらに `x-bili-pf-tail-ids` を持ちます:要素 K−1(前のターンのアンカー)のホストサイドメッセージ ID と、すべての**新しい**要素 — 「几个,不是几十个」(数個、数十個ではない)。ホストは chat-completions ボディに ID を入れませんが、注入された拡張はそれらをホストコンテキストから読み取ります(要素ごとのルールは増分エンベロープと共有、#4491)— したがってホストリリースは不要です。ワイヤ形式はセグメントごとのパーセントエンコーディング(`ids.map(encodeURIComponent).join(",")`)です:区切りカンマはリテラルのまま、ID 内部のカンマは %2C として移動するため、サーバーの分割後デコードは任意の ID アルファベットに対して曖昧さを持ちません。**整合性証明なし(オーナー裁定 2026-11-02):** ホストは履歴を圧縮し**書き換え**るため、証明ゲーティングは現実と戦い、チャネルを殺しました — msgid は永遠に一意であり、ORDER は検証済みデルタ内でそれらをバインドし、バイトレベルのヘッドチェックは境界の真です。したがってキャプチャは**スロットごと**です:使用可能なホスト ID を持たない要素(ネイティブコンパクト化サマリー `acp_summary_*`、ペルソナサイドカー、外国形状、重複 ID)は、隣人を汚染する代わりに、未知スロットプレースホルダー `?`(ワイヤ上 `%3F`)に乗ります;完全に解決できないリストのみがストレージをクリアします。サーバー裁定:長さ不良 / 重複実 ID / デコード不能セグメント ⇒ このターンの UNcredited 静かデグレード — ブレーカーに向かうことは決してない(シム↔プロキシドリフトはレガシーパス + 再スタンプで自己修復);prevId ≠ 保存アンカー ⇒ UNcredited、**両方**が既知 ID の場合のみチェック — どちらかの `?` はアイデンティティ主張なし(ペナルティなし)。ヘッダー不在 ⇒ 純粋なカウントモード;v2 以前のすべての動作はバイト単位で不変です。レーンカバレッジ:チャネルはプロトコル統一です — レーンは、**この**リクエストのホスト ID を解決する薄いキャプチャアダプターのみで異なります(オーナールール:クライアント間では「ID がどこから読み取られるか」は異なり得るが、それ以外は異なる):dsh はスロットごとにホストのディスパッチコンテキストからそれを読み取ります(`pfSlotIdsOf` — 上記の `?` プレースホルダー)、pi は送信ボディに対してセッションブランチエントリをファミリーごとにウォークします(anthropic `laneMsgIdsForWire`、openai-chat `laneMsgIdsForOpenAiWire`)、opencode は増分エンベロープのためにすでに整列した検証済みリストを再利用します(#4491)、omp は `before_provider_request` でホストが stash するブランチエントリのフェッチ層整列を、**実際に**送信されたボディに対してウォークします(`ompTurnMsgIds` — エンベロープが乗る同じコピー)— **anthropic-wire ターンのみ**:その厳格なカウント+ロール証明は、設定組み立ての先頭システムランをブリッジできず、そこでの失敗クリアは同じ会話 ID の共有フックのリストを**消去**します(フックが最初に実行され、このプランナーが最後に実行される)— openai-wire ターンは共有 `laneMsgIdsForOpenAiWire` リゾルバーのみによってカバーされます(#2583 モデルごとのエグレス)。pi/opencode/omp ウォーカーはオールオアナッシングであり、失敗した解決は保存リストを**クリア**します(それらにとって失敗は**位置**知識自体が欠如していることを意味するため、クリアが正直な動きです)— 解決不能なリクエストは古いアンカーに乗るのではなくカウントモードにデグレードします;dsh のスロットごとキャプチャは免除されます(上記)。1つのプロトコル注記:chat-completions ボディは、ブランチエントリを持たない設定/状態から組み立てられた system|developer 要素で始まります;openai リゾルバーはその先頭ランを位置固定合成トークン(`bili-ps-` — スロットごとに安定、文字セット安全、8-hex uuid エントリ ID と衝突不可能)でカバーするため、チェーンは最初のシステム要素で死ぬのではなく生き残り、移動したスロットは実際の編集と同様にアンカーを壊します(UNcredited、自己修復)。 + +ターンが HIT であるのは:ウィンドウ原点 K が確定し、プロセス内シード(前のターンの正規コア、モジュールレベル `WeakMap`、パネル分解がセッション真実について正直であるように Session オブジェクトの外に意図的に配置)が同じモデルの下で正確にそのカウントでスタンプされた場合です。**v4 カウント緩和(オーナー裁定 2026-11-02):** 形状有効な `x-bili-pf-tail-ids` リストがサーバー自身の簿記(`len = T − K + 1`、サーバー側で再検証)と幅が一致する場合、K は台帳(`seed.stampT`)から来て、エコーされた `x-bili-pf-count` は診断に降格します — 欠落または古い/同期外れたエコーはもはやミスを生み出しません(決定文字列は `hit(no-count)` / `hit(count-off=N)` として痕跡を残し、決してブレーカー燃料にはなりません);そのようなリストなしでは、v4 以前のラダーがバイト単位で不変のまま実行されます(エコーは `stampT` に等しく、T より厳密に小さい必要があります)。最初の `HEAD_CHECK_ELEMENTS`(8)要素はバイト同一のシステムランに変換され、ウィンドウヘッドは system/developer 要素ではありません(引き上げられたシステムは `reconcileSystemAnchor` を同期外れさせるため)。HIT 時、パイプラインは完全な解析の代わりに `[seed cores] + [新鮮に解析されたウィンドウコア [K..T)]` を受け取り、`snapshotMessages` はテールウィンドウのみをピンします。ウィンドウコアはプレフィックスに対して再キー付けされます。なぜなら `openaiToCore` は呼び出し内出現順序でクラスター ID を発行し(`_N` サフィックス付きの `h_` ベース)、与えられた配列位置から `wireIndex` をスタンプするためです — 繰り返しコンテンツベースは stash されたプレフィックスからその序数を継続しなければ、台帳のアイデンティティ契約が壊れます;K=1 で再キー付けされないウィンドウは、2つの異なるワイヤメッセージをマージさえします(prune は等しい wireIndex で最初のユーザーピンランを拡張します)。 + +失敗ソフト規律(逸脱防止ロック):レガシーパイプラインコードは**不変**です — この機能は呼び出し元が供給する入力を交換するのみであり、**任意の**疑念(スタンプなし/不良/古い — v4 上記の台帳有効テール ID リストがリクエストを運ぶ場合を除く;カウント退行 `ahead`、ゼロ成長 `T === K`(台帳有効な1要素リストでも `no-progress` を維持、空ウィンドウは空の `lastMessages` ベースラインをピンする)、モデル切り替え、ヘッドドリフト、ホイスティング危険、壊れたスキャン、アームされたブレーカー)は、そのターンについて不変の完全解析パスにフォールバックし、それは新鮮に測定された T を再スタンプするため、古いクライアントは1ラウンドトリップで収束します。5連続の CREDITED ミスは、レーンを1時間 HIT なしに保持するブレーカーをアームします — 保持されたターンはスキャンと再スタンプを続けます(スタンプなし保持はクライアントのウォーターマークを永遠に孤立させる;そのデッドロックは出荷前にユニットテストで発見され、ピニングされました)。CREDITED は、ミスが明らかに私たちのせいではないことを証明する場合(クライアントが嘘をついたり書き換えたりした)を意味します;未シード/進捗なしミスは無料です。 + +宣言された信頼境界(§7.4 — 人間レビュー必須、自動マージなし):要素カウントを一定に保ちつつプレフィックスバイトを編集するクライアントは検出されません — アンカーを除き、そこでは v2 が運ばれた prevId を保存されたものと比較し、再発行された ID は1つの UNcredited ミスと自己修復のコストです。そのトレードオフは、バイトレベル再検証をスキップする価格のすべてです;それは §7.4 人間レビューをクリアし、したがって**実験的**グレーロールアウトとして出荷されます — 約5%のインストールでデフォルト ON(オーナー裁定 2026-11-02:GA 前の小規模コホート、閉じるまですべてのインストールに見える1回限りの Web 紹介通知、3状態クイックスイッチ付き)— A/B ゴールデンが送信バイト同一性をピニングし、インストールごとのオプトイン/オプトアウト(`rollout.features.pluginFullResendWatermark: true|false` / `BILI_ROLLOUT_PLUGIN_FULL_RESEND_WATERMARK=1|0`)。破壊的書き換え(告知コンパクト化、切り詰め、並べ替え)はカウントを変更し、古いコアがカーネルに供給される前に捕捉されます — v4 下では、捕捉はクライアントエコーから幅算術自体に移動します:縮小されたプレフィックスは ID リストが満たせない非正幅を要求するため、CREDITED `ahead` / `seed-stale` 裁定は v4 以前と正確に発火します。 + +正直な制限:(1) マルチモーダルテール(`image_url` を含むコンテンツ配列)が stash に着地すると、その履歴の残りの部分についてレーンは完全レガシーターンにデグレードします — カーネルはメッセージが最後の要素である場合と履歴中間の場合で、ユーザーコンテンツ配列画像を異なる方法でレンダリングするため、凍結 stash は位置非依存でレガシーバイトを再現できません;テキストワークロード(#5403 レポーターの形状)は影響を受けません。(2) ヘッドフラグメントは、システムランチェックのために各 HIT で再解析されます(8要素)。(3) 両方の `x-bili-pf-*` ヘッダーはアップストリームで剥奪されます(`UPSTREAM_HOP_HEADERS`)— プロトコルヘッダーはモデルトラフィックに決して漏れません。 + +測定(プロベナンス:`tests/issue5403-watermark-fastpath.test.ts`、同じコーパスでの密閉デュアルプロキシ A/B):HIT ターンは完全な解析/変換/ピンを完全にスキップします;8ターンコーパス(マルチパート画像着地ターンを含む)で、常駐 `lastMessages` 8684 B → 1210 B(7.2×);すべてのターンで、カーネル `time="…"` 属性を除き送信バイトはレガシーとバイト同一;`x-bili-pf-*` はキャプチャされたすべてのアップストリームリクエスト、両フェーズから欠落。ユニットカバレッジ:`tests/fastpath.test.ts`(ブレーカー TTL 再アームを含む完全裁定ラダー)、`tests/fastpath-scanner.test.ts`(敵対的 JSON テーブル、深度上限、サロゲートペア、50k 要素スケール)、`tests/lane-decisions-matrix.test.ts`(ゲート行マトリクス、両方向)。 From 6c6857a534a5c248a890efc89b25822217faa252 Mon Sep 17 00:00:00 2001 From: ranxianglei Date: Thu, 12 Nov 2026 23:37:11 +0800 Subject: [PATCH 14/17] docs: add Japanese architecture hub + 8 module pages (#6072) ja pages reuse the EN diagrams (svg+png); hub ledger locked to EN by the extended check-architecture-docs guard. --- docs/architecture.ja.md | 49 +++++++++++++++++++++++++++++++ docs/architecture.md | 19 ++++++------ docs/architecture.zh-CN.md | 1 + docs/architecture/fastpaths.ja.md | 40 +++++++++++++++++++++++++ docs/architecture/identity.ja.md | 32 ++++++++++++++++++++ docs/architecture/kernel.ja.md | 37 +++++++++++++++++++++++ docs/architecture/lanes.ja.md | 34 +++++++++++++++++++++ docs/architecture/pipeline.ja.md | 38 ++++++++++++++++++++++++ docs/architecture/storage.ja.md | 41 ++++++++++++++++++++++++++ docs/architecture/update.ja.md | 38 ++++++++++++++++++++++++ docs/architecture/webui.ja.md | 34 +++++++++++++++++++++ 11 files changed, 354 insertions(+), 9 deletions(-) create mode 100644 docs/architecture.ja.md create mode 100644 docs/architecture/fastpaths.ja.md create mode 100644 docs/architecture/identity.ja.md create mode 100644 docs/architecture/kernel.ja.md create mode 100644 docs/architecture/lanes.ja.md create mode 100644 docs/architecture/pipeline.ja.md create mode 100644 docs/architecture/storage.ja.md create mode 100644 docs/architecture/update.ja.md create mode 100644 docs/architecture/webui.ja.md diff --git a/docs/architecture.ja.md b/docs/architecture.ja.md new file mode 100644 index 0000000000..0dae716354 --- /dev/null +++ b/docs/architecture.ja.md @@ -0,0 +1,49 @@ +# アーキテクチャ + +> システムのアーキテクチャに関するハブページです。このページには**全体図**と**モジュール台帳**を掲載しています。各モジュールは、このディレクトリ内に独自のページ(英語 + `.zh-CN`)を持ち、それぞれに独自の図が用意されています。 +> 中国語版: [architecture.zh-CN.md](./architecture.zh-CN.md) +> +> **ライブドキュメント(オーナー裁定 2026-11-08)。** モジュール境界、図示されたデータフロー、テーブル、レーン、またはワイヤーパスを変更する PR は、同じ PR 内で影響を受けるページ、図、およびこのハブテーブルを更新する必要があります。CI は機械的な部分(`tools/check-architecture-docs.mjs`)を強制します。ルールの本文は [AGENTS.md](../AGENTS.md) の "Documentation Layout" セクションにあります。 + +## 全体アーキテクチャ(2026-11-08 時点、master、ストレージスキーマ v11) + +![全体アーキテクチャ](./architecture/assets/architecture-current.en.svg) +(ビットマップフォールバック: [architecture-current.en.png](./architecture/assets/architecture-current.en.png)) + +読み方: + +- **左から右へは 1 つのモデルリクエストの流れです。** ホストレーン(dsh / pi / opencode / codex / ベアプロキシクライアント)はすでにアイデンティティ(ヘッダー内のセッション ID。プラグインレーンはエンベロープ内で要素ごとのホスト msgid を保持 — #5842 コレクター)を保持しています。イングレスアダプター(`prepare-*`)はワイヤーを正規化し、`lane-decisions` はリクエストの形状 × スティッキーセッションバインディングに基づいてリクエストを 4 つのレーンのいずれかにルーティングします。レーンは正規化されたコアを **acp-kernel** 圧縮エンジン(フォールド判定 / サマリー / リファレンス台帳 — コアはホスト作業によって書き換えられることはありません)に渡し、エグレスマッピング(`coreTo*`)は 4 つのワイヤー向けに再シリアライズし、モデルエンドポイントが応答します。 +- **インディゴ色の帯は単一の SQLite ファイル**(スキーマ v11)です:行レベルのソースオブトゥルース。12 個のテーブルチップと赤い **kstate JSON** チップ。 +- **右側の 3 つの赤いボックスは、#5643 の進化(スナップショットテーブル圧縮基盤)が対象とする構造的なペインポイント**です:3 か所に分散して存在する状態、ディスクに永続化されないホストアイデンティティ、そして統一されたスナップショットテーブルではなく各スライスを個別にパッチするファストパス。下部のストリップは進化の目標(6 段階の固定チェーン、単一のストレージソースオブトゥルース)を示しています — これは*提案*(#5643)であり、まだ構築されていません。 + +## モジュール台帳 + +| モジュール | 一行説明 | ページ | ステータス | +|---|---|---|---| +| `storage` | 統合 SQLite: テーブルファミリー、kstate、チェックポイント、GC | [storage.md](./architecture/storage.md) · [zh](./architecture/storage.zh-CN.md) · [ja](./architecture/storage.ja.md) | ✅ | +| `pipeline` | リクエストパイプライン(handle / prepare-* / relay / inject) | [pipeline.md](./architecture/pipeline.md) · [zh](./architecture/pipeline.zh-CN.md) · [ja](./architecture/pipeline.ja.md) | ✅ | +| `lanes` | ホストレーン(dsh / pi / opencode / codex / ベアプロキシ + lane-decisions) | [lanes.md](./architecture/lanes.md) · [zh](./architecture/lanes.zh-CN.md) · [ja](./architecture/lanes.ja.md) | ✅ | +| `kernel` | 圧縮エンジン(acp-kernel: フォールド、サマリー、リファレンス台帳) | [kernel.md](./architecture/kernel.md) · [zh](./architecture/kernel.zh-CN.md) · [ja](./architecture/kernel.ja.md) | ✅ | +| `identity` | セッションおよびメッセージのアイデンティティ(セッション ID、ペルソナフォーク、msgid チャネル) | [identity.md](./architecture/identity.md) · [zh](./architecture/identity.zh-CN.md) · [ja](./architecture/identity.ja.md) | ✅ | +| `fastpaths` | ファストパス(増分レーン、v5 ウォーターマーク、D レーンのスナップショットレンダリング) | [fastpaths.md](./architecture/fastpaths.md) · [zh](./architecture/fastpaths.zh-CN.md) · [ja](./architecture/fastpaths.ja.md) | ✅ | +| `webui` | Web パネルおよび管理画面 | [webui.md](./architecture/webui.md) · [zh](./architecture/webui.zh-CN.md) · [ja](./architecture/webui.ja.md) | ✅ | +| `update` | セルフアップデート、アドバイザリー、プラグインインストール | [update.md](./architecture/update.md) · [zh](./architecture/update.zh-CN.md) · [ja](./architecture/update.ja.md) | ✅ | + +上記のハブテーブルは単一の台帳です — CI は `✅` の行にページペアが存在し、余分なページが存在しないことをチェックします。 + +## 他のドキュメントとの関係 + +- **ファイルレベルのマップ**(どのファイルが何をするか、各 1 行): [reference/architecture.md](../reference/architecture.md) — CI は `src/` のすべてのファイルをカバーしていることを強制します。 +- **構築手順**(ビルド / テスト / リリース / git の仕組み): [reference/](../reference/README.md)。 +- **アイデンティティ教義**(アイデンティティルールの背後にある「なぜ」): [message-identity](./message-identity.md) · [session-identity](./session-identity.md) · [identity-channels](./identity-channels.md)。 +- **リーダー向け概要**(README がリンクしているもの): [how-it-works](../how-it-works.en.svg)。 + +## メンテナンスルール + +- **同一 PR ルール**(オーナー裁定 2026-11-08): 構造的変更 ⇒ ドキュメント + 図 + 台帳行を同じ PR で更新。「後でドキュメントを更新する」は禁止。 +- **CI レーン `architecture-docs`**(`tools/check-architecture-docs.mjs`)は機械的な部分を強制します: + 1. `reference/architecture.md` がすべての追跡対象 `src/` ファイルを列挙していること(欠落なし、ゴーストなし); + 2. すべての `✅` 台帳行に両方のページファイル(英語 + `.zh-CN`)が存在し、孤立したページが存在しないこと; + 3. すべてのページが `assets/.{en,zh-CN}.svg` **および** `.png` フォールバックを参照し、それらがすべて存在すること; + 4. すべての SVG が基本的な well-formed であること(タグのバランス、エスケープされていない `&` なし — かつて壊れた英語図をレンダリングした失敗モード)。 +- 図の**視覚的な鮮度**は機械的にチェックできません:同一 PR ルールおよびレビューに依存します。図はベクター優先(SVG)であり、PNG はフォールバックとして提供されます(AGENTS.md のドキュメントルールに従う)。 diff --git a/docs/architecture.md b/docs/architecture.md index 6aeef6e88e..5ccec3305b 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -1,7 +1,8 @@ # Architecture -> One hub for the system's architecture. This page holds the **overall diagram** and the **module ledger**; each module gets its own page (en + `.zh-CN`) in this directory, each with its own diagram. +> One hub for the system's architecture. This page holds the **overall diagram** and the **module ledger**; each module gets its own page (en + `.zh-CN` + `.ja`) in this directory, each with its own diagram. > 中文: [architecture.zh-CN.md](./architecture.zh-CN.md) +> 日本語: [architecture.ja.md](./architecture.ja.md) > > **Live document (owner ruling 2026-11-08).** A PR that changes a module boundary, a depicted data flow, a table, a lane, or a wire path MUST update the affected page(s), diagram(s), and this hub table in the same PR. CI enforces the mechanical parts (`tools/check-architecture-docs.mjs`); the rule text lives in [AGENTS.md](../AGENTS.md) "Documentation Layout". @@ -20,14 +21,14 @@ How to read it: | Module | One line | Pages | Status | |---|---|---|---| -| `storage` | Unified SQLite: table family, kstate, checkpoints, GC | [storage.md](./architecture/storage.md) · [zh](./architecture/storage.zh-CN.md) | ✅ | -| `pipeline` | Request pipeline (handle / prepare-* / relay / inject) | [pipeline.md](./architecture/pipeline.md) · [zh](./architecture/pipeline.zh-CN.md) | ✅ | -| `lanes` | Host lanes (dsh / pi / opencode / codex / bare proxy + lane-decisions) | [lanes.md](./architecture/lanes.md) · [zh](./architecture/lanes.zh-CN.md) | ✅ | -| `kernel` | Compression engine (acp-kernel: folds, summaries, ref ledger) | [kernel.md](./architecture/kernel.md) · [zh](./architecture/kernel.zh-CN.md) | ✅ | -| `identity` | Session & message identity (session id, persona fork, msgid channels) | [identity.md](./architecture/identity.md) · [zh](./architecture/identity.zh-CN.md) | ✅ | -| `fastpaths` | Fastpaths (incremental lane, v5 watermark, D-lane snapshot render) | [fastpaths.md](./architecture/fastpaths.md) · [zh](./architecture/fastpaths.zh-CN.md) | ✅ | -| `webui` | Web panel & admin surface | [webui.md](./architecture/webui.md) · [zh](./architecture/webui.zh-CN.md) | ✅ | -| `update` | Self-update, advisory, plugin install | [update.md](./architecture/update.md) · [zh](./architecture/update.zh-CN.md) | ✅ | +| `storage` | Unified SQLite: table family, kstate, checkpoints, GC | [storage.md](./architecture/storage.md) · [zh](./architecture/storage.zh-CN.md) · [ja](./architecture/storage.ja.md) | ✅ | +| `pipeline` | Request pipeline (handle / prepare-* / relay / inject) | [pipeline.md](./architecture/pipeline.md) · [zh](./architecture/pipeline.zh-CN.md) · [ja](./architecture/pipeline.ja.md) | ✅ | +| `lanes` | Host lanes (dsh / pi / opencode / codex / bare proxy + lane-decisions) | [lanes.md](./architecture/lanes.md) · [zh](./architecture/lanes.zh-CN.md) · [ja](./architecture/lanes.ja.md) | ✅ | +| `kernel` | Compression engine (acp-kernel: folds, summaries, ref ledger) | [kernel.md](./architecture/kernel.md) · [zh](./architecture/kernel.zh-CN.md) · [ja](./architecture/kernel.ja.md) | ✅ | +| `identity` | Session & message identity (session id, persona fork, msgid channels) | [identity.md](./architecture/identity.md) · [zh](./architecture/identity.zh-CN.md) · [ja](./architecture/identity.ja.md) | ✅ | +| `fastpaths` | Fastpaths (incremental lane, v5 watermark, D-lane snapshot render) | [fastpaths.md](./architecture/fastpaths.md) · [zh](./architecture/fastpaths.zh-CN.md) · [ja](./architecture/fastpaths.ja.md) | ✅ | +| `webui` | Web panel & admin surface | [webui.md](./architecture/webui.md) · [zh](./architecture/webui.zh-CN.md) · [ja](./architecture/webui.ja.md) | ✅ | +| `update` | Self-update, advisory, plugin install | [update.md](./architecture/update.md) · [zh](./architecture/update.zh-CN.md) · [ja](./architecture/update.ja.md) | ✅ | The hub table above is the single ledger — CI checks that `✅` rows have their page pairs and no extra pages exist. diff --git a/docs/architecture.zh-CN.md b/docs/architecture.zh-CN.md index 6b512f93ad..31552a1be8 100644 --- a/docs/architecture.zh-CN.md +++ b/docs/architecture.zh-CN.md @@ -2,6 +2,7 @@ > 系统架构的唯一枢纽。本页放**整体架构图**与**模块总表**;每个模块在本目录下有独立页面(中英各一份),每页配自己的图。 > English: [architecture.md](./architecture.md) +> 日本語: [architecture.ja.md](./architecture.ja.md) > > **实时维护文档(owner 裁定 2026-11-08)**:任何改动模块边界 / 数据流 / 表 / 车道 / 线上路径的 PR,必须**同一 PR** 更新对应页面 + 图 + 本总表。机械部分由 CI 强制(`tools/check-architecture-docs.mjs`);规则条文见 [AGENTS.md](../AGENTS.md)「Documentation Layout」。 diff --git a/docs/architecture/fastpaths.ja.md b/docs/architecture/fastpaths.ja.md new file mode 100644 index 0000000000..13846d8d86 --- /dev/null +++ b/docs/architecture/fastpaths.ja.md @@ -0,0 +1,40 @@ +# モジュール: fastpaths (増分レーン / v5 ウォーターマーク / Dレーン / レガシー) + +> [アーキテクチャハブ](../architecture.md) の一部 · 中国語版: [fastpaths.zh-CN.md](./fastpaths.zh-CN.md) · 2026-11-08 時点、master + +![Fastpaths module](./assets/fastpaths.en.svg) +(ビットマップフォールバック: [fastpaths.en.png](./assets/fastpaths.en.png)) + +## 責務 + +プラグインホスト (dsh スレッド、pi、opencode など) は、ターンごとに完全な履歴を再送信する。本モジュールは、これらのターンにおいてワイヤー上の作業(パース、正規化変換、スナップショット固定)を再実行することをスキップするメカニズムのファミリーであり、実際に実行した場合とバイト単位で同一の結果を保証する。1つのリクエストは常に正確に1つのパスのみを通過し、これらのパスは構造上(シェイプゲート + スティッキーバインディング)互いに排他的である。 + +## 原則 + +- **ヒットするか、完全なレガシーか — 中間は存在しない。** いかなる疑義(不正/古いスタンプ、シェイプ不一致、デシンク、ブレーカー)がある場合でも、ターン全体を未変更のレガシーパスに送る。これにより、クライアントは1ターンで真実値に収束するよう再スタンプが行われる。 +- **劣化させ、推測しない。** 検証の失敗はコストであり、高速結果を信頼する許可ではない(可用性を性能より優先、#3128)。 +- **高速レーンは1つのリクエストの最適化であり、新しいプロトコルではない。** pf-*/envelope ヘッダーはプロトコルヘッダーであり、アップストリーム (`UPSTREAM_HOP_HEADERS`) に送る前に除去され、モデルエンドポイントには決して表示されない。 + +## 動作原理 + +**ターンのシェイプ。** 各成功したレスポンスは、`x-bili-pf-seq` = メッセージ数(`fastpath-scan.ts` によって測定されるゼロアロケーションの構造的スキャン — JSON.parse なし)をスタンプする。クライアントはこれを `x-bili-pf-count` としてエコーバックし、さらに `x-bili-pf-tail-ids`(最後のアンカー以降のホスト msgid、#4491 の要素別スクリーニング)を付与する。プラグインターンのターンは、追加で `x-bili-plugin-turn` エンベロープ (#3248) を保持する。シェイプゲートがレーンを選択する: anthropic ワイヤー → 増分ダイバート; openai シェイプ → ウォーターマークレーン (#3433)。 + +**① 増分プラグインターンレーン** (`threads-lane.ts`, #3248): ホスト msgid に対する差分 + ACK + リシンク; デルタのみがパースされる。anthropic ワイヤーのダイバートターンを提供する。 + +**② v5 ウォーターマーク高速パス** (`fastpath.ts`, #5403/#5418, ロールアウト ~5% コホート): 検証済みのヒット時、パイプラインの入力は「前ターンの正規化コア(モジュールレベルの WeakMap)+ テールウィンドウ [K..T) のみに対する新規パース」になる — 完全なパース、完全な変換、および `lastMessages` の固定はスキップされる(#5403 の OOM 原因)。判定ラダー: 資格のある tail-ids リストが同行する場合(v4)、サーバー台帳からのカウントを使用し、それ以外の場合は従来のスタンプラダーを使用; 5回連続の PROVEN ミスで、1時間保持されるブレーカーが発動する(保持中もスキャン/スタンプは継続され、真実値を再教育する)。 + +**③ Dレーン スナップショットレンダリング** (`snapshot-render.ts`, #3756): 送信プレフィックスはサーバートランスクリプト行(行 seq = メッセージアイデンティティ)からレンダリングされる; テールはクライアントの原文のまま保持される。デシンクが発生した場合 → ターン全体をレガシーにする。 + +**レガシー完全再送信。** 未変更の完全パースパス — すべてのシェイプのデフォルトであり、3つの高速レーンすべてのフォールバックセーフティネットである。レスポンスに真実値ヘッダーを再スタンプするため、ミスしたターンは1ラウンドで自己修復される。 + +## ヒット時にスキップされるもの / 正直な境界 + +スキップ対象: 本体全体の `JSON.parse` + `openaiToCore` (v5); `snapshotMessages` プレフィックスの再固定 (v5); デルタのみパース (増分); 行からのプレフィックス再レンダリング (Dレーン)。正直な境界: 要素数を保持したままのバイト書き換えは検出不能である(その信頼モデルの変更は人間レビューの階層、KDD §7.4); マルチモーダルテールがキャッシュに入った時点で、その履歴はレガシーターンに留まる(KDD #15 ②); マーカー除去カウントはシード台帳から継承される(履歴の中間は再スキャンされない)。 + +## 主要エントリ + +`src/server/fastpath.ts` · `src/server/fastpath-scan.ts` (構造的スキャナー) · `src/server/threads-lane.ts` (増分) · `src/server/snapshot-render.ts` (Dレーン) · `src/agent/pf-channel.ts` (クライアント状態機械) · `src/agent/incremental-client.ts` · `src/server/lane-decisions.ts` (ルーティング) + +## 関連 + +[lanes](./lanes.md) · [pipeline](./pipeline.md) · [identity](./identity.md) · [#5643 進化: 4つすべてがスナップショットテーブル基盤に収束](https://github.com/ranxianglei/billion-context/issues/5643) · `tests/issue5403-watermark-fastpath.test.ts` diff --git a/docs/architecture/identity.ja.md b/docs/architecture/identity.ja.md new file mode 100644 index 0000000000..c90552de14 --- /dev/null +++ b/docs/architecture/identity.ja.md @@ -0,0 +1,32 @@ +# モジュール: セッションとメッセージのアイデンティティ + +> [アーキテクチャハブ](../architecture.md) の一部 · 中国語版: [identity.zh-CN.md](./identity.zh-CN.md) · 2026-11-08 時点、master + +![セッションとメッセージのアイデンティティモジュール](./assets/identity.en.svg) +(ビットマップフォールバック: [identity.en.png](./assets/identity.en.png)) + +## 責務 + +リクエストがどのセッションに属するか、そのセッションのメッセージのうち新規と既に保存済みのものを区別し、生存しているアイデンティティから送信履歴をレンダリングする。これにより、再送信、ID の再発行、モデルの切り替えが、サマリーが参照している内容を破損させることがない。 + +## 原則 + +- **階層: msgid > order > hash (オーナールール #11)。** 有効なホスト msgid がアイデンティティを決定する(モデル間での再エンコード後も生存する)。msgid が存在しない場合、順序が一次の担い手となり、コンテンツハッシュはセルごとのハードゲートとして機能するが、グローバルな拒否権は持たない。 +- **あいまいな類似性の使用は禁止。** 誤った帰属は最もコストの高い失敗である(MESSAGE-IDENTITY.md):誤った結合は、古い参照のすべての後続の `decompress` を静かに誤った経路へルーティングさせる。 +- **推測ではなく、劣化(デグラデーション)。** 同期のずれ(チェーンの破断、ストレージの読み取り不能、ターン中の切り替えなど)が発生した場合、そのターン全体でレガシーパスにフォールバックし、真実を再スタンプして、1 ラウンドで収束させる。 + +## 動作原理 + +**セッションアイデンティティ。** クライアントのセッション ID はそのまま使用される(ネイティブの安定 ID が優先される、#280 — 漂移する派生ハッシュからアイデンティティを構築しないこと)。匿名トラフィックは `pfa-*` プレフィックスアフィニティ ID に解決される(simhash チェーン、初回書き込み者の出所 #2879/#2265)。ペルソナのフォーク: `subagentNamespace(id, systemText)` はホスト由来のペルソナを `|sub:` にフォークする — 証拠パーミットリスト(現在は dsh、#1104/#2156)、ID 下で最初に確認されたシステムが生キーをアンカーし、サイドリクエストはそれを主張できない。 + +**メッセージアイデンティティ。** プラグインレーンは、bili のエンベロープ内で要素ごとのホスト msgid を保持する(`POST /__bili/plugin/turn` の `msgIds`)— インジェスト時に除去され、モデルワイヤー上には決して載らない(#4491/#4834/#5842)。台帳キーは `(session_id, msg_id, content_hash)` のトリプルである: msgid が決定し、ハッシュは誤った結合に対する安全帯として機能する。レガシーの全量再送信セッションは、順序中心の調整ラダーを実行する: セルごとのフィンガープリントゲートを伴う位置ベースの主張、ID/コンテンツは補助証拠として使用され、各階層はソフトに失敗し、同一インデックスの合意の連続(MIN_RESYNC_RUN)で再同期する。「基盤の破壊」へのエスカレーションは、すべてのパスが失敗した後、または完全展開のドゥームループ(#2821)の場合のみ行われる。 + +**サーバーサイドレンダリング(D レーン、#3756)。** 読み取り可能な統合ストレージにバインドされたセッションでは、送信 PREFIX はサーバートランスクリプトからレンダリングされる — 行の `seq` がメッセージアイデンティティであり、署名/ハッシュはチェーンのバックトレースのみである。末尾はプレフィックスキャッシュの安定性のためにクライアント由来のまま保持される。観察(`reconcileFoldCoverage`)とレンダリングは意図的に分離されている。 + +## 主要エントリ + +`src/session-id.ts`(セッションキー + ペルソナフォーク) · `src/prefix-affinity.ts`(匿名解決) · `src/server/snapshot-render.ts`(D レーン) · `src/fold-reconcile.ts`(調整ラダー) · `src/agent/incremental-client.ts`(msgid エンベロープ) + +## 関連 + +[MESSAGE-IDENTITY](../message-identity.md) · [SESSION-IDENTITY](../session-identity.md) · [identity-channels](../identity-channels.md) · [msgid-infrastructure](../msgid-infrastructure.md) · [session-identity-resolution](../session-identity-resolution.md) · [storage](./storage.md) diff --git a/docs/architecture/kernel.ja.md b/docs/architecture/kernel.ja.md new file mode 100644 index 0000000000..e59189c876 --- /dev/null +++ b/docs/architecture/kernel.ja.md @@ -0,0 +1,37 @@ +# モジュール: 圧縮カーネル (`kernel/` — acp-kernel, リポジトリ内) + +> [アーキテクチャハブ](../architecture.md) の一部 · 中国語版: [kernel.zh-CN.md](./kernel.zh-CN.md) · 2026-11-08 時点、master、カーネル v0.0.184 + +![圧縮カーネルモジュール](./assets/kernel.en.svg) +(ビットマップフォールバック: [kernel.en.png](./assets/kernel.en.png)) + +## 責務 + +プロダクト全体の意思決定コアである。正規化されたコアとセッションの圧縮状態を受け取り、折りたたみ可能な対象を判定し、成果物(ブロック、参照、サマリー、チェックポイント)を出力し、状態の差分を返す。リポジトリ内の `kernel/` (#2092) に配置され、独自の npm アイデンティティ (`acp-kernel`) とバージョンを保持している。ビルド時に `dist/` にインラインでバンドルされ、`dist/index.js` は自己完結した状態を維持する。 + +## 原則 (カーネル境界 — `kernel/` 配下の何かを変更する前に AGENTS.md を読むこと) + +- **ランタイム依存ゼロ。** オーナーの承認なしに新しい依存関係を追加しない。コアはプラットフォーム非依存を維持する(ホスト API / ファイル I/O / ネットワークなし)。 +- **メッセージ ID は決して再利用されない。** コンテンツハッシュ ID と参照番号 (`mNNNNN`) は、メッセージが死んでも永遠にちょうど 1 つのメッセージのみを指す — モデルは過去に見た任意の番号を引用できる。 +- **ロスカレスラウンドトリップ; 保護ツールのハード除外; 正規ノード順序。** 構造不変条件であり、人間によるゲート管理を行う。 +- **常に人間によるみでのレビュー。** `kernel/**` の変更は `src/update.ts` と同じ階層に位置する: 自動マージは絶対に禁止; PR 本文には `kernel-change: ` を宣言しなければならない (CI `kernel-guard`)。 + +## 動作原理 + +**入力。** 正規化されたコア(ホスト非依存のメッセージ形式)と `CompressionState` — ブロック / 参照 / dead_refs / チェックポイント / nudge / tokenSnapshot。判定は、`applyCompression` が実行される正確な配列クラス (`applyView`, KDD #12) に対して行われる。 + +**ユニット射影。** `projectUnit` (`kernel/src/unit-projection.ts`) は唯一の折りたたみ可能性の定義である (#3236): 境界の拡大 → キャリア/カバレッジ/メディアの切り出し → 保護ゾーンからの切り出し → ターン完全性 → 空判定、そして構造化された射影または、適用側とバイト単位で同一の致命的エラーを返す。推奨側は最終ユニットをこれを通じて再スクリーニングし、致命的なユニットをギャップに降格する — 広告→拒否の振動は起きない。 + +**意思決定と出力。** fold / archive / dead-refs; サマリーテキストは 4 つの荷重プロンプトルールに従う(`tests/golden/wire-contract/kernel.json` にゴールデンピンされている); 参照番号 `mNNNNN` は一度だけ発行される; nudge の頻度は平坦な 50K 成長ステップである — 意図的にコンテキストウィンドウにスケーリングされない (#379/#380; ユーザーのエスケープハッチ `compress.nudgeGrowthTokens`)。 + +**状態出力。** 新規/更新されたブロック + 参照、署名付きチェックポイントフレーム、tokenSnapshot + 統計情報。ホストは `mergeState()` を通じて生存するフィールドをシリアライズする — フィールドリストの唯一の真実の源 (`src/state-hydration.ts`); カーネルはホストのストレージレイアウトについて決して知らない。 + +**ガード。** ホストが黙って依存している動作表面のためのゴールデンピン; 2 つのテスト層(カーネル自身のスイート + bili e2e を統合として); `verif/` はガードされた意思決定コアファイルを SMT に変換し、反例を実際の TypeScript に対してリプレイする (AGENTS.md KDD #14)。 + +## 主要エントリ + +`kernel/src/` (エンジン) · `kernel/src/state.ts` (`CompressionState`) · `kernel/src/unit-projection.ts` (`projectUnit`) · `verif/guarded-files.ts` (SMT ガード範囲) · `tests/golden/wire-contract/kernel.json` (動作ピン) + +## 関連 + +[pipeline](./pipeline.md) · [storage](./storage.md) (状態永続化) · [fastpaths](./fastpaths.md) · [AGENTS.md — カーネル境界](../../AGENTS.md) · [#5643 進化提案](https://github.com/ranxianglei/billion-context/issues/5643) (カーネルは変更されない) diff --git a/docs/architecture/lanes.ja.md b/docs/architecture/lanes.ja.md new file mode 100644 index 0000000000..78b5236a38 --- /dev/null +++ b/docs/architecture/lanes.ja.md @@ -0,0 +1,34 @@ +# モジュール: ホストレーン (`src/agent` + `src/server/lane-decisions.ts`) + +> [アーキテクチャハブ](../architecture.md) の一部 · 中国語: [lanes.zh-CN.md](./lanes.zh-CN.md) · 2026-11-08 時点、master + +![Host lanes module](./assets/lanes.en.svg) +(ビットマップフォールバック: [lanes.en.png](./assets/lanes.en.png)) + +## 責務 + +このモジュールは、リクエストごとに3つの質問に答える。誰がそれを運んできたか(どのホスト、どのプラグイン)、どのアイデンティティに属するか(セッション、ペルソナ、メッセージ)、そしてどの処理レーンを通るかである。`src/agent/` はホストプロセス内で実行されるホストごとのプラグインコードを保持し、サーバー側の `lane-decisions.ts` は単一の解決器(resolver)である。 + +## 原則 + +- **1リクエスト = 1レーン。** `lane-decisions.ts` (#3417) によってリクエストごとに決定され、セッションごとにスティッキー(粘着性)であり、アップグレードのみ許可される(セッションがサイレントにダウングレードされることはない)。 +- **ゲートの規律。** すべての抑制/劣化ゲートは、両方向のアサーションを伴ってリリースされる — `tests/lane-decisions-matrix.test.ts` (#3617) 内の正の行と負の行の両方である。負の行を伴わないゲートは、定義上不完全である。 +- **エンベロープのみアイデンティティ。** ホストの msgid とスタンプされたヘッダーは bili のプライベートエンベロープ内で移動し、取り込み時に除去される。それらはモデルワイヤー上には決して現れない(msgid > order > hash, AGENTS.md #11)。 + +## 動作原理 + +**ホストプラグイン(ホストごと)。** dsh シム(anthropic-wire ターンを迂回し、openai 形状は完全な再送を維持 — #3433) · pi エントリーウォーカー(omp は同じエントリを再エクスポート) · opencode V1/V2 トランスフォームフック · codex Responses-over-WebSocket · claude フック(レーントークン、#5095) · kimi / zcode ネイティブ TOML レーン。各ホストレーンには `-native` ブートストラップゲートがあり、`native-intercept.ts` はホストの fetch トラフィックを帰属ヘッダー付きでプロキシにルーティングする。 + +**アイデンティティと帰属。** セッション ID はリクエストヘッダーからそのまま取得される(ネイティブ安定 ID が優先、#280)。匿名トラフィックはプレフィックスアフィニティ(`pfa-*`、ファーストライター由来 #2879、simhash チェーン #2265)によって解決される。dsh のペルソナフィンガープリントは証拠パーミットリスト(#1104/#2156)である:1つの ID を複数のペルソナ間で再利用することが証明されたホストのみが `|sub:` セッションにフォークする。ID 下で最初に見られたシステムが生のキーをアンカーし、サイドリクエストはそれを主張できない(#2156/#2160)。注入破損状態は `/__bili/status` の `attribution` 経由で可視化される(#3581)。 + +**解決器。** `lane-decisions.ts` はリクエスト形状 × セッションスティッキーバインディング(#5643 基盤レーン用の計画行1つ、負+正のペア)をマッチングし、以下を選択する:増分プラグインターンレーン / v5 ウォーターマーク / Dレーンスナップショットレンダリング / レガシー完全再送。 + +**処理レーン。** 3つのファストレーンについては [fastpaths モジュール](./fastpaths.md) を参照。レガシー完全再送はすべての形状のデフォルトであり、それらすべてのフォールバックセーフティネットである。 + +## 主要エントリ + +`src/agent/plugin.ts` (x-bili-plugin レーン) · `src/agent/dsh-*` · `src/agent/pi*.ts` · `src/agent/opencode*.ts` · `src/agent/native-intercept.ts` · `src/server/lane-decisions.ts` · `src/launcher.ts` (`bili ` ポスチャー) · `tests/lane-decisions-matrix.test.ts` + +## 関連 + +[fastpaths](./fastpaths.md) · [identity](./identity.md) · [pipeline](./pipeline.md) · [identity-channels](../identity-channels.md) · [msgid-infrastructure](../msgid-infrastructure.md) diff --git a/docs/architecture/pipeline.ja.md b/docs/architecture/pipeline.ja.md new file mode 100644 index 0000000000..08da5f62f1 --- /dev/null +++ b/docs/architecture/pipeline.ja.md @@ -0,0 +1,38 @@ +# モジュール: リクエストパイプライン (`src/server` + `src/loop`) + +> [アーキテクチャハブ](../architecture.md) の一部 · 中国語版: [pipeline.zh-CN.md](./pipeline.zh-CN.md) · 2026-11-10 時点, master + +![Request pipeline module](./assets/pipeline.en.svg) +(ビットマップフォールバック: [pipeline.en.png](./assets/pipeline.en.png)) + +## 責務 + +プロキシに到達するすべてのモデルトラフィックのリクエストは、このモジュールを通過します。受信バイト列はストリップおよびトリアージ(分類)され、ホスト非依存のコア形式に変換され、カーネルのフォールド判定を通過し、クライアントのワイヤー形式に再シリアライズされ、レスポンス側の書き換えを伴ってストリームとして返されます。管理トラフィック (`/__bili/*`, `/__acp/*`) は事前にトリアージで除外され、[webui モジュール](./webui.md) に送られます。 + +## 原則 + +- **1つのパイプライン、4つのワイヤー。** Anthropic、OpenAI chat-completions、Responses、Google それぞれに `prepare-*` と `stream-*` アダプタが用意され、中間部分は共有されます。変更は両方の圧縮モード(AGENTS.md §6)で論理的に検討する必要があります — 1つのモードで正しくても、もう1つのモードを壊す可能性があります (#377)。 +- **1つのフォールダビリティ定義。** レンジがフォールダブル(折りたたみ可能)かどうかは、カーネルの `projectUnit` によって決定され、バイト単位で同一に適用されます (KDD #12, #3236) — 推奨と適用は決して不一致になりません。 +- **重要な箇所ではバイト単位で正確に。** ツールコールの引数はユーザーの意図であり、バイト単位で正確に転送され、決してフィルタリングされません (#1039)。思考系ブロックは署名検証され、決して書き換えられません (#1960) — 散文フィルタはテキストチャネル専用です。 + +## 動作原理 + +**受信 (Inbound)。** マーカーストリップ (`src/marker/`) は、ワイヤーごとに ACP レンダリングタグを認識・除去する順序付きパイプラインです。`handle.ts` はルートをトリアージし、ワイヤーを検出してから、対応する `prepare-*` に引き継ぎます。 + +**準備 (Prepare) (ワイヤーごと)。** `prepare-anthropic` / `prepare-openai` / `prepare-responses` / `prepare-google` は、リクエストを正規コアに変換します(ホスト msgid などのインフライトエンベロープフィールドはここでストリップされます — [identity](./identity.md) を参照)、フォールド→再構築→注入のシーケンスを実行し、そのワイヤーが要求する場所にシステムメッセージとナッジを配置します。 + +**カーネル。** 正規コアとセッションの `CompressionState` が acp-kernel に渡され、判定とその成果物が返されます — [カーネルモジュール](./kernel.md) を参照してください。 + +**統一ループ (`src/loop`)。** 4つのワイヤーアダプタを持つプロトコル非依存のコアが、ツール裁定と散文タグエコーフィルタ (`tag-echo-filter.ts` — 散文のみ、引数は変更なし) を実行します。ここが2つの圧縮モードが同じコードパスを維持する場所です (KDD #7): プラグインモードではエージェントが圧縮を所有するためツール+ナッジ注入が抑制され、プロキシモードでは `acp_summary` キャリアを出力し、厳格なバックエンドが安定したプレフィックスを維持できるようユーザーメッセージとして再表現されます。 + +**送信 (Egress)。** `stream-*` はワイヤーごとにアップストリームの SSE を書き換えます(チャンクフレーミング、キャッシュコントロールブレークポイント #1637、`wire-body` トレーリングユーザーターン追加)。リクエスト側では、ユーザー登録可能な `egressTransforms[]` パイプライン (`src/egress-transforms.ts`, #6003) が、セッション処理の後で再署名/v1Wrap の前に、すべての送信モデルリクエストボディに対して ESM プラグインを実行します — プラグインごとにフェイルオープン、`/__bili/config/reload` によるホットリロード可能、未設定時は完全な何もしません (no-op)。プロトコルヘッダー (pf-*/envelope) はプロキシから決して外に出ません — アップストリームのホップヘッダーリストがそれらを除去します。 + +**ゲートとリカバリ。** `preflight.ts` (ホールドグレース、デッドエンドクールダウン)、`reasoning-guard` (署名済みペイロードは決してフォールド入力にならない)、`request-body-budget` (受信/デコード/送信バイト上限、パフォーマンスより可用性 #3128)、`content-encoding` (デコンプレッションボムガード、413)。エラー形状: `stream-error` (最小限の SSE エラー + 終了)、`fake-completion` (オプトインのリトライヒント)、`degenerate-turn` / `degenerate-retry`、および `exit-matrix` (ワイヤー終了 × 懸念事項、#588)。 + +## 主要エントリ + +`src/server/handle.ts` (トリアージ) · `src/server/prepare-*.ts` (ワイヤーごとのリクエスト準備) · `src/marker/` (受信タグストリップ) · `src/loop/` (統一コア + アダプタ) · `src/server/stream-*.ts` (ワイヤーごとの送信) · `src/egress-transforms.ts` (ユーザー送信ボディ書き換えプラグイン、#6003) · `src/server/preflight.ts` · `src/server/exit-matrix.ts` + +## 関連 + +[lanes](./lanes.md) · [kernel](./kernel.md) · [fastpaths](./fastpaths.md) · [storage](./storage.md) · [MESSAGE-IDENTITY](../message-identity.md) diff --git a/docs/architecture/storage.ja.md b/docs/architecture/storage.ja.md new file mode 100644 index 0000000000..062c152881 --- /dev/null +++ b/docs/architecture/storage.ja.md @@ -0,0 +1,41 @@ +# モジュール: 統合ストレージ (`src/persist.ts` + `src/storage/`) + +> [アーキテクチャハブ](../architecture.md) の一部 · 中国語版: [storage.zh-CN.md](./storage.zh-CN.md) · 2026-11-08 時点、master、スキーマ v11 + +![統合ストレージモジュール](./assets/storage.en.svg) +(ビットマップフォールバック: [storage.en.png](./assets/storage.en.png)) + +## 責務 + +プロセス再起動後も保持されなければならないすべてのデータは、単一の SQLite ファイルに格納される: セッション、メッセージ行、コンテンツ、圧縮ブロックとその参照台帳、チェックポイント、通知ストアとセッション拡張で使用される `kv_store`、およびメディアである。`src/persist.ts` はレガシーなセッションファイルのファサード(StateStore ラッパー、EPERM アラート層)であり、`src/storage/` は統合された行レベルのストアである。 + +## 原則 + +- **単一の WAL ライター。** 単一の SQLite ファイル、単一の書き込みパス(バッチ処理された `ingest.ts`)により、リーダーがライターと競合することがない。 +- **正規 ID、ホスト ID ではない。** `messages.msgId` には bili/kernel の正規 ID(`identityOfStoredContent`)が保存される。ホストの要素ごとの msgid は進行中のエンベロープフィールドであり、まだストレージには格納されない(ペインポイント 2 — #5643 提案の `l1_world` テーブルが予定された格納先である)。 +- **安定した絶対 seq (#421 修正)。** 行の順序はメッセージアイデンティティの主要な担い手である。フォールディングは行を非アクティブにマークするだけで、物理的に削除することはない(GC はカバーブロックのライフサイクルに基づいてパージする)。 +- **追加的なマイグレーションのみ。** スキーマバージョンは前方に進む。古い DB は `CREATE IF NOT EXISTS` 経由で移行される — 破壊的なマイグレーションには、まずロールバックドリルが必要である(T1 規律、#5643 テストマトリクス)。 + +## 動作原理 + +**書き込み側。** インジェストパスは統合ビューをバッチ書き込みする(安定した絶対 seq; `identityOfStoredContent` によるコンテンツハッシュ ID; バウンダリフレーム `boundaryMsgId` はバッチとともに格納される)。`persist.ts` はセッションファイルの保存/読み込みと EPERM アラート層を処理する。カーネルは、カーネルが提供する StateStore インターフェースを通じて圧縮状態(ブロック / 参照 / dead_refs / チェックポイント)を書き込む — ホストは実装を差し替える。 + +**kstate JSON は並列の第二の真実の源である(ペインポイント 1)。** 残存する `CompressionState` フィールドリストは `mergeState()` によってシリアライズされる(フィールドリストの単一の源 — `src/state-hydration.ts`)であり、テーブルとともに読み書きされる — 二重チャネルである。#5643 の進化により、カーネル状態のシリアライズは `snap_ckpt.meta_json` 内に移動され、テーブルが唯一の源となる。 + +**読み込み側。** ハイドレーションは、残存フィールドの単一の源として `mergeState()` を使用する(テーブル + kstate が組み立てられる)。エグレスはフォールディングカバレッジチェックとサーバーサイドの正規レンダリングを実行する(D レーン、#3756 — どのデシンクもレガシーパスにフォールバックし、デグレードしても推測しない)。課金とキャッシュ台帳(`cache-ledger`、`store.ts` 内の CCR 取得)および表示/エクスポートサーフェス(`sessions-data`、`acp_status`、`export` — 誠実な出力、#155)はすべて同じ行を読み取る。メンテナンスは `state-gc` / `storage-maintenance` / オルファン GC(`sessions.gc_*` でのストレージ GC、オプトイン、dead-ref の回収)である。 + +**整合性。** チェックポイントフレーム署名 + S4 行ごとのチェックサム; 判定はチェーンを信頼し、コンテンツの類似性を決して信頼しない。任意の静止時エンコーディング: AES-256-GCM (#708) + zstd (#1080)。`src/storage/mysql.ts` 配下の mysql ダイアレクトはテストミラーのみである(mysql-contract CI レーン) — SQLite が本番ストレージであり続ける。 + +## 厳格な不変条件(これに触れる前に AGENTS.md を参照すること) + +- メッセージ ID は決して再利用されない(カーネル契約); `messages.msgId` は正規 ID である。 +- 行の順序 = アイデンティティの担い手; フォールディング = 非アクティブマーク、物理削除ではない。 +- アップグレードは純粋に追加的である; 破壊的な変更の前にロールバックドリルを行う。 + +## 主要なエントリ + +`src/storage/schema.ts`(単一の DDL 真実の源) · `src/storage/store.ts`(行の読み書き) · `src/storage/ingest.ts`(バッチエントリ) · `src/persist.ts`(StateStore ラッパー) · `src/state-hydration.ts`(残存フィールドリスト) + +## 関連 + +[message-identity](../message-identity.md) · [session-identity](../session-identity.md) · [#5643 進化提案 (PR #5873)](https://github.com/ranxianglei/billion-context/issues/5643) diff --git a/docs/architecture/update.ja.md b/docs/architecture/update.ja.md new file mode 100644 index 0000000000..2eb56fb0e3 --- /dev/null +++ b/docs/architecture/update.ja.md @@ -0,0 +1,38 @@ +# モジュール: self-update & install lanes (`src/update.ts` + lane modules) + +> [アーキテクチャハブ](../architecture.md) の一部 · 中文: [update.zh-CN.md](./update.zh-CN.md) · 2026-11-08 時点, master + +![Self-update module](./assets/update.en.svg) +(ビットマップフォールバック: [update.en.png](./assets/update.en.png)) + +## 責務 + +マシン上のすべての bili コピーを、何も壊すことなく最新バージョンに更新すること。そして、コピー間の永続的な分岐を検出可能なバグとして扱うこと。これは、モジュール自身のバグが将来のすべてのリリースを障害に変えてしまう唯一のモジュールであり、そのため、変更をリリースする前に NO-OP 検証リリースプロトコルを適用し、人間レビュー層 (§7.4) に位置付けられている。 + +## 原則 + +- **コピーごとに 1 つのライターを、インストールソースで選択する (#991/#1196)。** ホスト自身のチャネル(dsh market、opencode/pi マネージャー、pnpm store)を通じてインストールされたコピーは、そのホストが所有するものとする: bili は決してそのコピーをインプレースで書き換えない。 +- **すべてのコピーに LIVE な更新パスがある。** グローバルな自己更新、またはグローバル dist への参照、またはホストのチャネル——「永遠に凍結」は、この契約が存在する理由であるバグクラスである。 +- **一時的なものは有界であり、永続的なものはバグである。** レーンは、1 つのチェックサイクル(約 3 分)とホストの再起動以内にレジストリバージョンへ収束する。 + +## 動作原理 + +**セルフアップデータ (`update.ts`)。** デフォルトでは 3 分ごとに npm レジストリをチェックする (`CHECK_INTERVAL_MS`、ノブで上書き可能 #2030; プロセスごとの最初のチェックはスロットリングを無視する)。更新は tarball の展開であり、`npm install` ではない——ユーザーの環境ではライフサイクルスクリプトは決して実行されない。グローバルインストールはインプレースで切り替わる。プラグインモードでは、注入されたコードは HOST プロセス内に存在する: 新しいコードはホストの再起動後にのみ有効になり、壊れた注入はモデルトラフィックを非圧縮の直接通信に劣化させる——パネルのバナーと `/__bili/status` の `attribution` で確認可能 (#3581)。 + +**インストールレーン。** グローバル (`npm i -g`、自己更新) · 参照レーン (omp/claude/codex/kimi/zcode/hermes — コピーなし、グローバル dist を指す) · ホストワールド (dsh プロファイルバンドル、opencode/pi ツリー — ホスト自身のチャネルを通じて更新され、グローバル自己更新と、グローバルが実行されない場合のコピー自身の定期的チェックによって駆動される、#1196) · ランチャー (`bili ` オーバーレイモード: 永続コピーゼロ)。 + +**台帳の収束。** デスクトップの dsh プロファイルは、bili が完全に所有する唯一のコピーである; その自己修復は `node_modules/billion-context` を直接切り替えるため、`convergeDshLedger` (`src/dsh-ledger.ts`) は、プロファイルマニフェストの宣言された spec と、ロックファイルに記録された解決結果を同じ操作で移動する (#3496) — コピーのみを移動するライターは、#3224 が検出するドリフトを生み出す。既存のドリフトは明示的な要求時のみ収束する: `bili doctor --fix`。`plugin-install.ts` はホスト自身のチャネル (`dsh plugin add`) のみ駆動し、その隣に第二のコピーをインストールすることは決してしない (#966)。 + +**助言と再起動。** `advisory.ts` は重大な欠陥を監視し、助言を提出する (#1481 — 人間が行動し、マシンは決して自動的にロールバックしない); `update-notes.ts` は階層化されたリリースノートを持つ(デフォルトでは重大なもののみ、#1870); `restart.ts` は新しいコードがディスク上に存在した時点で、オプトインの自己再起動を提供する (#811)。 + +## 厳格なルール + +人間レビュー層 (§7.4) — 自動マージなし; `update.ts` の変更にはまず NO-OP 検証リリースが必要; `link:`/`file:` 開発ピンは決して更新されない (`isRegistryDepSpec` ゲート); npm publish はリリース PR のマージ時の CI 経由でのみ発生する。 + +## 主要エントリ + +`src/update.ts` (アップデータ — 重要) · `src/advisory.ts` · `src/restart.ts` · `src/plugin-install.ts` · `src/dsh-ledger.ts` · `src/dsh-channel.ts` · `src/pi-channel.ts` · `src/launcher.ts` + +## 関連 + +[webui](./webui.md) (更新アクションのサーフェス) · [AGENTS.md — Install-Lane & Update-Ownership Contract](../../AGENTS.md) · [reference/release.md](../../reference/release.md) diff --git a/docs/architecture/webui.ja.md b/docs/architecture/webui.ja.md new file mode 100644 index 0000000000..29070ad5cf --- /dev/null +++ b/docs/architecture/webui.ja.md @@ -0,0 +1,34 @@ +# モジュール: Web パネルと管理画面 (`src/web` + `src/server/admin.ts`) + +> [アーキテクチャハブ](../architecture.md) の一部 · 中国語版: [webui.zh-CN.md](./webui.zh-CN.md) · 2026-11-08 時点、master + +![Web パネルモジュール](./assets/webui.en.svg) +(ビットマップフォールバック: [webui.en.png](./assets/webui.en.png)) + +## 責務 + +プロキシに関する人間が見るすべてのもの: セッションブラウザ、ログ、設定、更新、通知、そして ACP ネイティブのエージェントも呼び出すマシン向けの管理ルート (`/__bili/*`、`/__acp/*`)。パネルは [ストレージモジュール](./storage.md) に対するビューであり、データを所有することはない。 + +## 原則 + +- **パネルは嘘をつかない。** 0 ブロックのセッションは「元の会話」として何もエクスポートしない (#155); ストレージの劣化は隠蔽せず表面化される (`runtime-status`); すべてのデータ行は、その出典となったストレージ行に追跡可能である。 +- **通知チャネルは一つ。** すべてのバナーは `mergedNotices()` に対する一つのループを介して流れる — ビルトイン (S)、リモートフィード (A)、ローカルファイル (B); 同一 ID は B>A>S の順でシャドウイングされる (#5548)。個別のフィードフェッチャー、却下ストア、インラインバナーは存在しない。 +- **管理画面はゲートされている。** ループバック + 信頼できるオリジンチェック (#1440) — この画面はパブリック API ではなく、コントロールプレーンである。 + +## 動作原理 + +**ルート。** `admin.ts` は `/__bili/*` と `/__acp/*` を所有する: ステータス (`attribution` フィールドにより壊れたプラグインの注入が可視化される、#3581)、概要、セッション + 詳細、ログ、設定、プラグイン、ウォッチャー、アップストリーム。ACP ネイティブのエージェントは、compress/decompress/acp_status に同じルートを使用する。 + +**データソース。** ライブセッションプールとストレージ行 (ティアツリー、#3917); `acp_status` の範囲/nudge はレンダリングごとに LIVE で再計算され、古いキャッシュは決して使われない (`acp-status.ts`); キャッシュ台帳の経済性 (`cache-ledger.ts`、#1536); 回収期間ビュー付きの USD 価格での請求 (#4899); 統合ストレージ (kv_store 名前空間 `notices`) 内の通知却下レシート。 + +**レンダリング。** サーバーレンダリングされた HTML シェル (`page.ts`) + 単一の JS バンドル (`client.ts`) + スタイル; `i18n.ts` は zh-CN/en のメッセージテーブルを保持する (デッドキーはテストでガードされる); `mdrender.ts` はエスケープ優先の Markdown + 構文ハイライトのコア単体である (json/diff/js/ts/py/sh 用の手書きレクサ、GitHub ライト+ダークパレット、ランタイム依存ゼロ — JSONC ヘルパーと同様に `.toString()` 経由でブラウザ IIFE にインライン化される)、そして `markdown.ts` はサーバーサイド (ブログ記事 + ハンドオフフォールバック) 用にこれをラップする; `report.ts` は依存関係のない MD+SVG セッションレポートを構築する; `diagnostics.ts` は issue レポート用の貼り付け可能なブロブを生成する (#3040)。 + +**通知。** `mergedNotices()` (`src/announcements.ts`) は 3 つのソースをマージする; リモートフィードはこのリポジトリの `announcements/remote.json` であり、約 3 分間のウォッチャー周期でポーリングされ、フェイルオープン (フェッチの問題は最後に既知の正常なスナップショットを保持する; モデルトラフィックには決して影響を与えない); ビルトイン通知は `tests/notice-registry.test.ts` によってデッドキーガードされる。 + +## 主要エントリ + +`src/server/admin.ts` (ルート) · `src/web/` (シェル、バンドル、i18n、レポート、診断) · `src/announcements.ts` (通知レジストリ) · `src/notices.ts` (ビルトイン) · `src/remote-notices.ts` (フィードポーラー) · `src/notice-store.ts` (レシート) + +## 関連 + +[ストレージ](./storage.md) · [更新](./update.md) (更新アクションはパネル内に存在する、#3719) · [設定](../configuration.md) · `announcements/remote.json` From 4d3e72ee656e4db534f551d93010901bb05f8c2a Mon Sep 17 00:00:00 2001 From: ranxianglei Date: Thu, 12 Nov 2026 23:37:35 +0800 Subject: [PATCH 15/17] docs: ja hub/module pages link to ja hub; add English link in ja hub --- docs/architecture.ja.md | 1 + docs/architecture/fastpaths.ja.md | 2 +- docs/architecture/identity.ja.md | 2 +- docs/architecture/kernel.ja.md | 2 +- docs/architecture/lanes.ja.md | 2 +- docs/architecture/pipeline.ja.md | 2 +- docs/architecture/storage.ja.md | 2 +- docs/architecture/update.ja.md | 2 +- docs/architecture/webui.ja.md | 2 +- 9 files changed, 9 insertions(+), 8 deletions(-) diff --git a/docs/architecture.ja.md b/docs/architecture.ja.md index 0dae716354..1a65cf82d0 100644 --- a/docs/architecture.ja.md +++ b/docs/architecture.ja.md @@ -2,6 +2,7 @@ > システムのアーキテクチャに関するハブページです。このページには**全体図**と**モジュール台帳**を掲載しています。各モジュールは、このディレクトリ内に独自のページ(英語 + `.zh-CN`)を持ち、それぞれに独自の図が用意されています。 > 中国語版: [architecture.zh-CN.md](./architecture.zh-CN.md) +> English: [architecture.md](./architecture.md) > > **ライブドキュメント(オーナー裁定 2026-11-08)。** モジュール境界、図示されたデータフロー、テーブル、レーン、またはワイヤーパスを変更する PR は、同じ PR 内で影響を受けるページ、図、およびこのハブテーブルを更新する必要があります。CI は機械的な部分(`tools/check-architecture-docs.mjs`)を強制します。ルールの本文は [AGENTS.md](../AGENTS.md) の "Documentation Layout" セクションにあります。 diff --git a/docs/architecture/fastpaths.ja.md b/docs/architecture/fastpaths.ja.md index 13846d8d86..f610a2d780 100644 --- a/docs/architecture/fastpaths.ja.md +++ b/docs/architecture/fastpaths.ja.md @@ -1,6 +1,6 @@ # モジュール: fastpaths (増分レーン / v5 ウォーターマーク / Dレーン / レガシー) -> [アーキテクチャハブ](../architecture.md) の一部 · 中国語版: [fastpaths.zh-CN.md](./fastpaths.zh-CN.md) · 2026-11-08 時点、master +> [アーキテクチャハブ](../architecture.ja.md) の一部 · 中国語版: [fastpaths.zh-CN.md](./fastpaths.zh-CN.md) · 2026-11-08 時点、master ![Fastpaths module](./assets/fastpaths.en.svg) (ビットマップフォールバック: [fastpaths.en.png](./assets/fastpaths.en.png)) diff --git a/docs/architecture/identity.ja.md b/docs/architecture/identity.ja.md index c90552de14..80973ce048 100644 --- a/docs/architecture/identity.ja.md +++ b/docs/architecture/identity.ja.md @@ -1,6 +1,6 @@ # モジュール: セッションとメッセージのアイデンティティ -> [アーキテクチャハブ](../architecture.md) の一部 · 中国語版: [identity.zh-CN.md](./identity.zh-CN.md) · 2026-11-08 時点、master +> [アーキテクチャハブ](../architecture.ja.md) の一部 · 中国語版: [identity.zh-CN.md](./identity.zh-CN.md) · 2026-11-08 時点、master ![セッションとメッセージのアイデンティティモジュール](./assets/identity.en.svg) (ビットマップフォールバック: [identity.en.png](./assets/identity.en.png)) diff --git a/docs/architecture/kernel.ja.md b/docs/architecture/kernel.ja.md index e59189c876..295e0d9d02 100644 --- a/docs/architecture/kernel.ja.md +++ b/docs/architecture/kernel.ja.md @@ -1,6 +1,6 @@ # モジュール: 圧縮カーネル (`kernel/` — acp-kernel, リポジトリ内) -> [アーキテクチャハブ](../architecture.md) の一部 · 中国語版: [kernel.zh-CN.md](./kernel.zh-CN.md) · 2026-11-08 時点、master、カーネル v0.0.184 +> [アーキテクチャハブ](../architecture.ja.md) の一部 · 中国語版: [kernel.zh-CN.md](./kernel.zh-CN.md) · 2026-11-08 時点、master、カーネル v0.0.184 ![圧縮カーネルモジュール](./assets/kernel.en.svg) (ビットマップフォールバック: [kernel.en.png](./assets/kernel.en.png)) diff --git a/docs/architecture/lanes.ja.md b/docs/architecture/lanes.ja.md index 78b5236a38..e5ade58f26 100644 --- a/docs/architecture/lanes.ja.md +++ b/docs/architecture/lanes.ja.md @@ -1,6 +1,6 @@ # モジュール: ホストレーン (`src/agent` + `src/server/lane-decisions.ts`) -> [アーキテクチャハブ](../architecture.md) の一部 · 中国語: [lanes.zh-CN.md](./lanes.zh-CN.md) · 2026-11-08 時点、master +> [アーキテクチャハブ](../architecture.ja.md) の一部 · 中国語: [lanes.zh-CN.md](./lanes.zh-CN.md) · 2026-11-08 時点、master ![Host lanes module](./assets/lanes.en.svg) (ビットマップフォールバック: [lanes.en.png](./assets/lanes.en.png)) diff --git a/docs/architecture/pipeline.ja.md b/docs/architecture/pipeline.ja.md index 08da5f62f1..f35ddce2aa 100644 --- a/docs/architecture/pipeline.ja.md +++ b/docs/architecture/pipeline.ja.md @@ -1,6 +1,6 @@ # モジュール: リクエストパイプライン (`src/server` + `src/loop`) -> [アーキテクチャハブ](../architecture.md) の一部 · 中国語版: [pipeline.zh-CN.md](./pipeline.zh-CN.md) · 2026-11-10 時点, master +> [アーキテクチャハブ](../architecture.ja.md) の一部 · 中国語版: [pipeline.zh-CN.md](./pipeline.zh-CN.md) · 2026-11-10 時点, master ![Request pipeline module](./assets/pipeline.en.svg) (ビットマップフォールバック: [pipeline.en.png](./assets/pipeline.en.png)) diff --git a/docs/architecture/storage.ja.md b/docs/architecture/storage.ja.md index 062c152881..e7e7785843 100644 --- a/docs/architecture/storage.ja.md +++ b/docs/architecture/storage.ja.md @@ -1,6 +1,6 @@ # モジュール: 統合ストレージ (`src/persist.ts` + `src/storage/`) -> [アーキテクチャハブ](../architecture.md) の一部 · 中国語版: [storage.zh-CN.md](./storage.zh-CN.md) · 2026-11-08 時点、master、スキーマ v11 +> [アーキテクチャハブ](../architecture.ja.md) の一部 · 中国語版: [storage.zh-CN.md](./storage.zh-CN.md) · 2026-11-08 時点、master、スキーマ v11 ![統合ストレージモジュール](./assets/storage.en.svg) (ビットマップフォールバック: [storage.en.png](./assets/storage.en.png)) diff --git a/docs/architecture/update.ja.md b/docs/architecture/update.ja.md index 2eb56fb0e3..df65eac377 100644 --- a/docs/architecture/update.ja.md +++ b/docs/architecture/update.ja.md @@ -1,6 +1,6 @@ # モジュール: self-update & install lanes (`src/update.ts` + lane modules) -> [アーキテクチャハブ](../architecture.md) の一部 · 中文: [update.zh-CN.md](./update.zh-CN.md) · 2026-11-08 時点, master +> [アーキテクチャハブ](../architecture.ja.md) の一部 · 中文: [update.zh-CN.md](./update.zh-CN.md) · 2026-11-08 時点, master ![Self-update module](./assets/update.en.svg) (ビットマップフォールバック: [update.en.png](./assets/update.en.png)) diff --git a/docs/architecture/webui.ja.md b/docs/architecture/webui.ja.md index 29070ad5cf..eda6431d92 100644 --- a/docs/architecture/webui.ja.md +++ b/docs/architecture/webui.ja.md @@ -1,6 +1,6 @@ # モジュール: Web パネルと管理画面 (`src/web` + `src/server/admin.ts`) -> [アーキテクチャハブ](../architecture.md) の一部 · 中国語版: [webui.zh-CN.md](./webui.zh-CN.md) · 2026-11-08 時点、master +> [アーキテクチャハブ](../architecture.ja.md) の一部 · 中国語版: [webui.zh-CN.md](./webui.zh-CN.md) · 2026-11-08 時点、master ![Web パネルモジュール](./assets/webui.en.svg) (ビットマップフォールバック: [webui.en.png](./assets/webui.en.png)) From c5b7ac06acc4a97c9e278102309ff38b0735d3af Mon Sep 17 00:00:00 2001 From: ranxianglei Date: Fri, 13 Nov 2026 00:22:33 +0800 Subject: [PATCH 16/17] docs: add Japanese version of configuration.md + generator/guard/CI support (#6072) - gen-config-docs.mjs: ja seed field (desc_ja, required), ja param-ref and env-map blocks written to docs/configuration.ja.md; EN/ZH/main.js/html output byte-identical - all 8 config-reference seeds: 339 desc_ja entries - check-architecture-docs.mjs: ja hub/module-page rules (ledger parity with EN hub, EN-diagram reuse) - ci.yml docs-sync lane now drift-checks docs/configuration.ja.md too - configuration.md / configuration.zh-CN.md: three-language switch line --- .github/workflows/ci.yml | 2 +- docs/configuration.ja.md | 2669 +++++++++++++++++++++ docs/configuration.md | 2 +- docs/configuration.zh-CN.md | 2 +- tools/check-architecture-docs.mjs | 29 +- tools/gen-config-docs.mjs | 59 +- website/config-reference/compress.yaml | 75 + website/config-reference/diagnostics.yaml | 22 + website/config-reference/env-only.yaml | 68 + website/config-reference/process.yaml | 67 + website/config-reference/providers.yaml | 20 + website/config-reference/rollout.yaml | 10 + website/config-reference/server.yaml | 63 + website/config-reference/updates.yaml | 14 + 14 files changed, 3075 insertions(+), 27 deletions(-) create mode 100644 docs/configuration.ja.md diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 9861032aca..bdecc423b7 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -550,7 +550,7 @@ jobs: node-version: 22 - run: node tools/gen-config-docs.mjs generate - name: Fail on artifact drift - run: git diff --exit-code -- docs/configuration.md docs/configuration.zh-CN.md website/main.js website/docs/index.html + run: git diff --exit-code -- docs/configuration.md docs/configuration.zh-CN.md docs/configuration.ja.md website/main.js website/docs/index.html # #2107 drift guard B: every BILI_*/ACP_* env var read in src/ and every # FileConfig top-level key must have a seed entry — an undocumented param diff --git a/docs/configuration.ja.md b/docs/configuration.ja.md new file mode 100644 index 0000000000..2c3f3a6b05 --- /dev/null +++ b/docs/configuration.ja.md @@ -0,0 +1,2669 @@ +# billion-context 設定リファレンス + +[English](configuration.md) | [中文](configuration.zh-CN.md) | [日本語](configuration.ja.md) + +`billion-context` は、LLM API ストリームに [ACP](https://github.com/ranxianglei/acp-kernel)(Active Context Pruning)コンテキスト圧縮を注入する HTTP プロキシです。以下のすべてのオプションは、単一の JSON 設定ファイル(または同等の環境変数 / CLI フラグ)内に定義されます。 + +--- + +## 設定ファイルの場所 + +| スコープ | パス | 備考 | +|-------|------|-------| +| **設定ファイル (Linux)** | `~/.config/billion-context/billion-context.json` | XDG Base Directory — 正規の、ユーザーが編集可能な設定 | +| **設定ファイル (オーバーライド)** | `XDG_CONFIG_HOME` の値 | 設定ディレクトリ全体を再配置します | +| **設定ファイル (明示指定)** | `BILI_CONFIG_FILE` の値 | 任意の JSON ファイルを直接指します | +| **CLI フラグ** | `--config ` | `BILI_CONFIG_FILE` と同じ; ファイルパスに対して最優先 | +| **セッションデータ** | `~/.local/share/billion-context/sessions/` | 永続化された圧縮状態、時間とともに増加します | + +初回実行時、`billion-context` は設定パスに空のテンプレート (`{ "providers": {} }`) をシードし、編集対象を用意します。既存のファイルを上書きすることはありません。 + +設定ファイルは純粋なオーバーライドレイヤーであり、すべてのフィールドは任意です。未設定の項目は組み込みのデフォルト値にフォールバックします。 + +--- + +## クイックスタート + +```jsonc +// ~/.config/billion-context/billion-context.json +{ + // Server + "port": 8787, + "host": "127.0.0.1", + + // Route two providers + "providers": { + "https://api.anthropic.com": { + "models": { + "claude-sonnet-4-5": { "context": 200000, "output": 8192 } + } + }, + "https://generativelanguage.googleapis.com": { + "models": { + "gemini-2.5-pro": { "context": 1000000 } + } + } + }, + + // Global compression tuning (applies to every request) + "compress": { + "maxContextLimit": "75%", + "emergencyThresholdPercent": "95%" + } +} +``` + +--- + +## パラメータリファレンス + +ステータス凡例: **ACTIVE** = 現在使用中 | **DEPRECATED** = 受け入れられるが効果なし | **EXPERIMENTAL** = 変更される可能性あり + +以下インデックスは `website/config-reference/*.yaml` から生成 — シードを編集してから `node tools/gen-config-docs.mjs generate` を実行;このブロックを手で編集しないこと。 + +**サーバー & コア** + +| キー | 型 | デフォルト | 環境変数 | 説明 | +|-----|------|---------|-----|-------------| +| `port` | number | 8787 | ACP_PORT, PORT | プロキシがリッスンするTCPポート(ユーザーゾーン;レーンスポーンされたプロキシは `BILI_ZONE_PORT` を使用)。 | +| `host` | string | 127.0.0.1 | ACP_HOST | バインドアドレス。127.0.0.1 = ループバック専用;:: = デュアルスタック;0.0.0.0 は外部に公開(認証なし — 信頼できるネットワークのみ)。 | +| `sessionHeader` | string | x-acp-session | ACP_SESSION_HEADER | 会話IDを保持するHTTPヘッダー;同じ値は圧縮状態を共有する。 | +| `log` | boolean | true | ACP_LOG | リクエストごとのログ記録マスタースイッチ。 | +| `logFile` | string | XDG state path (off disables the file, keeps stderr) | ACP_LOG_FILE | `bili.log` の明示的なパス;10 MB で自動ローテーション。 | +| `debug` | boolean | false | ACP_DEBUG | 詳細なリクエストごとのログ記録。 | +| `dumpSse` | string | unset (directory) | ACP_DUMP_SSE | デバッグ用に生SSEフレームをダンプするディレクトリ、ループ起源のレスポンスを含む。 | +| `passthrough` | boolean | false | ACP_PASSTHROUGH | グローバルな生リレースイッチ:圧縮、ツール注入、ナッジなしですべてのリクエストを転送する。 | + +**アップストリーム & 課金** + +| キー | 型 | デフォルト | 環境変数 | 説明 | +|-----|------|---------|-----|-------------| +| `upstream` | string | https://api.anthropic.com | ACP_UPSTREAM | リクエストがどのプロバイダルートにも一致しない場合のフォールバック用アップストリームベースURL。 | +| `proxy` | string | unset (direct) | BILI_UPSTREAM_PROXY | プロキシ自身のエグレス(外部送信)用のグローバルアウトバウンドプロキシ。解決順序: ルート別 → BILI_UPSTREAM_PROXY → Web UI → この値 → HTTP(S)_PROXY → Windows システムプロキシ → 直接接続。空文字列は明示的な直接接続を意味し、SOCKS5 は拒否される。 | +| `upstreamProxy` | string | unset | — | Web-UI 手動プロキシ階層(ダッシュボードのプロキシエディタによって書き込まれる)。解決順序では BILI_UPSTREAM_PROXY より下位にある。 | +| `upstreamProxyMode` | "auto" \| "manual" \| "direct" | auto (unset behaves as direct) | BILI_UPSTREAM_PROXY_MODE | グローバルプロキシの取得方法: auto(環境変数/システム検出)、manual(Web-UI の値のみ)、direct(プロキシを一切使用しない)。 | +| `providers` | record url-prefix → route entry | {} | — | ルートテーブル: URLプレフィックスキーをプロバイダ別エントリ(モデル、compress、compat など)にマッピングする。Providers セクションを参照。 | +| `modelEndpointPatterns` | array of { match: string, wire: "anthropic" \| "openai" \| "responses" \| "google" \| "commandcode" } | [] | — | 宣言可能なカスタムワイヤモデルエンドポイント: ワイヤファミリにマッピングされる絶対URLプレフィックス。1つの設定ソースがプロキシのプロトコル分類器とクライアントサイドのフェッチクレームの両方に供給されるため、2つのゲートが乖離しなくなった(#1295)。 | +| `modelContextLimit` | number | 200000 | ACP_MODEL_CONTEXT_LIMIT | レガシーのグローバル DEFAULT ウィンドウ(ウィンドウラダーにおける最終手段のフォールバック: モデルの制限がティア証拠、プラグイン/ランチャーレポート、ルート別宣言、レジストリ検索、組み込みテーブルのいずれからも解決されない場合にのみ参照される。また、勝った場合の使用率の分母としても機能する)。compress.modelContextLimit を優先すること。 | +| `imageBilling` | "auto" \| "pixels" \| "bytes" | auto (resolves to pixels) | BILI_IMAGE_BILLING | グローバルなイメージトークン推定基準。リクエストごとにライブ読み取りされ、すべてのプロバイダ別設定を上回る。 | +| `imageTokenCap` | number | unset (uncapped) | BILI_IMAGE_TOKEN_CAP | 解決された課金モードの上に適用されるグローバルな1画像あたりのトークン上限。リクエストごとにライブ読み取りされる。 | +| `imageRescale` | boolean | true | BILI_IMAGE_RESCALE | エグレス画像のダウンスケールマスタースイッチ(#3295/#3400): 大きなアウトバウンド画像は縮小して送信され、セッションストレージ内のオリジナルは変更されない。リクエストごとにライブ読み取りされる。 | +| `egressTransforms` | array | unset (none) | — | ユーザー登録可能なエグレスリクエストボディ書き換えパイプライン(#6003): すべてのセッション処理の後、トランスポート(再署名 / v1Wrap / fetch)の前に、すべてのアウトバウンドモデルリクエストボディを書き換える ESM プラグイン。フェイルオープン、POST /__bili/config/reload によるホットリロード可能。 | +| `billing` | object | {} | — | モデルごとの課金価格(#4899): billing.prices[model] = { input, output?, cacheRead?, cacheWrite? } は100万トークンあたりの USD 単位。パネルの USD 支出台帳と保存済みドル推定値において、models.dev スナップショットを上書きする。価格未設定のモデルはトークン数のみ表示される。 | + +**挙動トグル** + +| キー | 型 | デフォルト | 環境変数 | 説明 | +|-----|------|---------|-----|-------------| +| `rollout` | object | {} | — | 機能ロールアウト(カナリア)ブロック:バージョンに組み込まれたロールアウト計画の機能ごとのオーバーライド;機能はインストール数のパーセンテージでロールアウトされ、安定したマシンごとの ID でバケット化されます。 | +| `rollout.installId` | string | auto-generated UUID persisted at ~/.local/state/billion-context/rollout-id.json | — | 自動生成された state-dir UUID の代わりにバケット化アイデンティティをピン留め(サポート/テスト:コホート内にバケットが収まる ID を選択または計算)。 | +| `rollout.features` | record feature name → { enabled?, percent?, salt?, base? } \| boolean \| number | {} | — | 実行中バージョンが rollout 下で持つ機能名をキーとする機能ごとのオーバーライド。enabled (boolean) はパーセンテージを無視して上書き;percent (0–100) はコホートを再スケーリング;salt は再ランダム化;base はネストのスコープを再定義。ショートハンド:"x": true/false でオン/オフを強制、"x": 20 で percent を設定。型が誤ったフィールド(例:enabled が文字列)は無視され、起動時の警告で名前が示されます — コホートのサイレントな拡大は決して行われません。 | +| `rollout.features.enabled` | boolean | unset (bucket math decides) | BILI_ROLLOUT_ | パーセンテージに関係なく、ゲート付き機能を強制的にオン/オフにする。環境変数 `BILI_ROLLOUT_`(大文字スネークケースの機能名; 0/false = オフ、それ以外の値 = オン)が、このフィールドを含むすべての設定を上書きする。 | +| `rollout.features.percent` | number | the version's baked-in plan | — | 機能を確認できるインストールの割合(0–100、小数可)。単調増加性を持つ:パーセンテージを上げても、すでに有効化されたインストールが失効することはない。バケットはインストールごとにプレフィックス安定である。 | +| `rollout.features.salt` | string | the feature name | — | バケット分割用のハッシュソルト。変更するとコホート全体が再ランダム化される(シャッフルする唯一の方法;パーセンテージを上げるだけではシャッフルされない)。 | +| `rollout.features.base` | string | unset (roll out over everyone) | — | ネストされたロールアウト:指定された機能の有効化コホート内でのみこの機能を評価し、パーセンテージがその母集団に対する相対値となる(Aのユーザーに対してBをロールアウト;チェーンは許可、サイクルはクローズドに失敗する)。 | +| `rollout.features.identityChannelHarvest` | boolean \| number | 0 (off) | BILI_ROLLOUT_IDENTITY_CHANNEL_HARVEST | IDチャネル収穫コホートゲート (#5825):インストールごとの環境スイッチなしで、ループバック専用のトランスクリプト/sqlite収穫(`src/identity-harvest.ts`: claude-code / codebuddy / mcode / goose / qwen レーン)を許可する。インストールごとのスイッチ(`BILI_IDENTITY_HARVEST`)もこのキーも設定されていない場合、クライアントストレージは一切読み取られない。オーナー裁定 2026-11-07:このコホートキーは `rollout.features.pluginLaneServerHistory`(承認済みIDの行固定を管理)とは意図的に分離されている — いずれかのイネーブラーが収穫を有効化できる。デフォルト 0%;小規模コホートでの degrade warn-once レートの観察後に引き上げる。`identity-channels.md` を参照。 | +| `rollout.features.pluginLaneServerHistory` | boolean \| number | 0 (off) | BILI_ROLLOUT_PLUGIN_LANE_SERVER_HISTORY | プラグインレーンのサーバー所有履歴 (#4491):有効化されたインストールにおいて、(a) プラグインレーンのリクエストは `messages` と並行して内部 `biliMsgIds` 配列を持ち、メッセージIDをクライアント提供のIDに固定できる(上流転送前に常に除去;不正な配列は警告付きで無視、ID汚染形状は増分レーンでハードフェイル);(b) ループバック専用の `POST /__bili/plugin/render` エンドポイントは、統合トランスクリプトからレンダリングされた送信プレフィックスを提供する(折り畳み領域はサマリアンカーに縮小;デシンクは非2xxにデグレードし、シムはローカル履歴にフォールバック);(c) 増分レーンのプローブは `serverHistory` をアドバタイズする。デフォルト 0% — ロールアウトされるまで挙動は変わらない。 | +| `rollout.features.pluginFullResendWatermark` | boolean \| number | 5 (experimental grey) | BILI_ROLLOUT_PLUGIN_FULL_RESEND_WATERMARK | フルリセンドウォーターマークファストパス (#5403/#5418):前回のレスポンスに `x-bili-pf-seq` ス tamp を持っていたプラグインレーンのチャットコンプリートターンでは、エコーされたカウントにより再送信プレフィックスをアサートする(構造スキャン、フルパースなし);ヒット時にパイプラインはスタッシュされた正規プレフィックスコアと新しいテールウィンドウのみを消費する(バイト同一の送信プロベナンス;疑義がある場合はターンごとに未変更のフルパースパスにフォールバックし再スタンプ、5回のクレジットミスでレーンを1時間保持)。クライアントがスタンプを `x-bili-pf-count` としてエコーバックすることを要求(dsh/pi/opencode/omp は対応;未適応レーンはヒットしない)。実験的グレースケールロールアウト — インストールの約5%でデフォルトON(オーナー裁定 2026-11-02:GA前に小規模コホート;Web UIで全インストールに一度限りの導入通知、クイック設定に3状態スイッチ)。`true` で強制、`false`(またはパーセンテージ)/ 環境変数 = 0 でオフ。`technical-notes.md` の「Full-resend watermark fastpath」を参照。 | +| `maskHosts` | boolean | true | BILI_LOG_MASK_HOSTS | ログ内の非公開ターゲットホストを としてマスクする。認証情報ヘッダーは常にマスクされる。 | +| `security.adminRelay` | boolean | false | — | エンベディングホスト(現在は dsh web)が、リモートブラウザからパネルを開けるように(#3373)、その自身のエントリーオリジンを通じて /__bili/ 管理サーフェス全体をリレーすることを許可する。フェイルクローズ、ファイルのみ。リレーされたホップはローカル非ブラウザクライアントとしてプロキシに到達する(ループバックソース + ループバック Host、Origin なし)ため、管理ゲートは変更されない。これを有効にすると、ホスト Web エントリーに到達できる者に設定編集と認証情報の書き込みが露出する — まずそのエントリー(認証 / リバースプロキシ)を保護すること。 | +| `subagentSplit` | boolean | true | BILI_SUBAGENT_SPLIT | Claude Code サブエージェントは、メインセッションのキューに並ぶ代わりに、独自のセッション名前空間(\|sub:)を取得します。Anthropic-wire 専用 — Responses wire ではこのスイッチは no-op です(`subagentSplit` / BOTH-mechanisms スコープ注記を参照)。 | +| `personaSplit` | boolean | true | BILI_PERSONA_SPLIT | 指示テキストが変更され、かつ受信履歴が追跡中のチェーンを継続していない場合、指示フィンガープリントでキー付けされた Responses-wire レーンを分割します(Claude Code の /v1/responses 経由; Codex ルートスレッド / 旧ビルド)。デフォルトで有効。環境変数 BILI_PERSONA_SPLIT=0 または personaSplit: false で無効化可能(環境変数が優先)。 | +| `forkAdoption` | boolean | false | BILI_FORK_ADOPTION | 匿名フォークは、フォークされたリクエストにソースコンテンツが完全に存在する親の圧縮ブロックを継承します。 | +| `autoModeForge.enabled` | boolean | true | BILI_AUTO_MODE_FORGE | Claude Code の自動モードのセーフティ分類器呼び出しを、上流へ転送する代わりに、偽造された許可判定でローカルに回答します(#2740):そのレーンでは送信ゼロ、課金ゼロ。すべての偽造判定は監査ログに記録され、セッションには通知バッジが付与されます。false / 環境変数 0 で、実際の判定料金を支払うユーザー向けに純粋なパススルーに戻ります。 | +| `affinitySimhash` | boolean | true | BILI_AFFINITY_SIMHASH | 匿名クライアント向けの Simhash チェーン整合性採用(#2265):クライアント側の普遍的な装飾的書き換え(例:Trae がすべてのアシスタントメッセージにモデルタグを再スタンプする)が発生した場合、ゼロから新規発行して再折りたたむ代わりに、既存のセッションとその圧縮状態を再アタッチします。 | +| `resumeInheritance` | boolean | true | BILI_RESUME_INHERITANCE | 新しいセッション ID で再開する識別済みクライアントは、親の ref 割り当てと完全に存在する圧縮ブロックを継承します。 | +| `chainContentDetection` | boolean | false | BILI_CHAIN_CONTENT | bili→bili チェーンのボディコンテンツ検出(オフ:ボディスキャンは CCR/モデルエコーテキストで誤検出する可能性がある);デフォルトでは x-bili-hop のみでチェーン認識を駆動します。 | +| `chainEgressStamp` | boolean | false | BILI_CHAIN_STAMP | 送信時にモデル可視の チェックポイントキャリアを発行します(オフ:モデルはこれを幻覚入力として扱い、トークンを消費します)。 | +| `stableSystemAnchor` | boolean | false | BILI_STABLE_SYSTEM_ANCHOR | ベストエフォートのワイヤーレイヤープレフィックスキャッシュアンカー:クライアントが変更した場合でも、最初に確認されたヘッドシステムバイトを再送信します(プレーンプロキシレーンのみ)。 | +| `compat` | { roles?, dropFields?, streamErrorShape?, noCacheControl?, keepResponseId? } | {} (disabled) | — | グローバルワイヤー互換性ブロック:ロールリマップ、厳格スキーマフィールドの削除、ストリームエラー形状、cache-control 処理。 | +| `compat.roles` | record role → role | {} | — | メッセージロールを上流が受け入れる名前にマッピングします(例:developer→system);完全一致ロールのみ、プロバイダーごとのエントリがキーごとに優先されます。 | +| `compat.dropFields` | string[] (dot paths) | [] | — | 未知のフィールドで 400 を返す厳格スキーマゲートウェイ向けに、転送されるすべてのボディからドットパスフィールドを削除します;グローバル + プロバイダーごとのリストは加算的に統合されます。 | +| `compat.streamErrorShape` | "protocol" \| "completion" | protocol | BILI_STREAM_ERROR_SHAPE | 200 がコミットされた後、上流ストリーム失敗がどのように提示されるか:プロトコルネイティブのエラーフレーム(デフォルト)またはレガシーの合成完了形状。 | +| `compat.noCacheControl` | boolean | false | BILI_NO_CACHE_CONTROL | Anthropic レーンの cache_control ブレークポイントを完全にスタンプしないようにします(独自のブレークポイントポリシーを持つ上流/リレー用のエスケープハッチ)。 | +| `compat.keepResponseId` | boolean | false | ACP_KEEP_RESPONSE_ID | カーネル再構築された Responses リクエストで previous_response_id を保持します(デフォルトでは削除するため、再構築されたボディは上流が発行したことのない ID を参照しません)。 | +| `dsh` | object | {} | BILI_ALLOW_DSH_COMPACTION | セクションは認識されるが、従来のエスケープハッチは削除された(#3666、#2028 を代替):`allowDshCompaction` キーおよび `BILI_ALLOW_DSH_COMPACTION` 環境変数はもはや存在しない — dsh ネイティブコンパクションは、すべてのレーンにおいてワイヤガードによって無条件に拒否される。残存する `dsh.allowDshCompaction` の値は、一度限りの非推奨警告とともに無視される;代わりにホスト側の抑制を適用すること(#3354/#2474)。ライブキー — `dsh.authoredCompaction`、`dsh.contextTab`、`dsh.contextTabLabel` — は以下のエントリに文書化されている。 | +| `dsh.authoredCompaction` | boolean | true (on, #3901 flip) | BILI_DSH_AUTHORED_COMPACTION | bili は dsh コンパクションの summarize 呼び出しを、拒否する代わりに折り畳みスナップショットでローカルに回答する(#3723/#3733)。0.1.203 のドッグフッド期間が維持されたため、デフォルトで ON。`false`(または環境変数 `BILI_DSH_AUTHORED_COMPACTION=0`)を設定すると、#1729 の拒否パスが復元される。 | +| `dsh.contextTab` | boolean | true | BILI_DSH_CONTEXT_TAB | DSH トップバーの「上下文」/「Context」会話タブを登録する(#3862/#4237):`false` にすると、そのタブのみが削除される — コンプレッション、設定セクション、その他のすべてのサーフェスは引き続き動作する。非表示にしてもコンプレッションは無効にならない;台帳は設定セクション(会话 サブページ)、プラグインバンドル設定フェイス、Web UI、および `/acp` コマンド経由で引き続きアクセス可能。次のページ読み込み / dsh リスタート時に有効になる(スロット登録はページ読み込み時に発生);デフォルト `true` = 現在の動作は変更なし。 | +| `dsh.contextTabLabel` | string | unset (built-in 「上下文」/「Context」) | — | DSH トップバーの Context タブのカスタム表示名(#4237)、例:別のプラグイン(dsh-context)が「上下文」の名前を所有している場合の "压缩账本"。トリムされた空でない文字列が組み込みラベルに優先される;空白または未設定の場合は組み込みにフォールバック。ファイル専用ティア(表示設定、#2030 に従い環境変数なし)。デフォルト未設定 = 組み込みラベルは変更なし。 | +| `resign` | scheme → { enabled?, passthrough?, credentialRef? } | {} (armed; built-in scheme sdk-hmac-sha256) | BILI_RESIGN, BILI_RESIGN_PASSTHROUGH, BILI_CODEARTS_REF, BILI_RESIGN_BENEFIT | Authorization スキームでキーイングされた再署名アーム:署名済みモデルリクエストは、すべてのエグレスボディが再署名されてトンネリングされる;署名解除できないリクエストは、パススルーがそのスキームを逐語転送にオプトインしていない限り、ローカルで 403 として拒否される。 | +| `promptCache.routing` | "auto" \| "enabled" \| "disabled" | disabled | ACP_PROMPT_CACHE_ROUTING | bili 自身の `prompt_cache_key` 出力の姿勢(両方のワイヤ);クライアントが供給したキーは常に逐語的に転送される。 | +| `cacheKeepalive.enabled` | boolean | false | BILI_CACHE_KEEPALIVE | Anthropic ワイヤにおけるアイドル時のプロンプトキャッシュキープアライブのマスタースイッチ(#3376):セッションがアイドルになると、bili は TTL 由来の周期で `max_tokens=1` を伴う最後の転送ボディを再生し、アップストリームのプレフィックスキャッシュをウォームに保つ;ヒットは `usage.cache_read_input_tokens` 経由で検証される;ミス/429/エラー連続/期間上限で停止。プロバイダルートごとおよびモデルごとにも設定可能。 | +| `cacheKeepalive.ttlFactor` | number | 0.9 | BILI_CACHE_KEEPALIVE_TTL_FACTOR | 検出/推定されたキャッシュ TTL ティアに適用される周期係数(ピン間隔 = ティア x 係数;0.9 は 5 分ティアで約 4.5 分ごとに 1 ピン、1 時間ティアで 54 分ごとに 1 ピン)。(0, 1] の範囲でなければならない。 | +| `cacheKeepalive.maxDurationMs` | number | 86400000 | BILI_CACHE_KEEPALIVE_MAX_DURATION_MS | セッションごとのキープアライブ生存期間上限、セッションの最後の実際のリクエストから測定(デフォルト 24 h);これを過ぎると、ヒットが続いていてもキープアライブは解除される。 | +| `cacheKeepalive.maxConcurrentPings` | number | 4 | BILI_CACHE_KEEPALIVE_MAX_PINGS | 同時にアームされたセッションの上限;超過した場合、最も長くアイドル状態のアーム済みセッションが最初に追い出される。 | +| `cacheKeepalive.assumeTtl` | "5m" \| "1h" | null (detect from body breakpoints) | BILI_CACHE_KEEPALIVE_ASSUME_TTL | ボディブレークポイント検出をスキップし、このティアから直接周期を導出 - bili の下流で `cache_control` TTL を注入または書き換えるリレー向け、転送ボディにブレークポイントがないか、ティアが誤っている場合。 | +| `cacheKeepalive.armWithoutBreakpoints` | boolean | false | BILI_CACHE_KEEPALIVE_ARM_WITHOUT_BREAKPOINTS | 転送ボディに `cache_control` ブレークポイントが全くない場合でもキープアライブをアーム(デフォルトオフ - ブレークポイントがない場合、リフレッシュすべき明示的なブレークポイント付きコンテンツがない;リレーがブレークポイントを自分で管理している場合は `assumeTtl`/`intervalMs` と組み合わせること)。 | +| `cacheKeepalive.intervalMs` | number | null (derive from TTL tier) | BILI_CACHE_KEEPALIVE_INTERVAL_MS | ミリ秒単位の絶対ピン間隔;`ttlFactor`、`assumeTtl`、および検出されたティアに優先。アップストリームの TTL ポリシーに従わない固定周期向け。 | +| `native.attachExternal` | boolean | false | BILI_NATIVE_ATTACH_EXTERNAL | ランチャーなしのネイティブプラグインが、自分自身のデーモンを生成する代わりに、外部(レーン付き、未アーム)のデーモンにアタッチできるようにする。 | +| `native.attachLanePriority` | string[] | [] (own lane → user zone → spawn) | — | 自レーンインスタンスが存在しない場合、レーンがライド可能な FOREIGN レーン名の順序付きリスト(#2905)。自レーンは常に最初に優先される;ユーザーゾーン(手動 `bili start`、8787 グローバル)は常に最後;リストにないレーンはアタッチ不可のまま。ファイル専用、環境変数なし。 | +| `native.attachPolicy` | "own-lane" \| "global-fallback" | own-lane | BILI_NATIVE_ATTACH_POLICY | ネイティブフックのアタッチにおけるレーンアフィニティ、およびクロスレーンライドが発生するかどうかのゲート(#2877)。own-lane(デフォルト): LANEd フックは同じレーンのデーモンにのみライドし、利用可能なものがなければフォールバックとしてレーンなし/手動起動された bili start デーモンや他のレーンのデーモンを使用するのではなく、自前でスポンします(この収束により、すべてのエージェントが1つのデーモンのバージョンに固定され、セッションの二重書き込みが発生していた問題が解決されました)。アームされたレーンなしデーモン(管理共有プロキシ、#1225)は、どちらのポリシー下でも共有可能のままです。global-fallback は #2877 以前の動作を復元します:まず同じレーン、次に互換性のあるレーンなし/ユーザーゾーンデーモン、そして(attachLanePriority が設定されている場合)リストされた外部レーン。 | +| `native.attachUrl` | string | unset (discover per lane) | BILI_MCP_PROXY | ネイティブフックのアタッチにおける明示的なターゲットオリジン(任意の URL)。設定されると、フックは自動検出の代わりに、その正確なオリジンにのみアタッチし、ライブでない場合は自前でスポンします。それでもなおコード互換性があり、ライフサイクルゲートを通過する必要があります。BILI_MCP_PROXY 環境変数(CLI の --origin によっても設定される)は、このファイルの値よりも優先されます。空または空白は未設定を意味します。 | +| `claude.nativePort` | number | unset (lane sticky zone port) | BILI_CLAUDE_NATIVE_PORT | claude ネイティブレーンのフックスポンによるプロキシの正確なポートピン(strict-port: 占有者は明確に拒否されます)。 | +| `pi.subagents` | object \| boolean | {} (acp_delegate enabled with package defaults) | PI_ACP_DELEGATE_FORCE_ENABLE, PI_ACP_DELEGATE_MAX_DEPTH, PI_ACP_DELEGATE_SYNC_TIMEOUT_MINUTES, PI_ACP_DELEGATE_IDLE_TIMEOUT_MINUTES, PI_ACP_DELEGATE_ASYNC_TIMEOUT_MINUTES, PI_ACP_DELEGATE_MAX_CONCURRENT | 組み込み pi レーンサブエージェント(acp_delegate)サーフェス、#2230 config-home。billion-context.json の pi.subagents セクションがデリゲート設定を所有します。4 つの acp.json キー(delegate/delegatePrompt/displayUsage/debug)は、セクションが存在しない場合のみ読み取られる非推奨のフォールバックです。prompt は delegatePrompt を置き換えます。debug はサブエージェントサブシステムにスコープされます。ブール値の省略形 subagents: false はサーフェス全体を無効にします。完全なフィールドテーブル:configuration.md の pi セクション。 | +| `pi.inline` | boolean | true (unset env+file runs inline) | BILI_PI_INLINE | Pi インラインレーン(#3278; #5428 以降デフォルトで有効、#4687 のオプトインルールを置き換え): pi 拡張機能の圧縮はインプロセスで実行されます — スポンされたプロキシなし、エフェメラルポートなし;モデルトラフィックと /__bili//__acp ツールサーフェスは擬似オリジンを通じてインプロセスエンジンによって提供され、codex Responses WebSocket レーンはループバック専用 WS ブリッジによって、Web UI はエンジンと同時に起動されるループバック専用 Web リスナーによって提供されます。現在、env+file が未設定の場合にはインラインで実行されます;ANNOUNCED アタッチターゲット(ランチャー設定の BILLION_CONTEXT_PROXY/ATTACH)はデフォルトよりも優先されるため、`bili pi` はランチャープロキシを維持します。BILI_PI_INLINE=0/false/no/off またはこのキーを false に設定することでオプトアウトできます — 従来のアタッチ/スポン姿勢を復元します。解決順序は env > file > default;明示的なインライン選択は常に ANNOUNCED アタッチターゲットよりも優先されます。人間向けサーフェス:`bili -i/--inline pi`(≡ ワンコマンドレーン)と `bili -s/--server pi`(プロキシ姿勢をピン留め、継承されたインライン env よりも優先)。 | +| `pi.commands` | string[] \| boolean | ["acp", "acp-cache"] | | 登録される bili pi-plugin スラッシュコマンド:"acp", "acp-cache", "acp-rule", "acp-fleet"。デフォルトでは、ステータス(/acp)とキャッシュ調整(/acp-cache)のエントリポイントを維持しつつ、より稀に使用される /acp-rule と /acp-fleet をスラッシュ補完リストから除外します;true は 4 つすべてを登録し、[] または false は何も登録しません。不明な名前は一度警告が表示され、無視されます。セッション開始時に読み取られるため、設定の編集は次のセッションに適用されます(プロキシの再起動は不要)。純粋な UI サーフェス:コマンドの無効化は、基盤となるツール(acp_cache / acp_rule はモデルに対して利用可能のまま)を削除したり、プロキシに影響を与えたりしません。 | +| `opencode.inline` | boolean | false | BILI_OPENCODE_INLINE | OpenCode インラインレーン(#3278 ポート;オプトイン — #4687 におけるオーナーの決定に従い、デフォルトはスポンされたプロキシのまま): opencode プラグインの圧縮はインプロセスで実行されます — スポンされたプロキシなし、エフェメラルポートなし、MITM 証明書なし;モデルトラフィックと /__bili/ ツールサーフェスは擬似オリジンを通じてインプロセスエンジンによって提供されます(Bun ホストで検証済み)。有効にするには true(または BILI_OPENCODE_INLINE=1)を設定します。解決順序は env > file;明示的なインライン選択は常に ANNOUNCED アタッチターゲットよりも優先され、選択が欠如している場合は従来どおりアタッチ/スポンにフォールバックします。`bili opencode-inline` はワンコマンドレーンです。 | + +**MITM レーン** + +| キー | 型 | デフォルト | 環境変数 | 説明 | +|-----|------|---------|-----|-------------| +| `providersPath` | string | unset | ACP_PROVIDERS | 外部 providers.json へのパス(レガシー/共有ルートファイル)。インラインプロバイダおよび設定ファイル内の場所の両方よりも優先される。 | +| `mitm.enabled` | boolean | true | BILI_MITM | アップストリームをハードコードしているログインクライアント向けの HTTPS 傍受スイッチ;ドメインは初回検出時にホワイトリストに登録されます。 | +| `mitm.domains` | string[] | [] | BILI_MITM_DOMAINS | 明示的な MITM ホワイトリストドメイン(初回検出時の自動ホワイトリスト化と合算)。 | +| `mitm.handshakeTimeoutMs` | number | 10000 | BILI_MITM_HANDSHAKE_TIMEOUT_MS | 傍受された接続の TLS ハンドシェイクタイムアウト。 | + +**プロセス & 永続化** + +| キー | 型 | デフォルト | 環境変数 | 説明 | +|-----|------|---------|-----|-------------| +| `network` | object | {} (all defaults) | — | 上流呼び出しのタイムアウト、ウォッチドッグ、リプレイポリシー。 | +| `network.upstreamTimeoutMs` | number | 720000 | BILI_UPSTREAM_TIMEOUT_MS | 単一の上流呼び出しに対する絶対上限(12分は、遅い深層思考モデルをカバーする)。 | +| `network.upstreamFirstByteMs` | number | = upstreamTimeoutMs (resolved; 720000 when unset) | BILI_UPSTREAM_FIRST_BYTE_MS | フェーズ1の予算:リクエスト送信 → 最初のレスポンスバイト(undiciは最初のボディデータ付近でfetchを解決する)。未設定の場合、解決済みの上流タイムアウト(upstreamTimeoutMs)に従う — BILI_UPSTREAM_TIMEOUT_MS を12分以上に引き上げるデプロイメントを含む(#5917 レビュー:定数 720000 のフォールバックはそれらを静かに再制限してしまう)— したがって動作は変更されない;より厳格なデプロイメントはオプトインする(#5904:リクエストを受け入れるが以前は応答しなかったスタックした上流は、クライアントが中断するまで静かにハングしていた)。最初のバイト後、チャンク間の沈黙は引き続き完全な upstreamTimeoutMs によって管理される(#1706/#1714 の保証)。この値が upstreamTimeoutMs 未満に設定されると、最初のバイトのタイムアウトは独自の失敗クラス upstream-headers-timeout となる — レスポンスバイトがゼロであるため、bili はリクエスト全体を一度で失敗させるのではなく、既存のリトライ予算(BILI_REPLAY_RETRY_MAX、デフォルト 3)の下でプロキシ内でリプレイする;ストリーム中(ボディ)のアイドルタイムアウトは upstream-timeout のままであり、リトライされない。未設定の場合、動作は以前とバイト単位で同一である(#5807/#5831)。リリースゲートは 120000 を設定する。 | +| `network.requestWatchdogMs` | number | 2× upstreamTimeoutMs | BILI_REQUEST_WATCHDOG_MS | 呼び出しごとのタイマーが設定されていなくても、スタックした上流ソケットを強制中断する絶対的なウォッチドッグ。 | +| `network.keepAliveTimeoutMs` | number | 5000 | BILI_KEEP_ALIVE_TIMEOUT_MS | プールされた上流ソケットのアイドルキープアライブタイムアウト。 | +| `network.clientErrorBackstopMs` | number | 30000 | BILI_CLIENT_ERROR_BACKSTOP_MS | コミットされたレスポンスの読み取りを停止したクライアント接続を中断するバックストップ。 | +| `network.exposureLogIntervalMs` | number | 3600000 (0 disables the log) | BILI_EXPOSURE_LOG_INTERVAL_MS | バインドアドレス公開の警告がログに繰り返し表示される間隔;0 で完全に無効化。 | +| `network.streamKeepAliveMs` | number | 15000 (0 disables) | BILI_STREAM_KEEPALIVE_MS | モデルチャンク間の下流ストリームキープアライブピン間隔;0 でピンを無効化。 | +| `network.preflightHoldMs` | number | 30000 | BILI_PREFLIGHT_HOLD_MS | 失敗したプリフライトが、リクエストが未調整のまま許可されるまで保持される時間。 | +| `network.preflightDeadEndCooldownMs` | number | 300000 | BILI_PREFLIGHT_DEAD_END_COOLDOWN_MS | 行き止まりのプリフライト後、同じセッションの調整を再試行するまでのクールダウン。 | +| `network.replayRetryMax` | number | 3 (1 disables replays) | BILI_REPLAY_RETRY_MAX | エラーを表面化させる前に、同一リクエストの最大トランスポート失敗リプレイ回数。 | +| `network.replayRetryBaseMs` | number | 1500 (0 disables the delay) | BILI_REPLAY_RETRY_BASE_MS | リプレイ間のベースバックオフ遅延(指数関数的)。 | +| `network.throttle429Enabled` | boolean | true | BILI_THROTTLE_429 | エグレス側の 429 ガバナナ(#4204):繰り返される上流 429 は転送されるのではなくローカルで応答される。アカウント制限および未認識/不正なレスポンスは origin+credential を保持する;KeyRing の正確な keyring_model_temporarily_unavailable コードと一致するリクエストモデルのみが origin+credential+model を保持し、他のモデルを適格とする。モデルの不一致または欠落はアカウント全体に適用される;false は従来の常に転送する動作を復元する。 | +| `network.throttle429MaxConsecutive` | number | 5 | BILI_THROTTLE_429_MAX_CONSECUTIVE | ホールドがターミナル(既知のすべての SDK リトライセットの外側のローカル 424)に変わるまでの連続上流 429 の回数;バックオフウィンドウごとに1回のプローブが、アカウントホールドをクリアする非 429 レスポンス、またはそのモデルホールドをクリアする一致するモデルの非 429 レスポンスがあるまでチェックを続ける。 | +| `network.throttle429BaseDelayMs` | number | 2000 | BILI_THROTTLE_429_BASE_DELAY_MS | 429 ホールドのベースバックオフ(連続する 429 ごとに倍増し、[0.5×, 1×] にジャッターされ、throttle429MaxDelayMs で上限が設定される;上流の Retry-After が大きい場合は優先される)。 | +| `network.throttle429MaxDelayMs` | number | 30000 | BILI_THROTTLE_429_MAX_DELAY_MS | 429 のバックオフおよびターミナルフェーズのプローブ間隔の上限。 | +| `network.throttle429Scope` | string | credential | BILI_THROTTLE_429_SCOPE | マーカーなしの上流 429 に対するホールドの粒度 (#5199)。値の一致は完全一致 (`credential` または `model`、大文字小文字を区別) であり、タイプミスがある場合は 1 回の警告ログとともに `credential` にフォールバックする。`credential` (デフォルト) は #5696 の保守的なセマンティクスを維持し、認識されたモデルマーカー (`keyring_model_temporarily_unavailable`、または bili リレーの `bili_throttle_hold` scope=model) を伴わない 429 は、そのクレデンシャルの背後にあるすべてのモデルがバックオフを待機するように、オリジン+クレデンシャル全体をホールドする。`model` は、1 つのクレデンシャルの背後に独立した制限を持つ多数のモデルをフロントするゲートウェイ (LiteLLM/one-api/opencode.ai スタイルのリレーで、1 つのモデルの RPM 枯渇がその兄弟モデルをフリーズすべきではない場合) に対して、送信のリクエストモデルをキーとしてホールドを行う。モデルを識別できないリクエストは引き続きクレデンシャル全体を対象とし、認識されたマーカーは両モードで独自のセマンティクスを維持する。注意: `model` の場合、ホールドキーはワイヤーが運ぶリクエストモデル文字列の完全一致 (`glm-5.2` ≠ `GLM-5.2` ≠ `glm-5.2-128k`) であり、モデル名を書き換えるか 1 つのモデルを複数のエイリアスで提供するゲートウェイは、そのモデルごとのクォータが請求されるのと同様に、スペルごとに個別のホールドを維持する。 | +| `network.maxShrinkPerCompress` | number | unset | BILI_MAX_SHRINK_PER_COMPRESS | 1 回の圧縮で履歴を縮小できる量の上限 (崩壊防止ガード)。 | +| `network.proxyKeepAliveMaxMs` | number | 55000 (0 = one-shot connections) | BILI_PROXY_KEEPALIVE_MAX_MS | アウトバウンドエグレスプロキシを介した接続の最大生存時間。これを超えると再接続を強制する (古い NAT マッピングを回避するため)。 | +| `network.postResponseLingerMs` | number | 5000 | BILI_POST_RESPONSE_LINGER_MS | レスポンス完了後のプロキシ起因のクローズに対するグレースフルクローズの予算: ソケットはピアの FIN/TLS close_notify を待って保持され、期限時に破棄される (reason=linger-backstop)。 | +| `network.allowPrivateHttpProviders` | boolean | false | BILI_ALLOW_PRIVATE_HTTP_PROVIDERS | オプトイン (#2984): プライベートネットワーク (RFC1918, 127/8, リンクローカル, ULA, *.local/.lan/.internal) 上のプレーン HTTP プロバイダーを、エージェントレジストリのインテークおよびサマリーエンドポイントのガードに許可する。デフォルトでは無効 — プレーンテキストはループバックのみ許可; 公開 IP/ドメインおよび CGNAT (100.64/10) は常に拒否される。1/true で有効化。 | +| `network.receiveBodyBytes` | number | 5368709120 | BILI_RECEIVE_BODY_BYTES | 受信ステージで 413 を返す前に、リクエストごとにメモリに読み込む最大ワイヤーバイト数。ハードコードされた 100 MiB から 5 GiB に引き上げられ (#3128 オーナー決定)、マルチギガバイトの単一リクエストがソケットリセットされることなく受け入れられるようになった。また、デコードされたリクエストが共有される 2 つの大型デコードアドミッションスロットの 1 つを消費する閾値でもある。WebSocket レーンは固定の 100 MiB のサーフェスを維持する。 | +| `network.decodedBodyBytes` | number | 10737418240 | BILI_DECODED_BODY_BYTES | コンテンツエンコーディング展開 (gzip/deflate/br/zstd) 後の最大デコードバイト数。デコード中に増分チェックされる (デコードステージ 413)。デフォルトは受信予算の 2 倍で、従来の decode=2x-wire の関係を反映し、デコンプレッションボムから守る。 | +| `network.outboundBodyBytes` | number | 5368709120 | BILI_OUTBOUND_BODY_BYTES | 上流に転送される再構築リクエストの最大バイト数 (転送ステージ 413)。最終ボディ文字列の UTF-8 バイト数としてカウントされる。fetch 前にチェックされるため、予算超過の再構築は上流のウォッチドッグ割り当てに到達しない。 | +| `network.wsOutboundBytes` | number | 10485760 | BILI_WS_OUTBOUND_BYTES | WebSocket レーン専用のソフトバイト予算 (#3701): 最終シリアライズされた Responses WS フレームがこれを超過した場合、まず OUTBOUND COPY から古い画像が除去される (プレースホルダーノートとしてアーカイブ — 元画像はセッションストレージに残り、ツールアームされたレーンでは read_original_image / decompress で復元可能 — 注入ツールを拒否する codex スタイルのレーンはサイズのみ注釈を保持)、その後残ったものは jimp maxDim ラダーを通じて有界にダウンスケールされる。それでもフレームが収まらず、イベント前に上流が 1009 でクローズした場合、同じリクエスト内で厳密に小さい再送信が 1 回試行される。0 に設定すると除去を無効化 (従来のそのまま送信する動作)。HTTP レーンには影響しない — ハード拒否上限は network.outboundBodyBytes のまま。 | +| `network.httpOutboundBytes` | number | 10485760 | BILI_HTTP_OUTBOUND_BYTES | プレーン/プロキシ/pi ネイティブ HTTP リレーレーン専用のソフトバイト予算 (#3909): 最終シリアライズされたリクエストがこれを超過した場合、まず OUTBOUND COPY から古い画像が除去される (プレースホルダーノートとしてアーカイブ — 元画像はセッションストレージに残り、ツールアームされたレーンでは read_original_image / decompress で復元可能 — 注入ツールを拒否する codex スタイルのレーンはサイズのみ注釈を保持)、その後残ったものは jimp maxDim ラダーを通じて有界にダウンスケールされる。画像密集セッションが空けられるギャップを閉じる: トークンスペースの折りたたみはトークンで決定するが、上流はバイト/ピクセルデコード CPU (Cloudflare Worker 503) で拒否するため、約 48 MiB のリクエストは同じピクセルを再送信するたびに永遠に 503 になる。マネージドトランスポートがインストールされていない場合 (spawned リレー) のみ適用される; WS レーンは network.wsOutboundBytes を使用し、マネージド HTTP トランスポート (inline-engine / dsh-inline) はここでは決して除去されない (#3701 Finding 1)。0 に設定すると無効化 (従来のそのまま送信する動作); ハード拒否上限は network.outboundBodyBytes のまま。 | +| `network.ingestBodyBytes` | number | 33554432 | BILI_INGEST_BODY_BYTES | デコード後 (#5794 item 2) の JSON.parse + 正規化スイープのためのコストバンド (デコードバイト数)。これを超過するテキスト主体のボディは、スイープ前に実行可能な 413 (ステージ ingest) で拒否される。なぜなら、32 MiB を超えるパース可能なテキストボディはすでに約 800 万トークンであり、すべての実際のモデルウィンドウを超えており、それをパースするためにイベントループの時間を数秒消費する (51.2 MiB / 29,619 メッセージのインシデント: 1 ラウンドあたり 5.5–7.2 秒、ローカル CPU の 54.6%、FATAL 747 秒) ことは成功に終わらないためである。画像を含むボディはすべてのレーンで免除される: base64 ピクセルは設計上トークンメーターから除外される (画像は別途請求され、生バイト数では決して失格にならない — #496/#1800/#857) ため、バンド超過の画像量は、アドミッションスロット、受信上限、および各レーン独自の shed / 送信前バイト予算 (#3909 約 48 MiB の画像密集セッション、#3701 WS スクリーンショット; Responses レーンは完全に免除) によって管理される。アドミッション SLOTS (network.receiveBodyBytes 閾値) とは異なる: スロットは大型デコードの並行性を制限するが、この上限は単一のボディを制限する。0 に設定すると無効化 (従来のすべてパースする動作)。 | +| `network.maxMessages` | number | 0 | BILI_MAX_MESSAGES | 上流ごとの messages[] 配列長のハード上限 (#5000 item 2) — COUNT 次元: バイト/トークン推定では表現できないワイヤー制約 (#5000 セッションの 26,903 メッセージ / 55.2 MiB はすべてのサイズゲートを通過したが、カウントエラーで上流で死んだ)。意図的に上流ごと: 普遍的な値が存在しないため、デフォルトは 0 = 無効; 上流の既知の制限に設定し、カウント超過のボディには保証された上流 400 の代わりに実行可能な 413 (セッションの再起動または巻き戻し) を返す。カウントのみ — 決して折りたたまない。プリフライト (トークントリガーの前) および no-model レーンのエグレスフュージで強制される。 | +| `network.caFile` | string | unset | BILI_CA_FILE | bili の独自のアップストリームフェッチが信頼する追加ルート CA を含む PEM ファイルへのパス (#3776)。Node の組み込みルートおよび NODE_EXTRA_CA_CERTS エントリとマージされる — 決して置き換えない。HTTPS/暗号化接続スキャンを行うセキュリティソフトウェア (Kaspersky、エンタープライズ DLP) またはアップストリームを再署名する企業 MITM プロキシに対して: そのルート CA を PEM にエクスポートし、これを指すように設定する。未設定 = デフォルトの信頼、バイト単位で同一の動作。 | +| `guardrails` | object | {} (all defaults) | — | ガードレール: pi/omp プラグインバンドル用のツール出力ガードレール (#3066) およびプロキシ側のテキストランストリームガード (#3406)。 | +| `guardrails.bashTimeout` | number | 60 | BILI_GUARDRAIL_BASH_TIMEOUT | モデルが bash ツールのタイムアウトを省略した場合に注入される秒数(#3066 のオーナー意図、#3366 で再確認:監督のない bash 呼び出しが pi セッションを丸一日ハングさせる可能性があるため、ホストスキーマにはデフォルト値が提供されていない)。N を設定して調整し、0 に設定すると注入を無効にする(pi ネイティブのデフォルトなし)。 | +| `guardrails.maxOutputBytes` | number | 50000 | BILI_GUARDRAIL_MAX_OUTPUT_BYTES | pi/omp プラグインにおけるツール結果ごとのテキスト出力バイト数上限(0 で上限を無効化)。上限超過の出力は先頭から切り詰められ、ホストが保存した完全な出力を指す通知が付与される。 | +| `guardrails.repetition` | boolean \| object | true | BILI_GUARDRAIL_REPETITION | pi/omp プラグイン向けの同一呼び出しループブレイカー:短時間に連続して発行された同一呼び出しが 3 回目に達すると警告を発する(引数の比較はキー順序に依存しない。実際に 5 秒以上実行された以前の同一呼び出しは長時間ポーリングとみなされ、実行が再開される)。5 回目に最終的な拒否を 1 回発行する(その呼び出しは拒否されるがターンは存続する)ことで、正当な待機/ポーリングがより長い待機に切り替えられるようにし、その拒否後に同一呼び出しが繰り返された場合のみターンを中断する(#5225)。オブジェクト形式では、`enabled`(デフォルト true、ゲート)、`warn`(デフォルト 3、警告閾値)、`abort`(デフォルト 5、最終拒否閾値)、および `recovery`(デフォルト false、オプトインのグレースフルターミネーションモード:呼び出し 6〜(abort+4) はスタックレポート付きで拒否されるがターンは存続し、同一呼び出しが abort+5 連続に達した場合のみターンが強制終了される(#5505))も追加で受け付ける。false / 環境変数 0 で無効化。オブジェクトのサブフィールドはファイル専用(環境変数経由では公開されない)。 | +| `guardrails.repetition.enabled` | boolean | true | — (file-only) | オブジェクト形式で使用する場合の同一呼び出しループブレイカーをゲートする。true(デフォルト)で有効化、false で無効化。よりシンプルなオプトアウトには `repetition: false`(ブール形式)を使用する。 | +| `guardrails.repetition.warn` | number | 3 | — (file-only) | 最初の警告閾値。この回数以降の同一呼び出しには、結果に WARNING 通知が追加される(#3066)。`abort` より小さい値でなければならない。 | +| `guardrails.repetition.abort` | number | 5 | — (file-only) | 最終拒否閾値。この回数を超えた次の同一呼び出しは、実行されずにブロックされ拒否され、FINAL WARNING が付与される(#5225)。`warn` より大きい値でなければならない。 | +| `guardrails.repetition.recovery` | boolean | false | — (file-only) | オプトインのグレースフルターミネーションモード(#5505)。true の場合、最終拒否(abort)後の呼び出しはスタックレポート付きで拒否されるがターンは存続する(ソフトストップ)。ターンが強制終了されるのは、同一呼び出しが abort+5(ハードバックストップ、デフォルト 10)に達した場合のみ。false(デフォルト)= 元の動作:呼び出し 6 で ctx.abort() が実行される。 | +| `guardrails.textRunThreshold` | number | 200 | BILI_GUARDRAIL_TEXT_RUN_THRESHOLD | レスポンスストリーム上のデコード済みモデルテキストに対する単一コードポイント反復ブレイカー(#3260;#3331 レビュー後に #3406 の項目 1 でキルスイッチが追加)。N 連続の同一コードポイントでトリガーされる - 正当な散文/コードはデフォルトの 200 を大きく下回るが、シンボルループモデルはそうではない。N を設定して調整し、0(または負)で無効化:正当な長い同一文字出力(コードコメントの区切り、ASCII ルール)はストリーム途中で切断されなくなる。thinking/reasoning チャネルもこのレーン内に存在する。 | +| `persist` | object | {} (all defaults) | — | XDG ステートディレクトリ下へのセッション永続化。 | +| `persist.enabled` | boolean | true | BILI_PERSIST | セッションレコードをディスクに書き込むためのマスタースイッチ(0/false でオフ)。 | +| `persist.zstd` | boolean | false | BILI_PERSIST_ZSTD | 永続化されたセッションファイルを Zstd 圧縮する(1/true で有効化)。 | +| `persist.debounceMs` | number | 500 | BILI_PERSIST_DEBOUNCE_MS | セッションファイルの書き込みデバウンスウィンドウ。 | +| `persist.maxDelayMs` | number | 5000 | BILI_PERSIST_MAX_DELAY_MS | 継続的なアクティビティ下で保留中のセッションファイル書き込みが待機できる最大時間 — デバウンスウィンドウはすべての変更で再起動されるため、この予算は摩耗に敏感なドライブ上の定常状態での書き換え速度を制限する(#6058)。 | +| `persist.tailTokens` | number | 16384 (0 disables message persistence) | BILI_PERSIST_TAIL_TOKENS | エクスポートの忠実性のために生テキストとして保持される最近のメッセージのトークンサイズ末尾。 | +| `persist.epermAlertThreshold` | number | 5 | BILI_PERSIST_EPERM_ALERT_THRESHOLD | ログにアラートを出すまでの連続 EPERM 書き込み失敗回数。 | +| `persist.epermAlertRepeatMs` | number | 0 (no repeats) | BILI_PERSIST_EPERM_ALERT_REPEAT_MS | EPERM アラートの繰り返し間隔。0 の場合は 1 回のみログ出力する。 | +| `storage` | object | {} (all defaults) | — | 統合 SQLite ストレージサイドカーの設定 (#2671)。 | +| `storage.unified` | legacy\|shadow\|full | unset (full) | BILI_STORAGE_UNIFIED | 階層型ストレージ移行スイッチ (#2671): shadow = ダイジェスト照合付き統合 SQLite ダブルライトのドライラン; full = ドロップイン読み取りパス (オーガニックインポート付きの統合優先読み込み、レガシーフォールバック)。現在、どこでも未設定の場合は FULL がデフォルト (#3818 の反転 - shadow ドライランは #2815 以降クリーンに照合されたため、インデックスが読み取りパスとなる; JSON エンベロープは引き続き書き込まれ、レガシーは 1 行のエスケープハッチとして残る)。ファイル階層は厳密に legacy/shadow/full; 環境変数階層は 1/true (=shadow) と unified (=full) も受け入れ、ファイルより優先される。レーン起動ごとに 1 回のみ解決される - ホット編集には再起動が必要。暗号化 (BILI_ENCRYPTION_KEY) はサイドカーをハードブロックする。 | +| `storage.backend` | sqlite\|mysql | unset (sqlite) | BILI_STORAGE_BACKEND | ストレージバックエンドの選択 (#3388 / #3931): 統合ストアは操作レベルの非同期 StorageBackend 契約を消費する。sqlite がデフォルト (Promise ラップされたアダプター背後の既存の UnifiedStore)。mysql は完全に配線済み (ステップ 2+3): openBackend("mysql", dsn) は MySQL 8.0 に対して実際の MysqlBackend を開く - 完全な契約サーフェス (CAS リファレンスカウント付きのインジェスト、読み取り、session_ext、リープジャーナル、アーカイブ/リストア/GC、チェックポイント、会話)、mysql2 は通常の依存関係としてバンドルされ、遅延ロードされる (mysql を選択しない起動では決してロードされない)。プロキシのホットパスは非同期シャドウファサードを通じて配線されている: セーブはシリアルバックエンドキューにエンキューされる (ウォーターマークデルタ、孤立/リープジャーナル、ダイジェストサンプリング - sqlite はゼロ await の同期高速パスを不変のまま維持)、同期読み取りは JSON エンベロープに乗る (サイドカーは ready() 経由で非同期にアタッチされる; viewFor/importRecord の同期ファサードは意図的にミスする)、レプリカ/ext/GC/エクスポート/フォークは非同期ツインを話す (#4911: フォークレーンはそれらを通じて lastLiveSeq + 行クローンに await する; フォールドアンカーバックフィル / スナップショットレンダリングのための同期ウィンドウ読み取りは意図的にエンベロープ提供される)。writerOff は sqlite のみ (エンベロープは mysql の同期読み取りパスである)。不明な名前は通知付きで sqlite にフォールバックする。レーン起動ごとに 1 回のみ解決される。 | +| `storage.mysql.dsn` | string | unset | BILI_MYSQL_DSN | storage.backend="mysql" 用の MySQL DSN (#3388 ステップ 2, #3931): mysql://user:pass@host:3306/db。StorageBackend 契約パスによって消費される (ホットパスを含む - 非同期シャドウキュー)。環境変数 BILI_MYSQL_DSN がファイルキーより優先される。空/未設定 = mysql バックエンドが開けない - 文書化されたエラーは両方のノブと動作するデフォルトを名指しする。 | +| `storage.sqliteAutoDownload` | boolean | true | BILI_SQLITE_AUTO_DOWNLOAD | 1 回限りの SQLite エンジンの自己ダウンロードのゲート (#2833): プロセス内でエンジンが利用可能でない場合 (組み込みの node:sqlite なし、ホストインストールの better-sqlite3 なし) かつこのプラットフォームで統合サイドカーが望まれる場合、bili は npm レジストリからピン留めされた better-sqlite3 プリビルトタールボールを 1 回ダウンロードし (~11 MB、sha512 検証済み)、キャッシュディレクトリに保存し、その後のすべての起動で再利用する。エンジン解決順序: 組み込み node:sqlite (Node >= 22.5) -> ホスト提供の better-sqlite3 -> キャッシュされた自己ダウンロード -> 自己ダウンロード (このスイッチでゲート) -> なし (レガシーのみ、#2825 のデグレード契約)。このスイッチはネットワークフェッチのみをゲートする - キャッシュされたコピーは false でも使用される; 非サポートプラットフォームでは決してダウンロードしない。タールボールのダウンロードは組み込みミラーリストを辿る (#3338): 設定されたレジストリ (BILI_UPDATE_REGISTRY / update.registry) が最初に試され、次に https://registry.npmjs.org、次に https://registry.npmmirror.com - sha512 検証済みのタールボールを返す最初のミラーが勝つ; エンジンなしの Node < 22.5 はデグレード理由に明示的な Node アップグレードヒントが付く (#3385)。エンジン成果物はランタイムごとにピン留めされる。なぜなら、バインディングはそのパッケージが宣言する範囲外ではロードできないため: N-API >= 10 を持つ Node >= 22 は better-sqlite3 v13 を使用 (独自のプリビルドを保持する 1 つのタールボール)、一方 v13 のメジャーフロアは通るが N-API 9 のみ搭載する Node 20 と Node 22.0-22.12 バンドは v12.9.0 を使用 (JS のみのタールボールとその ABI キー付きプリビルド、バイナリミラーから取得され nativeBinding を通じてバインドされる)。これにより、低バージョンの Node でも統合レーンに留まり、レガシーへのデグレードを避ける。ピン留めされた成果物が提供できないランタイム (すべてのフロア未満、またはプリビルドがターゲットとしない ABI) は、ロード前に拒否される。ダウンロードもキャッシュされたコピーも登録されない。そのようなバインディングのロードは優雅に失敗するのではなくプロセスをクラッシュさせるため (#3341, #3894)。ダウンロード失敗は、キャッシュディレクトリ配下にマーカーファイルとして永続化される 6 時間のリトライクールダウンをアームする (billion-context/sqlite/.bootstrap-failed.json); ストレージ診断ブロブはマーカーの絶対期限時間とパスを表示する - そのファイルを削除して bili を再起動すると、ウィンドウ全体を待たずに即座のリトライを強制できる (#3788)。 | +| `storage.jsonWriter` | on\|off | on | BILI_STORAGE_JSON_WRITER | フェーズ 3 エンベロープスイッチ (#2960): off は storage.unified が full の間、レガシー JSON セッションエンベロープの書き込みを停止する - SQLite インデックスが唯一の永続コピーとなる (読み取りはすでに統合優先; 起動時にインデックスの和集合を列挙するため、インデックスのみのセッションは正常にロードされる)。有効な full モードでのみ尊重される: shadow/legacy (または暗号化が有効な場合) では、JSON ファイルが唯一の真実のソースであるため、1 回限りの警告付きでリクエストは無視される。環境変数階層 0/false/off = off、1/true/on = on が厳密なファイル表記より優先される。フェイルセーフ: サイドカーが実行中に自身を無効化した場合、次のセーブでエンベロープ書き込みが再開される。ロールバック: ノブを未設定にする - 書き込みが再開され、インデックスのみのセッションは起動和集合経由で引き続きロードされ、レプリカ/リストアはポータブルな JSON エンベロープを再物質化する。バイナリのダウングレード (または SQLite エンジンの喪失) は、>=v0.1.197 バイナリが再び実行されるまで、インデックスのみのセッションを v0.1.196 以前のバージョンから不可視にする - データは index.db に無傷のまま残るが、古いコードによって読み取られないだけである。セッションごとの CCR コンテンツストアサイドカーも書き込みが停止する - full モードでは、すべての読み取りで最初にインデックスの ccr ミラーが参照されるため、ミラーが永続コピーとなる。jsonWriter=off レーンは、そのセッションディレクトリの唯一のライターでなければならない: off レーンは統合優先で読み取り、決してファイルにフォールバックしないため、同じディレクトリに対して legacy/shadow で実行されるピアインスタンスは静かに分岐する (その JSON コピーは更新を受け取らなくなり、off レーンはピアの書き込みを決して見ない)。 | +| `storage.walJournalSizeLimitBytes` | number | 8388608 | BILI_STORAGE_WAL_JOURNAL_SIZE_LIMIT_BYTES | index.db-wal の WAL 回収上限 (#3250)、バイト単位: 完了したチェックポイントごとに WAL ファイルがこのサイズまで切り詰められ、長寿命プロセスにおけるディスク使用量とクラッシュ復旧リプレイを制限する。セッションごとのデータクォータではない - データは書き込まれた時点で index.db に着地し、WAL はチェックポイント間のフレームをステージングするだけなので、セッション数/サイズはこれをスケーリングしない; 大きなバーストは、次の完了チェックポイントが切り詰めるまで一時的に超過しうる。高い = 切り詰め IO が稀になるが、定常時のディスク使用量が増え、クラッシュリプレイのテールが長くなる。環境変数階層 (正の整数) がファイル階層より優先される; ゴミまたは非正の環境変数値は、起動を失敗させるのではなくファイル/デフォルト階層にフォールスルーする。レーン起動時にストアが開かれる時点で適用される - ホット編集には再起動が必要。有効な値は統合有効ログ行とストレージ診断ブロブに表示される。 | +| `storage.archiveAfterDays` | integer | 365 | BILI_STORAGE_ARCHIVE_AFTER_DAYS | 日単位の GC 年齢スイープウィンドウ (#3463, #3901): これより長くアイドル状態のセッションはアーカイブされる - 単一のアーカイブログ (セッションディレクトリ配下の archive/archive.jsonl — セッションごとのファイルスプレーなし) に 1 行の JSON が追記され、トombストーン行がラベルとアイデンティティを保持し、コンテンツ/メディア参照が解放され、リストアは 1 つの POST のみで可能。0 は年齢スイープを無効にする; POST /__bili/storage/gc は常に実行され、既存の index.db を縮小するには ?vacuum=full を取る (新規書き込みには常に auto_vacuum=INCREMENTAL が有効)。同じ操作に CLI レイヤーがある (#3928): bili storage gc [--days N] [--vacuum full\|incremental] [--dry-run]、および bili sessions ls/rm/archive/restore (README の 'Storage maintenance CLI' セクション)。環境変数がファイル階層より優先される。 | +| `sessions` | object | {} (all defaults) | — | セッションテーブルサイズ上限とオプトインによるゴミ収集。 | +| `sessions.max` | number | 256 | BILI_MAX_SESSIONS | メモリ内セッションテーブル上限 (アイドルセッションの LRU 退避)。 | +| `sessions.warmMax` | number | 0 | BILI_SESSION_WARM_MAX | 有界な起動 (#2803/#3050): リスニング前に起動時に水合される最大最近保存セッション数; 古い状態はオンデマンドで再ロードされる。デフォルト 0 (急激なウォームセットなし — 最初のタッチが 1 回のオンデマンドロードを支払う; 急激な動作を復元するには 8 を設定)。sessions.max で上限が設定される。 | +| `sessions.warmMaxBytes` | number | 67108864 | BILI_SESSION_WARM_MAX_BYTES | 起動ウォームセットのデコード済みバイト予算 (#2803)。ディスク上の圧縮バイトではなくデコード済みサイズをカウントするため、zstd アーカイブが RAM 境界をすり抜けることはない。予算を超える単一のファイルは決してウォームされない。 | +| `sessions.residentMaxBytes` | number | 4294967296 | BILI_SESSION_RESIDENT_MAX_BYTES | 推定リザident セッションバイトのソフトターゲット (#2803; #5779 で 512 MiB から 4 GiB に引き上げ — 単一のセッションは通常 512 MiB を超え、より小さい予算に対して永遠にピンポンしていた)。アクティブ/進行中の状態はそれより上にピン留めされる; ターゲット超過時、アイドル状態はリクエスト完了時にディスクへ排出される。メモリが少ないマシンではこれを下げる。 | +| `sessions.hardMaxBytes` | number | (same as `sessions.residentMaxBytes`) | BILI_SESSION_RESIDENT_HARD_MAX_BYTES | セッションごとの推定リザident バイトのハード上限 (#4788, 決定 #4792 D1-A)。プールソフト上限とは異なり — それは他のコールドセッションのみを退避でき、単独アクティブセッションには決して触れない — これは 1 つのセッションを制限する: リクエスト終了境界で上限超過時、そのドロップ可能なフィールド (フォールドブロックのオリジナル、メタデータ台帳、有界ビューを超える生テール) はプール免除セッションであっても強制的にディスクへ戻され、次のターンは狭いディスク読み取りを通じて必要なものを透明に再読み取りする。最後の保存が確実に着地したことが証明される限り、安全なドロップはすべてのリクエスト境界で実行される; 上限はセッションごとのコールアウト (警告、60 秒にスロットリング) を追加する。`0` は上限チェックを無効にする。 | +| `sessions.contentStorePin` | boolean | false | BILI_SESSION_CONTENT_STORE_PIN | #4788 フェーズ2の常駐ドロップのエスケープハッチ: 各セッションのコンテンツストアをメモリに固定する(折りたたみは行われない)。デフォルトはオフ: 検証済みの保存が完了するたびに、アイドル状態のセッションのコンテンツストアはリクエスト間でドロップされ、統合インデックスミラーまたはサイドカーファイルからオンデマンドで再読み込みされる。検証済みのコピーがないストアを持つセッション(例: 新しいフォーク子プロセス)は自動的に常駐する。RAMを犠牲にしてゼロの再読み込みレイテンシが必要な場合にこれを設定する。 | +| `sessions.gc.enabled` | boolean | false | BILI_SESSION_GC | 古い永続化セッションのオプトインによるガベージコレクション(このフラグなしでユーザーデータを静かに削除することはない)。 | +| `sessions.gc.maxAgeDays` | number | 7 | BILI_SESSION_GC_MAX_AGE_DAYS | GCの年齢しきい値(日)。 | +| `sessions.gc.maxTokens` | number | 1000000 | BILI_SESSION_GC_MAX_TOKENS | セッションレコードごとのGCトークンサイズしきい値。 | +| `sessions.gc.intervalMs` | number | 3600000 | BILI_SESSION_GC_INTERVAL_MS | GCスイープ間隔。 | +| `plugin.snapshotCapBytes` | number | 104857600 (0 disables snapshots) | BILI_PUBLIC_SNAPSHOT_CAP_BYTES | ネイティブプラグインに配信されるフォークAPIパブリックスナップショットのサイズ上限。 | +| `snapshot.shadow` | boolean | true (on) | — | スナップショットレンダリングのシャドウ観測可能性(#3756のフォローアップ): レンダリングレーンがまだロールアウトゲートされている間、すべてのアームされたターンがスナップショットビューを計算し、レガシーアウトバウンドとの差分を分類し、セッションごとのカウンターを記録する(Webパネル行 + /__bili/status の snapshotShadow 集計 + snapshot-shadow 診断トピック)。デフォルトはオン - これはロールアウト切り替えをゲートするエラー率を持つフリートワイドのドライランである。環境変数 BILI_SNAPSHOT_SHADOW が優先される。追加のターンごとの計算を望まない場合は false/0/off でオフにする。 | + +**更新 & アドバイズリー** + +| キー | 型 | デフォルト | 環境変数 | 説明 | +|-----|------|---------|-----|-------------| +| `autoUpdate` | boolean | true | ACP_AUTO_UPDATE | 自動 npm バージョンチェック(約 3 分ごと);ACP_AUTO_UPDATE=0 または --no-auto-update で無効化。 | +| `autoRestartOnUpdate` | boolean | false | ACP_AUTO_RESTART_ON_UPDATE | 新しいバージョンがインストールされた後、デーモンを自動的に再起動する。 | +| `updateTag` | string | latest | ACP_UPDATE_TAG | セルフアップデート用の npm dist-tag チャンネル:latest(デフォルト)、dev、または pr。 | +| `update` | object | {} (all defaults) | — | セルフアップデートのチャンネル設定。 | +| `update.registry` | string | "npmjs" (registry.npmjs.org) | BILI_UPDATE_REGISTRY | セルフアップデート用のカスタム npm レジストリベース URL(プライベートミラー)。 | +| `update.checkIntervalMs` | number | 180000 | BILI_UPDATE_CHECK_INTERVAL_MS | npm レジストリのバージョンチェックの間隔。 | +| `update.staggerMinDelayMs` | number \| string | 900000 (built-in 15 min) | BILI_UPDATE_STAGGER_MIN_MS | #3619 スタグダードロールアウト: このマシンのベースアップグレード遅延ウィンドウの下限; ms 数値または期間文字列 (15m / 2d / 1d12h); 0 で遅延を無効化 (従来の即時実行)。リモートポリシーのデフォルトウィンドウとバージョン別の上書きがこれに重ねて適用される。 | +| `update.staggerMaxDelayMs` | number \| string | 172800000 (built-in 48 h) | BILI_UPDATE_STAGGER_MAX_MS | #3619 スタグダードロールアウト: このマシンのベースアップグレード遅延ウィンドウの上限; ms 数値または期間文字列 (48h / 2d); min とともに 0 に設定すると従来の即時アップグレードに戻る。 | +| `update.policyUrl` | string | official repo raw URL | BILI_UPDATE_POLICY_URL | リモート自動更新ポリシーファイルの URL 上書き (テスト用シーム — 本番環境では公式リポジトリに固定される)。 | +| `advisoryCheck` | boolean | true | BILI_ADVISORY_CHECK | 重大な欠陥に関するアドバイザリーウォッチャー; 実行中のバージョンが影響を受ける場合、推奨される修正を強制インストールする。 | +| `advisoryUrl` | string | unset (built-in feed) | BILI_ADVISORY_URL | アドバイザリーフィードの URL 上書き。 | +| `remoteAnnouncementsUrl` | string | unset (official feed: GitHub master announcements/remote.json) | BILI_ANNOUNCEMENTS_URL | リモートアナウンスメントフィードの URL 上書き (#5548): JSON ドキュメント {v: 1, entries: [...]} — ローカルアナウンスメントファイルと同じレコードスキーマ。他のウォッチャーと同様に約 3 分ごとに取得され、キャッシュされたスナップショットは再起動や障害後も維持される。ファイアウォールインストールではこれをリレーミラーに向ける。不正なプッシュは拒否され、最後に正常だったコピーが表示され続ける。`/announcements/*.json` 内のローカルファイルは、同じ ID のリモート/組み込み通知を常にシャドウする。 | +| `releaseNotesCheck` | boolean | true | BILI_RELEASE_NOTES_CHECK | Web パネル用のリリースノートフィード (取得とキャッシュのみ; 何もインストールしない)。 | +| `releaseNotesUrl` | string | unset (built-in feed) | BILI_RELEASE_NOTES_URL | リリースノートフィードの URL 上書き。 | + +**診断 & チューニング** + +| キー | 型 | デフォルト | 環境変数 | 説明 | +|-----|------|---------|-----|-------------| +| `diagnostics` | object | {} (all defaults) | — | ローカルトラブルシューティング用ノブ(ダンプ、レンダリング/インジェクションのトグル、count-tokens のパススルー)。 | +| `diagnostics.dumpBody` | boolean | false | ACP_DUMP_BODY | トラブルシューティングのために、完全なリクエスト/レスポンスボディをログにダンプします。ダンプは PLAINTEXT であり、認証情報が含まれる可能性があります — 共有前にスクラブしてください(#4482)。 | +| `diagnostics.dumpReq` | boolean | true | ACP_DUMP_REQ | 呼び出しごとに送信されるアップストリームリクエストのメタデータをログに記録します。dumpBody がオンの場合、PLAINTEXT ボディのダンプも制御します(共有前にスクラブしてください、#4482)。 | +| `diagnostics.rawDumpDir` | string | /raw | ACP_RAW_DUMP_DIR | 生ワイヤダンプのディレクトリ。 | +| `diagnostics.dump4xx` | boolean | false | BILI_DUMP_4XX | 事後検証のために、アップストリームの 4xx レスポンスをディスクに永続化します。ボディは PLAINTEXT であり、認証情報が含まれる可能性があります — 共有前にスクラブしてください(#4482)。 | +| `diagnostics.dump4xxMaxBytes` | number | 2097152 (floor 1024) | BILI_DUMP_4XX_MAX_BYTES | 単一の 4xx ダンプファイルのサイズ上限。 | +| `diagnostics.maxTotalBytes` | number | unset (off) | BILI_DUMP_MAX_TOTAL_BYTES | デバッグダンプディレクトリ(dumps/、raw/、SSE ダンプディレクトリ)の総サイズ上限。超過時は最も古いファイルから削除されます(下限 1 MiB)。デフォルトではダンプにローテーションがなく、アクティブなキャプチャ下では 1 日に数十 GB まで増加する可能性があります(#2412)。 | +| `diagnostics.maxAgeDays` | number | unset (off) | BILI_DUMP_MAX_AGE_DAYS | デバッグダンプディレクトリの日数ベースの年齢上限。これより古いファイルは削除されます(下限 1 h)。デフォルトではオフです。 | +| `diagnostics.logRetentionHours` | number | 48 (floor 1) | BILI_LOG_RETENTION_HOURS | PRIVATE 実行ログ(`bili.log`)を保持する時間(時間単位)で、カバーする範囲を指定します。ロガーはアクティブファイルを 10 MiB でシールし、1 つの `bili.log.old` ではなく、不変で一意の名前を持つジェネレーションに変換するため、保持されるすべてのジェネレーションが列挙可能であり、ウィンドウは偶然ではなく実在のものとなります。これは TARGET であり、約束ではありません:`diagnostics.logBudgetBytes` がハードバウンドであり、常に優先されます — より短いウィンドウは報告されますが、完全にカバーされていると黙って主張されることはありません。報告されるカバレッジは、最も古い保持行から現在までの測定されたスパンです。ジェネレーションファイルには系譜のエビデンスがないため、`continuity` は常に `unknown` となり、未断絶のウィンドウを主張するステータスはありません(順序が乱れたタイムスタンプも、履歴の欠落として扱われません)。下限 1 h。正でない値または数値でない値は 48 h のデフォルトにフォールバックし、SET された環境変数がスイッチを所有するため、不正な `BILI_LOG_RETENTION_HOURS` はこのキーではなくそのデフォルトにフォールバックします。 | +| `diagnostics.logBudgetBytes` | number | 268435456 (256 MiB, floor 1 MiB) | BILI_LOG_BUDGET_BYTES | アクティブログおよびすべてのシール済みジェネレーション全体でのハードな総バイト予算。超過時は最も古いジェネレーションから削除されます — シール済みタイムスタンプ順に最も古いものから(レガシーの `.old` は独自の mtime を採用)ため、移行されたレガシー成果物は新しいタイムスタンプ付きジェネレーションを優先してスキップされるのではなく、実際の年代順の位置で回収されます。デフォルトのウィンドウがこれの何倍にも及ぶ多忙なマシンにおいて、ディスクコストとプライバシーリスクを制限します。`logRetentionHours` に必要なバイト数が予算を超える場合、BUDGET が優先され、不足分が表面化します(開始時の `[warn]`、および `GET /__bili/logs` の `retention` オブジェクト)。ACTIVE ファイルは決して削除されないため、単一のアクティブファイルが予算を単独で超過する場合、切り詰められるのではなく予算超過として報告されます。下限 1 MiB。正でない値または数値でない値は 256 MiB のデフォルトにフォールバックし、設定された `BILI_LOG_BUDGET_BYTES` は時間キーと同様にスイッチを所有します。ファイルは所有者のみアクセス可能:最初のバイトから 0600、アーカイブディレクトリは 0700(win32 には POSIX モードビットがなく、state-dir の ACL が支配します)。 | +| `diagnostics.renderNone` | boolean | false | ACP_RENDER_NONE | すべての ACP タグレンダリングを無効化します(生ワイヤ研究モード)。 | +| `diagnostics.invariantJudge` | boolean | true | BILI_INVARIANT_JUDGE | I1/I2 送信不変性ジャッジを L1 アドバイザリーとして武装したままにします(#3938):すべてのリクエストの送信バイトがクライアントの受信履歴と照合されます。違反は warn でログに記録され、クリーンな判定は debug で記録され、トラフィックはブロックされません。無効にするには false を設定するか BILI_INVARIANT_JUDGE=0 を設定してください。 | +| `diagnostics.noInjectTool` | boolean | false | ACP_NO_INJECT_TOOL | リクエストへの acp_compress ツール定義のインジェクションを停止します。 | +| `diagnostics.noCompressPrompt` | boolean | false | ACP_NO_COMPRESS_PROMPT | システムプロンプトへの圧縮教義の追加を停止します。 | +| `diagnostics.countTokensPassthrough` | boolean | false | ACP_COUNT_TOKENS_PASSTHROUGH | ローカルで応答する代わりに、/v1/messages/count_tokens をアップストリームにフォワードします。 | +| `diagnostics.compressProtocol` | "tools" \| "marker" | "tools" | ACP_COMPRESS_PROTOCOL | 圧縮用の ACP 注入サーフェス: ネイティブツール (デフォルト) またはレガシープロンプトマーカー。 | +| `fakeCompletion` | object | {} (all defaults) | — | 最終チャンクが切り詰められて到着した際に再リクエストを行うリトライループ。 | +| `fakeCompletion.retries` | number | 0 (opt-in) | BILI_FAKE_COMPLETION_RETRIES | 切り詰められた最終完了を再リクエストできる回数; 0 でループを無効化。 | +| `fakeCompletion.bufCapBytes` | number | 16777216 | BILI_FAKE_BUF_CAP | リトライループの累積ストリームに対するバッファサイズ上限。 | +| `codexCompact` | "intercept" \| "pass" | "intercept" | BILI_CODEX_COMPACT | bili 内で Codex のコンパクト化要求を処理する (intercept, デフォルト) または上流へ転送する (pass): 明示的な形式 (compaction_trigger + /responses/compact) と、通常のターンとして通過するインライン自動コンパクト化 (SUMMARIZATION_PROMPT テンプレート (#3008) によって検出) — ユーザーが上書きした compact_prompt は検出から外れ、そのまま通過する; bili が観察のみ (pass/gate) したコンパクト化は事後にリベースされる (#2372)。 | +| `ccrRetrievalTtlMs` | number | 600000 (0 disables retrieval) | BILI_CCR_RETRIEVAL_TTL_MS | acp_retrieve 経由でオリジナルを取得できなくなるまでの CCR 検索ポインタの生存期間。 | +| `decompressTmpCap` | number | 50 | BILI_DECOMPRESS_TMP_CAP | セッション内で保持される一時的な展開済みコンテンツのサイズ上限 (ブロック数)。 | + +**圧縮(グローバルレベル)** + +| キー | 型 | デフォルト | 環境変数 | 説明 | +|-----|------|---------|-----|-------------| +| `compress.modelContextLimit` | number \| "N%" | native window (model-declared) | — | 有効コンテキストウィンドウ(トークン数または N%):使用率の分母であり、事前チェックのハードウォール。最優先のウィンドウソース。 | +| `compress.maxContextLimit` | number \| "N%" | "75%" | — | 強制圧縮のナッジ閾値:履歴がこのウィンドウの割合を超えると、ナッジが即座に発火し、成長ゲートをバイパスする。ハードキャップではない。 | +| `compress.emergencyThresholdPercent` | number \| % | "95%" | — | 履歴がこのウィンドウの割合を超えた場合の、過大ツール出力の緊急切り詰め(maxContextLimit 以上である必要がある)。 | +| `compress.outputHeadroomMaxPct` | number \| % | 0.25 | — | max_tokens 経由で出力に確保されるウィンドウの割合の上限。 | +| `compress.nudgeGrowthTokens` | number | 50000 (kernel flat cadence) | — | 成長ゲート:折りたたみ可能な範囲がベースライン成長をこのトークン数だけ上回った場合のみ、ナッジが発火する(設計上フラットであり、ウィンドウサイズに依存しない)。 | +| `compress.tierNudgeTokens` | object {t1?, t2?, t3?} | derived (T1 = nudgeGrowthTokens, T2/T3 = ×1.5) | — | ティアごとのトークン質量トリガー閾値。未設定のティアは導出デフォルトにフォールバックするため、欠落/空 = レガシー統合動作 (#2376)。 | +| `compress.minPressureBenefitTokens` | number (≥ 0) | max(5000, limit × 1%) | — | 圧力バンドのナッジが発火するために必要な最小の回収可能トークン数。インフレ計器ルートでは、高頻度の小規模な churn の代わりに、大きなイベントに折りたたみをバッチ処理するようにこれを引き上げる (#3211)。明示的な 0 = レガシーの任意の保留中。 | +| `compress.requireUsageSampleForPressure` | boolean | true | — | ファントム圧力ガード:このラウンドの計器がローカル推定値(請求サンプルなし — 中断されたターン、TTL 期限切れ)の場合、圧力バンドはインフレした読み取り値に基づいて EMERGENCY を発火させるのではなく、実際のサンプルを最大 compress.maxEstimateHoldRounds ラウンド(デフォルト 2)まで待機し、その後レガシーの推定駆動決定にフォールバックすることで、レポートしないアップストリームが永遠に飢餓状態にしないようにする。false = 常にレガシー。 | +| `compress.maxEstimateHoldRounds` | number | 2 | — | ファントム圧力ガードのバックストップ (#5865 裁定):圧力バンドが推定値に基づいて発火する前に、推定グレードのラウンドを何ラウンド連続で待機できるか。使用量をレポートしないアップストリーム(匿名ゼロベースラインフォーク、サイレントバックエンド — ローカル推定値が唯一の圧力シグナルとなる場所)でも、自動圧縮が実行されるように上限が設定されている。0 = 待機なし。requireUsageSampleForPressure がオンである間のみ参照される。 | +| `compress.nudgeModelDecided` | boolean | off (unset) | — | モデル決定によるナッジタイミング (#2228):アームされたティア 1 のナッジは、まずセッションのキャッシュ済みプレフィックス経由の短いサイドコールで、モデルに「今すぐ圧縮することが現在のタスクに有益か」を尋ねる。厳密な JSON の "yes" は、プログラムで最終化されたスパンを持つ明示的なディレクティブを注入する。"no"、不正な回答、またはタイムアウトの場合、このラウンドでは何も注入しない。EMERGENCY アームとティア 2 以上の蒸留は常にレガシーの助言を維持する。明示的に有効化されない限りオフ。 | +| `compress.nudgeDecisionMaxTokens` | number | 200 | — | nudgeModelDecided が使用するモデル決定サイドコールの出力予算(トークン数)。0 より大きい必要がある。 | +| `compress.requireNudge` | boolean | off (unset) | — | 無促のモデル主導圧縮の禁止 (#5683/#5943):NUDGE CREDIT がライブでない限り、compress 呼び出しは拒否される — 最後にモデルに実際に到達した圧縮ナッジ(助言、決定ディレクティブ、緊急注入はすべて発行;"gated"/"vetoed"/"skipped" は発行しない)によって発行された 20 モデルラウンドのウィンドウ。各新しい注入で更新され、ナッジされないモデルラウンドごとに 1 ずつ減衰する(非モデルリクエスト形状はそれをオープンに保つ)。成功した折りたたみはクレジットを消費しないため、ナッジの推奨クリーンアップを複数ラウンドにわたって完了することは依然として合法である。拒否は、折りたたむ代わりにモデルにエラーレシートを送る。bili 自身のオーバーフローバックストップ折りたたみは免除される。自分で折りたたむモデル(例: qwen 27b)向け;プロバイダー/モデルごとにスコープを限定できる。明示的に有効化されない限りオフ。 | +| `compress.requireRecommendation` | boolean | off (unset) | — | 範囲外のモデル主導圧縮の禁止 (#5683):提出されたすべての範囲は、bili が現在折りたたみを推奨している範囲内に留まらなければならない — ナッジテキストと acp_status が示すのと同じライブ折りたたみ可能セット(存在する場合、このリクエストの準備時オファー、それ以外の場合はライブ再計算)。判定はカバレッジによる:推奨スパンの細分化は合格し、アクティブなブロックにすでに折りたたまれたメッセージ(既存のサマリーを更新する再折りたたみ)は免除される。他のライブメッセージを含む範囲は、問題のあるスパンを特定するエラーレシートとともに全体として拒否される。明示的に有効化されない限りオフ。 | +| `compress.streamSummary` | boolean | false (unset) | — | 事前チェックの要約を、最初の試行からストリーミング(SSE)コールとして実行することを強制する。エラー駆動の自己学習は、ストリーミングを強制するアップストリームを独自に処理する(非ストリーミング要約での 400 はワンショット SSE プローブをトリガーする、#2494)が、ゲートウェイタイムアウト(例: Cloudflare HTTP 524)では決してアームしない:bili とオリジンの間にそのようなゲートウェイがある場合にこれを設定するか、単に 1 回のプローブ往復をスキップするために設定する。 | +| `compress.preserveRecentMessages` | number | 3 | — | 最新のメッセージは、折りたたみからソフト保護される。 | +| `compress.preserveRecentTokens` | number | kernel ≈5000 | — | 最新のトークンはフォールドからソフト保護される。 | +| `compress.minCompressRangeChars` | number (deprecated alias: minCompressRange) | kernel ≈5000 | — | フォールド可能な最小範囲(文字数)。これより短い範囲はフォールドされない。 | +| `compress.maxSummaryLength` | number | kernel 20000 | — | 1つの生成サマリーに対する文字数のハード上限。これを超える返信は全体として拒否される(切り詰めもリトライもされない)。外部サマライザーにはこの正確な上限が事前に通知される(#3635)。0 = 無制限。 | +| `compress.minSummaryLength` | number | kernel 50 | — | 生成サマリーの文字数下限:単一範囲はこれに単独で達する必要がある。複数範囲のバッチは、その結合サマリーがこれに達した場合に合格する(#5894)。0 = 無効。外部サマライザーはサマリーごとの下限に引き続き従う(#3635)。 | +| `compress.reconcile` | "off" \| "warn" \| "repair" | "repair" | BILI_FOLD_RECONCILE | クライアントがターン間で履歴を巻き戻しまたは書き換えた場合、フォールド状態を調整する。 | +| `compress.promptPack` | string (builtin: "default", "lean") | builtin "default" | — | 圧縮プロンプトパック。解決順序はプロジェクトパック → ユーザーパック → ビルトイン。`acknowledgePromptsRisk` によるゲートはされない。 | +| `compress.tiers` | boolean | true | — | T1→T3 の階層型蒸留により、フォールドコストを世代間で分散する。 | +| `compress.protectedTools` | string[] | none | — | 全履歴に対するハード除外:リストされたツールの結果は決してフォールドされない。パスパターン(`skill/`)は名前でスキルを選択する(#1947)。 | +| `compress.protectedLatestTools` | string[] | none | — | 最新の結果が古いものを上書きする累積スナップショット型ツールの最新インスタンスのみを保護する(例:todo リスト)。パスパターンはスキルごとに最新インスタンスを保持する(`skill/*`, #1947)。 | +| `compress.neverPreserveRecentTools` | string[] ([] valid) | ["decompress", "search_context", "read", "bash"] (kernel) | — | 最近保護ゾーンから除外(即時圧縮可能)。空の配列は何も除外しない(最大保護)。 | +| `compress.preserveRecentTools` | string[] | n/a (subtraction form) | — | 減算形式:最近ゾーンツールからこのリストを引いたものが完全保護される。ここでの空の配列は誤記として拒否される。 | +| `compress.visibilityMarkers` | boolean | true | — | `compress`/`decompress`/`search_context`/`acp_status` の結果後に可視性マーカーを追加。オフにすると模倣ナレーションが停止する。 | +| `compress.messageTimestamps` | boolean | true | BILI_MESSAGE_TIMESTAMPS | 圧縮メッセージレコードに不変の壁時計タイムスタンプを付与:ワイヤー上の ACP タグに `time=`、`compress` 受領証に `[start – end]` カバレッジスパン、サマリーに `Occurred` 行。デフォルトで ON:各メッセージに1つの不変な初回表示スタンプが決定論的にレンダリングされるため、再レンダリングされた履歴はバイト安定性を保つ(有効化時の再起動によるプレフィックス書き換えを超えるプロンプトキャッシュコストなし)。`false` に設定すると、#4313 以前のバイトを正確に再現する。 | +| `compress.rules` | boolean | false | — | 注入された `acp_rule` ツールを通じて配信される永続モデルリマインダー。フォールドからハード保護される。`pi/omp` は `/acp-rule` コマンドを公開する。プロキシモード専用 — プラグインモードでは無効であり、ホストがツールサーフェスを所有する。 | +| `compress.injectTool` | boolean | true | ACP_COMPRESS_TOOL | クライアント向けに `acp_compress` ツールを登録(グローバルレベルのみ)。 | +| `compress.injectNudge` | boolean | true | ACP_COMPRESS_NUDGE | ウィンドウが埋まるにつれて成長の通知を送信する(グローバルレベルのみ)。 | +| `compress.reasoning` | { drop?, threshold? } | drop true · threshold 2048 | — | 2048文字を超える完了ラウンドの推論実行を破棄する(デフォルトで drop: true);厳格な推論を要求するアップストリームでは drop: false が必要。 | +| `compress.absorb` | object | opt-in (disabled) | — | ツール結果を短い要約に即時蒸留するオプトイン機能;元データはコンテンツストアに保存される。デフォルトでは画像を含む結果のみが対象となる。 | +| `compress.blockOps` | object | off | — | 圧縮ブロック管理用のブロックライフサイクルツール(acp_retire / acp_restore / acp_rewrite)のオプトイン;デフォルト無効により、#5765 以前のワイヤーとバイト単位で同一を維持する。 | +| `compress.ccr` | object | enabled in proxy mode since v2 | — | コンテンツキャッシュと取得:大きな出力はセッションの隣接にロスカレスで保存され、先頭抜粋とポインタに置き換えられ、acp_retrieve 経由で取得される;上限や退避は行われない。 | +| `compress.search` | object | off | — | search_context の検索動作設定;現在、planAware リランキングを保持している。 | +| `compress.search.planAware` | boolean | false | — | オンにすると、search_context の候補が現在のプラン状態に対してリランキングされる;オフにすると、バイト単位で同一の語彙結果が維持される。 | +| `compress.prompts` | Partial | unset (kernel doctrine) | — | カーネル教義テキストを上書きする;品質に重要であるため、acknowledgePromptsRisk によってゲートされている。 | +| `compress.reasoningGuard` | object | off | — | gpt-5.x/6.x における推論格子の切り詰めに対する自動修復(最大3ラウンドの継続通知)。 | +| `compress.outputSteering` | object { enabled?, verbosityLevel?, effortRouting? } | enabled false · verbosityLevel 2 | — | システムプロンプトの末尾に簡潔性の指示を追加する;機械的な継続要求をクランプする。 | +| `compress.priceProfile` | { w?, r?, q? } | unset (registry, kernel fallback {1, 0.1, 4}) | — | w/r/q 比率を入力価格(書き込み/キャッシュ読み取り/出力)に対して正規化する;レポート専用であり、トリガーやワイヤーには影響を与えない。 | +| `compress.externalSummary` | object | opt-in (disabled) | — | プロバイダテーブルから参照される個別設定モデルに圧縮サマリーを送信する;3つの圧縮レベルすべてでチェーン全体の置換セマンティクスを持つ。 | +| `compress.acknowledgePromptsRisk` | boolean | false | — | カスタムプロンプトが有効になる前に true である必要がある。 | +| `compress.absorb.enabled` | boolean | false | — | 吸収蒸留ブロックを有効にする。 | +| `compress.absorb.minToolTokens` | number | 1000 | — | 吸収の対象となるツール結果の最小推定トークンサイズ。 | +| `compress.absorb.contextThresholdPct` | number \| % | unset | — | コンテキスト使用量がウィンドウのこの割合を超えた場合のみ吸収する。 | +| `compress.absorb.excludeTools` | string[] | [] | — | 吸収から除外されるツール名。 | +| `compress.absorb.toolName` | string | "absorb" | — | 吸収ツールの登録名。 | +| `compress.absorb.mediaOnly` | boolean | true | — | メディア(画像)を伴うツール結果に吸収を制限する。画像バイトはテキストにカウントされないため、minToolTokens の対象外となる。false に設定すると、従来の大規模結果の全文吸収が有効になる。 | +| `compress.blockOps.enabled` | boolean | false | — | 3 つのブロックライフサイクルツール(インジェクション + プロンプト + マニフェスト)を有効にする。Off = ツールなし、プロンプトセクションなし、リクエストごとのコストゼロ。 | +| `compress.ccr.enabled` | boolean | true (proxy mode) | — | コンテンツキャッシュおよび取得ブロックを有効にする。 | +| `compress.ccr.minToolTokens` | number | ≈4000 | — | CCR ストレージの対象となるツール結果の最小推定トークンサイズ。 | +| `compress.ccr.excludeTools` | string[] | [] | — | CCR ストレージから除外されるツール名。 | +| `compress.ccr.toolName` | string | "acp_retrieve" | — | 取得ツールの登録名。 | +| `compress.ccr.maxHeadChars` | number | 96 | — | ストレージポインタにインラインで残される最大ヘッド抜粋の長さ。 | +| `compress.prompts.compressPhilosophy` | string | unset (kernel text) | — | 圧縮哲学教義パラグラフの上書き。 | +| `compress.prompts.howToCompressRules` | string | unset (kernel text) | — | 圧縮手順ルールの上書き。 | +| `compress.prompts.tier2DistillRules` | string | unset (kernel text) | — | ティア 2 蒸留ルールの上書き。 | +| `compress.prompts.tier3CondenseRules` | string | unset (kernel text) | — | ティア 3 凝縮ルールの上書き。 | +| `compress.reasoningGuard.enabled` | boolean | false | — | 推論格子の自動修復を有効にする。 | +| `compress.reasoningGuard.maxContinue` | number | 3 | — | 切り詰めごとの最大 continue-nudge ラウンド数。 | +| `compress.reasoningGuard.maxTierN` | number | (built-in) | — | 修復済みラティス階層インデックスの上限。 | +| `compress.reasoningGuard.markerText` | string | "Continue thinking..." | — | 切り詰められた推論ラティスを示すマーカーテキスト。 | +| `compress.reasoningGuard.base` | number | (built-in) | — | 修復ラティスのベースオフセットパラメータ。 | +| `compress.reasoningGuard.offset` | number | (built-in) | — | 修復ラティスのオフセットステップパラメータ。 | +| `compress.reasoningGuard.debugLog` | boolean | false | — | 修復ループの詳細ログ出力。 | +| `compress.outputSteering.enabled` | boolean | false | — | システムプロンプト末尾に追加される簡潔性ディレクティブを有効にする。 | +| `compress.outputSteering.verbosityLevel` | number (0–4) | 2 | — | ディレクティブの目標冗長度レベル。 | +| `compress.outputSteering.effortRouting` | boolean | (built-in) | — | ディレクティブとともに努力ヒントをルーティングする。 | +| `compress.priceProfile.w` | number | unset (registry) | — | 入力価格に対する書き込み価格比。 | +| `compress.priceProfile.r` | number | unset (registry) | — | 入力価格に対するキャッシュ読み取り価格比。 | +| `compress.priceProfile.q` | number | unset (registry) | — | 入力価格に対する出力価格比。 | +| `compress.reasoning.drop` | boolean | true | — | 閾値を超える長さの完了ラウンド推論実行を破棄する。 | +| `compress.reasoning.threshold` | number | 2048 | — | 完了推論実行を破棄する文字数閾値。 | +| `compress.minCompressRange` | number | same as minCompressRangeChars | — | minCompressRangeChars の非推奨エイリアス(受け入れられ、それにマッピングされる)。 _(非推奨)_ | + +**プロバイダールートフィールド** + +| キー | 型 | デフォルト | 環境変数 | 説明 | +|-----|------|---------|-----|-------------| +| `models` | record name → { context?, output?, compress?, benefit? } | {} | — | モデルごとの宣言: コンテキストウィンドウ、出力上限、モデルごとの圧縮オーバーライド; トラフィックフィルタではない。 | +| `models.context` | number | unset (model registry) | — | このモデル名に対して宣言されたコンテキストウィンドウトークン数。 | +| `models.output` | number | unset | — | このモデル名に対して宣言された出力トークン上限。 | +| `models.compress` | object | unset | — | このモデルのレベル3圧縮オーバーライド(グローバル→プロバイダー→モデルのマージの中で最も深い)。 | +| `models.benefit` | boolean | false | — | エコノミクス台帳において、このモデルの無料クォータ課金をマークする。 | +| `proxy` | string ("" = explicit direct) | unset | — | ルートごとのアウトバウンドプロキシURL。 | +| `compressProtocol` | "tools" (default) \| "marker" | "tools" | — | このレーンが使用するACPインジェクションサーフェス。 | +| `protocol` | "anthropic" \| "openai" \| "responses" \| "google" | inferred from the URL marker | — | このレーンのワイヤプロトコルを宣言する; クライアント側の /bili// URLマーカーは宣言よりも優先される。 | +| `compress` | object (level 2) | unset | — | 任意の compress フィールドをここで上書きできます — global→provider→model マージのレベル 2 です。 | +| `compat` | { roles?, dropFields? } | {} | — | ルート単位のワイヤー互換性上書き;provider エントリはキーごとに global ブロックを優先します;dropFields は加算的に union されます。 | +| `direct` | boolean | false | — | クライアント側の除外:このアップストリームへのトラフィックは決して bili に指向されません。 | +| `passthrough` | boolean | false | — | セッション状態なしのルートスコープのバイト単位リレー — 不正防止アップストリーム向け。 | +| `imageBilling` | "auto" \| "pixels" \| "bytes" | auto (→ pixels) | — | このルートのイメージトークンカウント基準;bytes はバイトリレーに対する明示的なオプトインです。 | +| `imageTokenCap` | number | unset (uncapped) | — | このルートのイメージごとのトークンコスト上限。 | +| `resign` | scheme → { enabled?, passthrough?, credentialRef? } | {} (global map applies) | — | グローバル resign マップのルート単位のオーバーライド(レベル 2、最も深いものが優先)。 | +| `bind` | string (named entries only) | unset | — | 名前付き(非 URL)エントリをバインドされた URL レーンにエイリアスとしてディープマージ;bind なしでは名前付きエントリはルーティング無効のままです。 | +| `apiKeyEnv` | string (env var name) | unset | — | レーン認証情報オーバーライド (#2336):このレーンにおいて、クライアントの認証情報をこの環境変数の値に置き換えます。apiKeyEnv/credentialRef のいずれか一方のみ;[Lane credentials](#lane-credentials-apikeyenv--credentialref) を参照。 | +| `credentialRef` | string (store name) | unset | — | プライベートなサマリー認証情報ストア経由のレーン認証情報オーバーライド(secret:NAME セマンティクス)。 | +| `calibration` | { disabled?: boolean, max?: number } | unset (learned k̂ applies) | — | ルート単位の k̂ 較正ポリシー (#3211):使用量レポートが膨張するルートに対するオプトアウトまたはクランプ;[Route-level k̂ calibration policy](#route-level-k-calibration-policy) を参照。 | +| `compactionOptIn` | boolean | false | BILI_NON_HTTP_PROVIDERS | 名前付きエントリのみ:非 http(s)-baseUrl のプロバイダーを compaction 所有権にオプトイン(pi/omp レーン);環境変数 BILI_NON_HTTP_PROVIDERS と union します。 | + +**環境変数のみ(設定ファイルキーなし)** + +| キー | 型 | デフォルト | 環境変数 | 説明 | +|-----|------|---------|-----|-------------| +| `BILI_DSH_AUTHORED_COMPACTION` | boolean | true (on, #3901 flip) | — | bili が dsh のコンパクト化要約呼び出しを拒否する (#3733) 代わりに、折り畳みスナップショットでローカルに ANSWER する: アイデンティティヘッダー + カーネルレンダリングされたブロック要約、ゼロエグレス; リプレイは #2432 リベースによって認識される。 | +| `BILI_DSH_CONTEXT_TAB` | boolean | true | — | dsh.contextTab (#4237) の環境変数ティア: 0/false で DSH トップバーの「上下文」/「Context」タブを削除 (その他はすべて動作維持); その他の値はファイルティアを上書きして強制オン; 未設定 = ファイルティアが適用 (デフォルト true)。次のページ読み込み / dsh 再起動時に有効化。 | +| `BILI_DSH_MAX_TESTED_VERSION` | string | 0.2.0-rc.2 (CI e2e anchor) | — | dsh ネイティブレーンのブートノート (#4545) 背後にある最新テスト済み @deepseek-ai/dsh ビルド: 実行中のクライアントビルドは、注入バンドルより上位の最も近い node_modules/@deepseek-ai/dsh/package.json から解決される; この上限より厳密に新しい場合、サポートが実装されるまでロールバックを推奨するブート時のノート (永続ログ記録 + バナー) が 1 回発行される。片方向のみ — 上限以下または等しいビルドは沈黙する (既知の旧ビルド破損モードには独自のオーバーレイラッチ検出器がある)。警告のみ — トラフィックをゲートまたはブロックしない。ビルドが検証されるにつれて上限を引き上げる; 空文字列はこのレーンでのチェックをオフにする。解決不能/解析不能なバージョンは沈黙に向けてオープンに失敗する。 | +| `BILI_IDENTITY_HARVEST` | string | off | — | 安定したメッセージ ID レーン (#5825) 向けクライアントローカルトランスクリプト/sqlite のロールアウトゲート付きループバックハーベスト。未設定/空 = OFF (完全に不活性)。`all` またはソース ID のカンマ区切りリスト (`claude,codebuddy,mcode`) は、アイデンティティがループバックであるリクエストの一致するソースを有効化する; すべての一致には `pluginLaneServerHistory` ロールアウトが ON であることも必要。判定不能なものは、ターン全体で配線前のパスにデグレード — 部分的なマッピングは決して行われない。設計上の開発/検証スイッチ (レーンはすでにクライアントごとに安全であるため)、調整ノブではない。 | +| `BILI_STORAGE_BACKEND` | sqlite\|mysql | sqlite | — | storage.backend (#3931) の環境変数ティア: sqlite (デフォルト) または mysql (完全配線済み, #3388 ステップ 2+3 - 非同期シャドウキュー経由でインジェストを保存、同期読み取りは JSON エンベロープに乗る、レプリカ/拡張/GC/フォークは非同期ツイン経由 (#4911); エクスポートも)。ファイルティアに優先する。 | +| `BILI_MYSQL_DSN` | string | unset | — | storage.backend="mysql" (#3388, #3931) 用の MySQL DSN (mysql://user:pass@host:3306/db)。ファイルキー storage.mysql.dsn に優先する。空 = mysql バックエンドが開けない; 文書化されたエラーは両方のノブを名指しする。プールは遅延で開かれる; closeQuietlyAsync はインジェストキューをドレインして閉じる。 | +| `BILI_STORAGE_ARCHIVE_AFTER_DAYS` | integer | 365 | — | GC 年齢スウィープウィンドウ (日) (#3463): これより長くアイドル状態のセッションはアーカイブされる (単一のアーカイブログ (archive/archive.jsonl) に 1 行の JSON が追記 + トombstone 行 + コンテンツ/メディア参照の解放)。0 で年齢スウィープを無効化; 手動エントリ POST /__bili/storage/gc は常に実行される。設定ファイルキー storage.archiveAfterDays が永続形式である。 | +| `BILI_STORAGE_QUICK_CHECK` | string | on | — | オープン時のストレージ整合性セルフチェック (#4175): すべての index.db オープン時にマイグレーション前に PRAGMA quick_check を実行; このブートのスキャンによって破損が証明された場合、何も自動的に移動、コピー、再構築されない (自動回復は #4609/#4626 時代に撤回: BILI_STORAGE_JSON_WRITER=off ではインデックスが唯一の永続コピーであり、自動的な移動または再構築では完全なデータ回復を保証できないため) かつ bili はそれでも起動する — JSON エンベロープからサーブし、手動修正 (バックアップしてから index.db/-wal/-shm を手動で退避し、再起動 — 新しいインデックスは JSON エンベロープから再構築される) を名指しする大きくて実行可能なアラームを発する。成功した PASS はキャッシュされ、後の起動で再スキャンをスキップする; FAIL 判定は決して永続化されない (2026-10-30 オーナーポリシー): ランタイム/バックグラウンドの発見はアラームのみ (大きなログ + ランタイムステータス、プロセスはサーブを継続 — JSON エンベロープは回復ソースのまま) であり、すべてのブートは現在のファイルセットの新しいスキャンから再決定するため、古いバージョンが残した古い FAIL が将来のブートをブロックすることは決してない。自動リネーム/修復もレガシー専用フォールバックもない: レガシー専用で続行すると、JSON エンベロープが死んだインデックスから永遠に分岐する (決して調整不能)。一時的なオープン失敗 (SQLite エンジンなし / CANTOPEN / 読み取り専用 / バックエンド DSN) は、実行可能なエラーで bili が大きく起動を拒否する — 環境問題に対するサイレントレガシーフォールバックもない (2026-10-30 オーナーポリシー; ライブな第二ライターがこの拒否リストを 2026-10-31 に残した — 1 つのローカルディスク index.db を共有することはサポートされるトポロジーであり、情報提供のみ、決してブロックしない); 真に JSON のみでサーブしたいデプロイは明示的に設定する (BILI_STORAGE_UNIFIED=legacy または未設定)。チェックのコストが重要なブート時感度の高い巨大デプロイでのみ 0 を設定する。 | +| `BILI_SNAPSHOT_SHADOW` | boolean | true (on) | — | スナップショットレンダリングのシャドウ観測可能性(#3756 のフォローアップ): アームされたターンごとに送信スナップショットビューを計算するが使用せず、レガシー送信との差分を分類し、セッションごとのカウンターを Web パネルおよびスナップショットシャドウ診断トピックに表示する。0/false/off で無効化、1/true/on で有効化、それ以外の場合は設定ファイルの snapshot.shadow ブール値が適用される(デフォルトは on)。レンダリングレーン自体はロールアウトゲート(BILI_ROLLOUT_SNAPSHOT_RENDER)で制御されるため、シャドウレーンは送信バイト列を変更しない - これは後日のロールアウトを切り替えるためのドライラン証拠である。 | +| `BILI_CONFIG_FILE` | string | unset (XDG config path) | — | 設定ファイルのパスを上書きする(パスの再配置)。 | +| `BILI_SESSIONS_DIR` | string | unset (XDG state path) | — | セッションレコードの保存先(パスの再配置)。 | +| `BILI_ENCRYPTION_KEY` | string | unset | — | 暗号化された永続化ペイロード用の鍵材料(シークレット)。 | +| `BILI_TUNNEL_ALLOWED_HOSTS` | string[] (csv) | unset | — | MITM トンネルレーン用のホスト許可リスト。 | +| `BILI_RECLAIM_FETCH_PATCH` | boolean-ish | on | — | シャットダウン時にグローバル fetch パッチを回収するためのトグル。 | +| `BILI_CONFLICT_SCAN` | boolean-ish | off | — | インストールレーンの競合スキャナープローブを有効にする。 | +| `BILI_CHAIN_MAX_FUTURE_SKEW_MS` | number | (built-in) | — | 未来にずれたチェーンチェックポイントタイムスタンプの許容範囲。 | +| `BILI_CHAIN_RECENT_WINDOW_MS` | number | (built-in) | — | チェーンチェックポイント検証用の最近ウィンドウサイズ。 | +| `BILI_ZONE_PORT` | number | 18787 base (derived per lane) | — | レーン生成プロキシゾーン用のベースポート(ポートの再配置)。 | +| `BILI_ZCODE_ROUTE` | string | unset | — | zcode レーン用のルート選択。 | +| `BILI_ZCODE_PORT` | number | unset | — | zcode レーン用のポート固定。 | +| `BILI_ZCODE_SIGNING_FIXED` | boolean-ish | off | — | zcode 認証情報レーン用の固定署名モード。 | +| `BILI_CLAUDE_UPSTREAM` | string | unset | — | claude レーン用のアップストリーム固定。 | +| `BILI_CODEX_STATE_MODE` | string | auto | — | codex 状態の処理: auto(モダン codex では CODEX_SQLITE_HOME 経由の共有 DB、それ以外はレガシーオーバーレイコピー)、shared、または legacy。shared モードでは最大 16 個の並行セッションを処理し、それぞれに 1 つのセッション別オーバーレイスロットを使用する。legacy は同時に 1 つの排他オーバーレイを保持する。 | +| `BILI_ATTACH_HEALTH_DEADLINE_MS` | number | (built-in) | — | 外部デーモンに参加する際のヘルスチェック接続の期限。 | +| `BILI_SPAWN_WAIT_MS` | number | (built-in) | — | 新規に生成されたプロキシ子プロセスについて、ランチャーが待機を延長するまでの初期ヘルスウェイトウィンドウ(ms)。 | +| `BILI_SLOW_START_GRACE_MS` | number | (built-in) | — | まだ生存しているがバインドが遅い子プロセス(低速ストレージ、AVスキャン、共有ストレージのロック競合など)に対する追加の猶予時間(ms)。生成の総予算はこれら2つの合計である。 | +| `BILI_ATTACH_EVIDENCE_GRACE_MS` | number | (built-in) | — | アタッチ所有権の証拠に対する猶予期間。 | +| `BILI_SILENT_DIRECT_MAX_MB` | number | (built-in) | — | サイレントダイレクトの過大ガード上限(MiB)。 | +| `BILI_PROVIDER_REWRITES` | string | unset | — | ルーティング前に適用されるプロバイダーURL書き換えルール。 | +| `BILI_MCP_PROXY` | string | unset | — | 生成チャネル:プラグインホスト型ツールのMCPプロキシターゲット。 | +| `BILI_PARENT_PID` | number | unset | — | 生成チャネル:ライフサイクル監視用の親プロセスID。 | +| `BILI_STRICT_PORT` | number | unset | — | 生成チャネル:正確なポート要件(スキャッターはホッピングせず、明確に拒否される)。 | +| `BILI_UPGRADE_REPLACEMENT` | boolean-ish | unset | — | 生成チャネル:自己再起動による置換をマークする — 解放されたポートを正確に所有するか、ホッピングせずに終了しなければならない(#3044)。 | +| `BILI_OPENCODE_ACP_SPEC` | string | unset | — | 生成チャネル:opencodeネイティブレーン用のACP仕様マーカー。 | +| `BILI_LAUNCHER_MODEL_WINDOWS` | string | unset | — | ランチャーチャネル:生成されたクライアントに渡されるモデルウィンドウのオーバーライド。 | +| `BILI_LAUNCHER_LANE` | string | unset | — | ランチャーチャネル:生成元のbiliプロセスのレーンID。 | +| `BILI_LAUNCHER_PLUGIN` | string | unset | — | ランチャーチャネル:プラグインモードのハンドオフマーカー。 | +| `BILI_LAUNCHER_DIRECT` | boolean-ish | off | — | ランチャーチャネル:この起動において注入されたプロキシをバイパスする。 | +| `BILI_INHERITED_HTTP_PROXY` | string | unset | — | Launcher channel: spawn 境界をまたいで継承された http_proxy の値が保持されます。 | +| `BILI_INHERITED_HTTPS_PROXY` | string | unset | — | Launcher channel: spawn 境界をまたいで継承された https_proxy の値が保持されます。 | +| `BILI_INHERITED_ALL_PROXY` | string | unset | — | Launcher channel: spawn 境界をまたいで継承された all_proxy の値が保持されます。 | +| `BILI_INHERITED_NO_PROXY` | string | unset | — | Launcher channel: spawn 境界をまたいで継承された no_proxy の値が保持されます。 | +| `BILI_NATIVE_CLAUDE` | boolean-ish | off | — | Host posture: claude ネイティブプラグインプロセスであることを示します。 | +| `BILI_NATIVE_DSH` | boolean-ish | off | — | Host posture: dsh ネイティブプラグインプロセスであることを示します。 | +| `BILI_NATIVE_KIMI` | boolean-ish | off | — | Host posture: kimi ネイティブプラグインプロセスであることを示します。 | +| `BILI_NATIVE_OMP` | boolean-ish | off | — | Host posture: omp ネイティブプラグインプロセスであることを示します。 | +| `BILI_NATIVE_OPENCODE` | boolean-ish | off | — | Host posture: opencode ネイティブプラグインプロセスであることを示します。 | +| `BILI_NATIVE_PI` | boolean-ish | off | — | Host posture: pi ネイティブプラグインプロセスであることを示します。 | +| `BILI_PI_INLINE` | boolean-ish | inline when unset (DEFAULT-ON since #5428; explicit 0/false/no/off opts out) | — | Host posture: pi インラインレーン (#3278) — pi 拡張機能は、独自のプロキシを spawn するのではなく、擬似オリジン経由でプロセス内で圧縮を行います。プリセットの BILLION_CONTEXT_PROXY アタッチターゲットよりも優先されます。#5428 以降、デフォルトで有効 (#4687 のオプトインルールを置き換え): 環境変数とファイルが未設定の場合はインラインで実行されます。アタッチターゲットが明示されている場合でも DEFAULT より優先されるため、`bili pi` はランチャープロキシを維持します。明示的なオプトアウト = 0/false/no/off (または `"pi": {"inline": false}`) — 従来のアタッチ/spawn ポスチャを復元します。人間向けインターフェース: `bili -i/--inline pi` でインラインを強制、`bili -s/--server pi` でプロキシポスチャを固定 (継承されたインライン環境変数よりも優先)。Truthy = 0/false/no/off 以外の空でない任意の値 (on/yes/TRUE はすべて有効化)。Codex Responses WS トラフィックは、エンジンと共に起動されるループバック専用ブリッジ経由でルーティングされます。このブリッジが失敗した場合、WS レーンは DIRECT にデグレードし (警告が表示されます)、HTTP 圧縮はプロセス内で維持されます。 | +| `BILI_OPENCODE_INLINE` | boolean-ish | off (opt-in) | — | Host posture: opencode インラインレーン (#3278 ポート) — opencode プラグインは、独自のプロキシを spawn するのではなく、擬似オリジン経由でプロセス内で圧縮を行います。プリセットの BILLION_CONTEXT_PROXY アタッチターゲットよりも優先されます。オプトイン: opencode レーンは、この環境変数または "opencode": {"inline": true} が明示的に有効化されない限り、レガシーのデフォルト (spawn されたプロキシ) を維持します (#4687 におけるオーナーの決定)。Truthy = 0/false/no/off 以外の空でない任意の値 (on/yes/TRUE はすべて有効化)。Bun ホスト上で検証済み (エンジンは node:sqlite なしで起動およびディスパッチ可能)。 | +| `BILI_INLINE_DEBUG` | boolean-ish | off | — | インラインレーン (#3278) のみ: ミュート後もエンジンのログ行を stderr に保持します (インラインエンジンは pi プロセス内で実行され、stderr は対話型 TUI です。すべての [persist]/[storage]/[inline] 行が入力ボックスをスクロールさせてしまうため、デフォルトでは bili.log にのみ保持されます)。 | +| `BILI_NATIVE_ZCODE` | boolean-ish | off | — | Host posture: zcode ネイティブプラグインプロセスであることを示します。 | +| `BILI_PI_BIN` | string | pi (PATH lookup) | — | Host posture: pi クライアントバイナリの明示的なバイナリパス。 | +| `BILI_DSH_BIN` | string | dsh (PATH lookup) | — | ホストの姿勢: dsh クライアントバイナリの明示的なバイナリパス。 | +| `BILI_MODEL_INFO_RETRY_MS` | number | (built-in) | — | テストフック: モデル情報の参照におけるリトライ間隔。 | +| `BILI_DSH_RETRY_INTERVAL_MS` | number | (built-in) | — | テストフック: dsh レーン操作におけるリトライ間隔。 | +| `BILI_DSH_RECOVERY_INTERVAL_MS` | number | (built-in) | — | テストフック: dsh レーンのリカバリスウィープ間隔。 | +| `ACP_DUMP_DIR` | string | unset | — | ワイヤダンプ出力のベースディレクトリのオーバーライド(パスの再配置)。 | +| `BILI_STREAM_STALL_MS` | number | (built-in) | — | コミット済みアップストリームストリームのストール検出タイムアウト(中断前の無バイト沈黙)。 | +| `BILI_CLIENT_BIN` | string | unset (PATH lookup) | — | 起動するクライアントの明示的なバイナリオーバーライド(PATH で解決)。 | +| `BILI_CONVERSATION_ID` | string | unset (per-spawn UUID written by bili) | — | セッション ID を渡さないホストを持つ MCP 子プロセスに渡す、スポン時に生成される会話 UUID(ヘッドレス自己登録)。 | +| `BILI_LAUNCHER_MODEL_MAX_OUTPUTS` | string (JSON id→maxOutput map) | unset | — | ランチャーチャネル: 出力ヘッドルームの予約のためにスポンされたプロキシに渡す、モデルごとの最大出力マップ。 | +| `BILI_LAUNCH_TOKEN` | string | unset (generated per launch) | — | ランチャーとそのスポンされたプロキシ間のレーン内部エンドポイントを認証するランチャートークン(シークレット)。 | +| `BILI_MCP_DEFAULT_ORIGIN` | string | http://127.0.0.1:8787 | — | MCP エントリポイント用のフォールバックプロキシオリジン候補。 | +| `BILI_MCP_NO_ORPHAN_ADOPT` | boolean-ish | off (=1 disables orphan adoption) | — | 複数のホストセッションが 1 つのプロキシを共有する場合、再開セッションの孤児採用を無効にする。 | +| `BILI_MITM_HOSTS` | string[] (csv) | unset | — | ランチャーチャネル: スポンされたプロキシに渡す MITM ホワイトリストホスト(設定ファイルの双子 BILI_MITM_DOMAINS とは別物)。 | +| `BILI_PLUGIN_AGENT` | boolean-ish | off | — | スポンチャネル: プラグインエージェントプロセスを示す。 | +| `BILI_IMAGE_RESCALE_MAX_DIM` | integer | 1600 | — | エグレス画像のダウンスケールパスのトリガー閾値(px)(#3400); 数値でない場合または 128 未満の場合は無視される(デフォルトが適用される)。設計上、環境変数のみ。 | + + + +--- + +## サーバー設定 + +プロキシのリスニング方法とグローバルな動作を制御するトップレベルのキー。 + +### `port` + +- **型:** `number` +- **デフォルト:** `8787` +- **ステータス:** ACTIVE +- **説明:** プロキシがリスニングする TCP ポート。1 から 65535 までの整数でなければなりません。`ACP_PORT`(または `PORT`)環境変数、または `--port` CLI フラグによって上書きされます。無効な値は起動を中断します。これは**ユーザーゾーン**(`bili start`、デフォルト `8787`)であり、このポートはユーザーが管理します。レーン生成プロキシ(ネイティブフック、ランチャーレーン)は、別の自己管理ゾーン(`BILI_ZONE_PORT`、デフォルト `18787`)に存在し、このポートには決してアクセスしません(#1660)。 + +### `host` + +- **型:** `string` +- **デフォルト:** `127.0.0.1` +- **ステータス:** ACTIVE +- **説明:** プロキシがバインドするネットワークインターフェース。`127.0.0.1`(デフォルト)はローカルホストでのみリスニングします — ローカルサイドカーには安全です。IPv4 + IPv6 デュアルスタックには `::` を使用します。プロキシを他のマシンに公開するには `0.0.0.0`(または LAN IP)を使用します — 通常はコンテナ内や信頼できる LAN 内で使用します: リモートエージェントはモデルの `baseURL` を `http://:/bili/…` に設定し、MITM モードの `CONNECT` はホワイトリストに登録されたモデルホストのリモートクライアントのみを受け入れます(ブラインドトンネルはループバックのみに制限され、`/__bili/` 管理エンドポイントは以下の埋め込みホストリレーが有効化されない限りループバックのみに制限されます)。認証はありません — 周囲のネットワークが信頼できることを確認してください。`ACP_HOST` / `--host` によって上書きされます。 + +### `upstream` + +- **型:** `string` (ベース URL) +- **デフォルト:** `https://api.anthropic.com` +- **ステータス:** ACTIVE +- **説明:** パスのみのモデルリクエスト用のフォールバックベース URL: ホストなしで `/v1/messages` に POST するクライアントは `${upstream}/v1/messages` に転送されます。末尾のスラッシュは削除されます。`ACP_UPSTREAM` によって上書きされます。また、`GET /__bili/health` でも `upstream` として報告されます。 + +### `sessionHeader` + +- **型:** `string` +- **デフォルト:** `x-acp-session` +- **ステータス:** ACTIVE +- **説明:** クライアントが会話の識別に送信できる HTTP リクエストヘッダーの名前。同じ値を持つリクエストは、呼び出し間で圧縮状態を共有します。`ACP_SESSION_HEADER` によって上書きされます。 + +### `log` + +- **型:** `boolean` +- **デフォルト:** `true` +- **ステータス:** ACTIVE +- **説明:** リクエストごとのログ出力を有効にします。`false`(または `ACP_LOG=0`)に設定すると、標準のリクエストログを無音にします。 + +### `logFile` + +- **型:** `string` +- **デフォルト:** XDG ステートパス (`~/.local/state/billion-context/bili.log`) +- **ステータス:** ACTIVE +- **説明:** プロキシのティールログ(ファイル + stderr)の場所。`"off"` に設定すると、ファイルログ出力を完全に無効にします(stderr のみ)。10 MB で `bili.log.old` に自動ローテーションします。設定されている場合、`ACP_LOG_FILE` によって上書きされます(空の値はオフではなくデフォルトパスに解決されます)。 + +**ログの場所とクリーンアップ。** ログファイルは 2 つあります: + +1. `~/.local/state/billion-context/bili.log` — 共有インスタンスログ(このマシン上のすべてのプロキシがここに追記します; 各行に `[v=]` と `[sess=]` タグが付与されます)。10 MB でローテーションし、`.old` 世代を 1 つ保持します。 +2. `%TEMP%/bili-proxy-.log` (`os.tmpdir()/bili-proxy-.log`) — ランチャー生成プロキシ(`bili dsh`、pi/claude/codex オーバーレイなど)のみに作成されます。これらのプロキシは、起動プロセスによって stdout/stderr がこのファイルにリダイレクトされて実行されます。#2864 以降、生成された子プロセスは上記のファイルレグがライブになると stderr レグをミュートするため、このファイルにはロガー前のクラッシュ出力のみが含まれます(通常はほぼ 0 バイトです)。オープン時に上限が設定され、5 MB に達すると、次の生成時に `.old` にローテーション(1 世代保持)されてから再オープンされます。それ以外は OS の一時ディレクトリのクリーンアップポリシーが適用されます — スクラッチスペースとして扱い、古いファイルを自由に削除してください; 永続的な記録(それは `bili.log` です)を保持することはありません。 + +### `debug` + +- **型:** `boolean` +- **デフォルト:** `false` +- **ステータス:** ACTIVE +- **説明:** 詳細なログ出力 — `ACP_DEBUG=1` を設定するのと同じです。ルーティングや圧縮動作の診断に有用です。 + +### `passthrough` + +- **型:** `boolean` +- **デフォルト:** `false` +- **ステータス:** ACTIVE +- **説明:** すべてのリクエストを、圧縮、ツール注入、ナッジング**なし**でアップストリームに転送します。`ACP_PASSTHROUGH=1` と同等です。非圧縮ベースラインとの A/B 比較に便利です。 + +### `compactionOptIn` + +- **型:** `boolean` +- **デフォルト:** `false` +- **ステータス:** ACTIVE +- **説明:** `#1392` — **非 http(s) baseUrl プロバイダー**(例: pi-claude-bridge のリテラル `"claude-bridge"`)を、bili のコンパクション所有権の考慮対象にオプトインします。エントリの KEY はプロバイダー ID です — 非 URL のキーはそれ自体ではルーティングに対して不活性です(実際のレーンにするには [`bind`](#named-provider-entries-bind) を与えてください)、そして pi/omp プラグインが非 http baseUrl を即座に拒否しようとする際に参照する、ランチャーがエクスポートする `BILI_NON_HTTP_PROVIDERS` ホワイトリストにのみ供給されます(#1383)。オプトインは候補セットを広げるだけです: コンパクションは、積極的な搬送証拠(プラグインがセッションにスタンプを押した、または `/__bili/plugin/status` がプロキシがそれを保持していることを確認した)がある場合のみキャンセルされます。環境変数同等: `BILI_NON_HTTP_PROVIDERS=a,b`(ファイルとの和集合、重複排除)。`bili pi` / `bili omp` ランチャー、または直接インストールされたプラグインの下でのみ意味があります。 + + ```jsonc + { + "providers": { + "claude-bridge": { "compactionOptIn": true } + } + } + ``` +### `compat` + +- **Type:** `{ roles?: Record; dropFields?: string[]; streamErrorShape?: "protocol" | "completion"; noCacheControl?: boolean; keepResponseId?: boolean }` +- **Default:** `{}` (無効) +- **Status:** ACTIVE +- **Description:** グローバルなワイヤー互換ロールマップ。`roles` はメッセージのロールを、アップストリームが受け入れるロール名にマッピングします。例: `{"compat":{"roles":{"developer":"system"}}}` は、`developer` ロールを拒否するアップストリーム(#552、新しい codex クライアント)に対して、最終転送ボディ内で `developer` → `system` に書き換えます。`openai` の chat-completions と `responses` リクエストに適用されます。完全一致するロールのみ対象であり、ボディ内の他の部分は変更されません。再送信される compress-retry ボディにも同じ書き換えが適用されます。プロバイダーごとの `compat.roles` エントリ([Providers](#providers) 参照)はキーごとに優先されます。デフォルトの `{}` では、ボディはバイト単位で変更なしに転送されます。 +- **Learn-on-failure:** compat が設定されていない場合、アップストリームからの `400 Invalid role: …` は自動修正されます — bili は問題のあるロールを `system` に書き換え、1回リトライし、そのマッピングを**セッションスコープ**(セッション内のメモリ上;設定ファイルには書き込まれない)で記憶します。そのセッション内の後続のリクエストでは、400 の往復がスキップされます。修正が発火した際に出力される情報ログには、恒久的なプロバイダーごとのスニペットが含まれます。 +- **dropFields:** 最終転送ボディから削除するフィールドのドットパスリスト — クライアントが常に送信するがアップストリームが受け付けないフィールドを拒否する厳格スキーマのアップストリーム向け(#1757)。パスはプレーンオブジェクトのセグメントのみ使用可能(`reasoning.summary`);ワイルドカードと配列インデックスはサポートされていません;存在しないパスや非オブジェクトの中間要素はサイレントにスキップされます;文字列値は決して検査・変更されません — 構造キーのみ対象であり、ツール引数やメッセージコンテンツはバイト単位で正確に保たれます。`roles` と異なり、すべてのワイヤープロトコル(任意の JSON リクエストボディ)に適用されます。グローバルとプロバイダーごとのリストは**加算的に**(和集合)マージされます — プロバイダーエントリはパスを追加できますが、グローバルのものを撤回することはできません。最終送信ボディのロールマッピング / 出力ステアリングの後(プロンプトキャッシュスタンプの前)に適用され、compress-retry ループが再送信するすべてのボディおよび逐語パススルー転送にも適用されます。一致するフィールドのないボディはバイト単位で変更なしに転送されます;1つ以上のフィールドが実際に削除された場合、削除されたパスを記録する情報行がログ出力されます。オプトインのみ — v1 では learn-on-failure はありません: `"compat":{"dropFields":["reasoning.summary"]}`。 +- **streamErrorShape:** アップストリームストリーム失敗が、200 レスポンスがすでにコミットされた後に anthropic/openai ワイヤー上でどのように提示されるか(`"protocol"`(デフォルト)または `"completion"`)。`protocol` はプロトコルネイティブの失敗チャネルに乗ります — anthropic/responses は `event: error` フレームを受け取り、openai はトップレベルの `error` フレームに続けて `[DONE]` を受け取ります — これによりクライアントは「このターンが失敗した」と「このターンが完了した」を区別し、独自のリトライロジックを維持できます(#1455: 従来の合成された `end_turn`/`finish_reason` は、死んだターンを通常の完了として装い、クライアントのリトライ予算をサイレントに消費していました)。`completion` は、インバンドエラーイベントを表面化できない SDK を持つホストのために、そのレガシー形状(合成された正常な完了内の失敗テキスト)を復元します。設定ファイル: `"compat":{"streamErrorShape":"completion"}`;環境変数 `BILI_STREAM_ERROR_SHAPE` が優先されます。google ワイヤーのみ影響を受けません(すでにネイティブエラーフレームを使用);responses ワイヤーでは、このノブはサーバーサイドの終了を合成されたアイテムライフサイクル完了から `event: error` フレームに変更します(ループ内での終了はすでに `response.failed` 経由でネイティブでした)。 +- **noCacheControl:** (`#2030`) `true` にすると、bili の Anthropic レーンでの `cache_control` ブレークポイントスタンプが無効になります — フィールドを拒否するアップストリームや、独自のブレークポイントポリシーを持つリレーのためのエスケープハッチです。環境変数 `BILI_NO_CACHE_CONTROL` が優先されます;完全なメカニクスはその[環境変数エントリ](#environment-variables)を参照してください。 +- **keepResponseId:** (`#2030`) `true` にすると、カーネル再構築された Responses リクエストで `previous_response_id` を保持し、ストリップしません(デフォルトではストリップするため、再構築されたボディは、書き換えられた入力に対してアップストリームが発行しなかったレスポンス ID を参照することはありません)。環境変数 `ACP_KEEP_RESPONSE_ID=1` が優先されます。 + +### `proxy` + +- **Type:** `string` +- **Default:** *(なし — アップストリームプロキシなし)* +- **Status:** ACTIVE +- **Description:** モデルプロバイダーへのプロキシ**自身**のアウトバウンド接続に使用されるアップストリーム HTTP プロキシ(`http://host:port`)— HTTP プロキシ経由でのみプロバイダーに到達できるホスト向け(例: GFW の背後にある `api.openai.com`;bili をローカルの v2rayA/clash HTTP ポートに向ける)。 + + **解決順序(最初の一致が優先):** URL ごとの `providers..proxy` → `BILI_UPSTREAM_PROXY` 環境変数 → Web UI の手動プロキシ → このトップレベルの `proxy` → `HTTPS_PROXY` / `HTTP_PROXY` / `ALL_PROXY` 環境変数 → Windows システムプロキシ → 直接接続。自動モードは、環境/システムフォールバックに対して `NO_PROXY` と Windows プロキシバイパスリストを尊重します。bili 自身のローカルポートを指す値は、ループを防ぐために無視または拒否されます。Windows では、一般的な Clash/Mihomo の静的システムプロキシが自動的に検出されます;Web UI は有効なソースと、インターネット設定で検出された PAC URL を表示します。 + + 空文字列は「明示的に直接接続」を意味します — チェーン内の下位のものをオーバーライドして無効にします(トップレベル: すべてのプロバイダーに対して環境/システムプロキシフォールバックを無効化;プロバイダーごと: そのプロバイダーのみ)。 + + 両方のアウトバウンドパスがカバーされます: `/bili/` パスモード(fetch)および MITM CONNECT トンネル(プロキシから実際のアップストリームへの接続は HTTP CONNECT プロキシを経由します)。自動更新プログラムの自身のエグレス(npm レジストリチェック + ターボールダウンロード)は、そのホストに対して同じ判断を使用するため、npm がプロキシ経由でのみ到達可能な場所で `bili update` と自動更新が機能します(#609)。 + + SOCKS5 はサポートされていません: `socks5`/`socks5h` スキームを持つ明示的な `BILI_UPSTREAM_PROXY` / 設定 `proxy` は、実行可能なエラーとともに起動に失敗しますが、そのようなスキームを使用する環境/システムプロキシは、1回限りのログ警告とともに無視されます(トラフィックは直接接続にフォールスルーします)。Clash/mihomo の場合、`http://` 経由で同じ混合ポートを使用してください(例: `http://127.0.0.1:7890`)。 + + ```jsonc + { + // Global default: ALL providers route through this proxy + "proxy": "http://127.0.0.1:20172", + "providers": { + "https://api.openai.com/v1": { + // Per-URL overrides global (use a different proxy for this host) + "proxy": "http://127.0.0.1:20173" + }, + "https://open.bigmodel.cn/api/anthropic": { + // Empty string = explicitly DIRECT, overriding the global proxy + "proxy": "" + } + } + } + ``` + +### `upstreamProxy` + +- **Type:** `string` (プロキシ URL) +- **Default:** *(なし)* +- **Status:** ACTIVE +- **Description:** Web UI の手動プロキシコントロールの設定ファイル上のキャリア — UI はこのキーを書き込みます(再起動後も残ります;`BILI_UPSTREAM_PROXY` はラダー上でその上位の環境層です)。明示的な `upstreamProxyMode` なしで設定された場合、有効なモードは `"manual"` となり、この値が使用されます。[`proxy`](#proxy) の解決順序において、`BILI_UPSTREAM_PROXY` とトップレベルの `proxy` の間に位置します。空文字列は未設定として扱われます。 + +### `upstreamProxyMode` + +- **Type:** `"auto" | "manual" | "direct"` (それ以外は `"direct"` として解析) +- **Default:** *(未設定 — `upstreamProxy` が設定されている場合は `"manual"` に解決、それ以外は `"direct"`)* +- **Status:** ACTIVE +- **Description:** プロキシ自身のアウトバウンド接続の選択モード(完全なラダーについては [`proxy`](#proxy) の解決順序を参照): `"manual"` は Web UI の手動プロキシ(`upstreamProxy`)を使用し、空の場合はトップレベルの `proxy` にフォールバックします;`"auto"` と `"direct"` はトップレベルの `proxy` を使用します;明示的に設定された `"direct"` は、補助エグレス(MITM ブラインドトンネル)のプロキシフォールバックからもオプトアウトします。モードに関係なく、`BILI_UPSTREAM_PROXY` は常に明示的なプロキシとして優先されます。`BILI_UPSTREAM_PROXY_MODE` によってオーバーライドされます。 + +### `imageBilling` + +- **Type:** `"auto" | "pixels" | "bytes"` +- **Default:** `"auto"` +- **Status:** ACTIVE +- **Description:** インライン(base64)画像がプリフライトサイズゲートと出力クランプによってどのように課金されるか(#488/#496/#767/#1843)。`"pixels"` は、ボディをデコードせずに画像ヘッダー(PNG/JPEG/WebP/GIF/BMP)を解析し、ピクセルタイル課金を適用します(OpenAI 高詳細モデル: 512px タイル、短辺は 768px までスケーリングアップ、長辺は 2048px でキャップ → 画像ごとに 765–2805 トークン;解析できない形式はフラットな 16384 にフォールバック)。`"bytes"` は、各画像を `base64 長さ / 4` トークンで課金します — 保守的で、バイト課金リレーに対しては正しく、しかし #1843 以降は明示的なオプトインです: 不明なホストでは、従来のデフォルトがこの ±15× の推定値をすべてのウィンドウ決定に混入させ、実際の使用量がウィンドウに収まる画像中心のセッションを永続的にブロックしていました(#1800 インシデント: 6 枚のスクリーンショットが 278,161 と推定され、課金は 18,870)。リモート(`https://`)画像は、どちらのモードでも常にフラットな 4096 で課金されます。`"auto"`(デフォルト)は、すべてのホストに対して `pixels` に解決します。プロバイダーごとの `providers..imageBilling` がこのグローバルより優先され、`BILI_IMAGE_BILLING` 環境変数が両方より優先されます(ライブ読み取り、再起動不要)。 + +### `imageTokenCap` + +- **Type:** 正の整数(画像ごとのトークン) +- **Default:** *(未設定 — キャップなし)* +- **Status:** ACTIVE +- **Description:** プリフライトサイズゲート、出力クランプ、画像圧縮統計で使用される画像ごとのトークン推定値の包括的な上限(#488/#496/#1843)。解決された課金モードの上に適用されます — ルートの実際のエンコーダーがピクセル事前分布よりもはるかに低い課金を行う場合に有用です。優先順位: `BILI_IMAGE_TOKEN_CAP` 環境変数(ライブ読み取り、再起動不要) > プロバイダーごとの `providers..imageTokenCap` > このグローバル。数値でないか正でない値は破棄されます(寛容な解析、`imageBilling` と同じ)。 + +### `imageRescale` + +- **Type:** boolean +- **Default:** `true` +- **Status:** ACTIVE +- **Description:** エグレス画像ダウンスケールパスのマスタースイッチ(#3295 で従来の到着時パスが削除され;#3400 で簡略化された形で再追加)。すべてのアウトバウンドリクエストにおいて、カーネル折りたたみの後、プロトコルエンコードの前に、最長辺が `BILI_IMAGE_RESCALE_MAX_DIM`(デフォルト 1600)を超えるか、base64 ボディが 100 KB を超える画像は、OUTBOUND コピーのみで fit-inside に再エンコードされます(決してアップスケールせず、元の形式を保持)— セッションストレージは元のバイトをバイト単位で正確に保持します。バイトの 20% 未満しか節約できない再エンコードは破棄されます(keep-smaller)ため、小さい/低利益の画像は変更なしに通過します。PNG/JPEG/BMP のみ処理されます(純 JS エンコーダー、ネイティブ依存ゼロ);他の形式は通過します。各縮小画像の隣には、現在サイズと元サイズを報告する安定した注釈が付与されます;bili ツールを登録するレーン(プロキシ注入レーンとプラグインマニフェスト経由のプラグインレーン)では、`acp_read_original_image("")` も名前付けされます。これはローカルセッションストレージから元のバイトを返します — 注入ツールを拒否する codex スタイルのレーンは、サイズのみ注釈を受け取り、ツールは受け取りません。`acp_read_original_image` の結果は構造的に再縮小から免除されます(#3266 の推測-拒否-再送信疾患に対するループガード)。出力は決定論的です: 同じ入力バイトは常に同じ縮小バイトと同じ注釈テキストを生成するため、1つの履歴の繰り返し再送信はバイト安定を維持し、アップストリームプレフィックスキャッシュは乱されません。一意の画像ごとに 1 行のログ(コンテンツハッシュキャッシュ;キャッシュヒットはサイレント)。優先順位: `BILI_IMAGE_RESCALE` 環境変数(`"0"`/`"false"` で無効化;ライブ読み取り、再起動不要) > このキー > デフォルトのオン。 +### `egressTransforms` + +- **Type:** `array` — `{ id?, module, enabled?, priority?, match? }` エントリのリスト (#6003) +- **Default:** 未設定(トランスフォームが登録されておらず、パイプラインは完全な no-op となる) +- **Status:** ACTIVE +- **Description:** ユーザー登録可能な egress リクエストボディ書き換えパイプライン。各エントリは ESM プラグインモジュール(デフォルトエクスポート `{ transform(ctx) }`)を読み込み、その書き換えはすべての送信済みモデルリクエストボディに対して実行される。実行タイミングは、リレーレーン(メイン送信およびすべてのリカバリー再送信)と compress-loop レーンにおいて、すべてのセッション処理(shed / compress-loop 書き換え)の後、トランスポート(re-sign / v1Wrap / fetch)の前である。これにより、re-sign の不変条件が常に保たれる:署名は最終的に送信されるバイト列をカバーする。ファイルのみ(環境変数なし);相対パスの `module` は設定ファイルが存在するディレクトリに対して解決される。 + - **Entry fields:** `id` — ログラベル;モジュール自身の `id` にフォールバックし、次にファイル名にフォールバックする。`module` — 必須;絶対パスまたは設定ディレクトリからの相対パス。`enabled` — デフォルト `true`;`false` の場合、そのエントリはスキップされる。`priority` — 数値、小さいほど先に実行;未設定の場合は設定済みのすべてのエントリより後に実行され、同値の場合は登録順で決まる。`match` — `{ urlPrefix?, provider? }`、AND 条件のスコープフィルタ;未指定の場合はすべてのアップストリーム。モジュールはデフォルトエクスポート上で `id`/`priority`/`match`/`timeoutMs` を宣言することも可能;フィールドごとに設定値が優先される。 + - **Plugin contract:** `transform(ctx)` は非同期;`ctx = { sessionId, upstreamUrl, method, url, headers (mutable copy), body, protocol, model, stage }`、ここで `stage` は `"initial"`(メイン送信)、`"retry"`(リカバリー再送信)、または `"loop"`(compress loop)である。ボディを変更しない場合は `undefined` を返し、または `{ body?, headers?, reason? }` を返す;`body` は `string` または `Buffer` でなければならない。返された `headers` は成功時のみライブヘッダーセットにマージされる;ボディバイト列が変更された場合、古くなった `content-length` は常に破棄される。 + - **Fail-open:** 例外を投げるプラグイン、タイムアウト(モジュールの `timeoutMs`、デフォルト 1000 ms)を超えるプラグイン、または不正なボディタイプを返すプラグインはログに記録されスキップされ、パイプラインは以前のボディで続行される — 1つの不良プラグインがリクエストを壊すことは決してない。読み込めないモジュールや形状が不正なモジュールも同様にスキップされる。 + - **Hot reload:** `POST /__bili/config/reload` はエントリを再読み込みしモジュールキャッシュをリセットするため、追加/削除/順序変更されたエントリや編集されたプラグインコードは、再起動なしに次のリクエストで有効になる。1つのジェネレーション内では、読み込まれたモジュールは固定される(実行中のセッションは実行中にトランスフォーム動作を切り替えない);モジュールは mtime でバスターされるため、編集されたファイルはリロード時に再評価される。 + - **Observability:** 実際に実行された各プラグインは、1行のデバッグログ `[] [egress:] stage= in=B out=B ()` を出力する。 + - **Known boundary:** リカバリー再送信は、すでにトランスフォームされた送信ボディからそのバリアントを導出し、パイプラインを再実行するため、非冪等な文字列トランスフォームが2回適用される可能性がある;JSON ボディを解析する構造的ラダー(image shedding、thinking-strip)は、プラグインがボディを不透明にした場合、適切に劣化し(クラッシュするのではなく中断する)。fake-completion ヒントのリトライは、独自の wrap→re-sign 順序を使用し、意図的にこのパイプラインを介さない。 + + ```jsonc + { + "egressTransforms": [ + { "id": "tunnel", "module": "./plugins/tunnel.mjs", "priority": 10 }, + { "id": "audit", "module": "/abs/path/audit.mjs", "match": { "provider": "https://api.anthropic.com" } } + ] + } + ``` + +### `resign` + +- **Type:** `object` — スキームキー付き:`Record`、ここで各キーはワイヤー上で検出された小文字の署名スキームトークン(組み込み:`"sdk-hmac-sha256"`;カスタム:HMAC `Authorization` トークン(例:`"aws4-hmac-sha256"`)またはボディ署名ヘッダー名(例:`"x-ofm-signature"`)) +- **Default:** 組み込みの `"sdk-hmac-sha256"` キーはそのまま解決される — `enabled: true`、`passthrough: false`、`credentialRef` *(未設定 — アカウントプールの検出)*;ファイルで言及されていないスキームはこれらのデフォルトを維持する — これは組み込みでないスキームの場合、bili がそのスキームの re-signer をリリースするまで(バイナリ契約、#2090)続くローカル 403 拒否を意味する;Description を参照 +- **Status:** ACTIVE +- **Description:** #1884 re-sign アーム(ボディカバー署名;現在は Huawei CodeArts APIG の `SDK-HMAC-SHA256`)の設定ファイルサーフェス。検出は SHAPE ベースであり、名前ホワイトリストではない (#2090):HMAC 構成を名乗る任意の `Authorization` スキームトークン、または `-signature` / `-content-sha256` で終わる任意のリクエストヘッダーは、リクエストをボディ署名付きとしてマークする — すべてのゲートウェイは独自のヘッダーセットを発明する(dsh free-model プラグインは `x-ofm-signature` を同梱する)ため、クローズドルストは新しい形状を漏らし続け、他のプラグインの UI で「無効な認証情報」として表面化するサイレントなアップストリーム 401 を引き起こしていた。次に何が起きるかは、bili がそのスキームを re-sign できるかどうかによって異なる: + - **解決可能な認証情報を持つ組み込みスキーム**(dsh codearts アカウントプール):ゼロ設定の re-sign アーム — dsh では、credentials サービスを通じて `$DSH_HOME/jet-hub/state.json` から有効な `codearts` アカウントを検出し、生成するすべての egress ボディを re-sign するため、署名付きアップストリームでの圧縮がそのまま動作する。組み込みキーのデフォルトはまさにその動作であり、そのためスキームによるキー付けがこのフィールドを Huawei 形状のものにしない理由である。 + - **検出されたその他のすべてのスキーム**(SigV4、ゲートウェイ発明のヘッダー):bili にはどこにも認証情報ソースがなく、re-signer 実装もないため、bili は**それを拒否する — 常に**(オーナーのバイナリ契約裁定、#2090:署名付きリクエストは RE-SIGNED+COMPRESSED されるか REFUSED され、署名なしでパススルーされることはない)。403 はスキームを名乗り、まだ設定ではリンクを動作させることができないことを明確に述べる;各拒否はステートディレクトリ(`~/.local/state/billion-context/`)の `resign-pending.json` に記憶され、bili がそのスキームの re-signer をリリースするまで、すべての後続の起動時に `[resign] … UNRESOLVED` バナーとして再生される(dsh agent レーンはプラグインロード時にも警告する)。これらのスキームに対する `passthrough` 設定は無効(INERT)である — リマインダーはブランチがアンデプロイされた場合(`enabled: false` / `BILI_RESIGN=0`、re-sign 前の書き換え処理を復元し、アップストリームは再び 401 になる可能性が高い)にのみ自動的にクリアされる。v0.1.186 (#2260) 以降、そのようなデッドキーは設定ロード時の `[acp-config]` 警告によって、デッドキーセットごとに一度だけ名指しされるため、403 ボディが唯一のシグナルではなくなった。 + + このブロックは失敗/オーバーライドパス用である — すべてのフィールドについて、環境変数がファイルを優先する: + - `enabled: boolean` — そのスキームのキルスイッチ;`false` はアームをエンドツーエンドでアンロードする(修正前の動作:署名付きボディは通常の書き換えパスを通過し、アップストリームで 401 で失敗する)。環境変数 `BILI_RESIGN=0` が優先される。 + - `passthrough: boolean` — re-sign できない場合の、そのスキームのリクエストの逐語転送。組み込みスキームのみに適用される(その拒否にはユーザー側の修正がある — 認証情報を提供すること — ため、そこでの非圧縮転送へのオプトインは実際の決定である;#1884)。その他のすべてのスキームに対して、このフィールドは無効(INERT)である:#2090 のバイナリ契約裁定により、署名付きリクエストは re-signed+compressed されるか拒否されるため、拒否をパススルーに変える値は存在しない。キーをピン留めすると署名がピン留めされる:1つのスキームを設定しても、別のスキームが開かれることはない。環境変数 `BILI_RESIGN_PASSTHROUGH=1` が優先される(組み込みの効果のみ)。 + - `credentialRef: string` — アカウントプールの検出の代わりに、re-signing に使用される dsh credentials サービスの参照をピン留めする。環境変数 `BILI_CODEARTS_REF` が優先される。 + + 既知スキームレジストリと可観測性:bili は `sdk-hmac-sha256`(組み込み、#1884)、`aws4-hmac-sha256`、`hmac-sha256`、および `x-ofm-signature` (#2090) に対してラベル + 出所を同梱する。登録はコミットメントであり、能力ではない:バイナリ契約の下では、すべての登録済みスキームは最終的に bili で re-signer を得なければならない — それまで、そのスキームは大きく拒否される(Web UI はそれを「re-signer サポート待ち」とマークする);誰もまだ登録していないスキームは、サイレントに書き換えられるのではなく、形状検出によって捕捉され、同様に拒否される。保留中の拒否、スキームごとのライブ状態、未解決セットは、Web UI(`/__bili/` → Configuration → Signed upstreams (resign))で閲覧可能、またはループバック専用の `GET /__bili/resign` から読み取れる。 + + 組み込み(CodeArts)の前提条件と一時的な緩和策:`sdk-hmac-sha256` re-sign アームは、bili 自身の dsh ネイティブレーンによって注入される — それは `$DSH_HOME/jet-hub/state.json`(Windows ではデフォルトで `%USERPROFILE%\.dsh\jet-hub\state.json`)を走査し、`enabled: false` になっていない `provider: "codearts"` を持つアカウントを見つけ、ホストの credentials サービス(ネイティブプラグインに公開されていなければならない)を通じて各アカウントの `credentialRef` を解決し、`{access_key_id, secret_access_key}` を返す最初のものを使用する。それらのいずれかがホストバージョンで欠落している場合(例:credentials サービスをもう注入しない DSH ビルド、または変更されたステートファイルレイアウト)、認証情報自体が有効であっても、すべての署名付きリクエストは `bili_resign_unavailable` で拒否される — それはホスト側のギャップであり、bili の誤設定ではない;正確な最小 DSH バージョンはここでピン留めされるのではなく、ホストとともに追跡される。ホストをアップグレードするまで、`BILI_RESIGN_PASSTHROUGH=1` は codearts リンクをバイト単位で無傷に復元する(組み込みスキームのみ、圧縮なし)。拒否メッセージは、設定ローダーが読むのと同じ関数によって計算された正確な解決済み設定パスを出力するため、エラーに名前が記載されたファイルを編集することは常に正しい。 + + モデルレベルのノブは意図的にここにはフィールドとして存在しない — 以下の3レベルの注記を参照。 + + ```jsonc + { + "resign": { + "sdk-hmac-sha256": { "passthrough": false } + }, + "providers": { + "https://codearts.example.com": { + "resign": { + "sdk-hmac-sha256": { "passthrough": true } + }, + "models": { + "glm-5.3-flash": { "benefit": true }, + "deepseek-v4.1": { "benefit": false } + } + } + } + } + ``` + +- **Strict three levels (route-first):** #1884 のノブはリポジトリの標準カスケードに従う — 環境変数 > レベル 3 (`providers..models..benefit`) > レベル 2 (`providers..resign[""]`) > レベル 1(グローバル `resign[""]`)> 組み込みデフォルト — ルーティング後に解決され、[`imageBilling`](#imagebilling) と同じファミリーである: + + ```jsonc + { + "resign": { + "sdk-hmac-sha256": { "passthrough": false } + }, + "providers": { + "https://codearts.example.com": { + "resign": { + "sdk-hmac-sha256": { "passthrough": true } + }, + "models": { + "glm-5.3-flash": { "benefit": true }, + "deepseek-v4.1": { "benefit": false } + } + } + } + } + ``` + + - `models..benefit: boolean`(レベル 3)— このプロバイダー上のこのモデルが CodeArts の無料クォータに対して課金されるかどうか(その re-signed リクエストは署名付きの `maas_type: benefit` ヘッダーを運ぶ)。`true`/`false` は明示的である — `false` はデフォルトセットのモデルをオプトアウトさせる;未設定の場合は組み込みフォールバック `glm-5.3-flash, deepseek-v4.1-flash`(dsh codearts プラグインの `CODEARTS_BENEFIT_FALLBACK` ミラー)にフォールバックする。環境変数 `BILI_RESIGN_BENEFIT`(カンマ区切り)がツリー全体を優先する。 + - `providers..resign[""]`(レベル 2)— 同じスキームキーの下で、グローバルブロックに対してフィールドごとにオーバーライドする `{ enabled?, passthrough?, credentialRef? }`。 + - ホスト側のインターセプト(dsh ネイティブレーン)はルーティングが存在する前に実行され、常にグローバルブロックを使用する — それはワイヤー上の必要性トリガー(署名付きボディはトンネルするか拒否されるか)であり、ポリシーではない。スキーム検索自体は大文字小文字を区別しない(ワイヤートークンは `SDK-HMAC-SHA256 Access=…` のように到着し、キーは小文字である)。 +### `billing` + +- **Type:** `object` — `{ prices: Record }`, 価格は **100万** トークンあたりの USD 単位 +- **Default:** `{}` (models.dev レジストリのスナップショットは、既知のすべてのモデルに価格を設定している) +- **Status:** ACTIVE (#4899) +- **Description:** Web パネルの金額表示用のモデル別請求価格。確定した使用量レポートごとに、セッション (`session.stats.costUsd`: input / cache-read / cache-write / output) に対して実行中の USD 台帳が請求される。パネルの「Saved」列は、フォールドによる節約額をドルに換算して追加表示する。モデル ID 単位の解決順序: まず `billing.prices`、次にバンドルされた models.dev スナップショット、最後に未設定 (トークンのみ — 架空のドルは生成せず、偽の `$0` も表示しない)。 + - キーはモデル ID であり、レジストリが使用するのと同じあいまいなロジックで一致する: `"anthropic/claude-sonnet-4-5"`、単体の `"claude-sonnet-4-5"`、大文字小文字の揺れはすべてヒットする。 + - `input` (100万 input トークンあたりの USD) は必須 — これが欠けた行は正直に何も請求しない; `output` / `cacheRead` / `cacheWrite` は任意であり、欠けている場合は input レートで請求される (支出推定は割引やプレミアムを勝手に発明しない — 意図的にカーネルの経済比率 r=0.1w / q=4w を使用しない)。 + - 価格はリクエストごとにスタンプされる (最新のモデルが優先される) ため、セッション中のモデル切り替えは即座に価格を再設定する; 過去の台帳エントリは請求された時点の価格を保持する (メーターセマンティクス)。 + - 無効な形状 (未知のフィールド、負またはゼロの `input`、数値でない値) はロード時にブロック全体を拒否する — タイポした価格が静かに無効になることは決してあってはならない。 + - Web エディタ (`/__bili/` → Configuration → Billing prices) は、セッションで使用されたすべてのモデルをリスト表示し、レジストリのデフォルト値を事前入力し、このブロックに保存する; 空のテーブルを保存すると削除される。 + + ```jsonc + { + "billing": { + "prices": { + "anthropic/claude-sonnet-4-5": { "input": 3, "output": 15, "cacheRead": 0.3, "cacheWrite": 3.75 }, + "openai/gpt-5": { "input": 1.25 } + } + } + } + ``` + +### `modelContextLimit` + +- **Type:** `number` +- **Default:** `200000` +- **Status:** ACTIVE +- **Description:** プロセス全体の絶対的なコンテキスト上限 (トークン数) — 最終手段のウィンドウソース: モデルに対して他のソース (ティア証拠ヘッダー、プラグイン/ランチャーのレポート、ルート別 `models..context` 宣言、レジストリ検索、組み込みテーブル) が上限を解決できない場合のみ参照される。これらは制限や上書きはしない — 例えば、ネイティブウィンドウが 1M に解決されるモデルは、この値を完全に無視する (#5908)。環境変数 `ACP_MODEL_CONTEXT_LIMIT` またはこのファイルのキーで設定する (環境変数が優先される)。[Compression Tuning](#compression-tuning) 配下の `compress.modelContextLimit` マージキーとは異なり、後者はプロバイダー別/モデル別の 3 段階カスケードに参加し、すべての解決済みソースを上書きする。 + +### `providersPath` + +- **Type:** `string` +- **Default:** *(なし — プロバイダーはこのファイル内のインライン `providers` ブロックから取得される)* +- **Status:** ACTIVE +- **Description:** 外部 `providers.json` へのパス (インライン [`providers`](#providers) テーブルのレガシー/共有ファイル形式)。`ACP_PROVIDERS` によって上書きされる。 + +### `promptCache` + +- **Type:** `{ routing?: "auto" | "enabled" | "disabled" }` +- **Default:** `{ routing: "disabled" }` (#5079 以降) (認識されないものは `"disabled"` として解析される; #5079 以前はデフォルトが `"auto"` だった) +- **Status:** ACTIVE +- **Description:** bili 自身の `prompt_cache_key` 送信に関する単一のスイッチ — 2 つのワイヤーを同時に管理する: チャットワイヤーのプラグインレーン本体スタンプと、Responses ワイヤーのキー注入。クライアントから提供された `prompt_cache_key` は、bili が決定するものではない: すべてのモードでそのまま転送される (egress A/B probe-and-remember は、特定の origin+model が拒否することが証明されている場合にのみそれを保留する)。プラグインレーンにおいて、バインドされた会話 ID と等しい本体キーは、bili 自身の機構がエコーバックしているもの (例: dsh の `PI_CACHE_RETENTION=long` スタック) であり、bili 自身の送信としてカウントされる。モード: `"disabled"` (デフォルト) = bili は自身のキーを書き込まない; `"auto"` = #5079 以前の動作 (チャットワイヤーはすべてのプラグインレーンリクエストでスタンプ; Responses ワイヤーはアップストリームホストが正確に `api.openai.com` の場合のみ注入); `"enabled"` = 対応するすべてのレーンでスタンプ/注入 (Responses ワイヤーは任意のホスト)。このファイル、`ACP_PROMPT_CACHE_ROUTING`、または Web UI のクイック設定スイッチで設定する。このキーでプレフィックスキャッシュをルーティングするリレー/アカウントプールアップストリームへのアップグレードでは、`"auto"` (または `"enabled"`) を設定すべき — そうでなければトラフィックがランダムにルーティングされ、プレフィックスキャッシュをミスする可能性がある; 公式 API を直接使用するユーザーはデフォルトのままにできる。 + +### `cacheKeepalive` + +- **Type:** `{ enabled?: boolean, ttlFactor?: number, maxDurationMs?: number, maxConcurrentPings?: number, assumeTtl?: "5m" | "1h", armWithoutBreakpoints?: boolean, intervalMs?: number }` +- **Default:** `{}` (機能オフ) +- **Status:** ACTIVE (#3376) +- **Description:** Anthropic ワイヤー向けのアイドル期間中のプロンプトキャッシュキープアライブ (#3376)。Anthropic のプレフィックスキャッシュは TTL (ブレークポイントごとに 5 分または 1 時間) で期限切れになる; セッションがアイドル状態 (昼休み、一晩中) の間、次の実際のリクエストは、キャッシュされたプレフィックスのフルプライスのコールドリビルドを支払うことになる。有効化されると、bili は各セッションの最後に正常に転送されたリクエスト本体のスナップショットを撮る — アップストリームに到達した正確なバイト列、`cache_control` ブレークポイントを含む — そして、セッションがアイドル状態の間、TTL 由来の周期で `max_tokens=1` を付けて再生する; キャッシュヒット応答は、最小限の 1 回の完了のコストで TTL を更新する。すべてのピンは、アップストリーム自身の `usage.cache_read_input_tokens` に対して検証される: ヒットすると次のピンを再スケジュールする; 読み取りトークンがゼロの場合、プレフィックスはすでに死んでいることを意味し、キープアライブは停止する。 + - **Arming.** 正常 (2xx) な Anthropic ワイヤー POST のみスナップショットをアーム/更新する。パススルーリクエスト、再署名レーン (保存された署名は古いバイト列をカバーするため)、非文字列本体、64 MiB を超える本体、および `cache_control` ブレークポイントのない本体は、以下で上書きされない限りアームされない。スナップショットはメモリ内のみ: 再起動でクリアされ、次の実際のリクエストで再アームされる。 + - **Cadence.** `tier × ttlFactor`。ここで tier は、いずれかのブレークポイントが `ttl: "1h"` を宣言している場合は `1h`、それ以外は `5m`; デフォルト係数 `0.9` → おおよそ 4.5 分 / 54 分ごとに 1 ピン。`assumeTtl` (本体検出をスキップ — bili の下流で `cache_control` TTL を注入または書き換えるリレー用) または絶対的な `intervalMs` (すべてに優先) で上書き可能; `armWithoutBreakpoints: true` はブレークポイントのない本体でもアームする (`assumeTtl` と組み合わせる)。 + - **Stopping.** セッションに対する実際のリクエストは即座にキャンセルする (キャッシュ自体を更新するため); セッションに進行中のリクエストがある間にティックが着地したピンは約 5 秒遅延; `cache_read_input_tokens = 0` → 停止 (`prefix-dead`); HTTP 429 → 即座に停止; 3 回連続したその他のエラー → 停止; セッションの最後の実際のリクエストから `maxDurationMs` (デフォルト 24 時間) を超える → 停止; `maxConcurrentPings` (デフォルト 4) は同時にアームされたセッション数を制限し、最も長い間アイドルだったものを先に退避させる。 + - **Cost & observability.** ピンはプロキシパイプラインを完全にバイパスするため、`/acp-cache` ヒットレートの台帳には決して入らない (合成トラフィックはヘルス判定を汚染すべきではない) かつ、キャッシュ帰属サンプルを作成しない — ミス帰属の計算は、キープアライブなしの場合と正確に同じリクエストシーケンスに対して実行される。各アーム/ピン/ディザームは `[keepalive] …` 行をログ出力する; `acp_status` はアームされたセッションに対して `CACHE KEEPALIVE: armed tier=… cadence=… · pings=N [· last-hit Mm ago]` 行を 1 行報告する (未アームの場合は存在しない); Web UI はセッションごとのキープアライブバッジと詳細行を表示し、その生 JSON 設定エディタはこのセクションを直接受け入れる (保存時にサーバー側で検証される)。 + - **Per-provider & per-model override.** すべてのフィールドは、プロバイダールート (`providers..cacheKeepalive`) 下およびそのルートの特定のモデル (`providers..models..cacheKeepalive`) 下でも設定できる — 1 つのアップストリーム背後の異なるモデルは、異なるティア/周期で実行できる。フィールドごとに、優先順位は: 環境変数 > モデル > ルート > グローバルブロック > 組み込みデフォルト。 + +### `autoUpdate` + +- **Type:** `boolean` +- **Default:** `true` +- **Status:** ACTIVE +- **Description:** 定期的な npm レジストリバージョンチェック (`update.checkIntervalMs` ごと、デフォルト 3 分; プロセスごとの最初のチェックはスロットリングを無視する)。設定された `updateTag` チャンネル上の新しいビルドを検出する; 実行中のプロセスが実際に切り替えるかどうかは、`autoRestartOnUpdate` (自己再起動) または助言レーン (強制インストール) に依存する。`ACP_AUTO_UPDATE=0` で無効化。`advisoryCheck` とは独立: オートアップデートをオフにしたインストールでも、助言ウォッチャーを通じて既知の壊れたバージョン範囲を回避できる。#3619 以降、発見されたアップグレードは即座に適用されない — 自動アップグレードはランダムな遅延ウィンドウ内で段階的に実行される (組み込み 15 分 – 48 時間、リモートポリシーで調整可能; 以下の [`update`](#update) を参照) ため、悪いリリースは全フリートが移動した後にではなく、ロールアウト中に捕捉できる。 + +### `autoRestartOnUpdate` + +- **Type:** `boolean` +- **Default:** `false` +- **Status:** ACTIVE +- **Description:** オートアップデートインストール後のオプトイン自己再起動 (#811): 進行中のリクエストがゼロであることを要求し、インストール健全性チェックを通過し、10 分のクールダウンマーカーを尊重する; 失敗した場合、元のリスナーが再開される。`ACP_AUTO_RESTART_ON_UPDATE=1` (0 以外の任意の値) で有効化。 + +### `updateTag` + +- **Type:** `string` (npm dist-tag) +- **Default:** `"latest"` +- **Status:** ACTIVE +- **Description:** オートアップデータが追跡する dist-tag チャンネル (例: `dev`)。ローリング `pr` タグは、すべての PR にわたる最新の PR テストビルドを追跡する; レガシーな PR 別 `pr-N` タグはその PR の最後のビルドで凍結されており、明示的に設定された場合のみ追跡される。`ACP_UPDATE_TAG` によって上書きされる。 +### `advisoryCheck` + +- **Type:** `boolean` +- **Default:** `true` +- **Status:** ACTIVE +- **Description:** 重大欠陥アドバイザリーウォッチャー (#1481): 関連パッケージ `billion-context-advisories`(`advisories/` から CI 経由で公開)をポーリングし、実行中のバージョンが宣言された破損範囲内にある場合、固定された `target` バージョン(ロールバックの場合を含む)を強制インストールします。`autoUpdate` に独立して動作するため、自動更新をオフにしたインストールでも、既知の破損バージョンからの強制更新が行われます。フェイルオープン方式: ソースに到達できない場合や形式が不正な場合は警告のみ出力し、モデルトラフィックをブロックすることはありません。`BILI_ADVISORY_CHECK=0` で無効化できます。 + +### `advisoryUrl` + +- **Type:** `string` (URL) +- **Default:** *(設定済みレジストリ上の関連パッケージ `billion-context-advisories` — `update.registry` に準拠)* +- **Status:** ACTIVE +- **Description:** アドバイザリー文書の URL のオーバーライド。`BILI_ADVISORY_URL` によって上書きされます。 + +### `releaseNotesCheck` + +- **Type:** `boolean` +- **Default:** `true` +- **Status:** ACTIVE +- **Description:** リリースノート可視化ウォッチャー (#1870): 関連文書 `billion-context-release-notes` を取得し、保留中のスパンに `critical` ティアのエントリが含まれている場合のみ、`acp_status` および `/acp` パネル上で "CRITICAL update ready — restart to finish" または "critical update available" を表示します。通常のリリースは表示されません(設計上サイレント、#1977)。インストールも再起動も行いません。フェイルオープン方式。`BILI_RELEASE_NOTES_CHECK=0` で無効化できます。 + +### `releaseNotesUrl` + +- **Type:** `string` (URL) +- **Default:** *(設定済みレジストリ上の関連パッケージ `billion-context-release-notes` — `update.registry` に準拠)* +- **Status:** ACTIVE +- **Description:** リリースノート文書の URL のオーバーライド。`BILI_RELEASE_NOTES_URL` によって上書きされます。 + +### `security` + +- **Type:** object +- **Default:** 以下のどのノブも設定されていません(すべてフェイルクローズ) +- **Status:** ACTIVE +- **Description:** セキュリティ姿勢ノブ — 意図的にオンにすることで信頼境界が拡大される設定を、監査可能な単一のブロックとして保持する場所です。ファイル専用: ここに含まれるものには `BILI_*` 環境変数の対応物がありません (#2030)。 + +#### `security.adminRelay` (#3373) + +- **Type:** `boolean` +- **Default:** `false` (フェイルクローズ) +- **Description:** 埋め込みホスト(現在は dsh の Web パネル)が、ホスト自身の Web エントリを通じて `/__bili/` 管理サーフェスの全体をリレーすることを許可します。これにより、別のマシン上のブラウザが、プロキシがループバック以外のインターフェースをバインドすることなくパネルを開くことができます。ヘッドレスセットアップ: `dsh web` を実行し、リバースプロキシをそこに指向し、どこからでも bili タブを開きます — 設定 iframe とその API 呼び出しはエントリと同じオリジンを保ち、ホストのリレーに乗ります。仕組み: dsh 側の bili プラグインは `/__bili` プレフィックスルートを登録し、ループバックプロキシ(`127.0.0.1:18787` ゾーン)へ転送します。`/bili/origin` は `{"relay":true}` を報告し始め、パネル UI が同じオリジンの URL を構築します。また、パネル自身の API ルートはページパスから導出されるため、プレフィックスゲートウェイ(`/app/dsh/…`)でも動作します。管理ゲート自体は変更されていません (#1538): リレーされたホップは、ローカルな非ブラウザクライアントとしてプロキシに到達します — ループバックソースアドレス、ループバック `Host`、`Origin`/`Cookie`/`Referer` は転送されません — これは既存のチェックがすでに許可している形状と完全に一致します。**セキュリティ注意:** `/__bili/` は読み取り専用ダッシュボードではなく、完全な管理サーフェスです — 設定編集や認証情報の書き込みが含まれます。このフラグを有効にすると、ホスト Web エントリに到達できる者がすべてに到達できるようになるため、有効にする前にエントリを保護してください(認証 / リバースプロキシ)。リクエストごとにライブで読み取られます: ファイルの切り替えは次の呼び出しから適用され、再起動は不要です。環境変数はありません — 意図的な姿勢の決定はファイルに属します。 + +### `maskHosts` + +- **Type:** `boolean` +- **Default:** `true` +- **Status:** ACTIVE +- **Description:** プロキシログにおけるホストマスキング (#897/#255): 非パブリックなターゲットホスト(プライベートリレー、内部ドメイン)は、ログが定期的にパブリックな issue に貼り付けられるため、そのままではなく `` として記録されます。認証情報ヘッダーのマスキングは独立しており、常にオンです。実際のターゲットホストは、このフラグを変更せずに `GET /__bili/stats` → `blindTunnels` および `GET /__bili/health`(どちらもループバック専用)を通じて利用可能です。`BILI_LOG_MASK_HOSTS=0` で無効化できます。 + +### `subagentSplit` + +- **Type:** `boolean` +- **Default:** `true` +- **Status:** ACTIVE +- **Description:** Claude Code サブエージェントセッション分割 (#970/#4352)。このスイッチで制御される2つのメカニズム。(1) `x-claude-code-agent-id` + `x-claude-code-parent-agent-id` のペアを持つ anthropic-wire リクエストは、メインセッションのロックの後ろにキューイングするのではなく、独自の `\|sub:` セッション(独自のロックチェーンと圧縮状態)を取得します。(2) ヘッダーなしの claude code トラフィック(VS Code 拡張ビルド。そのサブエージェントは agent-id ヘッダーを持たず、親の最初のシステムブロックを共有するため、ペアゲートが検出できない — #4352)は、コンティニュイティ認識順序リゾルバーを介してルーティングされます。継続中のメイン会話では、順序+コンテンツの証拠に基づいて生のキーを保持しますが、履歴が非連続なサブエージェントライドは独自のレーンにフォークします — bili SubagentStart フックのトークンが最初のユーザーメッセージに乗っている場合は、DISPATCH ごとにキー付けされます(`\|sub::t:`)、それ以外の場合は実行の最初のユーザーメッセージの断片でキー付けされます(`\|sub::`)。これにより、同じタイプのサブエージェントが1つの親 ID 配下で再ディスパッチされても、圧縮セッションを共有しません (#5095)。有効なトークンも使用可能なユーザーテキストもないライドは、2セグメントの `\|sub:` 形式を保持します。`BILI_SUBAGENT_SPLIT=0` を設定すると、両方のメカニズムが無効になります。 + +> **スコープ — anthropic wire のみ。** **Responses** wire +> (`x-claude-code-session-id` が存在し、`/v1/responses` アップストリーム) を話す Claude Code は +> `claudeSubagentSplit` を通りません。そのレーンはインストラクションの +> フィンガープリントでキー付けされます(`WIRE_CLIENTS` → `claude-responses` in +> `src/server/lane-decisions.ts`)が、`subagentSplit` ではゲートされていません — +> `BILI_SUBAGENT_SPLIT=0` はそこで何もしません。そのレーンでの2つの回避方法: +> - `personaSplit: false` / `BILI_PERSONA_SPLIT=0`、または +> - `stableSystemAnchor: true`。これによりインストラクションのドリフトが予期された +> イベントとなり、変更されたシステムプロンプトがメイン会話をフォークすることがなくなります。 + +### `forkAdoption` + +- **Type:** `boolean` +- **Default:** `false` +- **Status:** ACTIVE +- **Description:** 匿名(プレフィックスアフィニティ)クライアント向けのフォークブロック採用 (#629): このようなクライアントが会話中に履歴をフォークした場合(編集して再送信 / 以前のターンを再生成)、新しいセッションは、フォークされたリクエストに完全に存在するソースコンテンツを持つ親の圧縮ブロックを継承し、ゼロの圧縮状態から始めて共有プレフィックスを最初から折りたたみ直す代わりに動作します。識別されたレジュームフォークはこのスイッチの対象外です — `resumeInheritance` (#1834) と一緒にブロックを採用します。採用可能なインベントリは、無効化中であってもすべての匿名フォークで記録されるため、有効化する前に利点を評価できます。`BILI_FORK_ADOPTION=1` で有効化します。 + +### `affinitySimhash` + +- **Type:** `boolean` +- **Default:** `true` +- **Status:** ACTIVE +- **Description:** 匿名(プレフィックスアフィニティ)クライアント向けの Simhash チェーン整列採用 (#2265): クライアント側の普遍的な装飾的書き換え(モデル切り替え後、Trae がすべてのアシスタントメッセージにモデルタグを再スタンプする)が正確なハッシュチェーンを壊した場合、すべてのリクエストが新しい pfa-* セッションを生成し、ゼロから完全な履歴を折りたたみ直すことになります。この段階では、メッセージごとの Simhash スケッチを位置ごとに比較します: ハミング距離 10 以内で 90% 以上のカバレッジ、かつ 20% 以上の変異したが類似した位置(普遍的な書き換えであり、ポイント編集ではない)、さらに少なくとも1つのバイト同一の USER メッセージ(所有権アンカー — ユーザーの言葉は異なる会話間で繰り返されませんが、ハーネス機構は繰り返されることがある)があれば、既存のセッションとその圧縮状態を再アタッチします。保存されたチェーンはその後、変異したバイトに再アンカーされ、次のリクエストは再び正確な高速パスで解決されます。編集して再送信するフォークは引き続き独自のセッションを生成します (#629 の契約は維持)。識別されたチェーンは決して採用されず、曖昧さは推測を拒否します。`BILI_AFFINITY_SIMHASH=0` で無効化できます。 +### `resumeInheritance` + +- **Type:** `boolean` +- **Default:** `true` +- **Status:** ACTIVE +- **Description:** 識別されたクライアント向けのレジューム継承(#1486/#1834): クライアントが自身のセッション ID(例: Claude Code の `x-claude-code-session-id`)を送信しながら、新しいセッション ID で会話をレジュームし、完全なトランスクリプトをリプレイする場合(`cc --resume` は新しい UUID をフォークする)、bili は受信履歴をバイト単位で正確に照合し、そのクライアントが追跡しているチェーン(8 メッセージ以上、追記専用トラッキング)と一致させる。レジュームされたセッションの最初のリクエストにおいて、親の参照割り当てを継承する — 古いモデル引用は、番号付けが変更されたメッセージに誤ってヒットするのではなく、元のメッセージに解決される — 完全に存在する圧縮ブロックを採用し、`derivedFrom` の系譜を記録する。親は決して変更されず、新しいメッセージは親の参照空間より上に番号付けされる。レジュームは親の履歴を厳密に拡張でなければならない — 別の ID での等深度バイト完全一致リプレイは重複であり、レジュームではない。匿名セッションは独自の pfa-* ワールドを維持する(#309)。`BILI_RESUME_INHERITANCE=0` で無効化される。 + +### `stableSystemAnchor` + +- **Type:** `boolean` +- **Default:** `false` +- **Status:** ACTIVE +- **Description:** 安定システムアンカリング(#1085)— プレフィックスキャッシュのためのベストエフォートのワイヤー層フォールバック。根本的な修正はクライアント側(クライアントは自身の履歴を所有し、指示変更の提示方法を決定する)に属する。プレーンプロキシモードのみ: プラグインモードのエージェント(`x-bili-plugin`)はコンテキスト管理を所有しており、アンカーリングされることはない。有効化されると、bili は各セッションで最初に確認されたヘッドのシステム/指示ブロックを記憶し、クライアントのシステムプロンプトが後で変更された場合でも、それらの正確なバイトを再送信し続ける: ローカライズされた変更(これまで有効だったバージョンと 70% 以上の行を共有するファイルスタイルの編集)では、末尾に `[System context update] …` ユーザーノートを追加し、コンパクトな行差分(`-` 削除 / `+` 追加)を保持する; ローカライズされていない変更(構造的な並べ替え、ツール定義の変更、タイムスタンプ付きバナー、400 行を超えるヘッド)はそのまま採用される — 1 回の意図的なキャッシュミスは、モデルを誤解させるノイズを追加するよりも良い; 8 件を超えるノートの蓄積もまた、アンカーを最新のテキストで置き換える。アンカーとノートログはセッションメタデータと共に永続化され、圧縮/コンパクト化後も生存する。アンカリングから除外されるもの: タイトル生成マイクロリクエスト(OpenAI/Google)、Responses コンパクショントリガーリクエスト、オートモード分類器リクエスト。`BILI_STABLE_SYSTEM_ANCHOR=1` で有効化される。 + +### `chainContentDetection` + +- **Type:** `boolean` +- **Default:** `false` +- **Status:** ACTIVE +- **Description:** bili→bili チェーン認識のボディコンテンツ検出(#1086/#1421/#1683 のフォローアップ): 受信リクエストが圧縮アーティファクト(レンダリングタグ / 歴史的な `acp_status`+`search_context` ツール呼び出し)またはダイジェスト付きの `` チェックポイントを BODY に持ち、かつそのセッションの `x-bili-hop` ヘッダーもローカル圧縮状態もない場合、bili は助言的な観測を記録し、および/または first-processor-wins パススルーを適用する。デフォルトで OFF である理由は、リクエスト BODY のスキャンが CCR/ファイル導入テキストやモデルがエコーするタグに対して誤検出を起こす可能性があるためであり、これらは実際のマーカーのように見える — 中間ボックスが `x-bili-hop` を取り除く狭いマルチ bili リレーケースでのみ、その誤検出リスクを受け入れて有効化すること。`x-bili-hop` シグナル自体はどちらの場合も影響を受けない。`BILI_CHAIN_CONTENT=1` で有効化される。 + +### `chainEgressStamp` + +- **Type:** `boolean` +- **Default:** `false` +- **Status:** ACTIVE +- **Description:** モデル可視の `` チェーン整合性チェックポイントキャリアのエグレス出力(#1683): 有効化されると、このインスタンスが実際に処理するすべてのリクエストは、ダイジェスト付きスタンプを付けて離れ、`x-bili-hop` ヘッダーが転送中に削除された場合でも(#1421)、下流の bili が first-processor-wins を適用できるようにする。キャリアはターミナルモデルも読むスロット(OpenAI/Responses では末尾の `user` メッセージ、Anthropic/Google では末尾のテキストパート)に配置されるため、モデルはそれを幽霊ユーザー入力として扱い、コメントするためにトークンを消費する — これがデフォルトでオフである理由である。`chainContentDetection`(受信ボディ検出)および `x-bili-hop` パススルーとは独立しており、後者はどちらの場合でも機能する。上記の狭いマルチ bili リレーケースでのみ有効化すること。`BILI_CHAIN_STAMP=1` で有効化される。 + +### `claude` + +- **Type:** `{ nativePort?: number }` +- **Default:** `{}` (レーンは自己管理ポートゾーンに乗る) +- **Status:** ACTIVE +- **Description:** claude ネイティブレーンの設定。`nativePort` はフック生成プロキシの正確なポートを固定する(#964/#1660): 厳密なポートセマンティクス — ポート上の占有者はホッピングするのではなく、はっきりと拒否される — かつ焼き込まれた管理対象 `ANTHROPIC_BASE_URL` はそれに向く。これがない場合、レーンは自己管理ゾーン(`BILI_ZONE_PORT` ベース + レーンごとのスティッキー)に乗るため、各セッションで管理対象 URL をライブオリジンに再固定し、ポートドリフトが自己修復される。`BILI_CLAUDE_NATIVE_PORT` によって上書きされる。 + +### `native` + +- **Type:** `{ attachExternal?: boolean; attachLanePriority?: string[]; attachPolicy?: "own-lane" | "global-fallback"; attachUrl?: string }` +- **Default:** `{}` (own-lane ポリシー; レーン付きインスタンスに対してアタッチゲートは閉じられている; 外部レーンはリストされていない) +- **Status:** ACTIVE +- **Description:** ネイティブフックのアタッチ選択(#1335, #1660, #2905, #2877)。ネイティブフックは、コード互換性がありライフサイクルゲート(`watchdog.armed == true`、または `attachExternal: true`)を通過する場合、独自のものを生成する代わりに、すでに実行されているプロキシに乗ることができる。4 つの独立したノブが、*どの* プロキシに乗るかを形成する: + - **`attachPolicy`** (デフォルト `"own-lane"`、環境変数 `BILI_NATIVE_ATTACH_POLICY`)— レーンアフィニティ、およびクロスレーンライドが発生するかどうかのゲート。`"own-lane"`: レーン付きフックは同じレーンのデーモン**のみ**に乗る; 利用可能なものがなければ、レーンなし/手動起動の `bili start` デーモンや他のレーンのデーモンにフォールバックするのではなく、**独自のものを生成する**(その収束はすべてのエージェントを 1 つのデーモンのバージョンに固定し、セッションを二重書き込みした、#2877)。**武装済み**のレーンなしデーモン(管理対象共有プロキシ、#1225)は、どちらのポリシー下でも共有可能のまま残る。`"global-fallback"` は #2877 以前の動作を復元する: まず同じレーン、次に互換性のあるレーンなし/ユーザーゾーンデーモン(および、`attachLanePriority` と一緒に、リストされた外部レーン)。 + - **`attachLanePriority`** (#2905、ファイルのみ、環境変数なし)— 独自のレーンインスタンスが存在しない場合、このフックが乗れる外部レーン名の順序付きリスト。クロスレーンライドが許可されている場合(つまり `global-fallback` 下)、アタッチ優先度は: まず独自のレーン → リスト順のレーン → ユーザーゾーンは常に最後。リストされていないレーンはアタッチ不可のまま残る(レーン分離 #1225/#1232)。デフォルト `[]` = 独自のレーン → ユーザーゾーン → 生成。設計上オプトイン: 外部インスタンスの MITM ホワイトリストがあなたのプロバイダーをカバーしていない場合があり、その場合モデルトラフィックはブラインドトンネルとなり、すべての圧縮ツール呼び出しが失敗する。すべてのレーン認識アタッチサイト(ランチャーレーン + hermes ネイティブプラグインのディスカバリー)に適用される。例: `"native": { "attachLanePriority": ["dsh"] }`。 + - **`attachUrl`** (環境変数 `BILI_MCP_PROXY`、これは `--origin` も受け入れる; 環境変数が優先)— 明示的なターゲットオリジン(ローカルまたはリモートの任意の URL)。設定されると、ディスカバリーはその正確なオリジンにのみアタッチする(ポリシーフィルタをバイパス); 到達不能または非互換の場合、フックはハードフェイルするのではなく独自のものを生成する。これにより、ホストは特定の常駐デーモンに自身を固定できる。 + - **`attachExternal`** (環境変数 `BILI_NATIVE_ATTACH_EXTERNAL`)— ライフサイクルゲートのエスケープハッチ: `true` は*レーン付き*の非武装リスナーにもアタッチする(ウォッチドッグ状態に関係なく、コード/レーン互換の任意のリスナー、#1330 以前のビルドを含む)かつ `own-lane` アフィニティフィルタを完全にバイパスする(完全に寛容)。これはどのレーンのデーモンが優先されるかを変更しない — それは `attachPolicy` である。優先順位: `1` は閉じたファイル上でもゲートを開き; `0` は寛容なファイル上でもそれを閉じる。 + - **動作変更(#2877):** デフォルトは「レーン付きフックは互換性のあるレーンなし/手動デーモンに乗ることにフォールバックする」から「独自のものを生成する」に反転した。1 つの手動 `bili start` デーモンがすべてのネイティブエージェントにサービスを提供するよう依存していた場合、`native.attachPolicy: "global-fallback"` を設定すること(または `BILI_NATIVE_ATTACH_EXTERNAL=1` を維持する)。完全なメカニクス: [technical-notes.md](technical-notes.md#proxy-reuse-and-the-attach-gate-1225-1335-1232-1660)。 + +### `pi` + +- **Type:** `{ subagents?: PiSubagentsFileConfig | boolean }` +- **Default:** `{}` (パッケージデフォルトで acp_delegate サーフェス有効) +- **Status:** ACTIVE (#2230 config-home) +- **Description:** 組み込み **pi レーンサブエージェント**(`acp_delegate` / `acp_delegate_wait` / `acp_delegate_cancel`、`bili pi` が埋め込み拡張を配線する際に登録される)の設定。`pi.subagents` セクションはこのサーフェスの設定ホームである; リポジトリ内の `pi-subagents/` コンポーネント(npm 名 `billion-context-pi-subagents`)は、独自のローダーを通じて同じセクションを読む(ファイル形式が契約であり、共有コードではない)。以前これらのノブは pi の `~/.pi/acp.json` の `delegate` / `delegatePrompt` / `displayUsage` / `debug` にあった — これら 4 つのキーは**非推奨フォールバック**である: セクションが存在しない間はまだ読み取られる(ホストプロセスの stderr に一度きりの非推奨警告)、**セクションが存在すると無視される**、将来のリリースで削除予定。名前変更: `delegatePrompt` → `prompt`; `debug` はサブエージェントサブシステムにスコープされ、トップレベルプロキシの `debug` とは**衝突しない**。 + +```jsonc +"pi": { + "subagents": { + "enabled": true, // master switch; false (or "subagents": false) removes tools+prompt+shortcut (new session) + "forceEnable": false, // keep acp_delegate even when a pi-subagents install (either scope) is detected (#415, #5637) + "displayUsage": "separate", // "separate" (own footer block) | "merged" (folded into tool-result usage) + "maxDepth": 2, // nesting depth cap, propagated to children + "syncTimeoutMinutes": 5, // hard timeout for sync delegates; 0/null disables + "idleTimeoutMinutes": 5, // idle watchdog for async delegates; 0/null disables (warns) + "asyncTimeoutMinutes": 30, // hard limit for async delegates; 0/null disables + "maxConcurrent": 4, // cap on concurrent background delegates (default unlimited; extras queue) + "thinkingLevel": "medium", // off|minimal|low|medium|high|xhigh|max; priority per-call > role > this > pi default + "agents": { // per-role defaults: { model: "provider/id", thinkingLevel: "…" } + "reviewer": { "model": "anthropic/claude-sonnet-4-5", "thinkingLevel": "high" } + }, + "notifyIfRead": "skip", // "skip" — no completion nudge if the model already read the result file + "fleetShortcut": "ctrl+alt+d", // "" disables the keyboard shortcut (/acp-fleet still works) + "prompt": null, // replace (string) or remove (null) the ACP_DELEGATE NOTIFICATIONS appendix + "debug": false // debug events in ~/.pi/acp.log, scoped to sub-agents + } +} +``` + +**環境変数オーバーライド**(プロセスごとの生成チャネル、デリゲート子プロセスに伝播; `PI_ACP_DELEGATE_*` > `pi.subagents` > 非推奨 acp.json > デフォルト): + +| 環境変数 | オーバーライド対象 | 備考 | +|---|---|---| +| `PI_ACP_DELEGATE_FORCE_ENABLE` | `pi.subagents.forceEnable` | `true`/`false`; 解析不能な値は警告し、ファイル値にフォールバックする。 | +| `PI_ACP_DELEGATE_MAX_DEPTH` | `pi.subagents.maxDepth` | 整数 ≥ 1; 無効な場合は警告し、フォールバックする。 | +| `PI_ACP_DELEGATE_SYNC_TIMEOUT_MINUTES` | `pi.subagents.syncTimeoutMinutes` | `0` で無効化; 負/数値でない場合は警告し、フォールバックする。 | +| `PI_ACP_DELEGATE_IDLE_TIMEOUT_MINUTES` | `pi.subagents.idleTimeoutMinutes` | `0` で無効化(警告 — ハングした子プロセスにはその後 `acp_delegate_cancel` が必要)。 | +| `PI_ACP_DELEGATE_ASYNC_TIMEOUT_MINUTES` | `pi.subagents.asyncTimeoutMinutes` | `0` で無効化。 | +| `PI_ACP_DELEGATE_MAX_CONCURRENT` | `pi.subagents.maxConcurrent` | 整数 ≥ 1; 無効な場合はファイル値に、次に無制限にフォールスルーする。 | + +変更は**新しいセッション**で有効になる(ツールはセッション開始時に登録される)。完全なデリゲートサーフェスドキュメント(ロール、実行モデル、フリートインスペクター): [billion-context-pi-subagents README](../pi-subagents/README.md)。 +### プロセスレベルのブロック (#2030) + +#2030 以降、すべての純粋な挙動制御ノブには、環境変数のほかに設定ファイルのキーが用意されています。解決順序は **環境変数 > 設定ファイル > ビルトインデフォルト** です。*設定済み* の環境変数値は、そのノブを所有します(ゴミデータであっても、#2030 以前と完全に同じようにパースされ、デフォルトにフォールバックします)。また、ファイル層にリークしたり、ファイル層によってシャドウされたりすることはありません。これらのブロックは **プロキシプロセス**(トランスポートタイミング、永続化、セッションライフサイクル、セルフアップデート、診断)のスコープを限定します。これらは意図的に、3レベルの圧縮マージ([global → provider → model](#three-level-merge-example))には参加しません。これらのノブにはプロバイダ別やモデル別のセマンティクスが存在しないためです。それらの環境変数形式はプロセス全体に適用されるものであり、トップレベルのキーはスコープを正確に保持します。すべてのキーは任意です。ブロックを省略しても何も変わりません。ノブごとの詳細なセマンティクスは、以下の [環境変数マッピングテーブル](#config-file-keys-for-environment-knobs-2030) に記載されています。 + +```jsonc +// ~/.config/billion-context/billion-context.json — #2030 process-level blocks (all optional) +{ + // Transport & retry timing + "network": { + "upstreamTimeoutMs": 720000, // idle budget per upstream request (12 min default) + "requestWatchdogMs": 1440000, // total request budget; default = 2× upstream timeout + "replayRetryMax": 3, // attempts after transient upstream 429/5xx + "replayRetryBaseMs": 1500, // backoff base; 0 disables the delay + "maxShrinkPerCompress": 0.4, // max fraction (0,1] one compress may shrink; omit = no steering + "keepAliveTimeoutMs": 5000, // client-facing socket keep-alive + "clientErrorBackstopMs": 30000, // half-open client socket destroy backstop + "exposureLogIntervalMs": 3600000, // [exposure] telemetry interval; 0 disables + "streamKeepAliveMs": 15000, // SSE keepalive during upstream silence; 0 disables + "preflightHoldMs": 30000, // grace before a long preflight hold starts + "preflightDeadEndCooldownMs": 300000, // cooldown after a dead-end preflight verdict + "proxyKeepAliveMaxMs": 55000, // upstream-proxy connection reuse cap; 0 uncapped + "postResponseLingerMs": 5000, // post-response close linger budget (#1982) + "allowPrivateHttpProviders": false // opt-in: private-network plain-HTTP providers (#2984) + }, + + // Session persistence + "persist": { + "enabled": true, // false = in-memory only, lost on restart + "zstd": false, // true = BILIZSTD1 files (#1080 owner decision: off) + "debounceMs": 500, + "tailTokens": 16384, // persisted snapshot budget; 0 = no message persistence + "epermAlertThreshold": 5, // Windows AV-exclusion alert after N failures + "epermAlertRepeatMs": 0 // 0 = alert once + }, + + // Session lifecycle + "sessions": { + "max": 256, // in-memory LRU cap + "gc": { + "enabled": false, // opt-in (#1082): session files are user data + "maxAgeDays": 7, + "maxTokens": 1000000, + "intervalMs": 3600000 + } + }, + + // Self-updater + "update": { + "registry": "https://registry.npmjs.org", + "checkIntervalMs": 180000 + }, + + // Debug & diagnostic toggles + "diagnostics": { + "dumpBody": false, // dump full request/response bodies + "dumpReq": true, // gate for request-body dumps + "rawDumpDir": null, // raw-dump location; null = /raw + "dump4xx": false, // capture rejected 4xx bodies + "dump4xxMaxBytes": 2097152, + "maxTotalBytes": null, // cap total dump-dir bytes; null = no cap (#2412) + "maxAgeDays": null, // delete dump files older than N days; null = off + "renderNone": false, // stop injecting mNNNNN render tags + "invariantJudge": true, // L1 advisory outbound-invariant judge (#3938) + "noInjectTool": false, // suppress compress tool injection + "noCompressPrompt": false, // suppress compress prompt text + "countTokensPassthrough": false, // forward /count_tokens verbatim + "compressProtocol": "tools" // "tools" | "text" + }, + + // Fake-completion safety net (#371, opt-in) + "fakeCompletion": { "retries": 0, "bufCapBytes": 16777216 }, + + // Scalars + "codexCompact": "intercept", // or "pass" + "ccrRetrievalTtlMs": 600000, // queued acp_retrieve expiry; 0 disables + "decompressTmpCap": 50 // max concurrent decompress temp files +} +``` +### `network` + +- **Type:** `{ upstreamTimeoutMs?: number; requestWatchdogMs?: number; replayRetryMax?: number; replayRetryBaseMs?: number; maxShrinkPerCompress?: number; keepAliveTimeoutMs?: number; clientErrorBackstopMs?: number; exposureLogIntervalMs?: number; streamKeepAliveMs?: number; preflightHoldMs?: number; preflightDeadEndCooldownMs?: number; proxyKeepAliveMaxMs?: number; postResponseLingerMs?: number; allowPrivateHttpProviders?: boolean }` +- **Default:** `{}` (組み込み値: `720000`, `2× upstream timeout`, `3`, `1500`, 未設定, `5000`, `30000`, `3600000`, `15000`, `30000`, `300000`, `55000`, `5000`, `false`) +- **Status:** ACTIVE +- **Description:** プロセス全体のトランスポートおよびリトライのタイミング(ミリ秒)。各キーは、対応する環境変数(`BILI_UPSTREAM_TIMEOUT_MS`, `BILI_REQUEST_WATCHDOG_MS`, `BILI_REPLAY_RETRY_MAX`, `BILI_REPLAY_RETRY_BASE_MS`, `BILI_MAX_SHRINK_PER_COMPRESS`, `BILI_KEEP_ALIVE_TIMEOUT_MS`, `BILI_CLIENT_ERROR_BACKSTOP_MS`, `BILI_EXPOSURE_LOG_INTERVAL_MS`, `BILI_STREAM_KEEPALIVE_MS`, `BILI_PREFLIGHT_HOLD_MS`, `BILI_PREFLIGHT_DEAD_END_COOLDOWN_MS`, `BILI_PROXY_KEEPALIVE_MAX_MS`, `BILI_POST_RESPONSE_LINGER_MS`, `BILI_ALLOW_PRIVATE_HTTP_PROVIDERS`, `BILI_CA_FILE`)を通じて、環境変数 > ファイル > デフォルトの優先順位で解決される。セマンティクス: `upstreamTimeoutMs` は、エンドツーエンドでのファーストバイトまでの時間とチャンク間の沈黙時間を制限する(#551);`requestWatchdogMs` はリクエスト全体の予算であり(負の値を設定すると無効化される);`replayRetryMax` は、一時的なアップストリーム拒否後の試行回数を数える(#189/#1688);`maxShrinkPerCompress` は、bili がより小さい範囲へ向かうよう誘導する前に、1回の圧縮でリクエストを縮小できる上限を定める(#189);`streamKeepAliveMs` は、レスポンスがその間ゼロバイトしか書き込まれていない場合に SSE コメントを発行する(#1647);`proxyKeepAliveMaxMs` は、アップストリームプロキシの再サイクル頻度未満での接続再利用を制限し(#1263)、`0` で無制限にする;`postResponseLingerMs` は、プロキシ起因のレスポンス後のクローズにおけるグレースフルクローズの予算であり、ソケットはピアの FIN/TLS close_notify を待って保持され、期限が来ると破棄される(`reason=linger-backstop`)(#1982);`allowPrivateHttpProviders` はオプトイン機能(#2984)であり、true の場合、プライベートネットワーク(RFC1918, 127/8, リンクローカル, IPv6 ULA/リンクローカル, `*.local`/`.lan`/`.internal`)上のプレーン HTTP プロバイダーの baseUrl が、通常はループバックのプレーンテキストのみを信頼するエージェントレジストリのインテークおよびサマリーエンドポイントのガードによって許可される — パブリック IP/ドメインおよび CGNAT (100.64/10) は常に拒否され、デフォルトの `false` は #2984 以前の動作をバイト単位で維持する;`caFile` (#3776) は、bili 自身のアップストリームフェッチを追加のルート CA PEM に向ける — 組み込みルートおよび `NODE_EXTRA_CA_CERTS` とマージされ、決して置き換えられない — セキュリティスキャナー/企業 MITM による再署名されたアップストリーム用。詳細は [env table](#config-file-keys-for-environment-knobs-2030) を参照。 + +### `persist` + +- **Type:** `{ enabled?: boolean; zstd?: boolean; debounceMs?: number; maxDelayMs?: number; tailTokens?: number; epermAlertThreshold?: number; epermAlertRepeatMs?: number }` +- **Default:** `{ enabled: true, zstd: false, debounceMs: 500, maxDelayMs: 5000, tailTokens: 16384, epermAlertThreshold: 5, epermAlertRepeatMs: 0 }` +- **Status:** ACTIVE +- **Description:** セッション永続化の動作(対応する環境変数: `BILI_PERSIST`, `BILI_PERSIST_ZSTD`, `BILI_PERSIST_DEBOUNCE_MS`, `BILI_PERSIST_MAX_DELAY_MS`, `BILI_PERSIST_TAIL_TOKENS`, `BILI_PERSIST_EPERM_ALERT_THRESHOLD`, `BILI_PERSIST_EPERM_ALERT_REPEAT_MS`)。`enabled: false` はセッションをメモリ内にのみ保持する;`zstd: true` は `BILIZSTD1` ファイルを書き出す(#1080 オーナー決定: 回復可能性のためプレーン JSON がデフォルトのまま);`tailTokens` は永続化された折り畳みスナップショットの予算を定める(`0` でメッセージ永続化を完全に無効化);`debounceMs` / `maxDelayMs` はセッションファイルの書き込みデバウンスを制限する — ウィンドウはすべての変更で再起動し、最大遅延の上限は持続的なトラフィック下でも書き込みが予算内で完了することを保証する(この上限はセッション順序 / プレフィックスアフィニティのスナップショットライターにのみ存在し、#6058 でこのノブに配線されるまで 5 秒の予算がハードコードされていた。これにより摩耗に敏感なドライブでの定常状態の書き換えレートが設定された;メインのセッション別ライターは飢餓を起こさない非再起動型デバウンスを使用するため、そのような上限はない);2つの `eperm*` キーは Windows のアンチウイルス除外アラートを調整する。詳細は [env table](#config-file-keys-for-environment-knobs-2030) を参照。 + + **物理的な書き込み量の監視 (#6058).** これらのノブが敏感な(例: QLC)ドライブの実際の摩耗にどのような影響を与えるかを測定するには、代表的な実行の前後で NVMe SMART カウンターを差分比較する: + + ```bash + smartctl -A -d nvme /dev/nvme0n1 # "Data Units Written" (+ "Percentage Used") を記録 + # ... N 分間ワークロードを実行 ... + smartctl -A -d nvme /dev/nvme0n1 # 差分 = ウィンドウ内の物理的な書き込みバイト数 + ``` + + その後、マシンがアイドル状態になった約 10 分後に一度だけ読み取り、バックグラウンド書き込み(WAL チェックポイント、スナップショットフラッシュ)とフォアグラウンドトラフィックを分離する。カウンターの単位はファームウェアで定義される(NVMe 標準では 512 バイト単位を使用 — 既知サイズのコピーに対して健全性チェックを行うこと)ため、絶対値ではなく固定ウィンドウでの DELTAS を比較すること。ファイルシステムレベルの集計(mtime/サイズのスキャン)では、ページレベルの index.db の書き換えや WAL の変動を完全に逃してしまう — 完全なボリュームを確認できるのは SMART カウンターのみである。 + +### `sessions` + +- **Type:** `{ max?: number; gc?: { enabled?: boolean; maxAgeDays?: number; maxTokens?: number; intervalMs?: number } }` +- **Default:** `{ max: 256, gc: { enabled: false, maxAgeDays: 7, maxTokens: 1000000, intervalMs: 3600000 } }` +- **Status:** ACTIVE +- **Description:** `max` は LRU エビクションによりメモリ内のセッション数を制限する(対応する環境変数 `BILI_MAX_SESSIONS`;ディスクは依然として真実のソースである)。`warmMax`/`warmMaxBytes` は起動時のウォームキャッシュを、`residentMaxBytes` はアイドル時の常駐目標を制限する(#2803 有界な起動: 起動時に最も最近のウォームセットのみがハイドレーションされ、それ以外はオンデマンドで再読み込みされる;アクティブ/進行中の状態は決してエビクションされない)。`gc` は古いセッションファイルのクリーンアップを制御する(対応する環境変数 `BILI_SESSION_GC*`) — **オプトイン**であり、セッションファイルはユーザーデータであるため:圧縮されたセッションは決して削除されず、削除は監査ログに記録され、経過日数およびロスレスサイズのゲートが適用される。詳細は [env table](#config-file-keys-for-environment-knobs-2030) を参照。 + +### `plugin` + +- **Type:** `{ snapshotCapBytes?: number }` +- **Default:** `{ snapshotCapBytes: 104857600 }` +- **Status:** ACTIVE +- **Description:** プラグインサーフェスのノブ(#2017)。`snapshotCapBytes` は、パブリックフォーク API(`GET /__bili/plugin/snapshot`, `POST /__bili/plugin/fork`)のためにプラグインセッションごとに保持される生ワイヤー履歴スナップショットの上限を定める:シリアライズされたスナップショットが上限を超えると、bili はそれを保持することを拒否する — ディスク上に無制限の生コピーを保持する代わりに、セッションはフォーク可能でなくなる(snapshot/fork が上限理由とともに `409` を返す)。デフォルトは `100 MiB`;`0` で保持を完全に無効化(どのセッションもフォーク不可);対応する環境変数 `BILI_PUBLIC_SNAPSHOT_CAP_BYTES`。詳細は [env table](#config-file-keys-for-environment-knobs-2030) を参照。 + +### `update` + +- **Type:** `{ registry?: string; checkIntervalMs?: number; staggerMinDelayMs?: number | string; staggerMaxDelayMs?: number | string; policyUrl?: string }` +- **Default:** `{ registry: https://registry.npmjs.org, checkIntervalMs: 180000 }` (stagger フィールド未設定 → 組み込みウィンドウ 15 分 – 48 時間;`policyUrl` 未設定 → 公式リポジトリの raw URL) +- **Status:** ACTIVE +- **Description:** セルフアップデーターのソース(対応する環境変数 `BILI_UPDATE_REGISTRY`, `BILI_UPDATE_CHECK_INTERVAL_MS`, `BILI_UPDATE_STAGGER_MIN_MS`, `BILI_UPDATE_STAGGER_MAX_MS`, `BILI_UPDATE_POLICY_URL`)。stagger ファイルフィールドは人間が読める期間文字列(`"15m"`, `"2d"`, `"1d12h"`, 単位 s/m/h/d/w、組み合わせ可能)を受け入れる;環境変数の対応物は生のミリ秒のまま。`registry`/`checkIntervalMs` はインポート時に解決されるため、次の再起動で有効になる — 環境変数と同様。`registry` はハーメティックテスト(verdaccio e2e レーン)のために意図されている;本番環境ではデフォルトのままにすること(#1153)。stagger フィールドおよび `policyUrl` は更新サイクルごとにライブ読み取りされる。 + +#### スタグダードロールアウトおよびリモート更新ポリシー (#3619) + +新しいバージョンが発見された場合、自動アップグレードは即座に実行されない:インスタンスは遅延ウィンドウ内のランダムな 1 つの時刻を引き — 組み込みデフォルトは **15 分から 48 時間** — その時刻が来たらアップグレードする。引き出された時刻はキャッシュディレクトリ(`~/.cache/billion-context/.update-stagger.json`)に `(dist-tag, target version)` をキーとして永続化されるため、プロセスの再起動では再抽選されない(再起動が多いマシンが早期の値を引き続けることはない)。これにより、リリースから数分以内に全員が移動するのではなく、フリートのアップグレードがウィンドウ内に分散され、ロールアウト中に不良リリースを捕捉するための応答ウィンドウが確保される(#3401/#3600/#3394)。 + +ウィンドウの構成(各側独立して):ローカル設定/環境変数 > リモートポリシーの `default` > 組み込み(15 分 / 48 時間)。**`0` はこのマシンの遅延を無効化する** — レガシーの即時アップグレードのために両側を `0` に設定する。 + +リモートポリシーファイル:bili は公式リポジトリの raw アドレスから `auto-update-policy.json` を匿名で GET する(`update.policyUrl` / `BILI_UPDATE_POLICY_URL` のオーバーライドはテストシームのみ)。キャッシュディレクトリに ETag/If-None-Match を使用してキャッシュされる。失敗ラダー(fail-open — ファイルによってアップグレード機能がブロックされることはない):フェッチ/HTTP 失敗 → 30 日以内であれば最後に正常にキャッシュされたコピーを再利用、それ以外はローカルデフォルト;不正な JSON または不明な `schemaVersion` → キャッシュを破棄し、ローカルデフォルト。テレメトリゼロ:プレーン GET、クエリパラメータなし、デバイス ID なし。 + +フォーマット(フィールドは追加的;不明なフィールドは無視される)。キーは `minDelay`/`maxDelay`(期間文字列が優先 — 生のミリ秒の数値も受け入れられる): + +```jsonc +{ + "schemaVersion": 1, + "default": { "minDelay": "15m", "maxDelay": "2d" }, + "overrides": [ + { "range": ">=0.1.200", "maxDelay": "1h" }, + { "version": "0.1.199", "maxDelay": "1m" } + ], + "hold": false, + "blocked": [], + "pinned": null +} +``` + +- `default` — オーバーライドに一致しないターゲットバージョンのベースウィンドウ。期間フィールド(`minDelay`/`maxDelay`、すべてのオーバーライドで同じ)は人間が読める文字列(`"15m"`, `"2d"`, `"1d12h"`, 単位 s/m/h/d/w、組み合わせ可能;プレーンな数値は依然として生のミリ秒を意味する)を受け入れる。不正な値は警告とともに無視される — 推測は決して行われない。 +- `overrides[]` — ターゲットバージョンごとのウィンドウ調整:正確な `version` が `range`(npm semver レンジ)に優先する;最初に一致したレンジが勝つ。オーバーライドは片側のみを設定してもよい。 +- `hold: true` — フリート全体の自動アップグレードを凍結する(チェックは実行され続けるが、何もインストールされない)。手動の `bili update` は依然として動作する。 +- `blocked: ["x.y.z", …]` — これらのバージョンをスキップする;アップデーターはリストされていない次に公開されたバージョンにステップダウンする。 +- `pinned: "x.y.z"` — アップグレードの上限:このバージョンを超える自動アップグレードは決して行われない(実行中のインストールを強制ダウングレードすることは決してない;ロールバックは依然としてアドバイザリーの役割である)。`null` = ピンなし。 + +セキュリティ境界:このファイルは、アップグレードする *タイミング* と、スキップまたはピンする *公開バージョン* を制御するのみであり、インストールされる *バイト* を決して制御しない。インストールソースは npm レジストリの dist-tag 解決のまま;実際に公開されていないバージョンである `blocked`/`pinned` の値はログ行とともに無視される。状態はユーザーに見える:凍結 / ピン / スタグダー中、`/__bili/status` は `updatePolicy`(`source`, `hold`, `pinned`, `blocked`, `plannedUpgrade`)を報告し、ログにもその旨が記載される。終了条件:手動の `bili update` は `hold` と stagger をバイパスする(ただし `blocked`/`pinned` は依然として尊重される)、`ACP_AUTO_UPDATE=0` は自動更新を完全に停止し、`0`/`0` の stagger はマシンごとにレガシーのタイミングを復元する。 +### `diagnostics` + +- **Type:** `{ dumpBody?: boolean; dumpReq?: boolean; rawDumpDir?: string; dump4xx?: boolean; dump4xxMaxBytes?: number; maxTotalBytes?: number; maxAgeDays?: number; renderNone?: boolean; invariantJudge?: boolean; noInjectTool?: boolean; noCompressPrompt?: boolean; countTokensPassthrough?: boolean; compressProtocol?: "tools" | "text" }` +- **Default:** `{ dumpBody: false, dumpReq: true, rawDumpDir: /raw, dump4xx: false, dump4xxMaxBytes: 2097152, maxTotalBytes: null, maxAgeDays: null, renderNone: false, invariantJudge: true, noInjectTool: false, noCompressPrompt: false, countTokensPassthrough: false, compressProtocol: "tools" }` +- **Status:** ACTIVE +- **Description:** 以前は環境変数のみで制御されていたデバッグ/診断用トグル(`ACP_DUMP_BODY`, `ACP_DUMP_REQ`, `ACP_RAW_DUMP_DIR`, `BILI_DUMP_4XX`, `BILI_DUMP_4XX_MAX_BYTES`, `ACP_RENDER_NONE`, `ACP_NO_INJECT_TOOL`, `ACP_NO_COMPRESS_PROMPT`, `ACP_COUNT_TOKENS_PASSTHROUGH`, `ACP_COMPRESS_PROTOCOL`)。`compressProtocol` は起動時に一度だけ解決される(環境変数と同様)が、それ以外はリクエストごとにライブで読み込まれる(再起動不要)。`renderNone` を設定すると、送信履歴への `mNNNNN` レンダリングタグの注入が停止する。リファレンスベースの圧縮を必要としないワークフローの場合のみ無効化すること(#933)。保持期間の上限(#2412): ダンプディレクトリはデフォルトでは書き込み専用でローテーションなし。アクティブなボディ/SSEキャプチャは約 63 GB/日と測定されており、数日でディスクを埋め尽くす可能性がある。`maxTotalBytes` および/または `maxAgeDays` を設定して上限を設けること(古いものから削除、`err-*`/`summary-err-*` のインシデントダンプは保護対象、削除は warn レベルでログ出力)。両方未設定の場合は無制限の保持となる。詳細は[環境変数テーブル](#config-file-keys-for-environment-knobs-2030)を参照。 + +### `fakeCompletion` + +- **Type:** `{ retries?: number; bufCapBytes?: number }` +- **Default:** `{ retries: 0, bufCapBytes: 16777216 }` +- **Status:** ACTIVE +- **Description:** ストリーム途中で中断するホスト向けのフェイクコンプリーションのセーフティネット(#371)— **オプトイン**方式で、`retries: 0`(デフォルト)は #371 以前のパススルー動作。`bufCapBytes` はバッファリングされたレスポンスに対する OOM ガード。`BILI_FAKE_COMPLETION_RETRIES`, `BILI_FAKE_BUF_CAP` と対応。 + +### `codexCompact` / `ccrRetrievalTtlMs` / `decompressTmpCap` + +- **Type:** `string` ("intercept" | "pass") / `number` / `number` +- **Default:** `"intercept"` / `600000` / `50` +- **Status:** ACTIVE +- **Description:** トップレベルのスカラー値。`codexCompact`: bili が codex ネイティブ圧縮リクエストをインターセプトしてローカル ACP ハンドオフを偽造するか、それともアップストリームにパスするかを決定する(対応変数 `BILI_CODEX_COMPACT`。リクエストごとに読み込まれるため、どちらの階層でも再起動なしで切り替え可能)。スコープ(#3008): インターセプトは明示的な形式(`/compact` トリガーアイテムと `POST /responses/compact`)と、通常のターンとして通過するインライン自動圧縮(SUMMARIZATION_PROMPT テンプレートで検出)をカバーする。ユーザーが上書きした compact_prompt は検出から除外され、そのまま通過する。bili が観察のみした圧縮(pass モード / ゲート拒否)は、圧縮後の履歴に事後ベースで再設定される(#2372)。`ccrRetrievalTtlMs`: キューイングされたが未配信の `acp_retrieve` 注入の有効期限。期限切れ時は明示的に破棄される(対応変数 `BILI_CCR_RETRIEVAL_TTL_MS`。`0` で無効化)。`decompressTmpCap`: 並行実行可能なデコンプレッション一時ファイルの最大数(対応変数 `BILI_DECOMPRESS_TMP_CAP`)。 + +既存のブロックを拡張する #2030 のキーがさらに 3 つある: [`mitm.handshakeTimeoutMs`](#client-integration)(デフォルト `10000`、対応変数 `BILI_MITM_HANDSHAKE_TIMEOUT_MS`)、[`compat.noCacheControl`](#compat)、および [`compat.keepResponseId`](#compat)。 + +--- +## プロバイダー + +`providers` ブロックは、**アップストリーム URL** をプロバイダーごとの設定にマッピングします。各キーは URL プレフィックスであり、各値はモデルのコンテキストウィンドウ、プロバイダーごとのプロキシ、圧縮プロトコル、ワイヤープロトコルの宣言、圧縮のオーバーライド、画像課金モード、ルートごとのパススルー、クライアント側の直接接続の免除、およびレーン認証情報のオーバーライド([`apiKeyEnv`](#lane-credentials-apikeyenv--credentialref))を宣言できます。URL 以外の**名前付き**キーも許可されています:それらは単独ではルーティングに無効ですが、[`bind`](#named-provider-entries-bind) を通じて実際のレーンになります。 +```jsonc +{ + "providers": { + "https://api.anthropic.com": { + "models": { + "claude-sonnet-4-5": { "context": 200000, "output": 8192 } + }, + "proxy": "http://10.0.0.1:7890", + "compressProtocol": "tools", + "compress": { "maxContextLimit": "70%" } + }, + "https://relay.example.com/my/custom/complete": { + "protocol": "openai" + } + } +} +``` + +### URL キーのマッチング + +キーは、リクエストのアップストリーム URL に対して**最長プレフィックス優先**でマッチングされます。リクエスト URL がキーと等しい場合、または `key + "/"` で始まる場合にキーがマッチします。これにより、マッチングは境界安全になります:キー `https://api.example.com` は `https://api.example.com/v1/chat` にマッチしますが、`https://api.example.com.evil`(攻撃者制御の類似ホスト)にはマッチし**ません**。 + +浅いキー(`https://open.bigmodel.cn`)は、そのホスト上のすべてのパスにマッチします。深いキー(`https://open.bigmodel.cn/api/anthropic`)は、そのエンドポイントのみをマッチします。2 つのキーが両方ともマッチする場合、より長い(より具体的な)方が優先されます。キーの末尾スラッシュは自動的に除去されます。 + +**アップストリームがどのキーにもマッチしないリクエストには、プロバイダーごとのオーバーライドは適用されません。** リクエスト URL が上記のどのキーにもマッチしない場合、そのリクエストはレジストリ/グローバルのデフォルトのみで実行されます — その `models..context`、`compress.modelContextLimit`、プロキシ、プロトコルなどはすべて無言で無視されます。一般的な罠は、ピン留めが旧ホストのキーの下にある間に、クライアントを*別のリレーホスト*に切り替えることです:新しいホストはルートミスとなるため、旧キーの下で設定したものは決してそこに到達しません。#2317 以降、これは無言ではなく明示的になりました — bili は (upstream, model) ごとに 1 回だけ、既知のキーを特定する `[route]` 警告をログに記録し、`[window]` / codex-clamp の行に `upstream=<…> route=miss` をスタンプし、ウィンドウ超過ペイロードに対するプリフライト 502 は `compress.modelContextLimit` を再設定するよう指示するのではなく、欠落しているキーを指し示します。新しいホスト(または URL プレフィックス)にオーバーライドを適用するには、`providers` エントリを追加してください。これらの行のエンドポイントは、ログのホストマスキング(`BILI_LOG_MASK_HOSTS`)と整合性を保つため、そのまま出力されるのではなくフィンガープリント化(``)されます。 + +### MITM と `/bili/` キースキーム + +ログインクライアント(MITM 経由の ZCode)と API キークライアントは、同じホスト(`open.bigmodel.cn`)にアクセスできます。それらの設定を異ならせるために、MITM トラフィックはプロバイダー検索キーで `mitm://` スキームを使用し、`/bili/` トラフィックは実際の `https://` を使用します: + +| クライアント | 検索キーの例 | +|---|---| +| ZCode (MITM, ログイン) | `mitm://open.bigmodel.cn` | +| API キークライアント (`/bili/`) | `https://open.bigmodel.cn/api/anthropic` | + +したがって、API キークライアントに影響を与えることなく、ZCode に独自のアップストリームプロキシを与えることができます: + +```jsonc +{ + "providers": { + "mitm://open.bigmodel.cn": { "proxy": "http://127.0.0.1:20173" }, + "https://open.bigmodel.cn/api/anthropic": { "proxy": "http://127.0.0.1:20172" } + } +} +``` + +2 つのスキームは決して重複しません:`mitm://` キーはそのホストの MITM(ログインクライアント)トラフィックのみを対象とし、プレーンな `https://` キーは `/bili/`(API キー)トラフィックのみを対象とします。 + +### 名前付きプロバイダーエントリ(`bind`) + +URL ではないキー(例:`"claude-bridge"`)は**名前付き**エントリです。単独ではルーティングに無効です — 最長プレフィックスマッチングは決してそれにはヒットしません — かつ、[`compactionOptIn`](#compactionoptin) のようなエージェント側のアイデンティティのみを保持します。`bind` フィールドがあると、別のレーンの純粋な**エイリアス**になります: + +- **型:** `string` — エイリアス化するレーンの http(s) ベース URL。 +- 解決は**完全に設定読み込み時**に行われます:エントリのルーティングフィールド(`compress`、`models`、`proxy`、`passthrough`、`compressProtocol`、`compat`、`imageBilling`、`imageTokenCap`、`protocol`)はバインドされた URL のルートにディープマージされ、その URL キーの下に書かれたかのように正確に適用されます。名前自体はリクエストパスやワイヤー上には決して現れません;プロキシは単一の URL プレフィックスルーティングを維持します。 +- **優先順位(フィールドごと):** 明示的な URL キーエントリはすべてのエイリアスフィールドに優先します;ソース間で、外部の `ACP_PROVIDERS` ファイルはすべてのレベルでインライン設定に優先します(エイリアスはソース順に折り畳まれ、最初に設定されたものが優先されます)。オブジェクトはキーごとにマージされます;配列/スカラーは勝者から丸ごと取得されます — 要素ごとのマージはありません。 +- `bind` がないがルーティングフィールドを保持している名前付きキーはデッド設定です:bili は起動時に警告をログに記録し、キーと無効なフィールドを特定します(「`bind` を追加するか、これらを URL エントリの下に移動してください」)無言で無視する代わりに。無効な `bind` 値(非文字列、非 http(s) URL)は警告し、エントリを無効のままにします;URL キーでの `bind` は警告し無視されます(キーはすでにレーンです)。 + +```jsonc +{ + "providers": { + "claude-bridge": { + "bind": "https://api.anthropic.com", + "compactionOptIn": true, + "compress": { "maxContextLimitPct": 0.75 } + } + } +} +``` + +### レーン認証情報(`apiKeyEnv` / `credentialRef`) + +URL キー付きレーン(または `bind` を持つ名前付きエントリ)は、クライアントのものではなく**独自の**認証情報をアップストリームに送信できます — レーン所有者のキーが、エージェントクライアントがワイヤー上に置いたものを置き換えます(#2336)。典型的なケース:共有マシンプロキシで、所有者の `deepseek` レーンは、どのクライアント(およびその個人キー)がそれを介して通信しても、所有者のキーで認証します。 + +```jsonc +{ + "providers": { + "https://api.deepseek.com": { "apiKeyEnv": "DEEPSEEK_LANE_KEY" } + } +} +``` + +- **型:** `string` — `apiKeyEnv` は環境変数の名前(`env:VAR` セマンティクス)、`credentialRef` はプライベートな[サマリー認証情報ストア](#shared-external-summary-service)内の名前(`secret:NAME` セマンティクス)です。エントリごとにちょうど 1 つ;無効な値は設定を拒否します(#1909 の規律 — 起動失敗 / Web UI 400)。 +- **置換ルール:** `x-api-key` と `x-goog-api-key` は完全に置き換えられます。`authorization` は、クライアントの値が Bearer トークンの場合**のみ**置き換えられます — その他のスキーム(SDK-HMAC 署名、mTLS フィンガープリント…)は署名所有であり、警告とともにそのままにされます。3 つのいずれも保持していないリクエストには `authorization: Bearer ` が付与されます。 +- **#1884 の相互作用:** リクエストで CodeArts 再署名アームがアクティブな場合は常にスキップされます — 再署名者がそこに `Authorization` を所有するためです。 +- **失敗時の姿勢:** 環境変数が未設定またはシークレットが存在しない場合、bili はクライアント自身のヘッダーを保持し、レーン+参照ごとに 1 回警告します(可視的であり、保証された 401 に無言で劣化することはありません)。警告は成功した解決後に再アームされます。 +- 共有フォワードヘッダーセットに一度適用されるため、リクエストのすべての出口 — 初期送信、ロールラダーリトライ、オーバーフローリフォールド、圧縮ループラウンド、継続リフェッチ — がレーン認証情報を保持します。 +### ルートレベルの k̂ 校正ポリシー + +- **型:** `object` — `{ "disabled"?: boolean, "max"?: number }`; 少なくとも 1 つのキーが必要 +- **デフォルト:** *(未設定 — 学習された k̂ が修正なしで適用される)* +- **ステータス:** ACTIVE +- **説明:** 使用量レポートが誠実なトークナイザのスケールを超えて膨張するアップストリーム向けの、ルートごとのエスケープハッチ (#3211: リレーのマークアップ / トークン以外の集計により k̂ ≈ 1.86–1.97 が学習され、決定メーターが永続的にプレッシャーバンドに固定される — このバンドは成長ゲート + キャデンスをバイパスするため、数千トークン単位の保留分が蓄積するたびに、ラインを下回る程度に回復する別のフォールドがトリガーされ、高頻度で小規模な変動(チャーン)が発生する)。使用量ストリームのみでは、bili は本当に高密度なトークナイザと膨張したレポートを区別できないため、このポリシーはルートごとにオプトイン方式であり、k̂ の公開(PUBLICATION)時に適用される — 学習されたリングは監査のために `stats.calibrationRing` に生データのまま保持され、変更されるのは適用係数 (`stats.calibratedEstimate`) のみである: + - `"disabled": true` — このルートでは学習された係数を絶対に適用しない; 決定メーターはローカル推定値の生データで動作する。 + - `"max": ` (0 < max ≤ 4) — 適用係数を ≤ max にクランプする。`1` = 縮小の学習のみを許可(膨張は許可しない): ローカル推定値よりわずかに少ない金額で請求している誠実なルートでも、その修正から恩恵を受ける。 + - 両方を設定可能; `disabled` が優先される。 + マッチングは、他のプロバイダーフィールドと同様に、最長 URL プレフィックスルールに従う(パススコープのキーを含む)。効果は、そのルートの次の k̂ 公開時に発効する(≤ 3 回の確定ターン); ポリシーを削除すると、次の公開時に学習された値が復元される。無効な値(型エラー、空オブジェクト、(0, 4] 範囲外の `max`)は、設定の読み込みを明確に拒否する。 + +### `models` + +- **型:** `Record` +- **デフォルト:** *(なし)* +- **ステータス:** ACTIVE +- **説明:** モデル名をそのコンテキストウィンドウ宣言にマッピングする。LLM の `/models` エンドポイントはコンテキストウィンドウを返さない(OpenAI、Anthropic、zhipu、comfly で検証済み)ため、プロキシは実行時にそれらを発見できない。`context` はトークン単位のモデルのコンテキストウィンドウ; `output` は最大出力サイズであり、リクエストに出力予算フィールドが全くない場合の出力ヘッドルームのフォールバックとして機能する([`outputHeadroomMaxPct`](#outputheadroommaxpct) を参照)。また、#546 の出力予算復元にも下限として機能する: クライアント自身の `max_tokens` がツールを持つメインリクエストで ≤ 200 に飢餓状態になった場合、プロキシはそれをセッションの最後の健全な予算に復元し、その復元ターゲットはモデルの既知の最大出力上限で下限が設定される — クライアント報告の実行時情報 > ランチャーチャネル > この宣言値 > models.dev レジストリ一覧 (#1665/#1840)。どのソースもモデルの出力上限を知らない場合、プロキシはモデルごとに一度だけ警告をログに記録する: その場合、復元はクライアントの最後の非飢餓値にのみ依存し、最大トークン数で長いセッションが切り詰められる可能性がある。 + + **解決順序(最初の一致が優先):** (1) リクエストごとのソース — クライアントの `anthropic-beta` による大規模コンテキスト交渉、協調プラグインの報告、ランチャーのモデルごとのウィンドウ; (2) このモデルごとの `context` 宣言; (3) モデルがリストされている場合の **ウォーム** な models.dev レジストリキャッシュ(リレー/プライベートホストは、レジストリのプロバイダー接頭辞付きエントリに対して素のモデル名を照合する); (4) 組み込みコンテキストテーブル。したがって、このモデルごとの `context` 宣言は **レジストリより優先される** — リレー/プライベートデプロイメントが実際に提供するウィンドウに設定すれば、models.dev がモデルに対して異なる(通常はより大きな)ウィンドウをリストしていても、こちらが優先される。すべてのルートでウィンドウを固定したい場合、`compress.modelContextLimit` が最優先ソース(常に優先)として残る。各モデルエントリには、モデルごとの `compress` ブロック([圧縮チューニング](#compression-tuning) を参照)および #1884 の再署名アームのモデルレベルノブ: `benefit: true | false` — このモデルが CodeArts の無料クォータに対して請求されるかどうか(その再署名リクエストは署名済み `maas_type: benefit` ヘッダーを持つ; 環境変数 `BILI_RESIGN_BENEFIT` がツリー全体に対して優先され、未設定の場合は組み込みの `glm-5.3-flash, deepseek-v4.1-flash` セットにフォールバックする)— を持つことができる。 + + 組み込みコンテキストテーブル(ステップ 4)はリリースごとに同梱される静的データであり、古くなる可能性がある — 例えば、DeepSeek の正規リクエスト ID `deepseek-flash` は models.dev にその名前でリストされていない(そのウィンドウは `deepseek-v4-flash` の下にリストされている)ため、テーブルのみが回答していた (#852)。ログはどのソースが優先されたかを記録し、プロセスごとにモデルごとに一度だけ(`[window] ... fallback=true` は値が組み込みテーブルから来たことを意味する)。解決されたウィンドウが誤っているように見える場合、上記のように `models..context` を宣言する — レジストリとテーブルの両方より優先される — または `compress.modelContextLimit` を固定する; そして、プロバイダーキーはトラフィックのスキームを持たなければならないことを忘れないでください(MITM ログインクライアントトラフィックには `mitm://`、`/bili/` トラフィックには `https://`)。 + +### `proxy` + +- **型:** `string` +- **デフォルト:** *(トップレベルの `proxy` を継承)* +- **ステータス:** ACTIVE +- **説明:** プロバイダーごとのアップストリーム HTTP プロキシ (`http://host:port`)。このプロバイダーに対してのみ、トップレベルの `proxy` を上書きする。空文字列は「明示的に直接接続」を意味し、この 1 つのプロバイダーに対してプロキシなしでグローバルプロキシを上書きする。 + +### `compressProtocol` + +- **型:** `"tools" | "marker"` +- **デフォルト:** `"tools"` +- **ステータス:** ACTIVE +- **説明:** 圧縮ツールをリクエストに注入する方法。`"tools"`(デフォルト)は、ネイティブな関数呼び出しツールとして注入する。`"marker"` は代わりにテキストトリガープロトコルを使用する — 宣言された `tools` フィールドと共存できないアップストリームに使用する。 + +### `protocol` + +- **型:** `"anthropic" | "openai" | "responses" | "google"` +- **デフォルト:** *(なし — リクエストパスから推論)* +- **ステータス:** ACTIVE +- **説明:** このレーンのワイヤプロトコルを宣言する (#1909)。組み込みサフィックステーブル(`/chat/completions`, `/messages`, `/responses`, Google パス)に一致しないエンドポイント向け。2 つの粒度: 素のホストキー (`"https://relay.example.com": { "protocol": "openai" }`) は、そのホスト配下のすべてのボディ付き POST をカバーする; パスキー (`"https://relay.example.com/my/custom/complete": { "protocol": "openai" }`) は、そのサブツリーのみをカバーする。これは、クライアント側の `/bili//` エスケープハッチのサーバー側対応であり、ベース URL を変更できないクライアント(カスタムエンドポイントパスを持つリレー、MITM 拦截されたホスト)をカバーする。優先度: `/bili//` の明示的マーカーは **宣言より優先され**、宣言は組み込みサフィックステーブルより優先される。宣言はリクエストを *識別* するだけであり、セーフティネットを緩和しない: 宣言されたプロトコルとしてパースできないボディはそのままリレーされる (#1284)、ボディのない GET は決して宣言されたプロトコルにはならない。 + + **クライアント側対応 — `/bili//` エスケープハッチ:** クライアントのベース URL を *制御* できるが、エンドポイントパスが非標準である場合、設定を完全にスキップしてプロトコルを URL 自体に含める: + + ```text + http://127.0.0.1:8787/bili/openai/https://relay.example.com/api/custom/complete + ``` + + `` ∈ `anthropic` | `openai` | `responses` | `google`。パスに関係なくワイヤプロトコルを強制し、すべてのサーバー側宣言(および組み込みサフィックステーブル)より **優先される**。プロトコルセグメントなしのプレーン形式 (`/bili/`) は変更なし: プロトコルは依然としてパスから推論される。クライアントごとに URL 形式を使用し、ベース URL を変更できない場合(ハードコードされたエンドポイント、MITM 拦截されたホスト)は、レーンごとにこの `providers.protocol` フィールドを使用する。 + + **シャドウイングなし (#1909):** `protocol` は他のプロバイダーフィールドとは独立して解決される — すべての一致キーが最長プレフィックス優先でスキャンされ、`protocol` を *明示的に宣言* した最も深いキーが優先されるため、ホストキーの宣言はサイレントなパスキーの下でも適用され続ける(重複は不要)。*他の* フィールドは、既存の単一エントリ最長キーセマンティクスを維持する: すべてのパスキーと同様に、プロトコル専用のパスキーはそのサブツリーの下で勝利するエントリとなるため、URL スコープのフィールド(`compress`, `models`, …)のホストレベルの値は、パスキーで繰り返されない限り、そのサブツリーには到達しない。1 つの例外: `compressProtocol` はアップストリームオリジンに対してのみ解決されるため、そこではパスキーがホストレベルの値をシャドウすることはできない。`protocol` を含まないパスキーは、依然としてルーティング設定にすぎない; `mitm://` キーは他のすべてのフィールドと同様のスキーム分割に従う。無効な値は設定の読み込みを明確に失敗させる(Web 保存は 400 を返す)。 + +### `compress` + +### `compat` + +- **型:** `{ roles?: Record; dropFields?: string[] }` +- **デフォルト:** `{}` (無効) +- **ステータス:** ACTIVE +- **説明:** プロバイダーごとのワイヤ互換性オーバーライド。`roles` はメッセージロールを、このアップストリームが受け入れるロール名にマッピングする。例えば、新しい codex クライアントが送信する `developer` ロールを拒否するアップストリーム向けに `{"developer": "system"}` (#552)。最終的に転送される `openai`/`responses` ボディ(クライアント送信のロールと、bili 自身が注入したプロンプトの両方)および、compress-retry ループが再送信するすべてのボディに適用される。グローバル `compat` ブロック([サーバー設定](#server-settings) を参照)に対してキーごとに優先される。`dropFields` は、厳格なスキーマのアップストリームが拒否するクライアント固定フィールドを削除する (#1757): ドットパスのプレーンオブジェクトパス(ワイルドカード/インデックスなし)、グローバルリストと **加法的に** マージされる(プロバイダーはパスを追加できるが、グローバルなものを撤回することはできない); 構造的な削除のみ — 文字列値は変更されず、存在しないパスはスキップされ、何も一致しない場合はバイト単位でそのまま転送される。正規ケース — SenseNova の Responses ゲートウェイは、pi-ai の固定 `reasoning.summary: "auto"` で 400 を返す: + + ```jsonc + { + "providers": { + "https://token.sensenova.cn/v1": { + "compat": { "dropFields": ["reasoning.summary"] } + } + } + } + ``` + +### `passthrough` + +- **型:** `boolean` +- **デフォルト:** *(なし — 圧縮が有効)* +- **ステータス:** ACTIVE +- **説明:** グローバル [`passthrough`](#passthrough) 設定のルートごとのオーバーライド。`true` の場合、このルートに一致するすべてのリクエストは **バイト単位でそのまま** 転送される: カーネル往復なし(メッセージの再シリアライズなし、ACP レンダリングタグなし、`prompt_cache_key` の削除なし)、レスポンスはそのままパイプされ、そのルートに対してセッション状態は作成されない。bili が書き換えたボディを拒否する不正アクセス防止フィンガープリンティングを持つアップストリームに使用する — 例えば、カーネル再構築された `messages` ボディに対する ZCode の `405 / 3012`(「異常な活動のためリクエストがブロックされました」)(#661)。`mitm://` キーはそのホストの MITM(ログインクライアント)トラフィックのみを対象とし、プレーンな `https://` キーは `/bili/`(API キー)トラフィックのみを対象とする — 2 つのスキームは決して重複しない: + + ```jsonc + { + "providers": { + "mitm://zcode.z.ai": { "passthrough": true } + } + } + ``` +### `direct` + +- **Type:** `boolean` +- **Default:** *(なし — ルートは bili を経由する)* +- **Status:** ACTIVE +- **Description:** クライアントサイドルーティングの例外 (#1622): `true` の場合、このアップストリームは**クライアントサイドで**決して bili を経由しない。ストア書き換えネイティブレーン(現在は ZCode)は、プロバイダストアのエントリをラップする代わりにマッチしたエントリをスキップするため、トラフィックはクライアント → アップストリームへ無加工で流れる — [`passthrough`](#passthrough) とは異なり、プロキシで終端しない。他のすべてのプロバイダフィールドと同様に、最長 URL プレフィックスルールでマッチするため、どのレーンでも同様に適用できる。クライアントの実際のオリジンを確認する必要があるアップストリーム(例: リクエスト署名がオリジンから導出されるアカウント)や、このマシンの bili を経由させたくないプロバイダに使用すること: + + ```jsonc + { + "providers": { + "https://api.moonshot.cn/v1": { "direct": true } + } + } + ``` + +### `imageBilling` + +- **Type:** `"auto" | "pixels" | "bytes"` +- **Default:** *(グローバル `imageBilling`、次に `"auto"`)* +- **Status:** ACTIVE +- **Description:** サイズゲートによるインライン画像の課金方法のルート別オーバーライド (#767/#1843)。バイトカウント方式のリレーには `"bytes"` を設定する — バイト課金では、古いウィンドウ外のベースラインと大きな base64 スクリーンショットにより、アップストリームでは画像が数千トークンしか課金されないにもかかわらず、プリフライトが永遠に 502 で失敗する。これがまさに、未知のホストに対するデフォルトではなく、明示的なオプトインとして `"bytes"` が扱われる理由である。両レベルで未設定の場合、すべてのホストに対して課金は `"pixels"` に解決される (#1843: ピクセル事前分布 — スクリーンショットあたり約 1k–3k トークン — はすべてのビジョンエンコーダにとって適切な桁数であり、旧来のバイトデフォルトは非 OpenAI アップストリームで最大 15 倍の誤差があった)。`BILI_IMAGE_BILLING` 環境変数は両方の設定レベルをオーバーライドする: + + ```jsonc + { + "providers": { + "https://relay.example.com/v1": { "imageBilling": "bytes" } + } + } + ``` + +### `imageTokenCap` + +- **Type:** 正の整数 (1 画像あたりのトークン数) +- **Default:** *(グローバル `imageTokenCap`、次に未設定 — 上限なし)* +- **Status:** ACTIVE +- **Description:** 1 画像あたりのトークン推定値のルート別上限 (#1843)。このルートで解決された課金モードの上に適用される。グローバル `imageTokenCap` より優先される。`BILI_IMAGE_TOKEN_CAP` 環境変数は両方より優先される。数値でないか正でない値は破棄される (寛容なパース、`imageBilling` と同じ)。 + +--- +## モデルエンドポイントパターン + +`modelEndpointPatterns` は、非標準パス上のモデルエンドポイントを宣言します。これは、組み込みのワイヤファミリーのいずれにも該当しないパス形状を持つ URL(例: `https://api.commandcode.ai/alpha/generate`)を指します。宣言がない場合、そのようなリクエストはゼロ圧縮でバイト単位そのままリレーされます(#1290)。宣言がある場合、両方のゲートがこれらについて合意します。クライアント側のフェッチパッチがリクエストを主張し、プロキシが宣言されたワイヤファミリーに分類します。 + +- **型:** `{ "match": string, "wire": "anthropic" | "openai" | "responses" | "google" | "commandcode" }` の配列 +- **デフォルト:** `[]`(組み込みパステーブルのみ) +- **ステータス:** ACTIVE +- **説明:** 各エントリは、絶対 URL プレフィックスと、それをどのワイヤファミリーとして扱うかの指定です。最長一致プレフィックスが優先されます。一致には、同一オリジンとパスセグメント境界が必要です(`…/alpha/generate` は自身とサブパスには一致しますが、`…/alpha/generate2` には一致せず、他のオリジンには決して一致しません)。1 つの設定ソースが、すべてのネイティブエントリにおいてプロキシのプロトコル分類器とクライアント側のフェッチ主張の両方に供給されるため、以前はハードコードされていた 2 つのテーブルが乖離することはなくなります(#1295)。パス書き換えを行うプロバイダーでは、2 つのゲートが異なる URL に一致することに注意してください。クライアント側の主張はクライアントが呼び出した URL に、プロキシの分類器はルート書き換え後の URL に一致します — **リクエストが実際に到達する URL を宣言してください**(`upstreamPath` 書き換えがある場合、それは書き換え後のパスです)。ユーザー情報(`https://user:pass@host/…`)は起動時に明確に拒否され、`search`/`hash` コンポーネントも同様です。ボディベースの曖昧さ解消は依然として適用されます(#1284):モデル会話のように見えないボディを持つ宣言済みエンドポイントはそのままリレーされ、変換可能なストリーミング CLI 会話でない `commandcode` ボディも同様です([wire-contracts.md](wire-contracts.md))。4 つの標準ファミリーは分類のみを変更し、そのパイプラインは変更なしで実行されます。`commandcode` は commandcode CLI ワイヤです:openai-completions 形状の会話の周りにネストされたエンベロープで、生の JSONL イベントストリーム応答を持ちます。ストリーミングリクエストは OpenAI ファミリーループを通じて圧縮されます(プロキシモードとプラグインモードの両方)、非ストリーミングリクエストはそのままリレーに降格されます。宣言はプロセス起動時に読み込まれます — 変更を適用するには bili(およびエンドポイントの主張が必要なフェッチパッチを持つネイティブクライアント)を再起動してください。不正なエントリは静かに破棄されるのではなく、起動時の明確な失敗となります。 + + ```jsonc + { + "modelEndpointPatterns": [ + { "match": "https://api.commandcode.ai/alpha/generate", "wire": "commandcode" } + ] + } + ``` + +--- + +## 圧縮チューニング + +圧縮の動作は `compress` ブロックによって制御され、3 つのレベルで出現できます。これらは**フィールド単位で、最も深いレベルが優先**してマージされます:より深いレベルで設定されたフィールドは、上位の同じフィールドを上書きしますが、より深いレベルで*未設定*のフィールドは、上位で設定された値をクリアすることはありません。つまり、子ノードはフィールド単位で親ノードをカバーし、オブジェクト全体を置き換えることはありません。 + +### 共有外部サマリーサービス + +任意の `compress.externalSummary` ブロックは、圧縮サマリーを個別に設定された 1 つ以上のモデルに送信します。他のすべてのフィールドと同様に、このブロックは 3 つの `compress` レベルすべてに存在し、チェーン全体のセマンティクスを持ちます:より深いレベル(プロバイダーまたはモデル)で設定されたチェーンは、それより上位の**チェーン全体を置き換えます** — `tiers` と全く同じように、ターゲット別や予算別の部分マージはありません。`enabled` が `true` でない限り無効です。有効な場合、ターゲットは順序通りに試みられ、失敗または使用不能なターゲットは次のものにフォールスルーします。メインリクエストのプロバイダー、モデル、認証情報は、これらの呼び出しのために再利用されることはありません。この機能は圧縮ツール契約を変更し、`summary` を任意の非権威的なヒントにします。プロキシは元のメッセージを復元可能な状態に保ち、検証された返されたサマリーのみをコミットします。会話モデルがコミットされたサマリーを書き込まなくなったため、チェーンが有効な間、注入される圧縮プロンプトはサマリー作成ルール(`HOW TO COMPRESS`、`KEEP VERBATIM`、`DROP`、`PRIORITY`)とサマリーごとの長さ予算を削除します。サマリーリクエスト自体は依然として完全なルールを持ちます(#4460)。 + +ターゲットは **`providers` テーブルへの参照**です:各エントリは文字列 `"provider/model"` で、`provider` は*名前付きプロバイダーレシピ*(ダイヤルフィールドを持つ非 URL の `providers` エントリ)であり、`model` はその `models` マップのキーです。エンドポイント、プロトコル、認証情報はレシピから導出され、ターゲットごとに URL を繰り返す必要はありません: + +```json +{ + "providers": { + "glm": { + "baseUrl": "https://open.bigmodel.cn/api/paas/v4", + "api": "openai", + "apiKeyEnv": "GLM_API_KEY", + "models": { "glm-4.9-flash": { "outputTokens": 4096 } } + }, + "claude": { + "baseUrl": "https://api.anthropic.com", + "api": "anthropic", + "credentialRef": "primary", + "models": { "claude-haiku-4.5": {} } + } + }, + "compress": { + "externalSummary": { + "enabled": true, + "targets": ["glm/glm-4.9-flash", "claude/claude-haiku-4.5"], + "budget": { "totalTimeoutMs": 50000, "targetTimeoutMs": 25000, "maxSummaryBytes": 65536 }, + "concurrency": 8, + "autoFold": true, + "autoFoldTargetTokens": 40000 + } + } +} +``` + +レシピには以下が含まれます:`baseUrl`(HTTPS。ローカル開発用にループバック HTTP を許可。埋め込み認証情報、プロキシ再帰パス、任意のクエリパラメータは不可)、`api`(`openai` | `anthropic` | `responses` | `google` のいずれか。ワイヤプロトコルを選択し、`baseUrl` からリクエストパスを導出)、認証情報参照はちょうど 1 つ — `apiKeyEnv: "VAR_NAME"`(呼び出し時に読み込まれる環境変数)または `credentialRef: "NAME"`(Web UI 経由で保存された値)—、そしてモデルごとのフィールドを持つ `models` マップ。モデルごとのフィールドは `contextWindow`(デフォルト 128000)、`outputTokens`(デフォルト `min(8192, window/4)`)、`stream`(デフォルト false)です。レシピは URL エントリと同様に `recipe`/`bind` ルーティング形式に分割することもでき、名前付きエントリはバインドされない限りルーティング無効です。 + +チェーンあたり最大 16 個のターゲットがサポートされます。Web API 経由で有効なチェーンを保存すると、すべての参照が解決できることが検証されます(不明なプロバイダーまたはモデル → HTTP 400)。実行時に解決できない参照は 1 回ログに記録され、修正されるまでチェーンが無効になります — メインモデルでのサマリー化にフォールバックすることはありません。`secret:` 値は、メインの JSON 設定とは別に、プライベートな `billion-context.json.summary-credentials.json` ファイルに保存され、設定 API によって返されることはありません。Windows では、このファイルとその親ディレクトリを管理者専用の ACL で保護してください。古い `.lock` ファイルは、プロキシプロセスがストアに書き込んでいないことを確認した後、手動で削除する必要があります。総予算はすべてのターゲットと圧縮エントリポイント間で共有され、キャンセルまたはセッション状態の変更は、折りたたみ(フォールド)せずに生成された結果を破棄します。エージェント側のプラグインブリッジ(dsh / pi / opencode / codex MCP)は、各 `compress` 呼び出しの HTTP 待機時間を `totalTimeoutMs` に小さなオーバーヘッドマージンを加えた値に設定します — ブートストラップ時にプロキシから学習 — したがって、この予算を引き上げても、長いフォールドが隠れた 60 秒のクライアント側タイムアウトで制限されなくなります(#2652)。 + +`concurrency`(整数 `1..32`、デフォルト `4`)は**プロセス全体のサマリーキュー**のサイズを決定します:このホスト上のすべての外部サマリー呼び出し — *すべての*セッションのプリフライト自動フォールドと、モデルが開始するすべての `compress` 呼び出し — は、実行中リクエストの 1 つのプールを共有します。サマライザーに余裕がある場合(ローカルリレー、セルフホストモデル、高クォータのフラッシュエンドポイント)には引き上げてください。小規模なプロバイダークォータでは保守的なデフォルトを維持してください。チェーンの値は、そのチェーンの作業が実行中である間のみ共有プールのサイズを変更します。異なる値を持つ複数のチェーンが並行して実行される場合、プールは最大の要求に成長し、それらのバッチが落ち着くとベースサイズに戻ります — 1 つのセッションが他のすべてのためにプールのサイズを永続的に変更することはできません。このノブは**成長のみ**であることに注意してください:1 つのセッションがプールのサイズを引き上げても、他のセッションの実行中作業をスロットリングしてはならないため、デフォルト未満の値(`1..3`)は検証のために受け入れられますが、プールを `4` 未満に縮小することはありません — クォータ保護を期待して低い値を設定しないでください。代わりに、チェーン自身の `budget`/`targetTimeoutMs` を設定してください。 + +予算との相互作用:バッチの達成可能なフォールドレートは、プール(`concurrency`)に収まる呼び出しの数と、各呼び出しが許容される時間(`targetTimeoutMs`)によって制限されます — 予算だけでは結果を制御できません。飽和したプールは可視的なエラーとして表面化しません:総期限が切れた時点でまだキューイングされているバッチは、試行が記録されず(`attempts=[]`)、`batch=deadline` として破棄され、フォールドパスは混雑の背後にさらなるラウンドをキューイングする代わりにそこで停止します。自動フォールドでは、これは一時的なスケジューラ混雑として扱われ、**チェーンの失敗ではありません**:10 分間のバックオフは設定されず、次のターンで(おそらく空になった)プールに再試行されます。ターゲットへの直接呼び出しが素早く成功しているのにこれらの行が見える場合、制約条件はタイムアウトではなくプールです。 + +期限セマンティクス(#4833):`targetTimeoutMs` はすべての単一ディスパッチに上限を設けます — 1 つの遅い呼び出しが `totalTimeoutMs` 全体を使い切ることはできません。1 ターゲットのチェーンであっても同様です(フォールスルー順序の各ターゲットは、共有総量から引き出される独自の新しい `targetTimeoutMs` ウィンドウを得ます)。期限が切れた場合、実行中の試行は中止され、**再試行されません**:有界リトライループ(`attempt 1/3`)は、一時的なプロバイダー判定(429/5xx/リスク管理ボディマーカー)とフェイルファストなネットワーク死のみを再ディスパッチします。期限による中止は試行を即座に終了します。失敗ログは、どのクロックが期限切れになったかを特定します:試行ごとの警告行にはソース — `target-timeout`、`batch-deadline`、または真のダウンストリームキャンセルのための `client-abort` — と安全な診断情報(経過時間、適用中の予算、ワイヤプロトコル/ストリームモード、ペイロードバイトサイズ、入力トークン推定値、出力文字数上限)が含まれ、`completed N/M range(s)` 行は各試行の詳細を記録します(`attempts=[t0:timeout (target-timeout 25000ms (elapsed 25002ms))]`)。`compress` 呼び出しが完全に失敗した場合、同じ診断情報がツール結果に乗ります。大規模コンテキストワークロードのサイズ設定:非ストリーミングサマリーは、最初のバイトが到着する前に完全な生成レイテンシを支払うため、`targetTimeoutMs` は、最大の予想入力に対する入力処理と完全なサマリー生成をカバーする必要があります — 数十万トークンは、遅いエンドポイントでは 25 秒のデフォルトを容易に超えます。大きなフォールドで `target-timeout` が見える場合、チェーンを無効にするのではなく、`targetTimeoutMs` を引き上げてください(そして、予想されるフォールスルー深度に対して `totalTimeoutMs` が十分大きくなるようにしてください)。 + +2 つの任意のノブが、チェーンを**プロキシ駆動の自動フォルダー**(`autoFold`)に変えます:`"autoFold": true` を設定すると、プロキシはモデルが圧縮ツールを呼び出すのを待たなくなります — オーバーフローウィンドウを保護するのと同じゼロモデルフォールディングエンジンが、外部チェーンとカーネル選択範囲を使用して、転送する*前に*会話を `autoFoldTargetTokens`(デフォルト:モデルウィンドウの半分)まで折りたたみます。モデルはナッジを見ることも、圧縮計画を作成するために思考トークンを消費することもありません。このノブはブロックの残りの部分と同様に、チェーン全体の置き換えセマンティクスを持ちます。チェーン自体が有効な間のみ効果が現れます — 無効(または `enabled` が省略された)チェーンにどちらかのノブを設定しても効果はなく、静かに失敗するのではなく、警告として 1 回ログに記録されます。`autoFoldTargetTokens` は `[8192, 10000000]` の範囲の整数でなければなりません。失敗はフェイルオープンです:フォールド時にチェーンがエラーになると、リクエストはそのまま転送され、10 分間のバックオフが自動フォールディングを抑制し、そのウィンドウの間は従来の助言ナッジが戻ります。1 つの例外(#2662):共有プールが飽和しているため、バッチは送信されたがサマリー呼び出しが一度もディスパッチされなかったことによる、純粋なキュードロップによるゼロ進捗フォールドは、スケジューラ混雑でありチェーンの失敗ではないため、バックオフを設定しません。自動フォールドは単に次のターンで再試行します。 + +自動フォールドの成長トリガーは利益ゲート付き(#3444)であり、単純な閾値超過ではありません:成長フォールドは、テキストチャネルが有効なターゲット予算を少なくとも **4096 トークン**超過した場合にのみ設定されます — ターゲットに達している(またはわずかに超過している)ペイロードは、固定コスト未満を節約するために完全な外部サマリー往復を消費するのではなく、そのまま転送されます。同じゲートはフォールド後にも適用されます:4096 トークン未満しか節約できない成長フォールドは、ゼロ進捗パスと同様に 10 分間のバックオフを設定します。画像中心のペイロードは免除されます(画像は折りたたみ可能ではないため、その超過分は「期待される利益」として扱われない)、従来のオーバーフローフォールディングは変更されません — そこでは発火が必須です。さらに、有効なターゲットには**測定された下限**があります:セッションの不可約化ベースライン(システムプロンプト + ツール定義 + ライブテール)が設定された `autoFoldTargetTokens` より大きい場合、ターゲットはその測定サイズに引き上げられ、警告が実際の数値を特定します — 到達不可能なターゲットは、それ以外の場合、すべてのリクエストで無駄なフォールドを再設定することになります。下限は、ターゲットをモデルウィンドウ以上には引き上げません。 + +#### エージェント報告プロバイダー(フォールバックレイヤー) + +ACP ネイティブエージェント(現在は `pi` 拡張機能)は、プロセスごとに 1 回、自身で設定されたプロバイダーをプロキシに報告します(`POST /__bili/agent-providers`):プロバイダー名、ベース URL、ワイヤプロトコル、解決された API キー、モデルリスト。これらのレシピは**フォールバックレイヤー**を形成します — チェーンは `"zhipu/glm-5"` を参照できますが、ファイル内でダイヤルフィールドを重複させる必要はありません。したがって、エージェント自身の設定で一度設定されたプロバイダーは、サマリーターゲットとして直接使用できます。マージ順序は**ファイル優先**です:同じ名前を持つファイルのレシピは、そのプロバイダーに対してエージェントの貢献を完全にシャドウします(モデルを含む)。エージェントレイヤーはディスクに永続化されません:キーはプロキシプロセスメモリ内にのみ存在し、設定 API によって返されることも、ログに表示されることもありません。報告側のスキップルール:OAuth 認証プロバイダー、`auth.json`("stored")認証情報、プロキシ自身を指すエンドポイントを持つプロバイダー、サマリーダイヤルのないワイヤプロトコル(`bedrock`、`vertex`、`mistral`、`pi-messages`)は報告されません。プレーン HTTP の非ループバック baseUrl も送信されません(サーバーはそれらを拒否します — インライン apiKey は平文で移動してはならないため、#2585)。受け入れはエントリごとです:拒否されたエントリはログに記録され、レスポンスの `skipped` リストに名前が示されますが、レポート全体を破棄することはありません — 残りのエントリは正常に登録されます。Web UI は、ターゲットドロップダウンでエージェント報告モデルに `(agent)` バッジを付けます。 + +3 つのレベル、最も広いものから最も具体的なものまで: + +1. **グローバル** — トップレベルの `"compress": { … }` キー。すべてのリクエストに適用されます。`injectTool` / `injectNudge` トグルが尊重されるのはこのレベルのみです。 +2. **プロバイダーごと** — `providers[url]` エントリ内の `"compress": { … }` ブロック。 +3. **モデルごと** — `providers[url].models[model]` エントリ内の `"compress": { … }` ブロック。 + +各リクエストについて、プロキシは最長 URL プレフィックス一致(プロバイダーを見つけるため)とリクエストのモデル名(モデルエントリを見つけるため)によって設定を解決し、その後、グローバル → プロバイダー → モデルの順にマージします。 +### CompressSettings フィールド + +#### `modelContextLimit` + +- **型:** `number | string` +- **デフォルト:** *(モデルのネイティブウィンドウ)* +- **ステータス:** ACTIVE +- **説明:** トークン単位のコンテキストウィンドウサイズです。これはエンジンが使用率(`usage = tokens / modelContextLimit`)を計算する際の**分母**であり、切り詰め上限ではありません。絶対数(`200000`)またはパーセンテージ文字列(`"80%"` = モデルのネイティブウィンドウの80%、組み込みテーブルまたは models.dev レジストリから解決)を受け入れます。すべてのレベルで省略された場合、ネイティブウィンドウが使用されます。これはモデル制限に対する最優先ソースであり、組み込みテーブル、レガシーなモデル別 `context` フィールド、トップレベルの `modelContextLimit` を上書きします。また、**ハードなプリフライト壁**としても機能します。ペイロードがこの値に達すると、プロキシは転送前に能動的にコンテキストを折りたたみ、折りたたみで下回れない場合は、アップストリームに送信する代わりにリクエストを即座に失敗させます。日常的なコンテキストを小さく保ちつつ、大きな読み取り時にネイティブウィンドウまでバーストできるようにするには、`modelContextLimit` をネイティブ値のままにし、代わりに `maxContextLimit` をソフトターゲットとして使用してください([エラスティックなヘッドルームを持つソフトターゲット](#soft-target-with-elastic-headroom-1122) を参照)。 +- **オーバーフローアームの挙動 (#3450)。** アップストリームが明示的なウィンドウエラーでペイロードを拒否した場合、プロキシはその拒否をリトライ用にアームします。ここで宣言されたウィンドウがアップストリームが示すものと異なる場合、両方の値を名指しした警告を一度だけ記録し、両者のうち小さい方を基準に折りたたみます。エラーボディにトークン数が示されている場合(例: `you requested N tokens (M in the messages, K in the completion)`)、`M` は測定されたペイロードサイズとして計上されます(上限はサイズではないため)、アームが有効の間、`K` はこの壁から差し引かれて適合判定に使われます — アップストリームは同じ予算に対して補完部分の請求を行うことを証明しているためです。次の実際の使用量レポートで、アームと予約は同時に解除されます。宣言が誤っている場合は、このキーを正しいウィンドウに設定してください。警告は消え、折りたたみターゲットもそれに従います。 + +#### `outputHeadroomMaxPct` + +- **型:** `number | string` +- **デフォルト:** `0.25` +- **ステータス:** ACTIVE +- **説明:** コンテキストウィンドウに対する出力ヘッドルーム予約の上限(分数)です。予約量 = `min(max_tokens, pct × window)`。**予算ソース:** リクエストに出力予算フィールド(`max_tokens` / `max_completion_tokens` / `max_output_tokens`)が全く含まれていない場合(例: Codex のネイティブ Responses パスは `max_output_tokens` を送信しない #924)、プロキシはモデルの宣言済み最大出力にフォールバックします。まずルート別の `providers[url].models[model].output` 設定、次に models.dev レジストリの出力上限(オフラインフロアとしてのバンドルスナップショット)を参照し、どちらも存在しない場合は予約を行いません。同じ上限がフォールバック値にも適用されます。この予約により、エンジンのナッジ/切り詰めバンドが `window − reserved` 以下に保たれ、長い返信が「入力 + 出力」をウィンドウを超えさせないようにします — これは出力をウィンドウにカウントする API に適用されます(Anthropic Messages は例外です:その入力制限は `max_tokens` に独立して強制されるため、除外されます)。上限がない場合、登録済み最大出力がウィンドウの大きな割合を占めるモデル(例: 262144 ウィンドウで `maxTokens` 131072)は入力予算の大部分を失い、75% の強制圧縮閾値がフルウィンドウの約3分の1で発火してしまいます。デフォルトの `0.25` は、ウィンドウの25%までの単一ターン返信に対して95%の緊急閾値でのオーバーフローがないことを保証しつつ、その損失を制限します。より長い返信は一度オーバーフローしますが、次のターンのオーバーフロー自己修復によって回復します。なお、この上限は過大予約を緩和するだけです:`max_tokens` が既に `pct × window` 以下の場合、予約は完全な `max_tokens` のままです(レガシー動作とバイト単位で同一)。比率(`0.25`)またはパーセンテージ文字列(`"25%"`)を受け入れます。`0` に設定すると予約を完全に無効にし、`>= 1` にするとレガシーな全機能予約(入力 + 全予算の返信が常に収まる — SGLang/vLLM などの厳格なバックエンドが強制するもの)に戻ります。負の値や解析不能な値は `compress` ブロック全体を拒否します。例: 262144 トークンのウィンドウ、`max_tokens = 131072` → デフォルト `0.25` で 65536 を予約 → 有効ウィンドウ 196608(レガシーの完全予約: 131072); `max_tokens = 65536` → 65536 を予約 → 196608 のまま(65536 ≤ ウィンドウの25%)。billion-context-pi (`#207`) と #896 により整合性が取られています。 + +#### `maxContextLimit` + +- **型:** `number | string` +- **デフォルト:** `"75%"` +- **ステータス:** ACTIVE +- **説明:** **強制圧縮**ナッジを発火させるコンテキスト使用率の閾値です。使用率がこの比率を超えると、エンジンは成長ゲートと頻度チェックをバイパスするナッジを発火します。比率(`0.75`)またはパーセンテージ文字列(`"75%"`)を受け入れます。値が低いほど早く圧縮されます。カーネルフィールド `nudge.maxContextLimitPct` にマッピングされます。 + +#### `emergencyThresholdPercent` + +- **型:** `number | string` +- **デフォルト:** `"95%"` +- **ステータス:** ACTIVE +- **説明:** 大きなツール出力の**緊急切り詰め**を発火させるコンテキスト使用率の閾値です。比率またはパーセンテージ文字列を受け入れます。`maxContextLimit` 以上である必要があります。カーネルフィールド `nudge.emergencyThresholdPct` および `truncate.threshold` にマッピングされます。 + +#### `nudgeGrowthTokens` + +- **型:** `number` +- **デフォルト:** `50000` +- **ステータス:** ACTIVE +- **説明:** ソフト圧縮ナッジのためのトークン成長ステップです。この数のトークンが圧縮可能になったたびに、ほぼナッジが発火します。値が低いほど、より頻繁にナッジが発生します。カーネルフィールド `nudge.growthFloor` および `nudge.growthCap` にマッピングされます(エンジンの適応バンドをこの固定ステップに平坦化します)。**これを最小のモデルウィンドウに対して比例させること:** T1 マストリガーには圧縮可能コンテンツの1ステップ分が必要であるため、ウィンドウより大きいステップ(例: ~1M ウィンドウに対して `1500000`)は、そのウィンドウ全体でマストリガーを到達不能にします — 使用率パーセンテージの圧力バンドとプリフライトはバックストップとして残りますが、増分折りたたみは沈黙し、ウィンドウ超過リクエスト(セッション中に小さなウィンドウのモデルへのフォーク後によく見られる)は、早期折りたたみではなく、マルチラウンドのプリフライト要約マラソンに直接突入します。 + +#### `minPressureBenefitTokens` + +- **型:** `number` (トークン, ≥ 0) +- **デフォルト:** *(未設定 — カーネルデフォルト `max(5000, context limit × 1%)`)* +- **ステータス:** ACTIVE +- **説明:** 圧力バンドナッジ(使用率が既に `maxContextLimit` 以上)が発火する前に必要とする最小の回収可能トークン量です。圧力バンドは設計上、成長ゲート + 頻度をバイパスするため、決定メーターが膨張して動作しているルート(k̂ 増幅、#3211)では、数千トークンの保留でも別の折りたたみをトリガーします — 各折りたたみはバンドを下回るのに十分な量しか回復せず、すぐに再入します:高頻度・低収益のチャーン(「ラインに達するたびに少し折りたたむ」)。このフロアを上げる(例: ~200k ウィンドウに対して `50000`)と、フロア未満の圧力ナッジは抑制されます(抑制として記録され、`truncate.threshold` が安全弁として残る)。成長がバンドから使用率を外すのに十分な1バッチに蓄積するまで — 正直なルートが成長ゲートから無料で得るリズムです。明示的な `0` はレガシーな任意保留動作に戻します。他の compress フィールドと同様に、グローバル → プロバイダー → モデル間でフィールドごとにマージされます。カーネルフィールド `nudge.minPressureBenefitTokens` にマッピングされます。 + +#### `requireUsageSampleForPressure` + +- **型:** `boolean` +- **デフォルト:** `true` (カーネルデフォルト) +- **ステータス:** ACTIVE +- **説明:** ナッジ計測パスのためのファントム圧力ガードです。ターンが中断された場合、または使用量レポートが届く前にアップストリームのサンプル配信ウィンドウが期限切れになった場合(短TTLキャッシュ環境)、有効なカウンターは請求済み読み取りに依存できず、実際に請求されるものよりも構造的に数倍高くなるローカル文字数ベースの推定値にフォールバックします。そのような読み取りに対して、圧力バンド(使用率 ≥ `maxContextLimit`)は歴史的に即座に EMERGENCY/OVER-LIMIT 注入を発火していました — 悪いメーターと焼けたプレフィックスキャッシュに基づいた破壊的な書き換えです。ガードが ON の場合、推定値読み取りで遭遇した圧力バンドナッジは1ラウンド延期されます:次のリクエストは新しい請求レポート(または出所安定アンカー)を持ち、実際の数値から判断するため、延期のコストはほぼゼロです。ハードオーバーフローバックストップ(`truncate.threshold`、プリフライト出力クランプ)は無条件でアームされたままです。請求済み読み取り("usage")とソースマーカーを省略するホストは、バイト単位で同一の動作を維持します;非圧力ティア(成長 / 頻度 / 初見マス)はマーカーを完全に無視します。`false` に設定すると、レガシーな推定駆動圧力注入に戻ります。他の compress フィールドと同様に、グローバル → プロバイダー → モデル間でフィールドごとにマージされます。カーネルフィールド `nudge.requireUsageSampleForPressure` にマッピングされます。 + +#### `tierNudgeTokens` + +- **型:** `object` — `{ "t1"?: number, "t2"?: number, "t3"?: number }` (各値はトークン単位, ≥ 1) +- **デフォルト:** *(未設定 — すべてのティアが導出値を使用)* +- **ステータス:** ACTIVE (acp-kernel >= 0.0.108 が必要) +- **説明:** T1/T2/T3 圧縮パスのティア別トークンマストリガー閾値 (#2376)。デフォルトでは、3つのティアすべてが `nudgeGrowthTokens` から導出されます(T1 = ステップ、T2/T3 = ステップ × 1.5);このフィールドは各ティアを独立して固定します — 例: 長いタスクでは T1 を攻撃的に保ちつつ、T2 を早期または遅延で蒸留させる。未設定のサブフィールドは、そのティアの導出デフォルトにフォールバックするため、欠落または空のオブジェクトは統合値と完全に後方互換です。変更されるのはトークンマストリガーの比較のみです:カウントトリガー(`tiers.tier2Trigger` / `tiers.tier3Trigger`)、頻度フロア、初見マスバイパス、圧力/緊急ルーティングは既存の基準を維持します。グローバル → プロバイダー → モデル間でサブフィールドごとにマージされます(モデルレベルの `t2` はプロバイダーレベルの `t1` を破棄しません)。カーネルフィールド `nudge.tierGrowthTokens` にマッピングされます。 +#### `nudgeModelDecided` + +- **型:** `boolean` +- **デフォルト:** *(設定されない限りオフ)* +- **ステータス:** ACTIVE (#2228) +- **説明:** モデル決定による圧縮タイミング。有効化されると、アームされた**ティア1**ナッジ(穏やかな成長または制限超過)は、その助言テキストを即座に注入しません。代わりに、bili はセッションの既にキャッシュされたプレフィックス(同じ system/tools/messages プレフィックス、小さな出力予算、15秒アイドルタイムアウト) üzerinden1つの短い**サイドコール**を送信し、現在のタスクを考慮して、今すぐ圧縮することが純粋に有益かどうか、オプションでどのスパンを折りたたみ、短いトピックを尋ねます。回答は厳密な JSON(`{"compress": true|false, "range": "mNNNNN-mNNNNN"?, "topic": "?"}`)である必要があります;それ以外の出力は失敗として扱われます。有効な「はい」の場合、bili はプログラムで最終化されたスパンを名指しした明示的な圧縮ディレクティブを注入します — 提案された範囲は、ライブの圧縮可能範囲に完全に含まれている場合のみ尊重され、そうでない場合は最大のライブ範囲が使用されます。「いいえ」、不正な回答、またはタイムアウトの場合、このラウンドでは何も注入されません。**3回の連続ハード失敗**の後、次のアームはレガシーな助言に一度フォールバックし、カウンターがリセットされます(自己修復ラダー)。**EMERGENCY** アームと**ティア2/3蒸留**は決定を経由せず、レガシーな助言をバイト単位で維持します。ホスト専用フィールド — カーネルには渡されません。デフォルトではオフです。 + +#### `nudgeDecisionMaxTokens` + +- **型:** `number` +- **デフォルト:** `200` +- **ステータス:** ACTIVE (#2228) +- **説明:** `nudgeModelDecided` が有効なときに実行されるモデル決定サイドコールの出力予算(トークン単位)です。0 より大きい必要があります(無効な値は設定読み込み時に拒否されます)。 + +#### `requireNudge` / `requireRecommendation` + +- **型:** `boolean` (それぞれ) +- **デフォルト:** *(設定されない限りオフ)* +- **ステータス:** ACTIVE (#5683) +- **説明:** 自発的に圧縮するモデルのためのポリシーゲート(フィールドケース: qwen 27b がプロンプトなしで compress を呼び出す)。両方ともホスト専用フィールドであり、カーネルには渡されません。他の compress フィールドと同様に、グローバル → プロバイダー → モデル間でフィールドごとにマージされ、Web パネルのクイック設定カードまたは任意の設定レベルで編集可能で、次のリクエストからホット適用されます。 + - `requireNudge` (タイミングゲート): モデル主導の compress 呼び出しは、NUDGE CREDIT がライブでない限り拒否されます (#5943) — 最後にモデルに実際に到達した圧縮ナッジ(ゲート後の配信事実 `nudgeOutcome === "injected"`:助言ナッジ、モデル決定ディレクティブ、緊急ナッジはすべてこれを発行し、"gated"/"vetoed"/"skipped" ラウンドは決して発行しない)によって発行された20モデルラウンドのウィンドウです。各新しい注入でウィンドウが更新され、ナッジされていない各モデルラウンドで1ずつ減衰します;非モデルリクエスト形状(countTokens / responsesCompact / ローカルフォージ)は更新せずに開いたままにし、1ターン内のループ再リクエストは再スタンプしないため、何も消費しません。成功した折りたたみはクレジットを消費しません — ナッジの推奨クリーンアップを複数ラウンドにわたって完了すること(#5943 が報告するマルチラウンドクリーンアップ拒否ストーム)は、まさにナッジが求めたものです;長期的な厳格さは、ナッジが成長駆動であるため、静かなセッションは20ラウンドのナッジなしで厳格な拒否に期限切れになり、成長しているものはウィンドウを継続的に更新することで維持されます。拒否は、ナッジが表示されるまでここでの無促圧縮は無効であることをモデルに伝えるエラーレシートです。 + - `requireRecommendation` (スコープゲート): 提出されたすべての範囲は、bili が現在折りたたみを**推奨**している範囲内に留まる必要があります — ナッジテキストと `acp_status` が示す同じライブ圧縮可能セット(存在する場合このリクエストの準備時オファー、なければライブ再計算、通常の viable + dead-ref + `minCompressRangeChars` フィルタ付き)。判定は**カバレッジ**によるもので、等価ではありません:推奨スパンをより小さなチャンクに細分することは合格します(bili 自身の初見ガイダンスは分割を奨励する)、そしてアクティブブロックに既に折りたたまれたメッセージは免除されるため、既存ブロックのサマリーを更新する再折りたたみは合法のままです。他のライブメッセージを含む範囲は、問題のスパンを名指しし `acp_status` を指して、全体として拒否されます。 + - 免除と相互作用: bili 自身のオーバーフローバックストップ折りたたみ(プリフライト / オートフォールド — モデル呼び出しなし)は両方のゲートから免除されるため、ゲートされたセッションはコンテキストオーバーフローで死にません;ナッジチャネル自体が抑制されている間でも可用性には影響しません(自己修復 D1)。独自のメカニズムで圧縮を駆動するホスト(例: codex の compaction トリガー、これは bili ナッジではない)は、タイミングゲートの「促された」概念の外にあります — このようなレーンがルートを共有する場合、これらの設定をグローバルではなく影響を受けるプロバイダー/モデルにスコープしてください。新しい環境変数はありません;レベルが明示的にフラグを有効にしない限り、動作は変わりません。 + +#### `preserveRecentMessages` + +- **型:** `number` +- **デフォルト:** *(カーネルデフォルト, `3`; #3058 で `5` から調整)* +- **ステータス:** ACTIVE +- **説明:** 圧縮対象として提供されない最新のメッセージの数です。アクティブな作業セットを保護し、モデルが最新のターンを逐語で保持できるようにします。カーネルフィールド `preserveRecentMessages` にマッピングされます。 + +#### `preserveRecentTokens` + +- **型:** `number` +- **デフォルト:** *(カーネルデフォルト, 通常 `5000`)* +- **ステータス:** ACTIVE +- **説明:** 最近のメッセージ保護のために予約されるトークン予算です。カーネルフィールド `preserveRecentTokens` にマッピングされます。 + +#### `minCompressRangeChars` + +- **型:** `number` +- **デフォルト:** *(カーネルデフォルト, 通常 `5000`)* +- **ステータス:** ACTIVE +- **説明:** メッセージ範囲が圧縮対象となるための最小範囲サイズ(**文字数**、トークンではありません);より小さい範囲はスキップされます。英語/コードは1トークンあたり約4文字、CJK は約1-2文字であるため、同じ数はトークンベースのメンタルモデルよりも英語テキストに対して約4倍寛容に読まれます。カーネルフィールド `compress.minCompressRange` にマッピングされます。 + +#### `minCompressRange` + +- **型:** `number` +- **ステータス:** DEPRECATED (`minCompressRangeChars` のエイリアス、後方互換性のために保持) +- **説明:** `minCompressRangeChars` のレガシー名 — 同じカーネルマッピング(`compress.minCompressRange`)、同じ単位(文字数)。同じレベルで両方のキーが設定されている場合、正規名が優先されます;レベル間で、どの名前で使われていても深いレベルが優先されます。 + +#### `maxSummaryLength` + +- **型:** `number` +- **デフォルト:** *(カーネルデフォルト `20000`)* +- **ステータス:** ACTIVE (#3635) +- **説明:** 1つの生成サマリーに対する**文字数**でのハード上限です。長い返信は全体として拒否されます — モデル内サマリーに対するカーネルのオールオアナッシング長さチェックと、設定済みチェーンに対する外部サマリー実行器によって(切り詰めなし、リトライなし)。プリフライトとモデルツール圧縮パスの両方が、外部サマライザーにこの正確な上限を事前に伝えます(プリフライトは #1775 から、compress パスは #3635 から)ため、超過は不透明な破棄ではなく、名前の付いたログ理由を持つモデルコンプライアンス失敗になります。`0` は上限を無効にします。カーネルフィールド `compress.maxSummaryLength` にマッピングされます。#3635 以前、このキーはどこでも受け入れられませんでした:パネル PUT はそれをサイレントに破棄し、ファイル編集は解決済み設定に到達しなかったため、有効な値は常にカーネルデフォルトでした。 + +#### `minSummaryLength` + +- **型:** `number` +- **デフォルト:** *(カーネルデフォルト `50`)* +- **ステータス:** ACTIVE (#3635) +- **説明:** 生成サマリーのフロア(**文字数**);短い返信は全体として拒否されます。`0` はフロアを無効にします。カーネルフィールド `compress.minSummaryLength` にマッピングされます。`maxSummaryLength` と同じ受け入れ履歴 (#3635)。 + +#### `tiers` + +- **型:** `boolean` +- **デフォルト:** `true` +- **ステータス:** ACTIVE +- **説明:** マルチティア圧縮を有効にします — 古いサマリーのティア2蒸留とティア3凝縮。`false` に設定すると、ティア1のみのモードで実行されます(すべてのサマリーがフラットなティア1サマリーになります)。カーネルフィールド `tiers.enabled` にマッピングされます。 + +#### `protectedLatestTools` + +- **型:** `string[]` (ツール名パターン、例: `["todo_list"]`) +- **デフォルト:** `[]` *(なし — クライアントごとにオプトイン、ツール名はクライアント固有)* +- **ステータス:** ACTIVE +- **説明:** その**最新**のツール呼び出し + ペアリング結果が決して圧縮されないツール名パターン(カーネル `protectedLatestTools`、`acp-kernel` >= 0.0.80 が必要)。累積スナップショットツールのために構築されました — 例: エージェントの todo/タスクリスト、新しい結果が古いものをすべて上書きする:ソースオブトゥルースは最新インスタンスのみであるため、**すべての**インスタンスを保護する(`protectedTools` を通じて)と、そのツールの履歴が無制限に成長しますが、**最新**を保護すると、ライブスナップショットをコンテキストに保ちつつ、すべての上書きされたインスタンスが正常に折りたたまれます。これは「圧縮後にエージェントがタスクリストを忘れる」失敗 (#639) を解決します。保護はハード除外です:最新インスタンスはアドレス不能(その参照は `BLOCKED` としてレンダリングされる)であり、提案された範囲でも明示的な compress 範囲でもカバーできません;両方の圧縮モードとすべてのワイヤーで同様に適用されます。パターンは正確なツール名または `*` グローブで一致します(例: `"todo_list"`, `"todo*"`)。`/` を含むパターンは正規スキルパスに一致し、パスごとに最新インスタンスを保護します (#1947):スキルロードはすべてのクライアントで `skill/` にプロジェクト化されます — opencode `skill({name})`、Claude Code/ZCode `Skill({skill})`、および `//SKILL.md` を読む任意のツール — したがって `"skill/*"` はすべてのスキルの最新ロードを保持します(名前ごとに1つの保護インスタンス)、スラッシュなしの `"skill"` はプレーンな単一最新セマンティクスを保持します。最も深く定義されたレベルで配列全体の置換。例: `{ "compress": { "protectedLatestTools": ["todo_list", "skill/*"] } }`。 + +#### `protectedTools` + +- **型:** `string[]` (ツール名パターン、例: `["skill"]`) +- **デフォルト:** `[]` *(なし — クライアントごとにオプトイン、ツール名はクライアント固有)* +- **ステータス:** ACTIVE +- **説明:** ツール呼び出しおよびペアリング結果が**決して圧縮されない — すべてのインスタンス、完全な履歴**(カーネル `protectedTools`)ツール名パターン。保護はハード除外です:すべての一致する参照は `BLOCKED` としてレンダリングされるため、提案された範囲でも明示的な compress 範囲でもインスタンスをカバーできません;両方の圧縮モードとすべてのワイヤーで同様に適用されます。パターンは正確なツール名または `*` グローブで一致します(例: `"skill"`, `"skill_*"`)。`/` を含むパターンは、すべてのクライアントで名前によってスキルを選択します (#1947):スキルロードは正規パス `skill/` にプロジェクト化されます — opencode `skill({name})`、Claude Code/ZCode `Skill({skill})`、および `//SKILL.md` を読む任意のツール — したがって `"skill/release-orchestrator"` はその1つのスキルのすべてのロードを保護し、`"skill/review-*"` は名前セグメント内でグローブ一致します(`*` は `/` をまたがない)、`"skill"` / `"skill/*"` は等価のままです(ノードおよびすべての後継)。`/` を含まないパターンはバイト単位で変更されません。最も深く定義されたレベルで配列全体の置換。例: `{ "compress": { "protectedTools": ["skill/release-orchestrator"] } }`。 +- **⚠ どのノブを使用すべきか(設定前に読むこと):** ツールの結果が互いにどのように関係しているかによって選択してください: + - **独立したコンテンツ** — 各インスタンスは、後の結果が上書きしない独自の情報を持ちます(opencode/pi `skill` ロード、ワンショット参照): `protectedTools` を使用します。古いロードを折りたたむとそのコンテンツが永久に失われます;保護はすべてのロードをコンテキストに保ちます (#1109)。1つのオーケストレータースキルのすべてのロードを保護しつつ、より軽いスキルを折りたたませるには `skill/` パスパターンを使用します(`protectedTools: ["skill/release-orchestrator"]`, #1947)。 + - **累積スナップショット** — 新しい結果が古いものを上書きします(クライアントの todo/タスクリスト): `protectedLatestTools` を使用します。そのようなツールの**すべての**インスタンスを保護すると、その履歴が無制限に成長します — #639 が最新のみを保護することで回避したまさにその失敗です。 + - 経験則: 低頻度、高価値のツール → `protectedTools`;チャッティなツール → 完全な履歴保護はしない(コンテキストが無制限に成長する);累積スナップショットツール → `protectedLatestTools`。 + +#### `neverPreserveRecentTools` + +- **型:** `string[]` (ツール名パターン) +- **デフォルト:** 未設定 → カーネル組み込み `["decompress", "search_context", "read", "bash"]` (`acp-kernel` >= 0.0.92 が必要) +- **ステータス:** ACTIVE +- **説明:** ソフト保護された最近ゾーン(`preserveRecentMessages`/`preserveRecentTokens`)から**除外**されるツール名パターン:最近ウィンドウ内の一致するツール結果は、最初に老化するのではなく、すぐに圧縮可能になります。カーネルデフォルトは `read`/`bash` を圧縮可能に保ちます。それらが最大の回収可能マスであるため — しかし、同じデフォルトがバッチ読み取りワークフローで新しく読んだファイルをすぐに折りたたみ、フォールド→再読み取りデスループに陥る原因でもあります (#1198/#1277)。**推奨される対策: `read` のみを削除する** — `{ "compress": { "neverPreserveRecentTools": ["decompress", "search_context", "bash"] } }` — 新鮮な読み取り結果を最近ゾーンに保ち、後に位置によって老化させる(`protectedLatestTools` は最新の読み取りを永遠にピン留めするため、それとは異なる)。逐語置換セマンティクスを必要としない場合、よりシンプルな陽性形式 `preserveRecentTools: ["read"]` を優先してください — 次のセクションを参照。`decompress`/`search_context` はリストに保ってください:それらを再包含すると、ちょうど復元されたブロックを最近ゾーンにピン留めし、回収不能にする — 別の病です。**⚠ 空配列 `[]` は有効であり、何も除外しません**(最大保護のエスケープハッチ)— `protectedTools`/`protectedLatestTools` と異なり、空配列は拒否されません;明示的な配列はデフォルトを逐語で置き換え、最も深く定義されたレベルで配列全体の置換。 + +#### `preserveRecentTools` + +- **型:** `string[]` (ツール名パターン) +- **デフォルト:** 未設定 → 減算なし(`neverPreserveRecentTools` ?? 組み込みリストが逐語で支配;`acp-kernel` >= 0.0.93 が必要) +- **ステータス:** ACTIVE +- **説明:** `neverPreserveRecentTools` の**陽性側**の対応物:有効な最近ゾーン除外リストから**削除**されるツール名パターン。#1198/#1277 のバッチ読み取りフォールド→再読み取り対策は、組み込みリストを再記述(または古い手動コピーを凍結)せずに新鮮な読み取り結果を保護し、組み込みの進化に従う1エントリ設定 — `{ "compress": { "preserveRecentTools": ["read"] } }` — になります。有効な除外 = `(neverPreserveRecentTools ?? 組み込み) minus preserveRecentTools`;明示的な `neverPreserveRecentTools` と組み合わせ可能(減算は明示的なリストにも適用);グローブサフィックスパターンは一致するエントリを減算します(`"bash*"` は `bash` を削除)。逐語置換セマンティクスを本当に必要としない限り、never-list の編集よりもこのノブを優先してください。**⚠ 空配列 `[]` は拒否されます** — ここでは純粋な何もしない操作であるため、単独の `[]` はほぼ確実に `neverPreserveRecentTools: []`(最大保護のエスケープハッチ)のタイプミスです。兄弟ノブと同様に、最も深く定義されたレベルで配列全体の置換。 + +#### `prompts` +- **デフォルト:** *(カーネルデフォルト — `acp-kernel` の `defaultPrompts` を参照)* +- **ステータス:** ACTIVE +- **説明:** システムプロンプトとナッジメッセージに注入される圧縮プロンプトテキストを上書きします。すべてのフィールドは**荷重**です:カーネルルールは数ヶ月の生産使用で調整されており、それらを上書きするとサマリー品質が低下する可能性があります(パス / シグネチャ / 決定の喪失 → 検索の破損)。上書きは、3レベルマージ後に `acknowledgePromptsRisk` が `true` に解決された場合のみ有効になります — フラグは独自の最も深く定義されたレベルで独立して解決され、各パーツがどのレベルに存在するかに関係なく、**すべての** `prompts` 上書きをゲートします(グローバルレベルのフラグはモデルレベルの `prompts` を有効にする);それ以外の場合は無視され、一度の警告が記録されます。非文字列フィールドはサイレントに破棄されます(不正な部分が良いデフォルトを上書きすることはありません)。主に非英語または小規模モデルのチューニングに有用 — issue #156 を参照。 + +#### `acknowledgePromptsRisk` + +- **型:** `boolean` +- **デフォルト:** `false` +- **ステータス:** ACTIVE +- **説明:** `prompts` 上書きが有効になるためには `true` である必要があります。他のすべてのフィールドと同様に解決されます(最も深く定義されたレベルが優先)し、各パーツがどのレベルに存在するかに関係なく、すべての `prompts` 上書きをゲートします — 解放する `prompts` と同じブロックに存在する必要はありません。設定すると、上記に文書化されたサマリー品質リスクを承認したことになります。 + +#### `promptPack` + +- **型:** `string` (パック名、例: `"lean"`) +- **デフォルト:** `default` *(未設定は等価 — アイデンティティサーフェス、カーネルデフォルト)* +- **ステータス:** ACTIVE +- **説明:** 名前付きプロンプトパックを選択します — ツール説明、compress システムプロンプトセクション、ナッジセクションをカバーするキュレーションされたサーフェスプリセット — ホストのパックチェーンから解決されます:**プロジェクト** `./.billion-context/packs/.json` → **ユーザー** `/packs/.json` → **shipped** (`chat`) → **builtin** (`default`, `lean`)。組み込み `lean` は4つの ACP ツール説明を1行に置き換えます(スニペット/ガイドラインの装飾なし)が、圧縮ルールはデフォルトのままです。組み込み `chat` (#5319) は、長期コンパニオンシップ / マルチセッションメモリ使用のために、compress 哲学と compress 方法の散文のみを書き換えます;他のすべてのサーフェスパーツはホストデフォルトのままです、同名のユーザーまたはプロジェクトファイルがそれを上書きします。不明な名前は一度の警告とともにアイデンティティサーフェスにフォールバックします。他のフィールドと同様の3レベルマージ;パックサーフェスセクション(ツール/セクション上書き)は直接適用され、`acknowledgePromptsRisk` ゲートなし — そのゲートはインライン `compress.prompts` ルールテキスト上書きのみを支配します。なお、パックの `prompts` ブロックはこのプロキシによって無視されます:ルールテキスト上書きはインライン `compress.prompts` を通じてのみ可能です。`acp-kernel` >= 0.0.66 が必要。設定パネルはユーザーディレクトリのファイルを直接管理できます — `/packs/` 配下のパックの New/Edit/Delete(ピッカーは各エントリの出所を知っています;組み込みと shipped パックは那里で読み取り専用です、代わりに同名のユーザーパックで上書きしてください)。編集ダイアログには3つのタブがあります (#5344):**ガイド付きフォーム** — フィールドごとのヘルプテキストと、`default`/`chat`/`lean` から読み込まれるワンクリックベーステキスト(空のフィールドは省略され、実行時にシステムデフォルトにフォールバック);**AI アシスト** — シナリオを平易な言葉で説明し、生成されたプロンプトを任意の LLM にコピーし、その JSON を貼り戻すとフォームに直接解析されます;**詳細 (JSON)** — 完全な制御のための生ファイルテキスト。 + +**パックファイル形式。** 各 `/.json` は1つのパックオブジェクトを保持します。不明なフィールドは、すべての読み込みパスで使用される同じサニタイザー(`sanitizePackSurface`)によって破棄されるため、追加のメタデータは無害です: + +```json +{ + "name": "my-pack", // optional — defaults to the file name without .json + "version": "1.0.0", // optional — shown by `bili pack list` and the panel + "description": "…", // optional + "promptSections": { + "philosophy": "…", // replace a whole system-prompt section; JSON null keeps the default + "howToCompress": "…" // start from the tuned texts in src/chat-pack.ts + } +} +``` + +オプションのサーフェスブロック: `prompts` (インラインルールテキスト上書き), `nudgeSections`, `toolPrompts`, および `adapters` (ホスト固有の追加、例: `"pi": { "promptSections": { … } }`)。少なくとも1つの認識されたフィールドがサニタイジング後に残る必要があります。そうでない場合、ファイルは書き込み時に拒否されます。 + +**他の人のパックのインストール。** ルートに `bili-pack.json`(上記のパックオブジェクト)を含む任意の npm パッケージはインストール可能です:`bili pack install ` — `name@version`、スコープ付き名、git URL、`.tgz` パスも受け入れます(ローカル `npm` に委譲するため、レジストリ認証は正常に動作します)。ファイルはデフォルトで `/packs/` に配置されます(`--project` は `./.billion-context/packs/` をターゲット;`--force` は既存のパックを拒否する代わりに置き換えます)。その後、設定パネルから管理するか、`bili pack remove ` / `bili pack list` を使用します。 + +#### `reconcile` + +- **型:** `string` — `"off"` | `"warn"` | `"repair"` +- **デフォルト:** `"repair"` +- **ステータス:** ACTIVE +- **説明:** **フォールド状態の調整** (#1921) を制御します:クライアントが圧縮されたものと*コンテンツ*が乖離した履歴を再送信した場合に何が起きるか — 例: フォークが以前のターンを再シリアライズ (#1908)、クライアントがメッセージバイトをインプレースで書き換え、またはプロバイダーが空白を正規化。デフォルトではメッセージアイデンティティはコンテンツハッシュであるため、1バイトのチャーンは影響を受けたメッセージをすべての圧縮ブロックからサイレントに落とし、生のオリジナルがワイヤーに再入します(「フォールドドリフト」)。`"repair"` モードでは、プロキシはフォールド実行前にメッセージごとにドリフトを分類します:安定したツール呼び出しアンカー(`tool_use_id`)と正規化アイデンティティアンカー(NFC テキスト、CRLF/空白折りたたみ)は、新しいメッセージ ID に圧縮ブロックを再アンカーし、クライアント側のチャーンに対してバイト単位でクリーンな再送信と等価にフォールドを生存させます;真に*編集された*メッセージ(正規化テキストが異なる、または長さが `max(256, 25%)` を超えてドリフト)は、折りたたみずにワイヤーに再入するように残されます — 正直で、決してサイレントな書き換えではなく — 次の圧縮パスがそれらを再折りたたみます。`"warn"` は同じ分類器を実行しますが、発見したものを記録するだけです;`"off"` はレイヤー全体を無効にします(#1921 以前の動作)。環境変数 `BILI_FOLD_RECONCILE` は1プロセスについて設定された値を上書きします。アンカーメタデータはセッションごとに永続化されます(セッションレコードの `foldAnchors`、16384 エントリ上限)で、各ブロックが実際に参照するメッセージをカバーします。システムプロンプトがメッセージチャーンなしで変更された場合、1行の `info` が記録されます(システムのみドリフトはフォールド状態に触れません)。 + +#### `absorb` + +- **型:** `object` (`{ enabled?, minToolTokens?, contextThresholdPct?, excludeTools?, toolName? }`) +- **デフォルト:** *(無効 — `enabled: true` を設定しない限り機能はオフ)* +- **ステータス:** ACTIVE +- **説明:** オプトインの**即時ツール結果圧縮**(issue #605、`acp-kernel` absorb API を通じて)。有効化されると、大きなツール結果は結果時に強制 `[ACP absorb]` 指示を受け、モデルは `absorb` ツールを通じて結果をコンパクトなサマリーに蒸留し、元のツール呼び出し/ツール結果ペアは次のターンからワイヤーから隠されます — フォールドラウンド間のセッション中の圧力を低く保ちます。サブフィールド(他の CompressSettings フィールドと同様に最も深いものが優先してマージ): + - `enabled: boolean` — メイナスイッチ;`true` 以外のものは機能を完全にオフに保ちます(ツールなし、プロンプトなし、マーカーなし)。 + - `minToolTokens: number` — このトークン数以上の結果のみがプロンプトされます(カーネルデフォルト 1000)。 + - `contextThresholdPct: number|percent-string` — 使用率が `modelContextLimit` のこの分数に達したときのみプロンプトします(`0` = サイズゲートのみ;`"75%"` は受け入れられます)。 + - `excludeTools: string[]` — 決して absorb されないツール名パターン。**既知の制限:** [ranxianglei/acp-kernel#213](https://github.com/ranxianglei/acp-kernel/issues/213) がリリースされるまで、ツール*結果*に対しては何もしません(ワイヤー投影は結果に `toolName` を持たないため、カーネルの名前ガードが発火できません)。 + - `toolName: string` — 注入されたツールの名前を変更(デフォルト `"absorb"`);宣伝/注入スキーマ、システムプロンプトセクション、セッションごとの裁定は両方のレーンで名前に従います。**レーンガバナンス (#1359):** プラグインモードは**ベース**設定によって `absorb` ブロック全体を支配するため、名前変更されたツールはその名前で宣伝され、その名前で実行されます(決して乖離しません);プロバイダー/モデルレベルの `absorb.*` 上書きは**プロキシレーンのみ**です(プロキシはマージされた名前で注入し裁定します)。読み込み時の警告は、ベースから乖離するプロバイダー/モデル `absorb.*` フィールドを列挙します。 + 注入はワイヤーのネイティブツールサーフェスに従います:プロキシモードは anthropic/openai/responses ネイティブツールワイヤーでツール(リクエストごとに解決された名前で)+ システムプロンプトセクションを注入し、プラグインモードは**有効な間のみ**プラグインマニフェストで宣伝します(ホストはマニフェストのツールを逐語に登録します — 無効なツールの宣伝はそれらを壊します、#1192;MCP シェルは無料で拾います)。Responses **マーカー/テキストプロトコル**ルートはサポートされていません(ネイティブツールサーフェスなし — REQUIRED absorb 指示は満たせません)、タイトル生成リクエスト(`max_tokens ≤ 200`)は compress プロンプトと同様に注入をスキップします。Absorb されたペアは再起動後も隠されたままです(セッション状態に永続化)。 + +#### `blockOps` + +- **型:** `object` (`{ enabled? }`) +- **デフォルト:** *(オフ — ツールは `enabled: true` の間のみ注入)* +- **ステータス:** ACTIVE (issue #5765) +- **説明:** オプトインの**圧縮ブロックライフサイクル管理**。有効化されると、3つのツールが ACP ツールとともに注入(プロキシレーン)/ 宣伝(プラグインレーン)され、それぞれに独自のシステムプロンプトセクションがあり、プラグインツール API がワイヤーが得た同じ値を解決するように、セッションごとの有効フラグが保存されます: + - `acp_retire` — アクティブな圧縮ブロックをレジデントビューから移動(そのサマリーはもはやすべてのリクエストに乗らない;`acp_restore` / `decompress` / `search_context` はまだ ID で到達可能)。 + - `acp_restore` — 引退したブロックをレジデントビューに戻す。 + - `acp_rewrite` — ブロックのサマリーをインプレースで置き換え(1ステップロールバックスロット `previousSummary` を保持;同一/空白の書き換えは拒否)。 + カーネル状態変更は冪等であり、バッチ可能(`blockId` 単一または `ids` 配列)。**デフォルトでオフである理由:** 3つのツールスキーマは有効な間、常にオンサーフェスです — 有効なプロキシのすべてのセッションのリクエストごとに約 +0.7k の推定トークン — したがって、オプトインしない限り、サーフェス(ツール配列、プロンプト、マニフェスト)は #5765 以前とバイト単位で同一のまま出荷されます。無効な間の誤った呼び出しは、エラーではなく、モデル向けの「この bili プロキシでは有効になっていません (compress.blockOps.enabled is not true)」レシートを受け取り、状態には決して触れません。引退/書き換え状態はセッション状態で再起動後も永続化され、エクスポート台帳(markdown ハンドオフ + JSONL)は `retired` ステータス、メッセージ参照スパン、オリジナル/サマリー文字数を報告します。 + +#### `ccr` + +- **型:** `object` (`{ enabled?, minToolTokens?, excludeTools?, toolName?, maxHeadChars? }`) +- **デフォルト:** *(v2 からプロキシモードでオン (#1179) — 未設定は `enabled: true` に解決;任意のレベルでの明示的な `enabled: false` はオプトアウト。プラグインレーンはオプトインのまま:明示的なグローバル `enabled: true` でのみアーム、#1271/#1273。)* +- **ステータス:** ACTIVE (v2 — プロキシモードがデフォルト;プラグインモードは明示的に有効な場合の anthropic + openai ワイヤー) +- **説明:** **コンテンツアドレスメッセージストア** / 組み込み CCR (issue #1097/#1179、`acp-kernel` CCR API を通じて、acp-kernel >= 0.0.84)。過大ツール結果を強制蒸留する(`absorb` のように)のではなく、または永遠にワイヤーに乗せるのではなく、カーネルは到着時にそれらを ID 参照します(ccr-store ノードは `processTurn` 内の prune と absorb の間に実行 — ID 参照は蒸留に優先):ワイヤーは決定的でバイト安定なプレースホルダー(`📦 [acp-stored #m00423 · shell output · 4,213 tok] \`npm run build\`\n → acp_retrieve("m00423") returns the full text`)を保持し、オリジナルはセッションのコンテンツストアに入ります。モデルは注入された `acp_retrieve` ツールを通じてオンデマンドで完全なオリジナルを取得します;retrieve は一時的です(リクエスト内ツール結果チャネルに乗る、フォールドスペースに入らない、メッセージ参照を消費しない)。デフォルトでロスレス:retrieve を行わないコストは1回の安価なツール呼び出し;absorb で蒸留された詳細は永久に失われます。サブフィールド(他の CompressSettings フィールドと同様に最も深いものが優先してマージ): + - `enabled: boolean` — メイナスイッチ。**未設定の場合デフォルトで `true`** (#1179);任意のレベルでの明示的な `false` が優先し、機能を完全にオフに保ちます(プレースホルダーなし、ツールなし)。プラグインモードのアームはさらに明示的なグローバル `true` を要求します (#1273) — マニフェストはオペレーターが明示的に有効にしたもののみを宣伝します。 + - `minToolTokens: number` — このトークン数以上のツール結果のみが ID 参照されます(カーネルデフォルト `4000`);小さい結果は逐語のままです。 + - `excludeTools: string[]` — 決して保存されないツール名パターン(グローブサフィックス許可;カーネルデフォルト: なし)。 + - `toolName: string` — 取得ツールの名前を変更(デフォルト `"acp_retrieve"`);宣言、ディスパッチ、プレースホルダーヒントはすべて名前に従います。クライアント自身のツール名に対して一意である必要があります。 + - `maxHeadChars: number` — プレースホルダー内のヘッド/コマンドプレビュー長さ(カーネルデフォルト `96`)。 + **プラグインレーンガバナンス (#1345):** プラグインモードでは、`ccr` ブロック全体が**ベース**設定に従います — セッションはベースレベルの `enabled: true` でのみアームされ、ベースの `toolName` と閾値で実行されます。なぜなら、プラグインマニフェスト(ホストの取得サーフェスの唯一の宣言)はベース設定のみから構築されるためです。したがって、プロバイダー/モデルレベルの `ccr.*` 上書きはプロキシモードセッションにのみ適用されます(プロキシはマージされたブロックでリクエストごとに宣言しディスパッチします)。すべての乖離した上書きは、設定読み込み時にレベル、フィールド、プラグインセッションが実際に使用する値を名指しした `[acp-config] ccr override ignored in plugin sessions: …` 警告として記録されます。 + ストアはセッション JSON の隣に単一のエンベロープファイル(`.content-store.json`)として永続化され、`BILI_ENCRYPTION_KEY` が設定されている場合、セッションファイルと同じ静止時コーデックを使用します;エントリはコンテンツハッシュで重複排除され、セッションごとに遅延読み込みされます。`tool` 結果内の*コンテンツ*のみが縮小します — アシスタント `tool_calls` とのペアリングには触れません。スコープゲート:**すべてのレーンでオプトイン** (#1207 オーナー決定 — ローカル検証後の任意のレベルで `compress.ccr.enabled: true`):プロキシモードは有効化されるとアームし、さらにプラグインモードは anthropic + openai ワイヤーで、CCR がグローバルに明示的に有効な間、プラグインマニフェストが `acp_retrieve` を宣伝します (#1271);responses マーカー/テキストプロトコルルート、`ACP_NO_INJECT_TOOL`、プラグインモードの responses/google ワイヤーは、retrieve を実行するための証明されたリクエスト専用ラウンドトリップチャネルを持たないため、コンテンツを失う代わりにそこでストアを解除します。v2 (#1179) 以降、フォールドもロスレスです:compress フォールドが着地すると、カバーされたオリジナルはストアに永続化されます(first-write-wins、reasoning はスキップ);したがって `acp_retrieve("mNNNNN")` は折りたたまれたコンテンツにも機能します;`decompress` はブロックのスパンのみを復元するためにオプションの `startId`/`endId` メッセージ参照を受け入れます(一時的な注入、retrieve と同じチャネル);`search_context` ヒットはブロックメタデータとともにカバーされた参照スパン(`[m00044–m00097 · N msgs]`)を持ち;`acp_status` はブロック→参照リンク(`BLOCK SPANS`)と STORE 行の別個の `range-restored` カウントを列挙します。設計決定 (#1282):**キャップなし、エビクションなし、永遠に** — エンベロープは保持されるユニークなオリジナルとともに成長し、セッションのライフサイクルを共有します;フットプリントは `acp_status` で確認できます。セッションごとの統計(保存バイト、現在のワイヤーバイト節約、retrieve レート)は `acp_status` に表示されます;各 retrieve は `[ccr] retrieve …` 行を記録します。 + +#### `search` + +- **型:** `object` (`{ planAware? }`) +- **デフォルト:** *(オフ — 未設定は `planAware: false` に解決;出力はプレーンなレキシカル検索とバイト単位で同一)* +- **ステータス:** ACTIVE (CCR v3 プラン認識検索、#1336 — 測定されるまでデフォルトオフ;プロキシモード + プラグインモード) +- **説明:** `search_context` 用のオプトイン**プラン認識検索** (issue #1336)。有効化されると、クエリが `limit` より多くのブロックに一致する場合、候補はコンテキスト内メッセージビューから抽出された現在のプラン状態に対して再ランキングされます:各プランニングツールの最後のツール呼び出し(組み込みパターン `TodoWrite`, `todowrite`, `todo_list`, `update_plan`, `TaskCreate`, `TaskUpdate`、およびすべての `compress.protectedLatestTools` パターン — カーネルのスナップショット保護と同じ最新優先セマンティクス)と、最近のユーザーターン。候補トピック/サマリーは、その状態との加重語重複によってスコアリングされます;スコアがゼロ以上のブロックが最初にソートされ、同点は元のレキシカル順序を保持します。そのときのみ2つのことが起こります:返されるサブセットが純粋なレキシカルカットと異なる可能性があり、`[plan-aware]` スティアリングセクションが追加されます。(a) `top fetch targets:` — 最高スコアの返されたブロックのカバーされた参照スパン、(b) このセッションで2回以上取得されたカバーされた参照へのヒント、繰り返し `acp_retrieve` の代わりにワンショット `decompress({blockId, startId, endId})` 範囲復元を指します。フラグがオフの場合、コンテキストにプラン状態がない場合、またはマッチプールが `limit` に収まる場合、出力は機能以前とバイト単位で同一です。ランキングは候補順序にのみ触れます — ストア/フォールド/注入メカニクスは変更されず、新しい永続化はなく、外部セッション検索(`conversation_id`)は読み取り専用レキシカルのままです。すべての再ランキングは、ブロックごとのスコアを含む `[acp-search-plan] …` 行を記録します。コンパニオン統計:ブロック全体の decompress は `acp_status` の `RETRIEVAL QUALITY` 行の下でカウントアップされます(合計、およびより安価な精密パスが利用可能だったものの数 — すなわちブロックが参照スパンを持ち CCR がアームされていた場合);したがって、有効化前後で retrieve-vs-decompress のトレードオフを測定できます。サブフィールド(他の CompressSettings フィールドと同様に最も深いものが優先してマージ): + - `planAware: boolean` — メイナスイッチ;`true` 以外のものは機能を完全にオフに保ちます。 + +#### `rules` + +- **型:** `boolean` +- **デフォルト:** `false` +- **ステータス:** ACTIVE +- **説明:** **永続モデルリマインダー** (issue [ranxianglei/billion-context-pi#433](https://github.com/ranxianglei/billion-context-pi/issues/433)、`acp-kernel` rules API を通じて)、**デフォルトでオフ** — 有効にするには `compress.rules: true` を設定します(#1399 の決定:有効化されると、モデルはセッションルールに対して完全な権限を持ち、削除/クリアを含むプロンプトなしで呼び出すことができます)。有効化されると、`acp_rule` ツールが ACP ツールとともに注入されます:短い `rule` 引数で呼び出すと、**ハード保護**された原則レベルのリマインダーが記録されます(呼び出し + 結果はすべてのフォールドを通じてコンテキストに残る)、引数を省略すると記録されたルールがリストされます。ルール ID(例: `"rule3"`)とともに `delete` を渡すと、その1つのルールを削除します(`Removed ruleN: `);`clear: true` を渡すとすべてのルールを削除します。これらは互いに排他であり、`rule` ともに排他です — 1回の呼び出しにつき1つの操作 — したがって、古いまたは誤って記録されたルールは、カウンタールールでヘッジするのではなく削除できます。*いつ*記録すべきか(ユーザーが強調した教訓、ユーザーが記憶を要求する行動、遭遇した重大な落とし穴)に関するガイダンスは完全にツール説明内にあります — システムプロンプトには何も追加されません。カーネル制限が適用されます(50 ルール × 各 300 文字);重複テキストは既存の ID を指して拒否されます。注入は `absorb` と全く同じようにワイヤーのネイティブツールサーフェスに従います:プロキシモードは anthropic/openai/responses ネイティブツールワイヤーでツールを注入し、プラグインモードは**有効な間のみ**プラグインマニフェストで宣伝します(ホストはマニフェストのツールを逐語に登録します — 無効なツールの宣伝はそれらを壊します、#1192;実行はセッションごとにゲート)。記録されたルールはセッション状態で再起動後も永続化され、削除も同様に永続化されます。`acp-kernel` >= 0.0.70 が必要(削除/クリアには >= 0.0.84)。人間はモデルを経由せずに完全な操作セットを得られます:pi/omp はツールと同じセマンティクスのネイティブ `/acp-rule` コマンドを公開します — プレーン `/acp-rule` はすべての記録されたルールをリストし、`/acp-rule ` は1つを直接記録し、`/acp-rule remove ` は1つを削除し、プレーン `/acp-rule clear` はすべての記録されたルールを消去します(`clear ` は消去するのではなく記録します)(#1251; remove/clear は #1399 で追加)。 + +#### `reasoning` + +- **型:** `object` (`{ drop?, threshold? }`) +- **デフォルト:** `drop: true`, `threshold: 2048` — オン +- **ステータス:** ACTIVE +- **説明:** **圧縮推論衛生** (issue #651、`billion-context-pi` #339/#348 / `opencode-acp` #377 のプロキシ側ツイン)。`reasoning`/`thinking` トレースをワイヤーに保持するモデルは、永久に圧縮不能なフロアを蓄積します:フォールドのアンカーは `compress` 呼び出しであり、その呼び出し*以前*にある推論メッセージは保護プレフィックスの一部としてすべてのフォールドを生き延びます — 再要約されることは決してなく、ストリップされるだけです。ストームセッションでは、このフロアは可視コンテキストの約50%に達しました。オンの場合、プロキシは**クローズド**な `compress` 呼び出しの直前にある推論ランを削除します — **ラウンド証拠**によるクローズド:呼び出しのツール結果(`contentType: "tool-result"`、一致する `toolCallId`)が後のインデックスに到着し、その後少なくとも1つのメッセージが存在すること。ユーザーメッセージは必要ないため、長いエージェントセッションもラウンドをクローズします [#348 ツイン]。安全ゲート:*進行中*のラウンド(結果欠落、または結果がまだ最後のメッセージ)には決して触れません;通常のツール呼び出し(`read`, `bash`, …)のランは推論を保持します;ランはその合計長によって判定されるため、2×1200 文字のランでも 2048 ゲートに引っかかります;非連続な推論(断片間のテキスト)はそのままにされます。サブフィールド(他の CompressSettings フィールドと同様に最も深いものが優先してマージ): + - `drop: boolean` — キルスイッチ;`false` は古いワイヤーを逐語で復元します。`tools` を持つリクエストで `reasoning` ラウンドトリップを必須とする思考モデルのプロバイダーごとに必要です — DeepSeek、GLM thinking、Qwen-QwQ は、以前の `reasoning_content` がエコーバックされない場合 HTTP 400 を返します。#684 以降、これはほぼ自動です:`deepseek` アップストリーム**およびボディの `model` ID が `/deepseek/i` に一致するリクエスト** (#1027 — 非 deepseek ゲートウェイから提供される DeepSeek モデル) は静的に検出され、**Anthropic ワイヤー**では履歴に**署名付き思考ブロック**を持つ任意のリクエストはリクエストごとに drop を無効にします (#1658 — 署名付き思考はその `tool_use` 兄弟とラウンドトリップする必要があり、そうでない場合アップストリームはペアを拒否するため、drop するとペアが孤立します;拡張思考のないセッションには影響しません)、そして `reasoning_content` を言及するボディで 400 を返す**任意の**アップストリームは、セッションに推論を保持することを教えます(自己修復、セッションスコープ;オペレーションログは `[acp-loop] learned strictReasoningEcho` を持ちます)。設定は他の厳格な推論アップストリームのための手動エスケープハッチのままです: + ```jsonc + "providers": { "https://api.deepseek.com": { "compress": { "reasoning": { "drop": false } } } } + ``` + - `threshold: number` — 文字数ゲート;これより**厳密に大きい**ランは drop されます(`0` = 空でない任意のランを drop)。無効な値はスローするのではなくデフォルトにフォールバックします。 + +#### `reasoningGuard` + +- **型:** `object` (`{ enabled?, maxContinue?, maxTierN?, markerText?, base?, offset?, debugLog? }`) +- **デフォルト:** *(無効 — あるレベルで `enabled: true` を設定しない限りオフ)* +- **ステータス:** ACTIVE +- **説明:** gpt-5.x/gpt-6.x の**「格子」推論切り詰め**に対するオプトインガード (issue #739; アップストリーム [openai/codex#30364](https://github.com/openai/codex/issues/30364))。これらのモデルは間歇的に正確に `base*n + offset` 推論トークン(デフォルト `518n−2` → 516, 1034, 1552, …)で思考の途中で停止し、半端な思考から回答します。スコープ内のターミナルラウンドが格子にヒットし**かつ** `encrypted_content` ブロブを持つ場合、bili はレスポンスをバッファリングし、独自の推論をリプレイして継続ナッジ(最大 `maxContinue` 継続ラウンド)を再送信し、すべてを1つのレスポンスに折りたたみ、その使用量は真の合計になります。推論ストリームはフォールド中にクライアントにライブで配信されます(完全なバッファリングなし);最終クリーンラウンドの非推論出力のみがパススルーされます。Responses/SSE ストリーミングリクエストにのみ適用されます(bili は SSE のみ);compress 注入ターンは免除されます(ループがそれらを所有)。サブフィールド(他の CompressSettings フィールドと同様に最も深いものが優先してマージ): + - `enabled: boolean` — メイナスイッチ;`true` 以外のものはガードを完全にオフに保ちます。スコープは、このブロックが3レベルツリー(グローバル / プロバイダー / モデル)の**どこ**に存在するかによって設定されます — 別個のモデルリストはありません。厳密なシグネチャ(正確な格子ヒット + `encrypted_content` + ツール呼び出しなし)は、実際に回復をトリガーするラウンドを制限します。 + - `maxContinue: number` — 初期ラウンド後の最大継続ラウンド数(デフォルト `3`)。 + - `maxTierN: number` — 継続が許可される最高格子ティア `n`(デフォルト `6`);`0` = 無制限。稀な深層ティア切り詰めのために引き上げます(例: gpt-6-astra で観察された `n=11` ヒット)。 + - `markerText: string` — 各継続ラウンドでコメントメッセージとして追加されるナッジテキスト(デフォルト `"Continue thinking..."`)。 + - `base: number` / `offset: number` — 格子シグネチャ `tokens == base*n + offset`(デフォルト `518` / `-2`)。別のモデルファミリーが異なる格子で切り詰める場合は上書きします。 + - `debugLog: boolean` — 詳細なラウンドごとのログ(デフォルト `false`)。 + ```jsonc + // enable globally + { "compress": { "reasoningGuard": { "enabled": true } } } + // tune per provider (placement scopes it to that provider's traffic) + { "providers": { "https://your-relay.example": { "compress": { "reasoningGuard": { "enabled": true, "maxContinue": 2 } } } } } + ``` + +#### `priceProfile` + +- **型:** `object` (`{ w?, r?, q? }`, すべて非負数) +- **デフォルト:** *(未設定 — レポートはリクエストモデルの models.dev 価格行から絶対 $/Mtok でフォールドを価格付け;レジストリが解決できないモデルのみがカーネルの組み込み相対比率 `{ w: 1, r: 0.1, q: 4 }` にフォールバック)* +- **ステータス:** ACTIVE +- **説明:** セッションキャッシュレポート(`acp_cache` ツール / `/acp-cache` コマンド / `GET /__bili/cache-report`、#800/#1279)内の**キャッシュ経済学的判定**のための価格プロファイル。フォールドごとの P&L フィールド(`oneTimeCostUnits`, `perTurnSavingUnits`, `breakevenTurns`, `paidBack`)は、入力トークン単位に対する3つの乗数から計算されます:`w` (キャッシュ書き込みコスト)、`r` (キャッシュ読み取りコスト)、`q` (出力コスト)。2つの単位規約が共存し、両方ともレポートヘッダー(`FOLD ECONOMICS (N folds @ w=.. r=.. q=..)`)に逐語で印刷されます: + - **ユーザー設定**は**入力価格 (p_in = 1) に正規化された比率**を使用します:`w` = cacheWrite ÷ input、`r` = cacheRead ÷ input、`q` = output ÷ input。サブフィールドは他の CompressSettings フィールドと同様に3レベル間で最も深いものが優先してマージされます(プロバイダーレベルで `q` を設定し、モデルレベルで1フィールドを微調整);部分プロファイル内で未設定のフィールドはカーネル比率 `w: 1`, `r: 0.1`, `q: 4` にフォールバックします。 + - **レジストリデフォルト**(どのレベルもキーを設定しない):リクエストモデルの models.dev 価格行から導出 — **絶対 $/Mtok**、`w = cost.input`、`r = cost.cache_read ?? 0.1 × input`、`q = cost.output ?? 1.5 × input`(それらのフィールドのない行のための規約フォールバック)。プロバイダー直接トラフィックはそのホスト自身のリスティングを取得します;不明なリレーはホスト間で最初の一致するリスティングを取得します(リスティングが競合する場合、一度の警告)。ライブレジストリは到達可能なら優先し、バンドルスナップショットはオフラインフロアです (#282)。 + ユーザー設定は全体として優先します — どのレベルで設定されたプロファイルも、レジストリ行とフィールドごとに混合されることはありません。最後のリクエストの有効な値はセッションにスタンプされるため、すべてのレポートフェイスは、そのセッションの最近のターンを支配したプロファイルでフォールドを価格付けします。**レポート専用**:プロファイルは圧縮トリガー、頻度、または任意のワイヤー動作に影響しません。ユーザー設定の例(リレーのカスタムマークアップなど、レジストリ行を上書き): + ```jsonc + // DeepSeek-V3 ≈ low output multiple + { "providers": { "https://api.deepseek.com": { "compress": { "priceProfile": { "w": 1, "r": 0.1, "q": 1.5 } } } } } + // OpenAI GPT-4o/o-series: 50% cached-read discount, flat writes, 4× output + { "providers": { "https://api.openai.com": { "compress": { "priceProfile": { "w": 1, "r": 0.5, "q": 4 } } } } } + // Self-hosted / free tier: everything costs zero tokens of your budget + { "compress": { "priceProfile": { "w": 0, "r": 0, "q": 0 } } } + ``` + 同じモデルの通常入力価格に対するリスト価格を使用してください;カスタムマークアップを持つリレーは、その有効なレートを使用すべきです。 + +#### `outputSteering` + +- **型:** `object` (`{ enabled?, verbosityLevel?, effortRouting? }`) +- **デフォルト:** *(無効 — あるレベルで `enabled: true` を設定しない限りオフ)* +- **ステータス:** ACTIVE +- **説明:** オプトインの**出力側圧縮** (issue #1093):*出力*トークンを削減する2つのリクエスト時レバー、それらは入力よりも高く、ストリーミングされた瞬間に請求されます。決定ロジック(ターン分類、L0–L4 ディレクティブ文言、エフォートクランプ)は acp-kernel にあり、エージェント側と共有されます;bili は他のすべてのボディ変更の後、それをワイヤーに落地させるだけです: + - **冗長性スティアリング** — システムプロンプトの**末尾**に追加される決定的な簡潔性ディレクティブ(決して前置しない — それならクライアントのプロンプトバイトをシフトし、プレフィックスキャッシュを壊す)。センチネルラップされ、冪等です:リトライはそれを蓄積せず、レベル変更はインプレースで置き換えます。なお、文言はリリース間でバイト安定です(カーネル文言編集は、そのレベルのすべてのセッションにとってプレフィックスキャッシュバスターです)。 + - **エフォートルーティング** — 最後のユーザーターンを構造的に分類(ブロック構成のみ、コンテンツパターンマッチングなし);*機械的継続*(クリーンなツール結果、エラーなし、新しいユーザーシグナルなし)の場合、既に存在するエフォートフィールドは最小値に向かってクランプされます。クランプのみ:クライアントが送信しなかったフィールドを注入することはない(エフォートサポートのないモデルはそれで 400 になる)、`thinking.type` を切り替えることはなく、`minimal` を上げることはありません。ワイヤー:OpenAI `reasoning_effort`、Responses `reasoning.effort`、Anthropic `thinking.budget_tokens` (フロア 1024)、Gemini `generationConfig.thinkingConfig.thinkingBudget` (フロア 128; `-1` ダイナミックは触れない)。 + - サブフィールド(他の CompressSettings フィールドと同様に最も深いものが優先してマージ):`enabled: boolean` メイナスイッチ;`verbosityLevel: number` 0–4 (0 = ディレクティブなし、デフォルト 2);`effortRouting: boolean` (`enabled` のときデフォルトオン)。範囲外の値はブロックを拒否するのではなく、**警告とともに**デフォルトにフォールバックします。4つのすべてのワイヤー(openai chat / responses / anthropic / google)に適用されます;システムキャリアのないリクエストは触れられません(スキップ-if-absent)。 + ```jsonc + // enable globally + { "compress": { "outputSteering": { "enabled": true } } } + // only lower effort, no wording directive + { "compress": { "outputSteering": { "enabled": true, "verbosityLevel": 0 } } } + // per provider (placement scopes it to that provider's traffic) + { "providers": { "https://your-relay.example": { "compress": { "outputSteering": { "enabled": true, "verbosityLevel": 3 } } } } } + ``` + +#### `stripImages` — REMOVED + +- **型:** ~~`boolean`~~ / **`stripImagesKeepRecent`** ~~`number`~~ — 削除済み (2026-10、#2607/#2640 のフォローアップ) +- **説明:** オプトインのワイヤー側画像ストリップはもはや存在しません。デフォルトのメディア折りたたみ (#2640: アーカイブ可能なメディアは他のメッセージと同様に折りたたまれ、フォールド前に `/retrieve/img//` 下にピクセルがアーカイブされ、`decompress({ imageRef })` がそれらを復元する) がそれを冗長にし、ストリップ自体は4つのワイヤーのうち3つでターンごとのプロンプトキャッシュブレイカーでした(そのスライディングカットオフ `len - keepRecent` は毎ターンバイト境界を移動する;anthropic のみフォールドアンカー修正を持っていた)。まだ `compress.stripImages` / `compress.stripImagesKeepRecent` を持つ設定は不活性です:キーは無視され、一度の `[acp-config] … INERT` 警告がこの注記を指します。bili が保存できないバイトを持つメディア(リモート URL、ファイル参照)はワイヤーにピン留めされたままです — #2609 を参照。 + +#### `visibilityMarkers` + +- **型:** `boolean` +- **デフォルト:** `true` +- **ステータス:** ACTIVE +- **説明:** プロキシがプロキシツール呼び出し(`compress` / `decompress` / `search_context` / `acp_status`)を実行した後に発行される 📦/❌ ACP 可視性マーカーを制御します。オンの場合、各実行はレスポンスストリームにマーカー行を追加し、および/またはそのラウンドの再構築履歴にマーカーメッセージを再注入し、モデルが後のターンで何が起きたかを見られるようにします。両方の成果物を抑制するには `false` に設定します — モデルがマーカーを模倣またはナレーションするデプロイメントのために(独自の確認行やコメントを出力;issue #862 を参照)。ツール実行自体には影響しません:呼び出しは依然として実行され、ペアリングされたツール呼び出し/ツール結果メッセージは通常通り記録されます;マーカー行/メッセージのみが省略されます。#913 以降、`false` はナッジと注入された compress プロンプトに追加されるマーカー完全性注記から #862 沈黙条項も削除します — 不可視デプロイメントにはモデルが模倣またはナレーションするマーカーがないため、そこでは条項は純粋なノイズです。#717 偽造防止セグメントはすべての設定で無条件のままです。他のすべてのフィールドと同様の3レベルマージ。#717 偽造防止によるモデル発行の偽マーカーのストリップはこのフラグとは独立しており、アクティブのままです。 + +#### `messageTimestamps` + +- **型:** `boolean` +- **デフォルト:** `true` +- **ステータス:** ACTIVE +- **説明:** メッセージタイムスタンプ (#4313, PR #5236; リーク監査フォローアップ以降デフォルトオン):bili は初見時に各メッセージに1つの不変なローカルタイムスタンプを発行し、それをレンダリングします — ワイヤー上のすべての `` 圧縮タグの `time="yyyy-MM-dd HH:mm:ss"` 属性、各 compress レシートフィンガープリント行に追加される `[start – end]` カバレッジスパン、レンダリングされたブロックサマリーの Occurred 行。可視の場合、コストはメッセージあたり約8トークンです。スタンプは決定的なレンダリング入力です(保存された値からレンダリングされ、決してウォールクロックではない)ため、再レンダリングされた履歴はターンごとにバイト安定のままです;ライブセッション監査は、フラグオンとオフで同じプロンプトキャッシュヒットレートを示しました。#4313 以前のバイトを正確に再現するには `false` に設定します(time 属性なし、オリジナルプロンプトテキスト、フィンガープリントスパンなし)。スタンプはどちらの場合も保存に記録されるため、後でオプトインしてもデータ損失なしで完全な履歴が表示されます。フラグが true に解決される最初の再起動は、アクティブなセッションごとに1回のフローズンプレフィックスキャッシュ書き換えを支払います。解決は環境変数(`BILI_MESSAGE_TIMESTAMPS`; `0` はオフを強制、他の値はオンを強制、BILI_RESIGN と同じ規約)が設定ファイルを上書きし、プロキシインスタンスごとに一度解決されます — フラグの変更には再起動が必要です。 +### 注入トグル(グローバルのみ) + +これら2つのトグルは **グローバル** レベルでのみ有効です。プロバイダーごとまたはモデルごとの `compress` ブロック内で設定しても効果はありません。 + +#### `injectTool` + +- **型:** `boolean` +- **デフォルト:** `true` +- **ステータス:** ACTIVE +- **説明:** `compress` / `decompress` / `search_context` ツールおよび圧縮システムプロンプトを各リクエストに注入します。ツール注入を完全に無効にするには `false`(または `ACP_COMPRESS_TOOL=0`)を設定してください。 + +#### `injectNudge` + +- **型:** `boolean` +- **デフォルト:** `true` +- **ステータス:** ACTIVE +- **説明:** 使用量しきい値を超えた際に、自動圧縮ナッジメッセージを注入します。ナッジ注入を無効にするには `false`(または `ACP_COMPRESS_NUDGE=0`)を設定してください。`injectTool` と `injectNudge` の両方を無効にすると、機能面では `passthrough` に類似しますが、プロキシはトークン使用量をトラッキングし続けます。 + +### なぜ最初のコンパクト化は200kまで待つか + +コンパクト化は絶対的なウィンドウ位置ではトリガーされ**ません** — トリガーされるのは**成長間隔**です:デフォルトでは、セッションが**起動コンテンツから50kトークン成長した**後に最初のソフトコンパクト化が発火します +([`nudgeGrowthTokens`](#nudgegrowthtokens)、ウィンドウサイズに依存しない平坦なステップ)。したがって、最初のコンパクト化の絶対的な位置は ≈ **起動 + +50k** となります: + +- 起動 30k–50k(dsh のデフォルト)→ 最初のコンパクト化は約80k–100kで発生; +- 起動が約100k、または成長ステップが約100kに設定されている場合 → 最初のコンパクト化は + **約200k** まで待たされる可能性があります。 + +強制しきい値([`maxContextLimit`](#maxcontextlimit)、デフォルト 75%)は +バックストップにすぎず、*実効* ウィンドウに適用されます — 出力リザーブ +`min(max_tokens, outputHeadroomMaxPct × window)`(キャップデフォルト `0.25`、 +[`outputHeadroomMaxPct`](#outputheadroommaxpct) を参照)が最初に差し引かれます。 +リザーブは通常小さく、リクエストが非常に大きな `max_tokens` を伴う場合にのみ +25% のキャップに達します:262,144トークンのウィンドウで +`max_tokens = 131072` → 実効ウィンドウ 196,608 → 強制ライン ≈147k;同じ +ウィンドウで8kのリザーブ → 強制ライン ≈190k。 + +その後、頻度は成長ベースのまま維持されます:圧縮可能な成長ごとに +50k ごとに +1回の増分コンパクト化。ローカルモデルでは、各コンパクト化は完全な再プリフィル +です — 重い起動と大きなウィンドウは、1つの長いタスクにそれらを複数回含める +ことになり、これがウォールクロック時間が2〜3倍長くなる原因となります。 + +最初のコンパクト化をより早く発火させ(トークンを節約し)るには、この順序で: + +1. **システムプロンプトをトリムし、不要なツールを無効にし、スキルを剪定する** — 起動 + サイズは最初のコンパクト化の絶対的な位置を直接決定します; +2. **`nudgeGrowthTokens` を約50kに下げる**(特に100kに引き上げられていた場合); +3. **リーンモードを有効にする**(`promptPack: "lean"`); +4. **`maxContextLimit` を下げる**(例:`"40%"`) — 圧迫バンドはその使用量レベルで + 圧縮を要求し始めるようになり、成長頻度を待つことはなくなります;デフォルトの + 75% バックストップが及ばない状態で、アップストリームまたはクライアントが大きな + リクエストで劣化する場合(タイムアウト、最初のバイトが遅い)に使用してください + (#4007)。45% 未満の場合、acp-kernel はターンごとの検証警告をログ出力します — + ノイズのみで、しきい値には影響しません。 + +チューニング前に、`/acp` または Web UI で実際の起動/コンテキスト使用量を測定してください。 + +### 弾性ヘッドルーム付きソフトターゲット(#1122) + +自律エージェントは同時に2つのことを望むことが多いです:*アクティブ* コンテキストを小さく保つこと(コスト/レイテンシ)、そして本当に必要とされる場合(例:大きなファイルの読み取り)には、単一のタスクがそのターゲットを大きく超えてバーストすることを許可すること。`modelContextLimit` をモデルのネイティブウィンドウ未満に設定しても、それを表現することはできません — 1つのフィールドが同時に2つの役割(使用率比の分母 **かつ** ハードプリフライト壁)を担っているため、それを超えるペイロードはタスク途中で折りたたまれたり、素早く失敗したりします(#1122)。 + +代わりに、既存のソフトバンドで表現してください:制限をネイティブウィンドウに保ち、`maxContextLimit` でターゲットを固定します: + +```jsonc +// model with a 200k native window; keep ~70k active, allow bursts up to the real edge +{ + "compress": { + "modelContextLimit": 200000, // = native window → hard wall only at the true edge + "maxContextLimit": "35%" // forced-nudge zone starts ≈ 70k (= target ÷ native window) + } +} +``` + +圧縮が実際にどのように決定するか(acp-kernel、検証済み): + +1. **成長レイヤー(日常の駆動要因、絶対トークン):** 前向きなナッジは、最後のアンカー(セッション開始 / 最後のナッジ / 圧縮後のリセット)以降の累積成長が成長ゲートに達し**かつ**十分な圧縮可能な質量が蓄積されたときに1回発火します。両方の数値は設計上、絶対値でありウィンドウに依存しません:成長ステップはすべてのウィンドウサイズで平坦な50kです(カーネル `nudge.growthFloor == nudge.growthCap == 50000`、ゴールデンピン済み;ウィンドウパーセンテージのスケーリングは意図的に削除されました — #379/#380;`nudgeGrowthTokens` でオーバーライド可能);成長ゲートは `max(20k, 0.45 × step)` ≈ 22.5k であり、T1 パスはさらに1ステップ(50k)以上の圧縮可能な質量を必要とします。このレイヤーは、パーセンテージバンドよりはるかに下でも、長いセッションを圧縮し続けます。 +2. **圧迫レイヤー(ウィンドウのパーセンテージ):** `usage ≥ maxContextLimit`(デフォルト 75%)→ コンテキストが再び下回るまで、各ターンでナッジが注入されます;`usage ≥ emergencyThresholdPercent`(デフォルト 95%)→ 強制ナッジ + 緊急切り詰め。 +3. **資格レイヤー(カーネルデフォルト 45%、公開されていません):** ターン1のコールドスタートチケットと、T2/T3 ティアエスカレーションのブロック数フロアのみをゲートします — 日常のパスの一部ではありません。 + +注:`maxContextLimit` をカーネルの45%デフォルト未満に設定しても正しく動作します(レイヤーは独立しているため)、しかし acp-kernel はターンごとの検証警告(`minContextLimitPct must not exceed maxContextLimitPct`)をログ出力します — ログノイズのみで、しきい値には影響しません。 + +古い低制限設定(例:`modelContextLimit: 70000`)との比較:ハード壁は70kからネイティブウィンドウに移動します(大きな読み取りがタスク途中で潰されたり、素早く失敗したりしなくなります);強制ゾーンは75%×70k ≈ 52.5kから、選択した%×ネイティブに移動します;強制ゾーン未満では、コンテキストは毎ターン固定されるのではなく、成長レイヤーに従ってドリフトします — そのドリフトは弾性の代価です。厳密な日常の上限 *かつ* バーストヘッドルームを同時に必要とする場合、静的なパーセンテージバンドでは両方を表現できません;許容できる上限の%を選択するか、構造認識圧縮を追跡してください(#344)。 + +同じフィールドはプロバイダーごと / モデルごと(3レベルマージ)で機能し、Web UI によるホットリロードも可能です。 +### 3レベルマージの例 + +この例では、グローバルデフォルト、プロバイダーごとのオーバーライド、モデルごとのオーバーライドがフィールド単位でスタックされる様子が示されています: + +```jsonc +{ + // Level 1 — global: applies to every request + "compress": { + "maxContextLimit": "75%", + "emergencyThresholdPercent": "95%", + "nudgeGrowthTokens": 50000, + "tiers": true, + "injectTool": true, + "injectNudge": true + }, + + "providers": { + "https://api.anthropic.com": { + // Level 2 — per-provider: overrides global fields for this provider + "compress": { + "maxContextLimit": "70%", // compress a bit earlier here + "preserveRecentMessages": 8 // keep more recent turns + }, + "models": { + "claude-sonnet-4-5": { + "context": 200000, + // Level 3 — per-model: the deepest, highest priority + "compress": { + "modelContextLimit": 180000, // treat window as 180k (leaves headroom) + "emergencyThresholdPercent": "90%" + } + } + } + } + } +} +``` + +`https://api.anthropic.com/v1/messages` へのリクエストでモデルが `claude-sonnet-4-5` の場合、解決された設定は以下のようになります: + +| フィールド | 解決元 | 値 | +|-------|---------------|-------| +| `maxContextLimit` | プロバイダー(レベル 2) | `"70%"` | +| `emergencyThresholdPercent` | モデル(レベル 3) | `"90%"` | +| `nudgeGrowthTokens` | グローバル(レベル 1) | `50000` | +| `preserveRecentMessages` | プロバイダー(レベル 2) | `8` | +| `modelContextLimit` | モデル(レベル 3) | `180000` | +| `tiers` | グローバル(レベル 1) | `true` | + +--- +## 環境変数 + +環境変数は設定ファイルよりも優先されます。ファイルの編集なしで、環境固有の上書き(CI、コンテナなど)を行う場合に便利です。 + +**優先度モデル (#2030)。** すべての動作制御項目は **環境変数 > 設定ファイル > ビルトインデフォルト** の順で解決されます。#2030 以降、すべての純粋な動作制御項目には設定ファイルのキーも用意されたため、デプロイメント全体を `billion-context.json` に記述することが可能になりました。環境変数は依然として上書きレイヤーとして機能します。*設定済み* の環境変数は、その値が不正であっても、その制御項目を所有します — #2030 以前と同様に正確にパースされ(デフォルトにフォールバックする)、ファイルレイヤーに漏洩したり、ファイルレイヤーによってシャドウされたりすることはありません。環境変数のみで管理される変数は、ファイルに格納できないもの(シークレット(`BILI_LAUNCH_TOKEN`、`BILI_ENCRYPTION_KEY`)、別の bili コンポーネントがスポン時に書き込むプロセス単位のチャネル(`BILI_MCP_PROXY`、`BILI_PARENT_PID`、`BILI_STRICT_PORT`、`BILI_OPENCODE_ACP_SPEC`、`BILI_LAUNCHER_MODEL_*`)、サードパーティ製ホストプロセス内で読み取られるホスト側の姿勢(`BILLION_CONTEXT_PLUGIN*`、`BILI_NATIVE_*`、`BILI_RECLAIM_FETCH_PATCH`)、パスの再配置(`BILI_CONFIG_FILE`、`BILI_SESSIONS_DIR`、`ACP_DUMP_DIR`、`XDG_*`)、およびサードパーティの慣習(`CLAUDE_CODE_SESSION_ID`、`CODEX_HOME`、`https_proxy`))に予約されています。新しい制御項目は、AGENTS.md の "Environment Variable Discipline" に記載されているルールに従います。 + +### 環境制御項目の設定ファイルキー (#2030) + +ファイルキーは、対応する環境変数が未設定の場合にのみ解決されます。括弧内のデフォルト値は、ビルトインのものです。 + +| 環境変数 | 設定ファイルキー | デフォルト | +|---------|------------|--------| +| `` | `pi.commands` | ["acp", "acp-cache"] | +| `ACP_AUTO_RESTART_ON_UPDATE` | `autoRestartOnUpdate` | false | +| `ACP_AUTO_UPDATE` | `autoUpdate` | true | +| `ACP_COMPRESS_NUDGE` | `compress.injectNudge` | true | +| `ACP_COMPRESS_PROTOCOL` | `diagnostics.compressProtocol` | "tools" | +| `ACP_COMPRESS_TOOL` | `compress.injectTool` | true | +| `ACP_COUNT_TOKENS_PASSTHROUGH` | `diagnostics.countTokensPassthrough` | false | +| `ACP_DEBUG` | `debug` | false | +| `ACP_DUMP_BODY` | `diagnostics.dumpBody` | false | +| `ACP_DUMP_REQ` | `diagnostics.dumpReq` | true | +| `ACP_DUMP_SSE` | `dumpSse` | unset (directory) | +| `ACP_HOST` | `host` | 127.0.0.1 | +| `ACP_KEEP_RESPONSE_ID` | `compat.keepResponseId` | false | +| `ACP_LOG` | `log` | true | +| `ACP_LOG_FILE` | `logFile` | XDG state path (off disables the file, keeps stderr) | +| `ACP_MODEL_CONTEXT_LIMIT` | `modelContextLimit` | 200000 | +| `ACP_NO_COMPRESS_PROMPT` | `diagnostics.noCompressPrompt` | false | +| `ACP_NO_INJECT_TOOL` | `diagnostics.noInjectTool` | false | +| `ACP_PASSTHROUGH` | `passthrough` | false | +| `ACP_PORT` | `port` | 8787 | +| `ACP_PROMPT_CACHE_ROUTING` | `promptCache.routing` | disabled | +| `ACP_PROVIDERS` | `providersPath` | unset | +| `ACP_RAW_DUMP_DIR` | `diagnostics.rawDumpDir` | /raw | +| `ACP_RENDER_NONE` | `diagnostics.renderNone` | false | +| `ACP_SESSION_HEADER` | `sessionHeader` | x-acp-session | +| `ACP_UPDATE_TAG` | `updateTag` | latest | +| `ACP_UPSTREAM` | `upstream` | https://api.anthropic.com | +| `BILI_ADVISORY_CHECK` | `advisoryCheck` | true | +| `BILI_ADVISORY_URL` | `advisoryUrl` | unset (built-in feed) | +| `BILI_AFFINITY_SIMHASH` | `affinitySimhash` | true | +| `BILI_ALLOW_DSH_COMPACTION` | `dsh` | {} | +| `BILI_ALLOW_PRIVATE_HTTP_PROVIDERS` | `network.allowPrivateHttpProviders` | false | +| `BILI_ANNOUNCEMENTS_URL` | `remoteAnnouncementsUrl` | unset (official feed: GitHub master announcements/remote.json) | +| `BILI_AUTO_MODE_FORGE` | `autoModeForge.enabled` | true | +| `BILI_CACHE_KEEPALIVE` | `cacheKeepalive.enabled` | false | +| `BILI_CACHE_KEEPALIVE_ARM_WITHOUT_BREAKPOINTS` | `cacheKeepalive.armWithoutBreakpoints` | false | +| `BILI_CACHE_KEEPALIVE_ASSUME_TTL` | `cacheKeepalive.assumeTtl` | null (detect from body breakpoints) | +| `BILI_CACHE_KEEPALIVE_INTERVAL_MS` | `cacheKeepalive.intervalMs` | null (derive from TTL tier) | +| `BILI_CACHE_KEEPALIVE_MAX_DURATION_MS` | `cacheKeepalive.maxDurationMs` | 86400000 | +| `BILI_CACHE_KEEPALIVE_MAX_PINGS` | `cacheKeepalive.maxConcurrentPings` | 4 | +| `BILI_CACHE_KEEPALIVE_TTL_FACTOR` | `cacheKeepalive.ttlFactor` | 0.9 | +| `BILI_CA_FILE` | `network.caFile` | unset | +| `BILI_CCR_RETRIEVAL_TTL_MS` | `ccrRetrievalTtlMs` | 600000 (0 disables retrieval) | +| `BILI_CHAIN_CONTENT` | `chainContentDetection` | false | +| `BILI_CHAIN_STAMP` | `chainEgressStamp` | false | +| `BILI_CLAUDE_NATIVE_PORT` | `claude.nativePort` | unset (lane sticky zone port) | +| `BILI_CLIENT_ERROR_BACKSTOP_MS` | `network.clientErrorBackstopMs` | 30000 | +| `BILI_CODEARTS_REF` | `resign` | {} (armed; built-in scheme sdk-hmac-sha256) | +| `BILI_CODEX_COMPACT` | `codexCompact` | "intercept" | +| `BILI_DECODED_BODY_BYTES` | `network.decodedBodyBytes` | 10737418240 | +| `BILI_DECOMPRESS_TMP_CAP` | `decompressTmpCap` | 50 | +| `BILI_DSH_AUTHORED_COMPACTION` | `dsh.authoredCompaction` | true (on, #3901 flip) | +| `BILI_DSH_CONTEXT_TAB` | `dsh.contextTab` | true | +| `BILI_DUMP_4XX` | `diagnostics.dump4xx` | false | +| `BILI_DUMP_4XX_MAX_BYTES` | `diagnostics.dump4xxMaxBytes` | 2097152 (floor 1024) | +| `BILI_DUMP_MAX_AGE_DAYS` | `diagnostics.maxAgeDays` | unset (off) | +| `BILI_DUMP_MAX_TOTAL_BYTES` | `diagnostics.maxTotalBytes` | unset (off) | +| `BILI_EXPOSURE_LOG_INTERVAL_MS` | `network.exposureLogIntervalMs` | 3600000 (0 disables the log) | +| `BILI_FAKE_BUF_CAP` | `fakeCompletion.bufCapBytes` | 16777216 | +| `BILI_FAKE_COMPLETION_RETRIES` | `fakeCompletion.retries` | 0 (opt-in) | +| `BILI_FOLD_RECONCILE` | `compress.reconcile` | "repair" | +| `BILI_FORK_ADOPTION` | `forkAdoption` | false | +| `BILI_GUARDRAIL_BASH_TIMEOUT` | `guardrails.bashTimeout` | 60 | +| `BILI_GUARDRAIL_MAX_OUTPUT_BYTES` | `guardrails.maxOutputBytes` | 50000 | +| `BILI_GUARDRAIL_REPETITION` | `guardrails.repetition` | true | +| `BILI_GUARDRAIL_TEXT_RUN_THRESHOLD` | `guardrails.textRunThreshold` | 200 | +| `BILI_HTTP_OUTBOUND_BYTES` | `network.httpOutboundBytes` | 10485760 | +| `BILI_IMAGE_BILLING` | `imageBilling` | auto (resolves to pixels) | +| `BILI_IMAGE_RESCALE` | `imageRescale` | true | +| `BILI_IMAGE_TOKEN_CAP` | `imageTokenCap` | unset (uncapped) | +| `BILI_INGEST_BODY_BYTES` | `network.ingestBodyBytes` | 33554432 | +| `BILI_INVARIANT_JUDGE` | `diagnostics.invariantJudge` | true | +| `BILI_KEEP_ALIVE_TIMEOUT_MS` | `network.keepAliveTimeoutMs` | 5000 | +| `BILI_LOG_BUDGET_BYTES` | `diagnostics.logBudgetBytes` | 268435456 (256 MiB, floor 1 MiB) | +| `BILI_LOG_MASK_HOSTS` | `maskHosts` | true | +| `BILI_LOG_RETENTION_HOURS` | `diagnostics.logRetentionHours` | 48 (floor 1) | +| `BILI_MAX_MESSAGES` | `network.maxMessages` | 0 | +| `BILI_MAX_SESSIONS` | `sessions.max` | 256 | +| `BILI_MAX_SHRINK_PER_COMPRESS` | `network.maxShrinkPerCompress` | unset | +| `BILI_MCP_PROXY` | `native.attachUrl` | unset (discover per lane) | +| `BILI_MESSAGE_TIMESTAMPS` | `compress.messageTimestamps` | true | +| `BILI_MITM` | `mitm.enabled` | true | +| `BILI_MITM_DOMAINS` | `mitm.domains` | [] | +| `BILI_MITM_HANDSHAKE_TIMEOUT_MS` | `mitm.handshakeTimeoutMs` | 10000 | +| `BILI_MYSQL_DSN` | `storage.mysql.dsn` | unset | +| `BILI_NATIVE_ATTACH_EXTERNAL` | `native.attachExternal` | false | +| `BILI_NATIVE_ATTACH_POLICY` | `native.attachPolicy` | own-lane | +| `BILI_NON_HTTP_PROVIDERS` | `compactionOptIn` | false | +| `BILI_NO_CACHE_CONTROL` | `compat.noCacheControl` | false | +| `BILI_OPENCODE_INLINE` | `opencode.inline` | false | +| `BILI_OUTBOUND_BODY_BYTES` | `network.outboundBodyBytes` | 5368709120 | +| `BILI_PERSIST` | `persist.enabled` | true | +| `BILI_PERSIST_DEBOUNCE_MS` | `persist.debounceMs` | 500 | +| `BILI_PERSIST_EPERM_ALERT_REPEAT_MS` | `persist.epermAlertRepeatMs` | 0 (no repeats) | +| `BILI_PERSIST_EPERM_ALERT_THRESHOLD` | `persist.epermAlertThreshold` | 5 | +| `BILI_PERSIST_MAX_DELAY_MS` | `persist.maxDelayMs` | 5000 | +| `BILI_PERSIST_TAIL_TOKENS` | `persist.tailTokens` | 16384 (0 disables message persistence) | +| `BILI_PERSIST_ZSTD` | `persist.zstd` | false | +| `BILI_PERSONA_SPLIT` | `personaSplit` | true | +| `BILI_PI_INLINE` | `pi.inline` | true (unset env+file runs inline) | +| `BILI_POST_RESPONSE_LINGER_MS` | `network.postResponseLingerMs` | 5000 | +| `BILI_PREFLIGHT_DEAD_END_COOLDOWN_MS` | `network.preflightDeadEndCooldownMs` | 300000 | +| `BILI_PREFLIGHT_HOLD_MS` | `network.preflightHoldMs` | 30000 | +| `BILI_PROXY_KEEPALIVE_MAX_MS` | `network.proxyKeepAliveMaxMs` | 55000 (0 = one-shot connections) | +| `BILI_PUBLIC_SNAPSHOT_CAP_BYTES` | `plugin.snapshotCapBytes` | 104857600 (0 disables snapshots) | +| `BILI_RECEIVE_BODY_BYTES` | `network.receiveBodyBytes` | 5368709120 | +| `BILI_RELEASE_NOTES_CHECK` | `releaseNotesCheck` | true | +| `BILI_RELEASE_NOTES_URL` | `releaseNotesUrl` | unset (built-in feed) | +| `BILI_REPLAY_RETRY_BASE_MS` | `network.replayRetryBaseMs` | 1500 (0 disables the delay) | +| `BILI_REPLAY_RETRY_MAX` | `network.replayRetryMax` | 3 (1 disables replays) | +| `BILI_REQUEST_WATCHDOG_MS` | `network.requestWatchdogMs` | 2× upstreamTimeoutMs | +| `BILI_RESIGN` | `resign` | {} (armed; built-in scheme sdk-hmac-sha256) | +| `BILI_RESIGN_BENEFIT` | `resign` | {} (armed; built-in scheme sdk-hmac-sha256) | +| `BILI_RESIGN_PASSTHROUGH` | `resign` | {} (armed; built-in scheme sdk-hmac-sha256) | +| `BILI_RESUME_INHERITANCE` | `resumeInheritance` | true | +| `BILI_ROLLOUT_` | `rollout.features.enabled` | unset (bucket math decides) | +| `BILI_ROLLOUT_IDENTITY_CHANNEL_HARVEST` | `rollout.features.identityChannelHarvest` | 0 (off) | +| `BILI_ROLLOUT_PLUGIN_FULL_RESEND_WATERMARK` | `rollout.features.pluginFullResendWatermark` | 5 (experimental grey) | +| `BILI_ROLLOUT_PLUGIN_LANE_SERVER_HISTORY` | `rollout.features.pluginLaneServerHistory` | 0 (off) | +| `BILI_SESSION_CONTENT_STORE_PIN` | `sessions.contentStorePin` | false | +| `BILI_SESSION_GC` | `sessions.gc.enabled` | false | +| `BILI_SESSION_GC_INTERVAL_MS` | `sessions.gc.intervalMs` | 3600000 | +| `BILI_SESSION_GC_MAX_AGE_DAYS` | `sessions.gc.maxAgeDays` | 7 | +| `BILI_SESSION_GC_MAX_TOKENS` | `sessions.gc.maxTokens` | 1000000 | +| `BILI_SESSION_RESIDENT_HARD_MAX_BYTES` | `sessions.hardMaxBytes` | (same as `sessions.residentMaxBytes`) | +| `BILI_SESSION_RESIDENT_MAX_BYTES` | `sessions.residentMaxBytes` | 4294967296 | +| `BILI_SESSION_WARM_MAX` | `sessions.warmMax` | 0 | +| `BILI_SESSION_WARM_MAX_BYTES` | `sessions.warmMaxBytes` | 67108864 | +| `BILI_SQLITE_AUTO_DOWNLOAD` | `storage.sqliteAutoDownload` | true | +| `BILI_STABLE_SYSTEM_ANCHOR` | `stableSystemAnchor` | false | +| `BILI_STORAGE_ARCHIVE_AFTER_DAYS` | `storage.archiveAfterDays` | 365 | +| `BILI_STORAGE_BACKEND` | `storage.backend` | unset (sqlite) | +| `BILI_STORAGE_JSON_WRITER` | `storage.jsonWriter` | on | +| `BILI_STORAGE_UNIFIED` | `storage.unified` | unset (full) | +| `BILI_STORAGE_WAL_JOURNAL_SIZE_LIMIT_BYTES` | `storage.walJournalSizeLimitBytes` | 8388608 | +| `BILI_STREAM_ERROR_SHAPE` | `compat.streamErrorShape` | protocol | +| `BILI_STREAM_KEEPALIVE_MS` | `network.streamKeepAliveMs` | 15000 (0 disables) | +| `BILI_SUBAGENT_SPLIT` | `subagentSplit` | true | +| `BILI_THROTTLE_429` | `network.throttle429Enabled` | true | +| `BILI_THROTTLE_429_BASE_DELAY_MS` | `network.throttle429BaseDelayMs` | 2000 | +| `BILI_THROTTLE_429_MAX_CONSECUTIVE` | `network.throttle429MaxConsecutive` | 5 | +| `BILI_THROTTLE_429_MAX_DELAY_MS` | `network.throttle429MaxDelayMs` | 30000 | +| `BILI_THROTTLE_429_SCOPE` | `network.throttle429Scope` | credential | +| `BILI_UPDATE_CHECK_INTERVAL_MS` | `update.checkIntervalMs` | 180000 | +| `BILI_UPDATE_POLICY_URL` | `update.policyUrl` | official repo raw URL | +| `BILI_UPDATE_REGISTRY` | `update.registry` | "npmjs" (registry.npmjs.org) | +| `BILI_UPDATE_STAGGER_MAX_MS` | `update.staggerMaxDelayMs` | 172800000 (built-in 48 h) | +| `BILI_UPDATE_STAGGER_MIN_MS` | `update.staggerMinDelayMs` | 900000 (built-in 15 min) | +| `BILI_UPSTREAM_FIRST_BYTE_MS` | `network.upstreamFirstByteMs` | = upstreamTimeoutMs (resolved; 720000 when unset) | +| `BILI_UPSTREAM_PROXY` | `proxy` | unset (direct) | +| `BILI_UPSTREAM_PROXY_MODE` | `upstreamProxyMode` | auto (unset behaves as direct) | +| `BILI_UPSTREAM_TIMEOUT_MS` | `network.upstreamTimeoutMs` | 720000 | +| `BILI_WS_OUTBOUND_BYTES` | `network.wsOutboundBytes` | 10485760 | +| `PI_ACP_DELEGATE_ASYNC_TIMEOUT_MINUTES` | `pi.subagents` | {} (acp_delegate enabled with package defaults) | +| `PI_ACP_DELEGATE_FORCE_ENABLE` | `pi.subagents` | {} (acp_delegate enabled with package defaults) | +| `PI_ACP_DELEGATE_IDLE_TIMEOUT_MINUTES` | `pi.subagents` | {} (acp_delegate enabled with package defaults) | +| `PI_ACP_DELEGATE_MAX_CONCURRENT` | `pi.subagents` | {} (acp_delegate enabled with package defaults) | +| `PI_ACP_DELEGATE_MAX_DEPTH` | `pi.subagents` | {} (acp_delegate enabled with package defaults) | +| `PI_ACP_DELEGATE_SYNC_TIMEOUT_MINUTES` | `pi.subagents` | {} (acp_delegate enabled with package defaults) | +| `PORT` | `port` | 8787 | +| `— (file-only)` | `guardrails.repetition.abort` | 5 | +| `— (file-only)` | `guardrails.repetition.enabled` | true | +| `— (file-only)` | `guardrails.repetition.recovery` | false | +| `— (file-only)` | `guardrails.repetition.warn` | 3 | + + +| 変数 | 効果 | +|----------|--------| +| `ACP_DEBUG` | `1` に設定すると詳細ログが有効になります(`"debug": true` と同じ)。 | +| `ACP_PASSTHROUGH` | `1` に設定すると、圧縮なしで転送します(`"passthrough": true` と同じ)。 | +| `ACP_COMPRESS_TOOL` | `0` に設定すると、ツール注入を無効にします(`"compress.injectTool": false` と同じ)。 | +| `ACP_COMPRESS_NUDGE` | `0` に設定すると、ナッジ注入を無効にします(`"compress.injectNudge": false` と同じ)。 | +| `ACP_MODEL_CONTEXT_LIMIT` | グローバルなデフォルトのコンテキスト上限(絶対トークン数)— 最終手段のウィンドウソース: ルート/モデルごとの宣言、レジストリエントリ、組み込みテーブルの値がモデルに対して解決されない場合のみ参照されます。ネイティブに解決されたウィンドウを制限することはありません (#5908)。特定のモデルのウィンドウを固定するには `compress.modelContextLimit` を使用してください。 | +| `BILLION_CONTEXT_NODE` | Node ホストプロセスでないホストプロセスがプロキシを起動する際に使用される Node 実行可能ファイルへの明示的なパス (#819/#1429)。Node 自身ではないホスト内部での解決順序: このオーバーライド → PATH 検索および GUI の PATH に含まれない既知のインストール場所 (`/opt/homebrew/bin`, `/usr/local/bin`, Volta など) → Electron ホスト自身のバイナリをプレーンな Node として実行 (`ELECTRON_RUN_AS_NODE=1`、最終手段 — deepseek-harness desktop などのデスクトップアプリはゼロ設定で動作します)。発見されたすべての候補は `--version` で検証され、メジャーバージョンが 20 以上である `vX.Y.Z` を報告する必要があります (#3383): 単に `node(.exe)` と*名前*が付けられた外部プログラム(引数を無視して終了コード 0 で終了する Microsoft HPC Pack のクラスタ CLI など)は、起動される代わりに警告とともにスキップされます — このようなプログラムが PATH 上で本物の Node より前にある場合は、この変数を明示的に設定してください。特定の Node(例: ホストにバンドルされたランタイムより新しいもの)を強制するために設定できます。常にフォールバックより優先されます。 | +| `BILI_CCR_RETRIEVAL_TTL_MS` | キューに入れられたが未配信の `acp_retrieve` 注入の有効期限 (ms) (#1343): 完全なテキストがこの間ずっとキューに残り、上流リクエストに乗る機会が一度もなかった場合、**明確に**破棄されます — 参照情報と理由付きの警告ログ、`stats.retrieveDropped` の増加、そして次のリクエストでモデルに `acp_retrieve` の再発行を促す補正ノート。デフォルトは `600000` (10分); `0` で有効期限を無効にします。プラグインレーンのキュー項目のみ対象です。範囲復元ライダー (#1207) は対象外です。 | +| `BILI_IMAGE_TOKEN_CAP` | プリフライトサイズゲート、出力クランプ、画像圧縮統計で使用される画像ごとのトークン推定値の上限 (#488/#496/#1843)。解決された課金モードの上に適用されます — 実際のエンコーダがピクセル事前確率よりも低い課金を行うルートに対する包括的な上限です。両方の設定レベル ([`imageTokenCap`](#imagetokencap)) より優先されます。リクエストごとにライブ読み込み (再起動不要)。未設定 = 設定へのフォールバック (`providers..imageTokenCap`、次にグローバル)、デフォルトは上限なし。 | +| `BILI_IMAGE_BILLING` | プリフライトサイズゲートと出力クランプで使用される画像課金モードのオーバーライド (#767/#1843): `pixels` または `bytes`。リクエストごとにライブ読み込み (再起動不要); グローバルの `imageBilling` およびすべてのプロバイダーごとの `providers..imageBilling` より優先されます。#1843 以降、デフォルトはすべてのホストに対して `pixels` に解決されるため、プロセス全体で保守的なバイト課金を強制するには `bytes` を使用してください (例: バイトカウントリレー) — ルートごとの設定はより狭い範囲のツールとして残ります。[`imageBilling`](#imagebilling) を参照してください。 | +| `BILI_IMAGE_RESCALE` | 送信画像のダウンスケールパス (#3400) を無効 (`"0"` または `"false"`) にするか、有効のまま (それ以外) にするか: 大きな送信画像は縮小されて送信され、オリジナルはセッションストレージ内でバイト単位で正確に保持されます。リクエストごとにライブ読み込み (再起動不要); 設定ファイルのキー [`imageRescale`](#imagerescale) より優先され、そのデフォルトはオンです。 | +| `BILI_IMAGE_RESCALE_MAX_DIM` | 送信ダウンスケールパスの最長辺トリガー閾値 (px) (#3400): 画像の最長辺がこの値を超えた場合、または base64 ボディが 100 KB を超えた場合に、リサイズ候補となります。fit-inside リサイズはアップスケールしません。デフォルトは `1600`; 数値でない場合や `128` 未満の値は無視されます (デフォルトが適用されます)。設計上、環境変数のみです — 設定ファイルへのミラーはありません。[`imageRescale`](#imagerescale) を参照してください。 | +| `BILI_PREFLIGHT_HOLD_MS` | 長時間のプリフライト圧縮が keep-alive バイトでクライアントを保持し始めるまでの猶予期間 (ms) (デフォルト `30000`; #568 を参照)。 | +| `BILI_STREAM_KEEPALIVE_MS` | ストリーミングフェーズのクライアント保持 (#1647): SSE レスポンスがこのミリ秒数にわたってクライアントにゼロバイトしか書き込んでいない場合、bili は 1 行の SSE コメント行 (`: bili-keepalive`、仕様レベルの no-op) を発行し、クライアントの undici `bodyTimeout` (デフォルト 300秒; Node 組み込み fetch はリクエストごとにオーバーライドできません) が、上流がリライター/ストリップパイプを飲み込むピンポンで応答している長時間プリフィルを殺すのを防ぎます。デフォルトは `15000`; `0` で無効にします。`BILI_PREFLIGHT_HOLD_MS` の兄弟で、後者は圧縮プリフライトの沈黙をカバーし、これはストリーミング中の上流起因の沈黙をカバーします。 | +| `BILI_RECLAIM_FETCH_PATCH` | `0` に設定すると、ネイティブモードの fetch 自己修復リアームを無効にします (#1158)。デフォルトでは、ネイティブ fetch インターセプトは `globalThis.fetch` をガード付きアクセサとしてインストールするため、`globalThis.fetch` を再インストールするサードパーティのパッチ (例: dsh-http-proxy の設定リフレッシュが凍結された pre-bili `originalFetch` を書き込む場合) は下流として再チェーンされ、モデルトラフィックは bili を通ってルーティングされ続けます。`0` の場合、従来の直接インストールが残ります: サードパーティのリアームが勝つため、そのセッションで bili はモデルトラフィックを見なくなります。**送信メモ:** ガードが保持されている間、クレームされたモデルトラフィックは bili プロキシ自身によってディスパッチされます — サードパーティチェーンの送信 (例: dsh-http-proxy で設定された SOCKS5 プロキシ; bili 自身のアップストリームプロキシングは HTTP プロキシのみサポート) に乗らなくなります。サードパーティの送信を復元する必要がある場合は、`0` を設定し、bili レベルで送信を設定してください (`"proxy": "http://…"` )。**共存メモ (#3528):** デフォルトのアクセサ形式は、`globalThis.fetch` がプレーンな書き込み可能データプロパティであることを要求するサードパーティコンポーネントと互換性がありません — 彼らはプロパティディスクリプタを読み取り、`value` を見つけず、ロード時に fetch 観測者を中断します (報告済み: DSH Desktop の Developer Tools / NodeJS 診断プラグイン、`@deepseek-ai/dsh-experimental-inspector`)。そのような観測者が従来の直接インストール経由でロードされるように `0` を設定してください (その後ホストを完全に再起動); 上記のトレードオフを受け入れます。#3528 を参照してください。 | +| `BILI_RESIGN` | `0` に設定すると、#1884 の再署名アームをエンドツーエンドで展開解除します (修正前の動作: 署名されたボディは通常の書き換えパスに乗って上流で 401 で失敗します)。デフォルト: アーム済み — 再署名可能な (解決可能なクレデンシャルを持つ SDK-HMAC-SHA256) 署名されたモデルリクエストは、すべての送信ボディが再署名されてトンネルされます; このアームは dsh での設定を必要としません (クレデンシャルサービス経由のアカウントプール検出)。再署名できない (解決可能なクレデンシャルがない) BUILT-IN スキームのリクエストは、実行可能なメッセージとともにローカルで 403 で拒否されます — その修正 (クレデンシャルの提供) は実行可能です。検出されたその他のすべてのスキーム (SigV4、`x-ofm-signature` のようなゲートウェイ発明ヘッダー — 検出は形状ベース、#2090) は bili のどこにもクレデンシャルソースがないため、常に拒否されます (バイナリ契約: 再署名+圧縮、または拒否、署名なしでのパススルーは決してない): スキーム名を特定した 403、`resign-pending.json` に記憶され、bili がそのスキームの再署名機能をリリースするまで、すべての起動時に再警告されます (Web UI でも表示)。`BILI_RESIGN_PASSTHROUGH=1` は BUILT-IN スキームのみに対して、圧縮なしの逐語転送をオンにします — その他のすべてのスキームに対しては無効です。`enabled` / `passthrough` / `credentialRef` は [`resign`](#resign) ブロックの下に設定ファイルの双子を持ち、署名スキームをキーとします (`resign["sdk-hmac-sha256"]`; `providers..resign[""]` はレベル 2 のオーバーライド) — 環境変数はファイルより優先されます。スキームキーはパススルーのオプトインを固定します: そのキーが設定されたスキームのみがトンネルされます。関連: `BILI_RESIGN_BENEFIT` (署名付き `maas_type: benefit` ヘッダーが付与される CodeArts ベネフィットモデルのコンマ区切りリスト — 3 層ツリー全体より優先; ファイル側の双子はレベル 3 の `models..benefit` ブール値で、未設定の場合は組み込みの `glm-5.3-flash,deepseek-v4.1-flash` にフォールバックし、dsh codearts プラグインの `CODEARTS_BENEFIT_FALLBACK` を反映) および `BILI_CODEARTS_REF` (有効な `codearts` アカウントを `$DSH_HOME/jet-hub/state.json` から検出する代わりに、再署名に使用される dsh クレデンシャルサービス ref を強制)。 | +| `BILI_CONFIG_FILE` | 設定ファイルのパスをオーバーライド (任意の JSON ファイルを指定)。 | +| `ACP_PORT` / `PORT` | リスニングポートをオーバーライド。 | +| `ACP_HOST` | リスニングホストをオーバーライド。 | +| `ACP_UPSTREAM` | デフォルトのアップストリームベース URL をオーバーライド。 | +| `ACP_LOG` | `0` に設定すると、リクエストログを無効にします。 | +| `ACP_AUTO_UPDATE` | `0` に設定すると、自動更新チェックを無効にします。ファイル設定キー: `autoUpdate`。 | +| `ACP_AUTO_RESTART_ON_UPDATE` | `1` (任意の `0` 以外の値) に設定すると、自動更新インストール後の自己再起動を有効にします (#811): 再起動には進行中のリクエストがゼロであること、インストール健全性チェックをパスすること、10 分間のクールダウンマーカーを尊重すること、失敗時に元のリスナーを再開することが必要です。ファイル設定キー: `autoRestartOnUpdate`。 | +| `ACP_UPDATE_TAG` | 自動更新プログラムが追跡する dist-tag チャンネル (デフォルト `latest`、例: `dev`)。ファイル設定キー: `updateTag`。ローリング `pr` タグはすべての PR にわたる最新の PR テストビルドを追跡します; レガシーな PR 別 `pr-N` タグはその PR の最後のビルドで凍結され、明示的に設定された場合のみ追跡されます。ローリング `master` タグは master にマージされた最新のビルドを追跡します — すべての非リリースマージが 1 つ公開します (#2049); マージ済み但未リリースの状態を追跡するにはこれを設定してください。 | +| `BILI_UPDATE_REGISTRY` | 自動更新プログラムと `bili update` が使用する npm レジストリのベース URL のオーバーライド (デフォルト `https://registry.npmjs.org`)。ループバックレジストリ (e2e スイートの `ACP_TEST_REGISTRY` 内の verdaccio インスタンス) に対する密閉テストを想定しています; 本番環境では未設定のままにしてください (#1153)。 | +| `BILI_UPDATE_CHECK_INTERVAL_MS` | 自動更新チェックの間隔 (ミリ秒) (デフォルト `180000`、つまり 3 分; 0 以下の値は無視されデフォルトが適用されます)。密閉 e2e スイートでは短縮され、完全なサイクルを待たないようにしています (#1153)。 | +| `BILI_UPDATE_STAGGER_MIN_MS` | ランダムなアップグレード遅延ウィンドウの下限 (#3619): 新しいバージョンを発見した後、自動アップグレードは [min, max] 内の抽選された時刻まで待機します — 未設定の場合は組み込み 15 分。リモートポリシーの `default` より優先されます; `0` でこのマシンの遅延を無効にします (レガシーの即時アップグレード)。ここでは生の ms; ファイルの双子は期間文字列 (`"15m"`) も受け入れます。 | +| `BILI_UPDATE_STAGGER_MAX_MS` | ランダムなアップグレード遅延ウィンドウの上限 (#3619) — 未設定の場合は組み込み 48 時間。両方の境界が `0` に設定されている場合、アップグレードは #3619 以前と同様に即時に行われます。ここでは生の ms; ファイルの双子は期間文字列 (`"2d"`) も受け入れます。 | +| `BILI_UPDATE_POLICY_URL` | リモート更新ポリシー JSON URL のオーバーライド (#3619)。デフォルト: 公式リポジトリの raw アドレスにある `auto-update-policy.json` — 設計上固定されています。ポリシーはタイミング/スキップ/ピンを誘導できますが、インストールソースは決して変更できないためです; オーバーライドは密閉テストのために存在します。ファイルの双子: `update.policyUrl`。 | +| `BILI_MODEL_INFO_RETRY_MS` | dsh ネイティブプラグインが、解決に失敗したかウィンドウを返さなかった現在のモデルのコンテキストウィンドウを再解決するまでのクールダウン (ms) (#1812/#1836): ウィンドウのないキャッシュエントリは最終的ではありません — プロセスの生存期間中ヘッダーなしに固定する代わりに、このクールダウン後の次のリクエストがリトライをトリガーします。デフォルトは `30000`; 数値でない場合や負の値は `30000` にフォールバックします。テストフック — dsh-native ユニットテストでは壁時計を待たないように短縮されています; 本番環境では未設定のままにしてください。 | +| `BILI_DSH_RETRY_INTERVAL_MS` | dsh ネイティブプラグインのツール登録リトライ間のバックオフ (ms) (#2082): マニフェスト取得またはツール登録が一時的に失敗した後、次のリトライはこのクールダウンより早く行われません。デフォルトは `10000`; 数値でない場合や非正の値は `10000` にフォールバックします。テストフック — dsh-native ユニットテストでは壁時計を待たないように短縮されています; 本番環境では未設定のままにしてください。 | +| `BILI_DSH_RECOVERY_INTERVAL_MS` | dsh ネイティブプラグインのデタッチされたリカバリータイマーの間隔 (ms) (#2082): ツールがダウンしている間、モデルトラフィックがゼロでも登録リトライを駆動し続けます — モデルが欠落ツールを諦め、他の何ものもループを再アームしない場合です。デフォルトでは `BILI_DSH_RETRY_INTERVAL_MS` (`10000`) に従います。テストフック — NODE_TEST_CONTEXT 下では、この変数が明示的に設定されない限りタイマーは開始されません; 本番環境では未設定のままにしてください。 | +| `BILI_DSH_MAX_TESTED_VERSION` | テスト済みより新しい dsh ブートノートの上限 (dsh ネイティブレーン): 実行中の dsh ビルド — 注入されたバンドルの上にある最も近い `node_modules/@deepseek-ai/dsh/package.json` から解決 — はこの最新テスト済みバージョンと比較され (semver、プレリリース対応)、厳密に新しい場合、サポートが実装されるまで上限バージョンへのロールバックを助言する 1 つの永続的なブート時ノート (dsh セッション内) を得ます。片方向のみ: 上限以下または等しいビルドは沈黙します。既知の旧ビルドの破損モードには独自のオーバーレイラッチ検出器があるためです (#3806 ブート警告 + #2474 フォールバック)。設計上ソフトです: 警告のみで、トラフィックをゲートまたはブロックしません (誤った推測が動作しているセッションを停止させてはならないため)。デフォルト = `0.2.0-rc.2`、CI e2e アンカー (.github/workflows/ci-e2e-dsh-native.yml); ビルドが検証されるにつれて上限を上げてください; 空文字列はこのレーンでのチェックをオフにします。解決不能/解析不能なバージョンは沈黙にフェイルオープンします (証拠の欠如 ≠ 破損ビルド)。 | +| `BILI_ADVISORY_CHECK` | `0` に設定すると、重大欠陥アドバイザリーウォッチャーを無効にします (#1481)。デフォルトはオン — `ACP_AUTO_UPDATE` に独立して実行されるため、自動更新をオフにしたインストールでも、既知の破損バージョン範囲から強制更新されます。フェイルオープン: 到達不能/不正なソースは警告のみで、モデルトラフィックをブロックしません。ファイル設定キー: `advisoryCheck`。 | +| `BILI_ADVISORY_URL` | アドバイザリー文書 URL のオーバーライド。デフォルト: 設定されたレジストリ (`BILI_UPDATE_REGISTRY` 対応) 上のコンパニオンパッケージ `billion-context-advisories`。ファイル設定キー: `advisoryUrl`。 | +| `BILI_RELEASE_NOTES_CHECK` | `0` に設定すると、リリースノート可視性ウォッチャーを無効にします (#1870)。デフォルトはオン — 純粋な可視性、デフォルトでは沈黙 (#1977): コンパニオンリリースノート文書をフェッチし、保留スパンに `critical` ティアのエントリを含む場合のみ、`acp_status` と `/acp` パネルで "CRITICAL update ready — restart to finish" (ディスクが実行中より新しい) または "critical update available" を表示します; 常時/推奨リリースは決して表示されません。決してインストールせず、再起動しません; フェイルオープン。ファイル設定キー: `releaseNotesCheck`。 | +| `BILI_RELEASE_NOTES_URL` | リリースノート文書 URL のオーバーライド。デフォルト: 設定されたレジストリ (`BILI_UPDATE_REGISTRY` 対応) 上のコンパニオンパッケージ `billion-context-release-notes`。ファイル設定キー: `releaseNotesUrl`。 | +| ~~`BILI_HOST_USAGE_CREDIT`~~ / ~~`hostUsageCredit`~~ | **#660 で削除。** ホスト向けの使用量モードを選択するために使用されていました。#408 の非圧縮ベースラインバックフィルは完全に削除されました — すべてのホストは実際に転送された (折り畳み後) リクエストをプロバイダー測定として報告します (`[acp-usage] input=` に一致)。環境変数または設定ファイルに残された古い値は無視されます; 削除してください。PR #691 の "Bug history lesson" セクションを参照してください。 | +| `ACP_PROVIDERS` | 外部 `providers.json` へのパス (レガシー / 共有ファイル)。 | +| `BILI_REPLAY_RETRY_BASE_MS` | 一時的な上流拒否後のリプレイリトライのベースバックオフ遅延 (ms) (デフォルト `1500`; `0` で遅延を無効にします)。#189 を参照。また、メインパスのトランスポートリトライバックオフも駆動します (#1688)。 | +| `BILI_REPLAY_RETRY_MAX` | リプレイリトライの総試行回数 (デフォルト `3`; `1` でリトライを完全に無効にします — レガシーの単一試行動作)。#189 を参照。acp-loop/preflight/compress ループでは、一時的な HTTP 失敗と #1263 のフェイルファストネットワーク失敗 (レスポンス前のリセット/拒否 — プロキシリサイクルクラス) の両方に適用されますが、タイムアウト/中断タイプには適用されません。メインモデルリクエストパス (#1688) では、フェイルファストのレスポンス前ネットワーク失敗のみがリプレイされます; HTTP 判定 (4xx/5xx) は常に逐語通り、再試行されません。 | +| `BILI_PROXY_KEEPALIVE_MAX_MS` | アップストリームプロキシを介した接続の keep-alive 再利用上限 (ms) (デフォルト `55000`)。一般的なプロキシは約 60 秒の周期でアイドルトンネルをリサイクルします; 再利用ウィンドウをそれより低く制限することで、いくつかの再接続と引き換えに、典型的な "アイドル後の最初のリクエストが ECONNRESET で死ぬ" 失敗 (#1263) を回避します。`0` = 上限なし (undici デフォルト)。直接 (プロキシなし) 接続には影響しません。 | +| `BILI_UPSTREAM_TIMEOUT_MS` | アップストリームリクエストのアイドル予算 (ms): 最初のバイトまでの時間とボディチャンク間の時間 (デフォルト `720000` = 12 分)。チャンクを生成し続ける健全なストリームは飛行中に切断されることはありません; 沈黙しているものは切断されます。同じ値が基礎となる HTTP クライアントのトランスポートタイムアウトを駆動するため、この単一のノブがローカルモデルの長時間プリフィルをエンドツーエンドで制限します (#551)。 | +| `BILI_CA_FILE` | bili 自身のアップストリーム TLS 信頼用の追加ルート CA を含む PEM ファイルへのパス (#3776)。HTTPS/暗号化接続スキャンを行うセキュリティソフトウェア (Kaspersky、エンタープライズ DLP) または企業 MITM プロキシは、独自の CA でアップストリームを再署名します: ブラウザは OS 証明書ストア経由でそれを信頼しますが、Node の fetch は組み込みルートと `NODE_EXTRA_CA_CERTS` のみを読み取ります — したがって、マシンの他の部分が正常に接続している間に bili は `SELF_SIGNED_CERT_IN_CHAIN` で失敗します。スキャナ/ベンダーのルートを PEM にエクスポートし、これ (または `NODE_EXTRA_CA_CERTS`) を設定してください; あるいは、ソフトウェアの HTTPS 検査から node.exe を除外してください。ファイルは Node の組み込みルートと `NODE_EXTRA_CA_CERTS` エントリと Merged され、決して置き換えられません。未設定 = 今日のデフォルトの信頼、バイト単位で一致。ファイル設定キー: `network.caFile`。 | +| ~~`BILI_STREAM_STALL_MS`~~ | **#1714 で削除** (#1452 のオプトインストリーミングフェーズストールガードは廃止)。#1706 で、古い `400` エクスポートがすべての思考フェーズの沈黙を偽の切り詰めに変えました; ローカルモデルデプロイメントはストリーム中 (思考フェーズ、長時間プリフィル) に正しく数分間沈黙するため、すべての人にとって安全な有限なサブ予算はありませんでした。上流の沈黙 — プリフィルとストリーム中を問わず — は現在、常にオンである `BILI_UPSTREAM_TIMEOUT_MS` のアイドル予算 (デフォルト 12 分、調整可能) によってのみ制限されます。古い値は無視されます; bili は起動時に一度だけ古いエクスポートを特定します (`no longer read`) — シェルプロファイルから削除してください。 | +| `BILI_KEEP_ALIVE_TIMEOUT_MS` | クライアント向けソケットの keep-alive タイムアウト (ms) (デフォルト `5000`、Node の暗黙のデフォルトに一致; #1452)。アイドルのクライアント接続は Node の組み込みリーパーによってクリーンな FIN で刈り取られます; これにより、以前は暗黙的だった値を明示的かつ設定可能にし、刈り取りは接続ライフサイクル台帳 (デバッグログ) で `reason=idle-timeout` として分類されます。数値でない場合や非正の値は `5000` にフォールバックします。 | +| `BILI_EXPOSURE_LOG_INTERVAL_MS` | 周期的な長期間露出テレメトリ行 `[exposure] uptime=… liveConns=… tcpHandles=… handles=… sessions=… blindTunnels=… inFlight=…` の間隔 (ms) (デフォルト `3600000` = 毎時; #1452)。`0` で無効にします。ソケットハンドルのリークとゾンビ接続が、事後の法医学ではなく、長時間実行ログに表示されるように存在します。 | +| `BILI_CLIENT_ERROR_BACKSTOP_MS` | clientError ドレインパスのターミナルバックストップ (ms) (#1529、#1452 アイテム 1 のフォローアップ): 300ms のドレイン bailout が FIN を決して送信しないピアを持つ接続を `end()` した後、ソケットはそれ以外の場合、私たちの側で半開き状態で無限に座り続けます — keep-alive リーパーは完了したレスポンスをキーとし、Node はデフォルトで SO_KEEPALIVE を有効にしません。この bailout 後の沈黙が経過した後、プロキシはソケットを破棄し、接続ライフサイクル台帳で独自の警告マーカーとともに `reason=clienterror-backstop` として分類します。#1452 の RST シグネチャに対して安全です: ソケットはウィンドウ全体で `resume()` ドレインされているため、破棄には未読の残存バイトがありません。デフォルトは `30000`; `0` でピアの死まで保持する現状を復元します。数値でない場合や負の値は `30000` にフォールバックします。 | +| `BILI_POST_RESPONSE_LINGER_MS` | 完了したレスポンス後のグレースフルクローズ予算 (ms) (#1982): プロキシが最後のレスポンス直後にクライアント接続のクローズを開始する場合 (例: `Connection: close`)、ピアのクローズシグナル — TCP FIN または TLS close_notify、これは私たちの最終バイトが受信+ACK された後にのみ到着可能 — を待ってソケットを開いたままにします — その後クリーンにクローズします; 予算内にシグナルが到着しない場合、ソケットはそれでも破棄され、`reason=linger-backstop` (警告行) として分類されます。これにより、クライアント側で未 ACK のバイトを RST に競合させる可能性のある中断的な破棄が除去されます (nginx `lingering_time` と同等)。デフォルトは `5000`; 数値でない場合や非正の値は `5000` にフォールバックします。エラー駆動のクローズ、ハンドシェイク前の破棄、clientError ドレイン (#1529)、アイドルリーパーは意図的に影響を受けません。 | +| `BILI_ALLOW_PRIVATE_HTTP_PROVIDERS` | オプトインスイッチ (#2984): プライベートネットワーク (RFC1918, 127/8, リンクローカル、IPv6 ULA/リンクローカル、`*.local`/`.lan`/`.internal`) 上のプレーン HTTP プロバイダー baseURL が、エージェントレジストリの受入とサマリーエンドポイントガードを通過できるようにするには `1`/`true` に設定します。それ以外の場合は、ループバックのプレーンテキストのみを信頼します。パブリック IP/ドメインと CGNAT (100.64/10) は常に拒否されます。デフォルトはオフ — #2984 以前と動作が同一です。設定された環境変数の値は `network.allowPrivateHttpProviders` より優先されます。 | +| `ACP_SESSION_HEADER` | 会話 ID ヘッダー名 (デフォルト `x-acp-session`)。 | +| `ACP_REASONING_KEEP` | Responses API のみ: `none` に設定すると、すべての推論アイテムを破棄します。デフォルトでは、推論は圧縮パイプラインを通過し、そのターンが要約されると自動的に隠されます (Codex のプロンプトキャッシュプレフィックスを破った無制限な蓄積を防ぎます)。 | +| `ACP_RENDER_NONE` | `1` に設定すると、送信リクエスト履歴へのメッセージごとのレンダリングタグ ( `mNNNNN` 参照を持つ `` `` `` マーカー) の注入を停止します — すべてのワイヤ形式 (OpenAI chat, Anthropic, Responses) およびコンパクト再構築に適用されます (#933)。デフォルトは `text-only`: モデルはこれらの参照を読み取り、`compress` 呼び出しでメッセージを引用するため、参照ベースの圧縮を必要としないワークフローであることが確認できた場合のみ無効にしてください (例: タグの反響がクライアント可視出力に漏れる)。以前は、この変数は Responses パスとコンパクトでのみ尊重されていました; #933 ですべてのパスに拡張されました。 | +| `ACP_LOG_FILE` | ログファイルのパス (デフォルト XDG state パス; `off` でファイルを無効にし、stderr を保持)。10 MB で自動ローテーション。 | +| `ACP_DUMP_SSE` | デバッグ用に生の SSE フレームをダンプするディレクトリ — ループ起因の上流レスポンス (compress 再リクエストと切り詰めリトライ、`--loop-raw.sse` と命名) を含む。これらは外部の forward tee では見えない (#1455)。 | +| `BILI_STREAM_ERROR_SHAPE` | `"completion"` に設定すると、anthropic/openai ワイヤ上のレガシーの失敗形状を復元します (合成された成功完了内の失敗テキスト); デフォルト `"protocol"` = プロトコルネイティブのエラーフレーム (#1455)。`compat.streamErrorShape` と同じノブです; この環境変数が優先されます。 | +| `BILI_LOG_MASK_HOSTS` | `0` に設定すると、プロキシログのホストマスキングをオフにします (#897): 非パブリックのターゲットホスト (プライベートリレー、内部ドメイン) は `` ではなく逐語で記録されます。デフォルトはオン (#255 — ログがパブリックな issue に貼り付けられる); クレデンシャルヘッダーのマスキングは独立しており、常にオンです。実際のターゲットホストは、このフラグに触れずに常に利用可能です: `GET /__bili/stats` → `blindTunnels`、`GET /__bili/health` (どちらもループバックのみ)、および `acp_status` の出力。 | +| `BILI_SUBAGENT_SPLIT` | `0` に設定すると、Claude Code サブエージェントセッション分割をオフにします (#970): デフォルトでは、anthropic ワイヤのリクエストが `x-claude-code-agent-id` + `x-claude-code-parent-agent-id` ペア (バックグラウンドサブエージェント) を運ぶ場合、メインセッションのロックの後ろにキューを積む代わりに、独自の `\|sub:` セッション — 独自のロックチェーンと圧縮状態 — を得ます。デフォルトはオンです。設定ファイルの `"subagentSplit": false` は同じことをします; 環境変数が優先されます。Responses ワイヤ: no-op — `subagentSplit` / BOTH-mechanisms スコープノートを参照してください。 | +| `BILI_FORK_ADOPTION` | `1` に設定すると、フォークブロック採用をオンにします (#629): 匿名 (プレフィックスアフィニティ) クライアントが会話中に履歴をフォークする場合 (編集して再送信 / 以前のターンを再生成)、新しいセッションは、フォークされたリクエストに完全に存在するソースコンテンツを持つ親の圧縮ブロックを継承します — 圧縮状態ゼロで開始し、共有プレフィックスを最初から再折り畳む代わりに。デフォルトはオフです。識別されたリサマフォークはこのスイッチの対象ではありません — `BILI_RESUME_INHERITANCE` (#1834) と一緒にブロックを採用します。設定ファイルの `"forkAdoption": true` は同じことをします; 環境変数が優先されます。採用可能なインベントリは、無効化中であってもすべての匿名フォークで記録されるため、オンにする前に利益の規模を把握できます。 | +| `BILI_AFFINITY_SIMHASH` | `0` に設定すると、simhash チェーンアライメント採用をオフにします (#2265): クライアント側の普遍的な装飾的書き換え (例: Trae がすべてのアシスタントメッセージにモデルタグを再スタンプする) によって正確なハッシュチェーンが壊れた匿名リクエストは、新しく発行してゼロから再折り畳む代わりに、圧縮状態を持つ既存のセッションに再接続します。ガード: ハミング距離 10 以内で ≥90% カバレッジ、変異したが類似の位置 ≥20% (ポイント編集はそれでもフォーク、#629)、バイト同一のユーザーメッセージ ≥1、候補は一意のみ。デフォルトはオン。設定ファイルの `"affinitySimhash": false` は同じことをします; 環境変数が優先されます。 | +| `BILI_RESUME_INHERITANCE` | `0` に設定すると、リサマ継承をオフにします (デフォルトはオン) (#1486): 識別されたクライアント (独自のセッション ID を送信、例: Claude Code の `x-claude-code-session-id`) が完全なトランスクリプトをリプレイしながら新しいセッション ID で会話を再開する場合 (`cc --resume` は新しい UUID をフォーク)、bili は受信履歴をそのクライアントの追跡チェーンとバイト単位で正確に照合し (≥8 メッセージ、追記のみ追跡)、再開セッションの最初のリクエストで、親の参照割り当てを継承します — 古いモデル引用は、番号付けが変更されたものに誤ってヒットするのではなく、元のメッセージに解決されます — 完全に存在する圧縮ブロックを採用します (この継承とともに、#1834: リサマでそれらを失うと、折り畳まれたオリジナルがワイヤに戻り、上流リクエストが膨張しました; 古い `forkAdoption` 共ゲートは現在匿名フォークのみに適用、#629)、そして `derivedFrom` 系譜を記録します。親は決して変更されず、新しいメッセージは親の参照空間の上で番号付けされます。リサマは親の履歴を厳密に拡張する必要があります — 他の ID での等深度バイト正確なリプレイは重複であり、リサマではありません。匿名セッションには影響しません (独自の pfa-* ワールドを保持、#309)。設定ファイルの `"resumeInheritance": false` は同じことをします; 環境変数が優先されます。 | +| `BILI_STABLE_SYSTEM_ANCHOR` | `1` に設定すると、安定システムアンカリングを有効にします (#1085) — プレフィックスキャッシュのための**ベストエフォートのワイヤレイヤーフォールバック**: ルート修正はクライアント側に属します (クライアントは自身の履歴を所有し、指示変更をどのように提示するかを決定する)、これはプロキシが変更されたヘッドがキャッシュされたプレフィックス全体を無効にするのを防ぐだけです。**プレーンプロキシモードのみ**: プラグインモードのエージェント (`x-bili-plugin`) は自身のコンテキスト管理を所有し、決してアンカーされないため、すでにキャッシュフレンドリーな更新を注入するクライアント (例: claude-code スタイルのシステムリマインダー) は二重処理されません。有効化されると、bili は各セッションの最初に見たヘッドシステム/指示ブロックを記憶し、クライアントのシステムプロンプトが後に変更されても、それらの正確なバイトを再送信し続けます。**局所的な**変更 (これまで有効だったバージョンと ≥70% の行を共有するファイルスタイルの編集) は、コンパクトな行差分 (`-` 削除 / `+` 追加; 各ノートは前のものの上に順次構成される) を運ぶ末尾の `[System context update] …` ユーザーノートを追加します。**非局所的な**変更 (構造的な並べ替え、ツール定義の流動、タイムスタンプ付きバナー、400 行を超えるヘッド) はそのまま採用されます — 1 つの意図的なキャッシュミスは、モデルに指示について誤解させるノイズを追加するより優れています。流動ガード: 累積ノートが 8 を超えると、アンカーを最新のテキストで置き換え、ログをクリアします。アンカーとノートログはセッションとともに永続化され、圧縮/コンパクト化を生き残ります (セッションメタデータ、カーネル状態ではない)。既知の残存制限: クライアント配置の `cache_control` ブレークポイントは、ヘッド交換後もまだ不一致になる可能性があります。アンカリングから除外: タイトル生成マイクロリクエスト (OpenAI/Google)、Responses コンパクト化トリガーリクエスト、オートモード分類器リクエスト。独自のバリアント (安定プロンプト + 履歴内更新) を実装するクライアントは、追加の注入をゼロにします —そのような更新は通常の履歴として通過します。デフォルトはオフです。設定ファイルの `"stableSystemAnchor": true` は同じことをします; 環境変数が優先されます。 | +| `BILI_ALLOW_DSH_COMPACTION` | **#3666 で削除** (#2028 を代替)。以前のスイッチは、ワイヤレベルの拒否 (#1729) を解除することで、dsh の組み込みオートコンパクト化が bili を通って実行されることを許可していました; dsh チェックポイントが着地すると生会話履歴を永続的に影隠しするため — 不可逆的であり、プロキシの圧縮基盤を破壊する — エスケープハッチは完全に削除されました: dsh ネイティブコンパクト化呼び出しは現在、bili が提供するすべてのレーン、すべてのビルドで無条件にインターセプトされ、デフォルトでは拒否 (422) されます、または `BILI_DSH_AUTHORED_COMPACTION` が設定されている場合、bili 自身によってローカルで応答されます (下の行)。残された値 — `"dsh": { "allowDshCompaction": true }`、古いファイルのトップレベルの単独 `"allowDshCompaction"`、または古い環境変数 — は、それを特定する一度限りの非推奨警告とともに無視されます。dsh 側のチェックポイントを完全に排除する必要がある場合は、代わりにホスト側の抑制を適用してください: 非 Web プロファイルでの出荷バンドルパッチ (`auto: false`)、または Web プロファイルでの #3354 ロード時オーバーレイ / #2474 プリセット標準の完全スナップショットオーバーライド。 | +| `BILI_DSH_CONTEXT_TAB` | `0` に設定すると、DSH トップバーの「上下文」/「Context」会話タブを削除します (#4237) — 名前は同機に併装されている dsh-context の同名タブと衝突し、このノブ以前はユーザー側のスイッチが存在しませんでした。非表示はタブのみを削除します: 圧縮、設定セクション (会話サブページ)、プラグインバンドル設定フェイス、Web UI、/acp コマンドはすべて影響を受けません — 台帳はそこで到達可能のままです。他の任意の値 (`1`, `true`, …) はファイルティアを無視してタブを強制オンにします; 未設定の場合、設定ファイルの `dsh.contextTab` ブール値が適用されます (デフォルト true = 今日の動作)。設定は既存のスナップショット + `/bili/origin` キャリアを通じて DSH ページに配信され、ページロード時に読み取られるため、プロキシ再起動なしに次のページロード / dsh 再起動で有効になります。タブの表示名は別のファイルのみティアです: `dsh.contextTabLabel`。 | +| `BILI_DSH_AUTHORED_COMPACTION` | `1` に設定すると、dsh のコンパクト化サマライズ呼び出しを拒否する代わりに、bili 自身がローカルで応答するようにします (#3733)。呼び出しごとの前提条件: #1729 ガードが発火 (マーカー決定; #3651 以降は無条件) し、セッションが少なくとも 1 つのアクティブな折り畳みブロックを保持していること。応答はゼロ送信で偽造されます (autoModeForge #2740 の規律): アイデンティティヘッダー `` と、カーネルレンダリング形式でのすべてのアクティブブロックのサマリー — モデルがすでに上流で読み取っている正確なバイトであり、クライアント表示、上流コンテキスト、サーバー状態が初めて一致し、dsh のチェックポイントファイルが縮小します (#3723 の無制限成長ループ)。オリジナルは CCR/エクスポート経由で復元可能であり、着地したチェックポイントはリプレイ時に同じ #2432 リベースを通じて外部のものとして認識されますが、`dshAuthoredCheckpointLanded` (info、warn ではない) として記録されます。ロールアウトウィンドウのために環境変数のみ; リクエストごとに読み取られ、再起動は不要です。 | +| `BILI_NO_CACHE_CONTROL` | `1` に設定すると、bili の Anthropic レーンの `cache_control` ブレークポイントスタンプを無効にします (#1637、#1639 で出荷)。デフォルトはオン: Anthropic スタイルの上流は明示的にブレークポイントされたもののみをキャッシュします (リクエストごとに最大 4 つ、system + tools + message ブロックを合計してカウント)、そのため bili はシステムブロックに加えて最大 3 つの累積メッセージマークをマークします — マークされたメッセージはマークされたまま (バイト安定プレフィックス)、マークは折り畳みによってのみ消え、最後の 3 つの安定メッセージが前進するフロンティアを運びます。クライアント設定の `cache_control` (メッセージブロック、tools エントリ) は bili のスタンプを完全に抑制します — クライアント管理のキャッシュが優先されます。マークはセッションとともに永続化されます。このスイッチは、フィールドを拒否する上流や独自のブレークポイントポリシーを持つリレーのためのエスケープハッチです。プレーンプロキシ Anthropic レーンのみ; OpenAI/Responses レーンは暗黙にキャッシュされ、決してスタンプされません。設定ファイルの双子: [`compat.noCacheControl`](#compat) — 環境変数が優先されます。 | +| `BILI_CACHE_KEEPALIVE` | `1` に設定すると、Anthropic ワイヤのアイドルプロンプトキャッシュ keepalive をオンにします (#3376) — 完全なメカニズム、停止ルール、コストノートを [`cacheKeepalive`](#cachekeepalive) を参照してください。ファイルの双子: `"cacheKeepalive": { "enabled": true }`; 環境変数が優先されます。デフォルトはオフ。 | +| `BILI_CACHE_KEEPALIVE_TTL_FACTOR` | 検出/推定されたキャッシュ TTL ティアに適用される頻度係数 (デフォルト `0.9` → 5 分ティアで約 4.5 分、1 時間ティアで約 54 分にピンポン)。`(0, 1]` の範囲でなければなりません。ファイルの双子: `cacheKeepalive.ttlFactor`。 | +| `BILI_CACHE_KEEPALIVE_MAX_DURATION_MS` | セッションごとの最大 keepalive 寿命、最後の REAL リクエストから測定 (デフォルト `86400000` = 24 時間); それを超えると、アームされたセッションはヒットし続けていても解除されます。ファイルの双子: `cacheKeepalive.maxDurationMs`。 | +| `BILI_CACHE_KEEPALIVE_MAX_PINGS` | 同時にアームされたセッションの最大数 (デフォルト `4`); オーバーフローは最も長いアイドルセッションの keepalive を追い出します。ファイルの双子: `cacheKeepalive.maxConcurrentPings`。 | +| `BILI_CACHE_KEEPALIVE_ASSUME_TTL` | `"5m"` または `"1h"`: ボディのブレークポイント検出をスキップし、代わりにこのティアから頻度を実行します — bili の下流で `cache_control` TTL を注入または書き換えるリレー/プロキシのために、転送されたボディに (または誤った) ブレークポイントティアが表示されない場合。ファイルの双子: `cacheKeepalive.assumeTtl`。 | +| `BILI_CACHE_KEEPALIVE_ARM_WITHOUT_BREAKPOINTS` | `1` に設定すると、転送されたボディに `cache_control` ブレークポイントがない場合でも keepalive をアームします (デフォルトはオフ — ブレークポイントなしでは明示的にブレークポイントされたものをリフレッシュするものがありません; リレーがブレークポイントを所有している場合は `assumeTtl`/`intervalMs` と組み合わせる)。ファイルの双子: `cacheKeepalive.armWithoutBreakpoints`。 | +| `BILI_CACHE_KEEPALIVE_INTERVAL_MS` | ミリ秒単位の絶対ピンポン間隔; `ttlFactor`、`assumeTtl`、検出されたティアより優先されます。上流の TTL ポリシーに関係なく固定頻度を使用する場合に使用します。ファイルの双子: `cacheKeepalive.intervalMs`。 | +| `BILI_CHAIN_CONTENT` | `1` に設定すると、bili→bili チェーン認識の ACP 成果物 / `` チェックポイント**ボディコンテンツ**検出をオンにします (#1086/#1421): 受信リクエストがそのボディに圧縮成果物 (レンダリングタグ / 歴史的な `acp_status`+`search_context` ツール呼び出し) またはダイジェストを持つチェックポイントを運ぶが、`x-bili-hop` ヘッダーもそのセッションのローカル圧縮状態もない場合、bili はアドバイザリー観測を記録し、/または first-processor-wins パススルーを適用します。**デフォルトはオフ** (#1683 フォローアップ): デフォルトでは `x-bili-hop` ヘッダーのみがチェーン認識を駆動します。リクエスト BODY のスキャンは、CCR/ファイル導入テキストやモデル反響タグのような実際のマーカーに見えるものに偽陽性になる可能性があるためです。中間ボックスが `x-bili-hop` をストリップする狭いマルチ bili リレーケースで、その偽陽性リスクを受け入れる場合のみ有効にしてください。設定ファイルの `"chainContentDetection": true` は同じことをします; 環境変数が優先されます。`x-bili-hop` シグナル自体はこのスイッチの影響を受けません。 | +| `BILI_CHAIN_STAMP` | `1` に設定すると、**モデル可視**の `` チェーン完全性チェックポイントキャリアの送信出力をオンにします (#1683、デフォルトオフ): 有効化されると、このインスタンスが実際に処理するすべてのリクエストは、`x-bili-hop` ヘッダーが転送中にストリップされた場合でも、下流の bili が first-processor-wins を適用できるように、ダイジェストを持つスタンプを付けて離れます (#1421)。キャリアは終端モデルも読み取るスロット (OpenAI/Responses では末尾の `user` メッセージ、Anthropic/Google では末尾のテキストパート) に着地するため、モデルはそれを幽霊ユーザー入力として扱い、コメントするためにトークンを消費します — これがデフォルトでオフである理由です。中間ボックスによって `x-bili-hop` がストリップされ、ダイジェスト検証済みボディスタンプが二重処理に対する唯一のガードである狭いマルチ bili リレーケースでのみ有効にしてください。`BILI_CHAIN_CONTENT` (受信ボディ検出もデフォルトオフ) およびどちらの方向でも動作する `x-bili-hop` パススルーとは独立しています。設定ファイルの `"chainEgressStamp": true` は同じことをします; 環境変数が優先されます。 | +| `BILI_CHAIN_MAX_FUTURE_SKEW_MS` | チェーンチェックポイントの `issued-at` タイムスタンプを検証する際に許容される最大未来スキュー (ms) (#1395 ステップ 2): この値より未来にスタンプされたチェックポイントは、ダイジェストが検証されていても `stale` (リプレイ / クロックスキュー) と判定されます。デフォルトは `120000` (2 分); 数値でない場合や非正の値はデフォルトにフォールバックします。ステップ 2 はシャドウのみです — これらのノブは判定ログを調整し、決して転送をしません。 | +| `BILI_CHAIN_RECENT_WINDOW_MS` | チェーンチェックポイント検証の新規性ウィンドウ (ms) (#1395 ステップ 2): これより古いチェックポイントは `stale` と判定されます。デフォルトは `600000` (10 分); 数値でない場合や非正の値はデフォルトにフォールバックします。ステップ 2 はシャドウのみです — これらのノブは判定ログを調整し、決して転送をしません。 | +| `BILI_CONFLICT_SCAN` | `0` に設定すると、サードパーティ圧縮プラグイン検出を無効にします (#1206)。デフォルトはオン: bili はクライアント自身のプラグイン/拡張レジストリ — opencode グローバル + プロジェクト `plugin` 配列、pi グローバル + プロジェクト `.pi/settings.json` `packages`、omp `config.yml` `extensions`、claude 設定 `enabledPlugins`/`plugins` + そのプラグインディレクトリ、kimi `plugins/installed.json`、hermes プラグインディレクトリ、dsh プロファイル依存関係 — をスキャンし、bili と同居する別の圧縮機を探します。2 つのティア: **既知の競合** (`opencode-acp`、レガシー `billion-context-pi`、および dsh の `dsh-live-compact`、#5984) と**キーワード疑わしい**エントリ (compress / compact / acp / summar* / context* に一致する名前; bili 自身のエントリは常にスキップされ、`context7` のような非圧縮ツールは一致しません)。発見は、クライアント開始前のランチャー stderr 行、各セッションの最初のリクエストでの一度限りのプロキシ警告ログ、セッションの競合台帳として表示されます — `acp_status` の `COMPRESSION CONFLICTS` セクション、`GET /__bili/stats` → `conflicts` で集計され、Web UI バナーとして表示されます。バナーはインターセプト**失敗**の警報です (#3235): 着地但未回復の証拠が存在する場合のみポップアップします (確認されたサードパーティ圧縮機、推定されたクライアントネイティブ着地、または説明のつかない履歴書き換えシグナル) — 回復 (インターセプト+リベース) された着地と疑わしい/兄弟在庫は記録されますが静かに保たれます。永続的な非表示 (新しいイベントで自動的に再アームされる localStorage ウォーターマーク) と、一般的な #3040 診断施設に乗る診断コピー / GitHub 報告ボタンを提供します。ランタイム干渉証拠 (告知なしの履歴書き換え #1001、孤立ブロックの無効化) は同じ台帳に供給されます。スキャンは読み取り専用、ベストエフォート、5 分キャッシュ、クライアント設定をブロックまたは変更しません。 | +| `BILI_UPSTREAM_PROXY` | プロキシ自身の送信接続用のアップストリームプロキシ — *グローバル* ソースの中で最優先 (Web UI 手動プロキシと設定ファイルの `proxy` より上)。URL ごとの `providers..proxy` は、一致するプロバイダー URL に対してはそれでも優先されます。完全な解決順序、ループ防止、例については、Server Settings の [`proxy`](#server-settings) を参照してください。 | +| `BILI_INHERITED_HTTP_PROXY` / `BILI_INHERITED_HTTPS_PROXY` / `BILI_INHERITED_ALL_PROXY` / `BILI_INHERITED_NO_PROXY` | ユーザー向けではありません — ランチャーがプロキシを起動する際に自動的に設定されます (#1012)。ランチャーはクライアントとプロキシ子プロセスの両方からシェルプロキシ変数をストリップします (クライアントは bili に送信する必要があり、プロキシはシェルプロキシによってモデル送信がハイジャックされてはならない)、しかしユーザーのストリップ前プロキシをこれらの名前で転送し、プロキシの**補助送信** (MITM 盲目トンネル — クライアント側の MCP/Web トラフィック) がユーザーの VPN に乗れるようにします。これらは盲目トンネルフォールバックティアのみを供給します: 明示的なルート / グローバル `proxy` / `BILI_UPSTREAM_PROXY` / 明示的な `"upstreamProxyMode": "direct"` はそれでも優先され、bili 自身のポートを指す値は破棄されます。モデル送信には影響しません (明示的に設定されない限り直接のまま)。 | +| `BILI_ATTACH_HEALTH_DEADLINE_MS` | アタッチターゲットがダウンしているが、このプロセスのモデルチャネルがそれに**ピン留め**されている場合 (ルーティングされた `/bili/…` モデルトラフィックがそれに対して観察された) の dsh/opencode アタッチ検証のヘルスウェイト期限 (ms): bili は第二のインスタンスを起動する代わりに、ターゲットが戻るのを待ちます — 起動はセッションを分割します (モデルトラフィックはピン留めされ、bili ツールは他のインスタンスに対して 404 になります)。期限が経過すると、ターゲットが戻るまで、すべてのモデルリクエストで再チェックしながら明確に失敗します (デフォルト `15000`)。#1365 を参照。 | +| `BILI_ATTACH_EVIDENCE_GRACE_MS` | dsh/opencode アタッチ検証が死んだターゲットをプローブする間、レガシー起動パスにフォールバックする前にルーティングチャネル証拠の出現を待つ猶予ウィンドウ (ms) (決定と最初のリクエストの競合をカバー: 最初のモデルリクエストが t≈1s で着地する間に、プローブは t≈0 で失敗する) (デフォルト `5000`)。#1365 を参照。 | +| `BILI_SILENT_DIRECT_MAX_MB` | プラグインのライブ状態スロットが欠落しているかリクエスト帰属が失われた場合、ローカルで 422 を返して直接モデルリクエストを拒否する生ボディバイトガードの上限 (MiB、> 0; 小数可) (#5405/#5408)。ガードは生バイトをカウントします — base64 膨張メディアを含む — したがって、画像中心のセッションは正しく 2 MiB を超える可能性があります; デフォルトは `8`。無効な値はデフォルトにフォールバックします。#5405、#5826 を参照。 | +| `BILI_SPAWN_WAIT_MS` | 新しく起動されたプロキシ子プロセスの初期ヘルスウェイトウィンドウ (ms)、ランチャーが `still starting up` をログに記録してウェイトを延長する前に (デフォルト `20000`)。プロキシの pre-bind オープンパスが長時間実行される場合は拡張してください: 大きな `index.db` は bind 前に完全な DB を開きます (整合性チェック、WAL 復旧 — #4939 を参照)、そして 1 つのストアを共有する 2 つのレーンが同時にコールドスタートすると SQLite 書き込みロックを競合します (Windows で 1.7 GiB ストアの場合、最初のログ行まで 28 秒以上、出力ゼロで 60 秒以上観察)。数値でない場合や非正の値はデフォルトにフォールバックします (#1365 と同じ `envMillis` 契約)。 | +| `BILI_SLOW_START_GRACE_MS` | まだ生存していて起動中の起動子プロセスの `BILI_SPAWN_WAIT_MS` を超えるスロースタート猶予 (ms) (#2187: AV / 初回実行ディスクアクティビティによる Windows 起動ウィンドウ 26-45 秒; 大きくまたは競合している共有ストアは、pre-bind 総時間を 60 秒以上押し上げる可能性があります)。起動総予算は 2 つのノブの合計です; 終了した子プロセスはそれでもフェイルファストします (デフォルト `40000`)。 | +| `BILI_PERSIST` | `0` に設定すると、セッション永続化を無効にします (メモリ内のみ、再起動で失われる)。 | +| `BILI_PERSIST_DEBOUNCE_MS` | ディスクへの永続化書き込みのデバウンスウィンドウ (ms) (デフォルト `500`)。 | +| `BILI_PERSIST_MAX_DELAY_MS` | 変更が到着し続ける間、保留中の永続化書き込みが待てる最大時間 (ms) — デバウンスウィンドウはすべての変更で再起動されるため、この予算が持続トラフィック下でファイルが着地することを保証します (デフォルト `5000`; 以前はセッション順序 / プレフィックスアフィニティライターでハードコード、#6058)。 | +| `BILI_PERSIST_TAIL_TOKENS` | 永続化された会話スナップショットのトークン予算 (#401)。ディスクレコードは、この予算内の最新のメッセージに切り詰められた**折り畳みビュー** (圧縮範囲の代わりにブロックサマリー) を保存します — 生の完全な履歴ではありません。デフォルトは `16384`; `0` でメッセージ永続化を完全に無効にします (ブロックサマリーと圧縮オリジナルはそれでも永続化; `bili export` はブロックのみレンダリングにフォールバック)。ライブメモリ内セッションには影響しません — ライブセッションの `bili export` は常に完全です。 | +| `BILI_PERSIST_ZSTD` | `1`/`true` に設定すると、セッションファイルの zstd 圧縮を有効にします (#1080、オーナー決定: **デフォルトオフ** — プレーン JSON は復元可能性を最大化します: jq/grep でデバッグ可能、ダウングレードテールリスクに免疫)。有効化されると、実際に縮小されるすべてのセッションファイルは `BILIZSTD1` として書き込まれます — JSON ボディの上に小さなヘッダー (マジック + 形式バージョン + モードバイト)、Node ≥ 22.15 では zstd 圧縮、古いランタイムでは生で保存; リーダーは両方のボディを受け入れます (ネイティブ zstd、それ以外はバンドルされた WASM フォールバック)、したがってファイルはランタイムとバージョン間で読み取り可能のままです。フレーミングで縮小できないペイロード (小さなセッション) とキーのない生ボディはディスク上でプレーン JSON のままです。`BILI_ENCRYPTION_KEY` と独立 — 両方がアクティブの場合、圧縮選択は `BILIENC1` 内のモードバイトに記録されます。既存のプレーン JSON ファイルは起動時に決して書き換えられません (ダウングレード安全性 — 大量の再エンコードは、古い bili にロールバックすると、その自身の書き込みを "破損" として読み取らせる); 次の保存で有機的に変換されます。注: セッションが `BILIZSTD1` として保存された後、古い bili (< 0.1.135) はそれを読み取れません — この注意はオプトインしたデプロイメントにのみ適用されます; 未設定または他の任意の値はプレーン JSON を保持します。 | +| `BILI_STORAGE_UNIFIED` | 階層型ストレージ移行スイッチ (#2671)。設定ファイルティア: `{"storage":{"unified":"legacy|shadow|full"}}` は同じモード (厳密なスペル) を選択し、環境変数が未設定の場合に常に適用されます; `BILI_STORAGE_UNIFIED` (`1`/`true` = shadow および `unified` = full も受け入れる) は常にファイルより優先されます。モードはレーン起動ごとに一度解決されます — ファイルへのホット編集は次の再起動で有効になります。`1`/`true` に設定すると、**統一 SQLite ストレージドライラン** (Phase 1) を有効にします。すべてのセッション書き込みは `/index.db` に二重取り込まれます (エンジン解決順序 #2833 以降: ランタイムが提供する場合は組み込み `node:sqlite` (Node >= 22.5) -> すでにインストールされたホスト `better-sqlite3` ネイティブモジュール -> 以前に自己ダウンロードされたキャッシュコピー -> npm レジストリからのピン留めされた `better-sqlite3` プリビルトタールボールの一度限りの自己ダウンロード (~11 MB、sha512 検証、`storage.sqliteAutoDownload` でゲート、サポートされていないプラットフォームは決してダウンロードしない; エンジン成果物は Node メジャーごとにピン留め (Node >= 22: better-sqlite3 v13; Node 20: v12.9.0 とその ABI キー付きプリビルド)、そしてピン留めされた成果物が提供しないランタイムはロード前に拒否され、ダウンロードもキャッシュコピーも登録されません。そのようなバインディングをロードするとプロセスがクラッシュするため (#3341, #3894)) -> なし、その場合サイドカーは #2825 ダウングレード契約に従ってレガシーのみのまま; エンジンの取得はホストのインストール時ビルドスクリプト承認に決して依存しない) かつ統一リプレイはレガシーロードビューとダイジェスト照合されます — 不一致は `[storage] unified shadow DIGEST DRIFT …` をログに記録し、決して書き込みパスをブロックまたは変更しません (レガシーファイルは真の単一ソースのまま)。`full`/`unified` に設定すると、**ドロップイン読み取りパス** (Phase 1.5) を有効にします: `loadSync`/`boot`/`loadAll`/`loadStateForSearch` は統一優先 — レガシーファイルセッションは最初のオープン時にインデックスに有機的にインポートされ (`[storage] unified import on first open: …`)、後のロードは `index.db` から提供され、統一失敗時にはレガシーファイルへの自動フォールバックがあります。レガシーファイルは二重書き込みされ続けるため、**ロールバック = ノブを未設定にする** (環境変数および/またはファイル値)。ハード暗号化オプトアウト: `BILI_ENCRYPTION_KEY` がアクティブの間、サイドカー全体は開くことを拒否します (index.db は平文インジェストペイロードを保持する; `unified sidecar DISABLED` 警告がログに記録され、ストアはレガシーのみのまま)。列挙/GC と Web セッションリストはファイルベースのままです; `removeLegacyFile` は現在インデックス行を削除し、CAS refcount を解放します。ダイジェストは最後の書き込み者 `biliVersion` スタンプと壁時計タイムスタンプを環境 (`__VER__`/`__TS__`) として扱い、他のすべてはバイト単位で一致する必要があります。インデックス書き込みパスは決して諦めません: 失敗したインジェストはログに記録されます (最初の失敗時にファイル + エラー詳細)、そしてすべての後続の保存は実際の書き込みを再試行します — 自己無効化なし、クールダウンなし、フォールバックモードなし (2026-10-30 オーナーポリシー)、その間 JSON エンベロープは読み取りを提供し続けます。**レプリカ/チェックポイント REST (Phase 2)**: 統一レーン (shadow または full) で、`POST /__bili/replicas {sessionId, label?, pinned?}` はセッションの永続化状態を 1 つのコンテンツアドレス付きチェックポイントブロブ + 行として凍結します (常駐セッションは最初にフラッシュされる)、`GET /__bili/replicas[?sessionId=]` はそれらをリストし、`GET /__bili/replicas/` は詳細 + バイト長を返し、`POST /__bili/replicas//restore {sessionId?}` はチェックポイントを通常の二重書き込みパス (JSON + 統一インジェスト; `meta.restoredFrom`/`restoredCheckpoint` が出所を記録) を通って新しい第一級セッションとして具現化し、`DELETE /__bili/replicas/` はそれを破棄します。ピン留めされたチェックポイントは CAS refcount を保持し、`deleteSession` GC を生き残ります (ポイント: 破壊的実験前に取られたコピーはそれより長く生きる); 明示的な DELETE はピン留めされたものでも削除します。ディスク期待: shadow/full は一意コンテンツバイトをほぼ倍にします (すべてのセッションは JSON ファイルと index.db 行を持ち、2 つのストア間で重複排除のないコンテンツ CAS を共有) かつ自動 VACUUM はありません — 移行実行中はセッションディレクトリのサイズを適切に設定してください。レガシーのみのレーンはノブヒントとともに 501 を返します。ルートは `__bili` の残りの部分と同様にループバックのみです。未設定の場合はデフォルトで `full` (#3818)。 | +| `BILI_PERSIST_EPERM_ALERT_THRESHOLD` | 一度限りの "このディレクトリをウイルス対策の除外に追加" アラートが発火する前に、1 つのセッションでの連続永続化書き込み失敗 (`EPERM`/`EBUSY`/`EACCES`) の N 回 (デフォルト `5`)。Windows のみ。[Windows: exclude the sessions dir](#windows-exclude-the-sessions-dir-from-antivirus-362) を参照。 | +| `BILI_PERSIST_EPERM_ALERT_REPEAT_MS` | 永続化 EPERM アラートの再アラートウィンドウ (ms)。`0` (デフォルト) = 一度アラートしてその後沈黙; `>0` = 失敗が続く間、最大でそのミリ秒ごとに再アラート。 | +| `BILI_TUNNEL_ALLOWED_HOSTS` | **リモートクライアント**の `/bili/` トンネル受入 (#409): ループバック/プライベート宛先 (例: LAN リレーやマシンの自身の sglang) を非ループバッククライアントに対してアンロックするコンマ区切りの `host` または `host:port` エントリ。プロキシ自身とリンクローカル/メタデータアドレスは常に拒否されます; ローカル (ループバック) クライアントは常に通過します。 | +| `BILI_MAX_SESSIONS` | メモリ内で保持される最大セッション数 (デフォルト `256`; LRU 追い出し — ディスクが真のソース)。 | +| `BILI_ROLLOUT_SNAPSHOT_RENDER` | スナップショットレンダリング (#3756): `1` に設定すると、クライアント再送信バイトではなく、サーバー側の統一ストレージトランスクリプトから送信履歴プレフィックスをレンダリングします。セッションにライブ折り畳みブロックがあり、統一ストレージが読み取り可能な場合のみアクティブです; それ以外の場合はすべてのリクエストが変更なしでレガシーパスにフォールバックします。#3752/#3751 の ID 流動クラスを殺します: アンカーカバレッジはブロック seq + コンテンツシグネチャに従うため、コーデック/アイデンティティアップグレード、クライアントチェックポイント、ホストコンパクト化はもはや折り畳まれた履歴をドロップまたは重複させません。`BILI_ROLLOUT_` の機能別形式 (デフォルト 0% ロールアウト)。 | +| `BILI_SESSION_WARM_MAX` | 有界起動 (#2803): リスニング前にブート時に水化される最近保存されたセッションの最大数 (デフォルト `0` = 水化なし、`sessions.max` で上限); 古い状態はオンデマンドで再読み込みされます。例: `8` に設定すると、最近のセットのイージアワーミングを復元します。ファイルの双子: `sessions.warmMax`。 | +| `BILI_SESSION_WARM_MAX_BYTES` | ブートウォームセットのデコードバイト予算 (#2803; デフォルト `67108864` = 64 MiB)。ディスク上の圧縮バイトではなく、DECODED サイズをカウントするため、zstd アーカイブは RAM 境界をすり抜けることができません。予算を超える単一ファイルは決してウォームされません。ファイルの双子: `sessions.warmMaxBytes`。 | +| `BILI_SESSION_RESIDENT_MAX_BYTES` | 推定常駐セッションバイトのソフトターゲット (#2803; デフォルト `4294967296` = 4 GiB、#5779 で 512 MiB から引き上げ)。アクティブ/進行中状態はそれより上にピン留めされます (バイト予算はアイドルキャッシュを制限し、アクティブワークロードを制限しない); ターゲット超過時、アイドル状態はリクエスト完了時にディスクへ排出されます。ファイルの双子: `sessions.residentMaxBytes`。 | +| `BILI_SESSION_RESIDENT_HARD_MAX_BYTES` | 推定常駐メモリに対するセッションごとのハード上限 (#4788、決定 #4792 D1-A)。なぜ存在するか: 上記のプールソフト上限は、予算内に留まるために他のアイドルセッションをメモリから引き出すことしかできません — 単一の長時間セッションでは追い出すものが何も残らないため、1 つの会話が 58 MiB の受信ストリームから約 2 GiB のワーキングセットを成長させました (#4788 ベースライン)。この上限は 1 つのセッションを単独で制限します: リクエストが完了し、ターンの保存がディスクに着地したことが証明された場合、セッション自身の常駐推定値 (`GET /__bili/memory` が報告する同じ数値) は上限と比較されます; 超過時、プール追い出しがセッションを免除しても、ドロップ可能なフィールド — 折り畳みブロックのオリジナルコンテンツ、メタデータ簿記、生メッセージテールの無制限部分 — はディスクに強制戻され、セッションごとに 1 分ごとに警告がログに記録されます。何も失われません: 各ドロップされたフィールドは、NARROW ディスク読み取り (そのフィールドのみ、レコード全体ではない) から初回使用時に再具現化されるため、次のターンはメガバイトを常駐させる代わりに 1 つの小さな読み取りを支払います。着地した保存によってゲートされたドロップは、上限に関係なくすべてのリクエスト境界で実行されます; 上限は単一のセッションが自身の予算を超えたときに呼び出されるかを決定します。デフォルト: プールソフト上限と等しい (`4294967296` = 4 GiB; #5779 で 512 MiB から引き上げ); 1 つの忙しい長時間セッションを個人の上限以下に保つには低く設定 (例: `53687091` = 64 MiB)。`0` で上限チェックを無効にします。圧縮状態 (`state`) とメディアコンテンツストアは設計上ドロップ可能ではなく、このパスでは触れられません。ファイルの双子: `sessions.hardMaxBytes`。 | +| `BILI_PUBLIC_SNAPSHOT_CAP_BYTES` | パブリックフォーク API を提供するためにプラグインセッションごとに保持される生ワイヤ履歴スナップショットの保持上限 (バイト) (#2017)。シリアライズされたスナップショットが上限を超えるプラグインセッションはフォーク可能ではなくなります — `GET /__bili/plugin/snapshot` と `POST /__bili/plugin/fork` は上限理由とともに `409` でフェイルクローズします — 履歴の無制限な生コピーを永遠に保持する代わりに。上限はすべてのプラグインモデルリクエストで再評価されます: 上限以下に縮小されたセッション (フォークがトリムした後、またはホストが履歴を縮小した後) はフォーク可能になります。デフォルトは `104857600` (100 MiB); `0` で保持を完全に無効にします (セッションはフォーク可能ではなく、既存のスナップショットは次のリクエストで破棄されます)。ファイルの双子: `plugin.snapshotCapBytes`。 | +| `BILI_SESSIONS_DIR` | 永続化セッション状態のディレクトリ (デフォルト XDG data ディレクトリ)。 | +| `BILI_SESSION_GC` | 古いセッションファイルのクリーンアップ (#1082) は**オプトイン**です: 有効にするには `1`/`true`/`on` に設定します — デフォルトはオフです。セッションファイルはユーザーデータ (エクスポート可能、再開可能) であり、サイレント削除ポリシーがないためです。有効化されると、スウィープ (ブート + 毎時) は、両方の条件が成立する場合のみファイルを削除します: `BILI_SESSION_GC_MAX_AGE_DAYS` より古く、かつ無損失の意味で小さい — セッションは**決して圧縮されていない** (折り畳みブロックゼロ) かつ最新のリクエストボディが以下のトークン上限以下であり、再開するとクライアント自身の履歴からの 1 回のコールドリビルドのコストしかかからないためです。セーフティレール: 圧縮されたセッションは決して削除されません (そのサマリーは無損失で再構築できない); メモリ内でまだ保持されているセッションは、最後のディスク書き込み以来アイドルでない限りスキップされます; 読み取り不能/破損ファイルはその場に置かれます; すべての削除は個別に監査ログに記録されます (パス、サイズ、年齢) 加えて、空でないスウィープごとに 1 行のサマリー行; 触れるのはセッションディレクトリのみ; 空になったプロトコルサブディレクトリは削除されます。常駐ガードはプロセスごとであることに注意してください: `BILI_SESSIONS_DIR` を共有するが永続化しない (例: `BILI_PERSIST=0`) 他のプロキシインスタンスはファイル mtime を更新しないため、まだライブなセッションファイルは年齢を重ねてスウィープされる可能性があります — コストは同じ有界コールドリビルドであり、年齢ゲートでバックストップされています。CCR コンテンツストア (#1097) はセッションのライフサイクルを共有します (#1180): `.content-store.json` コンパニオンはセッションファイルとともに削除され、孤立したコンパニオン (セッションファイルはすでに消えた) は年齢ゲートを過ぎると一度スウィープされ、読み取り不能なコンパニオンはセッションファイルも保持します (決して推測しない)。 | +| `BILI_SESSION_GC_MAX_AGE_DAYS` | セッションファイルが GC 候補になるまでの最小年齢 (日) (デフォルト `7`)。あらゆる可能性のあるリサマウィンドウよりはるかに長く保ってください: 削除後、再開されたセッションは m00001 からメッセージ番号付けを再開しますが、再開エージェントのトランスクリプトは古い番号をまだ引用している可能性があります (カーネル契約: ID は決して再利用されない)。 | +| `BILI_SESSION_GC_MAX_TOKENS` | GC 適格性のサイズ上限 (トークン) (デフォルト `1000000` = 1M、#1082 でオーナー設定)。**デコードされた**コンテキストに対して判定され、決してファイルバイトではありません (暗号化/zstd ファイルはディスク上ではるかに小さい): 最新のリクエストボディのトークン推定値 (`rawInputTokens`、ターンごとに記録) が存在する場合に優先されます; 記録されていないレガシーファイルは `stats.contextTokens` を使用します; そしてコンパニオンコンテンツストアのフットプリント (#1097: カーネルの CJK 対応 `defaultCountTokens` による一意コンテンツ、`rawInputTokens` と同じ推定器、#1180) が上に追加されるため、巨大なストアを持つ小さなセッションは上限をすり抜けることができません。圧縮されたことのないセッションにのみ適用されます — 折り畳みブロックを持つファイルは、そのサマリーが再送信から無損失で再構築できないため、サイズに関係なく常に保持されます。 | +| `BILI_SESSION_GC_INTERVAL_MS` | バックグラウンド GC スウィープの間隔 (ms) (デフォルト `3600000` = 1 時間)。スウィープはブート時に一度実行されます。 | +| `BILI_ENCRYPTION_KEY` | 信頼できないノード上のデプロイメントのためにセッションファイルを静止状態で暗号化します (#708)。正確に 32 バイト、hex (64 文字) または base64; 未設定 = 暗号化されないプレーン JSON ファイル (または `BILI_PERSIST_ZSTD=1` 時の `BILIZSTD1` — `BILI_PERSIST_ZSTD` を参照)。設定された場合: すべてのセッションファイルは `BILIENC1` AES-256-GCM として JSON 上に書き込まれ、`BILI_PERSIST_ZSTD=1` の場合のみ zstd 圧縮されます (Node ≥ 22.15 では zstd、それ以外は生ボディ) — 圧縮を有効にするとファイルも約 5–10 倍縮小します。暗号化と圧縮は現在独立したノブです (#1080)。キーはこの環境変数のみから来ます — ディスクやログに決して書き込まれません — したがって、同じファイルシステムの到達範囲外に保ってください。無効な値は起動を中断します (フェイルファスト、決してサイレントに暗号化されない)。誤ったキーでブートすると、影響を受けたセッションは破損としてスキップされます (ログに記録、クラッシュなし)。キーを失うと、暗号化されたセッションは永久に読み取り不能になります。設計上対称です (同じプロセスが暗号化と復号化を行う)。既存のエンコードされていないファイルは起動時に決して書き換えられません — 次の保存で有機的に暗号化されます (ダウングレード安全性; `BILI_PERSIST_ZSTD` を参照)。脅威モデル (#708、オーナー確認済み): それは**オフライン/機械的**ファイル取得から防御します — プロバイダーディスク交換、ノードイメージドリフト後のオフラインディスクスナップショット、盗まれたボリューム、漏洩バックアップ、クラウド同期状態ディレクトリ — オフラインの第三者がキーなしにコンテンツを読み取れない場所です。ライブアクセスを持つ標的型敵対者からは防御しません; そのティアでは、プロキシ内で解決するのではなく、信頼ルートをプロキシの外 (KMS / TEE / 機密 VM、強化された権限) に移動してください — そのレベルではキーよりもはるかに多くのものが露出するため、プロキシレベルのキー処理は保持すべき境界ではありません (`BILI_PERSIST=0` は永続化を完全に無効にします)。同じプロセス/環境からの第二のキーでキーを二重暗号化しても何も得られません: すべてのオフライン盗難シナリオで、攻撃者は正確に 1 つの成果物 — あなたのディスク外シークレット — を欠いています — それがデータキーと呼ばれようがラッピングキーと呼ばれようが; 異なる信頼ドメイン (KMS/TPM/TEE) のラッピングキーのみがバーを上げ、それは上記のシナリオ 2 です。 | +| `BILLION_CONTEXT_PROXY` | ランチャーによってエクスポートされます; クライアント側の bili プラグイン/拡張はそれを検出し、自身の圧縮を自己無効にします (二重圧縮なし)。 | +| `PI_PROXY_ANTHROPIC` | `bili omp` ランチャーによってエクスポートされます (ユーザーの環境から `PI_PROXY` も `PI_PROXY_ANTHROPIC` も来ない場合のみ): OMP の Cowork anthropic トランスポートをプロキシに向かせ、それらのリクエストが node:https 直接ではなく圧縮可能レーンに乗るようにします (#2583/#3556)。ユーザー設定の値は常に優先されます。 | +| `BILLION_CONTEXT_PLUGIN` | `0` に設定すると、プラグインモードを完全に無効にします (ワイヤレベルのツール注入が再開)。 | +| `BILI_LAUNCHER_MODEL_WINDOWS` | 内部: ランチャーはクライアント自身のモデルごとのコンテキストウィンドウ (pi `models.json`、omp `models.yml`、opencode `models..limit`、codex `model_context_window`) を JSON として起動されたプロキシに渡し、セルフホストモデルに対してナッジの分母が実際のウィンドウと一致するようにします。ランチャーのみが設定します — ユーザー設定はありません。 | +| `BILI_LAUNCHER_LANE` | 内部: ランチャーはクライアントのレーン名 (pi / codex / claude / …) を起動されたプロキシに渡し、インスタンスファイルに記録します (#1225)。再利用はアイデンティティベースです: *異なる宣言された* レーンを持つ 2 つのインスタンスは決して互いにアタッチしません; 宣言されたレーンを持たないインスタンスは手動で開始されたユーザーゾーンデーモンです — デフォルトでアタッチ可能 (#1660)。ランチャーのみが設定します — ユーザー設定はありません。 | +| `BILI_LAUNCHER_PLUGIN` | `0` に設定すると、claude/codex に対するランチャーの bili MCP サーバー注入を無効にします (純粋なワイヤモード); `1` でプラグインモードを強制します。デフォルト: 注入 — ただしローカル/プライベートアップストリーム (sglang/vllm/ollama は codex の名前空間ツールタイプを解析できないため、bili はそこで自動的にワイヤツールにフォールバック) を持つ codex を除く。[Launcher Reference](#launcher-reference) を参照。 | +| `BILI_LAUNCHER_DIRECT` | `1` に設定すると、ランチャーでの直接 URL ルーティング (MITM/CA 信頼をドロップ) を行います。[Launcher Reference](#launcher-reference) を参照。 | +| `BILI_NATIVE_ATTACH_EXTERNAL` | アタッチゲートエスケープハッチ (#1335)。レーン付きネイティブフックは、アームされたセッションライフサイクルウォッチドッグ (`/__bili/health` で `watchdog.armed == true`) を報告する実行中プロキシにのみアタッチします — アームされていない*レーン付き*プロキシ (クラッシュしたセッションの孤立、またはライフサイクル状態を検証できないインスタンス) は、サイレントに乗る代わりに明確に拒否されます。#1660: **手動で開始された `bili start` デーモン** (レーンなし、起動トークンなし) は定義上ユーザーゾーンです — **アームされた**ユーザーゾーンデーモン (管理された共有プロキシ、#1225) はそれでも互換性のあるクライアントレーンによって乗られますが、**アームされていない**手動デーモンは、デフォルト (`attachPolicy: "own-lane"`, #2877) では、LANEd フックによって乗られず、代わりに自身のものを起動します; #2877 以前のネイティブフックが手動デーモンにデフォルトでアタッチする動作を復元するには `attachPolicy: "global-fallback"` を設定してください。`1`/`true` に設定すると、ウォッチドッグ状態に関係なく、*レーン付き*アームされていないリスナーにもアタッチします (コード/レーン互換のリスナーはすべてアタッチ可能になります。`watchdog` フィールドをまったく報告しない #1330 以前のビルドを含む)。設定ファイルの `"native": { "attachExternal": true }` は同じことをします; 環境変数はファイル値より優先されます。注: `attachExternal` は**レーン付き**デーモンの*ライフサイクルゲート*のみを管理します — ユーザーゾーン (手動) デーモンへのアタッチを開いたり閉じたりしません; その軸は `attachPolicy` / `attachUrl` です。デフォルトは閉じています (レーン付きインスタンスのために)。完全なメカニズム (再利用ルール、リスナートーブル、エスケープハッチ): [technical-notes.md](technical-notes.md#proxy-reuse-and-the-attach-gate-1225-1335-1232-1660)。 | +| `BILI_ZCODE_ROUTE` | zcode ネイティブプラグインルーティングスコープ (#1622): `all` (デフォルト — 使用可能な http(s) baseURL を持つすべてのプロバイダーエントリが圧縮に乗る、pi/dsh パリティ)、`plans` (#1622 以前の bigmodel コーディングプランホワイトリスト)、`none` (オプトアウト; ブートストラップはストアを直接のままにします)。互換性エスケープハッチ — ファイル同等物は**ありません**; ルーティングはデフォルトでオンです。 | +| `BILI_ZONE_PORT` | 自己管理ポートゾーンのベース (#1660、デフォルト `18787`): すべての*レーン起動*プロキシ (claude/zcode ネイティブフック、ポート 0 を乗るランチャーレーン) はまずレーンのスティッキーレコードを試み、それがない場合はこのベースを試みます; ポート競合は子の +1 階段によって解決されます — ただし保持者が異なるビルドを実行している同じレーンの先行者 (アップグレード再起動オーバーラップ) の場合を除き、子はそれを待機 (最大 5 秒) し、ドリフトする代わりに同じポートを再バインドします (#1723) — そして決定されたポートは `/port-zone.json` 下にスティッキーとして記録され、後の起動が自動的にドリフトに従います。手動 `bili start` は独自のデフォルト (`8787`) を保持します — ユーザーゾーンはレーンによって決して触れられません。 | +| `BILI_ZCODE_PORT` | zcode ネイティブレーンのプロキシのために**正確な**ポートをピン留めします (#1660): 起動は厳密ポートになります — スクワッターはホッピングする代わりに明確に拒否されます — そして共有ストアに書き込まれたラッパーはハンドオフなしでもセッション再起動を生き残ります。それがない場合、レーンは自己管理ゾーン (`BILI_ZONE_PORT` ベース + スティッキードリフトフォロー) を乗ります。 | +| `BILI_ZCODE_SIGNING_FIXED` | `1`/`true` = ZCode ビルドが ClientRequestSigningV4 を固定したと仮定します (#1621): v3.14+ パーソナルストアでのコーディングプランアカウントのエントリごとのスキップがオフに切り替わり、再びルーティングされます。一時的なエスケープハッチ — ファイル同等物は**ありません**。 | +| `BILI_CLAUDE_UPSTREAM` | claude 直接モード: `ANTHROPIC_BASE_URL` がすでにランチャーがバイパスするリレーを指している場合のリレーエンドポイント。 | +| `BILI_CLAUDE_NATIVE_PORT` | claude ネイティブレーンのフック起動プロキシのために**正確な**ポートをピン留めします (#964/#1660): 厳密ポートセマンティクス — ポート上のスクワッターはホッピングする代わりに明確に拒否されます — そして焼き込まれた管理 `ANTHROPIC_BASE_URL` はそれを指します。それがない場合、フックは自己管理ゾーン (`BILI_ZONE_PORT` ベース + レーンごとのスティッキー) を乗り、セッションごとに管理 URL をライブオリジンに再ピン留めするため、ポートドリフトは自己修復します (#1660)。 | +| `BILI_CODEX_COMPACT` | Codex ネイティブコンパクト化処理。デフォルト `intercept`: bili は codex のコンパクト化リクエストをインターセプトし、セーフティゲートがパスした場合 (transform ok + 定常状態使用量 < ウィンドウの 90% + アクティブな圧縮ブロック少なくとも 1 つ) ACP 状態へのローカルハンドオフを偽造します — トリガー形式は 2 フレーム SSE を偽造し、エンドポイント形式は `{output}` を偽造 — そして決して上流に連絡しません。スコープ (#3008): 明示的な形式 (compaction_trigger + /responses/compact) と、SUMMARIZATION_PROMPT テンプレートによって検出される通常のターンとして通過するインラインオートコンパクト化をカバーします — ユーザーオーバーライドされた compact_prompt は検出から落ち、逐語通り通過します; bili が観察したのみ (pass/gate) のコンパクト化は事後にリベースされます (#2372)。偽造された ACP サマリーは履歴運搬ハンドオフメッセージ (developer-message フォールバック) として再注入され、codex が履歴を切り詰めた後も圧縮コンテンツが可視のままになります。`pass` に設定するとオプトアウトし、codex のコンパクト化リクエストを上流に転送します (ネイティブコンパクト化バックストップ)。ゲート失敗時には、リクエストは変更なしで通過します。Codex クライアント検出 (これが適用されるトラフィック、ウィンドウクランプとセッションアイデンティティフィンガープリンティングにも使用): User-Agent は登録されたプレフィックス (`codex_cli_rs/`, `codex_exec/`, `codex desktop/` — 大文字小文字を区別せず一致、Codex Desktop のようなバリアントが最初の文字を大文字で送信するため #1169) で始まるか、小文字 `codex` で始まる空白区切りコンポーネントを含む必要があります (未知のバリアント、例: `codex_sdk_ts/…`、#645 — #1641 で素の部分文字列からトークンレベルプレフィックスに狭められ、トークン中や括弧内で "codex" を単に言及する非 codex クライアントはもはや誤分類されません; フォールバックは意図的に大文字小文字を区別するため、"Codex" 形状のリレーは除外されます、#1106)。 | +| `BILI_CODEX_STATE_MODE` | codex 状態処理 (#2222, #3203)。デフォルト `auto`: codex バイナリが `CODEX_SQLITE_HOME` を尊重する場合 (codex-cli ≥ 0.147.0、キャッシュされた `--version` 呼び出しでプローブ)、bili はそれを REAL `$CODEX_HOME` に向けます — codex は WAL モード状態 db を REAL ホームの単一の物理パスに保持し、bili とネイティブ実行の間でライブ共有します。各起動は有界プール (`-bili-s1..s16`) から独自のセッション別オーバーレイスロットを取得します: 生成ファイル (.env, config.toml) とプロキシバインディングはスロットごとであるため、1 つの `$CODEX_HOME` で最大 16 つの独立したセッションが並行して実行され、それぞれが独自のレーン (`codex-s` — 同じビルドの 2 つの起動が 1 つのレーンを共有するとポート層で互いを拒否する、#3044) で実行される独自のプロキシを介してルーティングされます。スロットは永続化され再利用されます — コールドスタートスレッドレコードがそれらを通じて解決されるため、決して自動削除されません (#43bf59fc9) — したがって、クラッシュしたセッションのスロットは次の起動によって単に回収されます。起動ごとの db コピーがないため、終了時のマージバックも `.bili-conflict` 世代もありません (#381/#1917/#1918/#1919/#1951/#1965/#2195 パッチファミリーはこのモードで退役)。#3203 以前の固定名 `-bili` オーバーレイは、同じ出所裁定の下で、最初の共有モード起動時に REAL ホームに一度だけ移行されます; ライブなレガシー時代の起動がそれを保持している間は、起動は拒否されます。`shared` はこのモードを強制します (バイナリが古すぎる場合はレガシーに明確にダウングレード); `legacy` は単一の排他オーバーレイ (一度に 1 つの起動) を持つ古い起動ごとのコピー / マージバックメカニズムを強制します。環境変数のみのエスケープハッチ — ファイル同等物は**ありません**。ユーザー設定の `CODEX_SQLITE_HOME` はそのまま尊重されます (ネイティブと bili の実行は 1 つの論理 db を共有する必要がある); 管理 requirements.toml `sqlite_home` は両方より優先されます。 | +## 上流障害の診断(プロキシ経由の上流) + +すべての上流トランスポート障害は、ログ行の先頭(およびクライアント/ステータスが参照する `error:` 文字列)に付与される `kind=` に分類され、それぞれに修復ヒント(`hint=...`)が添えられている。分類体系(#1263): + +| kind | 意味 | bili の挙動 | +|------|---------|---------------| +| `client-abort` | 下流クライアントが切断した | なし(定義上、リクエストは既に死んでいる) | +| `upstream-timeout` | アイドル予算の期限切れ(ヘッダー/ボディ)またはリクエストウォッチドッグによる中断 | **リトライされない** — 待機予算を積み重ねない | +| `connect-timeout` | TCP ハンドシェイクが完了しなかった(エンドポイントに到達不能/ブラックホール化) | 透明なリプレイ、`BILI_REPLAY_RETRY_MAX` で上限設定 | +| `proxy-reset` | **プロキシ経由**でレスポンス前に接続が切断された(主な疑い先: プロキシのアイドルリサイクル / ペイロード上限 / ノード変動) | 透明なリプレイ、`BILI_REPLAY_RETRY_MAX` で上限設定(デフォルトは合計 3 回の試行) | +| `upstream-reset` | 同上、直接接続の場合(上流/ローカルネットワークを疑う) | 同上(`BILI_REPLAY_RETRY_MAX` で上限設定) | +| `connect-refused` | TCP が拒否された(設定されている場合はプロキシ、それ以外は上流) | 同上(`BILI_REPLAY_RETRY_MAX` で上限設定) | +| `upstream-unreachable` | ホストへのルートがない(ICMP `EHOSTUNREACH` / `ENETUNREACH` / `EHOSTDOWN`)— ルーティング / ACL / ファイアウォールの `REJECT`; macOS ではローカルネットワークのプライバシー拒否も含む(#5663) | 同上(`BILI_REPLAY_RETRY_MAX` で上限設定) | +| `dns` | 名前解決に失敗(DNS サーバー / ホスト名のタイプミス) | 透明なリプレイ、`BILI_REPLAY_RETRY_MAX` で上限設定 | +| `tls` / `unknown` | TLS/ハンドシェイク失敗(CA/MITM)/ 分類不能なトランスポート障害 | リトライされない | + +ハンドシェイククラスのレジリエンスは、プロキシ経由の接続に対するキープアライブ上限(`BILI_PROXY_KEEPALIVE_MAX_MS`、デフォルト 55 秒)と組み合わされ、bili はまもなくリサイクルされるプロキシのソケットを提供することを停止する。 + +長時間セッションで周期的な接続障害が発生した場合の**4 ステップのチェックリスト**(#1249 より): +1. `bili.log` を `kind=` で grep する — `proxy-reset` のクラスタは外部プロキシを指し示し、`upstream-timeout` は上流の健全性を指し示す。 +2. 失敗したリクエストのタイムスタンプを、外部プロキシ自身のアクセスログ(同じホストクロック)と照合する — 同じミリ秒にリサイクルエントリがあれば、原因が確定する。 +3. どのホップかを特定する: 同じ行内の `proxy=` と `proxy=direct` を確認し、転送されたリクエストの `content-length` をプロキシの文書化されたペイロード上限と比較する。 +4. プロキシがリサイクラーである場合、そのアイドルタイムアウトを引き上げるか、bili の 55 秒再利用上限 + 1 回リプレイのセーフティネットに吸収させる。 + +**ホスト側のリトライ階層化(#2568 の項目 4)。** プラグインホストが bili の背後で実行されている場合(例: `bili pi`)、レスポンス前のトランスポート障害は、互いのカウンターを見ることができない 2 つの独立したレイヤーによってリトライされうる: + +1. bili→上流レグにおける、上記の bili トランスポートリプレイ(`BILI_REPLAY_RETRY_MAX` 試行以内、`BILI_REPLAY_RETRY_BASE_MS`×2ⁿ バックオフ); +2. ホスト→bili レグにおける、ホスト自身のターンレベルのリトライ予算(pi: `retry.maxRetries`、デフォルト 3、ベース遅延 2 秒の指数バックオフ; 表面化されたエラーテキストが一時的パターンテーブルに一致した場合に発火)。 + +これらのレイヤーは、一方が他方に譲るのではなく、接続クラスの障害に対して意図的に重複している: bili の高速なローカルリプレイは、ホストがターンパイプライン全体を再実行する前にミリ秒単位のブリップを吸収し、ホストレイヤーは `BILI_REPLAY_RETRY_MAX=1`(フェイルファスト)の場合でもターンを保護する。完全に死んだ上流に対する結果: ユーザーに見える 1 ターンあたりの最悪ケース = (ホスト試行数) × (bili 試行数) の接続 — デフォルトでは 4 × 3 = **12**、エラーが表面化する前に約 30–35 秒のネストバックオフが発生する。両方の予算は有限の固定カウントであるため、最悪ケースは有界に保たれる。 + +デバッグ中に 2 つのログを相関させる場合: 各 bili トランスポートリプレイは `[] [acp-proxy] upstream (pre-response network failure): ; retrying in ms (attempt n/m)` をログに記録する(warn レベル、`bili.log`); pi はターンリトライごとに `auto_retry_start` / `auto_retry_end` イベントを発行する(インタラクティブ TUI のステータス行)。セッション ID + タイムスタンプウィンドウでそれらを一致させること — レイヤー間の共有相関 ID は存在しない。 +## CLI リファレンス + +完全なコマンド一覧(`bili --help` は省略版を表示する)。すべての優先順位: **CLI フラグ > 環境変数 > 設定ファイル > ビルトインのデフォルト**。 + +| コマンド | 機能 | +|---|---| +| `bili [start] [options]` | プロキシを起動する(デフォルトでは XDG 設定ファイルを読み込む) | +| `bili pi [opts --] [args]` | プロキシを起動し、それに対して **pi** を起動する | +| `bili pi-test [opts --] [args]` | `bili pi` と同じだが、`--no-extensions` を追加する(クリーンルームテスト — プロキシが圧縮を管理する) | +| `bili codex [opts --] [args]` | プロキシ + **codex** | +| `bili claude [opts --] [args]` | プロキシ + **claude** (Claude Code CLI) | +| `bili omp [opts --] [args]` | プロキシ + **omp** (pi ベース) — opencode zen モデルはデフォルトの `opencode.ai` MITM ホワイトリストに乗る (#1405) | +| `bili opencode [opts --] [args]` | プロキシ + **opencode** — ビルトインの zen ゲートウェイ (`opencode.ai`) はデフォルトで cert-MITM される (#1405); `~/.config/opencode/opencode.json` / `~/.omp/omp.json` の `providers[].baseURL` に宣言されたホストは自動的に MITM ホワイトリストに参加する (#1411), また `~/.aider.conf.yml` / `~/.config/opencode/.aider.conf.yml` も同様の目的で監視される | +| `bili hermes [opts --] [args]` | プロキシ + **hermes-agent** (`/bili/` リライト) | +| `bili dsh [opts --] [args]` | プロキシ + **deepseek-harness** (ループバック以外のアップストリームはプロキシ環境変数経由、ループバックは `/bili/` リライト経由 — #535; `--profile web "task"` のような引数はそのままパススルーされる) | +| `bili codebuddy [opts --] [args]` | プロキシ + **codebuddy** (Tencent CodeBuddy Code CLI) — `CODEBUDDY_BASE_URL` の `/bili/` リライト、OpenAI chat-completions ワイヤプロトコル; バジェットは `CODEBUDDY_AUTO_COMPACT_WINDOW` で制御 (#640) | +| `bili qoder [opts --] [args]` | プロキシ + **qoder CLI** (`qoder`/`qodercli`) — `HTTPS_PROXY` + `NODE_EXTRA_CA_CERTS` による cert-MITM; モデルエンドポイントは https がハードコードされているため `/bili/` リライトは不要(デフォルトのホストマップがホワイトリスト化済み)(#653)。Qoder **Desktop** は別個の BYOK/カスタムチャネルであり、`/bili/` プレフィックス付きのプレーンテキスト OpenAI を話す — bili を通常のカスタムプロバイダーとして指定する(この MITM レーンではない); 公式サブスクリプションのトラフィックは暗号化されており、対象外 (#764) | +| `bili trae [opts --] [args]` | プロキシ + **Trae CLI** (ByteDance、クローズドソースの Go バイナリ) — `HTTPS_PROXY` + `SSL_CERT_FILE` による cert-MITM; モデルホストは `TRAE_CLI_API_HOST` またはデフォルトのエントレプライズゲートウェイから取得 (#655) | +| `bili jcode [opts --] [args]` | プロキシ + **jcode** (Rust 製エージェントハーネス) — `HTTPS_PROXY` + `SSL_CERT_FILE` による環境変数専用の cert-MITM 起動; ホスティングモデルホスト (`api.z.ai`) はホワイトリスト化、ローカルループバックプロバイダーは `NO_PROXY` 経由で直接接続のまま | +| `bili kimi [opts --] [args]` | プロキシ + **Kimi Code** (Moonshot CLI) — `HTTPS_PROXY` + `NODE_EXTRA_CA_CERTS`/`SSL_CERT_FILE` による cert-MITM; プロバイダー/モデルホストは `~/.kimi-code/config.toml` (`KIMI_CODE_HOME` を尊重) または宣言がない場合の管理 OAuth エンドポイントから取得; ループバックエンドポイントは手動 `/bili/` プレフィックスのヒント付きでインベントリ化される (#757) | +| `bili test pi` | pi パスの非汚染エンドツーエンドスモークテスト | +| `bili export [session] [--full] [--jsonl] [--output FILE]` | 永続化されたセッションの一覧表示 / 1 つを Markdown ハンドオフとしてエクスポート(または `--jsonl`: 存在する場合統一インデックスからレンダリングされた行区切り JSON ダンプ、それ以外はレガシーレコード — 生成された相互運用成果物であり、真実のソースではない)— [Sessions & Migration](#sessions--migration) を参照 | +| `bili acp-cache diff [--json] [--log FILE] [--no-log] [--session SID]` | `ACP_DUMP_BODY` ダンプからのキャッシュミス要因を特定 — セッションごとに隣接リクエストのプレフィックス差分を計算 (#1266) | +| `bili update` | 今すぐ新しいバージョンを確認してインストール(3 分間のスロットルをバイパス) | +| `bili plugin install ` | ネイティブツールプラグイン / MCP ブリッジをホストにインストール — [Plugin Mode](#plugin-mode-native-tools) を参照 | +| `bili plugin remove ` | 再度削除する | +| `bili plugin list` | すべてのホストのインストール状態を表示 | +| `bili mcp` | bili MCP サーバーを stdio で単独実行 | +| `bili plugin-register [--origin URL] [--agent name]` | 会話 ID をプラグインモードに事前バインド(高度な機能) | +| `bili --version` / `bili --help` | バージョン / ヘルプを表示 | + +ランチャーコマンドの `--` の後のものは、クライアントにそのままパススルーされる(`bili pi -- print "hi"`)。 + +### オプション + +| フラグ | 効果 | +|---|---| +| `--port ` | リスニングポート(デフォルト `8787`) | +| `--host ` | リスニングホスト(デフォルト `127.0.0.1`) | +| `--config ` | 設定 JSON のパス(デフォルト: XDG 場所) | +| `--debug` | 詳細ログ出力 | +| `--passthrough` | 圧縮なしで転送 | +| `--no-passthrough` | 圧縮を強制オン(設定を上書き) | +| `--no-auto-update` | この実行でのバックグラウンド自己更新を無効化 | +| `--mitm-domain ` | 追加の MITM ホワイトリストエントリ(繰り返し指定可能; ランチャーのみ) | + +--- + +## クライアント統合 + +ランチャーを使わずにクライアントをプロキシに向ける 2 つの方法: **`/bili/` プレフィックス**(API キー使用クライアント)と **MITM トランスパレントモード**(エンドポイントがハードコードされたログイン使用クライアント)。 + +### `/bili/` プレフィックス (API キー使用クライアント) + +**API キー**(ログインではなく)で設定するクライアントでは、アップストリーム URL を変更できる。プロキシオリジン + `/bili/` を先頭に付けるだけでよい — これが唯一の変更点である。API キーはクライアント設定に残り、そのままパススルーされる。 + +**OpenCode** — `~/.config/opencode/opencode.json` を編集し、プロバイダーの `baseURL` を変更する: + +```jsonc +// before: +"baseURL": "https://open.bigmodel.cn/api/coding/paas/v4" +// after (prepend the proxy origin + /bili/): +"baseURL": "http://localhost:8787/bili/https://open.bigmodel.cn/api/coding/paas/v4" +``` + +**OpenCode に関する注記.** これは OpenCode の**プラグインなし**パスである。そのような設定に対してネイティブプラグインもインストールされている場合、ランタイムはセッションごとに 1 回、修正ガイド(プレフィックスの削除またはプラグインの削除)付きで警告を発する; リクエスト自体はプレーンプロキシパスを維持する。相互に排他的な 3 つの OpenCode アクセスパスは [clients.md](clients.md#opencode) に文書化されている。 + +**その他のクライアント.** 同じ 1 行プレフィックスは、モデルベース URL を編集できる任意のクライアント(Cline / Roo Code / Kilo Code, Continue, OpenHands, Zed, Void, Cursor の単一モデルオーバーライド、…)で動作する — 検証済みのエントリポイントは [clients.md → Adopting unlisted clients](clients.md#adopting-unlisted-clients-any-client-with-a-configurable-model-base-url-2340) にリストされている。 +**Codex (API キー)** — `~/.codex/config.toml` を編集し、プロバイダーの `base_url` を変更する: + +```toml +# before: +base_url = "https://api.openai.com/v1" +# after: +base_url = "http://localhost:8787/bili/https://api.openai.com/v1" +``` + +**Codex (ChatGPT ログイン)** — トップレベルの `openai_base_url` フィールドを設定する(`model_provider = "openai"` と OAuth ログインを維持): + +```toml +# ~/.codex/config.toml (top-level field, not a section) +model_provider = "openai" +openai_base_url = "http://localhost:8787/bili/https://chatgpt.com/backend-api/codex" +``` + +通常通り `codex login` を実行する; OAuth トークンは `Authorization` ヘッダーに含まれ、プロキシはそれをそのまま転送する。 + +**Pi** — `~/.pi/agent/models.json` を編集し、プロバイダーの `baseUrl` を変更する: + +```jsonc +// before: +"baseUrl": "https://api.anthropic.com" +// after: +"baseUrl": "http://localhost:8787/bili/https://api.anthropic.com" +``` + +**Claude Code** — `ANTHROPIC_BASE_URL` 環境変数を `/bili/` URL に設定する。(`/bili/` 形式は手動オプションである: 古い claude ビルドはプロキシ環境変数を完全に無視していたが、新しいビルド(例: 2.1.301)は `HTTPS_PROXY` を尊重する — 環境がループバックトラフィックをプロキシ経由でルーティングする場合、この URL が直接接続されるよう `NO_PROXY` にループバックホストを含めること (#3446).) + +```bash +export ANTHROPIC_BASE_URL="http://localhost:8787/bili/https://api.anthropic.com" +``` + +**Vertex AI 上の Claude Code** (`CLAUDE_CODE_USE_VERTEX=1`) — Vertex 下ではプレーンキーは無効である: Claude Code は `ANTHROPIC_BASE_URL` を無視し、`/projects/

/locations//publishers/anthropic/models/:rawPredict|streamRawPredict` をダイヤルし、そのパスをベース URL に**そのまま**(末尾のパスも含めて)追加する。代わりに `ANTHROPIC_VERTEX_BASE_URL` をルーティングする: + +```bash +export CLAUDE_CODE_USE_VERTEX=1 +export ANTHROPIC_VERTEX_PROJECT_ID= +export CLOUD_ML_REGION=global +export ANTHROPIC_VERTEX_BASE_URL="http://localhost:8787/bili/anthropic/https://aiplatform.googleapis.com/v1" +``` + +この URL が正しくなければならない 3 つのポイント(各々が欠けるとサイレントに 404 になる): + +- **`/v1` はベース URL に含まれる。** クライアント自身のパスは `/projects/…` から始まる; Vertex は `/v1/projects/…:rawPredict` を提供し、バージョンなしの形式は 404 になる。 +- **`anthropic` セグメントは必須である。** `/bili/` だけでは、プロキシはパスサフィックスで分類し、`:rawPredict` は既知のサフィックスにマッチしない — 明示的なプロトコルマーカーが anthropic レーンを選択する。 +- **ホストと `locations/` は一致しなければならず**、ホストはリージョンに従う: `global` → `https://aiplatform.googleapis.com`, `us`/`eu` → `https://aiplatform..rep.googleapis.com`, その他のリージョン → `https://-aiplatform.googleapis.com`。 + +このレーンでは認証は変更されない: Claude Code は独自の ADC アクセストークンを発行し、bili はそれのために認証を発行しない。`bili claude` は上記すべてを自動的に実行する — `ANTHROPIC_VERTEX_BASE_URL` を同じルーティング形式に設定し、プレーンキーはそのまま残す(Vertex 下では無効なので、プロバイダーがオフに切り替わっても 1 回の起動で動作する)。 + +> **Auto-compact の整合性(手動モードのみ).** `bili claude` ランチャーは、モデルに対する bili の有効ウィンドウに `CLAUDE_CODE_AUTO_COMPACT_WINDOW` を自動的に設定するため、claude 自身の auto-compact しきい値が bili の圧縮バジェットと一致する。手動 `/bili/` モードではこれを手動で行う必要がある — さもないと、claude は bili のウィンドウと一致しないしきい値で独自のローカル auto-compact(「会話を要約する」ターン)を実行する可能性がある。これは通常は無害である(同じセッション ID なので、bili は切り詰めから状態を再導出する)が、必要以上にノイズが多い。モデルに対する bili の有効ウィンドウに設定すること: +> +> ```bash +> export CLAUDE_CODE_AUTO_COMPACT_WINDOW= +> ``` +> +> claude はこの値をモデルに対して認識しているウィンドウに**下方向に**クランプする(上方向にはしない)ため、過剰設定は安全である。claude の設定(`autoCompactWindow`)経由で永続的に設定することもできる。 + +**その他の API キー使用クライアント** (Cursor / Aider / Continue …) — アップストリーム URL が設定されている場所に関係なく、`http://localhost:8787/bili/` を先頭に付ける。それ以外の変更はない。 + +`/bili/` プレフィックスは**自己検出シグナル**としても機能する: 10 億コンテキストクライアント拡張(billion-context-pi / opencode-acp)は自身の baseUrl でこれを認識し、自己無効化するため、二重圧縮が発生することはない。 +### MITM 透明プロキシ(ログインクライアント) + +**アカウントにログイン**するクライアント(ChatGPT Plus/Pro、Claude、ZCode コーディングプランなど)は、OAuth 経由で認証を行い、多くの場合**エンドポイントをハードコード**している。baseURL を変更できない場合、プレフィックスのトリックは機能しない。これらのクライアントには代わりに MITM モードを使用する。 + +動作原理: クライアントが提供する設定は**HTTP プロキシ**のみであるため、`CONNECT :443` を送信する。billion-context はローカルで TLS を終了処理し(ローカルで生成されたルート CA を使用)、プレーンテキストに圧縮を注入し、再暗号化して転送する。OAuth トークンはクライアントの `Authorization` ヘッダーに含まれており、そのまま転送されるため、サブスクリプションの割引は維持される。 + +対応する MITM クライアント: + +| クライアント | ログイン | エンドポイントのハードコード | ステータス | +|---|---|---|---| +| **ZCode** | bigmodel コーディングプラン (OAuth) | `open.bigmodel.cn` (組み込みプロバイダー) | ✅ テスト済み | +| **Claude Code** | Claude サブスクリプション (OAuth) | `api.anthropic.com` | ❓ 未テスト(動作しない可能性がある — 確認が必要) | +| **CodeBuddy** (VS Code IDE) | IDE アカウントログイン | `copilot.tencent.com` (`http.proxy` 経由で到達) | ✅ ユーザー確認済み (#897) | + +> **Codex の例外:** Codex はトップレベルの `openai_base_url` 設定フィールドを公開しているため、ChatGPT ログイン版は `/bili/` プレフィックスを使用できる(上記参照)。Codex には MITM は不要である。 + +> **ZCode ネイティブモード (#1145):** ZCode はこのリストの中で唯一、**ネイティブプラグインモード**も備えているクライアントである — `bili plugin install zcode` はモデルトラフィックをプロバイダーストア(`~/.zcode/v2/config.json`、または v3.14 以降では `provider_config.json`)経由でルーティングする。v3.14 以降のビルドでは、ZCode のクライアント署名がコーディングプランアカウントの http ループバックオリジンを拒否するため、それらのアカウントは記録された理由付きで直接接続のままとなり、他のすべてのプロバイダーはルーティングされる — これらのアカウントでの圧縮には GUI の証明書 MITM 設定を使用すること、#1621。それ以外の場合、GUI のプロキシ/CA 設定は全く不要である。ネイティブモードは MITM サーフェスには影響しない: 両方を実行する場合、ログイントラフィックのために GUI のプロキシ設定(および `"mitm://zcode.z.ai": { "passthrough": true }` ルート、#661)を維持すること。詳細な仕組み: [clients.md](clients.md) (*ZCode*)。 + +MITM はモデルホストの**ホワイトリスト**(`open.bigmodel.cn`、`api.anthropic.com`、`api.openai.com`、`chatgpt.com`)にスコープが限定され、さらにレーンの設定が存在する場合、ディスカバリーが自動シードするレーンごとの標準ゲートウェイのデフォルト(例: `opencode.ai` — `opencode auth login` からの opencode の組み込み zen ゲートウェイ、#1405)が含まれる。その他のすべての HTTPS ホストはブラインドトンネル化される — billion-context はモデル以外のトラフィックを復号化しない。 + +> **CONNECT のみクライアント (`http.proxy`):** 多くの IDE クラスのクライアント(CodeBuddy、Cursor、Windsurf など)はモデル base-URL 設定を提供しない — すべてトラフィックを `CONNECT` を介した HTTP プロキシ経由でルーティングする。そのようなクライアントは、そのモデルホストが上記でホワイトリストに登録されている場合(またはランチャーによって発見/自動ホワイトリスト化されている場合)にのみ復号化される。それ以外の場合、そのトンネルは**ブラインド**である: エラーは出ないが、billion-context がプレーンテキストを見ることができないため、**圧縮もされない**。この設定ミスは明示的に表面化される (#897): ホストごとの最初のブラインドトンネルは修正手順付きの一度限りの `BLIND TUNNEL WARNING` をログに記録する; `GET /__bili/health` と `/__bili/stats` は `blindTunnels`(カウント + 正確なターゲットホスト、ループバックのみ)を報告する; そしてそのようなトンネルが存在する間、`acp_status` には `UNDECRYPTED TRAFFIC (instance-level)` セクションが追加される。修正方法: クライアントのモデルドメインを `"mitm".domains`(または `BILI_MITM_DOMAINS`)に追加し、再起動し、以下の手順に従ってルート CA を信頼する。なお、プロキシログはデフォルトで非パブリックなターゲットホストをマスクする(``、#255)— ローカルログでそれらをそのまま見るには `BILI_LOG_MASK_HOSTS=0` を設定すること。 + +ワンタイムセットアップ(クライアントでルート CA を信頼する): + +1. ルート CA を生成するために一度だけプロキシを起動する: + + ```bash + bili start + ls ~/.local/share/billion-context/ca/root-ca.pem # 現在存在する + ``` + +2. クライアントの**設定 → ネットワーク / プロキシ**で以下を設定する: + - **HTTP プロキシ**: `http://127.0.0.1:8787` + - **プロキシ CA 証明書パス**: このマシンで bili が実際に生成した CA ファイル — Linux/macOS では `~/.local/share/billion-context/ca/root-ca.pem`、Windows では `%USERPROFILE%\.local\share\billion-context\ca\root-ca.pem`。Web UI のルーティングページの ZCode カードには、このマシン上の実際のパスがコピーボタン付きで表示される — それを貼り付けるだけでよい。 + - (任意)**プロキシ除外リスト**: `localhost,127.0.0.1` + - (ZCode の場合のみ: **設定 → ネットワーク**。Claude Code にはこれらは不要である: ランチャーが `ANTHROPIC_BASE_URL` 経由でルーティングし、そのモデルトラフィックはループバック上のプレーン http であり、その子プロセス環境変数にはもはや `HTTPS_PROXY`/`NODE_EXTRA_CA_CERTS` が含まれない — それらを自分で設定しても、セッション内のツールが不要なプロキシを指すだけである。) + + > **Windows に関する注記:** Windows 上の ZCode は `~` を展開**しない** — `~/...` パスは見つからない(現在の作業ディレクトリとは無関係)。完全な絶対パスを入力すること、例: `C:\Users\\.local\share\billion-context\ca\root-ca.pem` (#342)。 + +3. クライアントを再起動する。そのモデルトラフィックは現在、圧縮が注入されて billion-context 経由で流れる。メッセージを送信し、プロキシログ(`~/.local/state/billion-context/bili.log`)で `mitm :443 tunnel established` を確認すること。 + +> ルート CA はローカルで生成され、このマシン上にのみ存在する; それは**システム全体のインストールではない**。設定したクライアントのみ(その CA パス設定を介して)がそれを信頼するため、他のアプリには影響しない。CA ファイルを削除してプロキシを再起動すると、それらは再生成される。 + +MITM ログインクライアントに**独自のアップストリームプロキシ**(ファイアウォール/GFW)を、同じホスト上の API キークライアントに影響を与えずに与えるには、`mitm://` スキームキーを使用すること — [MITM vs `/bili/` キースキーム](#mitm-vs-bili-key-schemes) を参照。 + +--- +## ランチャー参照 + +`bili ` は独立したポートでプロキシを起動し(**起動のたびに新しいインスタンス** — 既に実行中の `bili start` は再利用されません、#216)、そのプロキシを指すようにクライアントを実行します。**設定ファイルの編集は不要**です:クライアント自身の設定は**読み取り専用**で参照され、どのアップストリームホストと通信しているかを特定するために使用されます。これらのホストは MITM 用に自動ホワイトリスト化され、プロキシはクライアントが使用するホストに対してのみ TLS を終端します。クライアントが終了すると、ランチャーが起動したプロキシは停止されます。 + +両方のアップストリーム方式は設定編集なしで自動的にカバーされます: + +- **HTTPS アップストリーム → 証明書による MITM。** クライアントは `HTTPS_PROXY` 経由でプロキシに接続され、プロキシの MITM ルート CA(`~/.local/share/billion-context/ca/root-ca.pem`、遅延生成)を信頼します。圧縮は傍受された TLS ストリームに注入されます。 +- **HTTP / ローカルホスト アップストリーム → `/bili/` baseURL の書き換え**(プレーンテキストは MITM できないため)。ランチャーは、クライアント自身のメカニズムを通じて、設定の分離された一時コピーを使用してクライアントのベース URL を書き換えます — 実際の設定ファイルには一切触れません(詳細は下記参照)。 + +各クライアントがどのようにプロキシに接続されるか(子プロセスの環境変数に自動設定): + +| クライアント | リダイレクト | CA 信頼 | +|---|---|---| +| pi | `HTTPS_PROXY` + `BILI_PROVIDER_REWRITES` 環境マニフェスト(拡張機能 `registerProvider`) | `NODE_EXTRA_CA_CERTS` | +| omp | `HTTPS_PROXY` + `BILI_PROVIDER_REWRITES` 環境マニフェスト(拡張機能 `registerProvider`)+ `PI_PROXY` も `PI_PROXY_ANTHROPIC` もユーザーが設定していない場合の `PI_PROXY_ANTHROPIC=`(OMP の Cowork anthropic レーンを node:https 直接接続ではなくプロキシ経由にルーティング、#2583/#3556) | `NODE_EXTRA_CA_CERTS` | +| codex | `HTTPS_PROXY` + `-c key=value` オーバーライド | `SSL_CERT_FILE` → `combined-ca.pem` | +| claude | `ANTHROPIC_BASE_URL` = `/bili/` URL(Vertex の場合:`CLAUDE_CODE_USE_VERTEX=1` 時の `ANTHROPIC_VERTEX_BASE_URL`;+ `NO_PROXY`/`no_proxy` のループバックマージ、#3446) | 不要 | +| opencode | `HTTPS_PROXY` + 分離された `OPENCODE_CONFIG` | `NODE_EXTRA_CA_CERTS` | +| hermes | `HTTPS_PROXY`(プレーン HTTP は絶対形式のフォワードプロキシリクエストに乗る) | `SSL_CERT_FILE` → `combined-ca.pem`(+ レガシー `HERMES_CA_BUNDLE` → `root-ca.pem`) | +| dsh | `HTTPS_PROXY`(プレーン HTTP の場合は `HTTP_PROXY` も)+ `DEEPSEEK_BASE_URL`;**ループバック専用**の分離された `DSH_HOME` | `SSL_CERT_FILE` → `combined-ca.pem` | + +`NODE_EXTRA_CA_CERTS` は組み込みの信頼ストアに*追加*するため、MITM ルート単独(`root-ca.pem`)を指します。一方、`SSL_CERT_FILE` はデフォルトの CA バンドルを*置き換える*ため、codex/dsh/hermes では `combined-ca.pem` を指します — これは MITM ルート**および** OS 信頼ストアと Node の公開ルートを含むバンドルであり、CA 証明書にのみ絞り込まれています(#5802: darwin の `security(1)` キーチェーンエクスポートには `com.apple.kerberos.kdc` のような非 CA のリーフアイデンティティが含まれ、codex の rustls スタックのような厳密な置き換えセマンティクスのクライアントは、エントリが 1 つでも解析に失敗するとファイル全体を拒否するため)。OS ストアのマージが重要なのは、起動された一部のクライアントがこのファイルを*完全な*信頼プールとして扱うためです(codex の rustls HTTP スタックは追加ではなく置き換える、#1807):それらの直接接続(プロキシを経由しない)はこのファイル単独に対して検証される必要があるため、このファイルは OS 自身が信頼するもののスーパーセットでなければなりません(Windows 証明書ストアは PowerShell 経由、macOS キーチェーンは `security(1)` 経由;Linux はすでにファイルシステムバンドルを読み取っています;最大 24 時間ごとに 1 回再構築)。pip/git/curl スタイルの TLS(ブラインドトンネル化、実際の証明書)を子プロセス環境内で動作させることが、このバンドルの元の理由です(#152;hermes は #1375 以降、現在の hermes は `SSL_CERT_FILE` 経由でのみ環境信頼を解決するため;OS ストアのマージは #1807 以降)。 + +Claude Code は、証明書による MITM ではなく、独自のベース URL 変数を通じて `/bili/` URL 形式にルーティングされます — すべてのアップストリーム、事前設定された `ANTHROPIC_BASE_URL` リレーや `CLAUDE_CODE_USE_VERTEX=1` 下の Vertex エンドポイントを含みます;CA 信頼は不要です。古いビルドはプロキシ環境変数を完全に無視していましたが、新しいビルド(例:2.1.301)は `HTTPS_PROXY` を尊重するため、ランチャーはループバックホストを `NO_PROXY`/`no_proxy` にマージします(既存の値を保持しつつ)、子プロセスがどの挙動を持つかに関係なく `/bili/` 経路を直接に保つためです(#3446)。 + +アップストリームがどこから検出されるか(読み取り専用): + +| クライアント | 読み取り元 | +|---|---| +| Pi | `~/.pi/agent/models.json` — 各プロバイダーの `baseUrl` | +| omp | `~/.omp/agent/models.yml` — 各プロバイダーの `baseUrl` | +| Codex | `~/.codex/config.toml` — 各 `[model_providers.]` の `base_url`(+ トップレベルの `openai_base_url`) | +| Claude Code | `ANTHROPIC_BASE_URL` 環境変数;`CLAUDE_CODE_USE_VERTEX=1` の場合は `ANTHROPIC_VERTEX_BASE_URL` / `CLOUD_ML_REGION` から導出される Vertex ホスト、それ以外はハードコードされた `api.anthropic.com` | +| OpenCode | `~/.config/opencode/opencode.json` — 各プロバイダーの `baseURL` | +| hermes | `~/.hermes/config.yaml` — 各プロバイダーのエンドポイント行 | +| dsh | `~/.dsh/settings.yaml` — すべての `baseURL`/`baseUrl`/`base_url` 値、目的地別に分割(ループバック → `/bili/` 書き換え;非ループバック https → MITM ホワイトリスト;非ループバック http → `HTTP_PROXY`);+ `$DEEPSEEK_BASE_URL` 経由の組み込み `deepseek-official` ルート | + +### 生成ファイル(書き込まれるもの — 最終手段のみ、#535) + +ランチャーはファイルなしの注入を優先します(環境変数 > CLI フラグ/拡張機能 API > 生成ファイル;technical-notes.md の「注入優先順位」セクション参照)。ファイルが避けられない場合、それは**コピー**です — 実際の設定は決して編集されません: + +- **pi / omp** — 何も書き込まれません(#535):プロバイダーの baseUrl は、読み込み時に bili 拡張機能が消費する `BILI_PROVIDER_REWRITES` 環境マニフェスト(`registerProvider`)に乗ります。また、自動ネイティブコンパクトは拡張機能内でキャンセルされます(`session_before_compact`;omp は `auto_compaction_start` アナウンスにより自動と手動を区別、#851)— ただし、プロキシが実際に会話を保持しているという肯定的な証拠がある場合のみ(プラグインがこのセッション ID に対して `x-bili-plugin-conversation` をスタンプした、または omp のアイデンティティ登録が成功した、または `/__bili/plugin/status?conversationId=` が確認した場合);非 http(s) のプロバイダー baseUrl(例:pi-claude-bridge のリテラル `"claude-bridge"`)はデフォルトではキャンセルされないため、それら自身のコンパクト引き継ぎが引き続き動作します(#1382);プロバイダーは `providers` テーブルのエントリ(キー = プロバイダー ID(ルーティングに対して非 URL キーは無効)、フィールド `"compactionOptIn": true`)または `BILI_NON_HTTP_PROVIDERS`(環境変数、カンマ区切り)でオプトインできます — ただし、オプトインは候補セットを広げるだけであり、オプトインされたプロバイダーであっても、上記の同じ肯定的な保持証拠がある場合のみキャンセルされます(#1392)— 手動 `/compact` はいずれの場合もユーザー所有のままです。実際の `~/.pi` / `~/.omp` ホームには触れません。 +- **opencode** — `OPENCODE_CONFIG` が指す一時 `opencode.json`(クライアント終了時に削除)、`/bili/` に書き換えられたプレーンテキスト baseURL **および薄いプラグインの追加**(`/acp` + `/acp-cache` コマンド)。OpenCode 1.x では、`opencode-acp` エントリはクローンから削除されます(ホストがそれを武装状態でロードしてはならないため)、代わりに薄いプラグインがそのパッケージをライブラリとしてインポートし、レガシーセッションにゲートされます;最初の削除されたスペックは `BILI_OPENCODE_ACP_SPEC` 経由で同梱され、ブリッジがホストがロードしたであろう正確なコピーをインポートできるようにします(#920)。相対的なローカルプラグインスペック(`./x`、`../x`)はクローン内で絶対パスに再アンカーされます — opencode はそれらを宣言した設定ファイルのディレクトリに対して解決しますが、クローンではそれがもはや該当しないためです(#826)。 +- **hermes** — 何も書き込まれません(#535):その httpx スタックは `HTTPS_PROXY`(+ `SSL_CERT_FILE` → `combined-ca.pem`;レガシー `HERMES_CA_BUNDLE` は古いビルドのために設定されたまま、#1375)に乗ります — https は CONNECT 証明書 MITM、プレーン HTTP は絶対形式のフォワードプロキシリクエスト。プロバイダーが設定されていない場合、ランチャーは警告を表示し、hermes は**プロキシなし**で実行されます(圧縮オフ)。 +- **dsh** — 目的地別に分割(#535):dsh の fetch スタックはプロキシ環境変数を尊重しますが、無条件のループバックバイパスを除きます。そのため、**非ループバック**のアップストリームは `HTTPS_PROXY`(証明書 MITM)/ `HTTP_PROXY`(絶対形式のフォワードプロキシリクエスト)に乗ります(`SSL_CERT_FILE` → `combined-ca.pem`);**ループバック**のアップストリームのみが、`/bili/` 経由でルーティングする書き換えられた `settings.yaml` を持つ永続オーバーレイ `DSH_HOME`(`~/.dsh-bili`)を保持します。`profiles/`、認証情報、セッションはシンボリックリンクで通されます;実際の `~/.dsh` には決して触れません。ホームルートにある SQLite データベースは共有の唯一の例外です:各起動でオーバーレイ内にプライベートコピーが作成され、終了時に単位としてマージバックされます(ファイルリンクされたメイン DB は、1 つの inode 上で 2 つのパスが独立した WAL を成長させることを許してしまうため — #1917)。組み込みの `deepseek-official` ルートは `$DEEPSEEK_BASE_URL` 経由で別途キャプチャされます(dsh は `settings llm-deepseek.baseURL` ?? 環境変数 ?? デフォルトを解決するため、ユーザー設定が優先され、環境変数はゼロ設定フォールバックです)— カスタムプロバイダーがなくても、deepseek ルートはデフォルトでプロキシされます。 +- **codex** — 永続オーバーレイ `CODEX_HOME`(`~/.codex-bili`、または `-bili`)、その他のエントリ(認証、セッション、モデル設定)は実際のホームへの共有リンクのままです。例外はホームルートにある SQLite データベース(`*.db` / `*.sqlite` / `*.sqlite3` — codex はそこにログ/状態を保持)です:各起動でオーバーレイ内にプライベートコピーが作成され、終了時に実際のホームへ**1 つの単位として**マージバックされます(新しいメイン DB ジェネレーションが勝つ;敗者は `.bili-conflict` として保存されます)。これら DB を 2 つのホーム間でファイルリンクすると、1 つの inode 上で 2 つのパスが独立した WAL を成長させることが可能になり — コミットされた書き込みが失われたり、データベースが破損したりします(#1917)。2 つの生成ファイル:(a) MCP 注入がオンの場合、マージされた `config.toml` — 実際の内容に加えて、スポン時の `[mcp_servers.bili]` ブロック(インライン `-c` 値は Windows の cmd.exe 引用符で生き残れないため、#681);(b) #1802 以降、生成された `.env`(モード 0600)が、**この**起動の `HTTP_PROXY` / `HTTPS_PROXY` / `ALL_PROXY` / `NO_PROXY` / `SSL_CERT_FILE` / `BILLION_CONTEXT_PROXY` を再ピン留めします:codex 自身の `load_dotenv()` は開始**後**に `$CODEX_HOME/.env` からランチャーのスポン環境を上書きするため、ユーザーの `.env` が例えば socks5h プロキシを指している場合、それ以外に codex が bili からサイレントにリルートされてしまいます(そして codex のカスタム CA rustls HTTP スタックは SOCKS を全く話せません)。他の `.env` 変数はそのまま引き継がれます;既存の共有 `.env` リンクは所有ファイルにマイグレーションされます;実際のホームの `.env` および他のすべての実際のホームファイルには決して触れません。Direct-URL モード(`BILI_LAUNCHER_DIRECT=1`)では `.env` は生成されません(保護すべき注入プロキシがないため)、MCP がなければオーバーレイ自体も生成されません。 + +### ランチャー内のネイティブツール + +- **pi** — プラグインがインストールされていない場合、ランチャーは pi の `-e ` フラグを利用して、その実行のみに `dist/agent/pi.js` をロードします(何も書き込まれません):ネイティブツール + `/acp`、`/acp-cache`、`/acp-rule` コマンドがデフォルトで利用可能(`/acp-cache` はサマリー台帳がデフォルト — 合計、判定、異常;`full`(または `--full`)を追加すると全行リストが表示され、`acp_cache` ツールに `detail: "full"` を渡すのと同じです)。インストールされている場合、シンボリックリンクされた `settings.json` がすでにそれをロードしているため — `-e` は追加されません。 +- **omp** — プラグインは同梱されていません;ランチャーは設定に読み込み可能な bili エントリがない場合に `-e dist/agent/omp.js` を自動注入します(pi と同じゼロ設定ライド)。2 つの omp 固有のメカニズムにより、プラグインはそこで完全にネイティブになります:omp 17.x は `loadMode` を省略した拡張機能ツールを `xd://` デバイス URL 下にマウントします(モデルのメインターンからは見えない)、そのためプラグインはツールを `loadMode: "essential"` で登録します — モデルは 4 つの ACP ツールをネイティブで取得します;また、omp のフォークは `before_provider_headers` を発行しないため、プラグインはランチャーのアイデンティティ登録(`POST /__bili/plugin/register`、omp のセッション ID = `prompt_cache_key`/`x-session-id` をキー)を通じて会話をバインドします — バインドされたセッションはプラグインモード(ワイヤー注入抑制)で実行され、ネイティブの `/acp`、`/acp-cache`、`/acp-rule` コマンドが利用可能になります。 +- **opencode** — 一時設定が薄いプラグインを自動的に追加します。 +- **claude / codex** — デフォルトでオン:ランチャーは単一の `bili` MCP サーバーを注入します(claude には一時的な `--mcp-config` ファイル;codex には定義がオーバーレイの生成 `config.toml` に存在、[生成ファイル](#generated-files-what-gets-written---last-resort-only--535) 参照 — いずれの場合も実際のホスト設定には何も書き込まれません)、そのためホストはデフォルトでネイティブツールを取得します(claude 2.1.227 / codex 0.147.0 で検証済み)。`BILI_LAUNCHER_PLUGIN=0` はプレーンワイヤーモードにフォールバックします — 検証されたビルドより古く、注入フラグに対してテストされていないホスト向け。 +- **codex + セルフホストアップストリーム自動フォールバック** — codex 0.147 は MCP ツールをモデルに `namespace` ツールタイプとして提供します;セルフホストサーバー(sglang/vllm/ollama/llama.cpp)はこれを解析せず、ツールがサイレントに見えなくなります。codex のアップストリームホストがループバック/プライベート(`127.0.0.1`、RFC1918、ULA、`.local`、…)であり、`BILI_LAUNCHER_PLUGIN` が未設定の場合、bili は自動的にワイヤーモード(すべてのサーバーが理解するフラットなツール)を使用し、stderr にそれを通知します。`BILI_LAUNCHER_PLUGIN=1` はプラグインモードを強制します。 +- **hermes** — プラグイン API なし;常にワイヤーモード。 +- **dsh** — ランチャーは常に dsh の argv に `--patch ` フラグをスパイスします(`~/.dsh-bili/.bili-acp.patch.yml` に書き込み)、プロファイルのローダーツリーに `dist/agent/dsh-acp.js` を挿入します:ネイティブの `/acp` と `/acp-cache` コマンド、dsh 自身の `/compact` と同じ形状(`/acp-cache` はデフォルトのサマリー台帳を表示 — dsh のコマンド API は引数を渡さないため、`full` はありません)。コマンドサービスを構成するすべてのプロファイルで動作します(web/tui インタラクティブサーフェス;`headless` ワンショットドライバーはタスクをモデルに直接送信し、コマンドを解析しない — `/compact` もそこで同じ挙動)。サブコマンド形式は処理されます:`dsh web` は `web` の後にフラグを取得し、`dsh plugin`/`--dump-default-config` は取得しません。 + +ランチャーモードマトリクス: + +| モード | ツールサーフェス | セットアップ | +|---|---|---| +| ランチャー + MCP(claude/codex のデフォルト) | ネイティブ MCP ツール | なし — `bili claude` / `bili codex` のみ | +| ランチャーワイヤーモード(claude/codex、`BILI_LAUNCHER_PLUGIN=0`) | プロキシ注入ワイヤーツール | 環境変数 1 つ | +| ランチャー `-e` / 自動プラグイン(pi、opencode;omp は組み込み) | ネイティブプラグインツール | なし | +| 手動プラグイン(`bili plugin install`) | エージェント側プラグイン | インストール実行 | +| 手動 baseURL(`/bili/` プレフィックス) | プロキシ注入ワイヤーツール | クライアント設定の編集 | + +### Direct-URL モード(オプトイン) + +`BILI_LAUNCHER_DIRECT=1` は MITM/CA 信頼を完全に削除します — claude の `ANTHROPIC_BASE_URL` / codex のプロバイダー `base_url` が `/bili/` プレフィックスを直接指します。警告: + +- **codex direct モード**:LLM トラフィックはプロキシを**通らない**ため、圧縮は適用されません — bili MCP ツール呼び出しのみが対象です。完全な圧縮にはデフォルトの MITM モードを使用してください(`BILI_LAUNCHER_DIRECT` を未設定に)。 +- **claude direct モード**:`ANTHROPIC_BASE_URL` はプロキシにオーバーライドされます;`BILI_CLAUDE_UPSTREAM=` が設定されていない限り、事前設定されたリレーはバイパスされます。OAuth サブスクリプショントラフィックにはデフォルトの MITM モードが必要です。 + +`--mitm-domain `(繰り返し可)は、自動検出が見つけたものに加えて、MITM ホワイトリストに追加のドメインを追加します — クライアントが設定ファイルではなく実行時にフェッチするホストに有用です。デフォルトポートが使用中の場合、ランチャーは自動的に空きポートを選択します;`--passthrough` / `--debug` / `--no-auto-update` はプレーンな `bili` と同じように動作します。 + +--- +## プラグインモード(ネイティブツール) + +ネイティブプラグインの体験を得るために、エージェントはプロキシと並行して小さな協調型プラグインを実行できます。プラグインは4つのACPツール(`compress` / `decompress` / `search_context` / `acp_status`)をエージェントにネイティブで登録し、エージェント自身のツールループを駆動します。一方、プロキシは圧縮の権威(状態、履歴の折りたたみ、哲学プロンプト、ナッジ)として機能し続けます。ツールのスキーマはプロキシ自体が提供するため(`GET /__bili/plugin/manifest`)、プラグインとプロキシの間に乖離が生じることはありません。プロトコル仕様: [plugin-protocol.md](plugin-protocol.md)。 + +プラグインを備えたセッションはリクエストヘッダーを介して自動的に検出され、それらに対してはワイヤーレベルのツール注入が抑制されます(二重圧縮の防止、ネイティブツールのUX)。両方のプロキシモードで動作します:`/bili/` プレフィックス付きの baseURL **および** MITM透過モード。プラグインは、エージェント自身のモデルコンテキストウィンドウ(`x-bili-plugin-context-window`)を報告し、`GET /__bili/plugin/status` を介してライブのコンテキスト使用量を読み取ることができます。逆方向のヘッダーとして `x-bili-plugin-bypass: 1` があり、これによりプロキシはパイプライン処理(セッションバインディング、注入、圧縮)の前にリクエストをそのままパススルーします。これは、圧縮がプロセス内で実行されるレガシー acp セッションのために opencode ブリッジによってスタンプされます(#920)。 + +### インストール / 削除 / 一覧表示 + +```bash +bili plugin install pi # add this billion-context install to pi's settings.json (packages) + # npm installs write the pi-managed npm: spec; dev checkouts keep the abs path +bili plugin install omp # same for omp (config.yml extensions) +bili plugin install claude # register the bili MCP server (claude mcp add, user scope) + write + # /commands/acp-cache.md (model-mediated /acp-cache) +bili plugin install codex # append [mcp_servers.bili] to ~/.codex/config.toml +bili plugin install opencode # self-spawning native plugin (+ tools) in ~/.config/opencode/opencode.json + # --with-mcp also adds the mcp.bili MCP face (no origin pin — live discovery) +bili plugin list # install status for every supported host +bili plugin remove pi # undo (original files backed up to *.bili-bak once) +``` + +`install pi` は、**レガシー** な billion-context エントリ(古い `npm:billion-context-pi` 参照、古い `npm:billion-context@x.y.z`、残った開発チェックアウトパス)を置き換え、正確に1つの bili プラグインのみがライブになるようにします。エントリを削除する場合、出力はまた、**プロジェクトスコープ** のエントリ(`pi install -l` で `/.pi/settings.json` に書き込まれるもの)がこのグローバル設定の外にあり、手動で削除する必要があることを思い出させます。npm インストールされた bili の場合、書き込まれるエントリは pi 管理の仕様 `npm:billion-context` であり、pi はこれを自動的に `~/.pi/agent/npm/` にインストールします(起動時に欠落している場合も同様)、`pi update` でアップグレードされるため、エントリはマシン間の node プレフィックス移動後も生存します。開発/チェックアウトインストールでは、マシンローカルの絶対パスが保持されます(pi はローカルパッケージディレクトリを直接ロードするため)。どちらも `pi` マニフェスト → `dist/agent/pi-native.js`、つまり自己生成型のネイティブエントリをロードします。素の `pi` では、ランチャーなしで完全なプラグインモードの圧縮が利用可能になります(#519)。 + +**スタンドアロン `billion-context-pi` 拡張との共存。** 両者は排他的です — 両方がアクティブだと二重圧縮になります。3つの安全策があります:上記のインストーラーによる除去(グローバル設定)、ネイティブエントリがロード時に同期的に設定する `BILLION_CONTEXT_NATIVE=pi` マーカー(`billion-context-pi` **0.1.72以降** はすべてのイベントでこれを再読み込みし、拒否します。0.1.71以前はネイティブプロキシが存在する前にロード時のみ `BILLION_CONTEXT_PROXY` をチェックします)、そしてランタイムスキャン:プロキシが起動すると、pi-native エントリは両方の pi 設定ファイルを読み取り、インストーラーが見逃した同居するレガシーエントリ(プロジェクトスコープ、または事後インストール)について大きく警告します。 + +インストールされたプラグインは**薄い**ものです(約5 KB、ランタイム依存ゼロ):プロキシを検出し(`/bili/` baseURL または `BILLION_CONTEXT_PROXY` から)、プロキシからツールスキーマを取得し、ネイティブツールを登録し、実行を転送します — プロキシは単一の圧縮権威であり続けるため、プラグインとプロキシは常にバージョンが一致します。プラグインAPIを持たないホスト(claude, codex)には代わりに MCP ブリッジがインストールされます — claude には `dist/claude-mcp-entry.js`(同じブリッジに加え、死んだレーンのプロキシを再生成するセッション中のプロキシウォッチドッグ、#1821)、codex にはプレーンな `dist/mcp.js` — 根本のプロトコルは同じですが、MCP にはスラッシュコマンドはありません(`/acp` パネルコマンドなし。claude はさらに、`/commands/acp-cache.md` に書き込まれるモデル仲介の `/acp-cache` マークダウンコマンドを取得します。そのプロンプトは `acp_cache` MCP ツールを駆動し — モデルはレポートをそのまま貼り付けます)。opencode は独自のプラグインAPIを持つため、そのインストールはデフォルトでネイティブプラグインツールを追加し、MCP フェースは追加しません(`--with-mcp` でオプトイン。エントリには `BILI_MCP_PROXY` ピンなし — `dist/mcp.js` は呼び出し時にインスタンスファイル経由でライブプロキシを発見するため、ネイティブプラグインのエフェメラルポート再起動後も生存、#926)。 + +キルスイッチ:`BILLION_CONTEXT_PLUGIN=0` でプラグインモードを完全に無効化します(ワイヤーレベルの注入が再開)。 + +**そもそも `plugin install` が必要なのはいつか?** ランチャーユーザーはほとんど必要ありません([ランチャーリファレンス](#launcher-reference) 参照 — pi/omp は `-e` が自動注入され、opencode は自動注入、claude/codex は MCP サーバーが自動注入、dsh は `--patch` 経由でネイティブの `/acp` と `/acp-cache` コマンドを取得、hermes はワイヤーのみ)。これは、ネイティブパネルを望む手動設定クライアント(`/bili/` プレフィックスまたは MITM)のためのものです:pi/omp/opencode はネイティブツール + `/acp` と `/acp-cache` を取得(pi/omp はさらに `/acp-rule` を取得。omp ではフォークが拡張ツールをモデルから隠すため、プラグインの価値はこれらのコマンドにあります);claude/codex はネイティブ MCP ツールを取得(`/acp` なし。claude はモデル仲介の `/acp-cache` マークダウンコマンドを取得);dsh はランチャーの `--patch` 経由で `/acp` と `/acp-cache` を取得(手動設定の dsh は同じパッチを自分で追加可能);hermes は不可(ワイヤーのみ)。プラグインがなくてもすべて動作します — 圧縮はワイヤー注入ツール経由で実行され、モデルに `acp_status` を呼び出してライブ使用量を確認するように依頼できます。 + +### 他の圧縮プラグインの検出 (#1206) + +1つの会話に2つの圧縮器があると二重圧縮となりメッセージ参照が破損するため、bili は自身と同居する他の圧縮器を能動的に探します: + +- **スキャン**(読み取り専用、ベストエフォート、5分キャッシュ):opencode グローバル + プロジェクト設定の `plugin` 配列;pi グローバル + プロジェクト `.pi/settings.json` の `packages`;omp `config.yml` の `extensions`;claude 設定の `enabledPlugins`/`plugins` キー + `~/.claude/plugins/` ディレクトリ;kimi `plugins/installed.json`;hermes `~/.hermes/plugins/` ディレクトリ;dsh プロファイル `package.json` の依存関係。2つの階層:**既知の競合**(`opencode-acp`、レガシー `billion-context-pi`、および dsh の `dsh-live-compact`(#5984) — 決定的)と**キーワードによる疑い**エントリ(compress* / compact* / acp / summar* に一致する名前。素の `context` は意図的に一致しません — それはドメインの名前であり、圧縮という行為の名前ではないため、`context7`/`dsh-context` のような読み取り専用ツールはフラグを立てません);圧縮を行わないことが確認されたプラグインは、正確なパッケージ名によって完全に免除されます — 読み取り専用/表示専用ツール(例:`pi-compact-transcript`、`pi-context-inspector`)や、名前がキーワードと単に衝突するプロトコルアダプター(`@openma/deepseek-harness-acp`:その `acp` は Agent Client Protocol を意味し、acp-kernel エコシステムのマーカーではない;#2969) — 類似した名前は依然としてフラグを立てます。dsh の `dsh-live-compact` はキーワードによる疑いではなく既知の競合です:それは競合するコンパクト化エンジンであり、同梱の `cordis.patch.yml` は標準の `compaction-basic` 行を無効にし、独自のエンジン行を登録し、そのプリセット引き継ぎはプリセットのコンパクト化行を自分自身に名前変更するため、bili のロード時コンパクト化無効オーバーレイ(#3354)は標準行名のみを認識するため構造的にそれに対して盲目であり、そのチェックポイントは bili の知識の外に配置されます(#5984)。 +- **検出結果が表示される場所:** クライアント起動前のランチャー stderr;各セッションの最初のリクエスト時のプロキシ警告ログ(クライアントは `x-bili-plugin` ヘッダーまたはワイヤーヘッダーから識別);およびセッションの競合台帳 — `acp_status` の `COMPRESSION CONFLICTS` セクション、`GET /__bili/stats` → `conflicts`、Web UI バナー。 +- **ランタイム証拠、表示用に階層化 (#2545):** 通告のない履歴書き換え(#1001)と孤立 GC による無効化(要約された内容がクライアントの履歴から削除される)は、*疑わしい* 共存として同じ台帳に記録されます。重大度は証拠階層によって等級付けされます:**確認済み** = 検出されたクライアントネイティブコンパクト化の着地(bili はそれに基づいてリベース、#2372/#2432)または疑わしくないプラグイン検出 — これのみが「1つの圧縮器を残す」という命令形警告をトリガーします;**未確認シグナル** = 通告のない書き換え + 孤立 GC による無効化 — 原因が特定されていない観察された変更(「履歴が変更された、原因不明」)、ネイティブ自動コンパクト化や第2の圧縮器として提示されることは決してありません;名前だけの [suspected] マッチはソフトな「まず確認」階層(#1736)にとどまり、純粋な [suspected] 台帳は確認前アドバイスのみを受け取ります — 何も確認されていない間、クライアントごとの命令形修正フッター(「自動コンパクト化を無効化 / 新しいセッションを開始」)はありません(#2969)。検証済み非圧縮プラグイン(読み取り専用ビューア、または #2969 の ACP アダプターのようなプロトコルアダプター)を名指しする標準台帳レコードは、アラームとして永続化するのではなく、表示時に中和されます。また、未確認シグナルのセッション間集計数は、同じ会話での二重圧縮の主張にエスカレートすることは決してありません。 +- **dsh の `auto: false` は自動トリガーのみを無効にします。** プロファイルバンドルパッチ(`dsh.bundle.patch.yml`)によってインストールされる `compaction-basic: { auto: false }` 行は、圧力/オーバーフロー自動コンパクト化をスキップします — 手動 `/compact`(およびアイドルセッションのコンパクト化)は依然として発火します。bili 経由でルーティングされた呼び出しはサーバーサイドガードによって拒否されます(#1729/#2360);bili を経由せずにプロバイダーに到達する呼び出し(プラグインの引き継ぎゲートが帰属させないデスクトップレーンパス)は着地し、bili は次のリプレイでそれらを検出します — チェックポイントフレーミング + 間引かれた折りたたみカバレッジ — 永遠に後続のすべての compress が失敗するのではなく、1ターンで圧縮状態をリベースします(#2432)。dsh のコンパクト化を**完全に**オフにすること(手動 `/compact` を含む)が目的である場合、デルタは `auto: false` ではなく、同じ行に `disabled: true` として属します(以下のレシピ)。 + + #### Web プロファイルで dsh ネイティブ自動コンパクト化を OFF にする (#1772/#3354, #3354以降は自動;#2474 レシピはフォールバック) + + **#3354以降は自動。** `@deepseek-ai/dsh-web-app` をバンドルするプロファイルでは、実行中の compaction-basic インスタンスはエージェントプリセット(`preset-standard.config.plugins`)内に存在し、パッチレイヤーはネストされた行を id でアドレス指定できません(#1772) — バンドルされた `- id: compaction-basic` 行は web-app のすでに無効化されたホストプレーン行に配置され、何も変更しません。bili は現在、LOAD TIME にそのギャップを閉じます:常時オンバンドルエントリ `bili-compaction-gate` — `bili-native` の横にある別の cordis エントリで、同じパッチレイヤーによってマウントされるため、`bili-native` が無効化またはキルスイッチされた後も生存します(#3662) — これは cordis `internal/config` オーバーレイを登録します([deshark42/dsh-compaction-basic-disable](https://github.com/deshark42/dsh-compaction-basic-disable) からベンダー、MIT)が、bili がレーンを所有している間、プリセットの `compaction-basic` と `command-compact` 行を `disabled: true` にマークし、`dsh.bundle.patch.yml` / ランチャーオーバーレイのプリセットゲート行は、各 Web プリセットがそのオーバーレイのサービスを待ってから登録できるようにします。これらのプロファイルでは、ユーザーアクションなしでネイティブ自動コンパクト化がオフになります;ACP 圧縮には影響しません。 + + オーバーレイは INTERNAL dsh フックに乗り、バージョンに敏感です。新しい/古い dsh ビルドで dsh コンパクト化チェックポイントが着地しているのがまだ見える場合、以下のフォールバックを使用してください。 + + **無効化と削除 (#3662)。** `bili-native` の無効化(dsh プラグインマネージャーまたはパッチレイヤーの `disabled: true`)は、セッション作成を壊れなくなります:ゲートサービスは別の常時オン `bili-compaction-gate` エントリで生存するため、プリセットは永遠に保留になるのではなく、STOCK ネイティブコンパクト化にフォールバックします — 圧縮オフ、dsh は完全に使用可能。`bili-compaction-gate` 自体を無効化しないでください(それは壊れを再作成します);完全にアンインストールするには、プロファイルの `dsh.profile.bundles` から `billion-context` を削除し、再起動してください。#3662以前のインストールで壊れたものはアップグレード時に自己修復します;手動では、`$DSH_HOME/cordis.patch.yml`(ホームレイヤー;デフォルト `~/.dsh/cordis.patch.yml`)に `- id: preset-standard` / `preset-ptc` / `preset-minimal` / `preset-cordis` をそれぞれ `inject: null` 付きで追加します — トップレベルキーは完全に置き換えられ、保留ラッチがクリアされます。 + + **フォールバックレシピ (#2474)**(dsh `0.2.1-alpha.1`、Windows 11、`@deepseek-ai/dsh-web-app` を含むプロファイルバンドルで検証済み)。プロファイルレイヤーパッチでオフにできます — プリセットはバンドルレイヤーによって挿入される通常のトップレベル行であり、プロファイルパッチレイヤーはその後で適用されます。機能しないのはネストされた行を id でアドレス指定することです;機能するのはプリセット行の `config` を完全にオーバーライドすることです。 + +```bash +# 1. Dump the composed profile and copy preset-standard's COMPLETE config block. +dsh --profile --dump-config > /tmp/profile.yml +``` + +2. `$DSH_HOME/profiles//cordis.patch.yml` に `preset-standard` 行を追加し、その**完全な** `config` を含みます — すべての `plugins` エントリをバイト単位で — `compaction` グループ内で正確に1つの変更を行います。2つのバリアント: + + - **強(推奨、#3235):コンポーネントを無効にする** — ネストされた `compaction-basic` 行に `disabled: true` を設定します。これは dsh 自体がホストプレーンで使用するのと同じメカニズムです;プラグインは完全にオフになります(运行状態 はもはや 运行中 ではないため)、圧力トリガーも手動トリガーもそこから発火できません。 + - **弱:ロードしたまま自動トリガーを止める** — 代わりに行の下に `config: { auto: false }` を追加します。自動圧力コンパクト化はオフですが、手動 `/compact` とツール結果プルーナーはオンに残り、コンポーネントは依然として実行されます。 + +```yaml +- id: preset-standard + name: '@deepseek-ai/dsh-agent-preset' + config: + id: standard + order: 1 + plugins: + # … every entry from the dump, unchanged … + - id: compaction + name: cordis:group + group: true + isolate: + compaction: true + toolResultPruner: true + config: + - id: compaction-basic + name: '@deepseek-ai/dsh-compaction-basic' + disabled: true # ← strong variant: the only delta + # config: { auto: false } # ← weak variant instead, if you prefer + - id: command-compact + name: '@deepseek-ai/dsh-command-compact' + - id: tool-result-pruner + name: '@deepseek-ai/dsh-compaction-tool-result-pruner' + config: + thresholdChars: 8192 + headChars: 4096 + tailChars: 1024 + # … every remaining entry, unchanged … +``` + +3. 頼る前に確認:`dsh --profile --dump-config | grep -A2 'id: compaction-basic'` — `preset-standard` のエントリ数は**不変**でなければならず、ネストされた行は現在 `disabled: true`(または `config.auto: false`)を保持していなければなりません。 + +自動圧力/オーバーフローコンパクト化はオフになります(強バリアントではコンポーネント全体が);弱バリアントでは手動 `/compact` とツール結果プルーナーはオンに残ります。**`preset-ptc` と `preset-cordis` にも同じ形状を繰り返す** — セッションモードの切り替えはプリセットを再解決し、そこに有効のまま残されたコンパクト化行は、`preset-standard` がパッチされた後でもネイティブコンパクト化を復活させます(`preset-minimal` は `compaction` グループを同梱しません)。 + +**これを誤る3つの方法 — すべてサイレント**(同じダンプに対して測定): + +| パッチ形式 | 結果 | +|---|---| +| `- id: preset-standard.compaction.compaction-basic` | `patch: entry "…" not found`;**効果なし** | +| `- id: preset-standard` + 部分的な `config.plugins` | `config` は**マージではなく置き換え** — プリセットは書き込んだエントリのみ(測定例では 35 → 3)に収束:ペルソナなし、ツールなし | +| `id: preset-standard` 付きの `- insert:` | ツリーの末尾に**2番目の** `preset-standard` 行を追加;ライブプリセットは無傷 | +| 完全な `config` スナップショット + 1つの `disabled: true` | ✅ エントリ数不変、唯一のデルタは `disabled: true` | + +**スナップショットはコピーした dsh バージョンで凍結されます。** バンドルレイヤーパッチとは異なり、プロファイルレイヤーの `config` は時点のコピーです:dsh アップグレードが同梱プリセット内の行を追加、削除、または再構成した後、このオーバーライドは古い名簿を提供し続けます — 新しいプラグインはサイレントにロードされません。ステップ1を再実行し、パッチ内のものに対して新しい `preset-standard` ブロックを差分比較し、そのセクションが変更されるたびに全体を再コピーしてください。スナップショットをメンテナンスしたくない場合は、ネイティブ自動コンパクト化をオンにし、代わりに #1729/#2432 リベースパスが相互作用を処理させることをお勧めします。 + +部分的なオーバーライドは診断なしで失敗するため、編集後は常に再ダンプしてエントリ数を比較してください。 +- opencode ランチャー/ネイティブモード下では、存在する `opencode-acp` は設計上情報提供のみです(#920 がレガシーセッションのためにそれを吸収);他の場所では警告します。 +- 無効化:`BILI_CONFLICT_SCAN=0`。 + +--- +## セッションとマイグレーション + +### 圧縮状態はプロキシ側に存在する (#151) + +圧縮状態(ブロック、サマリー、元のメッセージキャッシュ)はクライアント側ではなく**プロキシ側**に存在します。クライアント自身のローカル履歴は、圧縮されていない完全なビューです。これには2つの帰結があります。 + +- クライアントを元のアップストリーム(またはプロキシ停止時)に向き直すと、クライアントは各ターンごとに**完全なローカル履歴**をリプレイします。長い圧縮セッションの後、これはモデルのコンテキストウィンドウ(`context_window_exceeded`)を超える可能性があります。 +- 圧縮ブロックをクライアントのローカル履歴に「展開」する方法はありません。クライアントは圧縮された形式を見たことがないためです。 + +### 起動時のストレージライフサイクル (#401) + +プロキシはセッションストレージを**単一の**ディレクトリ走査とパース(ロードと、一度限りの #286 アイデンティティマイグレーションが同じパース済みマップ上で実行される)で起動します。セッションは永続的に保持されます。設計目標は、1年間の会話も失われないようにすることであり、そのため保持期間やサイズ予算によるプルーニング(削除)はありません。#286 マイグレーションは最初のパス後に `.bili-migration-286.done` マーカーを書き込むため、後の起動時に再スキャンや再ログ出力を行うことはありません。 + +### プロキシからの移行 + +セッションをエクスポートし、新しい会話に貼り付けて引き継ぎを行います。 + +```bash +bili export # list persisted sessions (id, label, blocks) +bili export # print a Markdown handoff (block summaries) +bili export --full # include the original messages per block +bili export --jsonl # line-delimited JSON dump (tables-first) +bili export --full --output handoff.md +``` + +その後、クライアントで新しい会話を開始し(アップストリーム直接接続)、引き継ぎドキュメントを冒頭のコンテキストとして貼り付けます。 + +### Codex サブエージェントは独自の圧縮名前空間を持つ (#150) + +Codex サブエージェント(例: `guardian_subagent` 承認レビュアー)はメイン会話の `session_id` を再利用するため、ワイヤー上では同じセッションのように見えます。注意を払わない場合、それらのリクエストはメイン会話の圧縮状態を継承してしまいます。これにより、サブエージェントのターンがコンテキストを折り畳まれ(読み戻す必要がある逐語的なユーザー承認を失う)、2つのロールの使用量推定が互いを汚染する可能性があります。 + +billion-context は `instructions` フィールドを通じてこれを検出します。サブエージェントのリクエストは独自のロールプロンプトを保持しています。**最初**に確認された instructions がメイン名前空間をアンカーします(メインプロンプトがドリフトしても安定)。それ以外の instructions 値は、独自の空の圧縮状態を持つ別の `|sub:` 名前空間にマッピングされます。サブエージェントのリクエストは自己完結型のリプレイであるため、新しい名前空間はロスレスです。また、Web UI のセッションリストでは、2つの名前空間が同じクライアントラベルを共有する別々のセッションとして表示されます。 + +このアンカーは Codex や Claude Code に固有のものではありませんが、分割は意図的なものであり、自動的ではありません。これは、トラフィックが複数のペルソナ間で1つの会話 ID を再利用していることが確認されたクライアントに適用されます(それぞれが同じ ID の下で独自のシステムプロンプトを送信する)。現在、これは Codex、Claude Code、DeepSeek Harness です。その他のすべてのクライアントにおいて、会話中のシステムプロンプトの変更は「同じ会話、進化したプロンプト」を意味し、メイン名前空間にとどまります。具体的な非 Claude の例としては、`@deepseek-ai/dsh-experimental-auto-review` を有効化した DeepSeek Harness があります。レビュアーは、各保留中のツール呼び出しの前に、独自の小さな固定システムプロンプト(約 1 KB。4つの `ENVIRONMENT` / `PROJECT_INSTRUCTIONS` / `FILTERED_HISTORY` / `PENDING_ACTION` セクションはそのユーザーターンに載る)の下で発火するため、その行はメイン会話の横に表示され、実行中としてもマークされます。 + +コードを読むことなく、そのようなレーンを区別するための4つの読み取り方法があります。 + +| 読み取り項目 | メイン会話 | レビュー / サブエージェントレーン | +| --- | --- | --- | +| システムプロンプト | 完全なプロンプト(数十 KB) | 非常に小さい(約 1 KB) | +| 圧縮回数 | 時間とともに増加 | 0 | +| リクエスト数 | ターンごとに約1回 | ツール呼び出しごとに約1回 | +| キャッシュヒット率 | 変動 | ≈99.9%(安定したプレフィックス、変更されるのは保留中のアクションのみ) | + +### Windows: セッションディレクトリをアンチウイルスから除外する (#362) + +billion-context は、セッションディレクトリ(デフォルトでは `%USERPROFILE%\.local\share\billion-context\`)の下にセッションごとに1つの JSON ファイルとして各セッションの圧縮状態を永続化し、長いセッションの各ターンでそのファイルを再書き込みします。Windows では、リアルタイムアンチウイルス(Windows Defender)、検索インデクサー、または同期ツール(OneDrive)が、書き込み中にそのディレクトリをロックする可能性があります。ロックが複数の書き込み間にわたって保持されると、リネームが `EPERM` で失敗し、ロックが解除されるまでそのセッションのすべての永続化が失敗します。 + +同じ環境の障害は、統合ストレージインデックス自体を開くことを拒否することもあります。SQLite が `%USERPROFILE%\.local\share\billion-context\sessions\index.db` を開けない場合(`unable to open database file` / SQLITE_CANTOPEN, #3823)、ストレージはレガシー専用モードにデグレードし、デグレード警告と診断ブロックはこの除外を最初の疑いとして特定します(他の2つは OneDrive のプレースホルダーファイルと 260 文字を超えるパスです)。 + +同じセッションが N 回連続で書き込み失敗した場合(デフォルトは `5`、`BILI_PERSIST_EPERM_ALERT_THRESHOLD` で調整可能)、プロキシは除外すべき正確なディレクトリを特定した**一度限りの、対応可能なアラート**をログに記録します。これは繰り返されません(`BILI_PERSIST_EPERM_ALERT_REPEAT_MS > 0` を設定すると、障害が続いている間、最大で M 分ごとに再アラートが発行されます)。 + +根本的に障害を止めるには、セッションディレクトリをアンチウイルスの除外リストに追加し、同期フォルダの外に保ってください。 + +1. **Windows Defender の除外設定:** 設定 → プライバシーとセキュリティ → Windows セキュリティ → ウィルスと脅威の保護 → 設定の管理 → **除外** → **除外の追加** → *フォルダー* → `%USERPROFILE%\.local\share\billion-context\` を選択。 +2. **このディレクトリを同期しない。** OneDrive(または Dropbox / Google Drive / 類似サービス)が `%USERPROFILE%\.local\share\billion-context\` を同期していないことを確認してください。同期フォルダの下にある場合は、`BILI_SESSIONS_DIR` を使用して非同期パスに移動してください。 + +それ以外の場合、高頻度の永続化書き込みは各ターンでリアルタイムスキャンを再トリガーします。これが `EPERM` 書き込み失敗の原因です。ディレクトリが除外されると、アラートは停止します。 + +### Windows: Node ランタイムが Low とラベル付けされている(NTFS 必須整合性) (#5154) + +上記すべては*ファイル*が問題であると仮定しています。#5154 では逆の形状が見つかりました。**Node ランタイム自体**(`node.exe`)が **Low 必須整合性ラベル**を保持しており、プロセスが Low 整合性であったため、*Medium ラベルのファイルへのすべての書き込み* — CA バンドルの再構築、`index.db`、セッションエンベロープ — が `EPERM` で失敗し、すべての ACL チェックは合格していました。ラベルは通常**継承**によって到着します。一度 `Low (OI)(CI)` とラベル付けされた親ディレクトリ(例えば、誤って実行された `icacls

/setintegritylevel "(OI)(CI)Low" /T` によって)は、その中に配置されたすべてのファイルに Low ラベルを刻み込み、再起動後も残ります。これは、原因が見えない「クラッシュループ」の起動クラスの背後にあるメカニズムです(#5096)。 + +bili は起動時に自身のランタイムのラベルを一度プローブし(`process.execPath` に対する `icacls`)、Low/Untrusted を検出すると大きな `[integrity]` 警告をログに記録します。これはブロッキングではなく、プロキシは実行を続けます。 + +手動で確認および修正するには(管理者権限で実行;**絶対パス**を使用してください — 一部の PowerShell/cmd プロファイルでは `icacls` の PATH 解決が失敗します): + +```bat +:: look for a "Mandatory Label\Low Mandatory Level" line (no Mandatory Label line = no label = fine) +C:\Windows\System32\icacls.exe "C:\Program Files\nodejs\node.exe" + +:: restore the runtime to Medium (this is the fix; verify with the command above) +C:\Windows\System32\icacls.exe "C:\Program Files\nodejs\node.exe" /setintegritylevel Medium +``` + +ラベルに `(I)`(継承)マーカーが表示される場合、**親ディレクトリ**がソースです:ディレクトリの**ルートのみを、非再帰的に**修正してください — `icacls "" /setintegritylevel Medium` を**`/T` なし**で実行します。新規および再作成された子要素はその後「(ラベルなし)」を継承し、収束します。`/T` を使用すると、何の意味もないのに数千のファイルに触れてしまいます。不明な場合は、まず `icacls "" /save acl.txt` で現在の ACL をバックアップしてください。 + +billion-context データディレクトリを Low に再ラベル付けしてこれを「修正する」ことは**しないでください** — その方向は状況を悪化させます(#3823 と #5154 を比較してください:Low プロセスのみが書き込めるファイル、どこにも整合性の天井がある)。 diff --git a/docs/configuration.md b/docs/configuration.md index 16cd5ca097..daefdcefec 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -1,6 +1,6 @@ # billion-context Configuration Reference -[English](configuration.md) | [中文](configuration.zh-CN.md) +[English](configuration.md) | [中文](configuration.zh-CN.md) | [日本語](configuration.ja.md) `billion-context` is an HTTP proxy that injects [ACP](https://github.com/ranxianglei/acp-kernel) (Active Context Pruning) context compression into LLM API streams. Every option below lives in a single JSON config file (or an equivalent environment variable / CLI flag). diff --git a/docs/configuration.zh-CN.md b/docs/configuration.zh-CN.md index 81c06cea33..4da27b69a8 100644 --- a/docs/configuration.zh-CN.md +++ b/docs/configuration.zh-CN.md @@ -1,6 +1,6 @@ # billion-context 配置参考 -[English](configuration.md) | [中文](configuration.zh-CN.md) +[中文](configuration.zh-CN.md) | [English](configuration.md) | [日本語](configuration.ja.md) `billion-context` 是一个 HTTP 代理,用于将 [ACP](https://github.com/ranxianglei/acp-kernel)(Active Context Pruning,主动上下文剪枝)的上下文压缩注入到 LLM API 流中。下文所有选项都位于同一个 JSON 配置文件中(也可通过等价的环境变量 / CLI 参数设置)。 diff --git a/tools/check-architecture-docs.mjs b/tools/check-architecture-docs.mjs index 06d716b986..844e52520a 100644 --- a/tools/check-architecture-docs.mjs +++ b/tools/check-architecture-docs.mjs @@ -77,7 +77,7 @@ if (JSON.stringify(ledgerSlugs) !== JSON.stringify(zhSlugs)) fail('hub ledger mi const pageDir = join(hubDir, 'architecture'); const pageFiles = existsSync(pageDir) ? readdirSync(pageDir).filter((f) => f.endsWith('.md')) : []; -const pageSlugs = new Set(pageFiles.map((f) => f.replace(/\.zh-CN\.md$/, '').replace(/\.md$/, ''))); +const pageSlugs = new Set(pageFiles.map((f) => f.replace(/\.zh-CN\.md$/, '').replace(/\.ja\.md$/, '').replace(/\.md$/, ''))); for (const slug of activeSlugs) { for (const f of [`architecture/${slug}.md`, `architecture/${slug}.zh-CN.md`]) { if (!existsSync(join(hubDir, f))) fail(`ledger says ${slug} is active but docs/${f} is missing`); @@ -86,6 +86,24 @@ for (const slug of activeSlugs) { for (const slug of pageSlugs) { if (!ledgerSlugs.includes(slug)) fail(`orphan module page (not in hub ledger): docs/architecture/${slug}.md`); } +// ja pages are optional until the hub exists; once docs/architecture.ja.md is in the tree the ja set +// must be complete and locked to the EN ledger (ja mirrors EN, reuses the EN diagrams). +const hubJaPath = join(hubDir, 'architecture.ja.md'); +if (existsSync(hubJaPath)) { + const hubJa = readFileSync(hubJaPath, 'utf8'); + const jaSlugs = [...hubJa.matchAll(/^\|\s*`([a-z-]+)`\s*\|/gm)].map((m) => m[1]); + if (JSON.stringify(ledgerSlugs) !== JSON.stringify(jaSlugs)) fail('hub ledger mismatch between architecture.md and architecture.ja.md'); + for (const ext of ['svg', 'png']) { + const link = `./architecture/assets/architecture-current.en.${ext}`; // ja hub reuses the EN diagram + if (!hubJa.includes(`](${link})`)) fail(`docs/architecture.ja.md does not link ${link}`); + } + for (const slug of activeSlugs) { + if (!existsSync(join(pageDir, `${slug}.ja.md`))) fail(`ledger says ${slug} is active but docs/architecture/${slug}.ja.md is missing (ja hub exists, ja set must be complete)`); + } + for (const slug of pageSlugs) { + if (existsSync(join(pageDir, `${slug}.ja.md`)) && !ledgerSlugs.includes(slug)) fail(`orphan ja module page (not in hub ledger): docs/architecture/${slug}.ja.md`); + } +} if (!process.exitCode) ok(`ledger: ${ledgerSlugs.length} modules, ${activeSlugs.length} active, page set matches`); // ---------- 3+4. each active page: diagram references present, SVGs well-formed ---------- @@ -110,6 +128,15 @@ for (const slug of activeSlugs) { } if (!existsSync(join(pageDir, png.slice(2)))) fail(`missing bitmap fallback: docs/${png}`); } + // ja module pages reuse the EN diagram (svg + png), same as the ja hub + const pageJa = join(pageDir, `${slug}.ja.md`); + if (existsSync(pageJa)) { + const jaPage = readFileSync(pageJa, 'utf8'); + const svgJa = `./assets/${slug}.en.svg`; + const pngJa = svgJa.replace(/\.svg$/, '.png'); + if (!jaPage.includes(`](${svgJa})`)) fail(`docs/architecture/${slug}.ja.md does not link ${svgJa}`); + if (!jaPage.includes(`](${pngJa})`)) fail(`docs/architecture/${slug}.ja.md does not link the ${pngJa} fallback`); + } } if (!process.exitCode) ok('diagram references + SVG well-formedness pass'); console.log(process.exitCode ? 'architecture-docs guard: FAILED' : 'architecture-docs guard: all green'); diff --git a/tools/gen-config-docs.mjs b/tools/gen-config-docs.mjs index f19a20e5a7..d629a4c997 100644 --- a/tools/gen-config-docs.mjs +++ b/tools/gen-config-docs.mjs @@ -12,6 +12,7 @@ const ROOT = join(dirname(fileURLToPath(import.meta.url)), ".."); const SEED_DIR = join(ROOT, "website", "config-reference"); const MD_EN = join(ROOT, "docs/configuration.md"); const MD_ZH = join(ROOT, "docs/configuration.zh-CN.md"); +const MD_JA = join(ROOT, "docs/configuration.ja.md"); const MAIN_JS = join(ROOT, "website", "main.js"); const DOCS_HTML = join(ROOT, "website", "docs", "index.html"); const HOME_HTML = join(ROOT, "website", "index.html"); @@ -23,16 +24,16 @@ const JOPEN = (id) => "/* bili:gen " + id + " */"; const JCLOSE = "/* /bili:gen */"; const GROUPS = [ - ["core", "Server & core", "服务与核心"], - ["upstream", "Upstream & billing", "上游与计费"], - ["behavior", "Behavior toggles", "行为开关"], - ["mitm", "MITM lane", "MITM 通道"], - ["process", "Process & persistence", "进程级配置块"], - ["updates", "Updates & advisories", "更新与公告"], - ["diagnostics", "Diagnostics & tuning", "诊断与调优"], - ["compress", "Compression (global level)", "压缩(全局层级)"], - ["providers", "Provider route fields", "路由表字段"], - ["envonly", "Environment-only variables", "仅环境变量(无配置文件键)"], + ["core", "Server & core", "服务与核心", "サーバー & コア"], + ["upstream", "Upstream & billing", "上游与计费", "アップストリーム & 課金"], + ["behavior", "Behavior toggles", "行为开关", "挙動トグル"], + ["mitm", "MITM lane", "MITM 通道", "MITM レーン"], + ["process", "Process & persistence", "进程级配置块", "プロセス & 永続化"], + ["updates", "Updates & advisories", "更新与公告", "更新 & アドバイズリー"], + ["diagnostics", "Diagnostics & tuning", "诊断与调优", "診断 & チューニング"], + ["compress", "Compression (global level)", "压缩(全局层级)", "圧縮(グローバルレベル)"], + ["providers", "Provider route fields", "路由表字段", "プロバイダールートフィールド"], + ["envonly", "Environment-only variables", "仅环境变量(无配置文件键)", "環境変数のみ(設定ファイルキーなし)"], ]; const SITE_GROUPS = [ @@ -110,7 +111,7 @@ function parseSeed(text, file) { function validate(entries, file, idMap) { for (const e of entries) { const ctx = file + ":" + e.key; - for (const f of ["type", "default", "group", "desc_en", "desc_zh"]) { + for (const f of ["type", "default", "group", "desc_en", "desc_zh", "desc_ja"]) { if (typeof e[f] !== "string" || e[f] === "") fail(ctx + ": missing or empty field " + f); } if (!GROUPS.some((g) => g[0] === e.group)) fail(ctx + ': unknown group "' + e.group + '"'); @@ -161,23 +162,28 @@ function replaceBlock(text, id, body, open, close) { function genParamRef(entries, lang) { const out = []; - out.push( - lang === "zh" - ? "以下索引由 `website/config-reference/*.yaml` 生成——改种子后运行 `node tools/gen-config-docs.mjs generate`,不要手改本区块。" - : "This index is generated from `website/config-reference/*.yaml` — edit the seed, then run `node tools/gen-config-docs.mjs generate`; do not hand-edit this block." - ); + if (lang === "zh") { + out.push("以下索引由 `website/config-reference/*.yaml` 生成——改种子后运行 `node tools/gen-config-docs.mjs generate`,不要手改本区块。"); + } else if (lang === "ja") { + out.push("以下インデックスは `website/config-reference/*.yaml` から生成 — シードを編集してから `node tools/gen-config-docs.mjs generate` を実行;このブロックを手で編集しないこと。"); + } else { + out.push("This index is generated from `website/config-reference/*.yaml` — edit the seed, then run `node tools/gen-config-docs.mjs generate`; do not hand-edit this block."); + } out.push(""); - for (const [gid, enL, zhL] of GROUPS) { + for (const [gid, enL, zhL, jaL] of GROUPS) { const rows = entries.filter((e) => e.group === gid); if (!rows.length) continue; - out.push("**" + (lang === "zh" ? zhL : enL) + "**"); + out.push("**" + (lang === "zh" ? zhL : lang === "ja" ? jaL : enL) + "**"); out.push(""); - out.push("| Key | Type | Default | Env | Description |"); + if (lang === "ja") out.push("| キー | 型 | デフォルト | 環境変数 | 説明 |"); + else out.push("| Key | Type | Default | Env | Description |"); out.push("|-----|------|---------|-----|-------------|"); for (const e of rows) { - const dep = e.deprecated === true ? (lang === "zh" ? " _(已弃用)_" : " _(deprecated)_") : ""; + const dep = e.deprecated === true + ? (lang === "zh" ? " _(已弃用)_" : lang === "ja" ? " _(非推奨)_" : " _(deprecated)_") + : ""; const envCol = e.kind === "env-only" ? "—" : e.env && e.env.length ? e.env.join(", ") : "—"; - const desc = lang === "zh" ? e.desc_zh : e.desc_en; + const desc = lang === "zh" ? e.desc_zh : lang === "ja" ? e.desc_ja : e.desc_en; const def = lang === "zh" && typeof e.default_zh === "string" ? e.default_zh : e.default; out.push("| `" + e.key + "` | " + mdCell(e.type) + " | " + mdCell(def) + " | " + mdCell(envCol) + " | " + mdCell(desc) + dep + " |"); } @@ -194,7 +200,9 @@ function genEnvMap(entries, lang) { } rows.sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : a[1] < b[1] ? -1 : 1)); const out = []; - out.push(lang === "zh" ? "| 环境变量 | 配置文件键 | 默认值 |" : "| Env var | Config key | Default |"); + if (lang === "zh") out.push("| 环境变量 | 配置文件键 | 默认值 |"); + else if (lang === "ja") out.push("| 環境変数 | 設定ファイルキー | デフォルト |"); + else out.push("| Env var | Config key | Default |"); out.push("|---------|------------|--------|"); for (const [n, k, d] of rows) out.push("| `" + n + "` | `" + k + "` | " + mdCell(d) + " |"); return out.join("\n"); @@ -262,6 +270,11 @@ function writeBlocks(entries) { mdZh = replaceBlock(mdZh, "env-map", genEnvMap(entries, "zh"), OPEN("env-map"), CLOSE); writeFileSync(MD_ZH, mdZh); + let mdJa = readFileSync(MD_JA, "utf8"); + mdJa = replaceBlock(mdJa, "param-ref", genParamRef(entries, "ja"), OPEN("param-ref"), CLOSE); + mdJa = replaceBlock(mdJa, "env-map", genEnvMap(entries, "ja"), OPEN("env-map"), CLOSE); + writeFileSync(MD_JA, mdJa); + let js = readFileSync(MAIN_JS, "utf8"); js = replaceBlock(js, "site-dict-en", genSiteDict(entries, "en"), JOPEN("site-dict-en"), JCLOSE); js = replaceBlock(js, "site-dict-zh", genSiteDict(entries, "zh"), JOPEN("site-dict-zh"), JCLOSE); @@ -274,7 +287,7 @@ function writeBlocks(entries) { h = replaceBlock(h, "top-list", genTopList(entries, "en"), OPEN("top-list"), CLOSE); writeFileSync(DOCS_HTML, h); - console.log("[gen-config-docs] wrote 10 blocks from " + entries.length + " seed entries"); + console.log("[gen-config-docs] wrote 12 blocks from " + entries.length + " seed entries"); } function dictKeys(slice) { diff --git a/website/config-reference/compress.yaml b/website/config-reference/compress.yaml index 668cbfbd07..700ac82737 100644 --- a/website/config-reference/compress.yaml +++ b/website/config-reference/compress.yaml @@ -10,6 +10,7 @@ entries: render: compress-row desc_en: "Effective context window (tokens or N%): denominator of the usage ratio and a hard preflight wall; highest-priority window source." desc_zh: "有效上下文窗口(token 数或 N%):使用率的分母,也是硬性 preflight 墙;窗口来源中优先级最高。" + desc_ja: "有効コンテキストウィンドウ(トークン数または N%):使用率の分母であり、事前チェックのハードウォール。最優先のウィンドウソース。" site_en: "Effective context window (tokens or \"N%\"): denominator of the usage ratio and a hard preflight wall. Highest-priority window source — overrides per-route / per-model declarations plus the top-level default." site_zh: "有效上下文窗口(token 数或 \"N%\"):使用率的分母,也是硬性 preflight 墙。窗口来源中优先级最高——覆盖路由/模型声明与顶层默认值。" - key: compress.maxContextLimit @@ -20,6 +21,7 @@ entries: render: compress-row desc_en: "Forced-compression nudge threshold: once history passes this share of the window the nudge fires immediately, bypassing growth gates. Not a hard cap." desc_zh: "强制压缩提醒阈值:历史超过窗口该占比时提醒立即触发,绕过增长门槛。不是硬上限。" + desc_ja: "強制圧縮のナッジ閾値:履歴がこのウィンドウの割合を超えると、ナッジが即座に発火し、成長ゲートをバイパスする。ハードキャップではない。" site_en: "Forced-compression nudge threshold (default \"75%\"): once history passes this share of the window the nudge fires immediately, bypassing the growth gates. Not a hard cap." site_zh: "强制压缩提醒阈值(默认 \"75%\"):历史超过窗口的该占比时提醒立即触发,绕过增长门槛。不是硬上限。" - key: compress.emergencyThresholdPercent @@ -30,6 +32,7 @@ entries: render: compress-row desc_en: "Emergency truncation of oversized tool outputs when history passes this share of the window (must be >= maxContextLimit)." desc_zh: "历史超过窗口该占比时对超大工具输出做紧急截断(必须 >= maxContextLimit)。" + desc_ja: "履歴がこのウィンドウの割合を超えた場合の、過大ツール出力の緊急切り詰め(maxContextLimit 以上である必要がある)。" site_en: "Default \"95%\": emergency truncation of oversized tool outputs when history passes this share of the window (must be ≥ maxContextLimit)." site_zh: "默认 \"95%\":历史超过窗口该占比时,对超大工具输出做紧急截断(必须 ≥ maxContextLimit)。" - key: compress.outputHeadroomMaxPct @@ -40,6 +43,7 @@ entries: render: compress-row desc_en: "Cap on the share of the window reserved for output via max_tokens." desc_zh: "max_tokens 输出预留占窗口的最大比例。" + desc_ja: "max_tokens 経由で出力に確保されるウィンドウの割合の上限。" site_en: "Cap (0–1, default 0.25) on the share of the window reserved for output via max_tokens." site_zh: "max_tokens 输出预留占窗口的最大比例(0–1,默认 0.25)。" - key: compress.nudgeGrowthTokens @@ -50,6 +54,7 @@ entries: render: compress-row desc_en: "Growth gate: nudges fire only when a foldable range exceeds baseline growth by this many tokens (flat by design, independent of window size)." desc_zh: "增长门槛:可折叠片段超出基线增长达到该 token 数才发提醒(按设计恒定,与窗口大小无关)。" + desc_ja: "成長ゲート:折りたたみ可能な範囲がベースライン成長をこのトークン数だけ上回った場合のみ、ナッジが発火する(設計上フラットであり、ウィンドウサイズに依存しない)。" site_en: "Growth gate (default 50000): nudges fire only when a foldable range exceeds baseline growth by this many tokens." site_zh: "增长门槛(默认 50000):可折叠片段超出基线增长达到该 token 数才发提醒。" - key: compress.tierNudgeTokens @@ -60,6 +65,7 @@ entries: render: compress-row desc_en: "Per-tier token-mass trigger thresholds; each unset tier falls back to its derived default, so absent/empty = legacy unified behavior (#2376)." desc_zh: "分层 token 质量触发阈值;每层未设置时回退到派生默认值,缺省/空对象=老的统一行为(#2376)。" + desc_ja: "ティアごとのトークン質量トリガー閾値。未設定のティアは導出デフォルトにフォールバックするため、欠落/空 = レガシー統合動作 (#2376)。" site_en: "Per-tier token-mass trigger thresholds for the T1/T2/T3 paths; each unset sub-field keeps its derived value (T1 = growth step, T2/T3 = step × 1.5)." site_zh: "T1/T2/T3 路径的分层 token 质量触发阈值;未设置的子字段保持派生值(T1=增长步长,T2/T3=步长 × 1.5)。" - key: compress.minPressureBenefitTokens @@ -70,6 +76,7 @@ entries: render: compress-row desc_en: "Minimum reclaimable tokens a pressure-band nudge must have to fire; on inflated-meter routes raise it so folds batch into big events instead of high-frequency small-yield churn (#3211). Explicit 0 = legacy any-pending." desc_zh: "压力带 nudge 触发所需的最小可回收 token 数;虚报表线路调大它,让折叠攒成大批量而非高频小折(#3211)。显式 0=老的任意 pending 行为。" + desc_ja: "圧力バンドのナッジが発火するために必要な最小の回収可能トークン数。インフレ計器ルートでは、高頻度の小規模な churn の代わりに、大きなイベントに折りたたみをバッチ処理するようにこれを引き上げる (#3211)。明示的な 0 = レガシーの任意の保留中。" site_en: "Minimum reclaimable tokens for a pressure-band nudge to fire (default max(5000, limit × 1%)); explicit 0 restores legacy any-pending behavior (#3211)." site_zh: "压力带 nudge 触发所需的最小可回收 token 数(默认 max(5000, 上限×1%));显式 0 恢复老的任意 pending 行为(#3211)。" - key: compress.requireUsageSampleForPressure @@ -80,6 +87,7 @@ entries: render: compress-row desc_en: "Phantom-pressure guard: when this round's meter is a local estimate (no billing sample — aborted turn, TTL expiry), the pressure band waits up to compress.maxEstimateHoldRounds rounds (default 2) for the real sample instead of firing EMERGENCY off an inflated reading, then falls back to the legacy estimate-driven decision so never-reporting upstreams cannot starve it forever. false = always legacy." desc_zh: "幻影压力守卫:本轮读数为本地估算(无计费样本——中断/TTL 丢 usage)时,压力带延后至多 compress.maxEstimateHoldRounds 轮(默认 2)等真样本,再回落到老的估算驱动决定,防止永不回传计费的线路被无限挂起。false=始终老行为。" + desc_ja: "ファントム圧力ガード:このラウンドの計器がローカル推定値(請求サンプルなし — 中断されたターン、TTL 期限切れ)の場合、圧力バンドはインフレした読み取り値に基づいて EMERGENCY を発火させるのではなく、実際のサンプルを最大 compress.maxEstimateHoldRounds ラウンド(デフォルト 2)まで待機し、その後レガシーの推定駆動決定にフォールバックすることで、レポートしないアップストリームが永遠に飢餓状態にしないようにする。false = 常にレガシー。" site_en: "When the decision meter has no billing sample this round (aborted turn, short-TTL expiry), pressure-band nudges are deferred for at most compress.maxEstimateHoldRounds rounds (default 2) until either a usage-grade reading decides or the bound runs out and the estimate decides (legacy); billed readings keep byte-identical behavior while within the hold. Set false to restore immediate estimate-driven pressure injection." site_zh: "本轮无计费样本(回合中断、短 TTL 丢 usage)时,压力带 nudge 延后至多 compress.maxEstimateHoldRounds 轮(默认 2),等实际 usage 级读数决定;到期仍未等到则按老行为用估算判,永不回传计费的会话因此不会被无限挂起。设 false 恢复旧的立即估算驱动行为。" - key: compress.maxEstimateHoldRounds @@ -90,6 +98,7 @@ entries: render: compress-row desc_en: "Backstop for the phantom-pressure guard (#5865 ruling): how many CONSECUTIVE estimate-grade rounds the pressure band may wait before firing on the estimate anyway. Capped so an upstream that never reports usage (anonymous zero-baseline forks, silent backends — where the local estimate is the only pressure signal) still gets automatic compression. 0 = no waiting at all. Only consulted while requireUsageSampleForPressure is on." desc_zh: "幻影压力守卫的兜底(#5865 裁定):压力带最多连等多少轮估算读数就必须照估算动手。兜底保证从不回传计费的会话(匿名零基线 fork、静默后端——本地估算是它们唯一的压力信号)也能拿到自动压缩。0=完全不等待。仅在 requireUsageSampleForPressure 开启时生效。" + desc_ja: "ファントム圧力ガードのバックストップ (#5865 裁定):圧力バンドが推定値に基づいて発火する前に、推定グレードのラウンドを何ラウンド連続で待機できるか。使用量をレポートしないアップストリーム(匿名ゼロベースラインフォーク、サイレントバックエンド — ローカル推定値が唯一の圧力シグナルとなる場所)でも、自動圧縮が実行されるように上限が設定されている。0 = 待機なし。requireUsageSampleForPressure がオンである間のみ参照される。" site_en: "Caps how many consecutive no-billing-sample rounds the pressure band may wait before deciding on the local estimate anyway (default 2), so a backend that never reports usage still gets automatic compression instead of being held forever; 0 waits not at all." site_zh: "限制压力带最多连等多少轮无计费样本的估算读数就必须照估算判(默认 2),保证从不回传计费的后端也能自动压缩、不会永远等待;设 0 表示不等待。" site_en: "When the decision meter has no billing sample this round (aborted turn, short-TTL expiry), pressure-band nudges are deferred one round until a usage-grade reading decides; billed readings keep byte-identical behavior. Set false to restore estimate-driven pressure injection." @@ -102,6 +111,7 @@ entries: render: compress-row desc_en: "Model-decided nudge timing (#2228): an armed tier-1 nudge first asks the model — via a short side call over the session's cached prefix — whether compressing NOW helps the current task. A strict-JSON \"yes\" injects an explicit directive with a program-finalized span; \"no\", a malformed answer, or a timeout injects nothing this round. EMERGENCY arms and tier≥2 distillation always keep the legacy advisory. Off unless explicitly enabled." desc_zh: "模型自决的压缩时机(#2228):tier-1 提醒触发时,先通过一次走会话缓存前缀的短 side call 问模型——以当前任务为前提,现在压缩是否划算。严格 JSON 的 \"yes\" 会注入带程序最终确定范围的明确压缩指令;\"no\"、格式错误或超时则本轮不注入任何内容。EMERGENCY 档与 tier≥2 蒸馏始终保留原有 advisory。默认关闭,需显式开启。" + desc_ja: "モデル決定によるナッジタイミング (#2228):アームされたティア 1 のナッジは、まずセッションのキャッシュ済みプレフィックス経由の短いサイドコールで、モデルに「今すぐ圧縮することが現在のタスクに有益か」を尋ねる。厳密な JSON の \"yes\" は、プログラムで最終化されたスパンを持つ明示的なディレクティブを注入する。\"no\"、不正な回答、またはタイムアウトの場合、このラウンドでは何も注入しない。EMERGENCY アームとティア 2 以上の蒸留は常にレガシーの助言を維持する。明示的に有効化されない限りオフ。" site_en: "Model-decided nudge timing (off by default): an armed tier-1 nudge first asks the model, over the session's cached prefix, whether compressing now helps the current task; a strict-JSON yes injects a directive with a program-finalized span, anything else injects nothing this round." site_zh: "模型自决的压缩时机(默认关闭):tier-1 提醒触发时,先通过会话缓存前缀上的短 side call 问模型现在压缩是否划算;严格 JSON 的 yes 注入带程序最终确定范围的指令,其余情况本轮不注入。" - key: compress.nudgeDecisionMaxTokens @@ -112,6 +122,7 @@ entries: render: compress-row desc_en: "Output budget (tokens) of the model-decision side call used by nudgeModelDecided. Must be > 0." desc_zh: "nudgeModelDecided 所用模型决策 side call 的输出预算(token)。必须 > 0。" + desc_ja: "nudgeModelDecided が使用するモデル決定サイドコールの出力予算(トークン数)。0 より大きい必要がある。" site_en: "Output budget (tokens) of the model-decision side call (default 200). Must be > 0." site_zh: "模型决策 side call 的输出预算(token,默认 200)。必须 > 0。" - key: compress.requireNudge @@ -122,6 +133,7 @@ entries: render: compress-row desc_en: "Forbid UNPROMPTED model-initiated compression (#5683/#5943): a compress call is refused unless a NUDGE CREDIT is live — a window of 20 MODEL rounds minted by the last compression nudge that actually reached the model (advisory, decide-directive and emergency injections all mint; \"gated\"/\"vetoed\"/\"skipped\" never do), refreshed by each new injection and decayed one per un-nudged model round (non-model request shapes hold it open). Successful folds do NOT consume the credit, so finishing a nudge's recommended cleanup over several rounds stays legal. Refusal sends the model an error receipt instead of folding; bili's own overflow backstop folds are exempt. For models that fold on their own (e.g. qwen 27b); can be scoped per provider/model. Off unless explicitly enabled." desc_zh: "禁止未提示的模型主动压缩(#5683/#5943):只有 nudge 信用存活时才允许 compress——即距最近一次真正送达模型的压缩提醒不超过 20 个 MODEL 轮的窗口(advisory、模型自决指令、紧急提醒都算铸券;\"gated\"/\"vetoed\"/\"skipped\" 不算);每次新注入刷新窗口,每个未提示的模型轮衰减 1(非模型请求形态既不刷新也不衰减)。成功折叠**不消耗**信用,分几轮压完 nudge 推荐的剩余范围仍然合法。否则拒绝并回错误回执;bili 自己的溢出兜底折叠不受影响。针对会自行乱压的模型(如 qwen 27b),可按 provider/model 单独开启。默认关闭。" + desc_ja: "無促のモデル主導圧縮の禁止 (#5683/#5943):NUDGE CREDIT がライブでない限り、compress 呼び出しは拒否される — 最後にモデルに実際に到達した圧縮ナッジ(助言、決定ディレクティブ、緊急注入はすべて発行;\"gated\"/\"vetoed\"/\"skipped\" は発行しない)によって発行された 20 モデルラウンドのウィンドウ。各新しい注入で更新され、ナッジされないモデルラウンドごとに 1 ずつ減衰する(非モデルリクエスト形状はそれをオープンに保つ)。成功した折りたたみはクレジットを消費しないため、ナッジの推奨クリーンアップを複数ラウンドにわたって完了することは依然として合法である。拒否は、折りたたむ代わりにモデルにエラーレシートを送る。bili 自身のオーバーフローバックストップ折りたたみは免除される。自分で折りたたむモデル(例: qwen 27b)向け;プロバイダー/モデルごとにスコープを限定できる。明示的に有効化されない限りオフ。" site_en: "Forbid unprompted compression (off by default): a model compress call is refused unless a nudge credit is live — a delivered nudge opens a 20-model-round window, refreshed by each new nudge; the refusal returns an error receipt instead of folding." site_zh: "禁止未提示压缩(默认关闭):只有 nudge 信用存活(送达的提醒开启 20 个模型轮窗口,新提醒刷新窗口)才允许模型调用 compress,否则拒绝并回错误回执。" - key: compress.requireRecommendation @@ -132,6 +144,7 @@ entries: render: compress-row desc_en: "Forbid OUT-OF-BOUNDS model-initiated compression (#5683): every submitted range must stay within what bili currently recommends folding — the same live compressible set the nudge text and acp_status show (this request's prepare-time offer when present, else a live recompute). Judgment is by COVERAGE: subdividing a recommended span passes, and messages already folded into active blocks (refolds updating an existing summary) are exempt. A range carrying any other live message is refused whole with an error receipt naming the offending span(s). Off unless explicitly enabled." desc_zh: "禁止越界的模型主动压缩(#5683):提交的每个范围必须落在 bili 当前推荐折叠的集合内——即 nudge 文案与 acp_status 展示的同一份实时可压缩列表(有本轮 prepare 快照用快照,否则实时重算)。按「覆盖」判定而非精确相等:把推荐跨度拆小段通过;已折进活跃块的消息豁免(重折已有块更新摘要合法)。范围里含任何其他仍存活的消息则整体拒绝,回执点名越界跨度并指向 acp_status。默认关闭。" + desc_ja: "範囲外のモデル主導圧縮の禁止 (#5683):提出されたすべての範囲は、bili が現在折りたたみを推奨している範囲内に留まらなければならない — ナッジテキストと acp_status が示すのと同じライブ折りたたみ可能セット(存在する場合、このリクエストの準備時オファー、それ以外の場合はライブ再計算)。判定はカバレッジによる:推奨スパンの細分化は合格し、アクティブなブロックにすでに折りたたまれたメッセージ(既存のサマリーを更新する再折りたたみ)は免除される。他のライブメッセージを含む範囲は、問題のあるスパンを特定するエラーレシートとともに全体として拒否される。明示的に有効化されない限りオフ。" site_en: "Forbid out-of-bounds compression (off by default): only ranges bili currently recommends may be folded; subdividing a listed span or refolding an existing block stays legal." site_zh: "禁止越界压缩(默认关闭):只允许折叠 bili 当前推荐的范围;拆分推荐跨度、重折已有块更新摘要仍合法。" - key: compress.streamSummary @@ -142,6 +155,7 @@ entries: render: compress-row desc_en: "Force preflight summarization to run as a streaming (SSE) call from the first attempt. The error-driven self-learn handles stream-mandating upstreams on its own (any 400 on a non-streaming summary triggers a one-shot SSE probe, #2494) but NEVER arms on gateway timeouts (e.g. Cloudflare HTTP 524): set this where such a gateway sits between bili and the origin, or simply to skip the one probe round-trip." desc_zh: "强制 preflight 摘要从首次尝试起就走流式(SSE)请求。要求流式的上游现在由错误驱动自学习自动处理(非流式摘要的任何 400 都会触发一次性 SSE 探测,#2494),但网关超时(如 Cloudflare HTTP 524)永远无法触发自学习:在此类网关位于 bili 与源站之间时设置此项,或用于省去一次探测往返。" + desc_ja: "事前チェックの要約を、最初の試行からストリーミング(SSE)コールとして実行することを強制する。エラー駆動の自己学習は、ストリーミングを強制するアップストリームを独自に処理する(非ストリーミング要約での 400 はワンショット SSE プローブをトリガーする、#2494)が、ゲートウェイタイムアウト(例: Cloudflare HTTP 524)では決してアームしない:bili とオリジンの間にそのようなゲートウェイがある場合にこれを設定するか、単に 1 回のプローブ往復をスキップするために設定する。" site_en: "Force streaming (SSE) summarization from the first attempt — stream-mandating upstreams now self-heal via a one-shot SSE probe on any non-streaming 400 (#2494); kept as the escape hatch for gateways that time out long non-streaming calls (e.g. Cloudflare 524), which the self-learn cannot detect, or to skip the one probe round-trip." site_zh: "强制摘要从首次起走流式(SSE)——要求流式的上游现在通过任何非流式 400 上的一次性 SSE 探测自愈(#2494);保留作为会掐断长非流式调用的网关(如 Cloudflare 524)的逃生通道(自学习无法感知该场景),也可用于省去一次探测往返。" - key: compress.preserveRecentMessages @@ -152,6 +166,7 @@ entries: render: compress-row desc_en: "The most recent messages stay soft-protected from folds." desc_zh: "最近的消息软保护、免于折叠。" + desc_ja: "最新のメッセージは、折りたたみからソフト保護される。" site_en: "Kernel default 3 (tuned 5 → 3, #3058): the most recent messages stay soft-protected from folds." site_zh: "内核默认 3(5 → 3,#3058):最近消息软保护、免于折叠。" - key: compress.preserveRecentTokens @@ -162,6 +177,7 @@ entries: render: compress-row desc_en: "The most recent tokens stay soft-protected from folds." desc_zh: "最近的 token 软保护、免于折叠。" + desc_ja: "最新のトークンはフォールドからソフト保護される。" site_en: "Kernel default ≈5000: the most recent tokens stay soft-protected from folds." site_zh: "内核默认约 5000:最近的 token 软保护、免于折叠。" - key: compress.minCompressRangeChars @@ -172,6 +188,7 @@ entries: render: compress-row desc_en: "Smallest foldable range, in characters; shorter ranges never fold." desc_zh: "可折叠片段的最小字符数;更短的永不折叠。" + desc_ja: "フォールド可能な最小範囲(文字数)。これより短い範囲はフォールドされない。" site_en: "Smallest foldable range, in characters (kernel default ≈5000) — shorter ranges never fold." site_zh: "可折叠片段的最小字符数(内核默认约 5000),更短的永不折叠。" - key: compress.maxSummaryLength @@ -182,6 +199,7 @@ entries: render: compress-row desc_en: "Hard character cap on ONE generated summary; longer replies are rejected whole (no truncation, no retry). External summarizers are told this exact cap up front (#3635). 0 = unbounded." desc_zh: "单条生成摘要的硬字符上限;超长的回复被整段拒绝(不截断、不重试)。外部摘要模型会被提前告知这个确切上限(#3635)。0 = 不限制。" + desc_ja: "1つの生成サマリーに対する文字数のハード上限。これを超える返信は全体として拒否される(切り詰めもリトライもされない)。外部サマライザーにはこの正確な上限が事前に通知される(#3635)。0 = 無制限。" site_en: "Hard cap, in characters, on one generated summary (kernel default 20000): longer replies are rejected whole by the kernel check or the external-summary executor. External summarizers receive this exact cap in their instructions (#3635); 0 disables the cap." site_zh: "单条生成摘要的硬上限,单位为字符(内核默认 20000):超长的回复由内核检查或外部摘要执行器整段拒绝。外部摘要模型的指令中会写明这个确切上限(#3635);0 禁用上限。" - key: compress.minSummaryLength @@ -192,6 +210,7 @@ entries: render: compress-row desc_en: "Character floor for generated summaries: a single range must meet it alone; a multi-range batch passes when its combined summaries reach it (#5894). 0 = disabled. External summarizers remain held to the per-summary floor (#3635)." desc_zh: "生成摘要的字符下限:单段压缩按自身判定;批量压缩按合计判定——一段偷懒不再拖垮整批(#5894)。0 = 禁用。外部摘要模型仍受逐段下限约束(#3635)。" + desc_ja: "生成サマリーの文字数下限:単一範囲はこれに単独で達する必要がある。複数範囲のバッチは、その結合サマリーがこれに達した場合に合格する(#5894)。0 = 無効。外部サマライザーはサマリーごとの下限に引き続き従う(#3635)。" site_en: "Floor, in characters, for generated summaries (kernel default 50): a single range must meet it on its own; a multi-range batch passes when its COMBINED summaries reach it — one lazy paragraph no longer sinks the whole batch (#5894). 0 disables the floor. External summarizers remain held to the per-summary floor (#3635)." site_zh: "生成摘要的下限,单位为字符(内核默认 50):单段压缩按自身判定;批量压缩按各段合计判定——一段偷懒不再拖垮整批(#5894)。0 禁用下限。外部摘要模型仍受逐段下限约束(#3635)。" - key: compress.reconcile @@ -203,6 +222,7 @@ entries: render: compress-row desc_en: "Reconcile folded state when the client rewinds or rewrites history between turns." desc_zh: "客户端在轮次之间回退或改写历史时校准已折叠状态。" + desc_ja: "クライアントがターン間で履歴を巻き戻しまたは書き換えた場合、フォールド状態を調整する。" site_en: "\"off\" | \"warn\" | \"repair\" (default repair): reconcile folded state when the client rewinds or rewrites history between turns." site_zh: "\"off\" | \"warn\" | \"repair\"(默认 repair):客户端在轮次之间回退或改写历史时校准已折叠状态。" - key: compress.promptPack @@ -213,6 +233,7 @@ entries: render: compress-row desc_en: "Compression prompt pack, resolved project pack → user pack → builtin; not gated by acknowledgePromptsRisk." desc_zh: "压缩提示词包,按 项目包 → 用户包 → 内置 解析;不受 acknowledgePromptsRisk 门控。" + desc_ja: "圧縮プロンプトパック。解決順序はプロジェクトパック → ユーザーパック → ビルトイン。`acknowledgePromptsRisk` によるゲートはされない。" site_en: "Compression prompt pack, resolved project pack → user pack → builtin. Builtins: \"default\" and \"lean\" (one-line tool descriptions). Not gated by acknowledgePromptsRisk." site_zh: "压缩提示词包,按 项目包 → 用户包 → 内置 解析。内置:\"default\" 与 \"lean\"(单行工具描述)。不受 acknowledgePromptsRisk 门控。" - key: compress.tiers @@ -223,6 +244,7 @@ entries: render: compress-row desc_en: "Tiered T1→T3 distillation spreads folding cost across generations." desc_zh: "T1→T3 分级蒸馏把折叠成本摊到多代。" + desc_ja: "T1→T3 の階層型蒸留により、フォールドコストを世代間で分散する。" site_en: "On by default: tiered T1→T3 distillation spreads folding cost across generations." site_zh: "默认开:T1→T3 分级蒸馏,把折叠成本摊到多代。" - key: compress.protectedTools @@ -233,6 +255,7 @@ entries: render: compress-row desc_en: "Hard exclusion across all history: results of listed tools never fold. Path patterns (skill/) select skills by name (#1947)." desc_zh: "全历史硬排除:列出工具的结果永不折叠。路径模式(skill/)可按名指定 skill(#1947)。" + desc_ja: "全履歴に対するハード除外:リストされたツールの結果は決してフォールドされない。パスパターン(`skill/`)は名前でスキルを選択する(#1947)。" site_en: "Hard exclusion across all history: results of listed tools never fold (use with care)." site_zh: "全历史硬排除:列出工具的结果永不折叠(慎用)。" - key: compress.protectedLatestTools @@ -243,6 +266,7 @@ entries: render: compress-row desc_en: "Protects only the LATEST instance of cumulative-snapshot tools whose newest result supersedes older ones (e.g. todo lists). Path patterns keep the latest instance per skill (skill/*, #1947)." desc_zh: "只保护累积快照类工具「最新一次」实例(新结果覆盖旧结果的工具,如 todo 列表)。路径模式按 skill 分组各保最新(skill/*,#1947)。" + desc_ja: "最新の結果が古いものを上書きする累積スナップショット型ツールの最新インスタンスのみを保護する(例:todo リスト)。パスパターンはスキルごとに最新インスタンスを保持する(`skill/*`, #1947)。" site_en: "Protects only the LATEST instance of cumulative-snapshot tools whose newest result supersedes older ones (e.g. todo lists)." site_zh: "只保护累积快照类工具的「最新一次」实例(新结果覆盖旧结果的工具,如 todo 列表)。" - key: compress.neverPreserveRecentTools @@ -253,6 +277,7 @@ entries: render: compress-row desc_en: "Excluded from the recent protection zone (immediately compressible); an empty array excludes nothing (maximum protection)." desc_zh: "从近期保护区排除(立即可压);空数组合法=不排除任何工具(最大保护)。" + desc_ja: "最近保護ゾーンから除外(即時圧縮可能)。空の配列は何も除外しない(最大保護)。" site_en: "Excluded from the recent protection zone (immediately compressible); default [\"decompress\", \"search_context\", \"read\", \"bash\"]. An empty array is valid — it excludes nothing (maximum protection)." site_zh: "从近期保护区排除(立即可压);默认 [\"decompress\", \"search_context\", \"read\", \"bash\"]。空数组合法=不排除任何工具(最大保护)。" - key: compress.preserveRecentTools @@ -263,6 +288,7 @@ entries: render: compress-row desc_en: "Subtraction form: recent-zone tools minus this list get full protection; an empty array here is rejected as a typo." desc_zh: "减法形式:近期区工具减去本列表得到完全保护;此处空数组按笔误拒绝。" + desc_ja: "減算形式:最近ゾーンツールからこのリストを引いたものが完全保護される。ここでの空の配列は誤記として拒否される。" site_en: "Subtraction form: recent-zone tools minus this list get full protection. An empty array here is rejected as a typo." site_zh: "减法形式:近期区工具减去本列表得到完全保护;此处空数组按笔误拒绝。" - key: compress.visibilityMarkers @@ -273,6 +299,7 @@ entries: render: compress-row desc_en: "Append visibility markers after compress/decompress/search_context/acp_status results; off stops imitated narration." desc_zh: "在 compress/decompress/search_context/acp_status 结果后追加可见性标记;关闭可抑制模型模仿叙述。" + desc_ja: "`compress`/`decompress`/`search_context`/`acp_status` の結果後に可視性マーカーを追加。オフにすると模倣ナレーションが停止する。" site_en: "Append 📦/❌ visibility markers after compress/decompress/search_context/acp_status results (on by default; off stops imitated narration)." site_zh: "在 compress/decompress/search_context/acp_status 结果后追加 📦/❌ 可见性标记(默认开;关闭可抑制模型模仿叙述)。" - key: compress.messageTimestamps @@ -284,6 +311,7 @@ entries: render: compress-row desc_en: "Attach immutable wall-clock time stamps to compressed-message records: time= on the wire's ACP tags, a [start – end] coverage span in compress receipts, and an Occurred line in summaries. ON by default: each message gets one immutable first-sight stamp rendered deterministically, so re-rendered history stays byte-stable (no prompt-cache cost beyond the one enabling-restart prefix rewrite). Set false to reproduce the pre-#4313 bytes exactly." desc_zh: "为压缩消息记录附加不可变墙钟时间戳:线上 ACP 标签的 time=\"…\" 属性、压缩回执指纹行的 [start – end] 覆盖跨度、渲染摘要的 Occurred 行。默认开启:每条消息首次出现时铸不可变戳、确定性渲染(历史重发字节稳定);设为 false 可精确复现特性前(pre-#4313)的线上字节。" + desc_ja: "圧縮メッセージレコードに不変の壁時計タイムスタンプを付与:ワイヤー上の ACP タグに `time=`、`compress` 受領証に `[start – end]` カバレッジスパン、サマリーに `Occurred` 行。デフォルトで ON:各メッセージに1つの不変な初回表示スタンプが決定論的にレンダリングされるため、再レンダリングされた履歴はバイト安定性を保つ(有効化時の再起動によるプレフィックス書き換えを超えるプロンプトキャッシュコストなし)。`false` に設定すると、#4313 以前のバイトを正確に再現する。" site_en: "Message timestamps (#4313): first-sight wall-clock stamps shown as time= on compression tags, coverage spans in receipts and Occurred lines in summaries; ON by default. Set `compress.messageTimestamps: false` or env BILI_MESSAGE_TIMESTAMPS=0 to keep every byte identical to pre-feature master. Env wins when defined (0 forces off, any other value forces on); resolved once per instance — changing the flag needs a restart, and the first restart with the flag on pays one frozen-prefix cache rewrite per active session." site_zh: "消息时间戳(#4313):首次出现时铸不可变墙钟戳,展示为压缩标签的 time= 属性、回执覆盖跨度、摘要 Occurred 行;默认开启。设 `compress.messageTimestamps: false` 或 env BILI_MESSAGE_TIMESTAMPS=0 可让线上字节与特性前逐字节一致。env 有定义时优先(0 强制关,其他值强制开);实例启动时一次性解析——改开关需重启,开关生效后的首个重启每个活跃会话付一次冻结前缀缓存重写。" - key: compress.rules @@ -294,6 +322,7 @@ entries: render: compress-row desc_en: "Persistent model reminders delivered through an injected acp_rule tool, hard-protected from folds; pi/omp expose an /acp-rule command. Proxy-mode only — inert in plugin mode, where the host owns the tool surface." desc_zh: "通过注入的 acp_rule 工具提供持久模型提醒——对折叠硬保护;pi/omp 提供 /acp-rule 命令。仅代理模式生效——插件模式下宿主自管工具面,此项无效。" + desc_ja: "注入された `acp_rule` ツールを通じて配信される永続モデルリマインダー。フォールドからハード保護される。`pi/omp` は `/acp-rule` コマンドを公開する。プロキシモード専用 — プラグインモードでは無効であり、ホストがツールサーフェスを所有する。" site_en: "Off by default: persistent model reminders delivered through an injected acp_rule tool, hard-protected from folds. pi/omp expose an /acp-rule command. Proxy-mode only — inert in plugin mode." site_zh: "默认关:通过注入的 acp_rule 工具提供持久模型提醒——对折叠硬保护。pi/omp 提供 /acp-rule 命令。仅代理模式生效——插件模式下无效。" - key: compress.injectTool @@ -305,6 +334,7 @@ entries: render: compress-row desc_en: "Register the acp_compress tool for clients (global level only)." desc_zh: "向客户端注册 acp_compress 工具(仅全局层级生效)。" + desc_ja: "クライアント向けに `acp_compress` ツールを登録(グローバルレベルのみ)。" site_en: "Register the acp_compress tool for clients (on by default; global level only)." site_zh: "向客户端注册 acp_compress 工具(默认开;仅全局层级生效)。" - key: compress.injectNudge @@ -316,6 +346,7 @@ entries: render: compress-row desc_en: "Send growth nudges as the window fills (global level only)." desc_zh: "窗口填满过程中发送增长提醒(仅全局层级生效)。" + desc_ja: "ウィンドウが埋まるにつれて成長の通知を送信する(グローバルレベルのみ)。" site_en: "Send growth nudges as the window fills (on by default; global level only)." site_zh: "窗口填满过程中发送增长提醒(默认开;仅全局层级生效)。" - key: compress.reasoning @@ -326,6 +357,7 @@ entries: render: compress-row desc_en: "Drop finished-round reasoning runs longer than 2048 chars (drop: true by default); strict-reasoning upstreams need drop:false." desc_zh: "丢弃超过 2048 字符的已结束轮次推理块(drop 默认 true);严格推理上游需设 drop:false。" + desc_ja: "2048文字を超える完了ラウンドの推論実行を破棄する(デフォルトで drop: true);厳格な推論を要求するアップストリームでは drop: false が必要。" site_en: "{ drop?, threshold? } — drop finished-round reasoning runs longer than 2048 chars (drop: true by default); strict-reasoning upstreams need drop:false." site_zh: "{ drop?, threshold? }——丢弃超过 2048 字符的已结束轮次推理块(drop 默认 true);严格推理上游需设 drop:false。" - key: compress.absorb @@ -336,6 +368,7 @@ entries: render: obj-item desc_en: "Opt-in instant distillation of tool results into short abstracts; originals go to the content store. By default only image-bearing results qualify." desc_zh: "可选即时蒸馏:把工具结果蒸馏成短摘要,原文进内容库。默认仅图片类结果参与。" + desc_ja: "ツール結果を短い要約に即時蒸留するオプトイン機能;元データはコンテンツストアに保存される。デフォルトでは画像を含む結果のみが対象となる。" site_en: "absorb — opt-in instant distillation of tool results into short abstracts; originals go to the content store; by default only image-bearing results qualify (enabled, minToolTokens (default 1000), contextThresholdPct, excludeTools, mediaOnly (default true), toolName \"absorb\")." site_zh: "absorb —— 可选即时蒸馏:把工具结果蒸馏成短摘要,原文进内容库;默认仅图片类结果参与(enabled, minToolTokens(默认 1000), contextThresholdPct, excludeTools, mediaOnly(默认 true), toolName \"absorb\")。" - key: compress.blockOps @@ -346,6 +379,7 @@ entries: render: obj-item desc_en: "Opt-in block-lifecycle tools (acp_retire / acp_restore / acp_rewrite) for compressed-block management; default-off keeps the wire byte-identical to pre-#5765." desc_zh: "可选的压缩块生命周期工具(acp_retire / acp_restore / acp_rewrite);默认关闭,关闭时线上字节与 #5765 之前完全一致。" + desc_ja: "圧縮ブロック管理用のブロックライフサイクルツール(acp_retire / acp_restore / acp_rewrite)のオプトイン;デフォルト無効により、#5765 以前のワイヤーとバイト単位で同一を維持する。" site_en: "blockOps — opt-in compressed-block lifecycle tools (acp_retire / acp_restore / acp_rewrite); off by default so the wire surface stays byte-identical to pre-#5765 (enabled)." site_zh: "blockOps —— 可选的压缩块生命周期工具(acp_retire / acp_restore / acp_rewrite);默认关闭,线上表面与 #5765 之前逐字节一致(enabled)。" - key: compress.ccr @@ -356,6 +390,7 @@ entries: render: obj-item desc_en: "Content cache & retrieve: large outputs stored losslessly beside the session, replaced by head excerpt + pointer fetched back via acp_retrieve; no cap or eviction." desc_zh: "内容缓存与回取:大输出无损存到会话旁、替换为首段摘录+指针,模型用 acp_retrieve 取回原文;无上限、永不清除。" + desc_ja: "コンテンツキャッシュと取得:大きな出力はセッションの隣接にロスカレスで保存され、先頭抜粋とポインタに置き換えられ、acp_retrieve 経由で取得される;上限や退避は行われない。" site_en: "ccr — content cache & retrieve: large outputs are stored losslessly beside the session and replaced by a head excerpt plus pointer; the model fetches originals back via acp_retrieve. No cap or eviction; on by default in proxy mode since v2 (enabled, minToolTokens (~4000), excludeTools, toolName \"acp_retrieve\", maxHeadChars)." site_zh: "ccr —— 内容缓存与回取:大输出无损存到会话旁、替换为首段摘录+指针,模型用 acp_retrieve 取回原文;无上限、永不清除;自 v2 起代理模式默认开(enabled, minToolTokens(~4000), excludeTools, toolName \"acp_retrieve\", maxHeadChars)。" - key: compress.search @@ -366,6 +401,7 @@ entries: render: obj-item desc_en: "Search-behavior settings for search_context; currently holds planAware re-ranking." desc_zh: "search_context 的检索行为设置;当前含 planAware 重排。" + desc_ja: "search_context の検索動作設定;現在、planAware リランキングを保持している。" site_en: "search — search-behavior settings for search_context; currently holds planAware." site_zh: "search —— search_context 的检索行为设置;当前含 planAware。" - key: compress.search.planAware @@ -376,6 +412,7 @@ entries: render: obj-item desc_en: "When on, search_context candidates are re-ranked against current plan state; off keeps byte-identical lexical results." desc_zh: "开启后 search_context 候选按当前计划状态重排;关闭时结果逐字节不变。" + desc_ja: "オンにすると、search_context の候補が現在のプラン状態に対してリランキングされる;オフにすると、バイト単位で同一の語彙結果が維持される。" site_en: "search.planAware — off by default: when on, search_context candidates are re-ranked against current plan state (latest-wins todos + last user turn); off keeps byte-identical lexical results." site_zh: "search.planAware —— 默认关:开启后 search_context 候选按当前计划状态重排(todo 最新优先 + 上一轮用户消息);关闭时结果逐字节不变。" - key: compress.prompts @@ -386,6 +423,7 @@ entries: render: obj-item desc_en: "Override the kernel doctrine texts; load-bearing for quality — gated behind acknowledgePromptsRisk." desc_zh: "覆盖内核教条文本;对压缩质量承重要——受 acknowledgePromptsRisk 门控。" + desc_ja: "カーネル教義テキストを上書きする;品質に重要であるため、acknowledgePromptsRisk によってゲートされている。" site_en: "prompts — override the kernel doctrine texts (compressPhilosophy, howToCompressRules, tier2DistillRules, tier3CondenseRules); load-bearing for quality — gated behind acknowledgePromptsRisk." site_zh: "prompts —— 覆盖内核教条文本(compressPhilosophy, howToCompressRules, tier2DistillRules, tier3CondenseRules);对压缩质量承重要——受 acknowledgePromptsRisk 门控。" - key: compress.reasoningGuard @@ -396,6 +434,7 @@ entries: render: obj-item desc_en: "Auto-repair of reasoning-lattice truncation on gpt-5.x/6.x (up to 3 continue-nudge rounds)." desc_zh: "gpt-5.x/6.x 推理格截断自动修复(最多 3 轮继续提示)。" + desc_ja: "gpt-5.x/6.x における推論格子の切り詰めに対する自動修復(最大3ラウンドの継続通知)。" site_en: "reasoningGuard — auto-repair of reasoning-lattice truncation on gpt-5.x/6.x (≤3 continue-nudge rounds, marker \"Continue thinking...\") (enabled, maxContinue, maxTierN, markerText, base, offset, debugLog)." site_zh: "reasoningGuard —— gpt-5.x/6.x 推理格截断自动修复(≤3 轮继续提示,标记 \"Continue thinking...\")(enabled, maxContinue, maxTierN, markerText, base, offset, debugLog)。" - key: compress.outputSteering @@ -406,6 +445,7 @@ entries: render: obj-item desc_en: "Appends a conciseness directive to the system-prompt tail; clamps mechanical continuation requests." desc_zh: "向系统提示词尾部附加简洁度指令;只收紧机械延续请求。" + desc_ja: "システムプロンプトの末尾に簡潔性の指示を追加する;機械的な継続要求をクランプする。" site_en: "outputSteering — { enabled? false, verbosityLevel? 2 (0–4), effortRouting? }: appends a conciseness directive to the system-prompt tail; clamps mechanical continuation requests." site_zh: "outputSteering —— { enabled? false, verbosityLevel? 2 (0–4), effortRouting? }:向系统提示词尾部附加简洁度指令;只收紧机械延续请求。" - key: compress.priceProfile @@ -416,6 +456,7 @@ entries: render: obj-item desc_en: "w/r/q ratios normalized to the input price (write/cache-read/output); report-only — never affects triggers or the wire." desc_zh: "w/r/q 相对输入价的比率(写入/缓存读/输出);仅供报告,不影响触发条件或线上行为。" + desc_ja: "w/r/q 比率を入力価格(書き込み/キャッシュ読み取り/出力)に対して正規化する;レポート専用であり、トリガーやワイヤーには影響を与えない。" site_en: "priceProfile — w / r / q ratios normalized to the input price (write / cache-read / output); unset ⇒ models.dev $/Mtok registry rows, kernel fallback {1, 0.1, 4}. Report-only — never affects triggers or the wire." site_zh: "priceProfile —— w / r / q 相对输入价的比率(写入/缓存读/输出);未设置 ⇒ 取 models.dev $/Mtok 注册表行,内核兜底 {1, 0.1, 4}。仅供报告,不影响触发条件或线上行为。" - key: compress.externalSummary @@ -426,6 +467,7 @@ entries: render: obj-item desc_en: "Sends compression summaries to separately configured models referenced from the providers table; whole-chain replace semantics at all three compress levels." desc_zh: "把压缩摘要交给 providers 表引用的独立配置模型;三级 compress 均为整链替换语义。" + desc_ja: "プロバイダテーブルから参照される個別設定モデルに圧縮サマリーを送信する;3つの圧縮レベルすべてでチェーン全体の置換セマンティクスを持つ。" site_en: "externalSummary — optional chain of external summary models, each target a \"provider/model\" reference into the providers table; disabled unless enabled is true, targets tried in order with fall-through (enabled, targets, budget {totalTimeoutMs, targetTimeoutMs, maxSummaryBytes}, concurrency, autoFold, autoFoldTargetTokens). Whole-chain replace semantics at all three compress levels." site_zh: "externalSummary —— 可选的外部摘要模型链,每个目标为指向 providers 表的 \"provider/model\" 引用;enabled 为 true 才启用,目标按顺序尝试、失败落到下一个(enabled, targets, budget {totalTimeoutMs, targetTimeoutMs, maxSummaryBytes}, concurrency, autoFold, autoFoldTargetTokens)。三级 compress 均为整链替换语义。" - key: compress.acknowledgePromptsRisk @@ -436,6 +478,7 @@ entries: render: obj-item desc_en: "Must be true before custom prompts take effect." desc_zh: "必须先置 true,自定义 prompts 才会生效。" + desc_ja: "カスタムプロンプトが有効になる前に true である必要がある。" site_en: "acknowledgePromptsRisk — must be true before custom prompts take effect." site_zh: "acknowledgePromptsRisk —— 必须先置 true,自定义 prompts 才会生效。" - key: compress.absorb.enabled @@ -444,186 +487,217 @@ entries: group: compress desc_en: "Enable the absorb distillation block." desc_zh: "启用 absorb 蒸馏块。" + desc_ja: "吸収蒸留ブロックを有効にする。" - key: compress.absorb.minToolTokens type: number default: "1000" group: compress desc_en: "Minimum estimated token size of a tool result eligible for absorption." desc_zh: "可被吸收的工具结果的最小估算 token 大小。" + desc_ja: "吸収の対象となるツール結果の最小推定トークンサイズ。" - key: compress.absorb.contextThresholdPct type: "number | %" default: "unset" group: compress desc_en: "Only absorb when context usage passes this share of the window." desc_zh: "仅当上下文使用率超过窗口该占比时才吸收。" + desc_ja: "コンテキスト使用量がウィンドウのこの割合を超えた場合のみ吸収する。" - key: compress.absorb.excludeTools type: "string[]" default: "[]" group: compress desc_en: "Tool names excluded from absorption." desc_zh: "排除出吸收范围的工具名。" + desc_ja: "吸収から除外されるツール名。" - key: compress.absorb.toolName type: string default: "\"absorb\"" group: compress desc_en: "Registered name of the absorb tool." desc_zh: "absorb 工具的注册名。" + desc_ja: "吸収ツールの登録名。" - key: compress.absorb.mediaOnly type: boolean default: "true" group: compress desc_en: "Restrict absorption to tool results that carry media (images). Image bytes are exempt from minToolTokens since they are not counted in text. Set false to restore legacy full-text absorption of any large result." desc_zh: "仅吸收携带媒体(图片)的工具结果;图片字节不计入文本 token,故豁免 minToolTokens 门槛。置 false 恢复对任意大结果的全文吸收(旧行为)。" + desc_ja: "メディア(画像)を伴うツール結果に吸収を制限する。画像バイトはテキストにカウントされないため、minToolTokens の対象外となる。false に設定すると、従来の大規模結果の全文吸収が有効になる。" - key: compress.blockOps.enabled type: boolean default: "false" group: compress desc_en: "Enable the three block-lifecycle tools (injection + prompt + manifest). Off = no tools, no prompt section, zero per-request cost." desc_zh: "启用三个压缩块生命周期工具(注入 + prompt + manifest)。关闭 = 无工具、无 prompt 段、零每请求开销。" + desc_ja: "3 つのブロックライフサイクルツール(インジェクション + プロンプト + マニフェスト)を有効にする。Off = ツールなし、プロンプトセクションなし、リクエストごとのコストゼロ。" - key: compress.ccr.enabled type: boolean default: "true (proxy mode)" group: compress desc_en: "Enable the content-cache-and-retrieve block." desc_zh: "启用内容缓存与回取块。" + desc_ja: "コンテンツキャッシュおよび取得ブロックを有効にする。" - key: compress.ccr.minToolTokens type: number default: "≈4000" group: compress desc_en: "Minimum estimated token size of a tool result eligible for CCR storage." desc_zh: "可进入 CCR 存储的工具结果的最小估算 token 大小。" + desc_ja: "CCR ストレージの対象となるツール結果の最小推定トークンサイズ。" - key: compress.ccr.excludeTools type: "string[]" default: "[]" group: compress desc_en: "Tool names excluded from CCR storage." desc_zh: "排除出 CCR 存储的工具名。" + desc_ja: "CCR ストレージから除外されるツール名。" - key: compress.ccr.toolName type: string default: "\"acp_retrieve\"" group: compress desc_en: "Registered name of the retrieval tool." desc_zh: "回取工具的注册名。" + desc_ja: "取得ツールの登録名。" - key: compress.ccr.maxHeadChars type: number default: "96" group: compress desc_en: "Maximum head-excerpt length left inline at the storage pointer." desc_zh: "存储指针处内联首段摘录的最大长度。" + desc_ja: "ストレージポインタにインラインで残される最大ヘッド抜粋の長さ。" - key: compress.prompts.compressPhilosophy type: string default: "unset (kernel text)" group: compress desc_en: "Override of the compression philosophy doctrine paragraph." desc_zh: "覆盖压缩哲学教条文段。" + desc_ja: "圧縮哲学教義パラグラフの上書き。" - key: compress.prompts.howToCompressRules type: string default: "unset (kernel text)" group: compress desc_en: "Override of the compression how-to rules." desc_zh: "覆盖压缩操作规则。" + desc_ja: "圧縮手順ルールの上書き。" - key: compress.prompts.tier2DistillRules type: string default: "unset (kernel text)" group: compress desc_en: "Override of the tier-2 distillation rules." desc_zh: "覆盖二级蒸馏规则。" + desc_ja: "ティア 2 蒸留ルールの上書き。" - key: compress.prompts.tier3CondenseRules type: string default: "unset (kernel text)" group: compress desc_en: "Override of the tier-3 condensation rules." desc_zh: "覆盖三级浓缩规则。" + desc_ja: "ティア 3 凝縮ルールの上書き。" - key: compress.reasoningGuard.enabled type: boolean default: "false" group: compress desc_en: "Enable reasoning-lattice auto-repair." desc_zh: "启用推理格自动修复。" + desc_ja: "推論格子の自動修復を有効にする。" - key: compress.reasoningGuard.maxContinue type: number default: "3" group: compress desc_en: "Maximum continue-nudge rounds per truncation." desc_zh: "单次截断的最多继续提示轮数。" + desc_ja: "切り詰めごとの最大 continue-nudge ラウンド数。" - key: compress.reasoningGuard.maxTierN type: number default: "(built-in)" group: compress desc_en: "Upper bound on the repaired lattice tier index." desc_zh: "修复后格层索引的上限。" + desc_ja: "修復済みラティス階層インデックスの上限。" - key: compress.reasoningGuard.markerText type: string default: "\"Continue thinking...\"" group: compress desc_en: "Marker text that signals a truncated reasoning lattice." desc_zh: "标识被截断推理格的标记文本。" + desc_ja: "切り詰められた推論ラティスを示すマーカーテキスト。" - key: compress.reasoningGuard.base type: number default: "(built-in)" group: compress desc_en: "Base offset parameter of the repair lattice." desc_zh: "修复格的基础偏移参数。" + desc_ja: "修復ラティスのベースオフセットパラメータ。" - key: compress.reasoningGuard.offset type: number default: "(built-in)" group: compress desc_en: "Offset step parameter of the repair lattice." desc_zh: "修复格的偏移步长参数。" + desc_ja: "修復ラティスのオフセットステップパラメータ。" - key: compress.reasoningGuard.debugLog type: boolean default: "false" group: compress desc_en: "Verbose logging for the repair loop." desc_zh: "修复环的详细日志。" + desc_ja: "修復ループの詳細ログ出力。" - key: compress.outputSteering.enabled type: boolean default: "false" group: compress desc_en: "Enable the conciseness directive appended to the system-prompt tail." desc_zh: "启用附加在系统提示词尾部的简洁度指令。" + desc_ja: "システムプロンプト末尾に追加される簡潔性ディレクティブを有効にする。" - key: compress.outputSteering.verbosityLevel type: "number (0–4)" default: "2" group: compress desc_en: "Target verbosity level for the directive." desc_zh: "指令的目标详细程度级别。" + desc_ja: "ディレクティブの目標冗長度レベル。" - key: compress.outputSteering.effortRouting type: boolean default: "(built-in)" group: compress desc_en: "Route effort hints alongside the directive." desc_zh: "随指令一起路由 effort 提示。" + desc_ja: "ディレクティブとともに努力ヒントをルーティングする。" - key: compress.priceProfile.w type: number default: "unset (registry)" group: compress desc_en: "Write-price ratio relative to the input price." desc_zh: "写入价相对输入价的比率。" + desc_ja: "入力価格に対する書き込み価格比。" - key: compress.priceProfile.r type: number default: "unset (registry)" group: compress desc_en: "Cache-read price ratio relative to the input price." desc_zh: "缓存读价相对输入价的比率。" + desc_ja: "入力価格に対するキャッシュ読み取り価格比。" - key: compress.priceProfile.q type: number default: "unset (registry)" group: compress desc_en: "Output price ratio relative to the input price." desc_zh: "输出价相对输入价的比率。" + desc_ja: "入力価格に対する出力価格比。" - key: compress.reasoning.drop type: boolean default: "true" group: compress desc_en: "Drop finished-round reasoning runs longer than the threshold." desc_zh: "丢弃超过阈值的已结束轮次推理块。" + desc_ja: "閾値を超える長さの完了ラウンド推論実行を破棄する。" - key: compress.reasoning.threshold type: number default: "2048" group: compress desc_en: "Character threshold above which finished reasoning runs are dropped." desc_zh: "已结束推理块被丢弃的字符阈值。" + desc_ja: "完了推論実行を破棄する文字数閾値。" - key: compress.minCompressRange type: number default: "same as minCompressRangeChars" @@ -631,3 +705,4 @@ entries: deprecated: true desc_en: "Deprecated alias of minCompressRangeChars (accepted, mapped onto it)." desc_zh: "minCompressRangeChars 的弃用别名(接受,映射到后者)。" + desc_ja: "minCompressRangeChars の非推奨エイリアス(受け入れられ、それにマッピングされる)。" diff --git a/website/config-reference/diagnostics.yaml b/website/config-reference/diagnostics.yaml index 3d50b0acaf..c955d4e65a 100644 --- a/website/config-reference/diagnostics.yaml +++ b/website/config-reference/diagnostics.yaml @@ -10,6 +10,7 @@ entries: site_group: diag desc_en: "Local troubleshooting knobs (dumps, render/injection toggles, count-tokens passthrough)." desc_zh: "本地排障旋钮(转储、渲染/注入开关、count-tokens 透传)。" + desc_ja: "ローカルトラブルシューティング用ノブ(ダンプ、レンダリング/インジェクションのトグル、count-tokens のパススルー)。" site_en: "diagnostics — local troubleshooting knobs: dumpBody false · dumpReq true · rawDumpDir · dump4xx false (+MaxBytes 2 MiB) · renderNone/noInjectTool/noCompressPrompt false · countTokensPassthrough false · compressProtocol \"tools\"." site_zh: "diagnostics —— 本地排障旋钮:dumpBody false · dumpReq true · rawDumpDir · dump4xx false (+MaxBytes 2 MiB) · renderNone/noInjectTool/noCompressPrompt false · countTokensPassthrough false · compressProtocol \"tools\"。" - key: diagnostics.dumpBody @@ -19,6 +20,7 @@ entries: group: diagnostics desc_en: "Dump full request/response bodies to the log for troubleshooting. Dumps are PLAINTEXT and may contain credentials — scrub before sharing (#4482)." desc_zh: "把完整请求/响应体转储到日志用于排障。转储内容为明文,可能包含凭据——分享前必须清洗(#4482)。" + desc_ja: "トラブルシューティングのために、完全なリクエスト/レスポンスボディをログにダンプします。ダンプは PLAINTEXT であり、認証情報が含まれる可能性があります — 共有前にスクラブしてください(#4482)。" - key: diagnostics.dumpReq type: boolean default: "true" @@ -26,6 +28,7 @@ entries: group: diagnostics desc_en: "Log outgoing upstream request metadata per call; with dumpBody on, also gates the plaintext body dumps (scrub before sharing, #4482)." desc_zh: "逐次调用记录发往上游的请求元数据;开启 dumpBody 时同时是明文请求体转储的闸门(分享前必须清洗,#4482)。" + desc_ja: "呼び出しごとに送信されるアップストリームリクエストのメタデータをログに記録します。dumpBody がオンの場合、PLAINTEXT ボディのダンプも制御します(共有前にスクラブしてください、#4482)。" - key: diagnostics.rawDumpDir type: string default: "/raw" @@ -33,6 +36,7 @@ entries: group: diagnostics desc_en: "Directory for raw wire dumps." desc_zh: "原始线路转储目录。" + desc_ja: "生ワイヤダンプのディレクトリ。" - key: diagnostics.dump4xx type: boolean default: "false" @@ -40,6 +44,7 @@ entries: group: diagnostics desc_en: "Persist upstream 4xx responses to disk for post-mortem inspection. Bodies are PLAINTEXT and may contain credentials — scrub before sharing (#4482)." desc_zh: "把上游 4xx 响应落盘以便事后检查。转储内容为明文,可能包含凭据——分享前必须清洗(#4482)。" + desc_ja: "事後検証のために、アップストリームの 4xx レスポンスをディスクに永続化します。ボディは PLAINTEXT であり、認証情報が含まれる可能性があります — 共有前にスクラブしてください(#4482)。" - key: diagnostics.dump4xxMaxBytes type: number default: "2097152 (floor 1024)" @@ -47,6 +52,7 @@ entries: group: diagnostics desc_en: "Size cap for a single 4xx dump file." desc_zh: "单个 4xx 转储文件的大小上限。" + desc_ja: "単一の 4xx ダンプファイルのサイズ上限。" - key: diagnostics.maxTotalBytes type: number default: "unset (off)" @@ -54,6 +60,7 @@ entries: group: diagnostics desc_en: "Total-size cap for debug dump dirs (dumps/, raw/, SSE dump dir); oldest files deleted first when exceeded (floor 1 MiB). Dumps have no rotation by default and can grow tens of GB/day under active capture (#2412)." desc_zh: "调试转储目录(dumps/、raw/、SSE dump 目录)的总大小上限;超限时按最旧优先删除(下限 1 MiB)。转储默认无任何轮转,持续捕获下每天可增长数十 GB(#2412)。" + desc_ja: "デバッグダンプディレクトリ(dumps/、raw/、SSE ダンプディレクトリ)の総サイズ上限。超過時は最も古いファイルから削除されます(下限 1 MiB)。デフォルトではダンプにローテーションがなく、アクティブなキャプチャ下では 1 日に数十 GB まで増加する可能性があります(#2412)。" - key: diagnostics.maxAgeDays type: number default: "unset (off)" @@ -61,6 +68,7 @@ entries: group: diagnostics desc_en: "Age cap in days for debug dump dirs; files older than this are deleted (floor 1 h). Off by default." desc_zh: "调试转储目录的保留天数上限;超过该天数的文件被删除(下限 1 小时)。默认关闭。" + desc_ja: "デバッグダンプディレクトリの日数ベースの年齢上限。これより古いファイルは削除されます(下限 1 h)。デフォルトではオフです。" - key: diagnostics.logRetentionHours type: number default: "48 (floor 1)" @@ -70,6 +78,7 @@ entries: group: diagnostics desc_en: "History the PRIVATE run log (`bili.log`) is retained to cover, in hours. The logger seals the active file at 10 MiB into an immutable, uniquely named generation instead of one `bili.log.old`, so every retained generation is enumerable and the window is real rather than accidental. This is a TARGET, not a promise: `diagnostics.logBudgetBytes` is the hard bound and always wins — a shorter window is reported, never silently claimed as complete. Reported coverage is the MEASURED span from the oldest retained line to now; generation files carry no lineage evidence, so `continuity` is always `unknown` and no status claims an unbroken window (out-of-order stamps are not treated as missing history either). Floor 1 h; a non-positive or non-numeric value falls back to the 48 h default, and because a SET env var owns the switch, an illegal `BILI_LOG_RETENTION_HOURS` falls back to that default rather than to this key." desc_zh: "**私有**运行日志(`bili.log`)目标覆盖的历史小时数。日志器在 10 MiB 处把活动文件封存为**不可变、名字唯一**的一代,取代单个 `bili.log.old`,于是每一代都可枚举、窗口是真实的而不是碰巧的。这是**目标**而非承诺:`diagnostics.logBudgetBytes` 是硬上限且永远优先——更短的窗口会被如实报告,绝不悄悄宣称完整。报告的覆盖是**实测跨度**(最旧保留行 → 现在):分代文件里没有谱系证据,所以 `continuity` 恒为 `unknown`,任何状态都不宣称窗口未中断(时间戳错序同样不被当作历史缺失)。下限 1 小时;非正数或非数值回落到默认 48 小时;按「env 一旦设置即拥有该开关」的约定,非法的 `BILI_LOG_RETENTION_HOURS` 回落到该默认值而不是本键。" + desc_ja: "PRIVATE 実行ログ(`bili.log`)を保持する時間(時間単位)で、カバーする範囲を指定します。ロガーはアクティブファイルを 10 MiB でシールし、1 つの `bili.log.old` ではなく、不変で一意の名前を持つジェネレーションに変換するため、保持されるすべてのジェネレーションが列挙可能であり、ウィンドウは偶然ではなく実在のものとなります。これは TARGET であり、約束ではありません:`diagnostics.logBudgetBytes` がハードバウンドであり、常に優先されます — より短いウィンドウは報告されますが、完全にカバーされていると黙って主張されることはありません。報告されるカバレッジは、最も古い保持行から現在までの測定されたスパンです。ジェネレーションファイルには系譜のエビデンスがないため、`continuity` は常に `unknown` となり、未断絶のウィンドウを主張するステータスはありません(順序が乱れたタイムスタンプも、履歴の欠落として扱われません)。下限 1 h。正でない値または数値でない値は 48 h のデフォルトにフォールバックし、SET された環境変数がスイッチを所有するため、不正な `BILI_LOG_RETENTION_HOURS` はこのキーではなくそのデフォルトにフォールバックします。" site_en: "diagnostics.logRetentionHours — target hours of PRIVATE bili.log history (default 48, floor 1); the byte budget always wins, and reported coverage is a MEASURED span whose continuity is unknown." site_zh: "diagnostics.logRetentionHours —— 私有 bili.log 的目标历史小时数(默认 48,下限 1);字节预算永远优先,报告的覆盖是实测跨度且 continuity 恒为 unknown。" - key: diagnostics.logBudgetBytes @@ -81,6 +90,7 @@ entries: group: diagnostics desc_en: "Hard total-byte budget across the active log plus every sealed generation; oldest generations are deleted first when it is exceeded — oldest first by sealed stamp (legacy `.old` takes its own mtime), so a migrated legacy artifact is reclaimed in its real chronological place instead of being skipped in favour of newer stamped generations. Bounds disk cost and privacy exposure on a busy machine where the default window would otherwise run to many times this. When the bytes needed for `logRetentionHours` exceed the budget, the BUDGET WINS and the shortfall is surfaced (a start-time `[warn]`, and the `retention` object in `GET /__bili/logs`). The ACTIVE file is never deleted, so a single active file that alone exceeds the budget is reported as over budget rather than truncated. Floor 1 MiB; a non-positive or non-numeric value falls back to the 256 MiB default, and a set `BILI_LOG_BUDGET_BYTES` owns the switch the same way as the hours key. Files are owner-only: 0600 from the first byte, archive directories 0700 (win32 has no POSIX mode bits and the state-dir ACL governs)." desc_zh: "活动日志 + 全部封存分代的总字节硬预算;超出时按**最旧优先**整代删除——排序按封存时间戳(遗留 `.old` 用自己的 mtime),所以迁移来的历史按其真实年代被回收,而不会被跳过、先去删更新的分代。它约束繁忙机器上的磁盘占用与隐私暴露面。当 `logRetentionHours` 所需的字节超出预算时**预算赢**,且不足会被上报(启动时一行 `[warn]`,以及 `GET /__bili/logs` 里的 `retention` 对象)。活动文件永不删除,所以单个活动文件本身就超过预算时会被报告为超预算,而不是被截断。下限 1 MiB;非正数或非数值回落到默认 256 MiB,且与小时键同理:设置了的 `BILI_LOG_BUDGET_BYTES` 拥有该开关。日志文件仅属主可读:首字节起 0600,归档目录 0700(win32 无 POSIX 权限位,由状态目录 ACL 决定)。" + desc_ja: "アクティブログおよびすべてのシール済みジェネレーション全体でのハードな総バイト予算。超過時は最も古いジェネレーションから削除されます — シール済みタイムスタンプ順に最も古いものから(レガシーの `.old` は独自の mtime を採用)ため、移行されたレガシー成果物は新しいタイムスタンプ付きジェネレーションを優先してスキップされるのではなく、実際の年代順の位置で回収されます。デフォルトのウィンドウがこれの何倍にも及ぶ多忙なマシンにおいて、ディスクコストとプライバシーリスクを制限します。`logRetentionHours` に必要なバイト数が予算を超える場合、BUDGET が優先され、不足分が表面化します(開始時の `[warn]`、および `GET /__bili/logs` の `retention` オブジェクト)。ACTIVE ファイルは決して削除されないため、単一のアクティブファイルが予算を単独で超過する場合、切り詰められるのではなく予算超過として報告されます。下限 1 MiB。正でない値または数値でない値は 256 MiB のデフォルトにフォールバックし、設定された `BILI_LOG_BUDGET_BYTES` は時間キーと同様にスイッチを所有します。ファイルは所有者のみアクセス可能:最初のバイトから 0600、アーカイブディレクトリは 0700(win32 には POSIX モードビットがなく、state-dir の ACL が支配します)。" site_en: "diagnostics.logBudgetBytes — hard total-byte budget across the active log + all sealed generations (default 256 MiB, floor 1 MiB); oldest-first eviction, the active file is never deleted, and this budget beats logRetentionHours." site_zh: "diagnostics.logBudgetBytes —— 活动日志 + 全部封存分代的总字节硬预算(默认 256 MiB,下限 1 MiB);最旧优先回收、活动文件永不删除,且该预算优先于 logRetentionHours。" - key: diagnostics.renderNone @@ -90,6 +100,7 @@ entries: group: diagnostics desc_en: "Disable all ACP tag rendering (raw wire study mode)." desc_zh: "禁用所有 ACP 标签渲染(原始线路研究模式)。" + desc_ja: "すべての ACP タグレンダリングを無効化します(生ワイヤ研究モード)。" - key: diagnostics.invariantJudge type: boolean default: "true" @@ -97,6 +108,7 @@ entries: group: diagnostics desc_en: "Keep the I1/I2 outbound-invariant judge armed as an L1 advisory (#3938): every request's outbound bytes are reconciled against the client's inbound history; violations log at warn, clean verdicts at debug, traffic is never blocked. Set false or BILI_INVARIANT_JUDGE=0 to silence it." desc_zh: "保持 I1/I2 出站不变量判官以 L1 advisory 形态开启(#3938):每笔请求的出站字节都与客户端入站历史对账,违规以 warn 记录、干净判定以 debug 记录,绝不阻塞流量。设为 false 或 BILI_INVARIANT_JUDGE=0 可静默。" + desc_ja: "I1/I2 送信不変性ジャッジを L1 アドバイザリーとして武装したままにします(#3938):すべてのリクエストの送信バイトがクライアントの受信履歴と照合されます。違反は warn でログに記録され、クリーンな判定は debug で記録され、トラフィックはブロックされません。無効にするには false を設定するか BILI_INVARIANT_JUDGE=0 を設定してください。" - key: diagnostics.noInjectTool type: boolean default: "false" @@ -104,6 +116,7 @@ entries: group: diagnostics desc_en: "Stop injecting the acp_compress tool definition into requests." desc_zh: "停止向请求注入 acp_compress 工具定义。" + desc_ja: "リクエストへの acp_compress ツール定義のインジェクションを停止します。" - key: diagnostics.noCompressPrompt type: boolean default: "false" @@ -111,6 +124,7 @@ entries: group: diagnostics desc_en: "Stop appending the compression doctrine to system prompts." desc_zh: "停止向系统提示词附加压缩教条文本。" + desc_ja: "システムプロンプトへの圧縮教義の追加を停止します。" - key: diagnostics.countTokensPassthrough type: boolean default: "false" @@ -118,6 +132,7 @@ entries: group: diagnostics desc_en: "Forward /v1/messages/count_tokens to the upstream instead of answering locally." desc_zh: "把 /v1/messages/count_tokens 转发给上游,而不是本地应答。" + desc_ja: "ローカルで応答する代わりに、/v1/messages/count_tokens をアップストリームにフォワードします。" - key: diagnostics.compressProtocol type: "\"tools\" | \"marker\"" default: "\"tools\"" @@ -125,6 +140,7 @@ entries: group: diagnostics desc_en: "ACP injection surface for compression: native tools (default) or legacy prompt markers." desc_zh: "压缩的 ACP 注入面:原生工具(默认)或旧版提示词标记。" + desc_ja: "圧縮用の ACP 注入サーフェス: ネイティブツール (デフォルト) またはレガシープロンプトマーカー。" - key: fakeCompletion type: object default: "{} (all defaults)" @@ -133,6 +149,7 @@ entries: site_group: diag desc_en: "Retry loop that re-requests when a final chunk arrives truncated." desc_zh: "末块被截断时重新发起请求的重试环。" + desc_ja: "最終チャンクが切り詰められて到着した際に再リクエストを行うリトライループ。" site_en: "fakeCompletion — retry loop for truncated final chunks: retries 0 (opt-in) · bufCapBytes 16 MiB." site_zh: "fakeCompletion —— 被截断末块的补完成重试环:retries 0 (可选) · bufCapBytes 16 MiB。" - key: fakeCompletion.retries @@ -142,6 +159,7 @@ entries: group: diagnostics desc_en: "How many times a truncated final completion may be re-requested; 0 disables the loop." desc_zh: "被截断的末块完成可被重新请求的次数;0 禁用该重试环。" + desc_ja: "切り詰められた最終完了を再リクエストできる回数; 0 でループを無効化。" - key: fakeCompletion.bufCapBytes type: number default: "16777216" @@ -149,6 +167,7 @@ entries: group: diagnostics desc_en: "Buffer size cap for the retry loop's accumulated stream." desc_zh: "重试环累积流缓冲的大小上限。" + desc_ja: "リトライループの累積ストリームに対するバッファサイズ上限。" - key: codexCompact type: "\"intercept\" | \"pass\"" default: "\"intercept\"" @@ -158,6 +177,7 @@ entries: site_group: adv desc_en: "Handle Codex's compaction requests inside bili (intercept, default) or forward them upstream (pass): the explicit forms (compaction_trigger + /responses/compact) and the inline auto-compact that transits as an ordinary turn, detected by its SUMMARIZATION_PROMPT template (#3008) — a user-overridden compact_prompt falls out of detection and transits verbatim; a compaction bili only observed (pass/gate) is rebased post-hoc (#2372)." desc_zh: "在 bili 内处理 Codex 的压缩请求(intercept,默认)还是转给上游(pass):覆盖显式形态(compaction_trigger + /responses/compact)与以普通请求形态过线的内联自动压缩(按 SUMMARIZATION_PROMPT 模板检测,#3008)—— 用户自定义 compact_prompt 后锚点失配、按原样转发;bili 仅旁路观察到的压缩(pass/安全阀放行)走事后 rebase(#2372)。" + desc_ja: "bili 内で Codex のコンパクト化要求を処理する (intercept, デフォルト) または上流へ転送する (pass): 明示的な形式 (compaction_trigger + /responses/compact) と、通常のターンとして通過するインライン自動コンパクト化 (SUMMARIZATION_PROMPT テンプレート (#3008) によって検出) — ユーザーが上書きした compact_prompt は検出から外れ、そのまま通過する; bili が観察のみ (pass/gate) したコンパクト化は事後にリベースされる (#2372)。" site_en: "codexCompact — intercept | pass (default intercept): handle Codex's compaction requests in bili or forward upstream — explicit forms plus the inline auto-compact transiting as an ordinary turn (prompt-form detection, #3008; overridden compact_prompt transits verbatim)." site_zh: "codexCompact —— intercept | pass(默认 intercept):在 bili 内处理 Codex 压缩请求或转给上游 —— 显式形态 + 以普通请求形态过线的内联自动压缩(prompt 文本检测,#3008;自定义 compact_prompt 按原样转发)。" - key: ccrRetrievalTtlMs @@ -169,6 +189,7 @@ entries: site_group: adv desc_en: "Lifetime of CCR retrieval pointers before originals stop being fetchable via acp_retrieve." desc_zh: "CCR 回取指针的有效期,过期后原文不再可通过 acp_retrieve 取回。" + desc_ja: "acp_retrieve 経由でオリジナルを取得できなくなるまでの CCR 検索ポインタの生存期間。" site_en: "ccrRetrievalTtlMs — lifetime of CCR retrieval pointers (default 600000; 0 disables retrieval)." site_zh: "ccrRetrievalTtlMs —— CCR 回取指针有效期(默认 600000;0 禁用回取)。" - key: decompressTmpCap @@ -180,5 +201,6 @@ entries: site_group: adv desc_en: "Size cap (blocks) for temporary decompressed content held in-session." desc_zh: "会话内临时展开内容的大小上限(按块计)。" + desc_ja: "セッション内で保持される一時的な展開済みコンテンツのサイズ上限 (ブロック数)。" site_en: "decompressTmpCap — size cap for temporary decompressed blocks (default 50)." site_zh: "decompressTmpCap —— 临时展开块的大小上限(默认 50)。" diff --git a/website/config-reference/env-only.yaml b/website/config-reference/env-only.yaml index bcf15edb15..c26a83cd97 100644 --- a/website/config-reference/env-only.yaml +++ b/website/config-reference/env-only.yaml @@ -10,6 +10,7 @@ entries: group: envonly desc_en: "Let bili ANSWER dsh compaction summarize calls locally with the folded snapshot instead of refusing (#3733): identity header + kernel-rendered block summaries, zero egress; replay recognized via the #2432 rebase." desc_zh: "让 bili 本地应答 dsh 压缩摘要请求(返回折叠快照而非拒绝,#3733):身份头 + 内核渲染格式的块摘要,零出口流量;重放经 #2432 再基线识别。" + desc_ja: "bili が dsh のコンパクト化要約呼び出しを拒否する (#3733) 代わりに、折り畳みスナップショットでローカルに ANSWER する: アイデンティティヘッダー + カーネルレンダリングされたブロック要約、ゼロエグレス; リプレイは #2432 リベースによって認識される。" - key: BILI_DSH_CONTEXT_TAB type: boolean default: "true" @@ -18,6 +19,7 @@ entries: group: envonly desc_en: "Env tier for dsh.contextTab (#4237): 0/false removes the DSH top-bar 「上下文」/「Context」 tab (everything else keeps working); any other value forces it on over the file tier; unset = file tier applies (default true). Takes effect on next page load / dsh restart." desc_zh: "dsh.contextTab 的 env 层(#4237):0/false 移除 DSH 顶栏「上下文」标签页(其余一切照常工作);其他取值强制开启并覆盖文件层;缺省 = 按文件层取值(默认 true)。下次页面加载 / dsh 重启生效。" + desc_ja: "dsh.contextTab (#4237) の環境変数ティア: 0/false で DSH トップバーの「上下文」/「Context」タブを削除 (その他はすべて動作維持); その他の値はファイルティアを上書きして強制オン; 未設定 = ファイルティアが適用 (デフォルト true)。次のページ読み込み / dsh 再起動時に有効化。" - key: BILI_DSH_MAX_TESTED_VERSION type: string default: "0.2.0-rc.2 (CI e2e anchor)" @@ -26,6 +28,7 @@ entries: group: envonly desc_en: "Newest-tested @deepseek-ai/dsh build behind the dsh native lane's boot note (#4545): the running client build is resolved from the nearest node_modules/@deepseek-ai/dsh/package.json above the injected bundle; being STRICTLY NEWER than this cap earns ONE boot-time note (durable log record + banner) advising roll-back until support lands. One direction only — at-or-below-cap builds stay silent (known older-build break modes have their own overlay-latch detectors). Warns only — never gates or blocks traffic. Move the cap up as builds get verified; an EMPTY string turns the check off for this lane. Unresolvable/unparseable versions fail open to silence." desc_zh: “dsh native lane 启动提示的“我们测过的最高版本”上限(#4545):从注入包上方最近的 node_modules/@deepseek-ai/dsh/package.json 读出运行中的构建,**严格高于**上限才弹一条启动提示(持久日志 + 横幅),建议先回滚到上限版本。只覆盖"更新"一个方向:≤ 上限保持静默(旧版已知坏法有专门的失锁探测)。只提示、绝不拦截或阻断流量;新版本验证通过后抬高上限,空字符串 = 关闭本 lane 检查;读不到/解析不了的版本按静默处理。” + desc_ja: "dsh ネイティブレーンのブートノート (#4545) 背後にある最新テスト済み @deepseek-ai/dsh ビルド: 実行中のクライアントビルドは、注入バンドルより上位の最も近い node_modules/@deepseek-ai/dsh/package.json から解決される; この上限より厳密に新しい場合、サポートが実装されるまでロールバックを推奨するブート時のノート (永続ログ記録 + バナー) が 1 回発行される。片方向のみ — 上限以下または等しいビルドは沈黙する (既知の旧ビルド破損モードには独自のオーバーレイラッチ検出器がある)。警告のみ — トラフィックをゲートまたはブロックしない。ビルドが検証されるにつれて上限を引き上げる; 空文字列はこのレーンでのチェックをオフにする。解決不能/解析不能なバージョンは沈黙に向けてオープンに失敗する。" - key: BILI_IDENTITY_HARVEST type: string default: "off" @@ -34,6 +37,7 @@ entries: group: envonly desc_en: "Rollout-gated loopback harvest of client-local transcripts/sqlite for stable message-id lanes (#5825). Unset/empty = OFF (fully inert). `all` or a comma list of source ids (`claude,codebuddy,mcode`) enables matching sources for requests whose identity is loopback; every match also requires the `pluginLaneServerHistory` rollout to be ON. Anything undecidable degrades to the pre-wiring path for the whole turn — never a partial mapping. Dev/verification switch by design (the lanes are already safe per client), not a tuning knob." desc_zh: "#5825 身份信道接线的采集开关(灰度门控下的回环本地转录/SQLite 采集):缺省关闭、完全惰性;`all` 或逗号列表(`claude,codebuddy,mcode`)开启对应来源,且仅对回环身份请求生效,同时要求 pluginLaneServerHistory 灰度为开。任何无法判定的情形整轮退化为接线前路径,绝不做部分映射。设计上是开发/验证开关而非调参旋钮。" + desc_ja: "安定したメッセージ ID レーン (#5825) 向けクライアントローカルトランスクリプト/sqlite のロールアウトゲート付きループバックハーベスト。未設定/空 = OFF (完全に不活性)。`all` またはソース ID のカンマ区切りリスト (`claude,codebuddy,mcode`) は、アイデンティティがループバックであるリクエストの一致するソースを有効化する; すべての一致には `pluginLaneServerHistory` ロールアウトが ON であることも必要。判定不能なものは、ターン全体で配線前のパスにデグレード — 部分的なマッピングは決して行われない。設計上の開発/検証スイッチ (レーンはすでにクライアントごとに安全であるため)、調整ノブではない。" - key: BILI_STORAGE_BACKEND type: "sqlite|mysql" default: "sqlite" @@ -42,6 +46,7 @@ entries: group: envonly desc_en: "Env tier for storage.backend (#3931): sqlite (default) or mysql (fully wired, #3388 steps 2+3 - saves ingest through the async shadow queue, sync reads ride the JSON envelope, replicas/ext/GC/fork via the async twins (#4911); export too). Wins over the file tier." desc_zh: "storage.backend 的环境变量层(#3931):sqlite(默认)或 mysql(已接线,#3388 第二+三步 —— 保存经异步影子队列入 mysql,同步读走 JSON 信封,replicas/ext/GC/fork 走异步孪生(#4911);export 同样支持)。优先于文件层。" + desc_ja: "storage.backend (#3931) の環境変数ティア: sqlite (デフォルト) または mysql (完全配線済み, #3388 ステップ 2+3 - 非同期シャドウキュー経由でインジェストを保存、同期読み取りは JSON エンベロープに乗る、レプリカ/拡張/GC/フォークは非同期ツイン経由 (#4911); エクスポートも)。ファイルティアに優先する。" - key: BILI_MYSQL_DSN type: string default: "unset" @@ -50,6 +55,7 @@ entries: group: envonly desc_en: "MySQL DSN (mysql://user:pass@host:3306/db) for storage.backend=\"mysql\" (#3388, #3931). Wins over the file key storage.mysql.dsn. Empty = the mysql backend cannot open; the documented error names both knobs. The pool opens lazily; closeQuietlyAsync drains the ingest queue and closes it." desc_zh: "storage.backend=\"mysql\" 的 MySQL DSN(mysql://user:pass@host:3306/db)(#3388,#3931)。优先于文件键 storage.mysql.dsn。留空 = mysql 后端无法打开;文档化错误会列出两个旋钮。连接池惰性打开;closeQuietlyAsync 排空入队事务并关闭。" + desc_ja: "storage.backend=\"mysql\" (#3388, #3931) 用の MySQL DSN (mysql://user:pass@host:3306/db)。ファイルキー storage.mysql.dsn に優先する。空 = mysql バックエンドが開けない; 文書化されたエラーは両方のノブを名指しする。プールは遅延で開かれる; closeQuietlyAsync はインジェストキューをドレインして閉じる。" - key: BILI_STORAGE_ARCHIVE_AFTER_DAYS type: integer default: "365" @@ -58,6 +64,7 @@ entries: group: envonly desc_en: "GC age sweep window in days (#3463): sessions idle longer than this are archived (one JSON line appended to the single archive log (archive/archive.jsonl) + tombstone row + content/media refs released). 0 disables the age sweep; the manual entry POST /__bili/storage/gc always runs. Config-file key storage.archiveAfterDays is the persistent form." desc_zh: "GC 年龄清扫窗口(天,#3463):闲置超过该时长的会话被归档(单文件归档日志 archive/archive.jsonl 追加一行 + 墓碑行保留标签 + 释放内容/媒体引用)。0 关闭年龄清扫;手动入口 POST /__bili/storage/gc 始终可用。配置文件键 storage.archiveAfterDays 为持久形式。" + desc_ja: "GC 年齢スウィープウィンドウ (日) (#3463): これより長くアイドル状態のセッションはアーカイブされる (単一のアーカイブログ (archive/archive.jsonl) に 1 行の JSON が追記 + トombstone 行 + コンテンツ/メディア参照の解放)。0 で年齢スウィープを無効化; 手動エントリ POST /__bili/storage/gc は常に実行される。設定ファイルキー storage.archiveAfterDays が永続形式である。" - key: BILI_STORAGE_QUICK_CHECK type: string default: "on" @@ -66,6 +73,7 @@ entries: desc_zh: "存储开库自检(#4175):每次 index.db 打开在迁移之前先跑 PRAGMA quick_check;一旦由本次启动自己的扫描证实损坏,文件原样保留在原地——不做任何自动搬移、复制或重建(自动恢复已撤回:BILI_STORAGE_JSON_WRITER=off 时索引是唯一的持久副本,自动操作无法保证完整数据恢复)——bili 照常启动,改用 JSON 信封服务,并给出响亮、可操作的告警指明手工修复步骤(备份后把 index.db/-wal/-shm 手工移开再启动——全新索引会从 JSON 信封重建)。PASS 判定会被缓存,之后的启动跳过重扫;FAIL 判定永不持久化(2026-10-30 owner 策略):运行期/后台发现只是告警(响亮日志 + runtime-status,进程继续服务——JSON 信封始终是恢复来源),每次启动都对当前文件集做新鲜扫描再判定,旧版本遗留的陈旧 FAIL 永远不能阻断后续启动。既没有自动改名/修复,也没有 legacy-only 兜底(继续以 legacy-only 运行会让 JSON 信封与死掉的索引永久分叉、再无对账可能)。瞬态打开失败(无引擎 / CANTOPEN / 只读 / 后端 DSN)仍响亮地拒绝启动并给出可操作的错误——环境类问题同样不允许静默走 legacy 兜底(活的第二写者已于 2026-10-31 移出该拒绝清单:多进程共享一个本地盘 index.db 是受支持拓扑,只提示、永不阻断启动);真正需要纯 JSON 服务的部署请显式设置 BILI_STORAGE_UNIFIED=legacy(或留空)。仅当超大部署对启动耗时敏感、检测成本构成问题时才设 0 跳过。" group: envonly desc_en: "Storage integrity self-check at open (#4175): every index.db open runs PRAGMA quick_check BEFORE migrations; if a corruption is PROVEN by THIS BOOT's own scan NOTHING is moved, copied or rebuilt automatically (auto-recovery was withdrawn #4609/#4626-era: with BILI_STORAGE_JSON_WRITER=off the index is the SOLE durable copy, so an automatic move or rebuild cannot guarantee full data recovery) and bili STARTS ANYWAY — serving from the JSON envelopes with a loud, actionable alarm naming the manual fix (back up then move index.db/-wal/-shm aside BY HAND, then start again — a fresh index rebuilds from the JSON envelopes). A successful PASS is cached so later starts skip the rescan; a FAIL verdict is NEVER persisted (2026-10-30 owner policy): runtime/background findings are alarms only (loud logs + runtime-status, the process keeps serving — JSON envelopes remain the recovery source) and every boot decides again from a fresh scan of the CURRENT file set, so a stale FAIL left behind by an older version can never block future boots. There is NO automatic rename/repair AND no legacy-only fallback: continuing legacy-only would fork the JSON envelopes from the dead index forever (never reconcilable). TRANSIENT open failures (no SQLite engine / CANTOPEN / readonly / backend DSN) make bili REFUSE TO START loudly with an actionable error — no silent legacy fallback for environment problems either (2026-10-30 owner policy; a live second writer left this refusal list on 2026-10-31 — sharing one local-disk index.db is the supported topology, informational only, never blocking); deployments that genuinely want JSON-only serve explicitly (BILI_STORAGE_UNIFIED=legacy or unset). Set 0 only for boot-time-sensitive huge deployments where the check's cost matters." + desc_ja: "オープン時のストレージ整合性セルフチェック (#4175): すべての index.db オープン時にマイグレーション前に PRAGMA quick_check を実行; このブートのスキャンによって破損が証明された場合、何も自動的に移動、コピー、再構築されない (自動回復は #4609/#4626 時代に撤回: BILI_STORAGE_JSON_WRITER=off ではインデックスが唯一の永続コピーであり、自動的な移動または再構築では完全なデータ回復を保証できないため) かつ bili はそれでも起動する — JSON エンベロープからサーブし、手動修正 (バックアップしてから index.db/-wal/-shm を手動で退避し、再起動 — 新しいインデックスは JSON エンベロープから再構築される) を名指しする大きくて実行可能なアラームを発する。成功した PASS はキャッシュされ、後の起動で再スキャンをスキップする; FAIL 判定は決して永続化されない (2026-10-30 オーナーポリシー): ランタイム/バックグラウンドの発見はアラームのみ (大きなログ + ランタイムステータス、プロセスはサーブを継続 — JSON エンベロープは回復ソースのまま) であり、すべてのブートは現在のファイルセットの新しいスキャンから再決定するため、古いバージョンが残した古い FAIL が将来のブートをブロックすることは決してない。自動リネーム/修復もレガシー専用フォールバックもない: レガシー専用で続行すると、JSON エンベロープが死んだインデックスから永遠に分岐する (決して調整不能)。一時的なオープン失敗 (SQLite エンジンなし / CANTOPEN / 読み取り専用 / バックエンド DSN) は、実行可能なエラーで bili が大きく起動を拒否する — 環境問題に対するサイレントレガシーフォールバックもない (2026-10-30 オーナーポリシー; ライブな第二ライターがこの拒否リストを 2026-10-31 に残した — 1 つのローカルディスク index.db を共有することはサポートされるトポロジーであり、情報提供のみ、決してブロックしない); 真に JSON のみでサーブしたいデプロイは明示的に設定する (BILI_STORAGE_UNIFIED=legacy または未設定)。チェックのコストが重要なブート時感度の高い巨大デプロイでのみ 0 を設定する。" - key: BILI_SNAPSHOT_SHADOW type: boolean default: "true (on)" @@ -74,6 +82,7 @@ entries: group: envonly desc_en: "Snapshot-render shadow observability (#3756 follow-up): compute the outbound snapshot view on every armed turn WITHOUT using it, classify the diff against the legacy outbound, and surface per-session counters in the web panel + the snapshot-shadow diagnostics topic. 0/false/off disables; 1/true/on enables; otherwise the config-file snapshot.shadow boolean applies (default on). The render lane itself stays rollout-gated (BILI_ROLLOUT_SNAPSHOT_RENDER), so the shadow lane never changes outbound bytes - it is the dry-run evidence that flips the rollout later." desc_zh: "快照渲染影子对账(#3756 后续):每轮已折叠会话都用引擎现算一次出站快照视图但不使用,与 legacy 实际出站比对分类,逐会话计数进 web 面板与 snapshot-shadow 诊断主题。0/false/off 关闭;1/true/on 开启;否则读配置文件 snapshot.shadow 布尔(默认开)。渲染车道本身仍受灰度开关控制(BILI_ROLLOUT_SNAPSHOT_RENDER),影子车道绝不改变出站字节 —— 它是后续翻转灰度的干跑证据。" + desc_ja: "スナップショットレンダリングのシャドウ観測可能性(#3756 のフォローアップ): アームされたターンごとに送信スナップショットビューを計算するが使用せず、レガシー送信との差分を分類し、セッションごとのカウンターを Web パネルおよびスナップショットシャドウ診断トピックに表示する。0/false/off で無効化、1/true/on で有効化、それ以外の場合は設定ファイルの snapshot.shadow ブール値が適用される(デフォルトは on)。レンダリングレーン自体はロールアウトゲート(BILI_ROLLOUT_SNAPSHOT_RENDER)で制御されるため、シャドウレーンは送信バイト列を変更しない - これは後日のロールアウトを切り替えるためのドライラン証拠である。" - key: BILI_CONFIG_FILE type: string default: "unset (XDG config path)" @@ -82,6 +91,7 @@ entries: group: envonly desc_en: "Override the config file path (path relocation)." desc_zh: "覆盖配置文件路径(路径重定位)。" + desc_ja: "設定ファイルのパスを上書きする(パスの再配置)。" - key: BILI_SESSIONS_DIR type: string default: "unset (XDG state path)" @@ -90,6 +100,7 @@ entries: group: envonly desc_en: "Where session records are stored (path relocation)." desc_zh: "会话记录的存放目录(路径重定位)。" + desc_ja: "セッションレコードの保存先(パスの再配置)。" - key: BILI_ENCRYPTION_KEY type: string default: "unset" @@ -98,6 +109,7 @@ entries: group: envonly desc_en: "Key material for encrypted persisted payloads (secret)." desc_zh: "加密持久化载荷的密钥材料(机密)。" + desc_ja: "暗号化された永続化ペイロード用の鍵材料(シークレット)。" - key: BILI_TUNNEL_ALLOWED_HOSTS type: "string[] (csv)" default: "unset" @@ -106,6 +118,7 @@ entries: group: envonly desc_en: "Host allowlist for the MITM tunnel lane." desc_zh: "MITM 隧道车道的主机白名单。" + desc_ja: "MITM トンネルレーン用のホスト許可リスト。" - key: BILI_RECLAIM_FETCH_PATCH type: boolean-ish default: "on" @@ -114,6 +127,7 @@ entries: group: envonly desc_en: "Toggle for reclaiming the global fetch patch on shutdown." desc_zh: "进程退出时回收全局 fetch 补丁的开关。" + desc_ja: "シャットダウン時にグローバル fetch パッチを回収するためのトグル。" - key: BILI_CONFLICT_SCAN type: boolean-ish default: "off" @@ -122,6 +136,7 @@ entries: group: envonly desc_en: "Enable the install-lane conflict scanner probe." desc_zh: "启用安装车道冲突扫描探针。" + desc_ja: "インストールレーンの競合スキャナープローブを有効にする。" - key: BILI_CHAIN_MAX_FUTURE_SKEW_MS type: number default: "(built-in)" @@ -130,6 +145,7 @@ entries: group: envonly desc_en: "Tolerance for future-skewed chain checkpoint timestamps." desc_zh: "链检查点时间戳未来偏移的容忍度。" + desc_ja: "未来にずれたチェーンチェックポイントタイムスタンプの許容範囲。" - key: BILI_CHAIN_RECENT_WINDOW_MS type: number default: "(built-in)" @@ -138,6 +154,7 @@ entries: group: envonly desc_en: "Recent-window size for chain checkpoint validation." desc_zh: "链检查点校验的近期窗口大小。" + desc_ja: "チェーンチェックポイント検証用の最近ウィンドウサイズ。" - key: BILI_ZONE_PORT type: number default: "18787 base (derived per lane)" @@ -146,6 +163,7 @@ entries: group: envonly desc_en: "Base port for lane-spawned proxy zones (port relocation)." desc_zh: "车道派生代理端口区的基础端口(端口重定位)。" + desc_ja: "レーン生成プロキシゾーン用のベースポート(ポートの再配置)。" - key: BILI_ZCODE_ROUTE type: string default: "unset" @@ -154,6 +172,7 @@ entries: group: envonly desc_en: "Route selection for the zcode lane." desc_zh: "zcode 车道的路由选择。" + desc_ja: "zcode レーン用のルート選択。" - key: BILI_ZCODE_PORT type: number default: "unset" @@ -162,6 +181,7 @@ entries: group: envonly desc_en: "Port pin for the zcode lane." desc_zh: "zcode 车道的端口钉死。" + desc_ja: "zcode レーン用のポート固定。" - key: BILI_ZCODE_SIGNING_FIXED type: boolean-ish default: "off" @@ -170,6 +190,7 @@ entries: group: envonly desc_en: "Fixed-signing mode for the zcode credential lane." desc_zh: "zcode 凭据车道的固定签名模式。" + desc_ja: "zcode 認証情報レーン用の固定署名モード。" - key: BILI_CLAUDE_UPSTREAM type: string default: "unset" @@ -178,6 +199,7 @@ entries: group: envonly desc_en: "Upstream pin for the claude lane." desc_zh: "claude 车道的上游钉死。" + desc_ja: "claude レーン用のアップストリーム固定。" - key: BILI_CODEX_STATE_MODE type: string default: "auto" @@ -186,6 +208,7 @@ entries: group: envonly desc_en: "codex state handling: auto (shared db via CODEX_SQLITE_HOME on modern codex, legacy overlay copies otherwise), shared, or legacy. Shared mode runs up to 16 concurrent sessions, one per-session overlay slot each; legacy keeps one exclusive overlay at a time." desc_zh: "codex 状态处理方式:auto(新版 codex 走 CODEX_SQLITE_HOME 共享库,旧版回退 overlay 副本)、shared、legacy。shared 模式最多 16 个并发会话,每会话一个独立 overlay 槽位;legacy 保持一次仅一个独占 overlay。" + desc_ja: "codex 状態の処理: auto(モダン codex では CODEX_SQLITE_HOME 経由の共有 DB、それ以外はレガシーオーバーレイコピー)、shared、または legacy。shared モードでは最大 16 個の並行セッションを処理し、それぞれに 1 つのセッション別オーバーレイスロットを使用する。legacy は同時に 1 つの排他オーバーレイを保持する。" - key: BILI_ATTACH_HEALTH_DEADLINE_MS type: number default: "(built-in)" @@ -194,6 +217,7 @@ entries: group: envonly desc_en: "Deadline for attach health checks when joining an external daemon." desc_zh: "挂接外部守护进程时健康检查的截止时间。" + desc_ja: "外部デーモンに参加する際のヘルスチェック接続の期限。" - key: BILI_SPAWN_WAIT_MS type: number default: "(built-in)" @@ -202,6 +226,7 @@ entries: group: envonly desc_en: "Initial health-wait window (ms) for a freshly spawned proxy child before the launcher extends the wait." desc_zh: "新派生的代理子进程在启动器延长等待之前的初始健康等待窗口(毫秒)。" + desc_ja: "新規に生成されたプロキシ子プロセスについて、ランチャーが待機を延長するまでの初期ヘルスウェイトウィンドウ(ms)。" - key: BILI_SLOW_START_GRACE_MS type: number default: "(built-in)" @@ -210,6 +235,7 @@ entries: group: envonly desc_en: "Extra grace (ms) for a still-alive child that is slow to bind (slow store, AV scan, shared-store lock contention); the total spawn budget is the sum of the two." desc_zh: "对仍存活但仍在启动(慢速存储、杀毒扫描、共享存储锁竞争)的子进程的额外宽限(毫秒);总启动预算为两者之和。" + desc_ja: "まだ生存しているがバインドが遅い子プロセス(低速ストレージ、AVスキャン、共有ストレージのロック競合など)に対する追加の猶予時間(ms)。生成の総予算はこれら2つの合計である。" - key: BILI_ATTACH_EVIDENCE_GRACE_MS type: number default: "(built-in)" @@ -218,6 +244,7 @@ entries: group: envonly desc_en: "Grace period for attach ownership evidence." desc_zh: "挂接归属证据的宽限期。" + desc_ja: "アタッチ所有権の証拠に対する猶予期間。" - key: BILI_SILENT_DIRECT_MAX_MB type: number default: "(built-in)" @@ -226,6 +253,7 @@ entries: group: envonly desc_en: "Silent-direct oversized guard ceiling (MiB)." desc_zh: "静默直连超大请求保护上限(MiB)。" + desc_ja: "サイレントダイレクトの過大ガード上限(MiB)。" - key: BILI_PROVIDER_REWRITES type: string default: "unset" @@ -234,6 +262,7 @@ entries: group: envonly desc_en: "Provider URL rewrite rules applied before routing." desc_zh: "路由前应用的 provider URL 重写规则。" + desc_ja: "ルーティング前に適用されるプロバイダーURL書き換えルール。" - key: BILI_MCP_PROXY type: string default: "unset" @@ -242,6 +271,7 @@ entries: group: envonly desc_en: "Spawn channel: MCP proxy target for plugin-hosted tools." desc_zh: "派生通道:插件宿主工具的 MCP 代理目标。" + desc_ja: "生成チャネル:プラグインホスト型ツールのMCPプロキシターゲット。" - key: BILI_PARENT_PID type: number default: "unset" @@ -250,6 +280,7 @@ entries: group: envonly desc_en: "Spawn channel: parent process id for lifecycle supervision." desc_zh: "派生通道:父进程 id,用于生命周期监管。" + desc_ja: "生成チャネル:ライフサイクル監視用の親プロセスID。" - key: BILI_STRICT_PORT type: number default: "unset" @@ -258,6 +289,7 @@ entries: group: envonly desc_en: "Spawn channel: exact-port requirement (squatters refused loudly instead of hopping)." desc_zh: "派生通道:精确端口要求(被占用时响亮拒绝而非跳端口)。" + desc_ja: "生成チャネル:正確なポート要件(スキャッターはホッピングせず、明確に拒否される)。" - key: BILI_UPGRADE_REPLACEMENT type: boolean-ish default: "unset" @@ -266,6 +298,7 @@ entries: group: envonly desc_en: "Spawn channel: marks a self-restart replacement — it must own exactly the freed port or exit without hopping (#3044)." desc_zh: "派生通道:标记自重启替换进程——必须独占被释放的精确端口,否则直接退出而非跳端口(#3044)。" + desc_ja: "生成チャネル:自己再起動による置換をマークする — 解放されたポートを正確に所有するか、ホッピングせずに終了しなければならない(#3044)。" - key: BILI_OPENCODE_ACP_SPEC type: string default: "unset" @@ -274,6 +307,7 @@ entries: group: envonly desc_en: "Spawn channel: ACP spec marker for opencode-native lanes." desc_zh: "派生通道:opencode 原生车道的 ACP 规格标记。" + desc_ja: "生成チャネル:opencodeネイティブレーン用のACP仕様マーカー。" - key: BILI_LAUNCHER_MODEL_WINDOWS type: string default: "unset" @@ -282,6 +316,7 @@ entries: group: envonly desc_en: "Launcher channel: model-window overrides passed into spawned clients." desc_zh: "启动器通道:传入被派生客户端的模型窗口覆盖。" + desc_ja: "ランチャーチャネル:生成されたクライアントに渡されるモデルウィンドウのオーバーライド。" - key: BILI_LAUNCHER_LANE type: string default: "unset" @@ -290,6 +325,7 @@ entries: group: envonly desc_en: "Launcher channel: lane identity of the spawning bili process." desc_zh: "启动器通道:派生方 bili 进程的车道身份。" + desc_ja: "ランチャーチャネル:生成元のbiliプロセスのレーンID。" - key: BILI_LAUNCHER_PLUGIN type: string default: "unset" @@ -298,6 +334,7 @@ entries: group: envonly desc_en: "Launcher channel: plugin-mode handoff marker." desc_zh: "启动器通道:插件模式交接标记。" + desc_ja: "ランチャーチャネル:プラグインモードのハンドオフマーカー。" - key: BILI_LAUNCHER_DIRECT type: boolean-ish default: "off" @@ -306,6 +343,7 @@ entries: group: envonly desc_en: "Launcher channel: bypass the injected proxy for this launch." desc_zh: "启动器通道:本次启动绕过注入的代理。" + desc_ja: "ランチャーチャネル:この起動において注入されたプロキシをバイパスする。" - key: BILI_INHERITED_HTTP_PROXY type: string default: "unset" @@ -314,6 +352,7 @@ entries: group: envonly desc_en: "Launcher channel: inherited http_proxy value preserved across the spawn boundary." desc_zh: "启动器通道:跨派生边界保留的 http_proxy 继承值。" + desc_ja: "Launcher channel: spawn 境界をまたいで継承された http_proxy の値が保持されます。" - key: BILI_INHERITED_HTTPS_PROXY type: string default: "unset" @@ -322,6 +361,7 @@ entries: group: envonly desc_en: "Launcher channel: inherited https_proxy value preserved across the spawn boundary." desc_zh: "启动器通道:跨派生边界保留的 https_proxy 继承值。" + desc_ja: "Launcher channel: spawn 境界をまたいで継承された https_proxy の値が保持されます。" - key: BILI_INHERITED_ALL_PROXY type: string default: "unset" @@ -330,6 +370,7 @@ entries: group: envonly desc_en: "Launcher channel: inherited all_proxy value preserved across the spawn boundary." desc_zh: "启动器通道:跨派生边界保留的 all_proxy 继承值。" + desc_ja: "Launcher channel: spawn 境界をまたいで継承された all_proxy の値が保持されます。" - key: BILI_INHERITED_NO_PROXY type: string default: "unset" @@ -338,6 +379,7 @@ entries: group: envonly desc_en: "Launcher channel: inherited no_proxy value preserved across the spawn boundary." desc_zh: "启动器通道:跨派生边界保留的 no_proxy 继承值。" + desc_ja: "Launcher channel: spawn 境界をまたいで継承された no_proxy の値が保持されます。" - key: BILI_NATIVE_CLAUDE type: boolean-ish default: "off" @@ -346,6 +388,7 @@ entries: group: envonly desc_en: "Host posture: marks a claude-native plugin process." desc_zh: "宿主姿态:标记 claude 原生插件进程。" + desc_ja: "Host posture: claude ネイティブプラグインプロセスであることを示します。" - key: BILI_NATIVE_DSH type: boolean-ish default: "off" @@ -354,6 +397,7 @@ entries: group: envonly desc_en: "Host posture: marks a dsh-native plugin process." desc_zh: "宿主姿态:标记 dsh 原生插件进程。" + desc_ja: "Host posture: dsh ネイティブプラグインプロセスであることを示します。" - key: BILI_NATIVE_KIMI type: boolean-ish default: "off" @@ -362,6 +406,7 @@ entries: group: envonly desc_en: "Host posture: marks a kimi-native plugin process." desc_zh: "宿主姿态:标记 kimi 原生插件进程。" + desc_ja: "Host posture: kimi ネイティブプラグインプロセスであることを示します。" - key: BILI_NATIVE_OMP type: boolean-ish default: "off" @@ -370,6 +415,7 @@ entries: group: envonly desc_en: "Host posture: marks an omp-native plugin process." desc_zh: "宿主姿态:标记 omp 原生插件进程。" + desc_ja: "Host posture: omp ネイティブプラグインプロセスであることを示します。" - key: BILI_NATIVE_OPENCODE type: boolean-ish default: "off" @@ -378,6 +424,7 @@ entries: group: envonly desc_en: "Host posture: marks an opencode-native plugin process." desc_zh: "宿主姿态:标记 opencode 原生插件进程。" + desc_ja: "Host posture: opencode ネイティブプラグインプロセスであることを示します。" - key: BILI_NATIVE_PI type: boolean-ish default: "off" @@ -386,6 +433,7 @@ entries: group: envonly desc_en: "Host posture: marks a pi-native plugin process." desc_zh: "宿主姿态:标记 pi 原生插件进程。" + desc_ja: "Host posture: pi ネイティブプラグインプロセスであることを示します。" - key: BILI_PI_INLINE type: boolean-ish default: "inline when unset (DEFAULT-ON since #5428; explicit 0/false/no/off opts out)" @@ -394,6 +442,7 @@ entries: group: envonly desc_en: "Host posture: pi inline lane (#3278) — the pi extension compresses IN-PROCESS through the pseudo-origin instead of spawning its own proxy; outranks a preset BILLION_CONTEXT_PROXY attach target. DEFAULT-ON since #5428 (supersedes the #4687 opt-in rule): unset env+file runs inline; an announced attach target still beats the DEFAULT, so `bili pi` keeps its launcher proxy. Explicit OPT-OUT = 0/false/no/off (or `\"pi\": {\"inline\": false}`) — restores the old attach/spawn posture. Human surface: `bili -i/--inline pi` forces inline, `bili -s/--server pi` pins the proxy posture (beats an inherited inline env). Truthy = any non-empty value except 0/false/no/off (on/yes/TRUE all enable). Codex Responses WS traffic is routed through a loopback-only bridge booted with the engine; if that bridge fails, the WS lane degrades DIRECT (warned) while HTTP compression stays in-process." desc_zh: "宿主姿态:pi 内联压缩通道(#3278)——pi 扩展在进程内通过伪源站直接压缩,不再另起代理进程;优先于预置的 BILLION_CONTEXT_PROXY 附着目标。自 #5428 起默认开启(取代 #4687 的手动开启规则):未设置 env+文件时走内联;显式宣告的附着目标仍压过默认,`bili pi` 照旧用 launcher 代理。显式关闭 = 0/false/no/off(或 `\"pi\": {\"inline\": false}`)——恢复旧的 attach/spawn 姿态。人类入口:`bili -i/--inline pi` 强制内联,`bili -s/--server pi` 钉死代理姿态(压过继承的内联变量)。除 0/false/no/off 外任何非空值均算开启(on/yes/TRUE 均可)。codex 的 Responses WS 流量改走随引擎启动的仅回环桥;桥起不来时该通道退回直连(打 warn),HTTP 压缩仍留在进程内。" + desc_ja: "Host posture: pi インラインレーン (#3278) — pi 拡張機能は、独自のプロキシを spawn するのではなく、擬似オリジン経由でプロセス内で圧縮を行います。プリセットの BILLION_CONTEXT_PROXY アタッチターゲットよりも優先されます。#5428 以降、デフォルトで有効 (#4687 のオプトインルールを置き換え): 環境変数とファイルが未設定の場合はインラインで実行されます。アタッチターゲットが明示されている場合でも DEFAULT より優先されるため、`bili pi` はランチャープロキシを維持します。明示的なオプトアウト = 0/false/no/off (または `\"pi\": {\"inline\": false}`) — 従来のアタッチ/spawn ポスチャを復元します。人間向けインターフェース: `bili -i/--inline pi` でインラインを強制、`bili -s/--server pi` でプロキシポスチャを固定 (継承されたインライン環境変数よりも優先)。Truthy = 0/false/no/off 以外の空でない任意の値 (on/yes/TRUE はすべて有効化)。Codex Responses WS トラフィックは、エンジンと共に起動されるループバック専用ブリッジ経由でルーティングされます。このブリッジが失敗した場合、WS レーンは DIRECT にデグレードし (警告が表示されます)、HTTP 圧縮はプロセス内で維持されます。" - key: BILI_OPENCODE_INLINE type: boolean-ish default: "off (opt-in)" @@ -402,6 +451,7 @@ entries: group: envonly desc_en: "Host posture: opencode inline lane (#3278 port) — the opencode plugin compresses IN-PROCESS through the pseudo-origin instead of spawning its own proxy; outranks a preset BILLION_CONTEXT_PROXY attach target. OPT-IN: the opencode lane keeps its legacy default (spawned proxy) unless this env or \"opencode\": {\"inline\": true} explicitly enables it (owner decision on #4687). Truthy = any non-empty value except 0/false/no/off (on/yes/TRUE all enable). Verified on the Bun host (engine boots and dispatches without node:sqlite)." desc_zh: "宿主姿态:opencode 内联压缩通道(#3278 移植)——opencode 插件在进程内通过伪源站直接压缩,不再另起代理进程;优先于预置的 BILLION_CONTEXT_PROXY 附着目标。需手动开启:按 #4687 决定,opencode 通道默认保持旧行为(另起代理),只有本环境变量或 \"opencode\": {\"inline\": true} 显式开启才切换;除 0/false/no/off 外任何非空值均算开启(on/yes/TRUE 均可)。已在 Bun 宿主上验证(无 node:sqlite 时引擎 boot/dispatch 正常)。" + desc_ja: "Host posture: opencode インラインレーン (#3278 ポート) — opencode プラグインは、独自のプロキシを spawn するのではなく、擬似オリジン経由でプロセス内で圧縮を行います。プリセットの BILLION_CONTEXT_PROXY アタッチターゲットよりも優先されます。オプトイン: opencode レーンは、この環境変数または \"opencode\": {\"inline\": true} が明示的に有効化されない限り、レガシーのデフォルト (spawn されたプロキシ) を維持します (#4687 におけるオーナーの決定)。Truthy = 0/false/no/off 以外の空でない任意の値 (on/yes/TRUE はすべて有効化)。Bun ホスト上で検証済み (エンジンは node:sqlite なしで起動およびディスパッチ可能)。" - key: BILI_INLINE_DEBUG type: boolean-ish default: "off" @@ -410,6 +460,7 @@ entries: group: envonly desc_en: "Inline lane (#3278) only: keep the engine's log lines on stderr after muting them (the inline engine runs inside the pi process, where stderr is the interactive TUI — every [persist]/[storage]/[inline] line would scroll the input box away; default keeps them in bili.log only)." desc_zh: "仅内联通道(#3278):把引擎日志保留在 stderr 上(默认关闭——内联引擎跑在 pi 进程里,stderr 就是交互终端,每行 [persist]/[storage]/[inline] 都会把输入框挤掉;默认只写 bili.log)。" + desc_ja: "インラインレーン (#3278) のみ: ミュート後もエンジンのログ行を stderr に保持します (インラインエンジンは pi プロセス内で実行され、stderr は対話型 TUI です。すべての [persist]/[storage]/[inline] 行が入力ボックスをスクロールさせてしまうため、デフォルトでは bili.log にのみ保持されます)。" - key: BILI_NATIVE_ZCODE type: boolean-ish default: "off" @@ -418,6 +469,7 @@ entries: group: envonly desc_en: "Host posture: marks a zcode-native plugin process." desc_zh: "宿主姿态:标记 zcode 原生插件进程。" + desc_ja: "Host posture: zcode ネイティブプラグインプロセスであることを示します。" - key: BILI_PI_BIN type: string default: "pi (PATH lookup)" @@ -426,6 +478,7 @@ entries: group: envonly desc_en: "Host posture: explicit binary path for the pi client binary." desc_zh: "宿主姿态:pi 客户端二进制的显式路径。" + desc_ja: "Host posture: pi クライアントバイナリの明示的なバイナリパス。" - key: BILI_DSH_BIN type: string default: "dsh (PATH lookup)" @@ -434,6 +487,7 @@ entries: group: envonly desc_en: "Host posture: explicit binary path for the dsh client binary." desc_zh: "宿主姿态:dsh 客户端二进制的显式路径。" + desc_ja: "ホストの姿勢: dsh クライアントバイナリの明示的なバイナリパス。" - key: BILI_MODEL_INFO_RETRY_MS type: number default: "(built-in)" @@ -442,6 +496,7 @@ entries: group: envonly desc_en: "Test hook: retry interval for model-info lookups." desc_zh: "测试钩子:模型信息查询的重试间隔。" + desc_ja: "テストフック: モデル情報の参照におけるリトライ間隔。" - key: BILI_DSH_RETRY_INTERVAL_MS type: number default: "(built-in)" @@ -450,6 +505,7 @@ entries: group: envonly desc_en: "Test hook: retry interval for dsh lane operations." desc_zh: "测试钩子:dsh 车道操作的重试间隔。" + desc_ja: "テストフック: dsh レーン操作におけるリトライ間隔。" - key: BILI_DSH_RECOVERY_INTERVAL_MS type: number default: "(built-in)" @@ -458,6 +514,7 @@ entries: group: envonly desc_en: "Test hook: recovery sweep interval for the dsh lane." desc_zh: "测试钩子:dsh 车道恢复清扫间隔。" + desc_ja: "テストフック: dsh レーンのリカバリスウィープ間隔。" - key: ACP_DUMP_DIR type: string default: "unset" @@ -466,6 +523,7 @@ entries: group: envonly desc_en: "Base directory override for wire dump output (path relocation)." desc_zh: "线路转储输出基础目录覆盖(路径重定位)。" + desc_ja: "ワイヤダンプ出力のベースディレクトリのオーバーライド(パスの再配置)。" - key: BILI_STREAM_STALL_MS type: number default: "(built-in)" @@ -474,6 +532,7 @@ entries: group: envonly desc_en: "Stall-detection timeout for committed upstream streams (no-byte silence before abort)." desc_zh: "已提交上游流的停滞检测超时(无字节静默多久后中止)。" + desc_ja: "コミット済みアップストリームストリームのストール検出タイムアウト(中断前の無バイト沈黙)。" - key: BILI_CLIENT_BIN type: string default: "unset (PATH lookup)" @@ -482,6 +541,7 @@ entries: group: envonly desc_en: "Explicit binary override for the launched client (resolved on PATH)." desc_zh: "被启动客户端二进制的显式覆盖(在 PATH 上解析)。" + desc_ja: "起動するクライアントの明示的なバイナリオーバーライド(PATH で解決)。" - key: BILI_CONVERSATION_ID type: string default: "unset (per-spawn UUID written by bili)" @@ -490,6 +550,7 @@ entries: group: envonly desc_en: "Per-spawn conversation UUID handed to MCP children whose host passes no session id (headless self-registration)." desc_zh: "传给 MCP 子进程的逐派生会话 UUID(宿主不传会话 id 时用于无头自注册)。" + desc_ja: "セッション ID を渡さないホストを持つ MCP 子プロセスに渡す、スポン時に生成される会話 UUID(ヘッドレス自己登録)。" - key: BILI_LAUNCHER_MODEL_MAX_OUTPUTS type: "string (JSON id→maxOutput map)" default: "unset" @@ -498,6 +559,7 @@ entries: group: envonly desc_en: "Launcher channel: per-model max-output map handed to the spawned proxy for output-headroom reservation." desc_zh: "启动器通道:传给被派生代理的逐模型最大输出映射,用于输出预留。" + desc_ja: "ランチャーチャネル: 出力ヘッドルームの予約のためにスポンされたプロキシに渡す、モデルごとの最大出力マップ。" - key: BILI_LAUNCH_TOKEN type: string default: "unset (generated per launch)" @@ -506,6 +568,7 @@ entries: group: envonly desc_en: "Launch token authenticating lane-internal endpoints between a launcher and its spawned proxy (secret)." desc_zh: "启动令牌,鉴权启动器与其派生代理之间的车道内部端点(机密)。" + desc_ja: "ランチャーとそのスポンされたプロキシ間のレーン内部エンドポイントを認証するランチャートークン(シークレット)。" - key: BILI_MCP_DEFAULT_ORIGIN type: string default: "http://127.0.0.1:8787" @@ -514,6 +577,7 @@ entries: group: envonly desc_en: "Fallback proxy origin candidate for MCP entry points." desc_zh: "MCP 入口的兜底代理 origin 候选。" + desc_ja: "MCP エントリポイント用のフォールバックプロキシオリジン候補。" - key: BILI_MCP_NO_ORPHAN_ADOPT type: boolean-ish default: "off (=1 disables orphan adoption)" @@ -522,6 +586,7 @@ entries: group: envonly desc_en: "Opt out of resumed-session orphan adoption when several host sessions share one proxy." desc_zh: "多个宿主会话共享一个代理时,退出恢复会话的孤儿收养。" + desc_ja: "複数のホストセッションが 1 つのプロキシを共有する場合、再開セッションの孤児採用を無効にする。" - key: BILI_MITM_HOSTS type: "string[] (csv)" default: "unset" @@ -530,6 +595,7 @@ entries: group: envonly desc_en: "Launcher channel: MITM whitelist hosts handed to the spawned proxy (distinct from the config-file twin BILI_MITM_DOMAINS)." desc_zh: "启动器通道:传给被派生代理的 MITM 白名单主机(区别于配置文件对应项 BILI_MITM_DOMAINS)。" + desc_ja: "ランチャーチャネル: スポンされたプロキシに渡す MITM ホワイトリストホスト(設定ファイルの双子 BILI_MITM_DOMAINS とは別物)。" - key: BILI_PLUGIN_AGENT type: boolean-ish default: "off" @@ -538,6 +604,7 @@ entries: group: envonly desc_en: "Spawn channel: marks a plugin-agent process." desc_zh: "派生通道:标记插件 agent 进程。" + desc_ja: "スポンチャネル: プラグインエージェントプロセスを示す。" - key: BILI_IMAGE_RESCALE_MAX_DIM type: integer default: "1600" @@ -546,3 +613,4 @@ entries: group: envonly desc_en: "Longest-edge trigger threshold (px) for the egress image downscale pass (#3400); non-numeric or below 128 ignored (default applies). Env-only by design." desc_zh: "出站图片降采样 pass 的最长边触发阈值(像素,#3400);非数字或低于 128 的取值按默认处理。设计上仅环境变量。" + desc_ja: "エグレス画像のダウンスケールパスのトリガー閾値(px)(#3400); 数値でない場合または 128 未満の場合は無視される(デフォルトが適用される)。設計上、環境変数のみ。" diff --git a/website/config-reference/process.yaml b/website/config-reference/process.yaml index b61c1453f1..679ab1dc92 100644 --- a/website/config-reference/process.yaml +++ b/website/config-reference/process.yaml @@ -10,6 +10,7 @@ entries: site_group: proc desc_en: "Transport timeouts, watchdogs and replay policy for upstream calls." desc_zh: "上游调用的传输超时、看门狗与重放策略。" + desc_ja: "上流呼び出しのタイムアウト、ウォッチドッグ、リプレイポリシー。" site_en: "network — transport timeouts, replays & the 429 egress governor: upstreamTimeoutMs 720000 · upstreamFirstByteMs 720000 · requestWatchdogMs 2× · replayRetryMax 3 · replayRetryBaseMs 1500 · keepAliveTimeoutMs 5000 · clientErrorBackstopMs 30000 · exposureLogIntervalMs 3600000 · streamKeepAliveMs 15000 · preflightHoldMs 30000 · preflightDeadEndCooldownMs 300000 · proxyKeepAliveMaxMs 55000 · throttle429Enabled true · throttle429MaxConsecutive 5 · throttle429BaseDelayMs 2000 · throttle429MaxDelayMs 30000 · throttle429Scope credential." site_zh: "network —— 传输超时、重放与 429 出站治理:upstreamTimeoutMs 720000 · upstreamFirstByteMs 720000 · requestWatchdogMs 2× · replayRetryMax 3 · replayRetryBaseMs 1500 · keepAliveTimeoutMs 5000 · clientErrorBackstopMs 30000 · exposureLogIntervalMs 3600000 · streamKeepAliveMs 15000 · preflightHoldMs 30000 · preflightDeadEndCooldownMs 300000 · proxyKeepAliveMaxMs 55000 · throttle429Enabled true · throttle429MaxConsecutive 5 · throttle429BaseDelayMs 2000 · throttle429MaxDelayMs 30000 · throttle429Scope credential。" - key: network.upstreamTimeoutMs @@ -19,6 +20,7 @@ entries: group: process desc_en: "Hard ceiling on a single upstream call (12 min covers slow deep-thinking models)." desc_zh: "单次上游调用的硬上限(12 分钟覆盖慢速深度思考模型)。" + desc_ja: "単一の上流呼び出しに対する絶対上限(12分は、遅い深層思考モデルをカバーする)。" - key: network.upstreamFirstByteMs type: number default: "= upstreamTimeoutMs (resolved; 720000 when unset)" @@ -26,6 +28,7 @@ entries: group: process desc_en: "Phase-1 budget: request sent → first response byte (undici resolves the fetch around the first body data). Unset follows the RESOLVED upstreamTimeoutMs — including deployments that raise BILI_UPSTREAM_TIMEOUT_MS above 12 min (#5917 review: a constant 720000 fallback would silently re-cap them) — so behavior is unchanged; tighter deployments opt in (#5904: a wedged upstream that accepts requests but never answered previously hung silently until the client aborted). After the first byte, chunk-gap silence stays governed by the full upstreamTimeoutMs (#1706/#1714 guarantee). When this value is set BELOW upstreamTimeoutMs, a first-byte timeout becomes its own failure class `upstream-headers-timeout` — zero response bytes were received, so bili replays it in-proxy under the existing retry budget (BILI_REPLAY_RETRY_MAX, default 3) instead of failing the whole request once; the mid-stream (body) idle timeout stays `upstream-timeout` and non-retried. Unset, behavior is byte-identical to before (#5807/#5831). The release gate sets 120000." desc_zh: "阶段一预算:请求发出 → 首个响应字节(undici 在首个 body 数据到达时才 resolve fetch)。未设时跟随解析后的 upstreamTimeoutMs——包括把 BILI_UPSTREAM_TIMEOUT_MS 提到 12 分钟以上的部署(#5917 评审:常量 720000 回落会悄悄把它们压回 12 分钟)——行为不变;需要更快约束首字节时延的部署可显式收紧(#5904:上游接收请求后永不应答的卡死,之前会静默拖到客户端中止)。首字节到达后,chunk 间隙静默仍由完整 upstreamTimeoutMs 管辖(#1706/#1714 保证)。当该值被收紧到低于 upstreamTimeoutMs 时,首字节超时成为独立失败类 `upstream-headers-timeout`——因为一个响应字节都未收到,bili 会在代理内按既有重试预算(BILI_REPLAY_RETRY_MAX,默认 3 次)重放,而不是让整步只失败一次;流中途(body)空闲超时仍是 `upstream-timeout` 且不重试。未设时行为与之前逐字节一致(#5807/#5831)。发布 gate 设 120000。" + desc_ja: "フェーズ1の予算:リクエスト送信 → 最初のレスポンスバイト(undiciは最初のボディデータ付近でfetchを解決する)。未設定の場合、解決済みの上流タイムアウト(upstreamTimeoutMs)に従う — BILI_UPSTREAM_TIMEOUT_MS を12分以上に引き上げるデプロイメントを含む(#5917 レビュー:定数 720000 のフォールバックはそれらを静かに再制限してしまう)— したがって動作は変更されない;より厳格なデプロイメントはオプトインする(#5904:リクエストを受け入れるが以前は応答しなかったスタックした上流は、クライアントが中断するまで静かにハングしていた)。最初のバイト後、チャンク間の沈黙は引き続き完全な upstreamTimeoutMs によって管理される(#1706/#1714 の保証)。この値が upstreamTimeoutMs 未満に設定されると、最初のバイトのタイムアウトは独自の失敗クラス upstream-headers-timeout となる — レスポンスバイトがゼロであるため、bili はリクエスト全体を一度で失敗させるのではなく、既存のリトライ予算(BILI_REPLAY_RETRY_MAX、デフォルト 3)の下でプロキシ内でリプレイする;ストリーム中(ボディ)のアイドルタイムアウトは upstream-timeout のままであり、リトライされない。未設定の場合、動作は以前とバイト単位で同一である(#5807/#5831)。リリースゲートは 120000 を設定する。" - key: network.requestWatchdogMs type: number default: "2× upstreamTimeoutMs" @@ -33,6 +36,7 @@ entries: group: process desc_en: "Absolute watchdog that force-aborts a stuck upstream socket even when the per-call timer was never armed." desc_zh: "绝对看门狗:即使按调用计时器从未挂上,也强制中止卡死的上游套接字。" + desc_ja: "呼び出しごとのタイマーが設定されていなくても、スタックした上流ソケットを強制中断する絶対的なウォッチドッグ。" - key: network.keepAliveTimeoutMs type: number default: "5000" @@ -40,6 +44,7 @@ entries: group: process desc_en: "Idle keep-alive timeout for pooled upstream sockets." desc_zh: "连接池内上游套接字的空闲保活超时。" + desc_ja: "プールされた上流ソケットのアイドルキープアライブタイムアウト。" - key: network.clientErrorBackstopMs type: number default: "30000" @@ -47,6 +52,7 @@ entries: group: process desc_en: "Backstop that aborts a client connection that stops reading a committed response." desc_zh: "中止停止读取已提交响应的客户端连接的兜底超时。" + desc_ja: "コミットされたレスポンスの読み取りを停止したクライアント接続を中断するバックストップ。" - key: network.exposureLogIntervalMs type: number default: "3600000 (0 disables the log)" @@ -54,6 +60,7 @@ entries: group: process desc_en: "How often bound-address exposure warnings repeat in the log; 0 disables them entirely." desc_zh: "绑定地址暴露警告在日志中的重复间隔;0 完全禁用。" + desc_ja: "バインドアドレス公開の警告がログに繰り返し表示される間隔;0 で完全に無効化。" - key: network.streamKeepAliveMs type: number default: "15000 (0 disables)" @@ -61,6 +68,7 @@ entries: group: process desc_en: "Downstream stream keep-alive ping interval between model chunks; 0 disables pinging." desc_zh: "模型块之间的下游流保活心跳间隔;0 禁用心跳。" + desc_ja: "モデルチャンク間の下流ストリームキープアライブピン間隔;0 でピンを無効化。" - key: network.preflightHoldMs type: number default: "30000" @@ -68,6 +76,7 @@ entries: group: process desc_en: "How long a failed preflight holds before the request is allowed through unreconciled." desc_zh: "preflight 失败后,允许请求未校准放行的持有时长。" + desc_ja: "失敗したプリフライトが、リクエストが未調整のまま許可されるまで保持される時間。" - key: network.preflightDeadEndCooldownMs type: number default: "300000" @@ -75,6 +84,7 @@ entries: group: process desc_en: "Cooldown after a dead-end preflight before retrying reconciliation for the same session." desc_zh: "死胡同 preflight 后,对同一会话重试校准的冷却时长。" + desc_ja: "行き止まりのプリフライト後、同じセッションの調整を再試行するまでのクールダウン。" - key: network.replayRetryMax type: number default: "3 (1 disables replays)" @@ -82,6 +92,7 @@ entries: group: process desc_en: "Maximum transport-failure replays of an identical request before surfacing the error." desc_zh: "同一请求在向上游暴露错误前的最大传输失败重放次数。" + desc_ja: "エラーを表面化させる前に、同一リクエストの最大トランスポート失敗リプレイ回数。" - key: network.replayRetryBaseMs type: number default: "1500 (0 disables the delay)" @@ -89,6 +100,7 @@ entries: group: process desc_en: "Base backoff delay between replays (exponential)." desc_zh: "重放之间的基础退避延迟(指数增长)。" + desc_ja: "リプレイ間のベースバックオフ遅延(指数関数的)。" - key: network.throttle429Enabled type: boolean default: "true" @@ -96,6 +108,7 @@ entries: group: process desc_en: "Egress-side 429 governor (#4204): repeated upstream 429s are answered locally instead of forwarded. Account limits and unrecognized/malformed responses hold origin+credential; only KeyRing's exact `keyring_model_temporarily_unavailable` code with a matching request model holds origin+credential+model, leaving other models eligible. A mismatch or missing model remains account-wide; false restores the legacy always-forward behavior." desc_zh: "出站 429 治理器(#4204):连续上游 429 会在本地应答而不再转发。账号限额及无法识别/格式错误的响应按 origin+凭据持有;只有 KeyRing 精确返回 `keyring_model_temporarily_unavailable` 且响应模型与请求模型完全相同时,才按 origin+凭据+模型持有,让其他模型继续可用。模型不匹配或缺失仍按账号级处理;设为 false 恢复旧的总是转发行为。" + desc_ja: "エグレス側の 429 ガバナナ(#4204):繰り返される上流 429 は転送されるのではなくローカルで応答される。アカウント制限および未認識/不正なレスポンスは origin+credential を保持する;KeyRing の正確な keyring_model_temporarily_unavailable コードと一致するリクエストモデルのみが origin+credential+model を保持し、他のモデルを適格とする。モデルの不一致または欠落はアカウント全体に適用される;false は従来の常に転送する動作を復元する。" - key: network.throttle429MaxConsecutive type: number default: "5" @@ -103,6 +116,7 @@ entries: group: process desc_en: "Consecutive upstream 429s before the hold turns terminal (local 424 outside every known SDK retry set); one probe per backoff window keeps checking until any non-429 response clears an account hold, or the matching model's non-429 response clears its model hold." desc_zh: "连续上游 429 达到该次数后 hold 转为终局(本地 424,不在任何已知 SDK 重试集合内);每个退避窗口仍放行一次探测,直到账号级 hold 收到任意非 429 响应,或模型级 hold 收到同一模型的非 429 响应后清除。" + desc_ja: "ホールドがターミナル(既知のすべての SDK リトライセットの外側のローカル 424)に変わるまでの連続上流 429 の回数;バックオフウィンドウごとに1回のプローブが、アカウントホールドをクリアする非 429 レスポンス、またはそのモデルホールドをクリアする一致するモデルの非 429 レスポンスがあるまでチェックを続ける。" - key: network.throttle429BaseDelayMs type: number default: "2000" @@ -110,6 +124,7 @@ entries: group: process desc_en: "Base backoff for the 429 hold (doubles per consecutive 429, jittered into [0.5×, 1×], capped by throttle429MaxDelayMs; an upstream Retry-After wins when larger)." desc_zh: "429 hold 的基础退避(每连续一次 429 翻倍、抖动到 [0.5×, 1×]、以 throttle429MaxDelayMs 封顶;上游 Retry-After 更大时优先)。" + desc_ja: "429 ホールドのベースバックオフ(連続する 429 ごとに倍増し、[0.5×, 1×] にジャッターされ、throttle429MaxDelayMs で上限が設定される;上流の Retry-After が大きい場合は優先される)。" - key: network.throttle429MaxDelayMs type: number default: "30000" @@ -117,6 +132,7 @@ entries: group: process desc_en: "Ceiling for the 429 hold backoff and for the terminal-phase probe interval." desc_zh: "429 hold 退避的上限,也是终局阶段探测间隔的上限。" + desc_ja: "429 のバックオフおよびターミナルフェーズのプローブ間隔の上限。" - key: network.throttle429Scope type: string default: "credential" @@ -124,6 +140,7 @@ entries: group: process desc_en: "Hold granularity for marker-less upstream 429s (#5199). The value match is EXACT (`credential` or `model`, case-sensitive) — a typo falls back to `credential` with one warn log. `credential` (default) keeps #5696's conservative semantics — any 429 without a recognized model marker (`keyring_model_temporarily_unavailable`, or a bili relay's `bili_throttle_hold` scope=model) holds the whole origin+credential, so every model behind that credential waits out the backoff. `model` keys the hold by the send's request model instead, for gateways that front many independently-limited models behind one credential (LiteLLM/one-api/opencode.ai-style relays where one model's RPM exhaustion must not freeze its siblings); requests whose model cannot be identified remain credential-wide, and recognized markers keep their own semantics in both modes. NOTE: under `model`, the hold key is the request model string EXACTLY as the wire carries it (`glm-5.2` ≠ `GLM-5.2` ≠ `glm-5.2-128k`) — a gateway that rewrites model names or serves one model under several aliases keeps separate holds per spelling, matching how its own per-model quotas are billed." desc_zh: "无标记上游 429 的 hold 粒度(#5199)。取值匹配是**精确匹配**(`credential` 或 `model`,区分大小写)——拼错会回落到 `credential` 并打一条 warn。`credential`(默认)保持 #5696 的保守语义——凡未携带可识别模型标记(`keyring_model_temporarily_unavailable`,或 bili 中继的 `bili_throttle_hold` scope=model)的 429 均按整个 origin+凭据持有,该凭据下所有模型一起退避等待。`model` 改按发送请求的模型分桶持有,适用于单凭据背后多模型独立限流的网关(LiteLLM/one-api/opencode.ai 类中继,一个模型的 RPM 耗尽不应冻结兄弟模型);无法识别模型的请求仍按凭据级持有,两种模式下已识别标记的语义均不变。注意:`model` 模式下 hold 键就是请求报文里的模型字符串,逐字精确(`glm-5.2` ≠ `GLM-5.2` ≠ `glm-5.2-128k`)——网关若改写模型名或同一模型挂多个别名,会按每个拼写各持一份 hold,与其自身按模型计的配额口径一致。" + desc_ja: "マーカーなしの上流 429 に対するホールドの粒度 (#5199)。値の一致は完全一致 (`credential` または `model`、大文字小文字を区別) であり、タイプミスがある場合は 1 回の警告ログとともに `credential` にフォールバックする。`credential` (デフォルト) は #5696 の保守的なセマンティクスを維持し、認識されたモデルマーカー (`keyring_model_temporarily_unavailable`、または bili リレーの `bili_throttle_hold` scope=model) を伴わない 429 は、そのクレデンシャルの背後にあるすべてのモデルがバックオフを待機するように、オリジン+クレデンシャル全体をホールドする。`model` は、1 つのクレデンシャルの背後に独立した制限を持つ多数のモデルをフロントするゲートウェイ (LiteLLM/one-api/opencode.ai スタイルのリレーで、1 つのモデルの RPM 枯渇がその兄弟モデルをフリーズすべきではない場合) に対して、送信のリクエストモデルをキーとしてホールドを行う。モデルを識別できないリクエストは引き続きクレデンシャル全体を対象とし、認識されたマーカーは両モードで独自のセマンティクスを維持する。注意: `model` の場合、ホールドキーはワイヤーが運ぶリクエストモデル文字列の完全一致 (`glm-5.2` ≠ `GLM-5.2` ≠ `glm-5.2-128k`) であり、モデル名を書き換えるか 1 つのモデルを複数のエイリアスで提供するゲートウェイは、そのモデルごとのクォータが請求されるのと同様に、スペルごとに個別のホールドを維持する。" - key: network.maxShrinkPerCompress type: number default: "unset" @@ -131,6 +148,7 @@ entries: group: process desc_en: "Cap on how much one compression may shrink history (anti-collapse guard)." desc_zh: "单次压缩允许收缩历史的上限(防塌缩护栏)。" + desc_ja: "1 回の圧縮で履歴を縮小できる量の上限 (崩壊防止ガード)。" - key: network.proxyKeepAliveMaxMs type: number default: "55000 (0 = one-shot connections)" @@ -138,6 +156,7 @@ entries: group: process desc_en: "Max lifetime of a connection through an outbound egress proxy before forcing reconnection (avoids stale NAT mappings)." desc_zh: "经出站代理的连接最大存活时长,到期强制重建(规避陈旧 NAT 映射)。" + desc_ja: "アウトバウンドエグレスプロキシを介した接続の最大生存時間。これを超えると再接続を強制する (古い NAT マッピングを回避するため)。" - key: network.postResponseLingerMs type: number default: "5000" @@ -145,6 +164,7 @@ entries: group: process desc_en: "Graceful-close budget for proxy-initiated closes after the response completed: the socket is held waiting for the peer's FIN/TLS close_notify and destroyed at the deadline (reason=linger-backstop)." desc_zh: "代理主动发起的响应后关闭的优雅关闭预算:socket 挂起等待对端 FIN/TLS close_notify,到点销毁(reason=linger-backstop)。" + desc_ja: "レスポンス完了後のプロキシ起因のクローズに対するグレースフルクローズの予算: ソケットはピアの FIN/TLS close_notify を待って保持され、期限時に破棄される (reason=linger-backstop)。" - key: network.allowPrivateHttpProviders type: boolean default: "false" @@ -152,6 +172,7 @@ entries: group: process desc_en: "Opt-in (#2984): admit plain-HTTP providers on private networks (RFC1918, 127/8, link-local, ULA, *.local/.lan/.internal) into the agent-registry intake and summary-endpoint guards. Off by default — plaintext stays loopback-only; public IPs/domains and CGNAT (100.64/10) stay refused regardless. 1/true enables." desc_zh: "可选开关(#2984):允许私网(RFC1918、127/8、link-local、ULA、*.local/.lan/.internal)明文 HTTP provider 进入 agent-registry 接收与摘要端点守卫。默认关——明文仅回环受信;公网 IP/域名与 CGNAT(100.64/10)无论如何都拒。1/true 启用。" + desc_ja: "オプトイン (#2984): プライベートネットワーク (RFC1918, 127/8, リンクローカル, ULA, *.local/.lan/.internal) 上のプレーン HTTP プロバイダーを、エージェントレジストリのインテークおよびサマリーエンドポイントのガードに許可する。デフォルトでは無効 — プレーンテキストはループバックのみ許可; 公開 IP/ドメインおよび CGNAT (100.64/10) は常に拒否される。1/true で有効化。" - key: network.receiveBodyBytes type: number default: "5368709120" @@ -159,6 +180,7 @@ entries: group: process desc_en: "Max inbound wire bytes read into memory per request before a 413 at the receive stage. Raised from a hardcoded 100 MiB to 5 GiB (#3128 owner decision) so multi-gigabyte single requests are accepted instead of the socket being reset. Also the threshold above which a decoded request consumes one of two shared large-decode admission slots. WebSocket lanes keep the fixed 100 MiB surface." desc_zh: "单请求读入内存的入站 wire 字节上限,超限在 receive 阶段返回 413。由硬编码 100 MiB 提升到 5 GiB(#3128 owner 决定),使多 GB 单请求被接受而非断连。同时也是解码请求占用两个共享大解码准入槽位的阈值。WebSocket lane 保持固定 100 MiB 表面。" + desc_ja: "受信ステージで 413 を返す前に、リクエストごとにメモリに読み込む最大ワイヤーバイト数。ハードコードされた 100 MiB から 5 GiB に引き上げられ (#3128 オーナー決定)、マルチギガバイトの単一リクエストがソケットリセットされることなく受け入れられるようになった。また、デコードされたリクエストが共有される 2 つの大型デコードアドミッションスロットの 1 つを消費する閾値でもある。WebSocket レーンは固定の 100 MiB のサーフェスを維持する。" - key: network.decodedBodyBytes type: number default: "10737418240" @@ -166,6 +188,7 @@ entries: group: process desc_en: "Max DECODED bytes after content-encoding expansion (gzip/deflate/br/zstd), checked incrementally during decode (decode-stage 413). Default is 2x the receive budget, mirroring the legacy decode=2x-wire relationship; guards against decompression bombs." desc_zh: "content-encoding 解压(gzip/deflate/br/zstd)后的解码字节上限,解码过程中增量检查(decode 阶段 413)。默认为接收预算的 2 倍,沿用旧的 decode=2×wire 关系;用于防解压炸弹。" + desc_ja: "コンテンツエンコーディング展開 (gzip/deflate/br/zstd) 後の最大デコードバイト数。デコード中に増分チェックされる (デコードステージ 413)。デフォルトは受信予算の 2 倍で、従来の decode=2x-wire の関係を反映し、デコンプレッションボムから守る。" - key: network.outboundBodyBytes type: number default: "5368709120" @@ -173,6 +196,7 @@ entries: group: process desc_en: "Max rebuilt request bytes forwarded upstream (forward-stage 413), counted as UTF-8 bytes of the final body string. Checked before the fetch so an over-budget rebuild never reaches the upstream watchdog allocation." desc_zh: "转发到上游的重建请求字节上限(forward 阶段 413),按最终 body 字符串的 UTF-8 字节计。在 fetch 之前检查,超预算的重建不会触发上游看门狗分配。" + desc_ja: "上流に転送される再構築リクエストの最大バイト数 (転送ステージ 413)。最終ボディ文字列の UTF-8 バイト数としてカウントされる。fetch 前にチェックされるため、予算超過の再構築は上流のウォッチドッグ割り当てに到達しない。" - key: network.wsOutboundBytes type: number default: "10485760" @@ -180,6 +204,7 @@ entries: group: process desc_en: "Soft byte budget for the WebSocket lane only (#3701): when the final serialized Responses WS frame exceeds it, older images are shed from the OUTBOUND COPY first (archived as placeholder notes — originals stay in session storage, recoverable via read_original_image / decompress on tool-armed lanes — codex-style lanes that reject injected tools keep the size-only annotation), then whatever remains is boundedly downscaled through the jimp maxDim ladder. If the frame still does not fit and the upstream closes with 1009 before any event, one strictly smaller resend is attempted within the same request. Set 0 to disable shedding (previous send-as-is behavior). HTTP lanes are unaffected — the hard refusal cap stays network.outboundBodyBytes." desc_zh: "仅针对 WebSocket 通道的软字节预算(#3701):当最终序列化的 Responses WS 帧超出该预算时,优先从出站副本中裁减较早的图片(归档为占位符备注——原始文件仍保留在会话存储中,可通过 read_original_image / decompress 恢复——仅限注册了 bili 工具的通道;拒绝注入工具的 codex 类通道只有尺寸备注),随后对剩余内容通过 jimp maxDim 阶梯进行有界降采样。若帧仍超出限制且上游在任何事件发出前即以 1009 关闭连接,则在同一请求内尝试一次严格更小的重发。设为 0 可禁用裁减(即恢复此前的原样发送行为)。HTTP 通道不受影响——硬性拒绝上限仍为 network.outboundBodyBytes。" + desc_ja: "WebSocket レーン専用のソフトバイト予算 (#3701): 最終シリアライズされた Responses WS フレームがこれを超過した場合、まず OUTBOUND COPY から古い画像が除去される (プレースホルダーノートとしてアーカイブ — 元画像はセッションストレージに残り、ツールアームされたレーンでは read_original_image / decompress で復元可能 — 注入ツールを拒否する codex スタイルのレーンはサイズのみ注釈を保持)、その後残ったものは jimp maxDim ラダーを通じて有界にダウンスケールされる。それでもフレームが収まらず、イベント前に上流が 1009 でクローズした場合、同じリクエスト内で厳密に小さい再送信が 1 回試行される。0 に設定すると除去を無効化 (従来のそのまま送信する動作)。HTTP レーンには影響しない — ハード拒否上限は network.outboundBodyBytes のまま。" - key: network.httpOutboundBytes type: number default: "10485760" @@ -187,6 +212,7 @@ entries: group: process desc_en: "Soft byte budget for the plain/proxy/pi-native HTTP relay lane (#3909): when the final serialized request exceeds it, older images are shed from the OUTBOUND COPY first (archived as placeholder notes — originals stay in session storage, recoverable via read_original_image / decompress on tool-armed lanes — codex-style lanes that reject injected tools keep the size-only annotation), then whatever remains is boundedly downscaled through the jimp maxDim ladder. Closes the gap image-dense sessions leave open: token-space folding decides in tokens while the upstream rejects in bytes / pixel-decode CPU (Cloudflare Worker 503), so a ~48 MiB request 503s forever with every retry resending the same pixels. Applies only when no managed transport is installed (the spawned relay); the WS lane uses network.wsOutboundBytes and managed HTTP transports (inline-engine / dsh-inline) are never shed here (#3701 Finding 1). Set 0 to disable (previous send-as-is); the hard refusal cap stays network.outboundBodyBytes." desc_zh: "面向普通/代理/pi 原生 HTTP 中继通道的软字节预算(#3909):当最终序列化的请求超出该预算时,优先从出站副本中裁减较早的图片(归档为占位符备注——原始文件仍保留在会话存储中,可通过 read_original_image / decompress 恢复——仅限注册了 bili 工具的通道;拒绝注入工具的 codex 类通道只有尺寸备注),随后对剩余内容通过 jimp maxDim 阶梯进行有界降采样。它补上图片密集会话留下的缺口:token 空间折叠按 token 决策,而上游按字节/像素解码 CPU 拒收(Cloudflare Worker 503),于是 ~48 MiB 的请求会永远 503、每次重试都重发同样的像素。仅在未安装受管传输(即 spawn 出来的中继)时生效;WebSocket 通道用 network.wsOutboundBytes,受管 HTTP 传输(inline-engine / dsh-inline)在此从不裁减(#3701 Finding 1)。设为 0 可禁用(恢复此前的原样发送);硬性拒绝上限仍为 network.outboundBodyBytes。" + desc_ja: "プレーン/プロキシ/pi ネイティブ HTTP リレーレーン専用のソフトバイト予算 (#3909): 最終シリアライズされたリクエストがこれを超過した場合、まず OUTBOUND COPY から古い画像が除去される (プレースホルダーノートとしてアーカイブ — 元画像はセッションストレージに残り、ツールアームされたレーンでは read_original_image / decompress で復元可能 — 注入ツールを拒否する codex スタイルのレーンはサイズのみ注釈を保持)、その後残ったものは jimp maxDim ラダーを通じて有界にダウンスケールされる。画像密集セッションが空けられるギャップを閉じる: トークンスペースの折りたたみはトークンで決定するが、上流はバイト/ピクセルデコード CPU (Cloudflare Worker 503) で拒否するため、約 48 MiB のリクエストは同じピクセルを再送信するたびに永遠に 503 になる。マネージドトランスポートがインストールされていない場合 (spawned リレー) のみ適用される; WS レーンは network.wsOutboundBytes を使用し、マネージド HTTP トランスポート (inline-engine / dsh-inline) はここでは決して除去されない (#3701 Finding 1)。0 に設定すると無効化 (従来のそのまま送信する動作); ハード拒否上限は network.outboundBodyBytes のまま。" - key: network.ingestBodyBytes type: number default: "33554432" @@ -194,6 +220,7 @@ entries: group: process desc_en: "Cost band (decoded bytes) for the JSON.parse + normalization sweep AFTER decode (#5794 item 2). A TEXT-DOMINATED body above it is refused with an actionable 413 (stage ingest) before the sweep, because any parseable text body over 32 MiB is already ~8M tokens — beyond every real model window — and burning seconds of event-loop time to parse it (the 51.2 MiB / 29,619-message incident: 5.5–7.2 s per round, 54.6% of local CPU, 747 s FATAL) cannot end in success. Image-bearing bodies are exempt on every lane: base64 pixels are excluded from the token meter by design (images billed separately, never doomed on raw bytes — #496/#1800/#857), so over-band image mass stays governed by the admission slots, the receive cap and each lane's own shed / pre-send byte budget (#3909 ~48 MiB image-dense sessions, #3701 WS screenshots; the Responses lane is exempt outright regardless). Distinct from the admission SLOTS (network.receiveBodyBytes threshold): the slots cap CONCURRENCY of large decodes, this cap bounds a single body. Set 0 to disable (legacy parse-everything)." desc_zh: "解码之后进入 JSON.parse+归一化清扫的成本带(解码后字节,#5794 第 2 项)。超限的**文本为主**的体在清扫之前以可操作的 413(stage ingest)拒收:任何可解析的 32 MiB+ 文本体都 ≥ ~8M token、超过一切真实模型窗口,为它烧掉数秒事件循环时间没有意义(51.2 MiB / 29,619 条消息现场:每轮 5.5–7.2s、占本机 CPU 54.6%、747s FATAL)。带图片的体在所有车道豁免:base64 像素按设计不进 token 计量(图片单独计费、绝不在原始字节上判死——#496/#1800/#857),超带的图片体量仍由准入槽位、收件上限与各车道自身的裁减/预发送字节预算治理(#3909 ~48 MiB 图片密集会话、#3701 WS 截图;Responses 车道无论如何整体豁免)。与大解码准入槽位(network.receiveBodyBytes 阈值)不同:槽位限的是大解码的并发数,本上限限的是单个体的成本。设为 0 可禁用(恢复此前的全解析)。" + desc_ja: "デコード後 (#5794 item 2) の JSON.parse + 正規化スイープのためのコストバンド (デコードバイト数)。これを超過するテキスト主体のボディは、スイープ前に実行可能な 413 (ステージ ingest) で拒否される。なぜなら、32 MiB を超えるパース可能なテキストボディはすでに約 800 万トークンであり、すべての実際のモデルウィンドウを超えており、それをパースするためにイベントループの時間を数秒消費する (51.2 MiB / 29,619 メッセージのインシデント: 1 ラウンドあたり 5.5–7.2 秒、ローカル CPU の 54.6%、FATAL 747 秒) ことは成功に終わらないためである。画像を含むボディはすべてのレーンで免除される: base64 ピクセルは設計上トークンメーターから除外される (画像は別途請求され、生バイト数では決して失格にならない — #496/#1800/#857) ため、バンド超過の画像量は、アドミッションスロット、受信上限、および各レーン独自の shed / 送信前バイト予算 (#3909 約 48 MiB の画像密集セッション、#3701 WS スクリーンショット; Responses レーンは完全に免除) によって管理される。アドミッション SLOTS (network.receiveBodyBytes 閾値) とは異なる: スロットは大型デコードの並行性を制限するが、この上限は単一のボディを制限する。0 に設定すると無効化 (従来のすべてパースする動作)。" - key: network.maxMessages type: number default: "0" @@ -201,6 +228,7 @@ entries: group: process desc_en: "Per-upstream hard cap on the messages[] array length (#5000 item 2) — the COUNT dimension: a wire constraint no byte/token estimate expresses (the 26,903-message / 55.2 MiB #5000 session cleared every size gate and died at the upstream with the count error). Per-UPSTREAM on purpose: there is no universal value, so the default is 0 = disabled; set it to your upstream's known limit and over-count bodies get an actionable 413 (restart the session or rewind) instead of a guaranteed upstream 400. Count only — it never folds. Enforced in preflight (before the token trigger) and at the egress fuse for the no-model lane." desc_zh: "单上游 messages[] 数组长度硬限(#5000 第 2 项)——COUNT 维度:任何字节/token 估算都表达不了的线路约束(#5000 的 26,903 条消息 / 55.2 MiB 会话清掉所有尺寸闸后仍在上游以条数错误死掉)。刻意按上游设置:没有通用值,默认 0 = 关闭;把它设为你所连上游的已知上限后,超条数的体会得到可操作的 413(重启会话或 rewind)而不是一次必然的上游 400。只判条数、从不折叠。在 preflight(token 触发器之前)与无模型车道的出站熔断处强制执行。" + desc_ja: "上流ごとの messages[] 配列長のハード上限 (#5000 item 2) — COUNT 次元: バイト/トークン推定では表現できないワイヤー制約 (#5000 セッションの 26,903 メッセージ / 55.2 MiB はすべてのサイズゲートを通過したが、カウントエラーで上流で死んだ)。意図的に上流ごと: 普遍的な値が存在しないため、デフォルトは 0 = 無効; 上流の既知の制限に設定し、カウント超過のボディには保証された上流 400 の代わりに実行可能な 413 (セッションの再起動または巻き戻し) を返す。カウントのみ — 決して折りたたまない。プリフライト (トークントリガーの前) および no-model レーンのエグレスフュージで強制される。" - key: network.caFile type: string default: "unset" @@ -208,6 +236,7 @@ entries: group: process desc_en: "Path to a PEM file with extra root CAs trusted by bili's OWN upstream fetches (#3776). Merged with Node's built-in roots and any NODE_EXTRA_CA_CERTS entries — never replaces them. For security software doing HTTPS/encrypted-connection scanning (Kaspersky, enterprise DLP) or a corporate MITM proxy that re-signs the upstream: export that root CA to PEM and point this at it. Unset = default trust, byte-identical behavior." desc_zh: "PEM 文件路径,包含要额外信任的根 CA(#3776),仅作用于 bili 自己的上游 fetch。与 Node 内置根证书及 NODE_EXTRA_CA_CERTS 中的条目合并——从不替换。安全软件做 HTTPS/加密连接扫描(卡巴斯基、企业 DLP)或企业 MITM 代理重签上游时使用:把该厂商根证书导出为 PEM 并指向此键。未设置 = 默认信任,行为逐字节不变。" + desc_ja: "bili の独自のアップストリームフェッチが信頼する追加ルート CA を含む PEM ファイルへのパス (#3776)。Node の組み込みルートおよび NODE_EXTRA_CA_CERTS エントリとマージされる — 決して置き換えない。HTTPS/暗号化接続スキャンを行うセキュリティソフトウェア (Kaspersky、エンタープライズ DLP) またはアップストリームを再署名する企業 MITM プロキシに対して: そのルート CA を PEM にエクスポートし、これを指すように設定する。未設定 = デフォルトの信頼、バイト単位で同一の動作。" - key: guardrails type: object default: "{} (all defaults)" @@ -216,6 +245,7 @@ entries: site_group: proc desc_en: "Guardrails: tool-output guardrails for the pi/omp plugin bundles (#3066) plus the proxy-side text-run stream guard (#3406)." desc_zh: "守卫集合:pi/omp 插件的工具输出守卫(#3066)及代理侧流式 text-run 守卫(#3406)。" + desc_ja: "ガードレール: pi/omp プラグインバンドル用のツール出力ガードレール (#3066) およびプロキシ側のテキストランストリームガード (#3406)。" site_en: "guardrails — pi/omp plugin tool-output + stream text-run guardrails: bashTimeout 60 · maxOutputBytes 50000 · repetition true · textRunThreshold 200." site_zh: "guardrails —— pi/omp 插件工具输出与流式 text-run 守卫:bashTimeout 60 · maxOutputBytes 50000 · repetition true · textRunThreshold 200。" - key: guardrails.bashTimeout @@ -225,6 +255,7 @@ entries: group: process desc_en: "Seconds injected as the bash tool's timeout when the model omits it (#3066 owner intent, re-affirmed #3366: an unsupervised bash call could hang a pi session for a whole day — the host schema provides no default). Set N to tune, 0 to disable injection (pi-native no-default)." desc_zh: "模型未写 timeout 时注入到 bash 工具的秒数(#3066 owner 有意为之,#3366 重申:无人看管的 bash 会把 pi 会话挂死一整天——宿主 schema 本身无默认值)。设 N 调整秒数,设 0 关闭注入(恢复 pi 原生行为)。" + desc_ja: "モデルが bash ツールのタイムアウトを省略した場合に注入される秒数(#3066 のオーナー意図、#3366 で再確認:監督のない bash 呼び出しが pi セッションを丸一日ハングさせる可能性があるため、ホストスキーマにはデフォルト値が提供されていない)。N を設定して調整し、0 に設定すると注入を無効にする(pi ネイティブのデフォルトなし)。" - key: guardrails.maxOutputBytes type: number default: "50000" @@ -232,6 +263,7 @@ entries: group: process desc_en: "Combined text-output byte cap per tool result in the pi/omp plugin (0 disables the cap). Over-cap output is truncated head-first with a notice pointing at the host-saved full output." desc_zh: "pi/omp 插件中每个工具结果的文本输出合计字节上限(0 禁用)。超限输出从头截断并附指向宿主已存完整输出的提示。" + desc_ja: "pi/omp プラグインにおけるツール結果ごとのテキスト出力バイト数上限(0 で上限を無効化)。上限超過の出力は先頭から切り詰められ、ホストが保存した完全な出力を指す通知が付与される。" - key: guardrails.repetition type: "boolean | object" default: "true" @@ -239,6 +271,7 @@ entries: group: process desc_en: "Identical-call loop-breaker for the pi/omp plugin: warns from the 3rd consecutive identical call issued in quick succession (arguments compare key-order-insensitively; a previous identical call that actually executed for >=5s counts as long polling and restarts the run), issues ONE final refusal (that call is refused but the turn stays alive) at the 5th so a legitimate wait/poll can still switch to a longer wait, and aborts the turn only if the identical call is repeated again after that refusal (#5225). The object form additionally accepts `enabled` (default true, gate), `warn` (default 3, warning threshold), `abort` (default 5, final-refuse threshold), and `recovery` (default false, opt-in graceful-termination mode: calls 6–(abort+4) are refused with a stuck-report while the turn stays alive, and the turn is forcibly terminated only when the identical call reaches abort+5 in a row (#5505)). false / env 0 disables it. Object sub-fields are file-only (not exposed via env var)." desc_zh: "pi/omp 插件的同一调用循环破除器:快速连续的相同调用(参数比较忽略键序;上一次相同调用若实际执行 ≥5s 视为长轮询并重新计数)从第 3 次起随结果附警告;第 5 次只拒绝这一次调用并发出明确的最后警告(回合保留,合法的等待/轮询此时可改成一次更长的等待继续);被拒之后仍一字不差地重发同样调用才终止整个回合(#5225)。对象形式另接受 `enabled`(默认 true,总开关)、`warn`(默认 3,警告阈值)、`abort`(默认 5,最终拒绝阈值)和 `recovery`(默认 false,选择性的优雅终止模式:调用 6 至 (abort+4) 次被拒绝并附卡死报告(回合保留、不中断宿主回合),直到同一调用连续达到 abort+5 次才强制终止回合(#5505))。false 或 env 0 关闭。对象子字段仅限配置文件(不通过环境变量暴露)。" + desc_ja: "pi/omp プラグイン向けの同一呼び出しループブレイカー:短時間に連続して発行された同一呼び出しが 3 回目に達すると警告を発する(引数の比較はキー順序に依存しない。実際に 5 秒以上実行された以前の同一呼び出しは長時間ポーリングとみなされ、実行が再開される)。5 回目に最終的な拒否を 1 回発行する(その呼び出しは拒否されるがターンは存続する)ことで、正当な待機/ポーリングがより長い待機に切り替えられるようにし、その拒否後に同一呼び出しが繰り返された場合のみターンを中断する(#5225)。オブジェクト形式では、`enabled`(デフォルト true、ゲート)、`warn`(デフォルト 3、警告閾値)、`abort`(デフォルト 5、最終拒否閾値)、および `recovery`(デフォルト false、オプトインのグレースフルターミネーションモード:呼び出し 6〜(abort+4) はスタックレポート付きで拒否されるがターンは存続し、同一呼び出しが abort+5 連続に達した場合のみターンが強制終了される(#5505))も追加で受け付ける。false / 環境変数 0 で無効化。オブジェクトのサブフィールドはファイル専用(環境変数経由では公開されない)。" - key: guardrails.repetition.enabled type: boolean default: "true" @@ -246,6 +279,7 @@ entries: group: process desc_en: "Gates the identical-call loop-breaker when used with the object form. true (default) enables it; false disables it. Use `repetition: false` (boolean form) for the simpler opt-out." desc_zh: "使用对象形式时控制调用循环破除器的开关。true(默认)启用;false 禁用。简单禁用请用 `repetition: false`(布尔形式)。" + desc_ja: "オブジェクト形式で使用する場合の同一呼び出しループブレイカーをゲートする。true(デフォルト)で有効化、false で無効化。よりシンプルなオプトアウトには `repetition: false`(ブール形式)を使用する。" - key: guardrails.repetition.warn type: number default: "3" @@ -253,6 +287,7 @@ entries: group: process desc_en: "First warning threshold. Identical calls from this count onward get a WARNING notice appended to results (#3066). Must be less than `abort`." desc_zh: "首次警告阈值。从第 N 次起,相同调用会在结果中附带 WARNING 通知(#3066)。必须小于 `abort`。" + desc_ja: "最初の警告閾値。この回数以降の同一呼び出しには、結果に WARNING 通知が追加される(#3066)。`abort` より小さい値でなければならない。" - key: guardrails.repetition.abort type: number default: "5" @@ -260,6 +295,7 @@ entries: group: process desc_en: "Final-refuse threshold. The next identical call after this count is blocked and refused without execution, followed by a FINAL WARNING (#5225). Must be greater than `warn`." desc_zh: "最终拒绝阈值。此计数之后的下一次相同调用会被阻止并拒绝执行,附带 FINAL WARNING(#5225)。必须大于 `warn`。" + desc_ja: "最終拒否閾値。この回数を超えた次の同一呼び出しは、実行されずにブロックされ拒否され、FINAL WARNING が付与される(#5225)。`warn` より大きい値でなければならない。" - key: guardrails.repetition.recovery type: boolean default: "false" @@ -267,6 +303,7 @@ entries: group: process desc_en: "Opt-in graceful-termination mode (#5505). When true, calls after the final refusal (abort) are refused with a stuck-report while the turn stays alive (soft-stop). The turn is forcibly terminated only when the identical call reaches abort+5 (hard backstop, default 10). false (default) = original behavior: ctx.abort() at call 6." desc_zh: "选择性的优雅终止模式(#5505)。开启后,最终拒绝(abort)之后的相同调用被拒绝并附卡死报告(软停止,回合保留)。同一调用连续达到 abort+5 次时才强制终止回合(硬保底,默认 10)。false(默认)= 原始行为:第 6 次调用时 ctx.abort()。" + desc_ja: "オプトインのグレースフルターミネーションモード(#5505)。true の場合、最終拒否(abort)後の呼び出しはスタックレポート付きで拒否されるがターンは存続する(ソフトストップ)。ターンが強制終了されるのは、同一呼び出しが abort+5(ハードバックストップ、デフォルト 10)に達した場合のみ。false(デフォルト)= 元の動作:呼び出し 6 で ctx.abort() が実行される。" - key: guardrails.textRunThreshold type: number @@ -275,6 +312,7 @@ entries: group: process desc_en: "Single-codepoint repetition breaker over decoded model text on the response stream (#3260; kill switch added by #3406 item 1 after the #3331 review). Trips at N consecutive identical codepoints - legit prose/code stays far below the 200 default, a symbol-loop model does not. Set N to tune, 0 (or negative) to disable: legit long same-char output (code comment separators, ASCII rules) is then never cut mid-stream. The thinking/reasoning channels sit inside this lane too." desc_zh: "响应流上解码后模型文本的单字符重复破除器(#3260;#3331 审查后由 #3406 第 1 项补上开关)。连续 N 个相同码点即触发——正常文本远低于默认 200,符号循环的模型会撞上。设 N 调整阈值,设 0(或负数)关闭:合法的长同字符输出(代码注释分隔线、ASCII 分隔线)不会再被中途掐断。thinking/reasoning 通道也在该守卫内。" + desc_ja: "レスポンスストリーム上のデコード済みモデルテキストに対する単一コードポイント反復ブレイカー(#3260;#3331 レビュー後に #3406 の項目 1 でキルスイッチが追加)。N 連続の同一コードポイントでトリガーされる - 正当な散文/コードはデフォルトの 200 を大きく下回るが、シンボルループモデルはそうではない。N を設定して調整し、0(または負)で無効化:正当な長い同一文字出力(コードコメントの区切り、ASCII ルール)はストリーム途中で切断されなくなる。thinking/reasoning チャネルもこのレーン内に存在する。" - key: persist type: object default: "{} (all defaults)" @@ -283,6 +321,7 @@ entries: site_group: proc desc_en: "Session persistence to disk under the XDG state dir." desc_zh: "会话落盘持久化(XDG state 目录之下)。" + desc_ja: "XDG ステートディレクトリ下へのセッション永続化。" site_en: "persist — session persistence to disk: enabled true · zstd false · debounceMs 500 · maxDelayMs 5000 · tailTokens 16384 · epermAlertThreshold 5 · epermAlertRepeatMs 0." site_zh: "persist —— 会话落盘持久化:enabled true · zstd false · debounceMs 500 · maxDelayMs 5000 · tailTokens 16384 · epermAlertThreshold 5 · epermAlertRepeatMs 0。" - key: persist.enabled @@ -292,6 +331,7 @@ entries: group: process desc_en: "Master switch for writing session records to disk (0/false turns it off)." desc_zh: "会话记录落盘总开关(0/false 关闭)。" + desc_ja: "セッションレコードをディスクに書き込むためのマスタースイッチ(0/false でオフ)。" - key: persist.zstd type: boolean default: "false" @@ -299,6 +339,7 @@ entries: group: process desc_en: "Zstd-compress persisted session files (1/true enables)." desc_zh: "zstd 压缩持久化会话文件(1/true 启用)。" + desc_ja: "永続化されたセッションファイルを Zstd 圧縮する(1/true で有効化)。" - key: persist.debounceMs type: number default: "500" @@ -306,6 +347,7 @@ entries: group: process desc_en: "Write debounce window for session files." desc_zh: "会话文件写入的去抖窗口。" + desc_ja: "セッションファイルの書き込みデバウンスウィンドウ。" - key: persist.maxDelayMs type: number default: "5000" @@ -313,6 +355,7 @@ entries: group: process desc_en: "Cap on how long a pending session-file write may wait under continuous activity — the debounce window restarts on every mutation, so this budget bounds the steady-state rewrite rate on wear-sensitive drives (#6058)." desc_zh: "持续写入时一次待落盘写入最多可等待的时长上限——去抖窗口每次变更都会重置,这个预算决定磨损敏感盘上的稳态重写速率(#6058)。" + desc_ja: "継続的なアクティビティ下で保留中のセッションファイル書き込みが待機できる最大時間 — デバウンスウィンドウはすべての変更で再起動されるため、この予算は摩耗に敏感なドライブ上の定常状態での書き換え速度を制限する(#6058)。" - key: persist.tailTokens type: number default: "16384 (0 disables message persistence)" @@ -320,6 +363,7 @@ entries: group: process desc_en: "Token-size tail of recent messages kept as raw text for export fidelity." desc_zh: "为导出保真保留的最近消息原文 token 尾部大小。" + desc_ja: "エクスポートの忠実性のために生テキストとして保持される最近のメッセージのトークンサイズ末尾。" - key: persist.epermAlertThreshold type: number default: "5" @@ -327,6 +371,7 @@ entries: group: process desc_en: "Consecutive EPERM write failures before alerting in the log." desc_zh: "连续 EPERM 写失败达到该次数后在日志中告警。" + desc_ja: "ログにアラートを出すまでの連続 EPERM 書き込み失敗回数。" - key: persist.epermAlertRepeatMs type: number default: "0 (no repeats)" @@ -334,6 +379,7 @@ entries: group: process desc_en: "Repeat interval for the EPERM alert; 0 logs it once." desc_zh: "EPERM 告警的重复间隔;0 只记录一次。" + desc_ja: "EPERM アラートの繰り返し間隔。0 の場合は 1 回のみログ出力する。" - key: storage type: object default: "{} (all defaults)" @@ -342,6 +388,7 @@ entries: site_group: proc desc_en: "Unified SQLite storage sidecar settings (#2671)." desc_zh: "统一 SQLite 存储边车设置(#2671)。" + desc_ja: "統合 SQLite ストレージサイドカーの設定 (#2671)。" site_en: "storage — unified storage sidecar: unified legacy — file tier selects the lane-wide storage mode; env BILI_STORAGE_UNIFIED wins when set." site_zh: "storage —— 统一存储边车:unified legacy —— 文件层选定全 lane 存储模式;设置了 BILI_STORAGE_UNIFIED 时环境变量优先。" - key: storage.unified @@ -351,6 +398,7 @@ entries: group: process desc_en: "Tiered storage-migration switch (#2671): shadow = unified SQLite double-write dry-run with digest reconciliation; full = drop-in read path (unified-first loads with organic import, legacy fallback). Absent everywhere now defaults to FULL (#3818 flip - the shadow dry-run reconciled cleanly since #2815, so the index is the load path; JSON envelopes keep being written, and legacy remains the one-line escape hatch). File tier is strict legacy/shadow/full; the env tier also accepts 1/true (=shadow) and unified (=full) and wins over the file. Resolved once per lane boot - hot edits need a restart. Encryption (BILI_ENCRYPTION_KEY) hard-blocks the sidecar." desc_zh: "分层存储迁移开关(#2671):shadow = 统一 SQLite 双写干跑 + digest 对账;full = 平替读路径(unified-first 加载 + 有机导入 + legacy 兜底)。两处均未设置时默认 full(#3818 翻转 —— shadow 干跑自 #2815 起对账一直干净,索引因此成为默认加载路径;JSON 信封照写,legacy 仍是一行逃生口)。文件层只接受 legacy/shadow/full;环境变量层还接受 1/true(=shadow)与 unified(=full)并优先于文件。每个 lane 启动时解析一次 —— 热改动需重启生效。加密(BILI_ENCRYPTION_KEY)会硬阻断边车。" + desc_ja: "階層型ストレージ移行スイッチ (#2671): shadow = ダイジェスト照合付き統合 SQLite ダブルライトのドライラン; full = ドロップイン読み取りパス (オーガニックインポート付きの統合優先読み込み、レガシーフォールバック)。現在、どこでも未設定の場合は FULL がデフォルト (#3818 の反転 - shadow ドライランは #2815 以降クリーンに照合されたため、インデックスが読み取りパスとなる; JSON エンベロープは引き続き書き込まれ、レガシーは 1 行のエスケープハッチとして残る)。ファイル階層は厳密に legacy/shadow/full; 環境変数階層は 1/true (=shadow) と unified (=full) も受け入れ、ファイルより優先される。レーン起動ごとに 1 回のみ解決される - ホット編集には再起動が必要。暗号化 (BILI_ENCRYPTION_KEY) はサイドカーをハードブロックする。" - key: storage.backend type: "sqlite|mysql" default: "unset (sqlite)" @@ -358,6 +406,7 @@ entries: group: process desc_en: "Storage backend selection (#3388 / #3931): the unified store consumes an operation-level async StorageBackend contract. sqlite is the default (the existing UnifiedStore behind a Promise-wrapped adapter). mysql is FULLY WIRED (steps 2+3): openBackend(\"mysql\", dsn) opens the real MysqlBackend against MySQL 8.0 — the full contract surface (ingest with CAS refcounts, reads, session_ext, reap journal, archive/restore/gc, checkpoints, conversations), with mysql2 bundled as a regular dependency and loaded lazily (boots that never select mysql never load it). The proxy hot path is wired through the async shadow facade: saves enqueue onto a serial backend queue (watermark deltas, orphan/reap journal, digest sampling — sqlite keeps its zero-await sync fast path unchanged), SYNC reads ride the JSON envelope (the sidecar attaches asynchronously via ready(); viewFor/importRecord sync facades miss by design), replicas/ext/GC/export/fork speak the async twins (#4911: the fork lane awaits lastLiveSeq + the row clone through them; the sync window reads for fold-anchor backfill / snapshot render stay envelope-served by design). writerOff stays sqlite-only (the envelope is the mysql sync read path). Unknown names fall back to sqlite with a notice. Resolved once per lane boot." desc_zh: "存储后端选择(#3388 / #3931):统一存储消费操作级的异步 StorageBackend 契约。sqlite 为默认(现有 UnifiedStore 套一层 Promise 包装适配器)。mysql 已完整接线(第二+三步):openBackend(\"mysql\", dsn) 打开真正的 MysqlBackend,对接 MySQL 8.0 —— 完整契约面(带 CAS 引用计数的 ingest、读取、session_ext、收割台账、归档/恢复/GC、checkpoint、会话绑定),mysql2 作为常规依赖打包并按需懒加载(从不选 mysql 的启动永不加载它)。代理热路径经异步影子 facade 接线:保存进串行后端队列(水位 delta、孤儿/收割台账、digest 采样 —— sqlite 保持零 await 同步快车道不变),同步读走 JSON 信封(sidecar 经 ready() 异步挂载;viewFor/importRecord 同步面按设计 miss),replicas/ext/GC/export/fork 走异步孪生(#4911:fork 车道经它们 await lastLiveSeq + 行克隆;fold-anchor 回填/快照渲染用的同步窗口读按设计仍走信封)。writerOff 仅 sqlite(信封就是 mysql 的同步读路径)。未知名字回退 sqlite 并提示。每个 lane 启动时解析一次。" + desc_ja: "ストレージバックエンドの選択 (#3388 / #3931): 統合ストアは操作レベルの非同期 StorageBackend 契約を消費する。sqlite がデフォルト (Promise ラップされたアダプター背後の既存の UnifiedStore)。mysql は完全に配線済み (ステップ 2+3): openBackend(\"mysql\", dsn) は MySQL 8.0 に対して実際の MysqlBackend を開く - 完全な契約サーフェス (CAS リファレンスカウント付きのインジェスト、読み取り、session_ext、リープジャーナル、アーカイブ/リストア/GC、チェックポイント、会話)、mysql2 は通常の依存関係としてバンドルされ、遅延ロードされる (mysql を選択しない起動では決してロードされない)。プロキシのホットパスは非同期シャドウファサードを通じて配線されている: セーブはシリアルバックエンドキューにエンキューされる (ウォーターマークデルタ、孤立/リープジャーナル、ダイジェストサンプリング - sqlite はゼロ await の同期高速パスを不変のまま維持)、同期読み取りは JSON エンベロープに乗る (サイドカーは ready() 経由で非同期にアタッチされる; viewFor/importRecord の同期ファサードは意図的にミスする)、レプリカ/ext/GC/エクスポート/フォークは非同期ツインを話す (#4911: フォークレーンはそれらを通じて lastLiveSeq + 行クローンに await する; フォールドアンカーバックフィル / スナップショットレンダリングのための同期ウィンドウ読み取りは意図的にエンベロープ提供される)。writerOff は sqlite のみ (エンベロープは mysql の同期読み取りパスである)。不明な名前は通知付きで sqlite にフォールバックする。レーン起動ごとに 1 回のみ解決される。" - key: storage.mysql.dsn type: string default: "unset" @@ -365,6 +414,7 @@ entries: group: process desc_en: "MySQL DSN for storage.backend=\"mysql\" (#3388 step 2, #3931): mysql://user:pass@host:3306/db. Consumed by the StorageBackend contract paths (hot path included — the async shadow queue). env BILI_MYSQL_DSN wins over the file key. Empty/unset = the mysql backend cannot open — the documented error names both knobs and the working default." desc_zh: "storage.backend=\"mysql\" 的 MySQL DSN(#3388 第二步,#3931):mysql://user:pass@host:3306/db。由 StorageBackend 契约路径消费(含热路径 —— 异步影子队列)。环境变量 BILI_MYSQL_DSN 优先于文件键。空/未设置 = mysql 后端无法打开 —— 文档化错误会同时列出两个旋钮和可用的默认值。" + desc_ja: "storage.backend=\"mysql\" 用の MySQL DSN (#3388 ステップ 2, #3931): mysql://user:pass@host:3306/db。StorageBackend 契約パスによって消費される (ホットパスを含む - 非同期シャドウキュー)。環境変数 BILI_MYSQL_DSN がファイルキーより優先される。空/未設定 = mysql バックエンドが開けない - 文書化されたエラーは両方のノブと動作するデフォルトを名指しする。" - key: storage.sqliteAutoDownload type: boolean default: "true" @@ -372,6 +422,7 @@ entries: group: process desc_en: "Gate for the one-time SQLite engine self-download (#2833): when no engine is available in-process (no built-in node:sqlite, no host-installed better-sqlite3) and the unified sidecar is wanted on this platform, bili downloads the pinned better-sqlite3 prebuilt tarball from the npm registry once (~11 MB, sha512-verified) into the cache dir and reuses it on every later start. Engine resolution order: built-in node:sqlite (Node >= 22.5) -> host-provided better-sqlite3 -> cached self-download -> self-download (gated by this switch) -> none (legacy-only, the #2825 degrade contract). The switch gates only the network fetch - a cached copy is used even when it is false; unsupported platforms never download. The tarball download walks a builtin mirror list (#3338): the configured registry (BILI_UPDATE_REGISTRY / update.registry) is tried first, then https://registry.npmjs.org, then https://registry.npmmirror.com - the first mirror that yields a sha512-verified tarball wins; a Node < 22.5 with no engine gets an explicit Node upgrade hint in the degrade reason (#3385). Engine artifacts are pinned PER RUNTIME, because a binding cannot be loaded outside the range its package declares: Node >= 22 with N-API >= 10 uses better-sqlite3 v13 (one tarball that carries its own prebuilds), while Node 20 and the Node 22.0-22.12 band - which passes v13's major floor but only ships N-API 9 - use v12.9.0 (a JS-only tarball plus its ABI-keyed prebuild, fetched from the binary mirror and bound through nativeBinding). That keeps a low Node on the unified lane instead of degrading to legacy. A runtime no pinned artifact serves (below every floor, or an ABI no prebuild targets) is refused before any load, with neither the download nor a cached copy registered, since loading such a binding crashes the process instead of failing gracefully (#3341, #3894). A failed download arms a 6-hour retry cooldown persisted as a marker file under the cache dir (billion-context/sqlite/.bootstrap-failed.json); the storage diagnostics blob shows the marker's absolute expiry time and path - delete that file and restart bili to force an immediate retry instead of waiting out the whole window (#3788)." desc_zh: "SQLite 引擎一次性自下载的闸门(#2833):进程内没有可用引擎(无内置 node:sqlite、宿主未装 better-sqlite3)且本平台希望启用统一边车时,bili 从 npm registry 一次性下载钉死的 better-sqlite3 预编译 tarball(约 11 MB,sha512 校验)到缓存目录,之后每次启动复用。引擎解析顺序:内置 node:sqlite(Node >= 22.5)-> 宿主机已装的 better-sqlite3 -> 缓存的自下载副本 -> 自下载(本开关控制)-> 无引擎(仅 legacy,即 #2825 降级契约)。开关只控制网络下载 —— 为 false 时缓存副本仍会使用;不支持的平台永不下载。 tarball 下载内置镜像列表兜底(#3338):先试配置的 registry(BILI_UPDATE_REGISTRY / update.registry),再试 https://registry.npmjs.org、https://registry.npmmirror.com —— 第一个通过 sha512 校验的镜像生效;Node < 22.5 且无引擎时,降级原因会给出明确的 Node 升级提示(#3385)。引擎产物按运行时特性分别钉死,因为 binding 无法在包自身声明的范围之外加载:Node >= 22 且 N-API >= 10 用 better-sqlite3 v13(单个 tarball 自带 prebuilds),而 Node 20 与 Node 22.0–22.12(满足 v13 的大版本下限但只带 N-API 9)用 v12.9.0(纯 JS tarball 加与之 ABI 匹配的 prebuild,从二进制镜像获取并经 nativeBinding 注入)—— 低版本 Node 因此留在统一存储车道上,而不是降级到 legacy。任何钉死产物都不支持的运行时(低于所有下限,或 ABI 无对应 prebuild)会在加载之前被拒绝,下载与缓存副本注册都不进行 —— 在那里加载该 binding 会让进程崩溃,而不是优雅失败(#3341、#3894)。下载失败会置一个 6 小时的重试冷却,以标记文件形式持久化在缓存目录下(billion-context/sqlite/.bootstrap-failed.json);storage 诊断块会显示该标记的绝对到期时间与路径 —— 删除该文件并重启 bili 即可强制立即重试,不必等完整个冷却窗口(#3788)。" + desc_ja: "1 回限りの SQLite エンジンの自己ダウンロードのゲート (#2833): プロセス内でエンジンが利用可能でない場合 (組み込みの node:sqlite なし、ホストインストールの better-sqlite3 なし) かつこのプラットフォームで統合サイドカーが望まれる場合、bili は npm レジストリからピン留めされた better-sqlite3 プリビルトタールボールを 1 回ダウンロードし (~11 MB、sha512 検証済み)、キャッシュディレクトリに保存し、その後のすべての起動で再利用する。エンジン解決順序: 組み込み node:sqlite (Node >= 22.5) -> ホスト提供の better-sqlite3 -> キャッシュされた自己ダウンロード -> 自己ダウンロード (このスイッチでゲート) -> なし (レガシーのみ、#2825 のデグレード契約)。このスイッチはネットワークフェッチのみをゲートする - キャッシュされたコピーは false でも使用される; 非サポートプラットフォームでは決してダウンロードしない。タールボールのダウンロードは組み込みミラーリストを辿る (#3338): 設定されたレジストリ (BILI_UPDATE_REGISTRY / update.registry) が最初に試され、次に https://registry.npmjs.org、次に https://registry.npmmirror.com - sha512 検証済みのタールボールを返す最初のミラーが勝つ; エンジンなしの Node < 22.5 はデグレード理由に明示的な Node アップグレードヒントが付く (#3385)。エンジン成果物はランタイムごとにピン留めされる。なぜなら、バインディングはそのパッケージが宣言する範囲外ではロードできないため: N-API >= 10 を持つ Node >= 22 は better-sqlite3 v13 を使用 (独自のプリビルドを保持する 1 つのタールボール)、一方 v13 のメジャーフロアは通るが N-API 9 のみ搭載する Node 20 と Node 22.0-22.12 バンドは v12.9.0 を使用 (JS のみのタールボールとその ABI キー付きプリビルド、バイナリミラーから取得され nativeBinding を通じてバインドされる)。これにより、低バージョンの Node でも統合レーンに留まり、レガシーへのデグレードを避ける。ピン留めされた成果物が提供できないランタイム (すべてのフロア未満、またはプリビルドがターゲットとしない ABI) は、ロード前に拒否される。ダウンロードもキャッシュされたコピーも登録されない。そのようなバインディングのロードは優雅に失敗するのではなくプロセスをクラッシュさせるため (#3341, #3894)。ダウンロード失敗は、キャッシュディレクトリ配下にマーカーファイルとして永続化される 6 時間のリトライクールダウンをアームする (billion-context/sqlite/.bootstrap-failed.json); ストレージ診断ブロブはマーカーの絶対期限時間とパスを表示する - そのファイルを削除して bili を再起動すると、ウィンドウ全体を待たずに即座のリトライを強制できる (#3788)。" - key: storage.jsonWriter type: "on|off" default: "on" @@ -379,6 +430,7 @@ entries: group: process desc_en: "Phase 3 envelope switch (#2960): off stops writing the legacy JSON session envelope while storage.unified is full - the SQLite index becomes the only persistent copy (reads are already unified-first; boot enumerates the index union, so index-only sessions load normally). Only honored in effective-full mode: under shadow/legacy (or with encryption active) the request is ignored with a one-time warning because the JSON file remains the sole source of truth. Env tier 0/false/off = off and 1/true/on = on wins over the strict file spellings. Fail-safe: if the sidecar disables itself mid-run, envelope writes resume on the next save. Rollback: unset the knob - writing resumes, index-only sessions keep loading via the boot union, and replicas/restore re-materialize portable JSON envelopes. Downgrading the binary (or losing the SQLite engine) makes index-only sessions invisible to v0.1.196 and older until a >=v0.1.197 binary runs again - the data stays intact in index.db, it is just not read by the older code. The per-session CCR content-store sidecar stops being written as well - in full mode the index's ccr mirror is consulted first on every read, so the mirror is the durable copy. A jsonWriter=off lane must be the SOLE writer of its sessions directory: an off lane reads unified-first and never falls back to the file, so any peer instance running legacy/shadow against the same directory diverges silently (its JSON copy stops receiving updates, and the off lane never sees the peer's writes)." desc_zh: "Phase 3 信封开关(#2960):off 时若 storage.unified 为 full 则不再写 legacy JSON 会话信封 —— SQLite 索引成为唯一持久化副本(读路径本就 unified-first;boot 枚举索引并集,纯索引会话可正常加载)。仅在有效 full 模式下生效:shadow/legacy(或加密激活)下请求会被忽略并警告一次,因为 JSON 文件仍是唯一事实源。环境变量层 0/false/off = off、1/true/on = on,优先于严格拼写的文件层。失败安全:若边车运行中自禁用,下次保存即恢复信封写入。回滚:去掉该开关 —— 写入恢复,纯索引会话经 boot 并集继续可加载,replicas/restore 可重新物化可移植的 JSON 信封。降级二进制(或丢失 SQLite 引擎)会让纯索引会话在 v0.1.196 及更早版本上不可见,直到重新运行 >=v0.1.197 —— 数据在 index.db 中完好无损,只是旧代码不读它。每会话的 CCR content-store 边车也不再写 —— full 模式下读取时先查索引里的 ccr 镜像,镜像才是持久副本。jsonWriter=off 的 lane 必须是其会话目录的唯一写者:off lane 读路径 unified-first、永不回退到文件,因此同一目录上跑 legacy/shadow 的对等实例会静默分叉(它的 JSON 副本收不到更新,off lane 也看不到对等实例的写入)。" + desc_ja: "フェーズ 3 エンベロープスイッチ (#2960): off は storage.unified が full の間、レガシー JSON セッションエンベロープの書き込みを停止する - SQLite インデックスが唯一の永続コピーとなる (読み取りはすでに統合優先; 起動時にインデックスの和集合を列挙するため、インデックスのみのセッションは正常にロードされる)。有効な full モードでのみ尊重される: shadow/legacy (または暗号化が有効な場合) では、JSON ファイルが唯一の真実のソースであるため、1 回限りの警告付きでリクエストは無視される。環境変数階層 0/false/off = off、1/true/on = on が厳密なファイル表記より優先される。フェイルセーフ: サイドカーが実行中に自身を無効化した場合、次のセーブでエンベロープ書き込みが再開される。ロールバック: ノブを未設定にする - 書き込みが再開され、インデックスのみのセッションは起動和集合経由で引き続きロードされ、レプリカ/リストアはポータブルな JSON エンベロープを再物質化する。バイナリのダウングレード (または SQLite エンジンの喪失) は、>=v0.1.197 バイナリが再び実行されるまで、インデックスのみのセッションを v0.1.196 以前のバージョンから不可視にする - データは index.db に無傷のまま残るが、古いコードによって読み取られないだけである。セッションごとの CCR コンテンツストアサイドカーも書き込みが停止する - full モードでは、すべての読み取りで最初にインデックスの ccr ミラーが参照されるため、ミラーが永続コピーとなる。jsonWriter=off レーンは、そのセッションディレクトリの唯一のライターでなければならない: off レーンは統合優先で読み取り、決してファイルにフォールバックしないため、同じディレクトリに対して legacy/shadow で実行されるピアインスタンスは静かに分岐する (その JSON コピーは更新を受け取らなくなり、off レーンはピアの書き込みを決して見ない)。" - key: storage.walJournalSizeLimitBytes type: number default: "8388608" @@ -386,6 +438,7 @@ entries: group: process desc_en: "WAL reclamation cap for index.db-wal (#3250), in bytes: every completed checkpoint truncates the WAL file back to this size, bounding disk use and crash-recovery replay in long-lived processes. NOT a per-session data quota - data lands in index.db as it is written and the WAL only stages frames between checkpoints, so session count/size does not scale this; a large burst can overshoot temporarily until the next completed checkpoint truncates back. Higher = rarer truncate IO but more steady disk use and a longer crash-replay tail. Env tier (positive integer) wins over the file tier; a garbage or non-positive env value falls through to the file/default tier instead of failing boot. Applied when the store opens at lane boot - hot edits need a restart. The effective value appears on the unified-enable log line and in the storage diagnostics blob." desc_zh: "index.db-wal 的 WAL 回收上限(#3250),单位字节:每次完成的 checkpoint 把 WAL 文件截回该大小,约束长驻进程的磁盘占用与崩溃恢复重放。不是每会话数据配额 —— 数据写入时就已落进 index.db,WAL 只是两次 checkpoint 之间的帧暂存区,会话数量/大小不会放大它;大 burst 可能暂时超出,直到下一次完成的 checkpoint 截回。调大 = truncate IO 更稀疏,但稳态磁盘占用更多、崩溃恢复重放尾更长。环境变量层(正整数)优先于配置文件层;env 值非法或非正数时静默落到文件/默认层,boot 不崩。lane 启动、store open 时生效 —— 热改动需重启。实际取值会出现在 unified-enable 日志行与 storage 诊断块中。" + desc_ja: "index.db-wal の WAL 回収上限 (#3250)、バイト単位: 完了したチェックポイントごとに WAL ファイルがこのサイズまで切り詰められ、長寿命プロセスにおけるディスク使用量とクラッシュ復旧リプレイを制限する。セッションごとのデータクォータではない - データは書き込まれた時点で index.db に着地し、WAL はチェックポイント間のフレームをステージングするだけなので、セッション数/サイズはこれをスケーリングしない; 大きなバーストは、次の完了チェックポイントが切り詰めるまで一時的に超過しうる。高い = 切り詰め IO が稀になるが、定常時のディスク使用量が増え、クラッシュリプレイのテールが長くなる。環境変数階層 (正の整数) がファイル階層より優先される; ゴミまたは非正の環境変数値は、起動を失敗させるのではなくファイル/デフォルト階層にフォールスルーする。レーン起動時にストアが開かれる時点で適用される - ホット編集には再起動が必要。有効な値は統合有効ログ行とストレージ診断ブロブに表示される。" - key: storage.archiveAfterDays type: integer default: "365" @@ -393,6 +446,7 @@ entries: group: process desc_en: "GC age sweep window in days (#3463, #3901): sessions idle longer than this are archived - one JSON line appended to a single archive log (archive/archive.jsonl under the sessions directory — no per-session file spray), a tombstone row keeps the label and identity, content/media refs are released, and restore is one POST away. 0 disables the age sweep; POST /__bili/storage/gc always runs and takes ?vacuum=full to shrink an existing index.db (auto_vacuum=INCREMENTAL is always on for new writes). The same operations have a CLI layer (#3928): bili storage gc [--days N] [--vacuum full|incremental] [--dry-run], plus bili sessions ls/rm/archive/restore (README 'Storage maintenance CLI' section). Env wins over the file tier." desc_zh: "GC 年龄清扫窗口(天,#3463/#3901):闲置超过该时长的会话被归档 —— 以单行 JSON 追加到单一归档日志(会话目录下的 archive/archive.jsonl——不撒每会话小文件),墓碑行保留标签与身份,释放内容/媒体引用,一条 POST 即可恢复。0 关闭年龄清扫;POST /__bili/storage/gc 始终可用并支持 ?vacuum=full 收缩存量 index.db(新写入始终 auto_vacuum=INCREMENTAL)。同一套操作另有 CLI 层(#3928):bili storage gc [--days N] [--vacuum full|incremental] [--dry-run],以及 bili sessions ls/rm/archive/restore (README「存储维护 CLI」一节)。环境变量优先于配置文件层。" + desc_ja: "日単位の GC 年齢スイープウィンドウ (#3463, #3901): これより長くアイドル状態のセッションはアーカイブされる - 単一のアーカイブログ (セッションディレクトリ配下の archive/archive.jsonl — セッションごとのファイルスプレーなし) に 1 行の JSON が追記され、トombストーン行がラベルとアイデンティティを保持し、コンテンツ/メディア参照が解放され、リストアは 1 つの POST のみで可能。0 は年齢スイープを無効にする; POST /__bili/storage/gc は常に実行され、既存の index.db を縮小するには ?vacuum=full を取る (新規書き込みには常に auto_vacuum=INCREMENTAL が有効)。同じ操作に CLI レイヤーがある (#3928): bili storage gc [--days N] [--vacuum full|incremental] [--dry-run]、および bili sessions ls/rm/archive/restore (README の 'Storage maintenance CLI' セクション)。環境変数がファイル階層より優先される。" - key: sessions type: object default: "{} (all defaults)" @@ -401,6 +455,7 @@ entries: site_group: proc desc_en: "Session-table size cap and opt-in garbage collection." desc_zh: "会话表容量上限与可选垃圾回收。" + desc_ja: "セッションテーブルサイズ上限とオプトインによるゴミ収集。" site_en: "sessions — max 256 (LRU) · gc { enabled false, maxAgeDays 7, maxTokens 1000000, intervalMs 3600000 } — GC is opt-in; user data is never pruned silently." site_zh: "sessions —— max 256 (LRU) · gc { enabled false, maxAgeDays 7, maxTokens 1000000, intervalMs 3600000 } —— GC 为可选:用户数据不会被悄悄清理。" - key: sessions.max @@ -410,6 +465,7 @@ entries: group: process desc_en: "In-memory session table cap (LRU eviction of idle sessions)." desc_zh: "内存会话表上限(空闲会话 LRU 逐出)。" + desc_ja: "メモリ内セッションテーブル上限 (アイドルセッションの LRU 退避)。" - key: sessions.warmMax type: number default: "0" @@ -417,6 +473,7 @@ entries: group: process desc_en: "Bounded startup (#2803/#3050): max most-recently-saved sessions hydrated at boot before listening; older state reloads on demand. Default 0 (no eager warm set — first touch pays one on-demand load; set 8 to restore the eager behavior). Capped by sessions.max." desc_zh: "有界启动(#2803/#3050):启动监听前预热加载的最近保存会话数上限,更早的状态按需重新加载。默认 0(不预热——首次访问按需加载一次;设 8 恢复预热行为)。受 sessions.max 封顶。" + desc_ja: "有界な起動 (#2803/#3050): リスニング前に起動時に水合される最大最近保存セッション数; 古い状態はオンデマンドで再ロードされる。デフォルト 0 (急激なウォームセットなし — 最初のタッチが 1 回のオンデマンドロードを支払う; 急激な動作を復元するには 8 を設定)。sessions.max で上限が設定される。" - key: sessions.warmMaxBytes type: number default: "67108864" @@ -424,6 +481,7 @@ entries: group: process desc_en: "Decoded-byte budget for the boot warm set (#2803). Counts decoded size, not compressed on-disk bytes, so zstd archives cannot sneak past the RAM bound. A single file over the budget is never warmed." desc_zh: "启动预热集的解码字节预算(#2803)。按解码后大小计而非磁盘压缩字节,zstd 归档无法绕过内存上限;单文件超预算则永不预热。" + desc_ja: "起動ウォームセットのデコード済みバイト予算 (#2803)。ディスク上の圧縮バイトではなくデコード済みサイズをカウントするため、zstd アーカイブが RAM 境界をすり抜けることはない。予算を超える単一のファイルは決してウォームされない。" - key: sessions.residentMaxBytes type: number default: "4294967296" @@ -431,6 +489,7 @@ entries: group: process desc_en: "Soft target for estimated resident session bytes (#2803; raised from 512 MiB to 4 GiB in #5779 — single sessions routinely exceed half a GiB and ping-ponged against the smaller budget forever). Active/in-flight state stays pinned above it; when over target, idle state discharges back to disk as requests complete. Lower it if your machine has little RAM." desc_zh: "驻留会话估算字节的软目标(#2803;#5779 从 512 MiB 提高到 4 GiB——单个会话经常就超过半 GiB,旧预算下会被反复逐出、永远驻留不下来)。活跃/在途状态始终固定保留;超过目标时,空闲状态随请求完成回写磁盘释放。内存小的机器可调低。" + desc_ja: "推定リザident セッションバイトのソフトターゲット (#2803; #5779 で 512 MiB から 4 GiB に引き上げ — 単一のセッションは通常 512 MiB を超え、より小さい予算に対して永遠にピンポンしていた)。アクティブ/進行中の状態はそれより上にピン留めされる; ターゲット超過時、アイドル状態はリクエスト完了時にディスクへ排出される。メモリが少ないマシンではこれを下げる。" - key: sessions.hardMaxBytes type: number default: "(same as `sessions.residentMaxBytes`)" @@ -438,6 +497,7 @@ entries: group: process desc_en: "Per-SESSION hard cap on estimated resident bytes (#4788, decision #4792 D1-A). Unlike the pool soft cap — which can only evict OTHER cold sessions and never touches a sole-active session — this bounds ONE session: over the cap at a request-end boundary, its droppable fields (folded-block originals, metadata ledger, the raw tail beyond the bounded view) are forced back to disk even for a pool-exempt session, and the next turn transparently re-reads what it needs via narrow disk reads. Safe drops run at every request boundary as long as the last save has provably landed; the cap adds the per-session call-out (warn, throttled to 60 s). `0` disables the cap check." desc_zh: "单会话驻留字节的硬上限(#4788,决策 #4792 D1-A)。不同于池软上限——它只能逐出其他冷会话、从不触碰唯一活跃会话——它约束单个会话:在请求结束边界超过上限时,其可丢弃字段(已折叠块的原文、元数据账本、超出有界视图的原始尾巴)会被强制回写磁盘,即使该会话被池逐出豁免;下一轮通过窄盘读透明地重新读取所需内容。只要上一次保存已被证明落盘,安全丢弃就在每个请求边界运行;该上限额外加入单会话告警(warn,限流至 60 秒)。`0` 关闭该检查。" + desc_ja: "セッションごとの推定リザident バイトのハード上限 (#4788, 決定 #4792 D1-A)。プールソフト上限とは異なり — それは他のコールドセッションのみを退避でき、単独アクティブセッションには決して触れない — これは 1 つのセッションを制限する: リクエスト終了境界で上限超過時、そのドロップ可能なフィールド (フォールドブロックのオリジナル、メタデータ台帳、有界ビューを超える生テール) はプール免除セッションであっても強制的にディスクへ戻され、次のターンは狭いディスク読み取りを通じて必要なものを透明に再読み取りする。最後の保存が確実に着地したことが証明される限り、安全なドロップはすべてのリクエスト境界で実行される; 上限はセッションごとのコールアウト (警告、60 秒にスロットリング) を追加する。`0` は上限チェックを無効にする。" - key: sessions.contentStorePin type: boolean default: "false" @@ -445,6 +505,7 @@ entries: group: process desc_en: "Escape hatch for the #4788 phase-2 resident drop: keep each session's content store pinned in memory (nothing ever folded away). Default off: after every proven-landed save, idle sessions' content stores are dropped between requests and re-read on demand from the unified index mirror or the sidecar file; sessions whose store has no provably-landed copy (e.g. fresh fork children) stay resident automatically. Set this if you need zero re-read latency at the cost of RAM." desc_zh: "#4788 二期驻留丢弃的逃生门:把会话内容存储钉在内存(永不折叠)。默认关闭:每次已证明落盘的保存之后,空闲会话的内容存储在请求间隙被释放,需要时从统一索引镜像或伴生文件按需重读;没有可证明落盘副本的会话(如新建 fork 子会话)自动保持驻留。需要零重读延迟且愿意用内存换时可设此项。" + desc_ja: "#4788 フェーズ2の常駐ドロップのエスケープハッチ: 各セッションのコンテンツストアをメモリに固定する(折りたたみは行われない)。デフォルトはオフ: 検証済みの保存が完了するたびに、アイドル状態のセッションのコンテンツストアはリクエスト間でドロップされ、統合インデックスミラーまたはサイドカーファイルからオンデマンドで再読み込みされる。検証済みのコピーがないストアを持つセッション(例: 新しいフォーク子プロセス)は自動的に常駐する。RAMを犠牲にしてゼロの再読み込みレイテンシが必要な場合にこれを設定する。" - key: sessions.gc.enabled type: boolean default: "false" @@ -452,6 +513,7 @@ entries: group: process desc_en: "Opt-in garbage collection of stale persisted sessions (user data is never pruned silently without this flag)." desc_zh: "过期持久化会话的可选垃圾回收(未开启时用户数据绝不被悄悄清理)。" + desc_ja: "古い永続化セッションのオプトインによるガベージコレクション(このフラグなしでユーザーデータを静かに削除することはない)。" - key: sessions.gc.maxAgeDays type: number default: "7" @@ -459,6 +521,7 @@ entries: group: process desc_en: "GC age threshold in days." desc_zh: "GC 年龄阈值(天)。" + desc_ja: "GCの年齢しきい値(日)。" - key: sessions.gc.maxTokens type: number default: "1000000" @@ -466,6 +529,7 @@ entries: group: process desc_en: "GC token-size threshold per session record." desc_zh: "GC 单会话记录的 token 大小阈值。" + desc_ja: "セッションレコードごとのGCトークンサイズしきい値。" - key: sessions.gc.intervalMs type: number default: "3600000" @@ -473,6 +537,7 @@ entries: group: process desc_en: "GC sweep interval." desc_zh: "GC 清扫间隔。" + desc_ja: "GCスイープ間隔。" - key: plugin.snapshotCapBytes type: number default: "104857600 (0 disables snapshots)" @@ -482,6 +547,7 @@ entries: site_group: proc desc_en: "Size cap for fork-API public snapshots served to native plugins." desc_zh: "提供给原生插件的 fork API 公共快照大小上限。" + desc_ja: "ネイティブプラグインに配信されるフォークAPIパブリックスナップショットのサイズ上限。" site_en: "plugin.snapshotCapBytes — fork API snapshot cap (default 100 MiB; 0 disables snapshots)." site_zh: "plugin.snapshotCapBytes —— fork API 快照上限(默认 100 MiB;0 禁用快照)。" - key: snapshot.shadow @@ -492,3 +558,4 @@ entries: group: process desc_en: "Snapshot-render shadow observability (#3756 follow-up): with the render lane still rollout-gated, every armed turn computes the would-be snapshot view, classifies the diff against the legacy outbound, and records per-session counters (web panel rows + /__bili/status snapshotShadow aggregate + the snapshot-shadow diagnostics topic). Default ON - it is the fleet-wide dry run whose error rate gates the rollout flip. Env BILI_SNAPSHOT_SHADOW wins. Turn off with false/0/off if you do not want the extra per-turn computation." desc_zh: "快照渲染影子对账(#3756 后续):渲染车道仍处灰度关闭时,每轮已折叠会话都现算一次快照视图,与 legacy 实际出站比对分类,逐会话记账(web 面板行 + /__bili/status snapshotShadow 汇总 + snapshot-shadow 诊断主题)。默认开 —— 这是全舰队干跑,其错误率决定灰度翻转。环境变量 BILI_SNAPSHOT_SHADOW 优先。不想要每轮额外计算可用 false/0/off 关闭。" + desc_ja: "スナップショットレンダリングのシャドウ観測可能性(#3756のフォローアップ): レンダリングレーンがまだロールアウトゲートされている間、すべてのアームされたターンがスナップショットビューを計算し、レガシーアウトバウンドとの差分を分類し、セッションごとのカウンターを記録する(Webパネル行 + /__bili/status の snapshotShadow 集計 + snapshot-shadow 診断トピック)。デフォルトはオン - これはロールアウト切り替えをゲートするエラー率を持つフリートワイドのドライランである。環境変数 BILI_SNAPSHOT_SHADOW が優先される。追加のターンごとの計算を望まない場合は false/0/off でオフにする。" diff --git a/website/config-reference/providers.yaml b/website/config-reference/providers.yaml index 7a10abbbac..d88e1b83d2 100644 --- a/website/config-reference/providers.yaml +++ b/website/config-reference/providers.yaml @@ -10,6 +10,7 @@ entries: render: route-row desc_en: "Per-model declarations: context window, output ceiling, per-model compression overrides; not a traffic filter." desc_zh: "逐模型声明:上下文窗口、输出上限、逐模型压缩覆盖;不是流量过滤器。" + desc_ja: "モデルごとの宣言: コンテキストウィンドウ、出力上限、モデルごとの圧縮オーバーライド; トラフィックフィルタではない。" site_en: "Record of model name → {context?, output?, compress?, benefit?}: declares each model's context window, output ceiling, and per-model compression overrides (benefit marks free-quota billing). Not a traffic filter." site_zh: "模型名 → {context?, output?, compress?, benefit?} 的记录:声明每个模型的上下文窗口、输出上限与逐模型压缩覆盖(benefit 标记免费额度计费)。不是流量过滤器。" - key: models.context @@ -18,24 +19,28 @@ entries: group: providers desc_en: "Context window tokens declared for this model name." desc_zh: "为该模型名声明的上下文窗口 token 数。" + desc_ja: "このモデル名に対して宣言されたコンテキストウィンドウトークン数。" - key: models.output type: number default: "unset" group: providers desc_en: "Output token ceiling declared for this model name." desc_zh: "为该模型名声明的输出 token 上限。" + desc_ja: "このモデル名に対して宣言された出力トークン上限。" - key: models.compress type: object default: "unset" group: providers desc_en: "Level-3 compression overrides for this model (deepest in the global→provider→model merge)." desc_zh: "该模型的第 3 级压缩覆盖(全局→provider→模型合并中最深)。" + desc_ja: "このモデルのレベル3圧縮オーバーライド(グローバル→プロバイダー→モデルのマージの中で最も深い)。" - key: models.benefit type: boolean default: "false" group: providers desc_en: "Marks free-quota billing for this model in the economics ledger." desc_zh: "在经济学账本中标记该模型为免费额度计费。" + desc_ja: "エコノミクス台帳において、このモデルの無料クォータ課金をマークする。" - key: proxy type: "string (\"\" = explicit direct)" default: "unset" @@ -44,6 +49,7 @@ entries: render: route-row desc_en: "Per-route outbound proxy URL." desc_zh: "本路由出站代理地址。" + desc_ja: "ルートごとのアウトバウンドプロキシURL。" site_en: "Per-route outbound proxy URL; empty string = explicitly direct." site_zh: "本路由出站代理地址;空字符串 = 显式直连。" - key: compressProtocol @@ -54,6 +60,7 @@ entries: render: route-row desc_en: "Which ACP injection surface this lane speaks." desc_zh: "本通道的 ACP 注入面。" + desc_ja: "このレーンが使用するACPインジェクションサーフェス。" site_en: "Which ACP injection surface this lane speaks: native tools (default) or prompt markers." site_zh: "本通道的 ACP 注入面:原生工具(默认)或提示词标记。" - key: protocol @@ -64,6 +71,7 @@ entries: render: route-row desc_en: "Declare this lane's wire protocol; a client-side /bili// URL marker outranks the declaration." desc_zh: "声明本通道的线上协议;客户端侧 /bili// URL 标记优先级更高。" + desc_ja: "このレーンのワイヤプロトコルを宣言する; クライアント側の /bili// URLマーカーは宣言よりも優先される。" site_en: "Declare this lane's wire protocol. A client-side /bili/<protocol>/ URL marker outranks the declaration; unparseable bodies relay verbatim." site_zh: "声明本通道的线上协议。客户端侧 /bili/<protocol>/ URL 标记优先级更高;不可解析的请求体原样转发。" - key: compress @@ -74,6 +82,7 @@ entries: render: route-row desc_en: "Any compress field can be overridden here — level 2 of the global→provider→model merge." desc_zh: "任意 compress 字段可在此覆盖——全局→provider→模型三级合并的第 2 级。" + desc_ja: "任意の compress フィールドをここで上書きできます — global→provider→model マージのレベル 2 です。" site_en: "Any compress field can be overridden here — level 2 of the global→provider→model merge (per-field, deepest wins)." site_zh: "任意 compress 字段可在此覆盖——全局→provider→模型三级合并的第 2 级(逐字段、最深层胜出)。" - key: compat @@ -84,6 +93,7 @@ entries: render: route-row desc_en: "Per-route wire-compat overrides; provider entries beat the global block per key; dropFields union additively." desc_zh: "逐路由线上兼容覆盖;provider 条目按键级覆盖全局;dropFields 加法并集。" + desc_ja: "ルート単位のワイヤー互換性上書き;provider エントリはキーごとに global ブロックを優先します;dropFields は加算的に union されます。" site_en: "{ roles?, dropFields? } — remap roles the upstream rejects (e.g. developer→system); provider entries beat the global block per key; dropFields strips fields strict schemas reject (additive union)." site_zh: "{ roles?, dropFields? } —— 重写上游拒收的角色(如 developer→system);provider 条目按键级覆盖全局;dropFields 剔除严格 schema 拒收的字段(加法并集)。" - key: direct @@ -94,6 +104,7 @@ entries: render: route-row desc_en: "Client-side exemption: traffic for this upstream is never pointed at bili at all." desc_zh: "客户端侧豁免:该上游流量完全不指向 bili。" + desc_ja: "クライアント側の除外:このアップストリームへのトラフィックは決して bili に指向されません。" site_en: "Client-side exemption: traffic for this upstream is never pointed at bili at all — unlike passthrough, it does not even terminate there." site_zh: "客户端侧豁免:该上游流量完全不指向 bili——与 passthrough 不同,连终结都不经过它。" - key: passthrough @@ -104,6 +115,7 @@ entries: render: route-row desc_en: "Route-scoped byte-for-byte relay with no session state — for anti-fraud upstreams." desc_zh: "路由级逐字节透传、无会话状态——面向反作弊上游。" + desc_ja: "セッション状態なしのルートスコープのバイト単位リレー — 不正防止アップストリーム向け。" site_en: "Route-scoped byte-for-byte relay with no session state — for anti-fraud upstreams." site_zh: "路由级逐字节透传、无会话状态——面向反作弊上游。" - key: imageBilling @@ -114,6 +126,7 @@ entries: render: route-row desc_en: "Image-token counting basis for this route; bytes is an explicit opt-in for byte relays." desc_zh: "本路由图片 token 计费口径;bytes 为字节中继的显式指定。" + desc_ja: "このルートのイメージトークンカウント基準;bytes はバイトリレーに対する明示的なオプトインです。" site_en: "Image-token counting basis for this route: auto (→ pixels), pixels, or bytes (explicit opt-in for byte relays)." site_zh: "本路由图片 token 计费口径:auto(默认→pixels)、pixels 或 bytes(字节中继需显式指定)。" - key: imageTokenCap @@ -124,6 +137,7 @@ entries: render: route-row desc_en: "Per-image token cost cap for this route." desc_zh: "本路由单张图片 token 成本上限。" + desc_ja: "このルートのイメージごとのトークンコスト上限。" site_en: "Per-image token cost cap for this route; unset = uncapped." site_zh: "本路由单张图片 token 成本上限;未设置 = 不限制。" - key: resign @@ -134,6 +148,7 @@ entries: render: route-row desc_en: "Per-route overrides of the global resign map (level 2, deepest wins)." desc_zh: "按路由覆盖全局 resign 映射(第 2 级,最深层胜出)。" + desc_ja: "グローバル resign マップのルート単位のオーバーライド(レベル 2、最も深いものが優先)。" site_en: "Per-route overrides of the global resign map (level 2, deepest wins)." site_zh: "按路由覆盖全局 resign 映射(第 2 级,最深层胜出)。" - key: bind @@ -144,6 +159,7 @@ entries: render: route-row desc_en: "Deep-merge a named (non-URL) entry onto the bound URL lane as an alias; without bind a named entry stays routing-inert." desc_zh: "把具名(非 URL)条目深合并到所绑定的 URL 通道作为别名;无 bind 的具名条目不参与路由。" + desc_ja: "名前付き(非 URL)エントリをバインドされた URL レーンにエイリアスとしてディープマージ;bind なしでは名前付きエントリはルーティング無効のままです。" site_en: "Named (non-URL) entry: deep-merged onto the bound URL lane at config load as an alias. Without bind a named entry stays routing-inert." site_zh: "具名(非 URL)条目:加载配置时深合并到所绑定的 URL 通道作为别名;无 bind 的具名条目不参与路由。" - key: apiKeyEnv @@ -154,6 +170,7 @@ entries: render: route-row desc_en: "Lane credential override (#2336): replace the client's credential with this env variable's value for this lane. Exactly one of apiKeyEnv/credentialRef; see [Lane credentials](#lane-credentials-apikeyenv--credentialref)." desc_zh: "通道凭据覆盖(#2336):用该环境变量的值替换客户端凭据。与 credentialRef 二选一;见[通道凭据](#lane-credentials-apikeyenv--credentialref)。" + desc_ja: "レーン認証情報オーバーライド (#2336):このレーンにおいて、クライアントの認証情報をこの環境変数の値に置き換えます。apiKeyEnv/credentialRef のいずれか一方のみ;[Lane credentials](#lane-credentials-apikeyenv--credentialref) を参照。" site_en: "Lane credential override (#2336): requests forwarded through this lane carry this env variable's value instead of the client's own credential — x-api-key / x-goog-api-key replaced outright, Bearer authorization replaced, injected when absent. Exactly one of apiKeyEnv / credentialRef per entry." site_zh: "通道凭据覆盖(#2336):经该通道转发的请求使用此环境变量的值取代客户端自带凭据——x-api-key / x-goog-api-key 直接替换、Bearer authorization 替换、缺失时注入。每个条目与 credentialRef 二选一。" - key: credentialRef @@ -164,6 +181,7 @@ entries: render: route-row desc_en: "Lane credential override via the private summary-credential store (secret:NAME semantics)." desc_zh: "经私有摘要凭据存储的通道凭据覆盖(secret:NAME 语义)。" + desc_ja: "プライベートなサマリー認証情報ストア経由のレーン認証情報オーバーライド(secret:NAME セマンティクス)。" site_en: "Lane credential override via the private summary-credential store (`secret:NAME` semantics); exactly one of apiKeyEnv / credentialRef per entry." site_zh: "经私有摘要凭据存储的通道凭据覆盖(`secret:NAME` 语义);每个条目与 apiKeyEnv 二选一。" - key: calibration @@ -174,6 +192,7 @@ entries: render: route-row desc_en: "Per-route k̂ calibration policy (#3211): opt-out or clamp for routes whose usage reports inflate; see [Route-level k̂ calibration policy](#route-level-k-calibration-policy)." desc_zh: "按路由的 k̂ 校准策略(#3211):对虚报报数线路做退出或钳制;见[线路级 k̂ 校准策略](#route-level-k-calibration-policy)。" + desc_ja: "ルート単位の k̂ 較正ポリシー (#3211):使用量レポートが膨張するルートに対するオプトアウトまたはクランプ;[Route-level k̂ calibration policy](#route-level-k-calibration-policy) を参照。" site_en: "Per-route k̂ calibration policy (#3211): `disabled` suppresses the learned factor on this route; `max` clamps it (0 < max ≤ 4). Applied at publication time — the learned ring stays raw." site_zh: "按路由的 k̂ 校准策略(#3211):`disabled` 在该线路禁用学习系数;`max` 钳制学习系数(0 < max ≤ 4)。作用于发布环节——学习环保持原始值。" - key: compactionOptIn @@ -185,5 +204,6 @@ entries: render: route-row desc_en: "Named entries only: opt a non-http(s)-baseUrl provider into compaction ownership (pi/omp lanes); unions with env BILI_NON_HTTP_PROVIDERS." desc_zh: "仅命名条目:把非 http(s) baseUrl 供应商纳入压缩所有权(pi/omp 车道);与 env BILI_NON_HTTP_PROVIDERS 取并集。" + desc_ja: "名前付きエントリのみ:非 http(s)-baseUrl のプロバイダーを compaction 所有権にオプトイン(pi/omp レーン);環境変数 BILI_NON_HTTP_PROVIDERS と union します。" site_en: "Named entries only: opt a non-http(s)-baseUrl provider into compaction ownership (pi/omp lanes); unions with env BILI_NON_HTTP_PROVIDERS." site_zh: "仅命名条目:把非 http(s) baseUrl 供应商纳入压缩所有权(pi/omp 车道);与 env BILI_NON_HTTP_PROVIDERS 取并集。" diff --git a/website/config-reference/rollout.yaml b/website/config-reference/rollout.yaml index bf209b4fde..70c94a109f 100644 --- a/website/config-reference/rollout.yaml +++ b/website/config-reference/rollout.yaml @@ -10,6 +10,7 @@ entries: site_group: beh desc_en: "Feature rollout (canary) block: per-feature overrides of the version's baked-in rollout plan; features roll out by percent of installs, bucketed on a stable per-machine id." desc_zh: "灰度发布配置块:按特性覆盖版本内置的灰度计划;特性按安装占比放量,分桶基于每台机器稳定的 id。" + desc_ja: "機能ロールアウト(カナリア)ブロック:バージョンに組み込まれたロールアウト計画の機能ごとのオーバーライド;機能はインストール数のパーセンテージでロールアウトされ、安定したマシンごとの ID でバケット化されます。" site_en: "rollout — canary gating: features enable for a percent of installs, bucketed on a stable per-machine UUID; nested base rolls B out only inside A's cohort." site_zh: "rollout —— 灰度门控:特性按安装百分比启用,以每台机器稳定的 UUID 分桶;嵌套 base 使 B 只在 A 的入组人群内放量。" - key: rollout.installId @@ -18,12 +19,14 @@ entries: group: behavior desc_en: "Pins the bucketing identity instead of the auto-generated state-dir UUID (support/testing: pick or compute an id whose bucket lands inside a cohort)." desc_zh: "钉住分桶身份,替代 state 目录自动生成的 UUID(支持/测试用:选取或计算一个桶值落在目标人群内的 id)。" + desc_ja: "自動生成された state-dir UUID の代わりにバケット化アイデンティティをピン留め(サポート/テスト:コホート内にバケットが収まる ID を選択または計算)。" - key: rollout.features type: "record feature name → { enabled?, percent?, salt?, base? } | boolean | number" default: "{}" group: behavior desc_en: "Per-feature overrides, keyed by the feature names the running version has under rollout. enabled (boolean) overrides any percentage; percent (0–100) re-scales the cohort; salt re-randomizes it; base re-scopes the nesting. Shorthands: \"x\": true/false forces on/off, \"x\": 20 sets percent. Wrong-typed fields (e.g. enabled as a string) are ignored and named by the startup warning — never silently widening a cohort." desc_zh: "按特性覆盖,键为当前版本处于灰度中的特性名。enabled(布尔)覆盖任何百分比;percent(0–100)重设比例;salt 重新洗牌;base 重设嵌套父特性。缩写:\"x\": true/false 强制开/关,\"x\": 20 等价 percent 20。类型写错的字段(如 enabled 写成字符串)会被忽略并在启动警告中点名,绝不静默放宽圈层。" + desc_ja: "実行中バージョンが rollout 下で持つ機能名をキーとする機能ごとのオーバーライド。enabled (boolean) はパーセンテージを無視して上書き;percent (0–100) はコホートを再スケーリング;salt は再ランダム化;base はネストのスコープを再定義。ショートハンド:\"x\": true/false でオン/オフを強制、\"x\": 20 で percent を設定。型が誤ったフィールド(例:enabled が文字列)は無視され、起動時の警告で名前が示されます — コホートのサイレントな拡大は決して行われません。" - key: rollout.features.enabled type: boolean default: "unset (bucket math decides)" @@ -31,24 +34,28 @@ entries: group: behavior desc_en: "Force a gated feature on/off regardless of percentage. Env tier BILI_ROLLOUT_ (UPPER_SNAKE feature name; 0/false = off, any other value = on) wins over everything, including this field." desc_zh: "无视百分比强制开关某个灰度特性。环境变量 BILI_ROLLOUT_<特性名>(大写下划线;0/false=关,其余值=开)优先于一切,包括本字段。" + desc_ja: "パーセンテージに関係なく、ゲート付き機能を強制的にオン/オフにする。環境変数 `BILI_ROLLOUT_`(大文字スネークケースの機能名; 0/false = オフ、それ以外の値 = オン)が、このフィールドを含むすべての設定を上書きする。" - key: rollout.features.percent type: number default: "the version's baked-in plan" group: behavior desc_en: "Percent of installs (0–100, fractional allowed) that see the feature. Monotonic: raising the percent never drops an already-enabled install; the bucket is prefix-stable per install." desc_zh: "看到该特性的安装占比(0–100,支持小数)。单调:上调比例不会把已入组的安装踢出;每台安装的桶值是前缀稳定的。" + desc_ja: "機能を確認できるインストールの割合(0–100、小数可)。単調増加性を持つ:パーセンテージを上げても、すでに有効化されたインストールが失効することはない。バケットはインストールごとにプレフィックス安定である。" - key: rollout.features.salt type: string default: "the feature name" group: behavior desc_en: "Hash salt for bucketing. Changing it re-randomizes the whole cohort (the only way to reshuffle; raising percent alone never reshuffles)." desc_zh: "分桶哈希盐。修改它会重新随机整个分组(唯一的洗牌方式;仅上调 percent 永不洗牌)。" + desc_ja: "バケット分割用のハッシュソルト。変更するとコホート全体が再ランダム化される(シャッフルする唯一の方法;パーセンテージを上げるだけではシャッフルされない)。" - key: rollout.features.base type: string default: "unset (roll out over everyone)" group: behavior desc_en: "Nested rollout: evaluate this feature only inside the named feature's enabled cohort, so the percent is relative to that population (roll B out to A's users; chains allowed, cycles fail closed)." desc_zh: "嵌套灰度:仅在所指特性的已入组人群内评估本特性,percent 相对该人群(B 只放量给 A 的用户;允许链式,环路判为关)。" + desc_ja: "ネストされたロールアウト:指定された機能の有効化コホート内でのみこの機能を評価し、パーセンテージがその母集団に対する相対値となる(Aのユーザーに対してBをロールアウト;チェーンは許可、サイクルはクローズドに失敗する)。" - key: rollout.features.identityChannelHarvest type: "boolean | number" default: "0 (off)" @@ -57,6 +64,7 @@ entries: group: behavior desc_en: "Identity-channel harvest cohort gate (#5825): allows the loopback-only transcript/sqlite harvest (src/identity-harvest.ts: claude-code / codebuddy / mcode / goose / qwen lanes) without any per-install env switch, when neither the per-install switch (BILI_IDENTITY_HARVEST) nor this key is set nothing ever reads client storage. Owner ruling 2026-11-07: this cohort key is deliberately separate from rollout.features.pluginLaneServerHistory (which governs row PINNING of admitted ids) — either enabler may activate harvesting. Default 0%; raise after small-cohort observation of the degrade warn-once rate. See identity-channels.md." desc_zh: "身份信道采集的灰度门(#5825):当安装级开关(BILI_IDENTITY_HARVEST)未设置时,允许仅由本灰度键激活回环专属的转录/SQLite 采集(claude-code / codebuddy / mcode / goose / qwen 车道);两者都不设则永不读客户端存储。owner 裁定 2026-11-07:本灰度键与 rollout.features.pluginLaneServerHistory(它管已接纳 id 的行钉住)刻意分离——任一使能方可激活采集。默认 0%,小流量观察退化率后再抬。见 identity-channels.zh-CN.md。" + desc_ja: "IDチャネル収穫コホートゲート (#5825):インストールごとの環境スイッチなしで、ループバック専用のトランスクリプト/sqlite収穫(`src/identity-harvest.ts`: claude-code / codebuddy / mcode / goose / qwen レーン)を許可する。インストールごとのスイッチ(`BILI_IDENTITY_HARVEST`)もこのキーも設定されていない場合、クライアントストレージは一切読み取られない。オーナー裁定 2026-11-07:このコホートキーは `rollout.features.pluginLaneServerHistory`(承認済みIDの行固定を管理)とは意図的に分離されている — いずれかのイネーブラーが収穫を有効化できる。デフォルト 0%;小規模コホートでの degrade warn-once レートの観察後に引き上げる。`identity-channels.md` を参照。" - key: rollout.features.pluginLaneServerHistory type: "boolean | number" default: "0 (off)" @@ -65,6 +73,7 @@ entries: group: behavior desc_en: "Plugin-lane server-owned history (#4491): for enabled installs, (a) plugin-lane requests may carry an internal `biliMsgIds` array parallel to `messages` that pins message identity to client-supplied ids (always stripped before upstream forwarding; malformed arrays are ignored with a warning, id-poisoning shapes hard-fail on the incremental lane); (b) the loopback-only `POST /__bili/plugin/render` endpoint serves the outbound prefix rendered from the unified transcript (folded regions collapse to summary anchors; any desync degrades to a non-2xx so the shim falls back to its local history); (c) the incremental-lane probe advertises `serverHistory`. Default 0% — no behavior change until rolled out." desc_zh: "插件车道服务端正史(#4491):对已放量的安装,(a) 插件车道请求可携带与 `messages` 平行的内部字段 `biliMsgIds`,把消息身份钉在客户端提供的 id 上(转发上游前一律剥掉;格式错误的数组告警后忽略,身份投毒形态在增量车道直接硬失败);(b) 仅回环可达的 `POST /__bili/plugin/render` 端点从统一存储渲染出站前缀(折叠区收敛为摘要锚点;任何失步都返回非 2xx,shim 退回本地历史);(c) 增量车道探测响应通告 `serverHistory`。默认 0%,放量前无行为变化。" + desc_ja: "プラグインレーンのサーバー所有履歴 (#4491):有効化されたインストールにおいて、(a) プラグインレーンのリクエストは `messages` と並行して内部 `biliMsgIds` 配列を持ち、メッセージIDをクライアント提供のIDに固定できる(上流転送前に常に除去;不正な配列は警告付きで無視、ID汚染形状は増分レーンでハードフェイル);(b) ループバック専用の `POST /__bili/plugin/render` エンドポイントは、統合トランスクリプトからレンダリングされた送信プレフィックスを提供する(折り畳み領域はサマリアンカーに縮小;デシンクは非2xxにデグレードし、シムはローカル履歴にフォールバック);(c) 増分レーンのプローブは `serverHistory` をアドバタイズする。デフォルト 0% — ロールアウトされるまで挙動は変わらない。" - key: rollout.features.pluginFullResendWatermark type: "boolean | number" default: "5 (experimental grey)" @@ -73,3 +82,4 @@ entries: group: behavior desc_en: "Full-resend watermark fastpath (#5403/#5418): plugin-lane chat-completions turns whose previous response carried an x-bili-pf-seq stamp assert the resent prefix via the echoed count (structural scan, no full parse); on a hit the pipeline consumes stashed canonical prefix cores plus only the new tail window (byte-identical outbound provenance; ANY doubt falls back to the untouched full-parse path per turn and re-stamps, five credited misses hold the lane for one hour). Requires the client to echo the stamp back as x-bili-pf-count (dsh/pi/opencode/omp do; unadapted lanes never hit). EXPERIMENTAL grey rollout — ON by default for roughly 5% of installs (owner ruling 2026-11-02: small cohort before GA; one-time intro notice in the web UI for every install, tri-state switch in quick config). Force it with `true`, turn off with `false` (or a percent) / env = 0. See technical-notes.md “Full-resend watermark fastpath”." desc_zh: "全量重发水位快路径(#5403/#5418):插件车道 chat-completions 回合若上一轮响应盖有 x-bili-pf-seq,则用回声计数声明重发前缀(结构扫描,不做全量解析);命中时管线只消费钉存的前缀核 + 新增尾巴窗口(出站字节同源可证;任何疑点当轮回退未动过的全量解析路径并重新盖戳,连续五次计名失配将车道按住一小时)。需客户端把戳回声为 x-bili-pf-count(适配的车道回带;其余车道不会命中)。**实验性灰度**——默认仅约 5% 的安装开启(owner 裁定 2026-11-02:先小流量再 GA;web 面板对全部安装显示一次性公告、快速配置提供三态开关);`true` 强制开、`false`(或百分比)/ env = 0 关。见 technical-notes.zh-CN.md「全量重发水位快路径」。" + desc_ja: "フルリセンドウォーターマークファストパス (#5403/#5418):前回のレスポンスに `x-bili-pf-seq` ス tamp を持っていたプラグインレーンのチャットコンプリートターンでは、エコーされたカウントにより再送信プレフィックスをアサートする(構造スキャン、フルパースなし);ヒット時にパイプラインはスタッシュされた正規プレフィックスコアと新しいテールウィンドウのみを消費する(バイト同一の送信プロベナンス;疑義がある場合はターンごとに未変更のフルパースパスにフォールバックし再スタンプ、5回のクレジットミスでレーンを1時間保持)。クライアントがスタンプを `x-bili-pf-count` としてエコーバックすることを要求(dsh/pi/opencode/omp は対応;未適応レーンはヒットしない)。実験的グレースケールロールアウト — インストールの約5%でデフォルトON(オーナー裁定 2026-11-02:GA前に小規模コホート;Web UIで全インストールに一度限りの導入通知、クイック設定に3状態スイッチ)。`true` で強制、`false`(またはパーセンテージ)/ 環境変数 = 0 でオフ。`technical-notes.md` の「Full-resend watermark fastpath」を参照。" diff --git a/website/config-reference/server.yaml b/website/config-reference/server.yaml index 71b6ea4931..d05c9e7e50 100644 --- a/website/config-reference/server.yaml +++ b/website/config-reference/server.yaml @@ -15,6 +15,7 @@ entries: site_group: core desc_en: "TCP port the proxy listens on (user zone; lane-spawned proxies use BILI_ZONE_PORT instead)." desc_zh: "代理监听端口(用户区;车道派生代理使用 BILI_ZONE_PORT,互不干扰)。" + desc_ja: "プロキシがリッスンするTCPポート(ユーザーゾーン;レーンスポーンされたプロキシは `BILI_ZONE_PORT` を使用)。" site_en: "port — listen port (default 8787)." site_zh: "port —— 监听端口(默认 8787)。" - key: host @@ -26,6 +27,7 @@ entries: site_group: core desc_en: "Bind address. 127.0.0.1 = loopback only; :: = dual-stack; 0.0.0.0 exposes outward (no auth — trusted networks only)." desc_zh: "绑定地址。127.0.0.1 仅本机回环;:: 双栈;0.0.0.0 对外暴露(无鉴权,仅限可信网络)。" + desc_ja: "バインドアドレス。127.0.0.1 = ループバック専用;:: = デュアルスタック;0.0.0.0 は外部に公開(認証なし — 信頼できるネットワークのみ)。" site_en: "host — bind address (default 127.0.0.1; \"::\" is dual-stack, 0.0.0.0 exposes outward)." site_zh: "host —— 绑定地址(默认 127.0.0.1;\"::\" 双栈,0.0.0.0 对外暴露)。" - key: sessionHeader @@ -37,6 +39,7 @@ entries: site_group: core desc_en: "HTTP header carrying the conversation id; same value shares compression state." desc_zh: "携带会话 id 的请求头;相同取值的请求共享压缩状态。" + desc_ja: "会話IDを保持するHTTPヘッダー;同じ値は圧縮状態を共有する。" site_en: "sessionHeader — HTTP header carrying the session id (default x-acp-session)." site_zh: "sessionHeader —— 携带会话 id 的请求头(默认 x-acp-session)。" - key: log @@ -48,6 +51,7 @@ entries: site_group: core desc_en: "Per-request logging master switch." desc_zh: "逐请求日志总开关。" + desc_ja: "リクエストごとのログ記録マスタースイッチ。" site_en: "log — file logging master switch (on by default)." site_zh: "log —— 文件日志总开关(默认开)。" - key: logFile @@ -59,6 +63,7 @@ entries: site_group: core desc_en: "Explicit path for bili.log; auto-rotates at 10 MB." desc_zh: "bili.log 的显式路径;10 MB 自动轮转。" + desc_ja: "`bili.log` の明示的なパス;10 MB で自動ローテーション。" site_en: "logFile — explicit path for bili.log (env ACP_LOG_FILE wins)." site_zh: "logFile —— bili.log 显式路径(环境变量 ACP_LOG_FILE 优先)。" - key: debug @@ -70,6 +75,7 @@ entries: site_group: core desc_en: "Verbose per-request logging." desc_zh: "逐请求详细日志。" + desc_ja: "詳細なリクエストごとのログ記録。" site_en: "debug — verbose per-request logging." site_zh: "debug —— 逐请求详细日志。" - key: dumpSse @@ -81,6 +87,7 @@ entries: site_group: core desc_en: "Directory to dump raw SSE frames for debugging, including loop-originated responses." desc_zh: "原始 SSE 帧转储目录(排障用),含循环内发起的上游响应。" + desc_ja: "デバッグ用に生SSEフレームをダンプするディレクトリ、ループ起源のレスポンスを含む。" site_en: "dumpSse — raw SSE stream dump level for debugging." site_zh: "dumpSse —— 原始 SSE 流转储级别(排障用)。" - key: passthrough @@ -92,6 +99,7 @@ entries: site_group: core desc_en: "Global raw-relay switch: forward every request without compression, tool injection, or nudging." desc_zh: "全局裸转发开关:所有请求不做压缩、工具注入或提醒直接转发。" + desc_ja: "グローバルな生リレースイッチ:圧縮、ツール注入、ナッジなしですべてのリクエストを転送する。" site_en: "passthrough — global raw-relay switch (off by default; ACP_PASSTHROUGH / --passthrough win over the file)." site_zh: "passthrough —— 全局裸转发开关(默认关;ACP_PASSTHROUGH / --passthrough 优先于文件)。" - key: upstream @@ -103,6 +111,7 @@ entries: site_group: up desc_en: "Fallback upstream base URL when a request matches no provider route." desc_zh: "请求未命中任何路由时的兜底上游基础地址。" + desc_ja: "リクエストがどのプロバイダルートにも一致しない場合のフォールバック用アップストリームベースURL。" site_en: "upstream — fallback upstream base URL (ACP_UPSTREAM overrides)." site_zh: "upstream —— 兜底上游基础地址(ACP_UPSTREAM 覆盖)。" - key: proxy @@ -114,6 +123,7 @@ entries: site_group: up desc_en: "Global outbound proxy for the proxy's own egress. Resolution: per-route → BILI_UPSTREAM_PROXY → Web UI → this value → HTTP(S)_PROXY → Windows system proxy → direct. Empty string = explicitly direct; SOCKS5 rejected." desc_zh: "代理自身出站的全局代理。解析顺序:按路由 → BILI_UPSTREAM_PROXY → Web UI → 本值 → HTTP(S)_PROXY 环境变量 → Windows 系统代理 → 直连。空字符串 = 显式直连;不支持 SOCKS5。" + desc_ja: "プロキシ自身のエグレス(外部送信)用のグローバルアウトバウンドプロキシ。解決順序: ルート別 → BILI_UPSTREAM_PROXY → Web UI → この値 → HTTP(S)_PROXY → Windows システムプロキシ → 直接接続。空文字列は明示的な直接接続を意味し、SOCKS5 は拒否される。" site_en: "proxy — global outbound proxy. Resolution: per-route → BILI_UPSTREAM_PROXY → Web UI → this value → HTTP(S)_PROXY env → Windows system proxy → direct. Empty string = explicitly direct; SOCKS5 is rejected." site_zh: "proxy —— 全局出站代理。解析顺序:按路由 → BILI_UPSTREAM_PROXY → Web UI → 本值 → HTTP(S)_PROXY 环境变量 → Windows 系统代理 → 直连。空字符串 = 显式直连;不支持 SOCKS5。" - key: upstreamProxy @@ -122,6 +132,7 @@ entries: group: upstream desc_en: "Web-UI manual proxy tier (written by the dashboard's proxy editor); sits below BILI_UPSTREAM_PROXY in resolution order." desc_zh: "Web 面板手动设置的代理层级(由仪表盘代理编辑器写入);解析顺序中位于 BILI_UPSTREAM_PROXY 之下。" + desc_ja: "Web-UI 手動プロキシ階層(ダッシュボードのプロキシエディタによって書き込まれる)。解決順序では BILI_UPSTREAM_PROXY より下位にある。" - key: upstreamProxyMode type: "\"auto\" | \"manual\" | \"direct\"" default: "auto (unset behaves as direct)" @@ -129,6 +140,7 @@ entries: group: upstream desc_en: "How the global proxy is sourced: auto (env/system discovery), manual (Web-UI value only), direct (never use a proxy)." desc_zh: "全局代理来源策略:auto(环境变量/系统发现)、manual(仅 Web 面板值)、direct(从不使用代理)。" + desc_ja: "グローバルプロキシの取得方法: auto(環境変数/システム検出)、manual(Web-UI の値のみ)、direct(プロキシを一切使用しない)。" - key: providersPath type: string default: "unset" @@ -138,6 +150,7 @@ entries: site_group: mitm desc_en: "Path to an external providers.json (legacy/shared routes file); beats both inline providers and the config-file location." desc_zh: "外部 providers.json 路径(遗留/共享路由文件);优先于内联 providers 与配置文件位置。" + desc_ja: "外部 providers.json へのパス(レガシー/共有ルートファイル)。インラインプロバイダおよび設定ファイル内の場所の両方よりも優先される。" site_en: "providersPath — external routes file path (env ACP_PROVIDERS beats both it and inline providers)." site_zh: "providersPath —— 外部路由文件路径(环境变量 ACP_PROVIDERS 优先于它与内联 providers)。" - key: providers @@ -146,6 +159,7 @@ entries: group: upstream desc_en: "Route table: URL-prefix keys to per-provider entries (models, compress, compat, …). See the Providers section." desc_zh: "路由表:URL 前缀键到逐 provider 条目(models、compress、compat…)的映射。详见 Providers 章节。" + desc_ja: "ルートテーブル: URLプレフィックスキーをプロバイダ別エントリ(モデル、compress、compat など)にマッピングする。Providers セクションを参照。" - key: modelEndpointPatterns type: "array of { match: string, wire: \"anthropic\" | \"openai\" | \"responses\" | \"google\" | \"commandcode\" }" default: "[]" @@ -154,6 +168,7 @@ entries: site_group: up desc_en: "Declarable custom-wire model endpoints: absolute URL prefixes mapped to a wire family. One config source feeds BOTH the proxy protocol classifier and the client-side fetch claim, so the two gates can no longer drift (#1295)." desc_zh: "可声明的自定义 wire 模型端点:绝对 URL 前缀到 wire 族的映射。同一配置源同时喂给代理协议分类器与客户端 fetch 认领,两个门不再漂移(#1295)。" + desc_ja: "宣言可能なカスタムワイヤモデルエンドポイント: ワイヤファミリにマッピングされる絶対URLプレフィックス。1つの設定ソースがプロキシのプロトコル分類器とクライアントサイドのフェッチクレームの両方に供給されるため、2つのゲートが乖離しなくなった(#1295)。" site_en: "modelEndpointPatterns — declare model endpoints on non-standard paths (URL prefix → wire family); empty = built-in path tables only." site_zh: "modelEndpointPatterns —— 声明非标准路径上的模型端点(URL 前缀 → wire 族);空 = 仅内置路径表。" - key: modelContextLimit @@ -165,6 +180,7 @@ entries: site_group: up desc_en: "Legacy global DEFAULT window (last-resort fallback in the window ladder: consulted only when no tier evidence, plugin/launcher report, per-route declaration, registry lookup, or built-in table resolves a limit for the model; also the usage-ratio denominator wherever it wins); prefer compress.modelContextLimit." desc_zh: "旧版全局默认窗口(窗口解析阶梯的最后一层兜底:仅当 tier 证据、plugin/launcher 报告、路由声明、注册表查询、内置表都未解析出该模型的上限时才使用;在其生效的会话里兼作使用率分母);建议改用 compress.modelContextLimit。" + desc_ja: "レガシーのグローバル DEFAULT ウィンドウ(ウィンドウラダーにおける最終手段のフォールバック: モデルの制限がティア証拠、プラグイン/ランチャーレポート、ルート別宣言、レジストリ検索、組み込みテーブルのいずれからも解決されない場合にのみ参照される。また、勝った場合の使用率の分母としても機能する)。compress.modelContextLimit を優先すること。" site_en: "modelContextLimit — legacy global DEFAULT window (default 200000): last-resort fallback when no other source resolves a limit for the model; does NOT cap a natively-resolved window (#5908); prefer compress.modelContextLimit." site_zh: "modelContextLimit —— 旧版全局默认窗口(默认 200000):窗口解析的最后一层兜底,其他来源都未解析出该模型上限时才生效;不会封顶已按原生解析出的窗口(#5908);建议改用 compress.modelContextLimit。" - key: imageBilling @@ -176,6 +192,7 @@ entries: site_group: up desc_en: "Global image-token estimation basis; live-read per request, beats every per-provider setting." desc_zh: "全局图片 token 估算口径;逐请求实时读取,优先于所有逐 provider 设置。" + desc_ja: "グローバルなイメージトークン推定基準。リクエストごとにライブ読み取りされ、すべてのプロバイダ別設定を上回る。" site_en: "imageBilling — global image-token estimation: \"auto\" (default → pixels), \"pixels\" or \"bytes\" (explicit opt-in for byte relays)." site_zh: "imageBilling —— 全局图片 token 估算口径:\"auto\"(默认→pixels)、\"pixels\" 或 \"bytes\"(字节中继需显式指定)。" - key: imageTokenCap @@ -187,6 +204,7 @@ entries: site_group: up desc_en: "Global per-image token ceiling applied on top of the resolved billing mode; live-read per request." desc_zh: "全局单图 token 上限,叠加在计费口径之上生效;逐请求实时读取。" + desc_ja: "解決された課金モードの上に適用されるグローバルな1画像あたりのトークン上限。リクエストごとにライブ読み取りされる。" site_en: "imageTokenCap — global per-image token cap; unset = uncapped (BILI_IMAGE_TOKEN_CAP wins, read live)." site_zh: "imageTokenCap —— 全局单图 token 上限;未设置 = 不限(BILI_IMAGE_TOKEN_CAP 优先且实时读取)。" - key: imageRescale @@ -198,6 +216,7 @@ entries: site_group: up desc_en: "Egress image downscale master switch (#3295/#3400): large outbound images are sent shrunken while originals stay untouched in session storage. Live-read per request." desc_zh: "出站图片降采样总开关(#3295/#3400):大图以缩小形态发给模型,原图在会话存储中保持字节级原样。逐请求实时读取。" + desc_ja: "エグレス画像のダウンスケールマスタースイッチ(#3295/#3400): 大きなアウトバウンド画像は縮小して送信され、セッションストレージ内のオリジナルは変更されない。リクエストごとにライブ読み取りされる。" site_en: "imageRescale — egress downscale switch; large outbound images sent shrunken, originals kept byte-exact in session storage." site_zh: "imageRescale —— 出站图片降采样总开关;大图以缩小形态出站,原图在会话存储中保持字节级原样。" - key: egressTransforms @@ -209,6 +228,7 @@ entries: site_group: up desc_en: "User-registerable egress request-body rewrite pipeline (#6003): ESM plugins that rewrite every outbound model-request body after all session processing and before transport (re-sign / v1Wrap / fetch). Fail-open, hot-reloadable via POST /__bili/config/reload." desc_zh: "用户可注册的出站请求体改写管线(#6003):ESM 插件在所有会话处理之后、传输(重签 / v1Wrap / fetch)之前改写每个出站模型请求体。fail-open,可经 POST /__bili/config/reload 热重载。" + desc_ja: "ユーザー登録可能なエグレスリクエストボディ書き換えパイプライン(#6003): すべてのセッション処理の後、トランスポート(再署名 / v1Wrap / fetch)の前に、すべてのアウトバウンドモデルリクエストボディを書き換える ESM プラグイン。フェイルオープン、POST /__bili/config/reload によるホットリロード可能。" site_en: "egressTransforms — user-registerable egress body-rewrite pipeline (ESM plugins, fail-open, hot-reloadable)." site_zh: "egressTransforms —— 用户可注册的出站请求体改写管线(ESM 插件,fail-open,可热重载)。" - key: billing @@ -220,6 +240,7 @@ entries: site_group: up desc_en: "Per-model billing prices (#4899): billing.prices[model] = { input, output?, cacheRead?, cacheWrite? } in USD per million tokens; overrides the models.dev snapshot for the panel's USD spend ledger and saved-dollar estimate. Unpriced models show tokens only." desc_zh: "按模型计费单价(#4899):billing.prices[模型] = { input, output?, cacheRead?, cacheWrite? },美元/百万 token;覆盖 models.dev 快照价,驱动面板美元花费台账与省钱折算。无价模型只显示 token。" + desc_ja: "モデルごとの課金価格(#4899): billing.prices[model] = { input, output?, cacheRead?, cacheWrite? } は100万トークンあたりの USD 単位。パネルの USD 支出台帳と保存済みドル推定値において、models.dev スナップショットを上書きする。価格未設定のモデルはトークン数のみ表示される。" site_en: "billing.prices — per-model USD/Mtok prices feeding the panel's spend + savings views." site_zh: "billing.prices —— 按模型美元/百万 token 单价,驱动面板花费与省钱视图。" - key: maskHosts @@ -231,6 +252,7 @@ entries: site_group: beh desc_en: "Mask non-public target hosts in logs as ; credential headers are always masked regardless." desc_zh: "日志中把非公开目标主机遮成 ;凭据头无论此开关如何总是遮盖。" + desc_ja: "ログ内の非公開ターゲットホストを としてマスクする。認証情報ヘッダーは常にマスクされる。" site_en: "maskHosts — mask non-public host names in logs as <private-host> (on by default; credentials are always masked)." site_zh: "maskHosts —— 日志中把非公开主机名遮成 <private-host>(默认开;凭据总是遮盖)。" - key: security.adminRelay @@ -241,6 +263,7 @@ entries: site_group: beh desc_en: "Let an embedding host (dsh web today) relay the ENTIRE /__bili/ admin surface through its own entry origin so a remote browser can open the panel (#3373). Fail-closed, file-only. The relayed hop reaches the proxy as a local non-browser client (loopback source + loopback Host, no Origin), so the admin gate stays unchanged; enabling it exposes config editing and credential writes to whoever can reach the host web entry — protect that entry (auth / reverse proxy) first." desc_zh: "允许宿主(当前为 dsh web)把它自己入口域名下的整个 /__bili/ 管理面中继到本机代理,使远程浏览器能打开面板(#3373)。默认关闭、仅配置文件。中继跳到达代理时是本机非浏览器客户端(回环源地址 + 回环 Host、无 Origin 头),管理端门槛不变;开启后,凡能访问宿主 web 入口的人都能改配置、写凭据——请先给入口加鉴权/反代。" + desc_ja: "エンベディングホスト(現在は dsh web)が、リモートブラウザからパネルを開けるように(#3373)、その自身のエントリーオリジンを通じて /__bili/ 管理サーフェス全体をリレーすることを許可する。フェイルクローズ、ファイルのみ。リレーされたホップはローカル非ブラウザクライアントとしてプロキシに到達する(ループバックソース + ループバック Host、Origin なし)ため、管理ゲートは変更されない。これを有効にすると、ホスト Web エントリーに到達できる者に設定編集と認証情報の書き込みが露出する — まずそのエントリー(認証 / リバースプロキシ)を保護すること。" site_en: "security.adminRelay — relay the /__bili/ admin surface through the embedding host's web entry (off by default; fail-closed)." site_zh: "security.adminRelay —— 将 /__bili/ 管理面经宿主 web 入口中继(默认关;fail-closed)。" - key: subagentSplit @@ -252,6 +275,7 @@ entries: site_group: beh desc_en: "Claude Code subagents get their own session namespace (|sub:) instead of queueing behind the main session. Anthropic-wire only — on the Responses wire this switch is a no-op (see the `subagentSplit` / BOTH-mechanisms scope note)." desc_zh: "Claude 子代理拥有独立会话命名空间(|sub:),不再排队在主会话锁后。仅 anthropic 线路 —— Responses 线路上本开关无效(见 `subagentSplit` / BOTH-mechanisms 作用域说明)。" + desc_ja: "Claude Code サブエージェントは、メインセッションのキューに並ぶ代わりに、独自のセッション名前空間(|sub:)を取得します。Anthropic-wire 専用 — Responses wire ではこのスイッチは no-op です(`subagentSplit` / BOTH-mechanisms スコープ注記を参照)。" site_en: "subagentSplit — Claude subagents get their own session namespace (on by default)." site_zh: "subagentSplit —— Claude 子代理拥有独立会话命名空间(默认开)。" - key: personaSplit @@ -263,6 +287,7 @@ entries: site_group: beh desc_en: "Split the Responses-wire lane keyed by the instructions fingerprint (Claude Code over /v1/responses; Codex root threads / older builds) when the instructions text changes AND the incoming history does not continue the tracked chain (default on). Opt out with env BILI_PERSONA_SPLIT=0 or personaSplit: false (env wins)." desc_zh: "当 instructions 文本变化且入站历史不连续时,把按 instructions 指纹分键的 Responses 车道(Claude Code over /v1/responses;Codex 根线程 / 旧版本构建)分叉出去(默认开)。用环境变量 BILI_PERSONA_SPLIT=0 或配置 personaSplit: false 关闭(环境变量优先)。" + desc_ja: "指示テキストが変更され、かつ受信履歴が追跡中のチェーンを継続していない場合、指示フィンガープリントでキー付けされた Responses-wire レーンを分割します(Claude Code の /v1/responses 経由; Codex ルートスレッド / 旧ビルド)。デフォルトで有効。環境変数 BILI_PERSONA_SPLIT=0 または personaSplit: false で無効化可能(環境変数が優先)。" site_en: "personaSplit — Responses-wire instructions-fingerprint split (on by default; set false / BILI_PERSONA_SPLIT=0 to opt out)." site_zh: "personaSplit —— Responses 线路 instructions 指纹分叉(默认开;false / BILI_PERSONA_SPLIT=0 关闭)。" - key: forkAdoption @@ -274,6 +299,7 @@ entries: site_group: beh desc_en: "Anonymous forks inherit the parent's compression blocks whose source content is fully present in the forked request." desc_zh: "匿名 fork 会话继承父会话中源内容完整存在于本次请求里的压缩块。" + desc_ja: "匿名フォークは、フォークされたリクエストにソースコンテンツが完全に存在する親の圧縮ブロックを継承します。" site_en: "forkAdoption — adopt anonymous forks into their parent session (off by default)." site_zh: "forkAdoption —— 匿名 fork 会话并入父会话(默认关)。" - key: autoModeForge.enabled @@ -285,6 +311,7 @@ entries: site_group: beh desc_en: "Answer Claude Code auto-mode safety-classifier calls locally with a forged allow verdict instead of forwarding them upstream (#2740): zero egress, zero billing for that lane; every forged verdict is audit-logged and the session carries a notice badge. false / env 0 restores pure passthrough for users who pay for real verdicts." desc_zh: "Claude Code auto mode 安全分类器请求由 bili 在本地代答放行判定,不再转发上游(#2740):该旁路零流出、零计费;每条代答写审计日志,会话带提示徽标。false / env 0 恢复纯透传(愿意付费要真判定的用户)。" + desc_ja: "Claude Code の自動モードのセーフティ分類器呼び出しを、上流へ転送する代わりに、偽造された許可判定でローカルに回答します(#2740):そのレーンでは送信ゼロ、課金ゼロ。すべての偽造判定は監査ログに記録され、セッションには通知バッジが付与されます。false / 環境変数 0 で、実際の判定料金を支払うユーザー向けに純粋なパススルーに戻ります。" site_en: "autoModeForge.enabled — answer Claude Code auto-mode classifier calls locally with a forged allow verdict (on by default; BILI_AUTO_MODE_FORGE=0 = pure passthrough)." site_zh: "autoModeForge.enabled —— Claude Code auto mode 分类器请求本地代答放行判定(默认开;BILI_AUTO_MODE_FORGE=0 纯透传)。" - key: affinitySimhash @@ -296,6 +323,7 @@ entries: site_group: beh desc_en: "Simhash chain-alignment adoption for anonymous clients (#2265): a client-side pervasive decorative rewrite (e.g. Trae re-stamping model tags on every assistant message) re-attaches the existing session with its compression state instead of minting fresh and re-folding from zero." desc_zh: "匿名客户端的 simhash 链对齐收养(#2265):客户端侧大面积装饰性改写(如 Trae 切模型后给每条 assistant 消息重打模型标签)时,重新挂回既有会话并保留压缩状态,而不是每次新铸会话、从零重折。" + desc_ja: "匿名クライアント向けの Simhash チェーン整合性採用(#2265):クライアント側の普遍的な装飾的書き換え(例:Trae がすべてのアシスタントメッセージにモデルタグを再スタンプする)が発生した場合、ゼロから新規発行して再折りたたむ代わりに、既存のセッションとその圧縮状態を再アタッチします。" site_en: "affinitySimhash — simhash chain-alignment re-attaches sessions after pervasive client rewrites (on by default)." site_zh: "affinitySimhash —— 大面积客户端改写后按 simhash 链对齐重新挂回会话(默认开)。" - key: resumeInheritance @@ -307,6 +335,7 @@ entries: site_group: beh desc_en: "Identified clients resuming under a new session id inherit the parent's ref assignments and fully-present compression blocks." desc_zh: "以新会话 id 恢复的已识别客户端继承父会话的引用编号与完整存在的压缩块。" + desc_ja: "新しいセッション ID で再開する識別済みクライアントは、親の ref 割り当てと完全に存在する圧縮ブロックを継承します。" site_en: "resumeInheritance — inherited refs/blocks on resume (cc --resume) (on by default)." site_zh: "resumeInheritance —— resume(cc --resume)继承引用与区块(默认开)。" - key: chainContentDetection @@ -318,6 +347,7 @@ entries: site_group: beh desc_en: "Body-content detection of bili→bili chains (off: body scanning can false-positive on CCR/model-echoed text); by default only x-bili-hop drives chain recognition." desc_zh: "按请求体内容识别 bili→bili 链(默认关:正文扫描会对 CCR/模型回声文本误报);默认仅 x-bili-hop 驱动链识别。" + desc_ja: "bili→bili チェーンのボディコンテンツ検出(オフ:ボディスキャンは CCR/モデルエコーテキストで誤検出する可能性がある);デフォルトでは x-bili-hop のみでチェーン認識を駆動します。" site_en: "chainContentDetection — recognize bili-owned traffic by body content (off; false-positive risk)." site_zh: "chainContentDetection —— 按请求体内容识别 bili 自有流量(默认关;有误报风险)。" - key: chainEgressStamp @@ -329,6 +359,7 @@ entries: site_group: beh desc_en: "Emit the model-visible checkpoint carrier on egress (off: models treat it as phantom input and burn tokens)." desc_zh: "在出口消息上打模型可见的 链完整性标记(默认关:模型会把它当幽灵输入而消耗 token)。" + desc_ja: "送信時にモデル可視の チェックポイントキャリアを発行します(オフ:モデルはこれを幻覚入力として扱い、トークンを消費します)。" site_en: "chainEgressStamp — model-visible stamp on egress messages (off; burns tokens)." site_zh: "chainEgressStamp —— 在出口消息上打模型可见的标记(默认关;消耗 token)。" - key: stableSystemAnchor @@ -340,6 +371,7 @@ entries: site_group: beh desc_en: "Best-effort wire-layer prefix-cache anchor: re-sends the first-seen head system bytes even when the client changes them (plain-proxy lanes only)." desc_zh: "线路层尽力而为的前缀缓存锚点:客户端改动头部 system 时仍重发首次见到的字节(仅纯代理通道)。" + desc_ja: "ベストエフォートのワイヤーレイヤープレフィックスキャッシュアンカー:クライアントが変更した場合でも、最初に確認されたヘッドシステムバイトを再送信します(プレーンプロキシレーンのみ)。" site_en: "stableSystemAnchor — best-effort wire-layer prefix-cache anchor (off; plain-proxy lanes)." site_zh: "stableSystemAnchor —— 线路层尽力而为的前缀缓存锚点(默认关;纯代理通道)。" - key: compat @@ -350,6 +382,7 @@ entries: site_group: beh desc_en: "Global wire-compat block: role remaps, strict-schema field drops, stream error shape, cache-control handling." desc_zh: "全局线上兼容块:角色映射、严格 schema 字段剔除、流式错误形态、缓存控制处理。" + desc_ja: "グローバルワイヤー互換性ブロック:ロールリマップ、厳格スキーマフィールドの削除、ストリームエラー形状、cache-control 処理。" site_en: "compat — wire-compatibility block: role remaps, stream error shape, strict-schema field drops, cache-control handling." site_zh: "compat —— 线上兼容块:角色映射、流式错误形态、严格 schema 字段剔除、缓存控制处理。" - key: compat.roles @@ -358,12 +391,14 @@ entries: group: behavior desc_en: "Map message roles to the names your upstream accepts (e.g. developer→system); exact-match roles only, per-provider entries win per key." desc_zh: "把消息角色映射为上游接受的名字(如 developer→system);仅精确匹配角色,逐 provider 条目按键级胜出。" + desc_ja: "メッセージロールを上流が受け入れる名前にマッピングします(例:developer→system);完全一致ロールのみ、プロバイダーごとのエントリがキーごとに優先されます。" - key: compat.dropFields type: "string[] (dot paths)" default: "[]" group: behavior desc_en: "Dot-path fields stripped from every forwarded body for strict-schema gateways that 400 on unknown fields; global + per-provider lists union additively." desc_zh: "从每个转发请求体中剔除的点路径字段,面向对未知字段返回 400 的严格 schema 网关;全局与逐 provider 列表加法并集。" + desc_ja: "未知のフィールドで 400 を返す厳格スキーマゲートウェイ向けに、転送されるすべてのボディからドットパスフィールドを削除します;グローバル + プロバイダーごとのリストは加算的に統合されます。" - key: compat.streamErrorShape type: "\"protocol\" | \"completion\"" default: "protocol" @@ -371,6 +406,7 @@ entries: group: behavior desc_en: "How upstream stream failures are presented after the 200 is committed: protocol-native error frames (default) or the legacy synthesized-completion shape." desc_zh: "200 已提交后上游流失败的呈现方式:协议原生错误帧(默认)或旧版合成完成形态。" + desc_ja: "200 がコミットされた後、上流ストリーム失敗がどのように提示されるか:プロトコルネイティブのエラーフレーム(デフォルト)またはレガシーの合成完了形状。" - key: compat.noCacheControl type: boolean default: "false" @@ -378,6 +414,7 @@ entries: group: behavior desc_en: "Stop stamping Anthropic-lane cache_control breakpoints entirely (escape hatch for upstreams/relays with their own breakpoint policy)." desc_zh: "完全停止 Anthropic 通道的 cache_control 断点打标(面向拒收该字段或有自有断点策略的上游/中继的逃生门)。" + desc_ja: "Anthropic レーンの cache_control ブレークポイントを完全にスタンプしないようにします(独自のブレークポイントポリシーを持つ上流/リレー用のエスケープハッチ)。" - key: compat.keepResponseId type: boolean default: "false" @@ -385,6 +422,7 @@ entries: group: behavior desc_en: "Preserve previous_response_id on kernel-rebuilt Responses requests (default strips it so rebuilt bodies never reference ids the upstream never issued)." desc_zh: "在内核重建的 Responses 请求上保留 previous_response_id(默认剔除,使重建请求体永不引用上游从未签发过的响应 id)。" + desc_ja: "カーネル再構築された Responses リクエストで previous_response_id を保持します(デフォルトでは削除するため、再構築されたボディは上流が発行したことのない ID を参照しません)。" - key: dsh type: object default: "{}" @@ -392,6 +430,7 @@ entries: group: behavior desc_en: "Section recognized but its former escape hatch is gone (#3666, superseding #2028): the allowDshCompaction key and the BILI_ALLOW_DSH_COMPACTION env var no longer exist — dsh native compaction is refused unconditionally by the wire guard on every lane. Leftover dsh.allowDshCompaction values are ignored with a one-time deprecation warning; apply host-side suppression instead (#3354/#2474). The live keys — dsh.authoredCompaction, dsh.contextTab, dsh.contextTabLabel — are documented in the following entries." desc_zh: "段仍被识别,但其原逃生门已移除(#3666,取代 #2028):allowDshCompaction 键与 BILI_ALLOW_DSH_COMPACTION 环境变量已不存在——dsh 原生压缩现在在所有线路上被无条件拒绝。遗留的 dsh.allowDshCompaction 取值会被忽略(一次性弃用警告);请改用宿主侧抑制(#3354/#2474)。存活的键——dsh.authoredCompaction、dsh.contextTab、dsh.contextTabLabel——见接下来的条目。" + desc_ja: "セクションは認識されるが、従来のエスケープハッチは削除された(#3666、#2028 を代替):`allowDshCompaction` キーおよび `BILI_ALLOW_DSH_COMPACTION` 環境変数はもはや存在しない — dsh ネイティブコンパクションは、すべてのレーンにおいてワイヤガードによって無条件に拒否される。残存する `dsh.allowDshCompaction` の値は、一度限りの非推奨警告とともに無視される;代わりにホスト側の抑制を適用すること(#3354/#2474)。ライブキー — `dsh.authoredCompaction`、`dsh.contextTab`、`dsh.contextTabLabel` — は以下のエントリに文書化されている。" - key: dsh.authoredCompaction type: boolean default: "true (on, #3901 flip)" @@ -399,6 +438,7 @@ entries: group: behavior desc_en: "bili answers dsh compaction summarize calls locally with the folded snapshot instead of refusing (#3723/#3733). ON by default since the 0.1.203 dogfood window held; false (or env BILI_DSH_AUTHORED_COMPACTION=0) restores the #1729 refusal path." desc_zh: "bili 用折叠快照本地应答 dsh 压缩摘要请求而非拒绝(#3723/#3733)。0.1.203 狗粮窗口守住后默认开启;false(或环境变量 BILI_DSH_AUTHORED_COMPACTION=0)恢复 #1729 拒绝路径。" + desc_ja: "bili は dsh コンパクションの summarize 呼び出しを、拒否する代わりに折り畳みスナップショットでローカルに回答する(#3723/#3733)。0.1.203 のドッグフッド期間が維持されたため、デフォルトで ON。`false`(または環境変数 `BILI_DSH_AUTHORED_COMPACTION=0`)を設定すると、#1729 の拒否パスが復元される。" - key: dsh.contextTab type: boolean default: "true" @@ -406,12 +446,14 @@ entries: group: behavior desc_en: "Registers the DSH top-bar 「上下文」/「Context」 conversation tab at all (#3862/#4237): false removes ONLY that tab — compression, the settings section and every other surface keep working. Hiding never disables compression; the ledger stays reachable via the settings section (会话 subpage), the plugin bundle config face, the Web UI and the /acp command. Takes effect on the next page load / dsh restart (slot registration happens at page load); default true = today's behavior unchanged." desc_zh: "是否注册 DSH 顶栏「上下文」会话标签页(#3862/#4237):false 只移除该标签页——压缩、设置页一节及其余所有入口不受影响。隐藏绝不关闭压缩;账本仍可从设置页(会话子页)、插件 bundle 配置面、Web UI 与 /acp 命令查看。下次页面加载 / dsh 重启生效(槽位注册发生在页面加载时);默认 true = 现状不变。" + desc_ja: "DSH トップバーの「上下文」/「Context」会話タブを登録する(#3862/#4237):`false` にすると、そのタブのみが削除される — コンプレッション、設定セクション、その他のすべてのサーフェスは引き続き動作する。非表示にしてもコンプレッションは無効にならない;台帳は設定セクション(会话 サブページ)、プラグインバンドル設定フェイス、Web UI、および `/acp` コマンド経由で引き続きアクセス可能。次のページ読み込み / dsh リスタート時に有効になる(スロット登録はページ読み込み時に発生);デフォルト `true` = 現在の動作は変更なし。" - key: dsh.contextTabLabel type: string default: "unset (built-in 「上下文」/「Context」)" group: behavior desc_en: "Custom display name for the DSH top-bar Context tab (#4237), e.g. \"压缩账本\" when another plugin (dsh-context) owns the name 「上下文」. Trimmed non-empty string wins over the built-in label; blank or absent falls back to the built-in. File-only tier (display preference, no env knob per #2030). Default unset = built-in label unchanged." desc_zh: "DSH 顶栏上下文标签页的自定义显示名(#4237),例如另一插件(dsh-context)已占用「上下文」时改为\"压缩账本\"。去空白后的非空字符串优先于内置名;留空或缺省回退内置名。仅文件层(显示偏好,按 #2030 不设 env 开关)。默认缺省 = 内置名不变。" + desc_ja: "DSH トップバーの Context タブのカスタム表示名(#4237)、例:別のプラグイン(dsh-context)が「上下文」の名前を所有している場合の \"压缩账本\"。トリムされた空でない文字列が組み込みラベルに優先される;空白または未設定の場合は組み込みにフォールバック。ファイル専用ティア(表示設定、#2030 に従い環境変数なし)。デフォルト未設定 = 組み込みラベルは変更なし。" - key: resign type: "scheme → { enabled?, passthrough?, credentialRef? }" default: "{} (armed; built-in scheme sdk-hmac-sha256)" @@ -419,6 +461,7 @@ entries: group: behavior desc_en: "Re-sign arm keyed by Authorization scheme: signed model requests tunnel with every egress body re-signed; unresignable requests are refused locally 403 unless passthrough opts that scheme into verbatim forwarding." desc_zh: "按 Authorization 方案键控的重签名臂:可重签名的模型请求全程重签转发;无法重签的请求本地 403 拒绝,除非该方案经 passthrough 选择原文透传。" + desc_ja: "Authorization スキームでキーイングされた再署名アーム:署名済みモデルリクエストは、すべてのエグレスボディが再署名されてトンネリングされる;署名解除できないリクエストは、パススルーがそのスキームを逐語転送にオプトインしていない限り、ローカルで 403 として拒否される。" - key: promptCache.routing type: "\"auto\" | \"enabled\" | \"disabled\"" default: "disabled" @@ -426,6 +469,7 @@ entries: group: behavior desc_en: "Posture of bili's own `prompt_cache_key` emission (both wires); client-supplied keys always forward verbatim." desc_zh: "bili 自注入 `prompt_cache_key` 的姿态(两条 wire 同时生效);客户端自带的 key 永远原样转发。" + desc_ja: "bili 自身の `prompt_cache_key` 出力の姿勢(両方のワイヤ);クライアントが供給したキーは常に逐語的に転送される。" - key: cacheKeepalive.enabled type: boolean default: "false" @@ -433,6 +477,7 @@ entries: group: behavior desc_en: "Master switch for idle prompt-cache keepalive on the Anthropic wire (#3376): while a session goes idle, bili replays the last forwarded body with max_tokens=1 on a TTL-derived cadence so the upstream prefix cache stays warm; hits are verified via usage.cache_read_input_tokens; stops on miss/429/error-streak/duration cap. Also settable per provider route and per model." desc_zh: "Anthropic 线路空闲期提示缓存保活总开关(#3376):会话空闲时按 TTL 推导的节奏以 max_tokens=1 重放最后一次转发的请求体,维持上游前缀缓存温热;以 usage.cache_read_input_tokens 验证命中,miss/429/连续错误/时长上限即停;支持逐 provider 路由与逐模型覆盖。" + desc_ja: "Anthropic ワイヤにおけるアイドル時のプロンプトキャッシュキープアライブのマスタースイッチ(#3376):セッションがアイドルになると、bili は TTL 由来の周期で `max_tokens=1` を伴う最後の転送ボディを再生し、アップストリームのプレフィックスキャッシュをウォームに保つ;ヒットは `usage.cache_read_input_tokens` 経由で検証される;ミス/429/エラー連続/期間上限で停止。プロバイダルートごとおよびモデルごとにも設定可能。" - key: cacheKeepalive.ttlFactor type: number default: "0.9" @@ -440,6 +485,7 @@ entries: group: behavior desc_en: "Cadence factor applied to the detected/assumed cache TTL tier (ping interval = tier x factor; 0.9 gives roughly one ping per 4.5 min on the 5-min tier and per 54 min on the 1-hour tier). Must be in (0, 1]." desc_zh: "作用于检测/假定缓存 TTL 档位的节奏因子(ping 间隔 = 档位 x 因子;0.9 → 5 分钟档约每 4.5 分钟、1 小时档约每 54 分钟一次)。取值须在 (0, 1]。" + desc_ja: "検出/推定されたキャッシュ TTL ティアに適用される周期係数(ピン間隔 = ティア x 係数;0.9 は 5 分ティアで約 4.5 分ごとに 1 ピン、1 時間ティアで 54 分ごとに 1 ピン)。(0, 1] の範囲でなければならない。" - key: cacheKeepalive.maxDurationMs type: number default: "86400000" @@ -447,6 +493,7 @@ entries: group: behavior desc_en: "Per-session keepalive lifetime cap, measured from the session's last real request (default 24 h); past it, keepalive disarms even while still hitting." desc_zh: "单会话保活时长上限,自其最后一次真实请求起算(默认 24 小时);超过后即使仍在命中也会解除武装。" + desc_ja: "セッションごとのキープアライブ生存期間上限、セッションの最後の実際のリクエストから測定(デフォルト 24 h);これを過ぎると、ヒットが続いていてもキープアライブは解除される。" - key: cacheKeepalive.maxConcurrentPings type: number default: "4" @@ -454,6 +501,7 @@ entries: group: behavior desc_en: "Cap on simultaneously armed sessions; when exceeded, the longest-idle armed session is evicted first." desc_zh: "同时武装的会话数上限;超限时先驱逐空闲最久的已武装会话。" + desc_ja: "同時にアームされたセッションの上限;超過した場合、最も長くアイドル状態のアーム済みセッションが最初に追い出される。" - key: cacheKeepalive.assumeTtl type: "\"5m\" | \"1h\"" default: "null (detect from body breakpoints)" @@ -461,6 +509,7 @@ entries: group: behavior desc_en: "Skip body breakpoint detection and derive the cadence from this tier directly - for relays that inject or rewrite cache_control TTL downstream of bili, leaving the forwarded body breakpoint-less or mis-tiered." desc_zh: "跳过 body 断点检测,直接按该档位推导节奏——面向会在 bili 下游注入或改写 cache_control TTL、导致转发 body 无断点(或档位不对)的中继/代理。" + desc_ja: "ボディブレークポイント検出をスキップし、このティアから直接周期を導出 - bili の下流で `cache_control` TTL を注入または書き換えるリレー向け、転送ボディにブレークポイントがないか、ティアが誤っている場合。" - key: cacheKeepalive.armWithoutBreakpoints type: boolean default: "false" @@ -468,6 +517,7 @@ entries: group: behavior desc_en: "Arm keepalive even when the forwarded body carries no cache_control breakpoint at all (off by default - without breakpoints there is no explicit break-pointed content to refresh; pair with assumeTtl/intervalMs when your relay manages breakpoints itself)." desc_zh: "转发 body 无任何 cache_control 断点时也武装保活(默认关——没有断点就没有显式打断点的内容可刷新;断点由你的中继自管时配合 assumeTtl/intervalMs 使用)。" + desc_ja: "転送ボディに `cache_control` ブレークポイントが全くない場合でもキープアライブをアーム(デフォルトオフ - ブレークポイントがない場合、リフレッシュすべき明示的なブレークポイント付きコンテンツがない;リレーがブレークポイントを自分で管理している場合は `assumeTtl`/`intervalMs` と組み合わせること)。" - key: cacheKeepalive.intervalMs type: number default: "null (derive from TTL tier)" @@ -475,6 +525,7 @@ entries: group: behavior desc_en: "Absolute ping interval in milliseconds; wins over ttlFactor, assumeTtl and the detected tier. For fixed cadences that do not follow the upstream TTL policy." desc_zh: "绝对 ping 间隔(毫秒);优先于 ttlFactor、assumeTtl 与检测档位。用于不随上游 TTL 策略变化的固定节奏。" + desc_ja: "ミリ秒単位の絶対ピン間隔;`ttlFactor`、`assumeTtl`、および検出されたティアに優先。アップストリームの TTL ポリシーに従わない固定周期向け。" - key: native.attachExternal type: boolean default: "false" @@ -484,6 +535,7 @@ entries: site_group: adv desc_en: "Let launcher-less native plugins attach to an external (lane'd, unarmed) daemon instead of spawning their own." desc_zh: "允许无启动器的原生插件挂到外部(车道化、未武装看门狗)守护进程,而不是自行派生。" + desc_ja: "ランチャーなしのネイティブプラグインが、自分自身のデーモンを生成する代わりに、外部(レーン付き、未アーム)のデーモンにアタッチできるようにする。" site_en: "native.attachExternal — let launcher-less native plugins attach to an external daemon (off by default)." site_zh: "native.attachExternal —— 允许无启动器的原生插件挂到外部守护进程(默认关)。" - key: native.attachLanePriority @@ -493,6 +545,7 @@ entries: group: behavior desc_en: "Ordered list of FOREIGN lane names a lane may ride when no own-lane instance exists (#2905). Own lane always wins first; the user zone (manual bili start, the 8787 global) is ALWAYS last; unlisted lanes stay non-attachable. File-only, no env var." desc_zh: "本 lane 没有自己的实例时可搭车的外部 lane 名字有序列表(#2905)。本 lane 永远第一;用户区(手动 bili start、8787 全局)永远最后;未列出的 lane 仍不可挂。仅配置文件,无 env。" + desc_ja: "自レーンインスタンスが存在しない場合、レーンがライド可能な FOREIGN レーン名の順序付きリスト(#2905)。自レーンは常に最初に優先される;ユーザーゾーン(手動 `bili start`、8787 グローバル)は常に最後;リストにないレーンはアタッチ不可のまま。ファイル専用、環境変数なし。" - key: native.attachPolicy type: "\"own-lane\" | \"global-fallback\"" default: "own-lane" @@ -500,6 +553,7 @@ entries: group: behavior desc_en: "Lane affinity for native-hook attach, and the gate on whether any cross-lane riding happens (#2877). own-lane (default): a LANEd hook rides ONLY a same-lane daemon and, with none available, spawns its own instead of falling back onto a lane-less / manually-started bili start daemon or another lane's daemon (that convergence pinned every agent to one daemon's version and double-wrote sessions); an armed lane-less daemon (a managed shared proxy, #1225) stays shareable under either policy. global-fallback restores the pre-#2877 behavior: same-lane first, then a compatible lane-less/user-zone daemon, and (with attachLanePriority) the listed foreign lanes." desc_zh: "native hook 附着的 lane 亲和,也是是否发生跨 lane 搭车的总闸(#2877)。own-lane(默认):lane 型 hook 只搭同 lane 的守护;没有时自行派生,而不是回落到无 lane / 手动启动的 bili start 守护或其他 lane 的守护(那种汇聚会把所有 agent 钉死在一台守护的版本上并双写会话);已武装的无 lane 守护(受管共享代理,#1225)在两种策略下都可被搭车。global-fallback 恢复 #2877 之前的行为:先同 lane,再兼容的无 lane/用户区守护,以及(配 attachLanePriority)列出的外部 lane。" + desc_ja: "ネイティブフックのアタッチにおけるレーンアフィニティ、およびクロスレーンライドが発生するかどうかのゲート(#2877)。own-lane(デフォルト): LANEd フックは同じレーンのデーモンにのみライドし、利用可能なものがなければフォールバックとしてレーンなし/手動起動された bili start デーモンや他のレーンのデーモンを使用するのではなく、自前でスポンします(この収束により、すべてのエージェントが1つのデーモンのバージョンに固定され、セッションの二重書き込みが発生していた問題が解決されました)。アームされたレーンなしデーモン(管理共有プロキシ、#1225)は、どちらのポリシー下でも共有可能のままです。global-fallback は #2877 以前の動作を復元します:まず同じレーン、次に互換性のあるレーンなし/ユーザーゾーンデーモン、そして(attachLanePriority が設定されている場合)リストされた外部レーン。" - key: native.attachUrl type: string default: "unset (discover per lane)" @@ -507,6 +561,7 @@ entries: group: behavior desc_en: "Explicit target origin for native-hook attach (any URL). When set, a hook attaches ONLY to that exact origin instead of auto-discovering, and spawns its own if it is not live; it must still be code-compatible and pass the lifecycle gate. The BILI_MCP_PROXY env var (also set by CLI --origin) takes precedence over this file value; empty/whitespace means unset." desc_zh: "native hook 附着的显式目标源(任意 URL)。设置后,hook 只附着到该精确 origin 而不是自动发现,若其不在线则自行派生;仍需代码兼容并通过生命周期门禁。BILI_MCP_PROXY 环境变量(CLI --origin 亦会设置它)优先于此文件值;空/空白视为未设置。" + desc_ja: "ネイティブフックのアタッチにおける明示的なターゲットオリジン(任意の URL)。設定されると、フックは自動検出の代わりに、その正確なオリジンにのみアタッチし、ライブでない場合は自前でスポンします。それでもなおコード互換性があり、ライフサイクルゲートを通過する必要があります。BILI_MCP_PROXY 環境変数(CLI の --origin によっても設定される)は、このファイルの値よりも優先されます。空または空白は未設定を意味します。" - key: claude.nativePort type: number default: "unset (lane sticky zone port)" @@ -514,6 +569,7 @@ entries: group: behavior desc_en: "Exact port pin for the claude native lane's hook-spawned proxy (strict-port: squatters are refused loudly)." desc_zh: "claude 原生车道钩子派生代理的精确端口钉死(严格端口:被占用时响亮拒绝而非跳端口)。" + desc_ja: "claude ネイティブレーンのフックスポンによるプロキシの正確なポートピン(strict-port: 占有者は明確に拒否されます)。" - key: pi.subagents type: "object | boolean" default: "{} (acp_delegate enabled with package defaults)" @@ -521,6 +577,7 @@ entries: group: behavior desc_en: "Built-in pi-lane sub-agents (acp_delegate) surface, #2230 config-home. The pi.subagents section of billion-context.json owns the delegate config; the four acp.json keys (delegate/delegatePrompt/displayUsage/debug) are a deprecated fallback read only while the section is absent. prompt replaces delegatePrompt; debug is scoped to the sub-agent subsystem. Boolean shorthand subagents: false disables the whole surface. Full field table: the pi section in configuration.md." desc_zh: "内置 pi lane 子代理(acp_delegate)面(#2230 配置搬家)。billion-context.json 的 pi.subagents 段拥有 delegate 配置;acp.json 四键(delegate/delegatePrompt/displayUsage/debug)为已废弃回退源,仅段缺失时读取。prompt 取代 delegatePrompt;debug 限定子代理子系统。布尔简写 subagents: false 整体关闭。完整字段表见 configuration.md 的 pi 段。" + desc_ja: "組み込み pi レーンサブエージェント(acp_delegate)サーフェス、#2230 config-home。billion-context.json の pi.subagents セクションがデリゲート設定を所有します。4 つの acp.json キー(delegate/delegatePrompt/displayUsage/debug)は、セクションが存在しない場合のみ読み取られる非推奨のフォールバックです。prompt は delegatePrompt を置き換えます。debug はサブエージェントサブシステムにスコープされます。ブール値の省略形 subagents: false はサーフェス全体を無効にします。完全なフィールドテーブル:configuration.md の pi セクション。" - key: pi.inline type: boolean default: "true (unset env+file runs inline)" @@ -528,6 +585,7 @@ entries: group: behavior desc_en: "Pi inline lane (#3278; DEFAULT-ON since #5428, superseding the #4687 opt-in rule): the pi extension's compression runs IN-PROCESS — no spawned proxy, no ephemeral port; model traffic and the /__bili//__acp tool surface are served by an in-process engine through a pseudo-origin, the codex Responses WebSocket lane by a loopback-only WS bridge, and the Web UI by a loopback-only web listener booted with the engine. Unset env+file now runs INLINE; an ANNOUNCED attach target (launcher-set BILLION_CONTEXT_PROXY/ATTACH) still beats the default, so `bili pi` keeps its launcher proxy. Opt OUT with BILI_PI_INLINE=0/false/no/off or this key set false — restores the old attach/spawn posture. Resolved env > file > default; an explicit inline choice always beats an announced attach target. Human surface: `bili -i/--inline pi` (≡ the one-command lane) and `bili -s/--server pi` (pin the proxy posture, beats an inherited inline env)." desc_zh: "pi 内联压缩通道(#3278;自 #5428 起默认开启,取代 #4687 的手动开启规则):pi 扩展的压缩在进程内完成——不派生代理进程、无临时端口;模型流量与 /__bili//__acp 工具面由进程内引擎经伪源站服务,codex 的 Responses WebSocket 通道走随引擎启动的仅回环 WS 桥,Web UI 走随引擎启动的仅回环监听。未设置 env+文件时默认内联;显式宣告的附着目标(launcher 预置的 BILLION_CONTEXT_PROXY/ATTACH)仍压过默认,`bili pi` 照旧用 launcher 代理。不想用就 BILI_PI_INLINE=0/false/no/off 或本键设 false——恢复旧的 attach/spawn 姿态。解析顺序 env > 文件 > 默认;显式开启永远压过附着目标。人类入口:`bili -i/--inline pi`(≡ 一键车道)与 `bili -s/--server pi`(钉死代理姿态,压过继承的内联变量)。" + desc_ja: "Pi インラインレーン(#3278; #5428 以降デフォルトで有効、#4687 のオプトインルールを置き換え): pi 拡張機能の圧縮はインプロセスで実行されます — スポンされたプロキシなし、エフェメラルポートなし;モデルトラフィックと /__bili//__acp ツールサーフェスは擬似オリジンを通じてインプロセスエンジンによって提供され、codex Responses WebSocket レーンはループバック専用 WS ブリッジによって、Web UI はエンジンと同時に起動されるループバック専用 Web リスナーによって提供されます。現在、env+file が未設定の場合にはインラインで実行されます;ANNOUNCED アタッチターゲット(ランチャー設定の BILLION_CONTEXT_PROXY/ATTACH)はデフォルトよりも優先されるため、`bili pi` はランチャープロキシを維持します。BILI_PI_INLINE=0/false/no/off またはこのキーを false に設定することでオプトアウトできます — 従来のアタッチ/スポン姿勢を復元します。解決順序は env > file > default;明示的なインライン選択は常に ANNOUNCED アタッチターゲットよりも優先されます。人間向けサーフェス:`bili -i/--inline pi`(≡ ワンコマンドレーン)と `bili -s/--server pi`(プロキシ姿勢をピン留め、継承されたインライン env よりも優先)。" - key: pi.commands type: "string[] | boolean" default: "[\"acp\", \"acp-cache\"]" @@ -535,6 +593,7 @@ entries: group: behavior desc_en: "Which bili pi-plugin slash commands register: \"acp\", \"acp-cache\", \"acp-rule\", \"acp-fleet\". The default keeps the status (/acp) and cache-reconciliation (/acp-cache) entry points while leaving the rarer /acp-rule and /acp-fleet off the slash-completion list; true registers all four, [] or false registers none. Unknown names warn once and are ignored. Read at session start, so a config edit applies to the next session (no proxy restart needed). Pure UI surface: disabling a command never removes the underlying tool (acp_cache / acp_rule stay available to the model) or affects the proxy." desc_zh: "bili pi 插件注册哪些斜杠命令:\"acp\"、\"acp-cache\"、\"acp-rule\"、\"acp-fleet\"。默认保留状态面板(/acp)与缓存对账(/acp-cache)两个入口,较冷门的 /acp-rule 与 /acp-fleet 不进入补全列表;true 注册全部四个,[] 或 false 一个都不注册。未知命令名告警一次后忽略。会话启动时读取,改配置下一个会话即生效(无需重启代理)。纯 UI 面:关闭命令不影响底层工具(acp_cache / acp_rule 对模型仍可用)与代理。" + desc_ja: "登録される bili pi-plugin スラッシュコマンド:\"acp\", \"acp-cache\", \"acp-rule\", \"acp-fleet\"。デフォルトでは、ステータス(/acp)とキャッシュ調整(/acp-cache)のエントリポイントを維持しつつ、より稀に使用される /acp-rule と /acp-fleet をスラッシュ補完リストから除外します;true は 4 つすべてを登録し、[] または false は何も登録しません。不明な名前は一度警告が表示され、無視されます。セッション開始時に読み取られるため、設定の編集は次のセッションに適用されます(プロキシの再起動は不要)。純粋な UI サーフェス:コマンドの無効化は、基盤となるツール(acp_cache / acp_rule はモデルに対して利用可能のまま)を削除したり、プロキシに影響を与えたりしません。" - key: opencode.inline type: boolean default: "false" @@ -542,6 +601,7 @@ entries: group: behavior desc_en: "OpenCode inline lane (#3278 port; OPT-IN — the default stays the spawned proxy, per owner decision on #4687): the opencode plugin's compression runs IN-PROCESS — no spawned proxy, no ephemeral port, no MITM certs; model traffic and the /__bili/ tool surface are served by an in-process engine through a pseudo-origin (verified on the Bun host). Set true (or BILI_OPENCODE_INLINE=1) to enable. Resolved env > file; an explicit inline choice always beats an announced attach target, an absent choice falls back to attach/spawn as before. `bili opencode-inline` is the one-command lane." desc_zh: "opencode 内联压缩通道(#3278 移植;需手动开启——按 #4687 决定,默认仍是派生代理):opencode 插件的压缩在进程内完成——不派生代理进程、无临时端口、无 MITM 证书;模型流量与 /__bili/ 工具面由进程内引擎经伪源站服务(已在 Bun 宿主验证)。设 true(或 BILI_OPENCODE_INLINE=1)开启。解析顺序 env > 文件;显式开启永远压过附着目标,未设置时行为与旧版一致(attach/spawn)。`bili opencode-inline` 一键车道。" + desc_ja: "OpenCode インラインレーン(#3278 ポート;オプトイン — #4687 におけるオーナーの決定に従い、デフォルトはスポンされたプロキシのまま): opencode プラグインの圧縮はインプロセスで実行されます — スポンされたプロキシなし、エフェメラルポートなし、MITM 証明書なし;モデルトラフィックと /__bili/ ツールサーフェスは擬似オリジンを通じてインプロセスエンジンによって提供されます(Bun ホストで検証済み)。有効にするには true(または BILI_OPENCODE_INLINE=1)を設定します。解決順序は env > file;明示的なインライン選択は常に ANNOUNCED アタッチターゲットよりも優先され、選択が欠如している場合は従来どおりアタッチ/スポンにフォールバックします。`bili opencode-inline` はワンコマンドレーンです。" - key: mitm.enabled type: boolean default: "true" @@ -551,6 +611,7 @@ entries: site_group: mitm desc_en: "HTTPS interception switch for login clients that hard-code their upstream; domains are whitelisted on first sight." desc_zh: "面向写死 HTTPS 上游的登录客户端的拦截开关;域名首次发现即加入白名单。" + desc_ja: "アップストリームをハードコードしているログインクライアント向けの HTTPS 傍受スイッチ;ドメインは初回検出時にホワイトリストに登録されます。" site_en: "mitm.enabled / mitm.domains — HTTPS interception switch and whitelist domains for login clients." site_zh: "mitm.enabled / mitm.domains —— 登录客户端 HTTPS 拦截开关与白名单域名。" - key: mitm.domains @@ -560,6 +621,7 @@ entries: group: mitm desc_en: "Explicit MITM whitelist domains (unioned with first-sight auto-whitelisting)." desc_zh: "显式 MITM 白名单域名(与首次发现的自动白名单取并集)。" + desc_ja: "明示的な MITM ホワイトリストドメイン(初回検出時の自動ホワイトリスト化と合算)。" - key: mitm.handshakeTimeoutMs type: number default: "10000" @@ -569,5 +631,6 @@ entries: site_group: mitm desc_en: "TLS handshake timeout for intercepted connections." desc_zh: "被拦截连接的 TLS 握手超时。" + desc_ja: "傍受された接続の TLS ハンドシェイクタイムアウト。" site_en: "mitm.handshakeTimeoutMs — TLS handshake timeout (default 10000)." site_zh: "mitm.handshakeTimeoutMs —— TLS 握手超时(默认 10000)。" diff --git a/website/config-reference/updates.yaml b/website/config-reference/updates.yaml index 270e8dfa6a..f353918cc5 100644 --- a/website/config-reference/updates.yaml +++ b/website/config-reference/updates.yaml @@ -11,6 +11,7 @@ entries: site_group: diag desc_en: "Automatic npm version checks (every ~3 min); disable via ACP_AUTO_UPDATE=0 or --no-auto-update." desc_zh: "自动 npm 版本检查(约每 3 分钟);ACP_AUTO_UPDATE=0 或 --no-auto-update 关闭。" + desc_ja: "自動 npm バージョンチェック(約 3 分ごと);ACP_AUTO_UPDATE=0 または --no-auto-update で無効化。" site_en: "autoUpdate — automatic version checks (on by default; disable via ACP_AUTO_UPDATE=0 or --no-auto-update)." site_zh: "autoUpdate —— 自动版本检查(默认开;ACP_AUTO_UPDATE=0 或 --no-auto-update 关闭)。" - key: autoRestartOnUpdate @@ -22,6 +23,7 @@ entries: site_group: diag desc_en: "Restart the daemon automatically once a newer version has been installed." desc_zh: "新版本装好后自动重启守护进程。" + desc_ja: "新しいバージョンがインストールされた後、デーモンを自動的に再起動する。" site_en: "autoRestartOnUpdate — restart the daemon automatically once a newer version is installed (opt-in)." site_zh: "autoRestartOnUpdate —— 新版本装好后自动重启守护进程(可选开启)。" - key: updateTag @@ -33,6 +35,7 @@ entries: site_group: diag desc_en: "npm dist-tag channel for self-updates: latest (default), dev, or pr." desc_zh: "自更新的 npm dist-tag 通道:latest(默认)、dev 或 pr。" + desc_ja: "セルフアップデート用の npm dist-tag チャンネル:latest(デフォルト)、dev、または pr。" site_en: "updateTag — npm dist-tag channel: latest (default), dev, or pr." site_zh: "updateTag —— npm dist-tag 通道:latest(默认)、dev 或 pr。" - key: update @@ -43,6 +46,7 @@ entries: site_group: proc desc_en: "Self-update channel settings." desc_zh: "自更新通道设置。" + desc_ja: "セルフアップデートのチャンネル設定。" site_en: "update — self-update channel: registry \"npmjs\" · checkIntervalMs 180000." site_zh: "update —— 自更新通道:registry \"npmjs\" · checkIntervalMs 180000。" - key: update.registry @@ -52,6 +56,7 @@ entries: group: updates desc_en: "Custom npm registry base URL for self-updates (private mirrors)." desc_zh: "自更新用的自定义 npm registry 基础地址(私有镜像)。" + desc_ja: "セルフアップデート用のカスタム npm レジストリベース URL(プライベートミラー)。" - key: update.checkIntervalMs type: number default: "180000" @@ -59,6 +64,7 @@ entries: group: updates desc_en: "Interval between npm registry version checks." desc_zh: "npm registry 版本检查间隔。" + desc_ja: "npm レジストリのバージョンチェックの間隔。" - key: update.staggerMinDelayMs type: "number | string" default: "900000 (built-in 15 min)" @@ -66,6 +72,7 @@ entries: group: updates desc_en: "#3619 staggered rollout: lower bound of this machine's base upgrade-delay window; ms number or duration string (15m / 2d / 1d12h); 0 disables the delay (legacy immediate). The remote policy's default window and per-version overrides stack on top." desc_zh: "#3619 错峰升级:本机基础升级延迟窗口下限;毫秒数字或时长字符串(15m / 2d / 1d12h);0 = 禁用延迟(恢复立即升级)。远端策略的 default 窗口与按版本 overrides 叠加在其上。" + desc_ja: "#3619 スタグダードロールアウト: このマシンのベースアップグレード遅延ウィンドウの下限; ms 数値または期間文字列 (15m / 2d / 1d12h); 0 で遅延を無効化 (従来の即時実行)。リモートポリシーのデフォルトウィンドウとバージョン別の上書きがこれに重ねて適用される。" - key: update.staggerMaxDelayMs type: "number | string" default: "172800000 (built-in 48 h)" @@ -73,6 +80,7 @@ entries: group: updates desc_en: "#3619 staggered rollout: upper bound of this machine's base upgrade-delay window; ms number or duration string (48h / 2d); together with min 0 restores legacy immediate upgrades." desc_zh: "#3619 错峰升级:本机基础升级延迟窗口上限;毫秒数字或时长字符串(48h / 2d);与 min=0 一起恢复立即升级。" + desc_ja: "#3619 スタグダードロールアウト: このマシンのベースアップグレード遅延ウィンドウの上限; ms 数値または期間文字列 (48h / 2d); min とともに 0 に設定すると従来の即時アップグレードに戻る。" - key: update.policyUrl type: string default: "official repo raw URL" @@ -80,6 +88,7 @@ entries: group: updates desc_en: "Override URL for the remote auto-update policy file (test seam — production stays pinned to the official repo)." desc_zh: "远端自动更新策略文件的覆盖地址(测试接缝——生产固定指向官方仓库)。" + desc_ja: "リモート自動更新ポリシーファイルの URL 上書き (テスト用シーム — 本番環境では公式リポジトリに固定される)。" - key: advisoryCheck type: boolean default: "true" @@ -89,6 +98,7 @@ entries: site_group: diag desc_en: "Critical-defect advisory watcher; force-installs the recommended fix when the running version is affected." desc_zh: "关键缺陷公告监视器;本机版本命中受影响范围时装填推荐修复版本。" + desc_ja: "重大な欠陥に関するアドバイザリーウォッチャー; 実行中のバージョンが影響を受ける場合、推奨される修正を強制インストールする。" site_en: "advisoryCheck / advisoryUrl — critical-defect advisory watcher (on by default; force-installs the recommended fix when your version is affected)." site_zh: "advisoryCheck / advisoryUrl —— 关键缺陷公告监视器(默认开;本机版本命中受影响范围时装填推荐修复版本)。" - key: advisoryUrl @@ -98,6 +108,7 @@ entries: group: updates desc_en: "Override URL for the advisory feed." desc_zh: "公告源覆盖地址。" + desc_ja: "アドバイザリーフィードの URL 上書き。" - key: remoteAnnouncementsUrl type: string default: "unset (official feed: GitHub master announcements/remote.json)" @@ -105,6 +116,7 @@ entries: group: updates desc_en: "Override URL for the remote announcement feed (#5548): JSON document {v: 1, entries: [...]} — same record schema as local announcement files, fetched every ~3 min like the other watchers, cached snapshot survives restarts/outages. Firewall installs point this at a relay mirror; bad pushes are rejected and the last good copy keeps showing. Local files in /announcements/*.json always shadow same-id remote/builtin notices." desc_zh: "远程公告源覆盖地址(#5548):JSON 文档 {v: 1, entries: [...]},记录格式与本地公告文件一致;与其他监视器一样约每 3 分钟拉取一次,缓存快照可跨重启/断网存活。无法直连的安装把它指向中继镜像;坏推送会被拒绝并继续显示上一份有效公告。配置目录 announcements/*.json 的本地文件按同 id 覆盖远程/内置公告。" + desc_ja: "リモートアナウンスメントフィードの URL 上書き (#5548): JSON ドキュメント {v: 1, entries: [...]} — ローカルアナウンスメントファイルと同じレコードスキーマ。他のウォッチャーと同様に約 3 分ごとに取得され、キャッシュされたスナップショットは再起動や障害後も維持される。ファイアウォールインストールではこれをリレーミラーに向ける。不正なプッシュは拒否され、最後に正常だったコピーが表示され続ける。`/announcements/*.json` 内のローカルファイルは、同じ ID のリモート/組み込み通知を常にシャドウする。" - key: releaseNotesCheck type: boolean default: "true" @@ -114,6 +126,7 @@ entries: site_group: diag desc_en: "Release-notes feed for the web panel (fetch + cache only; never installs anything)." desc_zh: "Web 面板里的发布说明源(只抓取缓存、从不安装任何东西)。" + desc_ja: "Web パネル用のリリースノートフィード (取得とキャッシュのみ; 何もインストールしない)。" site_en: "releaseNotesCheck / releaseNotesUrl — release-notes feed for the panel (on by default; fetch + cache only, never installs)." site_zh: "releaseNotesCheck / releaseNotesUrl —— 面板里的发布说明源(默认开;只抓取缓存、从不安装)。" - key: releaseNotesUrl @@ -123,3 +136,4 @@ entries: group: updates desc_en: "Override URL for the release-notes feed." desc_zh: "发布说明源覆盖地址。" + desc_ja: "リリースノートフィードの URL 上書き。" From db2e1dea1607677c46deb8f5a62e34bea6109797 Mon Sep 17 00:00:00 2001 From: ranxianglei Date: Fri, 13 Nov 2026 00:22:33 +0800 Subject: [PATCH 17/17] docs: root redirect stubs for Japanese + ja links in docs indexes (#6072) --- CLIENTS.ja.md | 1 + CONFIGURATION.ja.md | 1 + MESSAGE-IDENTITY.ja.md | 1 + SESSION-IDENTITY.ja.md | 1 + docs/index.md | 6 +++--- docs/index.zh-CN.md | 6 +++--- 6 files changed, 10 insertions(+), 6 deletions(-) create mode 100644 CLIENTS.ja.md create mode 100644 CONFIGURATION.ja.md create mode 100644 MESSAGE-IDENTITY.ja.md create mode 100644 SESSION-IDENTITY.ja.md diff --git a/CLIENTS.ja.md b/CLIENTS.ja.md new file mode 100644 index 0000000000..ae3e65511f --- /dev/null +++ b/CLIENTS.ja.md @@ -0,0 +1 @@ +> 移動先 [docs/clients.ja.md](docs/clients.ja.md)。リダイレクト用プレースホルダー。1–2 リリース後に削除予定。 diff --git a/CONFIGURATION.ja.md b/CONFIGURATION.ja.md new file mode 100644 index 0000000000..70807a0287 --- /dev/null +++ b/CONFIGURATION.ja.md @@ -0,0 +1 @@ +> 移動先 [docs/configuration.ja.md](docs/configuration.ja.md)。リダイレクト用プレースホルダー。1–2 リリース後に削除予定。 diff --git a/MESSAGE-IDENTITY.ja.md b/MESSAGE-IDENTITY.ja.md new file mode 100644 index 0000000000..e4ecbcb624 --- /dev/null +++ b/MESSAGE-IDENTITY.ja.md @@ -0,0 +1 @@ +> 移動先 [docs/message-identity.ja.md](docs/message-identity.ja.md)。リダイレクト用プレースホルダー。1–2 リリース後に削除予定。 diff --git a/SESSION-IDENTITY.ja.md b/SESSION-IDENTITY.ja.md new file mode 100644 index 0000000000..a2131bfe12 --- /dev/null +++ b/SESSION-IDENTITY.ja.md @@ -0,0 +1 @@ +> 移動先 [docs/session-identity.ja.md](docs/session-identity.ja.md)。リダイレクト用プレースホルダー。1–2 リリース後に削除予定。 diff --git a/docs/index.md b/docs/index.md index 6128f9eb22..102650852b 100644 --- a/docs/index.md +++ b/docs/index.md @@ -8,8 +8,8 @@ | Doc | What it is | |---|---| | [README](../README.md) / [中文](../README.zh-CN.md) / [日本語](../README.ja.md) | Project entry: what it is, quickstart, architecture overview | -| [architecture](architecture.md) / [中文](architecture.zh-CN.md) | **System architecture hub** (LIVE doc, owner ruling 2026-11-08): overall diagram + per-module pages, each with its own diagram — see `docs/architecture/` | -| [configuration](configuration.md) / [中文](configuration.zh-CN.md) | Full configuration reference (generated from `website/config-reference/*.yaml` by `tools/gen-config-docs.mjs`; hand-written sections are drift-guarded) | +| [architecture](architecture.md) / [中文](architecture.zh-CN.md) / [日本語](architecture.ja.md) | **System architecture hub** (LIVE doc, owner ruling 2026-11-08): overall diagram + per-module pages, each with its own diagram — see `docs/architecture/` | +| [configuration](configuration.md) / [中文](configuration.zh-CN.md) / [日本語](configuration.ja.md) | Full configuration reference (generated from `website/config-reference/*.yaml` by `tools/gen-config-docs.mjs`; hand-written sections are drift-guarded) | | [clients](clients.md) / [中文](clients.zh-CN.md) / [日本語](clients.ja.md) | Per-client integration deep dives: how each mode (launcher / `/bili/` / native plugin) wires traffic in | | [how-it-works](how-it-works.en.svg) / [中文](how-it-works.zh-CN.svg) | One diagram: request flow + the injected context tools | | [README](README.md) / [中文](README.zh-CN.md) / [日本語](README.ja.md) | Directory landing page: section map + the rules that keep this directory live | @@ -31,7 +31,7 @@ | Doc | What it is | |---|---| -| [technical-notes](technical-notes.md) / [中文](technical-notes.zh-CN.md) | Large compendium of mechanism deep-dives (wire behavior, compression modes, fastpaths) | +| [technical-notes](technical-notes.md) / [中文](technical-notes.zh-CN.md) / [日本語](technical-notes.ja.md) | Large compendium of mechanism deep-dives (wire behavior, compression modes, fastpaths) | | [lifecycle](lifecycle.md) | Transition-switch ledger / retirement inventory / hygiene record (CI-enforced `BILI_*` coverage) | | [auto-merge-guardrails](auto-merge-guardrails.md) | Evidence appendix behind §7 of `AGENTS.md` (AI auto-dev review history) | | [unified-loop-spec](unified-loop-spec.md) | Historical design: unified compress-loop spec (implemented; code is the source of truth) | diff --git a/docs/index.zh-CN.md b/docs/index.zh-CN.md index 6b9c8855da..248574b6d6 100644 --- a/docs/index.zh-CN.md +++ b/docs/index.zh-CN.md @@ -8,8 +8,8 @@ | 文档 | 说明 | |---|---| | [README](../README.zh-CN.md) / [English](../README.md) / [日本語](../README.ja.md) | 项目入口:是什么、快速上手、架构总览 | -| [architecture](architecture.zh-CN.md) / [English](architecture.md) | **系统架构总览**(实时维护,owner 裁定 2026-11-08):整体架构图 + 每模块一页(各配图),见 `docs/architecture/` | -| [configuration](configuration.zh-CN.md) / [English](configuration.md) | 全量配置参考(由 `website/config-reference/*.yaml` 经 `tools/gen-config-docs.mjs` 生成;手写部分有漂移守卫) | +| [architecture](architecture.zh-CN.md) / [English](architecture.md) / [日本語](architecture.ja.md) | **系统架构总览**(实时维护,owner 裁定 2026-11-08):整体架构图 + 每模块一页(各配图),见 `docs/architecture/` | +| [configuration](configuration.zh-CN.md) / [English](configuration.md) / [日本語](configuration.ja.md) | 全量配置参考(由 `website/config-reference/*.yaml` 经 `tools/gen-config-docs.mjs` 生成;手写部分有漂移守卫) | | [clients](clients.zh-CN.md) / [English](clients.md) / [日本語](clients.ja.md) | 各客户端接入深潜:launcher / `/bili/` / 原生插件三种模式如何接线 | | [how-it-works](how-it-works.zh-CN.svg) / [English](how-it-works.en.svg) | 一张图:请求流转 + 注入的上下文工具 | | [README](README.zh-CN.md) / [English](README.md) / [日本語](README.ja.md) | 目录落地页:分区地图 + 保持本目录不再变乱的规则 | @@ -31,7 +31,7 @@ | 文档 | 说明 | |---|---| -| [technical-notes](technical-notes.zh-CN.md) / [English](technical-notes.md) | 机制深潜大杂烩(wire 行为、双压缩模式、快路径) | +| [technical-notes](technical-notes.zh-CN.md) / [English](technical-notes.md) / [日本語](technical-notes.ja.md) | 机制深潜大杂烩(wire 行为、双压缩模式、快路径) | | [lifecycle](lifecycle.md) | 过渡开关台账 / 退役模块盘点 / 卫生记录(CI 强制 `BILI_*` 覆盖) | | [auto-merge-guardrails](auto-merge-guardrails.md) | `AGENTS.md` §7 背后的证据附录(AI 自动开发评审史) | | [unified-loop-spec](unified-loop-spec.md) | 历史设计:统一压缩循环规格(已落地,以代码为准) |