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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tamar-file-hub-client
-Version: 0.1.1
+Version: 0.1.3
 Summary: A Python SDK for gRPC-based file management system
 Home-page: https://github.com/Tamar-Edge-AI/file-hub-client
 Author: Oscar Ou
@@ -641,6 +641,30 @@ async with AsyncTamarFileHubClient() as client:
     )
 ```
 
+#### 保留原始文件名上传
+
+```python
+from file_hub_client import AsyncTamarFileHubClient
+
+async with AsyncTamarFileHubClient() as client:
+    # 设置用户上下文
+    client.set_user_context(org_id="123", user_id="456")
+
+    # 上传时保留原始文件名
+    file_info = await client.blobs.upload(
+        "document.pdf",
+        keep_original_filename=True  # 保留原始文件名，默认为False
+    )
+    
+    # 也可以指定文件夹和其他参数
+    file_info = await client.blobs.upload(
+        "report.xlsx",
+        folder_id="folder-123",
+        keep_original_filename=True,  # 保留原始文件名
+        is_temporary=False
+    )
+```
+
 ### 文件下载
 
 File Hub Client 提供了统一的下载接口，支持两种结构返回：
@@ -682,6 +706,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 +2174,13 @@ MIT License
 
 ## 更新日志
 
+### v0.0.5 (2025-01)
+- 新增批量下载URL生成接口 (batch_generate_download_url)
+- 新增GCS URL获取接口 (get_gcs_url, batch_get_gcs_url)
+- GCS URL接口返回MIME类型信息，便于文件类型识别
+- 新增 keep_original_filename 参数支持保留原始文件名
+- 更新相关文档和测试用例
+
 ### v0.0.4 (2025-01)
 - 新增从URL上传文件功能
 - 支持自动下载URL内容并上传到GCS

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

@@ -595,6 +595,30 @@ async with AsyncTamarFileHubClient() as client:
     )
 ```
 
+#### 保留原始文件名上传
+
+```python
+from file_hub_client import AsyncTamarFileHubClient
+
+async with AsyncTamarFileHubClient() as client:
+    # 设置用户上下文
+    client.set_user_context(org_id="123", user_id="456")
+
+    # 上传时保留原始文件名
+    file_info = await client.blobs.upload(
+        "document.pdf",
+        keep_original_filename=True  # 保留原始文件名，默认为False
+    )
+    
+    # 也可以指定文件夹和其他参数
+    file_info = await client.blobs.upload(
+        "report.xlsx",
+        folder_id="folder-123",
+        keep_original_filename=True,  # 保留原始文件名
+        is_temporary=False
+    )
+```
+
 ### 文件下载
 
 File Hub Client 提供了统一的下载接口，支持两种结构返回：
@@ -636,6 +660,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 +2128,13 @@ MIT License
 
 ## 更新日志
 
+### v0.0.5 (2025-01)
+- 新增批量下载URL生成接口 (batch_generate_download_url)
+- 新增GCS URL获取接口 (get_gcs_url, batch_get_gcs_url)
+- GCS URL接口返回MIME类型信息，便于文件类型识别
+- 新增 keep_original_filename 参数支持保留原始文件名
+- 更新相关文档和测试用例
+
 ### v0.0.4 (2025-01)
 - 新增从URL上传文件功能
 - 支持自动下载URL内容并上传到GCS

tamar_file_hub_client-0.1.3/file_hub_client/rpc/gen/file_service_pb2.py

