把网页 ChatGPT 变成本地开发助手：DevSpace 部署与 Windows GUI 启动器实战

网页里讨论好了改法，接下来还得把代码复制回电脑、运行、再把报错贴回去。DevSpace 要接上的就是这段流程：通过本机 MCP 服务，让 ChatGPT 读取项目、修改文件和执行命令。它也能调度本机已有的 Coding Agent，不再只有“网页连接本地电脑”这一种用法。

版本更新至 2026-10-23：正式版为 1.0.8，最新预发布为 1.1.0-beta.4。 两者不能混称为“最新版”。下文以正式版的配置和命令为主，同时交代 beta 的安全修复及使用条件；安装与接入步骤依据官方资料整理，不是本机重新部署记录。

先分清正式版和测试版

这个安全差异不能略过：beta.4 的修复说明不能当成 1.0.8 已包含修复的证据。准备把服务接到公网或处理不可信仓库时，应先确认所用版本是否包含该修复，再评估预发布风险；没有确认前，先在低权限账号、无敏感数据的测试项目里验证，不要直接开放工作电脑上的真实业务目录。

本文的目标不是简单翻译 DevSpace 官方 README，而是让你完成两件事：

• 在本机部署 DevSpace，接通指定测试项目，分清目录限制、命令权限和连接审批。
• 让你的 AI Agent 根据任务书开发一个 Windows GUI 启动器，管理网页连接服务、地址和配置。它是本文的自建方案，不是 DevSpace 官方客户端。

如果你只想手工部署，可以按前半部分操作；如果你想让自己的 AI Agent 直接帮你复现，请重点复制后面的“AI Agent 执行任务书”。

*早期 ChatGPT 接入示例，保留用于理解连接效果；当前入口以本文更新后的步骤为准。*

DevSpace 到底解决什么问题

DevSpace 一端提供文件读写和命令执行等 MCP 工具，另一端可以管理本机的编程 Agent。1.0.8 初始化时先选择 ChatGPT、Coding Agents 或两者；只使用本地 Agent 时，不必为此创建公网地址或启动网页 MCP 服务。初始化与两条使用路径

目录授权和连接审批的边界见 DevSpace 1.0.8 Security Model。

你可以把它理解成一条受控通道：

这条链路里有几个关键点：

• DevSpace 只应该运行在你信任的电脑上。
• allowedRoots 约束 MCP 文件工具可打开的项目目录，但不是整个进程的沙箱；shell 命令仍拥有运行账号的权限。
• Owner password 是审批连接用的密码，保存在 ~/.devspace/auth.json，不要发给别人。
• publicBaseUrl 是公网 HTTPS 根地址，配置时不要带 /mcp。
• MCP 客户端里填写的才是完整地址，例如 https://mcp.example.com/mcp。

这也是为什么我建议做一个 GUI 启动器：命令行流程本身不复杂，但用户很容易把公网地址、/mcp、授权目录和 token 搞混。GUI 的价值不是替代 DevSpace，而是把危险步骤做得更可见、更可控。

如果你只想让本机已有的 Codex 或 Claude Code 接手任务，可以选择 Coding Agents 路径，再用下面两条命令检查目标与后台状态：

devspace agents targets
devspace agents daemon status

这不会替你安装或登录对应 Agent。已有会话可按 devspace agents continue <id> 接续；网页服务与 Agent daemon 是两套生命周期，关闭 devspace serve 不代表正在运行的 Agent 已停止。1.0.8 会话与守护进程说明

准备环境

1.0.8 的 Node 要求仍是 >=22.19 <27，不是随便安装一个 Node 22 小版本就够了。下表中的 .NET 仅用于本文自建启动器；公网 HTTPS 地址仅用于下文的网页接入路径。

Node 与 Windows Shell 的要求见 DevSpace 1.0.8 Setup Guide。

建议先准备这些环境：

Windows 用户要特别注意：DevSpace 官方文档说明，只有 PowerShell 或 cmd.exe 还不够，Windows 下建议安装 Git Bash 或使用 WSL。如果你只部署 DevSpace，不开发 GUI，可以暂时不装 .NET SDK；如果要让 AI Agent 复现本文的 Windows GUI 启动器，就必须准备 .NET 8 SDK。

