# GPT Plus Plus

**让支持 MCP 的 GPT 网页端或 AI 客户端控制你 Windows 电脑上的本地开发工具。**

**注意：原版源码已被gpt删除无法恢复，此源码为快照版，建议使用exe版本**

GPT Plus Plus 是一个 Windows 桌面程序。它可以把你选择的本地项目目录提供给 GPT 或其他支持 MCP 的客户端，让 AI 在权限控制下进行：

- 查看项目文件和目录；
- 搜索代码；
- 修改文件；
- 执行测试和开发命令；
- 查看 Git 状态、差异和提交记录；
- 查看图片等项目资源。

默认权限是 `safe`。不需要安装 Docker 或 WSL。

> 注意：GPT 网页端必须支持自定义 MCP 服务或远程连接器功能。不同账号、地区和客户端版本的界面名称可能不同。

## 最简单的使用方式：Windows EXE

从 GitHub 的 **发布** 页面下载：

```text
GPT++-0.5.0.exe
```

双击运行，不需要另外安装 `uvx`、Python、MCP CLI 或 cloudflared。

### 使用步骤

1. 打开 `GPT++-0.5.0.exe`。
2. 在左侧选择或创建一个工作区，指向你要让 AI 操作的项目文件夹。
3. 保持权限模式为 `safe`。
4. 启动本地 MCP 服务。
5. 如果只在本机使用，使用显示的本地地址：

   ```text
   http://127.0.0.1:<端口>/mcp
   ```

6. 如果要让 GPT 网页端从外部连接，在“公网访问”中选择 Quick Tunnel 或固定域名 Tunnel。
7. 等待界面显示公网地址已经就绪，再复制显示的 MCP 地址：

   ```text
   https://<公网域名>/mcp
   ```

8. 在支持 MCP 的 GPT 网页端或 AI 客户端中，添加一个远程 MCP 服务，把上面的地址填入连接地址。
9. 按界面提示完成 OAuth 或 Bearer Token 认证；没有认证的配置只适合本机测试，不要暴露到公网。
10. 连接成功后，可以直接对 GPT 说：

    ```text
    请读取当前项目结构，运行测试，并告诉我第一个失败的原因。
    ```

### 两种 Tunnel 模式

- **Quick Tunnel**：不需要填写 Tunnel Token，会生成临时公网地址。每次重新启动地址可能变化。
- **固定域名 Tunnel**：需要你在桌面设置中填写自己的 Tunnel Token 和公网地址。凭据只保存在本机配置中，不会写入源码或 EXE。

程序不会仅因为 cloudflared 打印了一个 URL 就显示“已就绪”，还会检查公网 MCP metadata 和 `/mcp` 响应，避免出现“看起来连接成功但 GPT 调不到工具”的情况。

## GPT 网页端怎么控制本地工具

连接关系如下：

```text
GPT 网页端
    ↓ HTTPS + MCP
公网 Tunnel 地址 /mcp
    ↓
GPT Plus Plus 本地服务
    ↓
safe 权限控制
    ↓
你选择的 Windows 项目文件夹
```

GPT 不能绕过 MCP 服务直接读取你的电脑。它只能调用服务公开的工具；服务会检查路径、权限、命令和工作区边界。

建议第一次只连接一个测试项目，并保持 `safe` 模式。不要把包含密码、私钥、浏览器资料或其他敏感信息的文件夹作为工作区。

## 本地开发运行

如果你要从源码运行，而不是使用 EXE：

```bat
cd /d D:\测试文件夹\gpt-plus-plus
python -m venv .venv
.venv\Scripts\python.exe -m pip install -e ".[desktop,dev]"
.venv\Scripts\gpt-plus-plus-desktop.exe
```

也可以使用：

```bat
python -m pip install -e ".[desktop,dev]"
gpt-plus-plus-desktop
```

运行测试：

```bat
python -m unittest discover -s tests -p "test_*.py" -t . -v
```

## 安全提醒

- 默认使用 `safe`，但它不是 Docker 级别的完整沙箱。
- 不要把 Tunnel Token、Bearer Token、OAuth 密码或私钥提交到 GitHub。
- 不要把 `.env`、profiles、OAuth 状态、日志、`build`、`dist` 或 EXE 上传到源码仓库。
- 远程连接必须使用 HTTPS 和认证。
- 只把你愿意让 AI 操作的项目目录设置为工作区。
- 不要在不可信项目中随意使用 `trusted` 或 `dangerous` 模式。

## 源码与打包

源码仓库不包含 `cloudflared.exe`。Windows Release 工作流会下载锁定版本的官方 cloudflared，检查 SHA-256 和 Authenticode 后再打包。

Windows 打包说明见：

```text
packaging/windows/BUILDING.md
```

## 文档

- [隐私说明](PRIVACY.md)
- [安全策略](SECURITY.md)
- [贡献指南](CONTRIBUTING.md)
- [第三方声明](THIRD_PARTY_NOTICES.md)
- [许可证](LICENSE)
- [运行时协议说明](docs/runtime-contract-v0.5.md)
- [工具和接口说明](docs/tools-and-schemas.md)
- [English README](README.en.md)
  

## 许可证

本项目使用 [Apache License 2.0](LICENSE)。来源和第三方声明见 [NOTICE](NOTICE) 与 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。