Rice-dog/code-codex

Code‑Codex – Codex Desktop向けローカルファイルツリーアドオン

概要 – Code‑Codexは、公式のCodex/ChatGPT Desktopクライアント（OpenAIのチャットモデル用GUI）にプラグインする、コミュニティ製のWindowsヘルパーです。ネイティブなファイルツリーサイドバー、構文ハイライト付きコードのプレビューペイン、限定的な編集機能、追加のプレビューや視覚効果のためのプラグインマーケットプレイスを追加します。このプロジェクトはOpenAIとは完全に独立しています。

主要コンポーネント

ランチャーとブリッジ – 公式Codexクライアントを起動し、TypeScriptベースのエクスプローラーUIを注入し、制限付きワークスペースAPIを仲介する小さなWindows実行ファイル（code‑codex‑launcher.exe）。
エクスプローラーUI – 折りたたみ可能なファイルツリー、ドラッグ＆ドロップのファイル操作、右クリックコンテキストメニュー（新規、名前変更、削除、エクスプローラーで表示、更新）、開いているファイルのタブバーを表示する注入されたTypeScript UI。
プレビューと編集 – 構文ハイライト、サムネイルナビゲーション、軽量エディタのトグルを備えた組み込みのテキストプレビュー。Markdown、CSV、PDF、Jupyterノートブック、Officeドキュメント、画像、ビデオ、オーディオ、3D glTF/GLBモデルは、オプションのプラグインで処理されます。
プラグインシステム – 24のプラグインが外観、ファイルプレビュー、ツールにグループ化された「プレビューマーケット」。プラグインはオンデマンドでダウンロードされ、SHA-256で検証され、<install‑dir>/plugins/…に保存されます。サードパーティのスクリプトはインストールできません。
外観プラグイン – Codexの背景を置き換え、アクティブ時にクライアントを自動的にダークモードに切り替えるWebGL視覚効果（パーティクル画像、ブラックホール、オーロラ、天の川など）のコレクション。
ツールプラグイン – ブランチ、コミット、変更されたファイル、色分けされた差分を表示する読み取り専用のGit履歴ビューア。

インストール

ビルド済みバイナリ – Windows 10 x64インストーラ（.exe）、MSI、またはポータブルZIPがGitHubリリースページで提供されています。インストーラはSHA-256チェックサムでダウンロードを検証し、既存のCodexショートカットをバックアップし、ファイルを%LOCALAPPDATA%\Programs\Code‑Codex（カスタムフォルダも可能）に書き込みます。また、安全なクリーンアップのために以前のバージョンを保持します。
ソースからビルド – Windows 11 x64、Rust 1.85+、MSVCツールチェーン、Node ≥ 20、Visual Studio Build Toolsが必要です。scripts/build.ps1は実行可能ファイルを生成し、scripts/package.ps1はインストーラアセットを作成します。

使用フロー

Code‑Codexを起動します（またはCodexのCode‑Codexメニューを使用）。ファイルツリーがサイドバーに表示されます。
エクスプローラーからツリーにファイル/フォルダをドラッグするか、コンテキストメニューを使用して管理します。
ファイルをクリックしてプレビュータブを開きます。エディタのトグルを有効にして簡単な編集を行います。
ツリーの下部にあるプレビューマーケットを開き、必要なプラグイン（例：Markdownプレビューやパーティクル背景）をダウンロードして有効にします。
メニューから更新を確認します。インストーラは設定を保持しながら新しいバージョンをダウンロードします。

データレイアウト

<install‑dir>/
  data/                # ユーザー設定、プラグインパラメータ、メディア
  plugins/<type>/<id>/<ver>/  # 検証済みプラグインコードとアセット
  logs/runtime/       # 最近の実行ログ（それぞれ≤5 MiB）
  logs/diagnostics/  # クラッシュおよび自己チェックレポート
  logs/install/       # インストーラログ
  logs/update/        # 更新イベント
  temp/                # 更新中の一時ファイル
  backups/             # 移行レコード

アンインストーラ（Uninstall‑CodeCodex.exeまたはPowerShellスクリプト）は、元のCodexショートカットを復元し、オプションでCode‑Codexデータをすべて削除します。

対象ユーザー – Codex Desktopクライアントを既に使用しており、チャットUIから離れずにローカルプロジェクトエクスプローラー、より豊富なファイルプレビュー、およびオプションの視覚的カスタマイズを希望する開発者。

ライセンス – MIT（THIRD_PARTY_NOTICES_ZH_CN.mdにサードパーティの通知あり）。

Rice-dog/code-codex

Code‑Codex – Codex Desktop向けローカルファイルツリーアドオン

関連