手动部署 DevSpace

1. 安装 DevSpace CLI

先查看发布通道。以下命令只查询包信息，不安装：

npm.cmd view @waishnav/devspace dist-tags --json

核验时 latest 指向 1.0.8，beta 指向 1.1.0-beta.4。选择正式版、并确认安装权限后，可以固定版本安装：

npm.cmd install -g @waishnav/[email protected]
npm.cmd ls -g @waishnav/devspace --depth=0

也可以不全局安装，后续都用 npx：

npx.cmd @waishnav/[email protected] init
npx.cmd @waishnav/[email protected] serve

npx 也会下载、缓存并执行第三方代码，不是免安装风险的“纯查看”。如果决定评估 beta.4，应把安装、初始化和启动使用的版本统一固定为 1.1.0-beta.4，先检查其变更，不要混用全局正式版和临时 beta。无版本号的安装通常跟随 latest，不会自动取得 beta 的修复。

2. 初始化配置

运行：

devspace init

1.0.8 先让你选使用方式。本篇网页接入选择 ChatGPT；需要同时调度本地编程 Agent，再选两者。Coding Agents 路径还会列出检测到的 provider，让你选择启用项；已有 subagents 等设置应保留，不能用旧教程的简化 JSON 覆盖整个配置。

ChatGPT 路径再配置允许打开的目录和公网地址。不要填整盘、用户根目录或项目集合目录，先用一个没有敏感资料的测试项目：

D:\work\devspace-demo

网页 MCP 服务默认端口为 7676。DevSpace 不会自动替你建立隧道，HTTPS 转发须另行配置到 http://127.0.0.1:7676。

公网 HTTPS 根地址填 origin，不带 /mcp：

https://mcp.example.com

MCP 客户端里再填写完整地址：

https://mcp.example.com/mcp

这个区别非常重要。很多连接失败都来自把 /mcp 写进了 publicBaseUrl。

3. 启动服务

如果已经完成初始化，可以直接启动：

devspace serve

如果你使用的是临时隧道，每次地址会变化，也可以只在本次启动时覆盖公网地址：

$env:DEVSPACE_PUBLIC_BASE_URL="https://new-tunnel.example.com"
devspace serve

4. 验证端点

本机先检查：

curl.exe http://127.0.0.1:7676/.well-known/oauth-authorization-server
curl.exe http://127.0.0.1:7676/.well-known/oauth-protected-resource/mcp

公网再检查：

curl.exe https://mcp.example.com/.well-known/oauth-authorization-server
curl.exe https://mcp.example.com/.well-known/oauth-protected-resource/mcp

返回 JSON 只说明发现端点可达，不代表 OAuth、工具调用和目录权限都已经验证。端点正常后，再进行客户端授权和一次只读任务。

在网页 ChatGPT 中添加 DevSpace MCP 应用

本地服务和公网端点都验证通过后，还需要在网页端 ChatGPT 里把 DevSpace 添加成一个 MCP 应用。这个步骤对新手很关键：DevSpace 服务启动成功，不等于 ChatGPT 已经知道它在哪里。

DevSpace 侧的工作区流程见 1.0.8 ChatGPT Coding Workflow。ChatGPT 的入口已有变化：当前官方说明从 Plugins 添加自定义 MCP Server，能否添加还受账号与工作区策略控制。OpenAI 当前连接说明

1. 打开当前的插件入口

在网页 ChatGPT 打开 Plugins，点击加号，选择 Add custom MCP server。若工作区没有此选项，先核对管理员策略和账号可用能力，不要为找不到入口反复重装 DevSpace。

*2026年7月的旧版入口截图，不是当前 Plugins 路径。*

2. 确认连接方式

本文采用公网 HTTPS 端点，在 Connection 中填服务器 URL。OpenAI 当前也提供 Secure MCP Tunnel 选项，但它不是本文的普通 HTTPS 转发步骤，不能只换一个下拉框就当作已完成适配。

*旧版“应用”页，仅保留作历史界面对照。*

3. 填写新应用信息

新应用表单里建议这样填写：

