jiome/filebed/AI-TEST - Storage Bucket

file.webgo 文件服务器访问技能（可移植包）

访问本项目专用文件服务器 **https://file.webgo.eu.org**（Cloudflare Worker）的沙箱专用技能。 核心价值：把"目标站点 + 文件管理器 API + 沙箱 DNS 劫持绕过方案"打包成一个可复制安装的技能。

---

1. 包内容

file-webgo-filemanager/
├── SKILL.md          # 技能说明：目标站点、API 速查、沙箱出网绕过原理、约束
├── README.md         # 本文件：安装 / 用法 / 排障
├── install.sh        # 解压即装到任意沙箱的 skills 目录
└── scripts/
    └── filemgr.py     # 自包含 CLI，内置 TCP-DNS 取真 IP + 直连 443 绕过

2. 安装

# 解压
unzip file-webgo-skill.zip -d file-webgo-skill
cd file-webgo-skill/file-webgo-filemanager

# 装到默认技能目录（/root/.codebuddy/skills）
bash install.sh

# 或指定目标 skills 根目录
SKILLS_ROOT=/path/to/skills bash install.sh

安装后目录结构（file-webgo-filemanager 为固定技能名，避免跨环境 UUID 冲突）：

<SKILLS_ROOT>/file-webgo-filemanager/
├── SKILL.md
└── scripts/filemgr.py

装好后，若宿主 harness 支持技能热扫描，即可用 @skill file-webgo-filemanager 唤起； 否则直接执行脚本即可（见下）。

3. 快速使用

PY="<SKILLS_ROOT>/file-webgo-filemanager/scripts/filemgr.py"

python3 "$PY" list                 # 列根目录
python3 "$PY" list AI-TEST/        # 列子目录（带尾斜杠）
python3 "$PY" upload ./报告.pdf AI-TEST/reports/   # 上传（自动建目录）
python3 "$PY" mkdir AI-TEST/data   # 建空目录（占位 .keep 实现）
python3 "$PY" download AI-TEST/README.md ./x.md    # 下载
python3 "$PY" delete AI-TEST/temp/old.txt          # 删除

FILEMGR_URL="https://你的实例" python3 "$PY" list  # 覆盖为同类实例

4. 为什么需要这个技能（背景）

沙箱对所有域名的 UDP/53 DNS 做统一劫持，把解析结果重定向到 RFC 6598 黑洞段 198.18.0.0/15，于是普通 curl / requests 在沙箱内连不上任何外部站点 （表现为超时，或拿到 198.18.* 死 IP）。file.webgo.eu.org 同样中招。

本技能通过 sandbox-foreign-access 的思路解决：

1. 用 TCP/53 向公共 DNS（8.8.8.8 / 1.1.1.1 …）查询真实 IPv4 —— TCP/53 出网在沙箱内是开放的。
2. 直接连真实 IP 的 443，TLS 的 SNI/Host 仍填原始域名，证书校验照常通过。
3. 兜底：TCP-DNS 被封时，对 Cloudflare 站点退回写死的 anycast IP。

5. 排障

现象	可能原因	处理
无法解析…（DNS 被劫持且兜底失败）	TCP/53 也被封，且非 Cloudflare 站点	设置 FILEMGR_URL 为可达代理/隧道地址
连接超时 / all IPs unreachable	目标站点下线或网络变更	检查 FILEMGR_URL、确认站点存活
198.18.* 死 IP	用了普通 curl/requests 而非本脚本	一律走 filemgr.py
上传后目录没出现	dir 参数忘了带尾斜杠	传参用 AI-TEST/reports/（带 /）

6. 环境变量

变量	默认	说明
FILEMGR_URL	https://file.webgo.eu.org	站点根地址，可用于指向同类实例
SKILLS_ROOT	/root/.codebuddy/skills	仅 install.sh 使用，指定安装目标

---

本技能纯标准库实现（Python 3），无第三方依赖。