汇流本地文件 MCP（让 ChatGPT 网页读取你选定的一个文件夹）

使用顺序（完整图文教程见与黎 · 汇流站的「ChatGPT 控制本地文件」教程）：
1. 安装 Python 3.11 或更新版本，安装时勾选 Add python.exe to PATH。
2. 双击 start.bat，在弹出的窗口里选一个专用文件夹。窗口里会出现一串带口令的本机地址，这一串等于密码，不要发给任何人。
3. 另开窗口双击 start-tunnel.bat（需要先下载 cloudflared），得到 https://xxxx.trycloudflare.com 。
4. 在 ChatGPT 左侧点“插件”，右上角“添加 → 创建自定义 MCP 服务器”，服务器 URL 填：隧道地址 + /mcp/你的口令 ，身份验证选“无需身份验证”。
5. ChatGPT 提出的写入只是建议。要生效，双击 approve.bat，看差异，输入批准码。
6. 用完关闭 start.bat 和 start-tunnel.bat 两个窗口，ChatGPT 立刻读不到你的文件。

它能做的：列目录、读文本文件（最大 1 MiB）、按内容搜索、提出写入建议。
它不能做的：运行命令、删除文件、读取隐藏文件和密钥类文件（.env、.pem、.key 等）、写脚本和可执行文件（.py、.bat、.js 等）、读取共享文件夹以外的任何东西。
共享文件夹不能是整个磁盘、用户主目录、系统目录，也不能包含或位于本工具所在文件夹里。
写入建议、批准码和备份放在 ~/.huiliu-files/state/ 里，不在共享文件夹中。
被读取的内容会发给 OpenAI，并经过你选的隧道服务商。请只共享专用文件夹，不要放密码、证件、账号文件。

文件说明：
  huiliu_files_mcp.py  服务本体，只用 Python 标准库
  workspace.py         路径与写入安全检查
  approve.py           本机审阅并批准写入
  start.bat / approve.bat / start-tunnel.bat  启动脚本

版本 0.2.2