• 名称：写 DevSpace 或 本地项目助手。
• 描述：简单说明用途，例如 连接本机 DevSpace MCP 服务，用于访问已授权的本地项目目录。
• 连接：选择 服务器 URI，填写完整 MCP 地址，例如 https://mcp.example.com/mcp。
• 身份验证：选择 OAuth。
• 勾选风险确认：确认你理解自定义 MCP 服务器的风险。
• 选择 Create as a plugin，检查发现的工具和元数据，完成安装后在新对话中用 @ 选择它。

*旧表单展示名称、地址和 OAuth 的含义；按钮位置以当前插件表单为准。*

这里最容易出错的是地址：

• DevSpace config.json 里的 publicBaseUrl 只能写根地址，例如 https://mcp.example.com。
• ChatGPT 新应用里的服务器 URI 必须写完整 MCP 地址，例如 https://mcp.example.com/mcp。
• 不要把 https://mcp.example.com 直接填到 ChatGPT 的服务器 URI 里，也不要把 /mcp 写进 DevSpace 的 publicBaseUrl。

创建完成后，ChatGPT 连接 DevSpace 时会打开 Owner password 审批页。输入 devspace init 输出的 Owner password，或从 ~/.devspace/auth.json 中查看。这个密码只用于你本人审批连接，不要截图公开，也不要写进教程、代码仓库或共享文档。

完成授权后，先在新对话里给一个可核对的小任务：

请通过 DevSpace 打开 D:\work\devspace-demo，复用返回的 workspaceId。
只读取 README 和项目入口文件，告诉我启动命令写在哪里，并指出文件路径。
不要修改文件、安装依赖、执行 shell 命令或启动其他 Agent。

默认 minimal 工具模式下没有单独的 grep、glob、ls，不要因为没看到它们就判断连接失败。先确认 open_workspace 和读取工具能返回正确文件，再按需要授权修改。worktree 模式用于分开工作副本，不是安全沙箱，且不会自动带上当前未提交改动。工作区与工具模式

为什么要做 Windows GUI 启动器

命令行可以完成全部工作，但对很多普通用户来说，真正麻烦的是“运行状态不可见”。他们不知道服务是否启动，不知道当前 MCP URL 是什么，也不知道 Owner password 在哪里。

一个实用的 GUI 启动器至少要覆盖这些能力：

• 启动、停止、重启本启动器管理的 devspace serve。
• 分开显示网页服务状态与 Agent daemon 状态，不能把“7676 已停止”显示成“所有任务已停止”。
• 显示并复制 publicMcpUrl。
• Owner password 默认遮罩，仅用户主动操作时本地查看或复制，不进入日志。
• 添加、删除、保存 allowedRoots。
• 打开 config.json、auth.json、webgpt-session.json 和日志目录。
• 启动时不冻结界面，后台轮询健康端点。

这类 GUI 不需要做成复杂平台。第一版用 .NET 8 + WPF 就够了，重点是把危险配置做清楚，把状态反馈做好。

上图是自建启动器的结构草图，不是官方 GUI。webgpt-session.json 也是这个启动器自行维护的会话文件，不是 DevSpace 要求你手工创建的认证文件。

给 AI Agent 的完整执行任务书

下面这一段可以直接复制给你自己的 AI Agent。建议先让 Agent 只做本机部署和 GUI 开发，不要一开始就改系统服务、注册表或开机自启动。

你是我的本机开发助手。请依据 DevSpace 1.0.8 文档评估部署，并开发一个自建 Windows GUI 启动器，管理网页 MCP 服务、MCP URL、Owner password 和 allowedRoots。先核对发布通道；1.1.0-beta.4 含工作区符号链接逃逸修复，但仍为预发布。没有确认版本风险前，不接入真实业务目录或公网生产环境。

执行方式：
- 必须分阶段执行：环境预检 -> 等待用户确认安装/配置 -> 部署 DevSpace -> 等待用户提供或确认公网 HTTPS 根地址 -> 开发 GUI -> 验收。
- 涉及安装全局 npm 包、安装 .NET SDK、配置公网隧道、修改系统服务、设置开机自启动、停止未知进程或产生费用的动作，都必须先说明影响并等待我确认。
- 如果当前机器没有公网 HTTPS 根地址，只能给出 Cloudflare Tunnel、ngrok、Pinggy、Tailscale Funnel 或反向代理的选择建议，不能替我注册账号、开通付费服务或擅自配置永久域名。

