Rice-dog/code-codex

Code‑Codex – Codex Desktop的本地文件树插件

简介 – Code‑Codex 是一个社区构建的 Windows 助手，可插入官方 Codex/ChatGPT Desktop 客户端（OpenAI 聊天模型的 GUI）。它添加了原生文件树侧边栏、带语法高亮代码的预览窗格、有限的编辑功能，以及用于额外预览和视觉效果的插件市场。该项目完全独立于 OpenAI。

主要组件

启动器和桥接器 – 一个小型 Windows 可执行文件（code‑codex‑launcher.exe），用于启动官方 Codex 客户端，注入基于 TypeScript 的资源管理器 UI，并调解受限的工作区 API。
资源管理器 UI – 注入的 TypeScript UI，显示可折叠的文件树、拖放文件操作、右键单击上下文菜单（新建、重命名、删除、在资源管理器中显示、刷新），以及打开文件的选项卡栏。
预览和编辑 – 内置文本文本预览，支持语法高亮、缩略图导航和轻量级编辑器切换。Markdown、CSV、PDF、Jupyter 笔记本、Office 文档、图像、视频、音频和 3D glTF/GLB 模型由可选插件处理。
插件系统 – “预览市场”，其中 24 个插件分为外观、文件预览和工具。插件按需下载，经过 SHA-256 验证，并存储在 <install‑dir>/plugins/… 下。无法安装第三方脚本。
外观插件 – 一组 WebGL 视觉效果（粒子图像、黑洞、极光、银河等），可替换 Codex 背景，并在激活时自动将客户端切换到深色模式。
工具插件 – 只读的 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的本地文件树插件

相关