@@ -0,0 +1,92 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: file_service.proto
+# Protobuf Python Version: 5.27.2
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    5,
+    27,
+    2,
+    '',
+    'file_service.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+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\"\x9f\x02\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\x12#\n\x16keep_original_filename\x18\x08 \x01(\x08H\x03\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_secondsB\x19\n\x17_keep_original_filename\"\xb3\x02\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\x12#\n\x16keep_original_filename\x18\t \x01(\x08H\x03\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_secondsB\x19\n\x17_keep_original_filename\")\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)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'file_service_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_FILE']._serialized_start=92
+  _globals['_FILE']._serialized_end=263
+  _globals['_UPLOADFILE']._serialized_start=266
+  _globals['_UPLOADFILE']._serialized_end=577
+  _globals['_UPLOADFILEREQUEST']._serialized_start=580
+  _globals['_UPLOADFILEREQUEST']._serialized_end=867
+  _globals['_UPLOADURLREQUEST']._serialized_start=870
+  _globals['_UPLOADURLREQUEST']._serialized_end=1177
+  _globals['_UPLOADCOMPLETEDREQUEST']._serialized_start=1179
+  _globals['_UPLOADCOMPLETEDREQUEST']._serialized_end=1220
+  _globals['_DOWNLOADURLREQUEST']._serialized_start=1222
+  _globals['_DOWNLOADURLREQUEST']._serialized_end=1339
+  _globals['_SHARELINKREQUEST']._serialized_start=1342
+  _globals['_SHARELINKREQUEST']._serialized_end=1554
+  _globals['_FILEVISITREQUEST']._serialized_start=1557
+  _globals['_FILEVISITREQUEST']._serialized_end=1687
+  _globals['_GETFILEREQUEST']._serialized_start=1689
+  _globals['_GETFILEREQUEST']._serialized_end=1722
+  _globals['_RENAMEFILEREQUEST']._serialized_start=1724
+  _globals['_RENAMEFILEREQUEST']._serialized_end=1778
+  _globals['_DELETEFILEREQUEST']._serialized_start=1780
+  _globals['_DELETEFILEREQUEST']._serialized_end=1816
+  _globals['_LISTFILESREQUEST']._serialized_start=1819
+  _globals['_LISTFILESREQUEST']._serialized_end=2088
+  _globals['_BATCHDOWNLOADURLREQUEST']._serialized_start=2090
+  _globals['_BATCHDOWNLOADURLREQUEST']._serialized_end=2213
+  _globals['_GETGCSURLREQUEST']._serialized_start=2215
+  _globals['_GETGCSURLREQUEST']._serialized_end=2250
+  _globals['_BATCHGETGCSURLREQUEST']._serialized_start=2252
+  _globals['_BATCHGETGCSURLREQUEST']._serialized_end=2293
+  _globals['_UPLOADFILERESPONSE']._serialized_start=2295
+  _globals['_UPLOADFILERESPONSE']._serialized_end=2380
+  _globals['_UPLOADURLRESPONSE']._serialized_start=2382
+  _globals['_UPLOADURLRESPONSE']._serialized_end=2479
+  _globals['_DOWNLOADURLRESPONSE']._serialized_start=2481
+  _globals['_DOWNLOADURLRESPONSE']._serialized_end=2515
+  _globals['_SHARELINKRESPONSE']._serialized_start=2517
+  _globals['_SHARELINKRESPONSE']._serialized_end=2559
+  _globals['_FILELISTRESPONSE']._serialized_start=2561
+  _globals['_FILELISTRESPONSE']._serialized_end=2606
+  _globals['_GETFILERESPONSE']._serialized_start=2608
+  _globals['_GETFILERESPONSE']._serialized_end=2711
+  _globals['_BATCHDOWNLOADURLRESPONSE']._serialized_start=2713
+  _globals['_BATCHDOWNLOADURLRESPONSE']._serialized_end=2785
+  _globals['_DOWNLOADURLINFO']._serialized_start=2787
+  _globals['_DOWNLOADURLINFO']._serialized_end=2864
+  _globals['_GETGCSURLRESPONSE']._serialized_start=2866
+  _globals['_GETGCSURLRESPONSE']._serialized_end=2921
+  _globals['_BATCHGETGCSURLRESPONSE']._serialized_start=2923
+  _globals['_BATCHGETGCSURLRESPONSE']._serialized_end=2983
+  _globals['_GCSURLINFO']._serialized_start=2985
+  _globals['_GCSURLINFO']._serialized_end=3080
+  _globals['_EMPTY']._serialized_start=3082
+  _globals['_EMPTY']._serialized_end=3089
+  _globals['_FILESERVICE']._serialized_start=3092
+  _globals['_FILESERVICE']._serialized_end=4034
+# @@protoc_insertion_point(module_scope)

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

@@ -61,6 +61,7 @@ message UploadFileRequest {
     string mime_type = 5;
     optional bool is_temporary = 6;
     optional int32 expire_seconds = 7;
+    optional bool keep_original_filename = 8;  // 保留原始文件名，默认false
 }
 
 message UploadUrlRequest {
@@ -72,6 +73,7 @@ message UploadUrlRequest {
     string file_hash = 6;
     optional bool is_temporary = 7;
     optional int32 expire_seconds = 8;
+    optional bool keep_original_filename = 9;  // 保留原始文件名，默认false
 }
 
 message UploadCompletedRequest {
@@ -179,6 +181,7 @@ message DownloadUrlInfo {
 
 message GetGcsUrlResponse {
     string gcs_url = 1;
+    string mime_type = 2;
 }
 
 message BatchGetGcsUrlResponse {
@@ -188,7 +191,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.3}/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.3}/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列表")