内容
# 网页 ChatGPT 遥控本机：Windows + macOS MCP 部署包
让网页版 ChatGPT 通过 **AgentDock + HTTPS 隧道 + OAuth**，实际读取本地文件、修改项目、执行命令；可选增加独立浏览器、Coding Agent，以及 macOS 桌面观察和鼠标键盘操作。
这是根据一次真实部署整理的独立部署工具包，灵感来自 [GPT-TaskBoard](https://github.com/mengchangfeng/GPT-TaskBoard)。它不是 OpenAI、AgentDock 或 GPT-TaskBoard 的官方发行版，也没有复制原教程仓库的源码或冒用其许可证。
支持范围：
- Windows 11 x64，PowerShell 5.1+：保留已验证的 AgentDock 0.8.0 基线和可选 Codex ACP 离线运行时。
- macOS 13+，Apple Silicon 或 Intel：使用 AgentDock 0.8.1 官方 Universal App；文档与依赖核对日期为 2026-08-30。
下载入口：[GitHub Releases](https://github.com/zararogers338-hash/chatgpt-local-mcp-kit/releases/latest)。Windows 选择 `-windows-x64-full.zip`，Mac 选择 `-macos-universal-full.zip`。`-source.zip` 和 Code → Download ZIP 不带大体积安装程序。
## 先看这四句话
1. 这会操作真实电脑。默认使用普通用户权限、回环监听、OAuth 和 HTTPS；“完整能力”不等于管理员/root 权限、取消确认或无限额度。
2. 密码、账号、浏览器登录状态和 macOS 隐私授权不能打包转送。每台电脑都要生成自己的凭据，并由本人完成 ChatGPT、Codex 和系统授权。
3. 网页 ChatGPT 在云端，不能直接连接 `127.0.0.1`。本包继续使用 Cloudflare 临时 HTTPS Tunnel；临时地址重建后可能变化。
4. macOS 的登录自启由官方 AgentDock.app 使用 `SMAppService` 管理。本包不会再叠加一套 LaunchAgent，避免重复服务互相打架。
## Windows 最快开始
完整包解压到普通目录，例如 `C:\MCP-Kit`，不要在 ZIP 内直接运行。
| 顺序 | 运行什么 | 作用 |
| --- | --- | --- |
| 1 | `01-Install.cmd` | 安装核心、控制面板和临时 HTTPS Tunnel；已有安装不覆盖 |
| 2 | `02-Enable-Full.cmd` | 可选：开启独立浏览器与 Codex ACP |
| 3 | `03-Check.cmd` | 检查本地、公网、认证并显示 MCP 地址 |
| 4 | 按 [网页连接教程](docs/CONNECT-CHATGPT.md) 操作 | 在 ChatGPT 添加应用并由本人完成 OAuth |
| 5 | `04-Test-MCP.cmd`，再运行 `07-New-SmokeTest.cmd` | 协议检查和真实合成目录读写验收 |
平时用 `05-Start.cmd` 启动，`06-Stop.cmd` 停止。面板挡路时最小化即可，不要把最小化当作停止后台服务。
## macOS 最快开始
完整包解压后，在 Finder 打开 `macos` 文件夹。第一次运行若被 macOS 阻止，右键该 `.command` → 打开；不要关闭 Gatekeeper。
当前官方 AgentDock 0.8.1 DMG 使用有效的 ad-hoc 代码签名，但不是 Developer ID 公证发行，因此 Gatekeeper 命令行评估会显示 `rejected`。本包把这一状态写入锁文件并在真实 Mac 上核对，不伪装成“已公证”；安装器不会移除 quarantine 或关闭 Gatekeeper。macOS 提示时由本人右键“打开”/“仍要打开”，不接受这一上游签名状态就不要继续安装。
| 顺序 | 运行什么 | 作用 |
| --- | --- | --- |
| 1 | `macos/01-Install.command` | 校验官方 Universal DMG，安装到当前用户的 `~/Applications`，打开设置向导 |
| 2 | 在 AgentDock 设置选择“临时公网地址” | 生成本机凭据，注册 Core/Tunnel 登录自启；密码只在本机面板查看 |
| 3 | `macos/03-Check.command` | 检查 Core、Tunnel、本地/公网 health 和匿名 MCP 401，并显示当前地址 |
| 4 | 按 [网页连接教程](docs/CONNECT-CHATGPT.md) 操作 | 新建 ChatGPT MCP 应用并由本人完成 OAuth |
| 5 | `macos/02-Enable-Full.command` | 打开浏览器/桌面能力清单；系统隐私权限仍由本人授予 |
| 6 | `macos/07-New-SmokeTest.command` | 生成隔离的真实读写验收目录与提示词 |
关机重启后，官方 App 的两个后台项会在当前用户登录后恢复。运行 `03-Check.command` 验证。Core 不健康时运行 `04-Recover-Core.command`；Tunnel 不健康时运行 `05-Repair-Tunnel.command`。修复器发现健康状态会直接退出，不会为了“试一下”而更换临时地址。
完整的 Mac 说明、权限和卸载步骤见 [macOS 手册](docs/MACOS.md)。
## 从 Git 仓库安装
Windows 源码克隆后先获取固定依赖：
```powershell
powershell -NoProfile -ExecutionPolicy RemoteSigned -File .\scripts\Get-Dependencies.ps1 -Profile Full
powershell -NoProfile -ExecutionPolicy RemoteSigned -File .\scripts\Prepare-Offline.ps1
```
macOS 源码克隆后可直接运行 `macos/01-Install.command`。没有随包 DMG 时，它只从锁定的 AgentDock v0.8.1 官方 Release 下载，并核对仓库固定的 SHA-256；不会执行 `curl | sh`，也不使用 `sudo`。
“完整安装包”表示安装材料可随包携带，不代表 ChatGPT、Cloudflare、OAuth 或模型可以离线使用。
## 能力与平台差异
| 能力 | Windows 基线 | macOS 基线 |
| --- | --- | --- |
| 文件、搜索、编辑、命令、Git、任务、Skill、动态 MCP | 是 | 是 |
| AgentDock 独立浏览器会话 | 可选 | 在 App 高级设置中开启 |
| Coding Agent / Codex ACP | 本包可安装锁定运行时 | App 可配置已安装的受支持 Agent；账号登录另做 |
| 全桌面鼠标键盘 | 本包未提供 | 官方 `desktop` Skill + 本人授予辅助功能/屏幕录制权限 |
| 登录后 Core/Tunnel 自启 | 当前用户 Windows 启动项 | AgentDock.app 的 `SMAppService` 后台项 |
AgentDock 0.8.1 已把旧的 `server_info` 合并为 `agentdock_context`。跨平台提示应优先调用 `agentdock_context`；锁定的 Windows 0.8.0 没有时再用 `server_info`。不要把固定工具数量当作验收标准，以实际 `tools/list` 为准。
浏览器使用 AgentDock 独立 Profile，不接管日常浏览器 Cookie。macOS 桌面截图可能包含通知、聊天和账号信息；只给完成任务所需权限，不自动上传截图。默认工作目录也不是操作系统沙箱，真实访问范围仍由当前用户权限决定。
## 给不会配置的朋友
把完整包交给能执行本地命令的 Agent，然后发送：
> 请完整阅读 `AGENT-DEPLOYMENT.md`、`AGENTS.md` 和当前系统对应的安装手册，再按仓库流程部署。先识别 Windows 或 macOS 并检查已有安装；不要把密码、令牌、Cookie、桌面截图或真实配置写进聊天或 Git。需要我登录、输入密码、授予 macOS 隐私权限或确认账户权限时停下来交给我。
接手说明见 [给部署 Agent 的信](AGENT-DEPLOYMENT.md)。
## 文档导航
- [Windows 安装、迁移和已有安装处理](docs/INSTALL.md)
- [macOS 安装、自启恢复、桌面权限和卸载](docs/MACOS.md)
- [连接网页 ChatGPT、第一次实际使用](docs/CONNECT-CHATGPT.md)
- [可选能力、Coding Agent 与边界](docs/FEATURES.md)
- [分层故障排查](docs/TROUBLESHOOTING.md)
- [安全边界、停用与回滚](docs/SECURITY.md)
- [真实 Windows 部署案例](docs/CASE-STUDY.md)
- [可复制的日常任务指令](prompts/DAILY-USE.md)
- [版本维护、测试、Git 与打包](docs/MAINTAINING.md)
- [依赖来源与许可证](THIRD-PARTY-NOTICES.md)
## 项目布局
```text
README.md / AGENT-DEPLOYMENT.md / AGENTS.md
macos/ Finder 可双击的 macOS 安装、检查与恢复入口
scripts/ Windows PowerShell 与 macOS zsh 实现、依赖获取和打包
config/ 分平台固定版本与 SHA-256；不含真实凭据
templates/ ACP 包描述、lockfile 与部署验收模板
docs/ 中文手册与案例记录
prompts/ 网页端可复制指令
tests/ Windows 与 macOS 的非破坏性测试
licenses/ 上游许可证与通知
vendor/ Git 忽略的官方安装依赖；完整 Release 包附带
```
## 许可与来源
本工具包原创脚本与文档采用 [MIT](LICENSE)。AgentDock、cloudflared、Codex、Node.js 和 npm 依赖保留各自许可证，详见 [第三方声明](THIRD-PARTY-NOTICES.md)。请保留上游归属，不把本工具包描述为上游官方产品。
MCP 市场