Unlimited Agent

Unlimited Agent 允许私有 ChatGPT 应用操作其所有者配对的 Windows 电脑：文件、PowerShell、程序、屏幕截图、鼠标和键盘、剪贴板以及 Chrome。

它使用 ChatGPT 作为大脑。它不调用模型 API、不消耗 Codex 令牌，也不安装 OpenAI 模型 API 密钥。用户仍然需要一个受限的 Secure MCP Tunnel 运行时凭据（Tunnels: Read + Use），以便本地桥接器可以对其自己的隧道进行身份验证；该凭据无法执行模型推理，并且使用 Windows DPAPI 加密。

[!WARNING] 完全远程控制功能强大。仅可在所有者知情同意的情况下安装。除非您了解更改后果，否则请保留默认的 balanced + dangerous 审批策略。

它能做什么

• 读取、搜索、创建、编辑、复制、移动和删除可访问的文件

• 立即或作为后台任务运行 PowerShell 命令

• 启动本地程序并检查 Windows/系统信息

• 捕获主屏幕或虚拟桌面

• 列出、聚焦、调整大小、最小化、最大化或关闭窗口

• 发送鼠标点击、滚动、快捷键和文本输入

• 读取或替换剪贴板文本

• 打开 URL、选择 Chrome 配置文件并控制标签页/导航

• 发起 HTTP 请求并下载文件，而不会继承隧道凭据

• 在 Windows 登录后自动重新连接

完整的 21 个工具契约位于 docs/TOOL_CONTRACT.md。

Related MCP server: ChatGPT Local Agent MCP

系统要求

• Windows 10 或 11，x64

• 一个可以启用开发者模式和私有应用/连接器的 ChatGPT 账户

• 可以访问 OpenAI Platform Secure MCP Tunnels

• 用于 Chrome 相关工具的 Google Chrome（其他工具不需要）

安装与配对

1. 从最新发布下载 Unlimited-Agent-Setup-v0.1.0.exe 和 SHA256SUMS.txt。

2. 可选：验证下载：

   Get-FileHash .\Unlimited-Agent-Setup-v0.1.0.exe -Algorithm SHA256

3. 运行安装程序并接受知情同意通知。Windows SmartScreen 可能会警告，因为社区构建未进行代码签名；在选择仍然运行之前，请验证 SHA-256。

4. 在设置窗口中，选择 Open Secure MCP Tunnels。在 OpenAI Platform 隧道设置中创建一个隧道，然后复制其 tunnel_... ID。

5. 在 OpenAI Platform API 密钥中，创建一个仅限于 Tunnels: Read + Use 的专用项目密钥。不要授予模型或其他 API 权限。将其粘贴到设置窗口中。

6. 选择权限。推荐的默认值为：

   • 权限模式：balanced

   • 本地审批：dangerous

   • 敏感读取审批：已启用

   • 允许的文件夹：您的 Windows 用户配置文件

7. 选择保存并连接。桥接器在后台启动，并在登录时注册为当前 Windows 用户。

8. 在 ChatGPT 中，打开设置 → 应用与连接器 → 高级设置，启用开发者模式，创建一个私有应用，然后选择您刚刚配对的隧道。将其命名为 Unlimited Agent。

打开桌面快捷方式 Unlimited Agent Status。CONNECTED and ready 表示隧道可以为私有 ChatGPT 应用提供服务。向 ChatGPT 提问：“Use Unlimited Agent to show my Windows system information.”

OpenAI 目前将 Secure MCP Tunnels 记录为私有开发者模式测试功能。它们不支持公共 ChatGPT 应用目录提交或共享公共隧道。因此，即使用户安装的是相同的安装程序，每个用户也必须创建自己的私有隧道和私有应用。请参阅官方 Secure MCP Tunnel 指南。

权限模式

在桌面上打开 Unlimited Agent Settings 以重新配对、更改隧道凭据或更改权限。更改设置无需重新安装。被拒绝的工具调用会向 ChatGPT 返回结构化的 PERMISSION_DENIED 结果。工具调用是串行化的，因此 Unlimited Agent 无法使用自己的鼠标/键盘工具点击待处理的审批窗口。

示例请求

• “Find all .docx files modified this week in Documents and summarize their names. Don’t change anything.”

• “Create a folder on my desktop named Trip, move the selected photos into it, and verify the count.”

• “Run the test suite in C:\work\my-app; keep polling until it finishes and fix the first failure.”

• “Take a screenshot, focus Chrome, open the project dashboard, and tell me what is visible.”

• “Start Notepad, type this meeting note, save it to Documents, then confirm the file exists.”

对于 GUI 任务，ChatGPT 应迭代执行 屏幕截图 → 输入 → 屏幕截图 的循环。Unlimited Agent 无法绕过密码、CAPTCHA、UAC 安全桌面或锁定的 Windows 会话。

架构

