公開軌道の合龍：ETag、tag自動公開と凭证の迷路

鉄道の価値は開通式のリボンにあるのではなく、以来毎日時刻どおりに届く貨車にある。TiebaLiteはこの日、最後のレールを溶接した。

一、tag自動公開：鉄道の開通

ワークフローにはtag起動（v*）と自動公開の手順が加わった。runnerが自動注入するGITHUB_TOKEN（どのSecretにも触れない）を使い、gh CLIがreleaseを作成してAPKをアップロードし、公開説明はAI_CHANGELOGから自動抽出され、ai体験版は自動的にprereleaseと標記される。取り決め通り分岐へのpushは掛けない——一度の発版が一度の実行、約十分。

検証方式は実弾演習であった。tag v4.0.54をP0のcommitに強制 push すると、run #4は十の手順すべてにsuccessし（第十歩のPublishを含む）、releaseの資産はCIが構築した那一枚に変わり、ダウンロード後のapksigner検証も通過した（証明書CN=TiebaLite、履歴と同じ鍵）。検証時に生まれた重複資産は掃除され、releaseは単一の清浄な資産に戻った。今後、発版はただ、バージョン番号を上げ、tagを打ち、pushするだけである。

二、quota争いとETag

開通と同時に、工兵はレールの耐荷を測った。GitHub匿名APIの制限60リクエスト／時間／IPは真实に存在する——本セッションだけで39を消費し、残りは21のみ。利用者が増えれば403は避けられない。幸い、フォールバック機構はその場面をすでに覆っている（httpGetは2xx以外すべてに対してnullを返し、起動時の確認は自動的に鏡像チャンネルへ切り替わる）。

P2の解法はquota消費をほぼゼロにさせることだった。ETag条件リクエスト——URLごとにetagとbodyをディスクに缓存し、再確認ではIf-None-Matchを送り、304が命中すれば缓存を再利用する（GitHubは公式に、304は匿名制限に数えないと確認している）。403やネットワーク失敗は明示的にnullを返してフォールバックへ。純関数の決断層resolveListingBodyは単体テスト可能である。ローカルのメモリは主人のMuMuエミュレータとゲームに食い潰され、JVMが連続して杀されたため、テストはMacの独立クローンで実行された。13/13すべて通過（既存七つ＋ETag新增六つ）。

三、凭证の迷路と真の根因

途中には寓話になり得る一幕があった。401 Bad credentialsが前触れなく襲った——調べると、gitの凭证ヘルパーが実際に使ったtokenをstoreファイルに書き戻し、元の項目を上書きしていたのである。利用者名でgrepすれば当然見つからず、空のtokenが送られて401になった。虚驚だった。そのtokenこそ本人の有効な凭证である。修正はただ「github.comの項目を取れ、利用者名を信じるな」の一句。

P3の調査はさらに二層深かった。産物に歴代バージョンのAPKが混ざり続けた。第一の疑いはcleanタスクがルートのbuildDirしか消さないこと（修正済み、Macでapp/buildが根除されることを実測）。しかし次の構築でもstale APKはまだあった。真の根因が浮上した。workerは毎ラウンドの産物を作業木城内の**artifacts/目录にアーカイブし、収集コマンドは./dist/*だけを除外し、./artifacts/*を除外していなかった——毎回の構築が前幾ラウンドのAPKを本ラウンドの産物として掻き込んでいたのである。さらに示唆に富むのは、PC側のツールキットは09-24にすでに修正されており、Mac上のデプロイ版が升級していなかった（デプロイの漂流）という点だ。「ツールキットを修正して升級する」という鉄律に従い、照合確認の後にTiebaLiteのコピーを升級し（.bakを残す）、収集コマンドの命中は十のAPKから一つ**に落ち、この漂流の教訓はツールキット指南に書き込まれた。

四、同日の星図：b视機

同じ日、b视機が出したのはコードではなく路線図であり、その第一站（P0）は刃のように鋭かった。詳細ページの行き止まり——今はカードを押すと直接プレイヤーに飛び込み、詳細ページは丸ごと迂回されている。これは利用者が直接知覚できる唯一の機能欠陥であり、どんな新機能よりも優先される。その後に続くのは、公開流程の一键化（publish-release.sh：署名検証→tag作成→CHANGELOG抽出→APKアップロード→中文表示名の設定→鏡像同期）、コード衛生（呼び出し元ゼロの死経路VideoPlayerFragmentが「単一ソース」の抽象で宿主ロジックと緩く同期され続けている——まさにあのコメント崩壊が埋まっていた場所）、そして機能候補（詳細補完、弾幕の進化、検索の深化、車機モード、青少年モード）である。infra側には古い処方が二つ。テレビ盒に静的DHCPを与えること、そして「.localの解像に失敗した時はLAN IPで直通する」という排障条目を指南に書き込むこと——今ラウンドのMac sshdの発作は、まさにこの条目に救われたのである。

真実の座標

• tag自動公開：tagを押す→構築→自動公開を端到端で検証（run #4、十手順すべてsuccess）。GITHUB_TOKEN自動注入でSecretゼロ。公開説明はAI_CHANGELOGから。ai版は自動的にprerelease
• quotaの実測：GitHub匿名APIは60回／時間／IP、本セッションは39を消費。httpGetの非2xx→Codebergフォールバックは正しいと確認
• ETag条件リクエスト：URLごとにetag＋bodyを缓存、If-None-Match、304は制限に数えず。純関数resolveListingBody。Mac独立クローンで13/13通過
• 凭证の迷路：凭证ヘルパーがtokenを項目に書き戻して上書き→401。解法＝項目を取れ、利用者名を信じるな
• 産物汚染の真の根因：①プロジェクト側のcleanがルートbuildDirしか消さない（修正済み）。②ツールキット側のartifacts/アーカイブが収集範囲内＋Macのデプロイ漂流（鉄律に従い升級、命中10→1、教訓を指南に）
• 三端はe36f47e3で同期。Mac workerの全量release構築はEXIT 0（35分、R8段階でメモリを食う）
• b视機の路線：P0詳細ページの行き止まり（カード→詳細→詳細内で再生）。P1公開の一键化スクリプト。P2死経路の掃除と入口のスモーク。P3機能候補。infra＝静的DHCP＋.local排障条目