rebel0789/codexpro

CodexPro – 为 ChatGPT 提供安全、本地化的代码仓库访问权限

它是什么 – CodexPro 是一个小型 Node-JS 服务器，作为 OpenAI ChatGPT 的 自定义 MCP (Model-Client-Plugin)。当您在机器上运行它并将其注册为 ChatGPT 内的插件时，模型可以调用一组工具，让它能够对您明确允许的任何仓库文件进行 读取、搜索、编辑和执行检查。所有分析都保留在您的电脑上；不会上传到任何第三方服务。

为什么它很重要 – 近期的“代码助手”浪潮（如 GitHub Copilot、ChatGPT Code Interpreter 等）通常在云端运行，将您的源代码发送到远程服务器。CodexPro 颠覆了这种模式：LLM 留在 OpenAI 的云端，但重量级的代码智能（语言检测、符号索引、影响分析）则在本地运行，让您对隐私、安全性和可重现性拥有更严格的控制。

快速入门 (来自 README)

先决条件
- 已安装 Node 20+
- 拥有可添加自定义 MCP 插件的 ChatGPT 账号
- 指向您机器的 HTTPS 端点 (例如 Cloudflare tunnel、ngrok 或 Tailscale Funnel)
安装 CLI
```
npm install -g codexpro
```
设置仓库
```
cd /path/to/your/project
codexpro setup
```
这会创建一个本地配置文件并打印出您将提供给 ChatGPT 的 HTTPS URL。
在 ChatGPT 中添加插件
- 在 Settings → Security & login 中开启 Developer mode。
- 前往 Settings → Plugins → 点击 Search plugins 旁边的 +。
- 创建一个名为 CodexPro 的插件，并粘贴步骤 3 中的 URL。
- 选择 No Authentication / None (令牌已嵌入 URL 中)。
启动服务器
```
codexpro start   # 为当前仓库运行 MCP 服务器
```
服务器现在会监听来自您 ChatGPT 会话的工具调用。

核心功能 (如 README 所述)

功能	ChatGPT 通过 CodexPro 可执行的操作
工作区检查	`inspect_workspace` 建立语言、项目类型、入口点、符号和内部关系的轻量级索引。
搜索	`search` 支持纯文本、regex 以及意图驱动的查询，如 `symbol`、`references` 和 `impact`。
编辑	`write`、`edit` 或受保护的 `apply_patch` 让模型能够在允许的根目录内提出并应用代码变更。
文件导入	`import_file` 接受来自 ChatGPT Apps SDK 的附件并将其写入仓库。
命令执行	在您启用后，可以执行安全子集的 Bash 命令 (`bash` 工具)。
差异与影响分析	`show_changes` 返回差异、标示受影响区域、依赖代码、相关测试、风险信号以及建议的验证命令。
规划与交接	模型可以在 `.ai-bridge` 目录下编写交接计划，并为无法调用工具的对话导出内容套件。

内置仓库智能

识别 TypeScript/JavaScript, Python, Go, Rust, Swift, Java, C#, C, C++ 中的声明。其他语言则获得词法搜索和安全清单功能。
不需要外部嵌入服务、向量数据库或语言服务器守护程序 – 所有内容都在本地缓存并以工作区指纹为键值。
结果包含 覆盖率 和 推论强度 指标，而非虚假的确定感。

安全性默认值

明确的工作区边界 – 您决定哪些目录被暴露；其他所有内容都被封锁。
受令牌保护的通道 – 公共 HTTPS 通道需要一个随机的 24 字节令牌 (存储在 ~/.codexpro/http-token)。
写入模式默认隐藏，除非您使用 --mode workspace 启动服务器。
安全 Bash 为默认值；危险命令会被过滤。
封锁路径包括 .env、私钥、.git、构建缓存等。
附件仅通过 ChatGPT Apps SDK 从核准的 HTTPS 主机接收。

典型工作流程

开启工作区 – codexpro start (或 codexpro start --root /path/to/repo)。
在 ChatGPT 中，要求模型为该仓库执行 open_workspace。
模型随后可以：
- 搜索函数定义 (search symbol MyClass.myMethod)。
- 提出变更 (edit src/foo.py)，查看差异 (show_changes)，并应用 (apply_patch)。
- 运行测试命令 (bash npm test)。
- 编写总结已完成工作的交接文档。
完成后，停止服务器或为另一个仓库启动另一个实例。

可扩展性与模式

多个项目 – 单一 CodexPro 进程可以服务多个仓库 (codexpro settings set --project …)。
工具模式选择 – --tool-mode minimal、full 或自定义卡片集 (CODEXPRO_TOOL_CARDS=1)。
无头 / 交接 / 专业模式 – 针对 CI 风格运行、记录保存或完整交互式使用的不同预设设置。

安装与更新

npm install -g codexpro          # 全局安装
codexpro --version               # 验证
npm install -g codexpro@latest    # 升级

配置文件位于 `~/.codexpro`；更新二进制文件不会删除您保存的配置文件。

了解更多

网站 / 文档 – https://rebel0789.github.io/codexpro/
路线图、常见问题、安全指南 – 链接于仓库中 (ROADMAP.md, FAQ.md, SECURITY.md)。
源代码 – 仓库包含供贡献者使用的 CI、冒烟测试、压力测试和发布脚本。

总结

CodexPro 是一个真正的开源桥梁，让 ChatGPT 能够作为 本地代码助手 运行，而无需暴露您的专有源代码。它提供可搜索、具备语言感知能力的索引、安全的编辑/修补工作流程以及选用的命令执行功能，所有这些都受到明确的仓库权限和 HTTPS 通道验证的保护。非常适合希望在保留对代码和环境完全控制的同时，享受 LLM 驱动编码便利性的开发者。