源码系统概览
文章正文
DevSpace 是一个自托管的 MCP 服务器，让 ChatGPT 直接操作本地代码仓库。
部署后，浏览器里的 ChatGPT 就能像 Codex 一样读写、搜索并运行项目文件。
装上它相当于多了一套 Codex 风格的工作流，编程额度自然翻倍。
源码简介
仓库由 Waishnav 维护，核心理念是把 ChatGPT 改造成一个能落地的 Codex 编码伙伴。
服务端使用 TypeScript 编写，基于 Node.js 22.19 以上版本运行，前端用 React 与 Vite 构建差异卡片。
通信走标准 MCP 协议，ChatGPT 通过 HTTPS 隧道连到本地 127.0.0.1 的 7676 端口。
Owner 密码存放在 ~/.devspace/auth.json，所有调用都要经用户显式授权。
项目以 MIT 协议开源，CLI 通过 npm 以 @waishnav/devspace 名义发布。
仓库包含 examples、skills、docs 等子目录，提供 agent 配置与官方教程。
MCP 工具默认覆盖文件读写、目录搜索与 shell 执行三类基础能力。
适用场景
在 ChatGPT 网页里调试本地仓库，不用把代码上传到第三方。
给 ChatGPT 配一套 Codex 风格的工作流，等于额外多了一份编程助手额度。
团队内网部署时，让 AI 直接读写授权的内部代码目录并执行测试。
教学场景下，用 MCP 把 ChatGPT 接到学生本地的练习项目做点评。
个人开发者也可以拿它跑私有代码库的自动化重构与脚本批处理。
功能亮点
支持文件读写、目录搜索、shell 命令执行等基础工具，全部走 MCP 工具卡片。
Git worktree 隔离机制让多个编码会话并行而不互相覆盖。
自动识别仓库根目录的 AGENTS.md 与 CLAUDE.md 指令文件。
提供 devspace-agentd 本地守护进程，配合 ChatGPT 完成长时间任务。
内置 review_checkpoints 模块，每次变更都能生成可视化差异卡片。
集成 examples/agents 目录的 copilot-reviewer、pi-reviewer 等只读审查 agent。
技术架构与部署指南
技术栈与运行环境
开发语言：TypeScript 5.x，模块系统采用 NodeNext，前后端共享类型。
核心框架：Node.js 22.19 至 26 版本，UI 基于 React 18 与 Vite 5 构建。
通信协议：Model Context Protocol，HTTP 与 JSON-RPC 走 127.0.0.1 的 7676 端口。
持久化：配置与鉴权写入 ~/.devspace 目录，不依赖外部数据库。
部署方式：支持本地 npm 全局安装、npx 临时运行以及 Cloudflare Tunnel 隧道暴露。
安装与部署提示
先确认 Node 版本在 22.19 到 26 之间，运行 node -v 检查。
全局安装命令是 npm i -g @waishnav/devspace，装完用 devspace init 初始化。
初始化时选择允许暴露的本地根目录，默认端口 7676，可改成其他值。
启动服务执行 devspace serve，日志会打印 MCP 端点与公网 URL 推导结果。
公网访问需要自备 Cloudflare Tunnel 或 ngrok，并把完整地址写入 DEVSPACE_PUBLIC_BASE_URL。
macOS 与 Linux 直接可用，Windows 需先装 Git Bash 或 WSL。
完成后用 devspace doctor 自检 Node、npm、Git 与 Bash 依赖是否齐全。
截图与演示说明
仓库 docs/assets 目录提供官方面板截图，下面这张展示 DevSpace 接入 ChatGPT 后的整体效果。
截图区还包含 review_payload 的差异卡片渲染示例，可在 src/ui/review-payload.tsx 找到对应组件。
examples/agents 目录下的 pi-reviewer 配置展示如何接入 openai-codex/gpt-5.5 做只读审查。
常见问题
问DevSpace 和 Codex 是什么关系？
DevSpace 不替代 OpenAI Codex，而是把 ChatGPT 包装成具备 Codex 风格工作流的能力。
问它会把代码上传给第三方吗？
不会，DevSpace 完全自托管，只有你自己能通过 Owner 密码审批连接。
问能在 Windows 上用吗？
可以在 Git Bash 或 WSL 下运行，PowerShell 暂不支持。
问需要付费的 API 吗？
服务端本身不收费，只是 ChatGPT 那侧的订阅与额度由 OpenAI 决定。
安全风险提示
Owner Token 必须使用长随机串，避免使用弱密码。
仅将必要的本地目录加入 DEVSPACE_ALLOWED_ROOTS 白名单。
关闭公网访问时请删除 DEVSPACE_PUBLIC_BASE_URL 并重启服务。
examples/agents 下的第三方审查 profile 请审阅 provider 字段后再启用。
对外暴露前务必确认 Host 头白名单，避免被恶意域名劫持。
下载说明
本页提供 waishnav/devspace 仓库完整源码打包下载，含 src、docs、examples、skills 等目录。
源码仅供学习与二次开发，请遵守 MIT 许可证约定。
npm 包名 @waishnav/devspace 可在 Node.js 22.19 及以上环境直接安装。
GitHub项目开源地址：https://github.com/waishnav/devspace
视频教程
抖音上有作者分享 DevSpace 的实战演示，重点展示把 ChatGPT 升级为 Codex 风格工作流后如何多出一倍的编程额度。
视频里完整演示了 devspace init 到 ChatGPT 连通的流程，配合本仓库源码逐行对照效果更好。
