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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tamar-file-hub-client
-Version: 0.0.12
+Version: 0.1.1
 Summary: A Python SDK for gRPC-based file management system
 Home-page: https://github.com/Tamar-Edge-AI/file-hub-client
 Author: Oscar Ou
@@ -695,11 +695,23 @@ async with AsyncTamarFileHubClient() as client:
     # 设置用户上下文
     client.set_user_context(org_id="123", user_id="456")
     
-    # 获取文件详细信息
-    file_info = await client.files.get_file(file_id="file-001")
+    # 获取文件详细信息（返回 GetFileResponse 对象）
+    response = await client.files.get_file(file_id="file-001")
+    
+    # 访问文件基本信息
+    file_info = response.file
+    print(f"文件ID: {file_info.id}")
     print(f"文件名: {file_info.file_name}")
-    print(f"文件大小: {file_info.file_size} bytes")
+    print(f"文件类型: {file_info.file_type}")
     print(f"创建时间: {file_info.created_at}")
+    
+    # 访问上传文件详细信息（如果存在）
+    if response.upload_file:
+        upload_info = response.upload_file
+        print(f"文件大小: {upload_info.file_size} bytes")
+        print(f"MIME类型: {upload_info.mime_type}")
+        print(f"存储类型: {upload_info.storage_type}")
+        print(f"存储路径: {upload_info.stored_path}")
 ```
 
 #### 重命名文件
@@ -1622,10 +1634,12 @@ folder = await client.folders.create_folder(
 
 # 同步客户端同样支持
 sync_client = TamarFileHubClient(user_context=user_context)
-file_info = sync_client.files.get_file(
+response = sync_client.files.get_file(
     file_id="file-123",
     request_id="debug-get-file-001"
 )
+# response.file 包含文件基本信息
+# response.upload_file 包含上传文件详细信息（可能为None）
 ```
 
 #### 请求ID优先级
@@ -1679,7 +1693,8 @@ await minimal_client.taples.create_table(name="auto_generated")
 - 所有批量操作方法
 
 **文件服务**：
-- `get_file()`, `rename_file()`, `delete_file()`, `list_files()`
+- `get_file()` - 返回 `GetFileResponse` 对象，包含 `file` 和 `upload_file` 信息
+- `rename_file()`, `delete_file()`, `list_files()`
 - `generate_share_link()`, `visit_file()`
 
 **文件夹服务**：

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

@@ -649,11 +649,23 @@ async with AsyncTamarFileHubClient() as client:
     # 设置用户上下文
     client.set_user_context(org_id="123", user_id="456")
     
-    # 获取文件详细信息
-    file_info = await client.files.get_file(file_id="file-001")
+    # 获取文件详细信息（返回 GetFileResponse 对象）
+    response = await client.files.get_file(file_id="file-001")
+    
+    # 访问文件基本信息
+    file_info = response.file
+    print(f"文件ID: {file_info.id}")
     print(f"文件名: {file_info.file_name}")
-    print(f"文件大小: {file_info.file_size} bytes")
+    print(f"文件类型: {file_info.file_type}")
     print(f"创建时间: {file_info.created_at}")
+    
+    # 访问上传文件详细信息（如果存在）
+    if response.upload_file:
+        upload_info = response.upload_file
+        print(f"文件大小: {upload_info.file_size} bytes")
+        print(f"MIME类型: {upload_info.mime_type}")
+        print(f"存储类型: {upload_info.storage_type}")
+        print(f"存储路径: {upload_info.stored_path}")
 ```
 
 #### 重命名文件
@@ -1576,10 +1588,12 @@ folder = await client.folders.create_folder(
 
 # 同步客户端同样支持
 sync_client = TamarFileHubClient(user_context=user_context)
-file_info = sync_client.files.get_file(
+response = sync_client.files.get_file(
     file_id="file-123",
     request_id="debug-get-file-001"
 )
+# response.file 包含文件基本信息
+# response.upload_file 包含上传文件详细信息（可能为None）
 ```
 
 #### 请求ID优先级
