什么是us3-skill
UCloud US3 Storage Skill 是一个专为开发者设计的命令行工具，用于将本地文件上传至 UCloud US3 对象存储服务，并自动生成可直接访问的公开链接。该技能通过简单的参数配置和脚本调用，实现了文件云存储与快速分享的一体化流程，特别适合需要频繁处理图片、视频、文档等媒体资源的场景。用户只需提供本地文件路径，即可一键完成上传并获取可公开访问的 URL，极大提升了工作效率。
该工具基于 Node.js 环境运行，支持多种常见文件格式，包括图像（JPG、PNG、GIF）、视频（MP4、MOV）、文档（PDF、DOCX）以及音频和压缩包等类型。其自动识别文件扩展名并设置合适的 MIME 类型，确保文件在云端正确展示。此外，US3 Storage Skill 不依赖图形界面，完全通过命令行操作，便于集成到自动化工作流或脚本中，适用于 CI/CD、数据处理流水线等多种技术场景。
使用本工具前需具备 UCloud 账号及已创建的 US3 存储空间（Bucket），并通过环境变量配置密钥信息。系统支持自定义文件在云端的存储路径（即 object key），也允许仅返回 URL 而不输出完整响应内容，满足不同使用习惯。整体设计注重轻量化与易用性，帮助开发者和运维人员快速实现文件托管与分发需求。
核心功能特点
- 支持上传任意本地文件至 UCloud US3 对象存储
- 自动生成可直接访问的公开 URL，无需额外配置权限
- 支持自定义文件在云端的存储路径（object key）
- 可选输出模式：返回完整 JSON 或仅显示 URL 字符串
- 自动根据文件扩展名识别并设置正确的 MIME 类型
- 兼容主流格式：图片、视频、文档、音频、压缩包等
适用场景
US3 Storage Skill 特别适用于需要将临时文件或生成内容快速上传至云端并分享给他人查看的场景。例如，当用户在飞书中发送截图或图片时，可通过此工具自动下载后上传至 US3，并立即获得一个公开链接用于回复或嵌入其他平台。这种“下载—上传—分享”的模式在团队协作中极为高效，尤其适合客服、技术支持和内容运营等岗位。
另一个典型应用场景是图像处理与批量上传。开发者可在本地对图片进行裁剪、压缩或格式转换后，利用该技能将处理后的结果推送到云端，并按时间戳或分类命名保存，便于后续检索与管理。结合 ffmpeg、baidu-ocr 等工具使用时，可实现完整的媒体处理流水线，如先 OCR 识别文档内容，再将扫描件归档存储。此外，该技能也适合集成到自动化脚本中，实现定时备份日志、监控截图归档等功能，提升运维自动化水平。
对于需要频繁共享大文件但又不希望搭建自建服务器的个人或小团队而言，US3 Storage Skill 提供了一种低成本、高可用且易于维护的解决方案。无论是上传会议记录、项目演示视频，还是作为 API 接口返回静态资源链接，该工具都能以简洁的方式满足基本需求，同时保持部署灵活性和跨平台兼容性。