用途：gemini-files 通过脚本调用 Google Gemini File API，上传并管理供 Gemini 模型使用的文件，支持图片、音频、视频、PDF 及文本等类型。
主要能力：提供上传脚本 scripts/upload.js，可上传文件、设置显示名称、等待处理完成；支持查看文件状态（PROCESSING、ACTIVE、FAILED）；上传后的文件可被 gemini-text、gemini-image、gemini-batch、gemini-embeddings 等其他技能引用，用于多模态分析、文档处理、批量任务和嵌入生成。
使用方式：基础上传命令为 node scripts/upload.js image.jpg；指定名称使用 node scripts/upload.js document.pdf --name "Quarterly Report Q4 2026"；等待处理完成使用 node scripts/upload.js video.mp4 --wait。上传后可用 node skills/gemini-text/scripts/generate.js "Describe this image" --image photo.png 进行调用。批量上传可用 for file in *.jpg; do node scripts/upload.js "$file"; done。若缺少依赖，需执行 npm install @google/genai@latest dotenv@latest。
适用场景：图片多模态分析、视频内容处理、PDF 文档分析、音频转写或处理、批量操作前的文件预上传、文件状态检查与列表管理。
限制：文件大小受类型限制，图片 20MB、音频 25MB、视频 2GB、文档 50MB；视频等大文件处理可能耗时数分钟到数小时；文件状态需为 ACTIVE 才可使用；文件可能在一段时间后过期。API 密钥与文档链接见 https://aistudio.google.com/apikey 和 https://ai.google.dev/gemini-api/docs/file-upload。