目标：
1. 部署 DevSpace，让网页端 ChatGPT 或其他 MCP 客户端可以通过公网 HTTPS /mcp 地址访问本机 DevSpace。
2. MCP 文件工具只授权一个明确项目，不授权 C:\、D:\、用户目录根或整盘。另行说明 shell 具有本机账号权限，allowedRoots 不是 shell 沙箱。
3. 开发一个 .NET 8 + WPF GUI 程序，降低普通用户使用 DevSpace 的操作难度。
4. 不输出、上传或泄露 auth.json、Owner Token、真实公网域名、真实项目路径中的敏感信息。

执行前必须先做环境检查：
- 执行 node --version，确认 Node 满足 DevSpace 官方当前要求，优先使用 Node 22 LTS。
- 执行 npm --version，确认 npm 可用。
- 执行 git --version，确认 Git 可用。
- 执行 `where.exe bash` 或 `Get-Command bash -ErrorAction SilentlyContinue`，确认 Windows 上有 Bash 兼容 shell。
- 执行 npm.cmd view @waishnav/devspace dist-tags --json，区分 latest 与 beta；固定经我确认的版本，不静默切换通道。
- 执行 `dotnet --info`，确认已安装 .NET 8 SDK；如果没有，只能提示用户安装，不能擅自安装。
- 确认用户已经准备一个公网 HTTPS 根地址，例如 `https://mcp.example.com`。如果没有公网地址，停止部署并向用户说明下一步选择。
- 如果环境缺失，先列出缺失项和安装建议，等待我确认，不要直接安装大依赖。

DevSpace 部署要求：
- 正式版安装示例为 npm.cmd install -g @waishnav/[email protected]；须在版本风险与安装许可确认后执行。
- 不全局安装时使用 npx.cmd @waishnav/[email protected]；它仍会下载执行代码。若选择 beta.4，全部命令统一固定该版本。
- 配置文件目录使用默认 ~/.devspace。
- 首次运行官方 devspace init，按网页需求选 ChatGPT 或两者；不要跳过当前版本的模式选择。
- 让官方初始化管理 config.json 和 auth.json，不自行拼装认证文件。已有配置、subagents 和未知字段必须保留，不使用 init --force 覆盖已有设置。
- Owner password 不自定义为弱口令，不打印到日志或提交到 Git。
- publicBaseUrl 只能是 https://mcp.example.com 这种根地址，不能带 /mcp。
- 如果用户没有提供 publicBaseUrl，脚本必须停止并提示用户，不要自动生成假地址，不要自动申请公网隧道。
- MCP 客户端里使用的地址才是 https://mcp.example.com/mcp。
- 本地服务端口默认使用 7676。

建议生成两个 PowerShell 脚本：
1. start-devspace-webgpt.ps1
   - 读取已有配置；缺失时引导用户执行官方初始化，不写一份旧版最小 JSON 冒充完整配置。
   - 认证文件仅按需要本地读取，不由启动器创建、重写或重置。
   - 保留已有 allowedRoots，不要擅自覆盖。
   - 检查 7676 端口。只有会话文件记录为本启动器所有、且 PID、进程启动时间和命令路径均匹配的进程才可管理；其他监听者只报告，不凭名称或端口强杀。
   - 启动 devspace serve。
   - 轮询 http://127.0.0.1:7676/.well-known/oauth-authorization-server。
   - 本地端点就绪后写入自建的 ~/.devspace/runtime/webgpt-session.json，记录 startedAt、进程启动时间、命令路径、allowedRoots、port、publicBaseUrl、publicMcpUrl、authPath、devspacePid、日志路径，不保存密码。该文件不是官方配置契约。
2. stop-devspace-webgpt.ps1
   - 读取 ~/.devspace/runtime/webgpt-session.json。
   - 只停止属于本启动器且身份重新核对一致的 devspace serve 进程，不误杀 PID 已复用的进程。
   - 不连带停止 devspace-agentd 或其他 Agent 会话。单独显示 daemon 状态；终止任务需另获授权。
   - 不删除 config.json、auth.json、allowedRoots。
   - 如果 7676 被未知程序占用，停止并提示用户，不要强杀未知进程。