flowchart LR
  A[Private ChatGPT app] --> B[OpenAI Secure MCP Tunnel]
  B -->|outbound HTTPS session| C[tunnel-client]
  C -->|stdio MCP| D[Unlimited Agent server]
  D --> E[Central policy + local approval]
  E --> F[Files / PowerShell / HTTP]
  E --> G[Windows UI / Chrome / clipboard]

• server.mjs 注册 MCP 工具并包含其实现。

• policy.mjs 使用规范路径权限、重解析点/硬链接防护文件夹检查、完整的本地审批详情、覆盖规则和审计检查来包装每个工具注册。

• scripts/windows-ui.ps1 通过 Windows API 提供屏幕、窗口、输入和剪贴板原语。

• scripts/start-tunnel.ps1 仅解密运行时凭据足够长的时间以启动 tunnel-client。MCP 服务器在处理调用之前删除凭据环境变量，子进程接收经过清理的环境。

• scripts/watch-tunnel.ps1 提供单实例后台恢复。

• scripts/settings.ps1 负责配对和权限设置。凭据使用 DPAPI CurrentUser；非机密策略为 JSON。

• installer/ 生成一个自包含的 x64 Windows 安装可执行文件。

不创建入站监听器或防火墙例外。本地服务器仅使用 stdio；tunnel-client 提供 ChatGPT 选择的远程 MCP 端点。

本地开发

git clone https://github.com/yungsuk53-pixel/unlimited-agent.git
cd unlimited-agent
npm ci --ignore-scripts
npm test

npm test 达到验证级别 2：模式/注释检查、真实的 stdio MCP 会话、文件操作、PowerShell 凭据隔离、本地 HTTP、屏幕截图、窗口、输入管道、系统策略和后台任务。

构建和全新安装测试：

npm run build:installer
npm run test:install

构建会下载固定版本的 Node.js、tunnel-client 和 ripgrep x64 发布版本，并对照构建脚本中提交的不可变 SHA-256 值进行验证。CI 重复 MCP 测试、安装程序构建、DPAPI 往返、合成全新安装以及已安装运行时工具测试。测试凭据是合成的，绝不联系 OpenAI。

要测试真实隧道，请安装生成的 EXE，配对专用隧道凭据，检查 Unlimited Agent Status，然后在 ChatGPT 开发者模式下连接私有应用。

数据位置

已安装的文件和当前用户数据位于：

%LOCALAPPDATA%\UnlimitedAgent\
  config\config.json          non-secret policy and tunnel ID
  config\credential.dpapi     DPAPI-encrypted restricted runtime key
  data\audit.jsonl            tool decision audit (names, decisions, hashes)
  data\logs\                  tunnel and watchdog diagnostics

项目从不记录明文隧道凭据。日志会对匹配 OpenAI 密钥格式的字符串进行脱敏，工具启动的进程接收最小允许的普通 Windows 环境变量列表，而不是继承环境中的令牌或机密。

故障排除

状态显示正在重新连接或不可用

• 打开 Unlimited Agent Settings 并重新输入隧道 ID 和有效的受限运行时密钥。

• 确认密钥具有 Tunnels: Read + Use 权限，并且属于拥有该隧道的组织/工作区。

• 检查 %LOCALAPPDATA%\UnlimitedAgent\data\logs\bridge.log 和 watchdog.log。

• 404 通常表示 ChatGPT 选择了不同的隧道/应用、运行时已停止，或者私有应用不是从相同的 ChatGPT/OpenAI 组织上下文中创建的。

工具被拒绝

• 本地响应会说明原因：是只读模式、允许的文件夹边界、每工具覆盖规则，还是被拒绝的审批。

• 打开 Unlimited Agent Settings 更改策略。不要仅仅为了隐藏真正的安全边界而削弱权限。

鼠标或键盘操作无效

• Windows 必须已登录并解锁。

• UAC 安全桌面、登录屏幕、某些提升权限的应用、使用独占输入的游戏以及受保护的媒体无法从普通用户进程可靠地自动化。

Chrome 打开了错误的配置文件

• 让 ChatGPT 调用 open_url 或 browser_control 并指定 Chrome 配置文件目录名称，例如 Default 或 Profile 2。

卸载与撤销

运行桌面快捷方式 Uninstall Unlimited Agent。它会停止/移除本地运行时、删除自动启动条目、移除加密凭据并删除安装目录。

然后，在 OpenAI Platform 中撤销专用的受限密钥，如果隧道不再使用则将其删除。如果电脑或 Windows 账户可能已被入侵，撤销至关重要。

安全与许可证

在启用完全访问之前，请阅读 SECURITY.md。安全报告应使用 GitHub 私有漏洞报告功能，而不是公开问题。

Unlimited Agent 根据 MIT 许可证 提供。捆绑的运行时声明位于 THIRD_PARTY_NOTICES.md。