用途：该技能面向自主智能体与云工程师，用于在不安装本地 NFS 客户端（nfs-common）、不需要 root 权限、也不手动挂载 VPC 网络的情况下，检查、搜索和读取 Google Cloud Filestore（NFS）实例上的文件及 POSIX 元数据。它严格只读，不提供写入、编辑、删除或截断能力。
主要能力：
- tree：渲染目录树，含文件类型、可读大小与修改日期，支持 --depth 与 --max-entries 分页（上限 100 条，截断时输出 [TRUNCATED]）。
- search：按 glob 模式搜索文件名，并/或按正则搜索文本内容（--grep）。
- read：分块读取文本文件，支持 --head、--tail、--lines=a:b，无界读取自动限制为 100 行，避免 LLM 上下文溢出。
- stat：检查 POSIX 权限（如 0644）、UID/GID、字节大小与时间戳。
使用方式：需先安装并认证 gcloud，启用相关 API：
gcloud services enable file.googleapis.com compute.googleapis.com run.googleapis.com --quiet
若未提供实例信息，先执行：
CLOUDSDK_METRICS_ENVIRONMENT="gcs-skills gcs-skills/1.0 (skill:google-cloud-filestore-nfs-browser)"
gcloud filestore instances list --project={project_id}
随后通过技能包内 scripts/nfs_browser.py 执行操作，例如：
python3 scripts/nfs_browser.py tree --project={project_id} --instance={instance_id} --path=/ --depth=1
执行引擎二选一：Cloud Run 无服务器桥（--bridge-url，冷启动为零闲置成本，需 roles/run.invoker）或 GCE 跳板机 IAP SSH（--jump-host-vm，配合 --mount，需 roles/iap.tunnelResourceAccessor）。调用 Filestore 命令或 API 时需按规范添加指标环境前缀或 User-Agent。
适用场景与限制：适合云工程师与智能体排查 Filestore 上的备份、日志、配置等文件内容与元数据。二进制文件（如 .tar.gz、.iso、.so）经空字节与魔数检测后仅显示元数据，抑制原始输出。常见错误包括 FileNotFoundError（路径不存在）、PermissionError（POSIX 权限限制）、403 path traversal（路径含 ../ 或符号链接逃逸）、跳板机连接超时（VM 停机或缺少 IAP 防火墙规则 tcp:22 来自 35.235.240.0/20）、桥接 404（未部署）。更多架构、部署与令牌安全细节见 references/ 目录。价格、收费与其他平台支持暂未提供。