@@ -1633,7 +1647,8 @@ await minimal_client.taples.create_table(name="auto_generated")
 - 所有批量操作方法
 
 **文件服务**：
-- `get_file()`, `rename_file()`, `delete_file()`, `list_files()`
+- `get_file()` - 返回 `GetFileResponse` 对象，包含 `file` 和 `upload_file` 信息
+- `rename_file()`, `delete_file()`, `list_files()`
 - `generate_share_link()`, `visit_file()`
 
 **文件夹服务**：

{tamar_file_hub_client-0.0.12 → tamar_file_hub_client-0.1.1}/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\"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\"\x07\n\x05\x45mpty2\xbd\x05\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\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+\n\x07GetFile\x12\x14.file.GetFileRequest\x1a\n.file.File\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\"$\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')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -57,18 +57,36 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_DELETEFILEREQUEST']._serialized_end=1688
   _globals['_LISTFILESREQUEST']._serialized_start=1691
   _globals['_LISTFILESREQUEST']._serialized_end=1960
-  _globals['_UPLOADFILERESPONSE']._serialized_start=1962
-  _globals['_UPLOADFILERESPONSE']._serialized_end=2047
-  _globals['_UPLOADURLRESPONSE']._serialized_start=2049
-  _globals['_UPLOADURLRESPONSE']._serialized_end=2146
-  _globals['_DOWNLOADURLRESPONSE']._serialized_start=2148
-  _globals['_DOWNLOADURLRESPONSE']._serialized_end=2182
-  _globals['_SHARELINKRESPONSE']._serialized_start=2184
-  _globals['_SHARELINKRESPONSE']._serialized_end=2226
-  _globals['_FILELISTRESPONSE']._serialized_start=2228
-  _globals['_FILELISTRESPONSE']._serialized_end=2273
-  _globals['_EMPTY']._serialized_start=2275
-  _globals['_EMPTY']._serialized_end=2282
-  _globals['_FILESERVICE']._serialized_start=2285
-  _globals['_FILESERVICE']._serialized_end=2986
+  _globals['_BATCHDOWNLOADURLREQUEST']._serialized_start=1962
+  _globals['_BATCHDOWNLOADURLREQUEST']._serialized_end=2085
+  _globals['_GETGCSURLREQUEST']._serialized_start=2087
+  _globals['_GETGCSURLREQUEST']._serialized_end=2122
+  _globals['_BATCHGETGCSURLREQUEST']._serialized_start=2124
+  _globals['_BATCHGETGCSURLREQUEST']._serialized_end=2165
+  _globals['_UPLOADFILERESPONSE']._serialized_start=2167
+  _globals['_UPLOADFILERESPONSE']._serialized_end=2252
+  _globals['_UPLOADURLRESPONSE']._serialized_start=2254
+  _globals['_UPLOADURLRESPONSE']._serialized_end=2351
+  _globals['_DOWNLOADURLRESPONSE']._serialized_start=2353
+  _globals['_DOWNLOADURLRESPONSE']._serialized_end=2387
+  _globals['_SHARELINKRESPONSE']._serialized_start=2389
+  _globals['_SHARELINKRESPONSE']._serialized_end=2431
+  _globals['_FILELISTRESPONSE']._serialized_start=2433
+  _globals['_FILELISTRESPONSE']._serialized_end=2478
+  _globals['_GETFILERESPONSE']._serialized_start=2480
+  _globals['_GETFILERESPONSE']._serialized_end=2583
+  _globals['_BATCHDOWNLOADURLRESPONSE']._serialized_start=2585
+  _globals['_BATCHDOWNLOADURLRESPONSE']._serialized_end=2657
+  _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
 # @@protoc_insertion_point(module_scope)

{tamar_file_hub_client-0.0.12 → tamar_file_hub_client-0.1.1}/file_hub_client/rpc/gen/file_service_pb2_grpc.py

@@ -61,6 +61,21 @@ class FileServiceStub(object):
                 request_serializer=file__service__pb2.DownloadUrlRequest.SerializeToString,
                 response_deserializer=file__service__pb2.DownloadUrlResponse.FromString,
                 _registered_method=True)
