阿里云 OSS 文件上传

这个技能提供阿里云 OSS（对象存储服务）的文件上传功能，支持生成带签名的临时访问链接。

快速开始

1. 配置环境变量

使用前必须配置以下环境变量（详见 references/config.md）：

bash
export ALIYUNOSSACCESSKEYID=your-access-key-id
export ALIYUNOSSACCESSKEYSECRET=your-access-key-secret
export ALIYUNOSSENDPOINT=https://oss-cn-hangzhou.aliyuncs.com
export ALIYUNOSSBUCKET=your-bucket-name

2. 安装依赖

bash
pip install oss2

使用方法

上传文件

bash
python scripts/oss-upload.py upload --file /path/to/local/file.txt

可选参数：

• - --key：指定 OSS 中的文件名（默认使用本地文件名）
• --expire：链接有效期（秒，默认 3600）

示例：
bash

上传到指定路径

生成临时访问链接

bash
python scripts/oss-upload.py url --key images/photo.jpg --expire 3600

工作流程

1. 1. 用户请求上传文件时：

1. 2. 用户已有 OSS 文件需要访问链接时：

注意事项

• - 临时链接有效期默认 1 小时，可根据需求调整
• Bucket 建议设置为私有，通过签名链接安全访问
• 上传大文件时脚本会自动处理，无需额外配置