tamar-file-hub-client 0.1.1__tar.gz → 0.1.2__tar.gz

{tamar_file_hub_client-0.1.1 → tamar_file_hub_client-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tamar-file-hub-client
-Version: 0.1.1
+Version: 0.1.2
 Summary: A Python SDK for gRPC-based file management system
 Home-page: https://github.com/Tamar-Edge-AI/file-hub-client
 Author: Oscar Ou
@@ -682,6 +682,137 @@ async with AsyncTamarFileHubClient() as client:
     print(f"文件已保存到: {save_path}")
 ```
 
+#### 高级下载功能
+
+File Hub Client 提供了高级的下载URL管理功能，支持批量操作和直接获取GCS URL：
+
+##### 批量生成下载URL
+
+当需要为多个文件生成下载URL时，使用批量接口可以显著提高效率：
+
+```python
+from file_hub_client import AsyncTamarFileHubClient
+
+async with AsyncTamarFileHubClient() as client:
+    # 设置用户上下文
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 批量生成下载URL
+    file_ids = ["file-001", "file-002", "file-003"]
+    
+    result = await client.blobs.batch_generate_download_url(
+        file_ids=file_ids,
+        is_cdn=True,           # 使用CDN加速（可选，默认为True）
+        expire_seconds=3600    # URL有效期1小时（可选）
+    )
+    
+    # 处理结果
+    for url_info in result.download_urls:
+        if url_info.error:
+            print(f"文件 {url_info.file_id} 生成URL失败: {url_info.error}")
+        else:
+            print(f"文件 {url_info.file_id} 的下载URL: {url_info.url}")
+```
+
+同步客户端示例：
+
+```python
+from file_hub_client import TamarFileHubClient
+
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    result = client.blobs.batch_generate_download_url(
+        file_ids=["file-001", "file-002"],
+        is_cdn=False  # 不使用CDN，直接返回源站URL
+    )
+```
+
+##### 获取GCS URL
+
+对于需要直接访问Google Cloud Storage的场景，可以获取文件的GCS URL和MIME类型信息：
+
+```python
+# 异步客户端 - 获取单个文件的GCS URL
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    gcs_response = await client.blobs.get_gcs_url(file_id="file-001")
+    print(f"GCS URL: {gcs_response.gcs_url}")
+    print(f"MIME类型: {gcs_response.mime_type}")
+    # 输出示例：
+    # GCS URL: gs://bucket-name/path/to/file.pdf
+    # MIME类型: application/pdf
+```
+
+**注意**：`get_gcs_url` 方法现在返回一个 `GetGcsUrlResponse` 对象，包含：
+- `gcs_url`: Google Cloud Storage 的完整路径
+- `mime_type`: 文件的MIME类型，便于正确处理文件内容
+
+##### 批量获取GCS URL
+
+批量获取多个文件的GCS URL和MIME类型信息：
+
+```python
+# 异步客户端 - 批量获取GCS URL
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    file_ids = ["file-001", "file-002", "file-003"]
+    result = await client.blobs.batch_get_gcs_url(file_ids)
+    
+    # 处理结果
+    for url_info in result.gcs_urls:
+        if url_info.error:
+            print(f"文件 {url_info.file_id} 获取GCS URL失败: {url_info.error}")
+        else:
+            print(f"文件 {url_info.file_id}:")
+            print(f"  GCS URL: {url_info.gcs_url}")
+            print(f"  MIME类型: {url_info.mime_type}")
+            # 根据MIME类型处理文件
+            if url_info.mime_type.startswith('image/'):
+                print(f"  这是一个图片文件")
+            elif url_info.mime_type == 'application/pdf':
+                print(f"  这是一个PDF文件")
+```
+
+同步客户端示例：
+
+```python
+# 同步客户端 - 批量获取GCS URL
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 获取单个GCS URL
+    gcs_response = client.blobs.get_gcs_url(file_id="file-001")
+    print(f"GCS URL: {gcs_response.gcs_url}")
+    print(f"MIME类型: {gcs_response.mime_type}")
+    
+    # 批量获取GCS URL
+    result = client.blobs.batch_get_gcs_url(["file-001", "file-002"])
+```
+
+##### 使用场景说明
+
+1. **批量下载URL生成**：
+   - 适用于需要同时下载多个文件的场景
+   - 支持CDN加速，提供更好的下载体验
+   - 可设置URL有效期，增强安全性
+   - 批量操作减少网络往返，提高效率
+
+2. **GCS URL获取**：
+   - 适用于需要与Google Cloud服务集成的场景
+   - 可用于数据分析、批处理等后端处理
+   - 支持使用GCS工具进行文件操作
+   - 返回的是永久有效的存储路径
+   - 同时返回MIME类型信息，便于正确处理不同类型的文件
+   - 可根据MIME类型选择合适的处理方式（如图片处理、文档解析等）
+
+3. **错误处理**：
+   - 每个文件独立处理，部分失败不影响其他文件
+   - 错误信息通过 `error` 字段返回
+   - 建议在批量操作时做好错误处理和重试逻辑
+
 ### 文件管理操作
 
 File Hub Client 提供了完整的文件管理功能，通过 `files` 服务访问：
@@ -2019,6 +2150,12 @@ MIT License
 
 ## 更新日志
 
+### v0.0.5 (2025-01)
+- 新增批量下载URL生成接口 (batch_generate_download_url)
+- 新增GCS URL获取接口 (get_gcs_url, batch_get_gcs_url)
+- GCS URL接口返回MIME类型信息，便于文件类型识别
+- 更新相关文档和测试用例
+
 ### v0.0.4 (2025-01)
 - 新增从URL上传文件功能
 - 支持自动下载URL内容并上传到GCS

{tamar_file_hub_client-0.1.1 → tamar_file_hub_client-0.1.2}/README.md

@@ -636,6 +636,137 @@ async with AsyncTamarFileHubClient() as client:
     print(f"文件已保存到: {save_path}")
 ```
 
+#### 高级下载功能
+
+File Hub Client 提供了高级的下载URL管理功能，支持批量操作和直接获取GCS URL：
+
+##### 批量生成下载URL
+
+当需要为多个文件生成下载URL时，使用批量接口可以显著提高效率：
+
+```python
+from file_hub_client import AsyncTamarFileHubClient
+
+async with AsyncTamarFileHubClient() as client:
+    # 设置用户上下文
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 批量生成下载URL
+    file_ids = ["file-001", "file-002", "file-003"]
+    
+    result = await client.blobs.batch_generate_download_url(
+        file_ids=file_ids,
+        is_cdn=True,           # 使用CDN加速（可选，默认为True）
+        expire_seconds=3600    # URL有效期1小时（可选）
+    )
+    
+    # 处理结果
+    for url_info in result.download_urls:
+        if url_info.error:
+            print(f"文件 {url_info.file_id} 生成URL失败: {url_info.error}")
+        else:
+            print(f"文件 {url_info.file_id} 的下载URL: {url_info.url}")
+```
+
+同步客户端示例：
+
+```python
+from file_hub_client import TamarFileHubClient
+
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    result = client.blobs.batch_generate_download_url(
+        file_ids=["file-001", "file-002"],
+        is_cdn=False  # 不使用CDN，直接返回源站URL
+    )
+```
+
+##### 获取GCS URL
+
+对于需要直接访问Google Cloud Storage的场景，可以获取文件的GCS URL和MIME类型信息：
+
+```python
+# 异步客户端 - 获取单个文件的GCS URL
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    gcs_response = await client.blobs.get_gcs_url(file_id="file-001")
+    print(f"GCS URL: {gcs_response.gcs_url}")
+    print(f"MIME类型: {gcs_response.mime_type}")
+    # 输出示例：
+    # GCS URL: gs://bucket-name/path/to/file.pdf
+    # MIME类型: application/pdf
+```
+
+**注意**：`get_gcs_url` 方法现在返回一个 `GetGcsUrlResponse` 对象，包含：
+- `gcs_url`: Google Cloud Storage 的完整路径
+- `mime_type`: 文件的MIME类型，便于正确处理文件内容
+
+##### 批量获取GCS URL
+
+批量获取多个文件的GCS URL和MIME类型信息：
+
+```python
+# 异步客户端 - 批量获取GCS URL
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    file_ids = ["file-001", "file-002", "file-003"]
+    result = await client.blobs.batch_get_gcs_url(file_ids)
+    
+    # 处理结果
+    for url_info in result.gcs_urls:
+        if url_info.error:
+            print(f"文件 {url_info.file_id} 获取GCS URL失败: {url_info.error}")
+        else:
+            print(f"文件 {url_info.file_id}:")
+            print(f"  GCS URL: {url_info.gcs_url}")
+            print(f"  MIME类型: {url_info.mime_type}")
+            # 根据MIME类型处理文件
+            if url_info.mime_type.startswith('image/'):
+                print(f"  这是一个图片文件")
+            elif url_info.mime_type == 'application/pdf':
+                print(f"  这是一个PDF文件")
+```
+
+同步客户端示例：
+
+```python
+# 同步客户端 - 批量获取GCS URL
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 获取单个GCS URL
+    gcs_response = client.blobs.get_gcs_url(file_id="file-001")
+    print(f"GCS URL: {gcs_response.gcs_url}")
+    print(f"MIME类型: {gcs_response.mime_type}")
+    
+    # 批量获取GCS URL
+    result = client.blobs.batch_get_gcs_url(["file-001", "file-002"])
+```
+
+##### 使用场景说明
+
+1. **批量下载URL生成**：
+   - 适用于需要同时下载多个文件的场景
+   - 支持CDN加速，提供更好的下载体验
+   - 可设置URL有效期，增强安全性
+   - 批量操作减少网络往返，提高效率
+
+2. **GCS URL获取**：
+   - 适用于需要与Google Cloud服务集成的场景
+   - 可用于数据分析、批处理等后端处理
+   - 支持使用GCS工具进行文件操作
+   - 返回的是永久有效的存储路径
+   - 同时返回MIME类型信息，便于正确处理不同类型的文件
+   - 可根据MIME类型选择合适的处理方式（如图片处理、文档解析等）
+
+3. **错误处理**：
+   - 每个文件独立处理，部分失败不影响其他文件
+   - 错误信息通过 `error` 字段返回
+   - 建议在批量操作时做好错误处理和重试逻辑
+
 ### 文件管理操作
 
 File Hub Client 提供了完整的文件管理功能，通过 `files` 服务访问：
@@ -1973,6 +2104,12 @@ MIT License
 
 ## 更新日志
 
+### v0.0.5 (2025-01)
+- 新增批量下载URL生成接口 (batch_generate_download_url)
+- 新增GCS URL获取接口 (get_gcs_url, batch_get_gcs_url)
+- GCS URL接口返回MIME类型信息，便于文件类型识别
+- 更新相关文档和测试用例
+
 ### v0.0.4 (2025-01)
 - 新增从URL上传文件功能
 - 支持自动下载URL内容并上传到GCS

{tamar_file_hub_client-0.1.1 → tamar_file_hub_client-0.1.2}/file_hub_client/rpc/gen/file_service_pb2.py

@@ -26,7 +26,7 @@ from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__
 from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x12\x66ile_service.proto\x12\x04\x66ile\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/protobuf/struct.proto\"\xab\x01\n\x04\x46ile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x11\n\tfile_name\x18\x03 \x01(\t\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12.\n\ncreated_at\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb7\x02\n\nUploadFile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x0f\n\x07\x66ile_id\x18\x03 \x01(\t\x12\x14\n\x0cstorage_type\x18\x04 \x01(\t\x12\x13\n\x0bstored_name\x18\x05 \x01(\t\x12\x13\n\x0bstored_path\x18\x06 \x01(\t\x12\x11\n\tfile_name\x18\x07 \x01(\t\x12\x11\n\tfile_size\x18\x08 \x01(\x03\x12\x10\n\x08\x66ile_ext\x18\t \x01(\t\x12\x11\n\tmime_type\x18\n \x01(\t\x12\x0e\n\x06status\x18\x0b \x01(\t\x12.\n\ncreated_at\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\r \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xdf\x01\n\x11UploadFileRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\x0c\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12\x11\n\tmime_type\x18\x05 \x01(\t\x12\x19\n\x0cis_temporary\x18\x06 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x07 \x01(\x05H\x02\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_seconds\"\xf3\x01\n\x10UploadUrlRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x11\n\tfile_type\x18\x03 \x01(\t\x12\x11\n\tmime_type\x18\x04 \x01(\t\x12\x11\n\tfile_size\x18\x05 \x01(\x03\x12\x11\n\tfile_hash\x18\x06 \x01(\t\x12\x19\n\x0cis_temporary\x18\x07 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x08 \x01(\x05H\x02\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_seconds\")\n\x16UploadCompletedRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"u\n\x12\x44ownloadUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x13\n\x06is_cdn\x18\x03 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x02 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"\xd4\x01\n\x10ShareLinkRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x11\n\tis_public\x18\x02 \x01(\x08\x12\x14\n\x0c\x61\x63\x63\x65ss_scope\x18\x03 \x01(\t\x12\x1b\n\x0e\x65xpire_seconds\x18\x04 \x01(\x05H\x00\x88\x01\x01\x12\x17\n\nmax_access\x18\x05 \x01(\x05H\x01\x88\x01\x01\x12\x1b\n\x0eshare_password\x18\x06 \x01(\tH\x02\x88\x01\x01\x42\x11\n\x0f_expire_secondsB\r\n\x0b_max_accessB\x11\n\x0f_share_password\"\x82\x01\n\x10\x46ileVisitRequest\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\x12\x13\n\x0b\x61\x63\x63\x65ss_type\x18\x02 \x01(\t\x12\x17\n\x0f\x61\x63\x63\x65ss_duration\x18\x03 \x01(\x05\x12)\n\x08metadata\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\"!\n\x0eGetFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"6\n\x11RenameFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x10\n\x08new_name\x18\x02 \x01(\t\"$\n\x11\x44\x65leteFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"\x8d\x02\n\x10ListFilesRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x16\n\tfile_name\x18\x02 \x01(\tH\x01\x88\x01\x01\x12\x11\n\tfile_type\x18\x03 \x03(\t\x12\x1c\n\x0f\x63reated_by_role\x18\x04 \x01(\tH\x02\x88\x01\x01\x12\x17\n\ncreated_by\x18\x05 \x01(\tH\x03\x88\x01\x01\x12\x16\n\tpage_size\x18\x06 \x01(\x05H\x04\x88\x01\x01\x12\x11\n\x04page\x18\x07 \x01(\x05H\x05\x88\x01\x01\x42\x0c\n\n_folder_idB\x0c\n\n_file_nameB\x12\n\x10_created_by_roleB\r\n\x0b_created_byB\x0c\n\n_page_sizeB\x07\n\x05_page\"{\n\x17\x42\x61tchDownloadUrlRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\x12\x13\n\x06is_cdn\x18\x02 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x03 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"#\n\x10GetGcsUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\")\n\x15\x42\x61tchGetGcsUrlRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\"U\n\x12UploadFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\"a\n\x11UploadUrlResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\x12\x0b\n\x03url\x18\x03 \x01(\t\"\"\n\x13\x44ownloadUrlResponse\x12\x0b\n\x03url\x18\x01 \x01(\t\"*\n\x11ShareLinkResponse\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\"-\n\x10\x46ileListResponse\x12\x19\n\x05\x66iles\x18\x01 \x03(\x0b\x32\n.file.File\"g\n\x0fGetFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12*\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFileH\x00\x88\x01\x01\x42\x0e\n\x0c_upload_file\"H\n\x18\x42\x61tchDownloadUrlResponse\x12,\n\rdownload_urls\x18\x01 \x03(\x0b\x32\x15.file.DownloadUrlInfo\"M\n\x0f\x44ownloadUrlInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t\x12\x12\n\x05\x65rror\x18\x03 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_error\"$\n\x11GetGcsUrlResponse\x12\x0f\n\x07gcs_url\x18\x01 \x01(\t\"<\n\x16\x42\x61tchGetGcsUrlResponse\x12\"\n\x08gcs_urls\x18\x01 \x03(\x0b\x32\x10.file.GcsUrlInfo\"L\n\nGcsUrlInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x0f\n\x07gcs_url\x18\x02 \x01(\t\x12\x12\n\x05\x65rror\x18\x03 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_error\"\x07\n\x05\x45mpty2\xae\x07\n\x0b\x46ileService\x12?\n\nUploadFile\x12\x17.file.UploadFileRequest\x1a\x18.file.UploadFileResponse\x12\x44\n\x11GenerateUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12M\n\x1aGenerateResumableUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12\x43\n\x16\x43onfirmUploadCompleted\x12\x1c.file.UploadCompletedRequest\x1a\x0b.file.Empty\x12J\n\x13GenerateDownloadUrl\x12\x18.file.DownloadUrlRequest\x1a\x19.file.DownloadUrlResponse\x12Y\n\x18\x42\x61tchGenerateDownloadUrl\x12\x1d.file.BatchDownloadUrlRequest\x1a\x1e.file.BatchDownloadUrlResponse\x12<\n\tGetGcsUrl\x12\x16.file.GetGcsUrlRequest\x1a\x17.file.GetGcsUrlResponse\x12K\n\x0e\x42\x61tchGetGcsUrl\x12\x1b.file.BatchGetGcsUrlRequest\x1a\x1c.file.BatchGetGcsUrlResponse\x12\x44\n\x11GenerateShareLink\x12\x16.file.ShareLinkRequest\x1a\x17.file.ShareLinkResponse\x12\x30\n\tVisitFile\x12\x16.file.FileVisitRequest\x1a\x0b.file.Empty\x12\x36\n\x07GetFile\x12\x14.file.GetFileRequest\x1a\x15.file.GetFileResponse\x12\x31\n\nRenameFile\x12\x17.file.RenameFileRequest\x1a\n.file.File\x12\x32\n\nDeleteFile\x12\x17.file.DeleteFileRequest\x1a\x0b.file.Empty\x12;\n\tListFiles\x12\x16.file.ListFilesRequest\x1a\x16.file.FileListResponseb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x12\x66ile_service.proto\x12\x04\x66ile\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/protobuf/struct.proto\"\xab\x01\n\x04\x46ile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x11\n\tfile_name\x18\x03 \x01(\t\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12.\n\ncreated_at\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb7\x02\n\nUploadFile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x0f\n\x07\x66ile_id\x18\x03 \x01(\t\x12\x14\n\x0cstorage_type\x18\x04 \x01(\t\x12\x13\n\x0bstored_name\x18\x05 \x01(\t\x12\x13\n\x0bstored_path\x18\x06 \x01(\t\x12\x11\n\tfile_name\x18\x07 \x01(\t\x12\x11\n\tfile_size\x18\x08 \x01(\x03\x12\x10\n\x08\x66ile_ext\x18\t \x01(\t\x12\x11\n\tmime_type\x18\n \x01(\t\x12\x0e\n\x06status\x18\x0b \x01(\t\x12.\n\ncreated_at\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\r \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xdf\x01\n\x11UploadFileRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\x0c\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12\x11\n\tmime_type\x18\x05 \x01(\t\x12\x19\n\x0cis_temporary\x18\x06 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x07 \x01(\x05H\x02\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_seconds\"\xf3\x01\n\x10UploadUrlRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x11\n\tfile_type\x18\x03 \x01(\t\x12\x11\n\tmime_type\x18\x04 \x01(\t\x12\x11\n\tfile_size\x18\x05 \x01(\x03\x12\x11\n\tfile_hash\x18\x06 \x01(\t\x12\x19\n\x0cis_temporary\x18\x07 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x08 \x01(\x05H\x02\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_seconds\")\n\x16UploadCompletedRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"u\n\x12\x44ownloadUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x13\n\x06is_cdn\x18\x03 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x02 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"\xd4\x01\n\x10ShareLinkRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x11\n\tis_public\x18\x02 \x01(\x08\x12\x14\n\x0c\x61\x63\x63\x65ss_scope\x18\x03 \x01(\t\x12\x1b\n\x0e\x65xpire_seconds\x18\x04 \x01(\x05H\x00\x88\x01\x01\x12\x17\n\nmax_access\x18\x05 \x01(\x05H\x01\x88\x01\x01\x12\x1b\n\x0eshare_password\x18\x06 \x01(\tH\x02\x88\x01\x01\x42\x11\n\x0f_expire_secondsB\r\n\x0b_max_accessB\x11\n\x0f_share_password\"\x82\x01\n\x10\x46ileVisitRequest\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\x12\x13\n\x0b\x61\x63\x63\x65ss_type\x18\x02 \x01(\t\x12\x17\n\x0f\x61\x63\x63\x65ss_duration\x18\x03 \x01(\x05\x12)\n\x08metadata\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\"!\n\x0eGetFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"6\n\x11RenameFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x10\n\x08new_name\x18\x02 \x01(\t\"$\n\x11\x44\x65leteFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"\x8d\x02\n\x10ListFilesRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x16\n\tfile_name\x18\x02 \x01(\tH\x01\x88\x01\x01\x12\x11\n\tfile_type\x18\x03 \x03(\t\x12\x1c\n\x0f\x63reated_by_role\x18\x04 \x01(\tH\x02\x88\x01\x01\x12\x17\n\ncreated_by\x18\x05 \x01(\tH\x03\x88\x01\x01\x12\x16\n\tpage_size\x18\x06 \x01(\x05H\x04\x88\x01\x01\x12\x11\n\x04page\x18\x07 \x01(\x05H\x05\x88\x01\x01\x42\x0c\n\n_folder_idB\x0c\n\n_file_nameB\x12\n\x10_created_by_roleB\r\n\x0b_created_byB\x0c\n\n_page_sizeB\x07\n\x05_page\"{\n\x17\x42\x61tchDownloadUrlRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\x12\x13\n\x06is_cdn\x18\x02 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x03 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"#\n\x10GetGcsUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\")\n\x15\x42\x61tchGetGcsUrlRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\"U\n\x12UploadFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\"a\n\x11UploadUrlResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\x12\x0b\n\x03url\x18\x03 \x01(\t\"\"\n\x13\x44ownloadUrlResponse\x12\x0b\n\x03url\x18\x01 \x01(\t\"*\n\x11ShareLinkResponse\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\"-\n\x10\x46ileListResponse\x12\x19\n\x05\x66iles\x18\x01 \x03(\x0b\x32\n.file.File\"g\n\x0fGetFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12*\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFileH\x00\x88\x01\x01\x42\x0e\n\x0c_upload_file\"H\n\x18\x42\x61tchDownloadUrlResponse\x12,\n\rdownload_urls\x18\x01 \x03(\x0b\x32\x15.file.DownloadUrlInfo\"M\n\x0f\x44ownloadUrlInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t\x12\x12\n\x05\x65rror\x18\x03 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_error\"7\n\x11GetGcsUrlResponse\x12\x0f\n\x07gcs_url\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t\"<\n\x16\x42\x61tchGetGcsUrlResponse\x12\"\n\x08gcs_urls\x18\x01 \x03(\x0b\x32\x10.file.GcsUrlInfo\"_\n\nGcsUrlInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x0f\n\x07gcs_url\x18\x02 \x01(\t\x12\x11\n\tmime_type\x18\x03 \x01(\t\x12\x12\n\x05\x65rror\x18\x04 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_error\"\x07\n\x05\x45mpty2\xae\x07\n\x0b\x46ileService\x12?\n\nUploadFile\x12\x17.file.UploadFileRequest\x1a\x18.file.UploadFileResponse\x12\x44\n\x11GenerateUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12M\n\x1aGenerateResumableUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12\x43\n\x16\x43onfirmUploadCompleted\x12\x1c.file.UploadCompletedRequest\x1a\x0b.file.Empty\x12J\n\x13GenerateDownloadUrl\x12\x18.file.DownloadUrlRequest\x1a\x19.file.DownloadUrlResponse\x12Y\n\x18\x42\x61tchGenerateDownloadUrl\x12\x1d.file.BatchDownloadUrlRequest\x1a\x1e.file.BatchDownloadUrlResponse\x12<\n\tGetGcsUrl\x12\x16.file.GetGcsUrlRequest\x1a\x17.file.GetGcsUrlResponse\x12K\n\x0e\x42\x61tchGetGcsUrl\x12\x1b.file.BatchGetGcsUrlRequest\x1a\x1c.file.BatchGetGcsUrlResponse\x12\x44\n\x11GenerateShareLink\x12\x16.file.ShareLinkRequest\x1a\x17.file.ShareLinkResponse\x12\x30\n\tVisitFile\x12\x16.file.FileVisitRequest\x1a\x0b.file.Empty\x12\x36\n\x07GetFile\x12\x14.file.GetFileRequest\x1a\x15.file.GetFileResponse\x12\x31\n\nRenameFile\x12\x17.file.RenameFileRequest\x1a\n.file.File\x12\x32\n\nDeleteFile\x12\x17.file.DeleteFileRequest\x1a\x0b.file.Empty\x12;\n\tListFiles\x12\x16.file.ListFilesRequest\x1a\x16.file.FileListResponseb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -80,13 +80,13 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_DOWNLOADURLINFO']._serialized_start=2659
   _globals['_DOWNLOADURLINFO']._serialized_end=2736
   _globals['_GETGCSURLRESPONSE']._serialized_start=2738
-  _globals['_GETGCSURLRESPONSE']._serialized_end=2774
-  _globals['_BATCHGETGCSURLRESPONSE']._serialized_start=2776
-  _globals['_BATCHGETGCSURLRESPONSE']._serialized_end=2836
-  _globals['_GCSURLINFO']._serialized_start=2838
-  _globals['_GCSURLINFO']._serialized_end=2914
-  _globals['_EMPTY']._serialized_start=2916
-  _globals['_EMPTY']._serialized_end=2923
-  _globals['_FILESERVICE']._serialized_start=2926
-  _globals['_FILESERVICE']._serialized_end=3868
+  _globals['_GETGCSURLRESPONSE']._serialized_end=2793
+  _globals['_BATCHGETGCSURLRESPONSE']._serialized_start=2795
+  _globals['_BATCHGETGCSURLRESPONSE']._serialized_end=2855
+  _globals['_GCSURLINFO']._serialized_start=2857
+  _globals['_GCSURLINFO']._serialized_end=2952
+  _globals['_EMPTY']._serialized_start=2954
+  _globals['_EMPTY']._serialized_end=2961
+  _globals['_FILESERVICE']._serialized_start=2964
+  _globals['_FILESERVICE']._serialized_end=3906
 # @@protoc_insertion_point(module_scope)

{tamar_file_hub_client-0.1.1 → tamar_file_hub_client-0.1.2}/file_hub_client/rpc/protos/file_service.proto

@@ -179,6 +179,7 @@ message DownloadUrlInfo {
 
 message GetGcsUrlResponse {
     string gcs_url = 1;
+    string mime_type = 2;
 }
 
 message BatchGetGcsUrlResponse {
@@ -188,7 +189,8 @@ message BatchGetGcsUrlResponse {
 message GcsUrlInfo {
     string file_id = 1;
     string gcs_url = 2;
-    optional string error = 3;
+    string mime_type = 3;
+    optional string error = 4;
 }
 
 message Empty {}

{tamar_file_hub_client-0.1.1 → tamar_file_hub_client-0.1.2}/file_hub_client/schemas/__init__.py

@@ -14,6 +14,7 @@ from .file import (
     DownloadUrlInfo,
     BatchDownloadUrlResponse,
     GcsUrlInfo,
+    GetGcsUrlResponse,
     BatchGcsUrlResponse,
 )
 from .folder import (
@@ -70,6 +71,7 @@ __all__ = [
     "DownloadUrlInfo",
     "BatchDownloadUrlResponse",
     "GcsUrlInfo",
+    "GetGcsUrlResponse",
     "BatchGcsUrlResponse",
 
     # 文件夹相关

{tamar_file_hub_client-0.1.1 → tamar_file_hub_client-0.1.2}/file_hub_client/schemas/file.py

@@ -111,9 +111,16 @@ class GcsUrlInfo(BaseModel):
     """GCS URL信息"""
     file_id: str = Field(..., description="文件ID")
     gcs_url: str = Field(..., description="GCS URL")
+    mime_type: str = Field(..., description="MIME类型")
     error: Optional[str] = Field(None, description="错误信息")
 
 
+class GetGcsUrlResponse(BaseModel):
+    """获取GCS URL响应"""
+    gcs_url: str = Field(..., description="GCS URL")
+    mime_type: str = Field(..., description="MIME类型")
+
+
 class BatchGcsUrlResponse(BaseModel):
     """批量GCS URL响应"""
     gcs_urls: List[GcsUrlInfo] = Field(default_factory=list, description="GCS URL列表")

{tamar_file_hub_client-0.1.1 → tamar_file_hub_client-0.1.2}/file_hub_client/services/file/async_blob_service.py

@@ -11,7 +11,7 @@ from .base_file_service import BaseFileService
 from ...enums import UploadMode
 from ...errors import ValidationError
 from ...rpc import AsyncGrpcClient
-from ...schemas import FileUploadResponse, UploadUrlResponse, BatchDownloadUrlResponse, DownloadUrlInfo, GcsUrlInfo, BatchGcsUrlResponse
+from ...schemas import FileUploadResponse, UploadUrlResponse, BatchDownloadUrlResponse, DownloadUrlInfo, GcsUrlInfo, GetGcsUrlResponse, BatchGcsUrlResponse
 from ...utils import AsyncHttpUploader, AsyncHttpDownloader, retry_with_backoff, get_file_mime_type
 
 
@@ -623,7 +623,7 @@ class AsyncBlobService(BaseFileService):
             *,
             request_id: Optional[str] = None,
             **metadata
-    ) -> str:
+    ) -> GetGcsUrlResponse:
         """
         获取文件的GCS URL
 
@@ -633,7 +633,7 @@ class AsyncBlobService(BaseFileService):
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
 
         Returns:
-            GCS URL
+            GCS URL响应，包含URL和MIME类型
         """
         from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
 
@@ -646,7 +646,10 @@ class AsyncBlobService(BaseFileService):
 
         response = await stub.GetGcsUrl(request, metadata=grpc_metadata)
 
-        return response.gcs_url
+        return GetGcsUrlResponse(
+            gcs_url=response.gcs_url,
+            mime_type=response.mime_type
+        )
 
     async def batch_get_gcs_url(
             self,
@@ -683,6 +686,7 @@ class AsyncBlobService(BaseFileService):
             gcs_urls.append(GcsUrlInfo(
                 file_id=url_info.file_id,
                 gcs_url=url_info.gcs_url,
+                mime_type=url_info.mime_type,
                 error=url_info.error if url_info.HasField('error') else None
             ))
 

{tamar_file_hub_client-0.1.1 → tamar_file_hub_client-0.1.2}/file_hub_client/services/file/sync_blob_service.py

@@ -9,7 +9,7 @@ from .base_file_service import BaseFileService
 from ...enums import UploadMode
 from ...errors import ValidationError
 from ...rpc import SyncGrpcClient
-from ...schemas import FileUploadResponse, UploadUrlResponse, BatchDownloadUrlResponse, DownloadUrlInfo, GcsUrlInfo, BatchGcsUrlResponse
+from ...schemas import FileUploadResponse, UploadUrlResponse, BatchDownloadUrlResponse, DownloadUrlInfo, GcsUrlInfo, GetGcsUrlResponse, BatchGcsUrlResponse
 from ...utils import HttpUploader, HttpDownloader, retry_with_backoff, get_file_mime_type
 
 
@@ -620,7 +620,7 @@ class SyncBlobService(BaseFileService):
             *,
             request_id: Optional[str] = None,
             **metadata
-    ) -> str:
+    ) -> GetGcsUrlResponse:
         """
         获取文件的GCS URL
 
@@ -630,7 +630,7 @@ class SyncBlobService(BaseFileService):
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
 
         Returns:
-            GCS URL
+            GCS URL响应，包含URL和MIME类型
         """
         from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
 
@@ -643,7 +643,10 @@ class SyncBlobService(BaseFileService):
 
         response = stub.GetGcsUrl(request, metadata=grpc_metadata)
 
-        return response.gcs_url
+        return GetGcsUrlResponse(
+            gcs_url=response.gcs_url,
+            mime_type=response.mime_type
+        )
 
     def batch_get_gcs_url(
             self,
@@ -680,6 +683,7 @@ class SyncBlobService(BaseFileService):
             gcs_urls.append(GcsUrlInfo(
                 file_id=url_info.file_id,
                 gcs_url=url_info.gcs_url,
+                mime_type=url_info.mime_type,
                 error=url_info.error if url_info.HasField('error') else None
             ))
 

{tamar_file_hub_client-0.1.1 → tamar_file_hub_client-0.1.2}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="tamar-file-hub-client",
-    version="0.1.1",
+    version="0.1.2",
     description="A Python SDK for gRPC-based file management system",
     long_description=open("README.md", encoding="utf-8").read(),
     long_description_content_type="text/markdown",

{tamar_file_hub_client-0.1.1 → tamar_file_hub_client-0.1.2}/tamar_file_hub_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tamar-file-hub-client
-Version: 0.1.1
+Version: 0.1.2
 Summary: A Python SDK for gRPC-based file management system
 Home-page: https://github.com/Tamar-Edge-AI/file-hub-client
 Author: Oscar Ou
@@ -682,6 +682,137 @@ async with AsyncTamarFileHubClient() as client:
     print(f"文件已保存到: {save_path}")
 ```
 
+#### 高级下载功能
+
+File Hub Client 提供了高级的下载URL管理功能，支持批量操作和直接获取GCS URL：
+
+##### 批量生成下载URL
+
+当需要为多个文件生成下载URL时，使用批量接口可以显著提高效率：
+
+```python
+from file_hub_client import AsyncTamarFileHubClient
+
+async with AsyncTamarFileHubClient() as client:
+    # 设置用户上下文
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 批量生成下载URL
+    file_ids = ["file-001", "file-002", "file-003"]
+    
+    result = await client.blobs.batch_generate_download_url(
+        file_ids=file_ids,
+        is_cdn=True,           # 使用CDN加速（可选，默认为True）
+        expire_seconds=3600    # URL有效期1小时（可选）
+    )
+    
+    # 处理结果
+    for url_info in result.download_urls:
+        if url_info.error:
+            print(f"文件 {url_info.file_id} 生成URL失败: {url_info.error}")
+        else:
+            print(f"文件 {url_info.file_id} 的下载URL: {url_info.url}")
+```
+
+同步客户端示例：
+
+```python
+from file_hub_client import TamarFileHubClient
+
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    result = client.blobs.batch_generate_download_url(
+        file_ids=["file-001", "file-002"],
+        is_cdn=False  # 不使用CDN，直接返回源站URL
+    )
+```
+
+##### 获取GCS URL
+
+对于需要直接访问Google Cloud Storage的场景，可以获取文件的GCS URL和MIME类型信息：
+
+```python
+# 异步客户端 - 获取单个文件的GCS URL
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    gcs_response = await client.blobs.get_gcs_url(file_id="file-001")
+    print(f"GCS URL: {gcs_response.gcs_url}")
+    print(f"MIME类型: {gcs_response.mime_type}")
+    # 输出示例：
+    # GCS URL: gs://bucket-name/path/to/file.pdf
+    # MIME类型: application/pdf
+```
+
+**注意**：`get_gcs_url` 方法现在返回一个 `GetGcsUrlResponse` 对象，包含：
+- `gcs_url`: Google Cloud Storage 的完整路径
+- `mime_type`: 文件的MIME类型，便于正确处理文件内容
+
+##### 批量获取GCS URL
+
+批量获取多个文件的GCS URL和MIME类型信息：
+
+```python
+# 异步客户端 - 批量获取GCS URL
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    file_ids = ["file-001", "file-002", "file-003"]
+    result = await client.blobs.batch_get_gcs_url(file_ids)
+    
+    # 处理结果
+    for url_info in result.gcs_urls:
+        if url_info.error:
+            print(f"文件 {url_info.file_id} 获取GCS URL失败: {url_info.error}")
+        else:
+            print(f"文件 {url_info.file_id}:")
+            print(f"  GCS URL: {url_info.gcs_url}")
+            print(f"  MIME类型: {url_info.mime_type}")
+            # 根据MIME类型处理文件
+            if url_info.mime_type.startswith('image/'):
+                print(f"  这是一个图片文件")
+            elif url_info.mime_type == 'application/pdf':
+                print(f"  这是一个PDF文件")
+```
+
+同步客户端示例：
+
+```python
+# 同步客户端 - 批量获取GCS URL
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 获取单个GCS URL
+    gcs_response = client.blobs.get_gcs_url(file_id="file-001")
+    print(f"GCS URL: {gcs_response.gcs_url}")
+    print(f"MIME类型: {gcs_response.mime_type}")
+    
+    # 批量获取GCS URL
+    result = client.blobs.batch_get_gcs_url(["file-001", "file-002"])
+```
+
+##### 使用场景说明
+
+1. **批量下载URL生成**：
+   - 适用于需要同时下载多个文件的场景
+   - 支持CDN加速，提供更好的下载体验
+   - 可设置URL有效期，增强安全性
+   - 批量操作减少网络往返，提高效率
+
+2. **GCS URL获取**：
+   - 适用于需要与Google Cloud服务集成的场景
+   - 可用于数据分析、批处理等后端处理
+   - 支持使用GCS工具进行文件操作
+   - 返回的是永久有效的存储路径
+   - 同时返回MIME类型信息，便于正确处理不同类型的文件
+   - 可根据MIME类型选择合适的处理方式（如图片处理、文档解析等）
+
+3. **错误处理**：
+   - 每个文件独立处理，部分失败不影响其他文件
+   - 错误信息通过 `error` 字段返回
+   - 建议在批量操作时做好错误处理和重试逻辑
+
 ### 文件管理操作
 
 File Hub Client 提供了完整的文件管理功能，通过 `files` 服务访问：
@@ -2019,6 +2150,12 @@ MIT License
 
 ## 更新日志
 
+### v0.0.5 (2025-01)
+- 新增批量下载URL生成接口 (batch_generate_download_url)
+- 新增GCS URL获取接口 (get_gcs_url, batch_get_gcs_url)
+- GCS URL接口返回MIME类型信息，便于文件类型识别
+- 更新相关文档和测试用例
+
 ### v0.0.4 (2025-01)
 - 新增从URL上传文件功能
 - 支持自动下载URL内容并上传到GCS