+        self.BatchGenerateDownloadUrl = channel.unary_unary(
+                '/file.FileService/BatchGenerateDownloadUrl',
+                request_serializer=file__service__pb2.BatchDownloadUrlRequest.SerializeToString,
+                response_deserializer=file__service__pb2.BatchDownloadUrlResponse.FromString,
+                _registered_method=True)
+        self.GetGcsUrl = channel.unary_unary(
+                '/file.FileService/GetGcsUrl',
+                request_serializer=file__service__pb2.GetGcsUrlRequest.SerializeToString,
+                response_deserializer=file__service__pb2.GetGcsUrlResponse.FromString,
+                _registered_method=True)
+        self.BatchGetGcsUrl = channel.unary_unary(
+                '/file.FileService/BatchGetGcsUrl',
+                request_serializer=file__service__pb2.BatchGetGcsUrlRequest.SerializeToString,
+                response_deserializer=file__service__pb2.BatchGetGcsUrlResponse.FromString,
+                _registered_method=True)
         self.GenerateShareLink = channel.unary_unary(
                 '/file.FileService/GenerateShareLink',
                 request_serializer=file__service__pb2.ShareLinkRequest.SerializeToString,
@@ -74,7 +89,7 @@ class FileServiceStub(object):
         self.GetFile = channel.unary_unary(
                 '/file.FileService/GetFile',
                 request_serializer=file__service__pb2.GetFileRequest.SerializeToString,
-                response_deserializer=file__service__pb2.File.FromString,
+                response_deserializer=file__service__pb2.GetFileResponse.FromString,
                 _registered_method=True)
         self.RenameFile = channel.unary_unary(
                 '/file.FileService/RenameFile',
@@ -128,6 +143,24 @@ class FileServiceServicer(object):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def BatchGenerateDownloadUrl(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def GetGcsUrl(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def BatchGetGcsUrl(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
     def GenerateShareLink(self, request, context):
         """Missing associated documentation comment in .proto file."""
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
@@ -192,6 +225,21 @@ def add_FileServiceServicer_to_server(servicer, server):
                     request_deserializer=file__service__pb2.DownloadUrlRequest.FromString,
                     response_serializer=file__service__pb2.DownloadUrlResponse.SerializeToString,
             ),
+            'BatchGenerateDownloadUrl': grpc.unary_unary_rpc_method_handler(
+                    servicer.BatchGenerateDownloadUrl,
+                    request_deserializer=file__service__pb2.BatchDownloadUrlRequest.FromString,
+                    response_serializer=file__service__pb2.BatchDownloadUrlResponse.SerializeToString,
+            ),
+            'GetGcsUrl': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetGcsUrl,
+                    request_deserializer=file__service__pb2.GetGcsUrlRequest.FromString,
+                    response_serializer=file__service__pb2.GetGcsUrlResponse.SerializeToString,
+            ),
+            'BatchGetGcsUrl': grpc.unary_unary_rpc_method_handler(
+                    servicer.BatchGetGcsUrl,
+                    request_deserializer=file__service__pb2.BatchGetGcsUrlRequest.FromString,
+                    response_serializer=file__service__pb2.BatchGetGcsUrlResponse.SerializeToString,
+            ),
             'GenerateShareLink': grpc.unary_unary_rpc_method_handler(
                     servicer.GenerateShareLink,
                     request_deserializer=file__service__pb2.ShareLinkRequest.FromString,
@@ -205,7 +253,7 @@ def add_FileServiceServicer_to_server(servicer, server):
             'GetFile': grpc.unary_unary_rpc_method_handler(
                     servicer.GetFile,
                     request_deserializer=file__service__pb2.GetFileRequest.FromString,
-                    response_serializer=file__service__pb2.File.SerializeToString,
+                    response_serializer=file__service__pb2.GetFileResponse.SerializeToString,
             ),
             'RenameFile': grpc.unary_unary_rpc_method_handler(
                     servicer.RenameFile,
@@ -370,6 +418,87 @@ class FileService(object):
             metadata,
             _registered_method=True)
 
+    @staticmethod
+    def BatchGenerateDownloadUrl(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/file.FileService/BatchGenerateDownloadUrl',
+            file__service__pb2.BatchDownloadUrlRequest.SerializeToString,
+            file__service__pb2.BatchDownloadUrlResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def GetGcsUrl(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/file.FileService/GetGcsUrl',
+            file__service__pb2.GetGcsUrlRequest.SerializeToString,
+            file__service__pb2.GetGcsUrlResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def BatchGetGcsUrl(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/file.FileService/BatchGetGcsUrl',
+            file__service__pb2.BatchGetGcsUrlRequest.SerializeToString,
+            file__service__pb2.BatchGetGcsUrlResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
     @staticmethod
     def GenerateShareLink(request,
             target,
@@ -440,7 +569,7 @@ class FileService(object):
             target,
             '/file.FileService/GetFile',
             file__service__pb2.GetFileRequest.SerializeToString,
-            file__service__pb2.File.FromString,
+            file__service__pb2.GetFileResponse.FromString,
             options,
             channel_credentials,
             insecure,

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

@@ -13,9 +13,12 @@ service FileService {
     rpc GenerateResumableUploadUrl (UploadUrlRequest) returns (UploadUrlResponse);
     rpc ConfirmUploadCompleted (UploadCompletedRequest) returns (Empty);
     rpc GenerateDownloadUrl (DownloadUrlRequest) returns (DownloadUrlResponse);
+    rpc BatchGenerateDownloadUrl (BatchDownloadUrlRequest) returns (BatchDownloadUrlResponse);
+    rpc GetGcsUrl (GetGcsUrlRequest) returns (GetGcsUrlResponse);
+    rpc BatchGetGcsUrl (BatchGetGcsUrlRequest) returns (BatchGetGcsUrlResponse);
     rpc GenerateShareLink (ShareLinkRequest) returns (ShareLinkResponse);
     rpc VisitFile (FileVisitRequest) returns (Empty);
-    rpc GetFile (GetFileRequest) returns (File);
+    rpc GetFile (GetFileRequest) returns (GetFileResponse);
     rpc RenameFile (RenameFileRequest) returns (File);
     rpc DeleteFile (DeleteFileRequest) returns (Empty);
     rpc ListFiles (ListFilesRequest) returns (FileListResponse);
@@ -120,6 +123,20 @@ message ListFilesRequest {
     optional int32 page = 7;
 }
 
+message BatchDownloadUrlRequest {
+    repeated string file_ids = 1;
+    optional bool is_cdn = 2;
+    optional int32 expire_seconds = 3;
+}
+
+message GetGcsUrlRequest {
+    string file_id = 1;
+}
+
+message BatchGetGcsUrlRequest {
+    repeated string file_ids = 1;
+}
+
 // ========= 响应结构 =========
 
 message UploadFileResponse {
@@ -145,4 +162,33 @@ message FileListResponse {
     repeated File files = 1;
 }
 
+message GetFileResponse {
+    File file = 1;
+    optional UploadFile upload_file = 2;
+}
+
+message BatchDownloadUrlResponse {
+    repeated DownloadUrlInfo download_urls = 1;
+}
+
+message DownloadUrlInfo {
+    string file_id = 1;
+    string url = 2;
+    optional string error = 3;
+}
+
+message GetGcsUrlResponse {
+    string gcs_url = 1;
+}
+
+message BatchGetGcsUrlResponse {
+    repeated GcsUrlInfo gcs_urls = 1;
+}
+
+message GcsUrlInfo {
+    string file_id = 1;
+    string gcs_url = 2;
+    optional string error = 3;
+}
+
 message Empty {}

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

@@ -10,6 +10,11 @@ from .file import (
     FileVisitRequest,
     FileListRequest,
     FileListResponse,
+    GetFileResponse,
+    DownloadUrlInfo,
+    BatchDownloadUrlResponse,
+    GcsUrlInfo,
+    BatchGcsUrlResponse,
 )
 from .folder import (
     FolderInfo,
@@ -61,6 +66,11 @@ __all__ = [
     "FileVisitRequest",
     "FileListRequest",
     "FileListResponse",
+    "GetFileResponse",
+    "DownloadUrlInfo",
+    "BatchDownloadUrlResponse",
+    "GcsUrlInfo",
+    "BatchGcsUrlResponse",
 
     # 文件夹相关
     "FolderInfo",

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

@@ -87,3 +87,33 @@ class FileListRequest(BaseModel):
 class FileListResponse(BaseModel):
     """文件列表响应"""
     files: List[File] = Field(default_factory=list, description="文件列表")
+
+
+class GetFileResponse(BaseModel):
+    """获取文件响应"""
+    file: File = Field(..., description="文件信息")
+    upload_file: Optional[UploadFile] = Field(None, description="上传文件信息")
+
+
+class DownloadUrlInfo(BaseModel):
+    """下载URL信息"""
+    file_id: str = Field(..., description="文件ID")
+    url: str = Field(..., description="下载URL")
+    error: Optional[str] = Field(None, description="错误信息")
+
+
+class BatchDownloadUrlResponse(BaseModel):
+    """批量下载URL响应"""
+    download_urls: List[DownloadUrlInfo] = Field(default_factory=list, description="下载URL列表")
+
+
+class GcsUrlInfo(BaseModel):
+    """GCS URL信息"""
+    file_id: str = Field(..., description="文件ID")
+    gcs_url: str = Field(..., description="GCS URL")
+    error: Optional[str] = Field(None, description="错误信息")
+
+
+class BatchGcsUrlResponse(BaseModel):
+    """批量GCS URL响应"""
+    gcs_urls: List[GcsUrlInfo] = Field(default_factory=list, description="GCS URL列表")

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

@@ -5,13 +5,13 @@ import asyncio
 import hashlib
 
 from pathlib import Path
-from typing import Optional, Union, BinaryIO, AsyncIterator
+from typing import Optional, Union, BinaryIO, AsyncIterator, List
 
 from .base_file_service import BaseFileService
 from ...enums import UploadMode
 from ...errors import ValidationError
 from ...rpc import AsyncGrpcClient
-from ...schemas import FileUploadResponse, UploadUrlResponse
+from ...schemas import FileUploadResponse, UploadUrlResponse, BatchDownloadUrlResponse, DownloadUrlInfo, GcsUrlInfo, BatchGcsUrlResponse
 from ...utils import AsyncHttpUploader, AsyncHttpDownloader, retry_with_backoff, get_file_mime_type
 
 
@@ -568,3 +568,122 @@ class AsyncBlobService(BaseFileService):
             save_path=save_path,
             chunk_size=chunk_size,
         )
+
+    async def batch_generate_download_url(
+            self,
+            file_ids: List[str],
+            *,
+            is_cdn: Optional[bool] = True,
+            expire_seconds: Optional[int] = None,
+            request_id: Optional[str] = None,
+            **metadata
+    ) -> BatchDownloadUrlResponse:
+        """
+        批量生成下载URL
+
+        Args:
+            file_ids: 文件ID列表
+            is_cdn: 是否返回CDN的URL
+            expire_seconds: 过期时间（秒）
+            request_id: 请求ID（可选，如果不提供则自动生成）
+            **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
+
+        Returns:
+            批量下载URL响应
+        """
+        from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+
+        stub = await self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
+
+        request = file_service_pb2.BatchDownloadUrlRequest(
+            file_ids=file_ids,
+            is_cdn=is_cdn,
+            expire_seconds=expire_seconds if expire_seconds else None
+        )
+
+        # 构建元数据
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
+
+        response = await stub.BatchGenerateDownloadUrl(request, metadata=grpc_metadata)
+
+        # 转换响应
+        download_urls = []
+        for url_info in response.download_urls:
+            download_urls.append(DownloadUrlInfo(
+                file_id=url_info.file_id,
+                url=url_info.url,
+                error=url_info.error if url_info.HasField('error') else None
+            ))
+
+        return BatchDownloadUrlResponse(download_urls=download_urls)
+
+    async def get_gcs_url(
+            self,
+            file_id: str,
+            *,
+            request_id: Optional[str] = None,
+            **metadata
+    ) -> str:
+        """
+        获取文件的GCS URL
+
+        Args:
+            file_id: 文件ID
+            request_id: 请求ID（可选，如果不提供则自动生成）
+            **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
+
+        Returns:
+            GCS URL
+        """
+        from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+
+        stub = await self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
+
+        request = file_service_pb2.GetGcsUrlRequest(file_id=file_id)
+
+        # 构建元数据
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
+
+        response = await stub.GetGcsUrl(request, metadata=grpc_metadata)
+
+        return response.gcs_url
+
+    async def batch_get_gcs_url(
+            self,
+            file_ids: List[str],
+            *,
+            request_id: Optional[str] = None,
+            **metadata
+    ) -> BatchGcsUrlResponse:
+        """
+        批量获取文件的GCS URL
+
+        Args:
+            file_ids: 文件ID列表
+            request_id: 请求ID（可选，如果不提供则自动生成）
+            **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
+
+        Returns:
+            批量GCS URL响应
+        """
+        from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+
+        stub = await self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
+
+        request = file_service_pb2.BatchGetGcsUrlRequest(file_ids=file_ids)
+
+        # 构建元数据
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
+
+        response = await stub.BatchGetGcsUrl(request, metadata=grpc_metadata)
+
+        # 转换响应
+        gcs_urls = []
+        for url_info in response.gcs_urls:
+            gcs_urls.append(GcsUrlInfo(
+                file_id=url_info.file_id,
+                gcs_url=url_info.gcs_url,
+                error=url_info.error if url_info.HasField('error') else None
+            ))
+
+        return BatchGcsUrlResponse(gcs_urls=gcs_urls)

{tamar_file_hub_client-0.0.12 → tamar_file_hub_client-0.1.1}/file_hub_client/services/file/async_file_service.py

@@ -11,6 +11,7 @@ from ...rpc.async_client import AsyncGrpcClient
 from ...schemas import (
     File,
     FileListResponse,
+    GetFileResponse,
 )
 from ...errors import FileNotFoundError
 
@@ -120,7 +121,7 @@ class AsyncFileService(BaseFileService):
         await stub.VisitFile(request, metadata=grpc_metadata)
 
     async def get_file(self, file_id: str, request_id: Optional[str] = None,
-                       **metadata) -> File:
+                       **metadata) -> GetFileResponse:
         """
         获取文件信息
         
@@ -129,9 +130,10 @@ class AsyncFileService(BaseFileService):
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
             
         Returns:
-            文件信息
+            文件信息响应，包含文件信息和上传文件信息
         """
         from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+        from ...schemas.file import GetFileResponse
 
         stub = await self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
 
@@ -142,7 +144,16 @@ class AsyncFileService(BaseFileService):
 
         try:
             response = await stub.GetFile(request, metadata=grpc_metadata)
-            return self._convert_file_info(response)
+            
+            # 转换文件信息
+            file_info = self._convert_file_info(response.file)
+            
+            # 转换上传文件信息（如果存在）
+            upload_file_info = None
+            if response.HasField('upload_file'):
+                upload_file_info = self._convert_upload_file_info(response.upload_file)
+            
+            return GetFileResponse(file=file_info, upload_file=upload_file_info)
         except grpc.RpcError as e:
             if e.code() == grpc.StatusCode.NOT_FOUND:
                 raise FileNotFoundError(file_id)

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

@@ -3,13 +3,13 @@
 """
 import hashlib
 from pathlib import Path
-from typing import Optional, Union, BinaryIO, Iterator
+from typing import Optional, Union, BinaryIO, Iterator, List
 
 from .base_file_service import BaseFileService
 from ...enums import UploadMode
 from ...errors import ValidationError
 from ...rpc import SyncGrpcClient
-from ...schemas import FileUploadResponse, UploadUrlResponse
+from ...schemas import FileUploadResponse, UploadUrlResponse, BatchDownloadUrlResponse, DownloadUrlInfo, GcsUrlInfo, BatchGcsUrlResponse
 from ...utils import HttpUploader, HttpDownloader, retry_with_backoff, get_file_mime_type
 
 
@@ -565,3 +565,122 @@ class SyncBlobService(BaseFileService):
             save_path=save_path,
             chunk_size=chunk_size,
         )
+
+    def batch_generate_download_url(
+            self,
+            file_ids: List[str],
+            *,
+            is_cdn: Optional[bool] = True,
+            expire_seconds: Optional[int] = None,
+            request_id: Optional[str] = None,
+            **metadata
+    ) -> BatchDownloadUrlResponse:
+        """
+        批量生成下载URL
+
+        Args:
+            file_ids: 文件ID列表
+            is_cdn: 是否返回CDN的URL
+            expire_seconds: 过期时间（秒）
+            request_id: 请求ID（可选，如果不提供则自动生成）
+            **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
+
+        Returns:
+            批量下载URL响应
+        """
+        from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+
+        stub = self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
+
+        request = file_service_pb2.BatchDownloadUrlRequest(
+            file_ids=file_ids,
+            is_cdn=is_cdn,
+            expire_seconds=expire_seconds if expire_seconds else None
+        )
+
+        # 构建元数据
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
+
+        response = stub.BatchGenerateDownloadUrl(request, metadata=grpc_metadata)
+
+        # 转换响应
+        download_urls = []
+        for url_info in response.download_urls:
+            download_urls.append(DownloadUrlInfo(
+                file_id=url_info.file_id,
+                url=url_info.url,
+                error=url_info.error if url_info.HasField('error') else None
+            ))
+
+        return BatchDownloadUrlResponse(download_urls=download_urls)
+
+    def get_gcs_url(
+            self,
+            file_id: str,
+            *,
+            request_id: Optional[str] = None,
+            **metadata
+    ) -> str:
+        """
+        获取文件的GCS URL
+
+        Args:
+            file_id: 文件ID
+            request_id: 请求ID（可选，如果不提供则自动生成）
+            **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
+
+        Returns:
+            GCS URL
+        """
+        from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+
+        stub = self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
+
+        request = file_service_pb2.GetGcsUrlRequest(file_id=file_id)
+
+        # 构建元数据
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
+
+        response = stub.GetGcsUrl(request, metadata=grpc_metadata)
+
+        return response.gcs_url
+
+    def batch_get_gcs_url(
+            self,
+            file_ids: List[str],
+            *,
+            request_id: Optional[str] = None,
+            **metadata
+    ) -> BatchGcsUrlResponse:
+        """
+        批量获取文件的GCS URL
+
+        Args:
+            file_ids: 文件ID列表
+            request_id: 请求ID（可选，如果不提供则自动生成）
+            **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
+
+        Returns:
+            批量GCS URL响应
+        """
+        from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+
+        stub = self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
+
+        request = file_service_pb2.BatchGetGcsUrlRequest(file_ids=file_ids)
+
+        # 构建元数据
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
+
+        response = stub.BatchGetGcsUrl(request, metadata=grpc_metadata)
+
+        # 转换响应
+        gcs_urls = []
+        for url_info in response.gcs_urls:
+            gcs_urls.append(GcsUrlInfo(
+                file_id=url_info.file_id,
+                gcs_url=url_info.gcs_url,
+                error=url_info.error if url_info.HasField('error') else None
+            ))
+
+        return BatchGcsUrlResponse(gcs_urls=gcs_urls)

{tamar_file_hub_client-0.0.12 → tamar_file_hub_client-0.1.1}/file_hub_client/services/file/sync_file_service.py

@@ -9,6 +9,7 @@ from ...rpc.sync_client import SyncGrpcClient
 from ...schemas import (
     File,
     FileListResponse,
+    GetFileResponse,
 )
 from ...errors import FileNotFoundError
 
@@ -118,7 +119,7 @@ class SyncFileService(BaseFileService):
         stub.VisitFile(request, metadata=grpc_metadata)
 
     def get_file(self, file_id: str, request_id: Optional[str] = None,
-                 **metadata) -> File:
+                 **metadata) -> GetFileResponse:
         """
         获取文件信息
         
@@ -127,9 +128,10 @@ class SyncFileService(BaseFileService):
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
             
         Returns:
-            文件信息
+            文件信息响应，包含文件信息和上传文件信息
         """
         from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+        from ...schemas.file import GetFileResponse
 
         stub = self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
 
@@ -140,7 +142,16 @@ class SyncFileService(BaseFileService):
 
         try:
             response = stub.GetFile(request, metadata=grpc_metadata)
-            return self._convert_file_info(response)
+            
+            # 转换文件信息
+            file_info = self._convert_file_info(response.file)
+            
+            # 转换上传文件信息（如果存在）
+            upload_file_info = None
+            if response.HasField('upload_file'):
+                upload_file_info = self._convert_upload_file_info(response.upload_file)
+            
+            return GetFileResponse(file=file_info, upload_file=upload_file_info)
         except grpc.RpcError as e:
             if e.code() == grpc.StatusCode.NOT_FOUND:
                 raise FileNotFoundError(file_id)

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

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="tamar-file-hub-client",
-    version="0.0.12",
+    version="0.1.1",
     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.0.12 → tamar_file_hub_client-0.1.1}/tamar_file_hub_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tamar-file-hub-client
-Version: 0.0.12
+Version: 0.1.1
 Summary: A Python SDK for gRPC-based file management system
 Home-page: https://github.com/Tamar-Edge-AI/file-hub-client
 Author: Oscar Ou
@@ -695,11 +695,23 @@ async with AsyncTamarFileHubClient() as client:
     # 设置用户上下文
     client.set_user_context(org_id="123", user_id="456")
     
-    # 获取文件详细信息
-    file_info = await client.files.get_file(file_id="file-001")
+    # 获取文件详细信息（返回 GetFileResponse 对象）
+    response = await client.files.get_file(file_id="file-001")
+    
+    # 访问文件基本信息
+    file_info = response.file
+    print(f"文件ID: {file_info.id}")
     print(f"文件名: {file_info.file_name}")
-    print(f"文件大小: {file_info.file_size} bytes")
+    print(f"文件类型: {file_info.file_type}")
     print(f"创建时间: {file_info.created_at}")
+    
+    # 访问上传文件详细信息（如果存在）
+    if response.upload_file:
+        upload_info = response.upload_file
+        print(f"文件大小: {upload_info.file_size} bytes")
+        print(f"MIME类型: {upload_info.mime_type}")
+        print(f"存储类型: {upload_info.storage_type}")
+        print(f"存储路径: {upload_info.stored_path}")
 ```
 
 #### 重命名文件
@@ -1622,10 +1634,12 @@ folder = await client.folders.create_folder(
 
 # 同步客户端同样支持
 sync_client = TamarFileHubClient(user_context=user_context)
-file_info = sync_client.files.get_file(
+response = sync_client.files.get_file(
     file_id="file-123",
     request_id="debug-get-file-001"
 )
+# response.file 包含文件基本信息
+# response.upload_file 包含上传文件详细信息（可能为None）
 ```
 
 #### 请求ID优先级
@@ -1679,7 +1693,8 @@ await minimal_client.taples.create_table(name="auto_generated")
 - 所有批量操作方法
 
 **文件服务**：
-- `get_file()`, `rename_file()`, `delete_file()`, `list_files()`
+- `get_file()` - 返回 `GetFileResponse` 对象，包含 `file` 和 `upload_file` 信息
+- `rename_file()`, `delete_file()`, `list_files()`
 - `generate_share_link()`, `visit_file()`
 
 **文件夹服务**：