GUI 程序要求：
- 技术栈：.NET 8 + WPF。
- 项目名：DevSpaceGui。
- 主窗口标题：DevSpace 本地控制台。
- 主窗口至少包含 5 个区域：
  1. 服务状态：分别显示本地端点、公开端点及 Agent daemon；OAuth 与工作区验证单独显示，不能凭本地 HTTP 成功宣称全部可用。
  2. 连接信息：显示 publicBaseUrl、publicMcpUrl，并提供复制 MCP URL 按钮。
  3. 授权信息：密码默认遮罩，仅用户主动操作后短暂显示或复制，不回显到操作日志。
  4. 允许访问的目录：ListBox 展示 allowedRoots，提供添加目录、删除选中、保存配置、保存并重启。
  5. 辅助操作和日志：打开 config.json、session 文件、日志目录，并显示操作日志。
- 添加目录时使用 FolderBrowserDialog。
- 用户添加目录后，在保存前不能被自动刷新覆盖。
- 启动和重启必须后台执行，不能冻结 UI。
- GUI 每 3 秒刷新一次状态，但不能覆盖未保存的 allowedRoots。
- 重新构建前必须提醒用户关闭正在运行的 DevSpaceGui.exe，否则 apphost 可能被锁定，导致新代码没有真正编译进 exe。
- 状态判断优先使用本地健康端点，而不是只看 PID。

核心实现建议：
- MainWindow.xaml 负责界面布局。
- MainWindow.xaml.cs 负责状态读取、脚本启动、健康检查和按钮事件。
- 用 DispatcherTimer 做状态刷新。
- 用 HttpClient 请求 http://127.0.0.1:7676/.well-known/oauth-authorization-server 判断服务是否就绪。
- 配置局部更新须保留未知字段；System.Text.Json 可维护启动器自有 session 文件，不重写 auth.json。
- 用 ProcessStartInfo 后台启动 PowerShell 脚本，CreateNoWindow=true。
- 启动服务时设置 _isStartingService 标记，服务就绪后立即清除忙碌状态。

参考实现行为：
- `LaunchScriptDetached(...)` 只负责后台发起启动脚本，不同步等待 PowerShell 结束。
- `WaitForServiceReadyAsync(...)` 在约 45 秒内轮询健康端点，成功后立刻刷新状态并解除按钮锁定。
- `DispatcherTimer` 每 3 秒刷新一次状态，但 `_allowedRootsDirty=true` 时不能重置列表。
- `ProbeLocalServerAsync(...)` 以 `http://127.0.0.1:7676/.well-known/oauth-authorization-server` 是否可访问作为主要运行状态依据。
- `webgpt-session.json` 只记录本启动器拥有的网页服务；显示状态仍需核对存活进程和实际端点，不代表全部 Agent 状态。
- 如果启动脚本失败，GUI 要显示一行友好错误，并提示查看 stdout/stderr 日志。

安全规则：
- 不允许把 C:\、D:\、用户目录根、桌面根目录直接加入 allowedRoots。
- 不允许把 Owner Token 写进教程、日志、截图或提交到 Git。
- 不允许把真实公网域名写进公开教程截图。
- 不允许开启 DEVSPACE_ALLOWED_HOSTS=*，除非我明确说只是本地调试。
- 不允许启用包含密钥的 shell 命令日志。
- 不允许自动配置永久 Cloudflare 子域名；如果用户需要固定地址，只能说明方案并等待用户单独确认。

验收标准：
- `dotnet --info` 能看到 .NET 8 SDK。
- `dotnet build` 可以通过。
- GUI 打开后不会卡死。
- 点击“启动服务”后，状态能从启动中变成运行中。
- 本机端点 http://127.0.0.1:7676/.well-known/oauth-authorization-server 可以返回内容。
- GUI 可以复制 publicMcpUrl。
- 密码默认隐藏，只有明确点击才可本地复制；日志和截图不出现密码。
- 添加 allowedRoots 后点击保存，config.json 中能看到新增目录。
- 保存并重启后，新增 allowedRoots 仍然存在。
- 停止网页服务后准确显示该服务已停；若 Agent daemon 仍在运行，仍须单独显示，不能声称全部停止。
- 所有截图和日志都不能出现真实 token 或真实公网域名。

