codedrobe-theme-manager

CodeDrobe テーマを管理する

パッケージは管理対象の CodexSkins ライブラリに保管し、実行時には公開済みの @codedrobe/core のみを使用してください。アプリケーションバンドルにパッチを適用したり、 テーマパッケージのコードを評価したりしないでください。

ウォッチャーの所有権、プラットフォームのパス、復元の失敗をデバッグする前に、 references/lifecycle.md を読んでください。

検索またはインストール

ユーザーがビジュアルスタイルのみを指定した場合は、まず codedrobe-theme-finder を使用してください。 インストール可能なカタログ ID が指定された場合は、次を実行します。

node scripts/theme_library.mjs install <theme-id>

カタログに downloadAuth: "google" と記載されている場合、Google への サインインを自動化したり、ログインページをパッケージのダウンロード先として 扱ったりしないでください。テーマの詳細 URL をユーザーに提示し、ブラウザーで サインインしてダウンロードするよう依頼してから、apply_theme.mjs を使って 取得したローカルの .codedrobe-theme パスを検査し、適用してください。

インストーラーは CodexSkins カタログで公開されているパッケージ URL のみから ダウンロードし、バイトサイズと SHA-256 を確認して、CodeDrobe Core で検査した後、 ~/.codexskins/themes/<theme-id>/ の下に書き込みます。ユーザーが更新を 依頼するか、--force を承認しない限り、既存のパッケージを上書きしません。 --catalog /absolute/catalog.json または CODEXSKINS_CATALOG_URL は、 ステージング／ローカル検証にのみ使用し、信頼できないユーザー提供のカタログから インストールするためには使用しないでください。

インストール済みパッケージを一覧表示または解決するには、次を実行します。

node scripts/theme_library.mjs list
node scripts/theme_library.mjs resolve <theme-id>

適用または切り替え

適用とは、ユーザーがテーマを実際に表示したいという意味です。依頼に インストールと適用の両方が明記されている場合は、インストール後も続行してください。 そうでない場合は、インストール先のパスを伝えて、適用するかどうかを尋ねてください。

単一の所有ウォッチャーを通じて適用します。

node scripts/apply_theme.mjs --theme /absolute/theme.codedrobe-theme

Codex がすでに CDP を公開している場合、ホット適用されます。再起動が必要と 表示された場合は、許可を求めてから --restart-existing を付けて再実行してください。 ブラウジングやダウンロードを、再起動の許可と解釈しないでください。

ヘルパーが所有する CodexSkins ウォッチャーは常に 1 つだけです。そのため、 切り替え時にはインジェクターが重複するのではなく、以前のウォッチャーが置き換えられます。 CodeDrobe はポート 9335 の 127.0.0.1 にバインドされ、WindowsApps を変更せずに macOS と Windows をサポートします。

検証

ヘルパーはランタイムの準備完了を最大 45 秒待ちます。action: applied には 簡潔な Core の証拠が含まれます。action: submitted は制限時間内に完了せず、 視覚的な証拠にはなりません。Codex に接続できるようになったら、次を実行します。

npx --yes @codedrobe/core@latest verify \
  --app codex --port 9335 \
  --theme /absolute/theme.codedrobe-theme \
  --screenshot /absolute/verification.png

スクリーンショットを確認してください。テーマ ID／バージョン、アクティブな画像名、 レンダラープロファイル、必須ランドマーク、オーバーフロー、および確認した ホーム／会話／設定の各コンテキストを報告してください。macOS での実行結果をもとに、 Windows で検証したと主張しないでください。

復元

復元前に所有ウォッチャーを停止し、再注入されないようにしてください。

node scripts/restore_theme.mjs

結果は見た目に関する保証ではなく、ライフサイクルのステータスとして扱ってください。

• native：レンダラーとホストの状態はすでにネイティブであり、再起動は不要です。
• restart-required：インジェクションは解除され、バックアップされたホストの外観は ディスク上で復元されていますが、実行中の Codex プロセスにはテーマの色が キャッシュされたまま表示されている可能性があります。再起動の許可を求めてください。
• watcher-stopped：Core がレンダラーに接続できませんでした。完全に終了してから 再度開く必要があります。

ユーザーが Codex の終了を許可した後、現在の Codex タスクが終了しても動作する デタッチされた再起動をヘルパーに送信させてください。

node scripts/restore_theme.mjs --restart-existing

Codex が再起動したら、プライバシーに配慮した Core DOM スナップショットを取得してください。 復元の完了には、activeTheme.installed: false、codedrobe-theme／ホストテーマの クラスが存在しないこと、所有ウォッチャーが存在しないこと、計算後の背景色がネイティブであることが 必要です。codedrobe restore が正常終了したという理由だけで、復元が完全に完了したと 報告しないでください。

境界事項

• カタログで宣言された HTTPS ダウンロードのみを使用し、ダイジェストを検証してください。
• アプリバンドル、app.asar、WindowsApps、認証データ、ユーザータスクは変更しないでください。
• ローカルパッケージにユーザー編集が含まれている可能性がある場合は、警告せずに --force で上書きしないでください。
• ダウンロード、検査、パッケージ化だけを根拠に、適用中または検証済みと主張しないでください。