完成任务16：编写 04_长期发展/环境保护.md

2026-05-23 16:51:48 +00:00
parent 33ea0114ea
commit c8cd92ba7c
734 changed files with 188060 additions and 604 deletions
--- a/active_skills/minio/SKILL.md
+++ b/active_skills/minio/SKILL.md
@@ -0,0 +1,270 @@
+---
+name: minio
+description: MinIO 对象存储操作技能。当用户提到 MinIO、S3 存储、对象存储、文件上传下载、公网地址、外链等关键词时必须使用此技能。
+vm0_secrets:
+  - MINIO_ACCESS_KEY
+  - MINIO_SECRET_KEY
+vm0_vars:
+  - MINIO_ENDPOINT
+  - MINIO_PUBLIC_URL
+---
+
+# MinIO 对象存储技能
+
+统一的 MinIO 对象存储操作技能，支持文件上传下载、桶管理、公网地址生成等功能。
+
+> 官方文档: `https://min.io/docs/minio/linux/reference/minio-mc.html`
+
+---
+
+## 触发条件
+
+**当用户提到以下关键词时必须使用此技能：**
+- MinIO、minio
+- S3 存储、对象存储
+- 文件上传、文件下载
+- 公网地址、外链、访问链接
+- 桶、bucket
+
+---
+
+## 环境配置
+
+| 变量名 | 说明 | 示例 |
+|--------|------|------|
+| `MINIO_ENDPOINT` | MinIO 服务地址 | `http://192.168.11.13:10061` |
+| `MINIO_ACCESS_KEY` | 访问密钥 | `iUTez6g5DYVg5vhXhMzc` |
+| `MINIO_SECRET_KEY` | 密钥 | `xx...` |
+| `MINIO_PUBLIC_URL` | 公网访问域名（可选） | `https://oss.example.com` |
+
+### 配置 mc 客户端
+
+首次使用需配置别名：
+
+```bash
+mc alias set myminio $MINIO_ENDPOINT $MINIO_ACCESS_KEY $MINIO_SECRET_KEY
+```
+
+---
+
+## 功能列表
+
+### 1. 桶管理
+
+```bash
+# 列出所有桶
+mc ls myminio/
+
+# 创建新桶
+mc mb myminio/new-bucket
+
+# 删除空桶
+mc rb myminio/empty-bucket
+
+# 删除非空桶（危险操作）
+mc rb --force myminio/bucket-to-delete
+```
+
+### 2. 文件上传
+
+```bash
+# 上传单个文件
+mc cp /path/to/local/file.txt myminio/bucket/path/to/remote/file.txt
+
+# 上传并指定按日期组织的路径
+mc cp myfile.tar.gz myminio/files/$(date +%Y/%m/%d)/myfile.tar.gz
+
+# 上传整个目录
+mc mirror ./local_dir myminio/bucket/remote_dir/
+
+# 上传目录并显示进度
+mc mirror --watch ./local_dir myminio/bucket/remote_dir/
+```
+
+### 3. 文件下载
+
+```bash
+# 下载单个文件
+mc cp myminio/bucket/path/to/file.txt ./local_file.txt
+
+# 下载整个目录
+mc mirror myminio/bucket/remote_dir/ ./local_dir/
+
+# 下载指定前缀的所有文件
+mc mirror myminio/bucket/prefix/ ./local_dir/
+```
+
+### 4. 文件管理
+
+```bash
+# 列出桶内文件
+mc ls myminio/bucket/
+mc ls myminio/bucket/path/
+
+# 递归列出
+mc ls --recursive myminio/bucket/
+
+# 查看文件详情
+mc stat myminio/bucket/path/to/file.txt
+
+# 删除文件
+mc rm myminio/bucket/path/to/file.txt
+
+# 批量删除
+mc rm --recursive --force myminio/bucket/path/
+
+# 复制文件（桶内或跨桶）
+mc cp myminio/source-bucket/file.txt myminio/dest-bucket/file.txt
+
+# 移动/重命名文件
+mc mv myminio/bucket/old-name.txt myminio/bucket/new-name.txt
+```
+
+### 5. 公网访问地址
+
+```bash
+# 列出所有桶内对象的公网地址
+# 使用端点地址作为公网地址
+mc ls --recursive myminio/bucket/ | while read -r line; do
+  file=$(echo "$line" | awk '{print $NF}')
+  echo "http://192.168.11.13:10061/bucket/$file"
+done
+
+# 生成临时分享链接（默认7天有效）
+mc share download myminio/bucket/path/to/file.txt
+
+# 生成指定有效期的分享链接
+mc share download --expire 24h myminio/bucket/path/to/file.txt
+```
+
+### 6. Python 脚本操作（适用于复杂场景）
+
+```python
+import boto3
+from botocore.client import Config
+import os
+
+# MinIO 配置
+endpoint = os.environ.get('MINIO_ENDPOINT', 'http://192.168.11.13:10061')
+access_key = os.environ.get('MINIO_ACCESS_KEY')
+secret_key = os.environ.get('MINIO_SECRET_KEY')
+
+# 创建 S3 客户端
+s3 = boto3.client(
+    's3',
+    endpoint_url=endpoint,
+    aws_access_key_id=access_key,
+    aws_secret_access_key=secret_key,
+    config=Config(signature_version='s3v4')
+)
+
+# 列出所有桶
+buckets = s3.list_buckets()
+for bucket in buckets['Buckets']:
+    print(bucket['Name'])
+
+# 上传文件
+s3.upload_file('local_file.txt', 'bucket-name', 'remote/path/file.txt')
+
+# 下载文件
+s3.download_file('bucket-name', 'remote/path/file.txt', 'local_file.txt')
+
+# 列出桶内对象
+objects = s3.list_objects_v2(Bucket='bucket-name', Prefix='path/')
+for obj in objects.get('Contents', []):
+    print(f"{obj['Key']} - {obj['Size']} bytes")
+
+# 生成预签名URL（临时访问链接）
+url = s3.generate_presigned_url(
+    'get_object',
+    Params={'Bucket': 'bucket-name', 'Key': 'path/to/file.txt'},
+    ExpiresIn=3600  # 1小时有效
+)
+print(url)
+```
+
+---
+
+## 常用场景示例
+
+### 场景1：上传文件并返回公网地址
+
+```bash
+# 上传文件到按日期组织的路径
+DATE_PATH=$(date +%Y/%m/%d)
+FILENAME="myfile.tar.gz"
+mc cp $FILENAME myminio/files/$DATE_PATH/$FILENAME
+
+# 返回公网地址
+echo "公网地址: http://192.168.11.13:10061/files/$DATE_PATH/$FILENAME"
+```
+
+### 场景2：列出所有公网地址
+
+```bash
+# 快速列出桶内所有文件的公网地址
+python3 << 'EOF'
+import boto3
+from botocore.client import Config
+import os
+from urllib.parse import quote
+
+endpoint = os.environ.get('MINIO_ENDPOINT')
+access_key = os.environ.get('MINIO_ACCESS_KEY')
+secret_key = os.environ.get('MINIO_SECRET_KEY')
+
+s3 = boto3.client(
+    's3',
+    endpoint_url=endpoint,
+    aws_access_key_id=access_key,
+    aws_secret_access_key=secret_key,
+    config=Config(signature_version='s3v4')
+)
+
+# 列出所有桶
+for bucket in s3.list_buckets()['Buckets']:
+    bucket_name = bucket['Name']
+    print(f"\n=== 桶: {bucket_name} ===")
+    
+    # 列出桶内所有对象
+    paginator = s3.get_paginator('list_objects_v2')
+    for page in paginator.paginate(Bucket=bucket_name):
+        for obj in page.get('Contents', []):
+            key = obj['Key']
+            # URL 编码文件路径
+            encoded_key = quote(key, safe='/')
+            print(f"{endpoint}/{bucket_name}/{encoded_key}")
+EOF
+```
+
+### 场景3：打包目录并上传
+
+```bash
+# 打包目录
+tar -czf output.tar.gz ./my_directory/
+
+# 上传
+mc cp output.tar.gz myminio/files/$(date +%Y/%m/%d)/output.tar.gz
+
+# 清理本地文件
+rm output.tar.gz
+```
+
+---
+
+## 工具脚本
+
+列出所有公网地址的脚本：
+
+```bash
+/app/working/workspaces/default/active_skills/minio/scripts/list_public_urls.py
+```
+
+---
+
+## 注意事项
+
+1. **不要上传到根目录**：始终将文件上传到有意义的路径，如按日期组织 `files/YYYY/MM/DD/`
+2. **大文件上传**：对于大文件，使用 `mc` 命令行工具比 Python 脚本更稳定
+3. **临时链接**：分享敏感文件时，使用 `mc share download` 生成临时链接而非公网地址
+4. **权限控制**：确保 bucket 策略配置正确，公开访问的 bucket 才能通过公网地址直接访问
--- a/active_skills/minio/scripts/list_public_urls.py
+++ b/active_skills/minio/scripts/list_public_urls.py
@@ -0,0 +1,137 @@
+#!/usr/bin/env python3
+"""
+列出 MinIO 存储桶中所有对象的公网访问地址
+
+环境变量:
+    MINIO_ENDPOINT: MinIO 服务地址 (例如: http://192.168.1.1:9000)
+    MINIO_ACCESS_KEY: 访问密钥
+    MINIO_SECRET_KEY: 密钥
+    MINIO_PUBLIC_URL: 公网访问域名 (可选，默认使用 MINIO_ENDPOINT)
+
+用法:
+    python3 list_public_urls.py [bucket_name] [--prefix path/]
+"""
+
+import os
+import sys
+from urllib.parse import quote
+
+def main():
+    # 获取环境变量
+    endpoint = os.environ.get('MINIO_ENDPOINT', '')
+    access_key = os.environ.get('MINIO_ACCESS_KEY', '')
+    secret_key = os.environ.get('MINIO_SECRET_KEY', '')
+    public_url = os.environ.get('MINIO_PUBLIC_URL', endpoint).rstrip('/')
+
+    # 检查环境变量
+    if not all([endpoint, access_key, secret_key]):
+        print("错误: 请确保以下环境变量已配置:")
+        print("  - MINIO_ENDPOINT")
+        print("  - MINIO_ACCESS_KEY")
+        print("  - MINIO_SECRET_KEY")
+        sys.exit(1)
+
+    # 解析命令行参数
+    bucket_filter = None
+    prefix_filter = ''
+    
+    args = sys.argv[1:]
+    i = 0
+    while i < len(args):
+        if args[i] == '--prefix' and i + 1 < len(args):
+            prefix_filter = args[i + 1]
+            i += 2
+        elif not args[i].startswith('--'):
+            bucket_filter = args[i]
+            i += 1
+        else:
+            i += 1
+
+    try:
+        import boto3
+        from botocore.client import Config
+    except ImportError:
+        print("正在安装 boto3...")
+        os.system("pip3 install boto3 -q")
+        import boto3
+        from botocore.client import Config
+
+    # 创建客户端
+    s3 = boto3.client(
+        's3',
+        endpoint_url=endpoint,
+        aws_access_key_id=access_key,
+        aws_secret_access_key=secret_key,
+        config=Config(signature_version='s3v4')
+    )
+
+    print(f"公网访问前缀: {public_url}")
+    print(f"MinIO 端点: {endpoint}")
+    print()
+
+    total_objects = 0
+    total_size = 0
+
+    # 获取桶列表
+    buckets = s3.list_buckets()['Buckets']
+    
+    for bucket in buckets:
+        bucket_name = bucket['Name']
+        
+        # 过滤桶
+        if bucket_filter and bucket_name != bucket_filter:
+            continue
+        
+        bucket_objects = 0
+        bucket_size = 0
+        
+        print(f"=== 桶: {bucket_name} ===")
+        
+        # 分页列出对象
+        paginator = s3.get_paginator('list_objects_v2')
+        pages = paginator.paginate(Bucket=bucket_name, Prefix=prefix_filter)
+        
+        for page in pages:
+            if 'Contents' not in page:
+                continue
+            
+            for obj in page['Contents']:
+                key = obj['Key']
+                size = obj['Size']
+                bucket_objects += 1
+                bucket_size += size
+                
+                # URL 编码
+                encoded_key = quote(key, safe='/')
+                public_address = f"{public_url}/{bucket_name}/{encoded_key}"
+                
+                # 格式化大小
+                if size < 1024:
+                    size_str = f"{size} B"
+                elif size < 1024 * 1024:
+                    size_str = f"{size / 1024:.1f} KB"
+                elif size < 1024 * 1024 * 1024:
+                    size_str = f"{size / 1024 / 1024:.1f} MB"
+                else:
+                    size_str = f"{size / 1024 / 1024 / 1024:.1f} GB"
+                
+                print(f"  [{size_str}] {key}")
+                print(f"    -> {public_address}")
+        
+        if bucket_objects > 0:
+            print(f"\n  小计: {bucket_objects} 个对象\n")
+        
+        total_objects += bucket_objects
+        total_size += bucket_size
+
+    # 总计
+    print("=" * 50)
+    if total_size < 1024 * 1024 * 1024:
+        total_size_str = f"{total_size / 1024 / 1024:.2f} MB"
+    else:
+        total_size_str = f"{total_size / 1024 / 1024 / 1024:.2f} GB"
+    
+    print(f"总计: {total_objects} 个对象, {total_size_str}")
+
+if __name__ == '__main__':
+    main()