完成后请给我：
- 文件清单。
- 如何启动 GUI。
- 如何把 MCP URL 填到 ChatGPT。
- 常见故障和处理方式。
- 你执行过的验证命令和结果。

这段任务书故意写得比较细。原因是 DevSpace 一旦接通，就等于把一部分本机开发能力交给网页端 AI Agent。越是自动化，越要把边界说清楚。

固定域名是不是必须做

不是必须。

如果你只是测试，可以用临时隧道地址。缺点是每次地址变化后，都需要更新 publicBaseUrl，然后在 MCP 客户端里重新确认连接。

如果你希望长期使用，可以给 DevSpace 准备一个固定 HTTPS 子域名，让它稳定转发到：

http://127.0.0.1:7676

但这属于进阶运维配置，不是本文主流程。你只需要记住两个规则：

• DevSpace 的 publicBaseUrl 填固定根地址，例如 https://mcp.example.com。
• ChatGPT MCP 客户端填完整 /mcp 地址，例如 https://mcp.example.com/mcp。

不要把你的真实域名、真实 token 或真实项目路径写进公开教程。

常见问题

为什么服务启动了，ChatGPT 还是连不上

官方还整理了 DevSpace 1.0.8 Troubleshooting Gotchas，可按具体报错核对。若升级 Node 后出现 better-sqlite3 加载错误，先用 devspace doctor 检查运行时与原生依赖，确认原因后再修复，不要先删除整套配置重装。

先检查公网地址是不是能访问 .well-known 端点。如果本机能访问，公网不能访问，通常是 Tunnel 或反向代理没有指向 http://127.0.0.1:7676。

为什么提示 public URL 或 Host 不对

检查 publicBaseUrl 是否误写了 /mcp。配置里应该是：

https://mcp.example.com

客户端里才是：

https://mcp.example.com/mcp

为什么 Windows 下命令执行失败

DevSpace 的 shell 执行需要 Bash 兼容环境。安装 Git for Windows 后，通常会带 Git Bash。只有 PowerShell 或 cmd.exe 不够。

为什么 workspace path rejected

你让 ChatGPT 打开的项目路径不在 allowedRoots 下。先在 GUI 里添加正确目录，保存并重启，再让 ChatGPT 重新打开 workspace。

为什么要避免授权整盘

收窄 allowedRoots 有助于限制文件工具，不会撤销 shell 对其他目录的访问权限。敏感任务应配合低权限账号或独立隔离环境。文件工具还要考虑前文的符号链接修复，不能只看配置里有没有目录白名单。

同样，“自托管”只说明服务在本机运行。工具返回给 ChatGPT 的源码或命令输出会进入对应的 AI 服务处理流程，不等于离线；先按公司要求确认哪些内容可以外发。安全边界

结果验收清单

完成部署和 GUI 后，用这份清单验收：

• [ ] node --version 满足 DevSpace 官方当前要求。
• [ ] 如开发自建 GUI，dotnet --info 能看到 .NET 8 SDK；只用 CLI 不需要此项。
• [ ] Windows 下 where.exe bash 或 Get-Command bash 能找到 Bash。
• [ ] devspace doctor 没有关键错误。
• [ ] 本机 7676 端口健康端点可访问。
• [ ] 公网 HTTPS .well-known 端点可访问。
• [ ] MCP 客户端填写的是 /mcp 完整地址。
• [ ] publicBaseUrl 不带 /mcp。
• [ ] allowedRoots 只包含具体项目目录。
• [ ] auth.json 没有被提交、截图或分享。
• [ ] GUI 启动、停止、保存配置、保存并重启都正常。
• [ ] 未知程序占用 7676 时，脚本不会直接强杀。
• [ ] 重新构建 GUI 前，已关闭正在运行的 DevSpaceGui.exe。
• [ ] ChatGPT 的文件工具能读取授权测试项目，并拒绝未授权项目；不把这项当作 shell 隔离证明。
• [ ] 已明确所选版本的符号链接修复状态，没有把 beta 修复写成正式版已具备。
• [ ] 关闭网页服务时，本地 Agent daemon 和会话状态仍独立可见。