chat2local

通过一个 ChatGPT MCP 连接，读写多台电脑上明确共享的文件夹，并在单独授权后执行本机命令。

版本：0.1.0-alpha.24 · Alpha 预览 · MIT License

1. 功能与边界

终端不是操作系统沙箱。 命令以桌面用户权限运行，可以访问共享目录之外的文件、使用网络和删除文件；文件工具的备份与路径限制不适用于命令副作用。仅向可信客户端开放。网关可以接触转发内容，不提供针对网关运营者的端到端加密。权限说明 · 安全边界

Related MCP server: chatgpt-local-coding-agent

2. 选择入口

3. 首次创建实例

前提

需要自己的 Cloudflare 账号，以及能够添加相应自定义 MCP 应用的 ChatGPT 账号/工作区。平台可用性、写入能力和工具刷新方式以账号实际入口及 OpenAI 官方说明 为准；安装本项目不会解锁平台未开放的权限。

Windows 10+：普通 PowerShell

& ([scriptblock]::Create((Invoke-RestMethod 'https://raw.githubusercontent.com/jianmosier/chat2local/main/install.ps1')))

macOS：普通终端，不使用 sudo

curl -fsSL --proto '=https' --proto-redir '=https' \
  https://raw.githubusercontent.com/jianmosier/chat2local/main/install.sh | sh

入口下载固定版本源码和官方 Node 运行环境，校验 SHA-256 后执行配置。首次自托管依次完成：Cloudflare 登录、资源创建确认、本机安装、ChatGPT MCP 配置、本机目录授权、实例安装密码设置。云服务条款和可能产生的费用由实例所有者决定。详细步骤见首次安装。

当前尚未完成全新第三方 Cloudflare 账号的完整端到端验收。 失败后保留已有配置与错误信息，不删除身份数据、不重复创建云资源。

4. 新增电脑

使用原实例地址，不创建另一套网关。以下 YOUR-INSTANCE 必须替换为自己的实例域名，不能直接照抄。

Windows：

& ([scriptblock]::Create((Invoke-RestMethod 'https://raw.githubusercontent.com/jianmosier/chat2local/main/install.ps1'))) -Instance 'https://YOUR-INSTANCE.workers.dev'

macOS：

curl -fsSL --proto '=https' --proto-redir '=https' \
  https://raw.githubusercontent.com/jianmosier/chat2local/main/install.sh \
  | sh -s -- --instance 'https://YOUR-INSTANCE.workers.dev'

在新电脑的浏览器输入实例安装密码，选择本机目录并确认。原有电脑不必在线；不复制设备密钥，不传邀请 JSON，不重复创建 ChatGPT 插件。日常管理不再要求安装密码。

5. 日常打开与回连

Windows：按 Win+R，输入：

%LOCALAPPDATA%\Chat2Local\Chat2Local.cmd

macOS：

open "$HOME/Applications/Chat2Local.command"

关闭管理网页不停止后台程序。网络恢复后客户端使用原身份自动重连。主动退出程序后需重新打开入口。管理页“更新与启动”中的“登录后自动连接”控制系统登录后的启动，不是开机登录前的系统服务。

断连、OAuth 失效、身份丢失是不同问题。按回连故障表处理，不把重新安装或重新配对作为默认修复。

6. 验证是否可用

按顺序核对：

1. list_devices：目标电脑在线，多设备时明确 deviceId。

2. list_roots：目标目录存在，文件权限符合预期。

3. 文件读写：先检查当前会话实际提供的工具，使用专用测试文件和返回的哈希验证。

4. 终端：工具列表包含三个终端工具，且 terminalLocalEnabled、terminalScopeGranted、terminalAllowed 均为 true；再执行无副作用命令并查询退出码。

服务器声明、ChatGPT 保存的工具列表、当前会话工具和本次 OAuth 权限分别核对。不能用其他插件执行成功，替代 Chat2Local 实际调用验收。

7. 文档

8. 开发

npm ci --ignore-scripts
npm run verify
npm run build:public
npm run release

release 默认只准备；显式 --publish --repo OWNER/chat2local 才写入 GitHub。发布会检查完整测试、脱敏源码清单、三种客户端安装包及远端下载一致性。不会自动部署云端或更新本机客户端。

Windows x64、macOS ARM64、macOS x64 有版本化发布包；源码包含 GNU/Linux 适配，但该平台未达到同等实机验收范围。macOS 签名/公证、真实整机重启、全新第三方账号首装及独立安全审计仍是验收项，不以模拟测试替代。