CodePaidie

CodePaidie > **Code Paid Die — 杀死付费 AI 编程代理** 将 ChatGPT、Gemini、Kimi 或任何支持自定义工具的 AI 转换为免费的本地编码环境。读取、写入、搜索和执行您机器上的文件 — 无需 Codex，无需 MCP，无需额外费用。 [](https://python.org) [](https://fastapi.tiangolo.com) [](LICENSE) **作者：CLYiX** ## 为什么存在 Codex 配额有限。MCP 需要商业/企业版。DevSpace（[Waishnav/devspace](https://github.com/Waishnav/devspace)）需要 MCP。 **与 ChatGPT、Gemini、Kimi 和任何支持自定义工具调用的 AI 配合使用。** 无需特殊订阅，无需额外协议 — 只需一个 REST API。使用官方平台功能，而不是浏览器黑，因此 **无封号。 最适合于网络与编码配额分离（例如 ChatGPT Plusini）。对于配额共享的平台（例如 Claude），则不那么有益。 ## 起源故事 我实际上几个月前就构建了这个项目的早期版本，并一直私下使用它作为自己的本地 AI 编程环境。它最初是一个个人工具：一种简单的方法，让 ChatGPT 和其他 AI 助手可以读取、写入、搜索本地项目文件依赖 Codex、M任何特定的付费编码。 有一段时间，我计划状态 — 只是一个安工具供自己使用。 Space 出现了。 看到 使得一件事变得明确 AI 编程环境个人黑客。很多人。很多人试图将强大的 AI 模型与自己的机器、项目流程连接起来。 ：为什么要保密它？ CodePaidie 与 DevSpace 走了一条不同的道路。相反，它使用普通的 REST API 和 OpenAPI 模式，这使得它更容易与 ChatGPT Actions、Gemini 函数调用、Kimi 自定义工具和几乎任何支持外部工具调用的平台连接。 DevSpace 是一个伟大的项目。CodePaidie 是同一风暴中的另一个实验。 所以它在这里 — 开源。 让我们一起构建本地 AI 编程工具。让我们使它们更便宜、更简单、更开放，也许还有一点疯狂。 | | CodePaidie | Codex | DevSpace | | --------------------- | :-------------------: | :---------: | :-----------------: | | **平台支持** | 任意（通过扩展） | 仅 OpenAI | ChatGPT（MCP） | | **订阅** | 任意层级 | 专业版/API | 商业/企业版 | | **协议** | REST API | 原生 | MCP | | **设置** | 低 | 无 | 中等 | | **封号风险** | 无（官方 API） | 无 | 可能 | | **DALL-E 图片保存** | 是 | 否 | 否 | | **多项目** | 是 | 否 | 是 | | **网页 UI** | 是 | 否 | 否 | ## 架构 ```text ChatGPT（网页/移动端） | HTTPS（X-API-Key 头） ngrok 隧道 | FastAPI（localhost:8000） | 路径解析 + 认证 本地文件系统（项目隔离） ``` ## 快速开始 ### 1. 安装 ```bash git clone https://github.com/CLYiX/CodePaidie.git cd CodePaidie pip install -r requirements.txt ``` ### 2. 运行 ```bash # 选项 A：一键启动（Windows） start.bat # 选项 B：手动 python run.py ``` 服务器启动在 `http://localhost:8000`。API 密钥打印在控制台中。 3. 设置 ngrok ```bash # 仅首次 setup.bat # 然后启动隧道 ng 8000 ``` 复制 `https://xxx.ng.app` URL。 ### 4. 配置 ChatGPT 1. 打开 ChatGPT → 创建 GPT → **配置** → **操作** 2. 粘贴 OpenAPI 模式（从网页 UI → “OpenAPI” 选项卡，或查看 `openapi.json`） 3. 认证：**API 密钥** → **自定义** → 头名称：`X-API-Key` 4. 粘贴您的 API 密钥 5. 保存 → 在 GPT 中测试 ### 替代：浏览器扩展（v2） 与 **任意** AI 网页聊天室配合使用 — 无需平台操作。 ```bash # 1. 启动 CodePaidie 服务器 python run.py # 2. 在 Chrome 中：chrome://extensions → 开发者模式 → 加载解压 → 选择扩展/ # 3. 点击扩展图标 → 输入服务器 URL + API 密钥 # 4. 打开 ChatGPT / Gemini / / DeepSeek 等 — ``` 扩展程序系统提示，赋予地文件操作能力。当 AI 需要读写文件时，它会输出 `<tool_calls>` 标签。扩展程序拦截它们，调用您的 CodePaidie 服务器，并将结果反馈回去 — 对 AI 透明。 **支持的平台：** ChatGPT, Gemini, Kimi, 通义, 文心, DeepSeek, ChatLM, HuggingChat ## 路径格式 所有文件操作均使用 `project_name/relative_path`： ```text myproject/src/main.py → 读取 “myproject” 中的 src/main.py myproject/ → 列出项目根目录 . → 列出所有项目 ``` 首先调用 `/api/roots` 以发现可用的项目。 ## ChatGPT 系统提示 在新的对话开始时粘贴以下提示之一。 ### 中文版 ```text 你是本地文件桥接工具。所有文件操作使用「项目名/相对路径」格式。 第一步：调 /api/roots 查看可用项目和目录。 第二步：用返回的 project 名作为路径前缀。 示例：读取 C:\Users\me\project\src\main.py → 路径填 myproject/src/main.py 注意： - 不要用 Windows 绝对路径，用「项目名/相对路径」 - 写文件用 POST /api/write，不要用 exec + python -c - 创建目录用 /api/mkdir，不要问用户 - 出错了自己换方案重试，不要让用户排查 ``` ### 英文版 ```text You are a local file bridge tool. All file operations must use the "project_name/relative_path" format. Step 1: Call /api/roots to discover available projects and directories. Step 2: Use the returned project name as the path prefix. Example: To read C:\Users\me\project\src\main.py, use: myproject/src/main.py Rules: - Do not use Windows absolute paths. Always use "project_name/relative_path". - Use POST /api/write to write files. Do not use exec + python -c for file writing. - Use /api/mkdir to create directories. Do not ask the user to create them manually. - If an operation fails, try another reasonable approach yourself instead of asking the user to debug it. ``` ## API 参考 | 端点 | 方法 | 描述 | | -------------------------- | ------ | ---------------------------------------------- | | `/api/roots` | GET | 发现可用项目 | | `/api/read?path=` | GET | 读取文件 | | `/api/write` | POST | 写入文件（正文：`{path, content}`） | | `/api/list?path=` | GET | 列出目录（支持 `offset`、`limit`） | | `/api/tree?path=` | GET | 目录树 | | `/api/delete?path=` | GET | 删除文件/目录 | | `/api/copy?source=&dest=` | GET | 复制 | | `/api/move?source=&dest=` | GET | 移动/重命名 | | `/api/mkdir?path=` | GET | 创建目录 | | `/api/info?path=` | GET | 文件信息 | | `/api/search?query=&path=` | GET | 按文件名搜索 | | `/api/grep?query=&path=` | GET | 搜索文件内容 | | `/api/exec?command=` | GET | 执行 shell 命令 | | `/api/save-image` | POST | 保存 base64 图片（正文：`{path, image_data}`） | | `/api/upload` | POST | 上传文件（多部分：`file` + `path`） | | `/api/browse?path=` | GET | 浏览文件系统（网页 UI） | ## DALL-E 图片工作流 1. ChatGPT 生成图片（返回 base64） 2. 调用 `POST /api/save-image`，参数为 `{path: "myproject/output/image.png", image_data: "base64..."}` ## 网页 UI 打开 `http://localhost:8000` 以访问： - **文件浏览器** — 导航项目，拖放上传 - **项目管理** — 添加/删除项目和目录 - **设置** — API 密钥、扩展、大小限制 - **OpenAPI 模式** — 为自定义 GPT 设置复制粘贴 - **浏览器扩展** — 安装说明 + v2 系统提示 ## 安全与沙箱 CodePaidie 为 AI 工具提供了访问您本地项目的权限。安全不是事后才考虑的问题 — 它被融入了每一层。 ### 沙箱隔离 - **每个项目的沙箱** — 每个项目都是一个单独的隔离范围。AI 处理项目 A 时无法触及项目 B。 - **路径遍历保护** — `safe_path()` 验证每个请求。即使 AI 尝试使用 `../../etc/passwd`，它也会被锁定在沙箱中。 - **无跨项目泄漏** — 项目之间的连接是显式且需选择的。默认情况下，每个项目都是完全隔离的。 ### 访问控制 - **API 密钥认证** — 随机 32 个字符的令牌，在首次运行时自动生成。缺少或无效的密钥返回 401。 - **扩展白名单** — 限制 AI 可以触及的文件类型。阻止 `.env`、`.key`、`.pem` — 或如果您信任沙箱，则允许所有文件。 - **大小限制** — 每个请求的读取/写入限制可配置。防止失控的 AI 消耗您的磁盘空间。设置为 0 以无限使用。 - **目录选择器** — 选择要公开的文件夹。无需访问敏感路径。 ### 网络安全 - **ngrok 基本认证**（可选） — 为隧道添加用户名/密码，以免陌生人访问您的服务器。 - **默认本地主机** — 服务器绑定到 `127.0.0.1`。无需隧道，它对网络不可见。 - **无遥测，无外部调用** — CodePaidie 绝不联网。您的代码保留在您的机器上。 ### 推荐用法 - 仅添加您信任的项目目录 - 不要公开敏感的文件夹 - 不要在启用的项目中存储机密、API 密钥、钱包或私钥 - 不使用时停止隧道 - 将每个连接的 AI 平台视为具有本地机器访问权限的编码合作伙伴 ## 项目结构 ```text CodePaidie/ server.py # FastAPI 后端 run.py # 入口点 start.bat # 一键启动（服务器 + ngrok） setup.bat # 首次 ngrok 安装 config.json # 运行时配置（，gitignored） .example.json # 配置模板 requirements.txt # Python 依赖项 api.json # 模式备份 index.html # UI # Chrome 扩展（v2） manifest.json # 清单 V3 background.js 调用 CodePaidie API content # 平台检测 + 工具调用注入 popup.html/js # 扩展配置 UI icons/ # 扩展图标 ``` ## 开发历史 ### v1 — 基本 API FastAPI + 单个沙箱目录，无 UI，手动配置编辑。 ### v2 — 网页 UI + 隧道 中文网页 UI，ngrok 集成，自定义 GPT 的 OpenAPI 模式。 ### v3 — 多项目隔离 基于项目的模型：每个项目都有一个名称、多个目录、启用/禁用切换。路径格式：`project_name/relative_path` v4 — 安全白名单，大小路径遍历保护，删除 ngrok 基本认证（ GPT 不兼容）。 5 — 完整 图片保存 所有，DALL-E，文件上传拖目录选择器 UI v2.0浏览器扩展 Chrome程序，将本地文件操作注入任何 AI 网页。与 ChatGPT、、Kimi、配合使用 —平台操作。无需费用。 ##问题 **问会让我的账户被** 答：不会。这使用自定义 GPT 操作 — 一个官方支持的 OpenAI 功能。它与“让 ChatGPT 检查天气”或“查找股票”使用的相同机制，只是它指向您自己的服务器。无需浏览器自动化，无需脚本注入，无需违反服务条款。 **问：为什么不使用 MCP？** 答：ChatGPT 中的 MCP 支持需要商业/企业/教育订阅。DevSpace 需要 MCP。这个项目与任何 Plus 账户配合使用 — 最常见的层级。 **问哪些 AI 平台？** 答：两种模式：模式 1原生操作（v** ChatGPT 自定义，Gemini 函数调用，Kimi 自定义工具具有外部工具支持的平台。 **模式 2 — 浏览器扩展（v2）：** 任意 AI 网页聊天室。ChatGPT、Gemini、Kimi、通义、文心、DeepSeek、ChatLM、HuggingChat — 如果它有文本输入，扩展程序就会起作用。 如果平台允许您为 AI 调用定义外部 API，它就可以与 CodePaidie 配合使用。如果它不允许，请使用浏览器扩展。 **问：有哪些平台对此不适用？** 答：有。Claude 共享网络和代码配额，因此没有优势。具有无限或独立编码配额的平台受益最大。 ## 许可证 MIT