tamar-file-hub-client 0.1.3__py3-none-any.whl → 0.1.4__py3-none-any.whl

file_hub_client/client.py

@@ -157,7 +157,7 @@ class AsyncTamarFileHubClient:
             self._taple_service = AsyncTapleService(self._client)
         return self._taple_service
 
-    def set_user_context(self, org_id: str, user_id: str, role: Role = Role.ACCOUNT, actor_id: Optional[str] = None):
+    def set_user_context(self, org_id: str, user_id: str, role: Role = Role.ACCOUNT, actor_id: Optional[str] = None, user_ip: Optional[str] = None):
         """
         设置用户上下文信息
         
@@ -166,8 +166,18 @@ class AsyncTamarFileHubClient:
             user_id: 用户ID
             role: 用户角色（默认为 ACCOUNT）
             actor_id: 操作者ID（如果不同于 user_id）
+            user_ip: 用户IP地址（实际请求用户的IP，如前端用户的IP）
         """
-        self._client.set_user_context(org_id, user_id, role, actor_id)
+        self._client.set_user_context(org_id, user_id, role, actor_id, user_ip)
+
+    def set_user_ip(self, user_ip: Optional[str]):
+        """
+        设置或更新用户IP地址
+        
+        Args:
+            user_ip: 用户IP地址（实际请求用户的IP，如前端用户的IP）
+        """
+        self._client.set_user_ip(user_ip)
 
     def get_user_context(self) -> Optional[UserContext]:
         """获取当前用户上下文"""
@@ -364,7 +374,7 @@ class TamarFileHubClient:
             self._taple_service = SyncTapleService(self._client)
         return self._taple_service
 
-    def set_user_context(self, org_id: str, user_id: str, role: Role = Role.ACCOUNT, actor_id: Optional[str] = None):
+    def set_user_context(self, org_id: str, user_id: str, role: Role = Role.ACCOUNT, actor_id: Optional[str] = None, user_ip: Optional[str] = None):
         """
         设置用户上下文信息
 
@@ -373,8 +383,18 @@ class TamarFileHubClient:
             user_id: 用户ID
             role: 用户角色（默认为 ACCOUNT）
             actor_id: 操作者ID（如果不同于 user_id）
+            user_ip: 用户IP地址（实际请求用户的IP，如前端用户的IP）
+        """
+        self._client.set_user_context(org_id, user_id, role, actor_id, user_ip)
+
+    def set_user_ip(self, user_ip: Optional[str]):
+        """
+        设置或更新用户IP地址
+
+        Args:
+            user_ip: 用户IP地址（实际请求用户的IP，如前端用户的IP）
         """
-        self._client.set_user_context(org_id, user_id, role, actor_id)
+        self._client.set_user_ip(user_ip)
 
     def get_user_context(self) -> Optional[UserContext]:
         """获取当前用户上下文"""

file_hub_client/rpc/async_client.py

@@ -281,8 +281,17 @@ class AsyncGrpcClient:
         # 添加默认元数据
         metadata.update(self.default_metadata)
 
-        # 添加/覆盖传入的元数据
-        metadata.update(kwargs)
+        # 自动检测用户真实IP
+        from ..utils.ip_detector import get_current_user_ip
+        auto_detected_ip = get_current_user_ip()
+        if auto_detected_ip and 'x-user-ip' not in metadata:
+            # 只有在没有设置过user_ip的情况下才使用自动检测的IP
+            metadata['x-user-ip'] = auto_detected_ip
+
+        # 添加/覆盖传入的元数据，但跳过None值以避免覆盖有效的默认值
+        for k, v in kwargs.items():
+            if v is not None:
+                metadata[k] = v
 
         # 处理 request_id（优先级：显式传入 > metadata中的x-request-id > RequestContext > 自动生成）
         if request_id is not None:
@@ -314,7 +323,7 @@ class AsyncGrpcClient:
         """
         self.default_metadata.update(kwargs)
 
-    def set_user_context(self, org_id: str, user_id: str, role: Role = Role.ACCOUNT, actor_id: Optional[str] = None):
+    def set_user_context(self, org_id: str, user_id: str, role: Role = Role.ACCOUNT, actor_id: Optional[str] = None, user_ip: Optional[str] = None):
         """
         设置用户上下文信息
         
@@ -323,16 +332,34 @@ class AsyncGrpcClient:
             user_id: 用户ID
             role: 用户角色（默认为 ACCOUNT）
             actor_id: 操作者ID（如果不同于 user_id）
+            user_ip: 用户IP地址（实际请求用户的IP，如前端用户的IP）
         """
         self._user_context = UserContext(
             org_id=org_id,
             user_id=user_id,
             role=role,
-            actor_id=actor_id
+            actor_id=actor_id,
+            user_ip=user_ip
         )
         # 更新到默认元数据
         self.update_default_metadata(**self._user_context.to_metadata())
 
+    def set_user_ip(self, user_ip: Optional[str]):
+        """
+        设置或更新用户IP地址
+        
+        Args:
+            user_ip: 用户IP地址（实际请求用户的IP，如前端用户的IP）
+        """
+        if self._user_context:
+            self._user_context.user_ip = user_ip
+            # 先移除旧的x-user-ip（如果存在）
+            self.default_metadata.pop('x-user-ip', None)
+            # 更新到默认元数据（只有非None值会被添加）
+            self.update_default_metadata(**self._user_context.to_metadata())
+        else:
+            raise ValueError("必须先调用 set_user_context 设置用户上下文，然后才能设置用户IP")
+
     def get_user_context(self) -> Optional[UserContext]:
         """获取当前用户上下文"""
         return self._user_context

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\"\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')
+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\"+\n\x18\x43ompressionStatusRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"\x84\x01\n\x19\x43ompressionStatusResponse\x12\x0e\n\x06status\x18\x01 \x01(\t\x12\x1a\n\rerror_message\x18\x02 \x01(\tH\x00\x88\x01\x01\x12)\n\x08variants\x18\x03 \x03(\x0b\x32\x17.file.CompressedVariantB\x10\n\x0e_error_message\"Q\n\x12GetVariantsRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x19\n\x0cvariant_type\x18\x02 \x01(\tH\x00\x88\x01\x01\x42\x0f\n\r_variant_type\"@\n\x13GetVariantsResponse\x12)\n\x08variants\x18\x01 \x03(\x0b\x32\x17.file.CompressedVariant\"\xc7\x02\n\x11\x43ompressedVariant\x12\x14\n\x0cvariant_name\x18\x01 \x01(\t\x12\x14\n\x0cvariant_type\x18\x02 \x01(\t\x12\x12\n\nmedia_type\x18\x03 \x01(\t\x12\r\n\x05width\x18\x04 \x01(\x05\x12\x0e\n\x06height\x18\x05 \x01(\x05\x12\x11\n\tfile_size\x18\x06 \x01(\x03\x12\x0e\n\x06\x66ormat\x18\x07 \x01(\t\x12\x14\n\x07quality\x18\x08 \x01(\x05H\x00\x88\x01\x01\x12\x15\n\x08\x64uration\x18\t \x01(\x01H\x01\x88\x01\x01\x12\x14\n\x07\x62itrate\x18\n \x01(\x03H\x02\x88\x01\x01\x12\x10\n\x03\x66ps\x18\x0b \x01(\x05H\x03\x88\x01\x01\x12\x19\n\x11\x63ompression_ratio\x18\x0c \x01(\x01\x12\x13\n\x0bstored_path\x18\r \x01(\tB\n\n\x08_qualityB\x0b\n\t_durationB\n\n\x08_bitrateB\x06\n\x04_fps\"Y\n\x14RecompressionRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x1c\n\x0f\x66orce_reprocess\x18\x02 \x01(\x08H\x00\x88\x01\x01\x42\x12\n\x10_force_reprocess\"8\n\x15RecompressionResponse\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0e\n\x06status\x18\x02 \x01(\t\"\x92\x01\n\x19VariantDownloadUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x14\n\x0cvariant_name\x18\x02 \x01(\t\x12\x1b\n\x0e\x65xpire_seconds\x18\x03 \x01(\x05H\x00\x88\x01\x01\x12\x13\n\x06is_cdn\x18\x04 \x01(\x08H\x01\x88\x01\x01\x42\x11\n\x0f_expire_secondsB\t\n\x07_is_cdn\"\x8c\x01\n\x1aVariantDownloadUrlResponse\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x12\n\x05\x65rror\x18\x02 \x01(\tH\x00\x88\x01\x01\x12\x32\n\x0cvariant_info\x18\x03 \x01(\x0b\x32\x17.file.CompressedVariantH\x01\x88\x01\x01\x42\x08\n\x06_errorB\x0f\n\r_variant_info\"\x07\n\x05\x45mpty2\x87\n\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.FileListResponse\x12W\n\x14GetCompressionStatus\x12\x1e.file.CompressionStatusRequest\x1a\x1f.file.CompressionStatusResponse\x12L\n\x15GetCompressedVariants\x12\x18.file.GetVariantsRequest\x1a\x19.file.GetVariantsResponse\x12O\n\x14TriggerRecompression\x12\x1a.file.RecompressionRequest\x1a\x1b.file.RecompressionResponse\x12_\n\x1aGenerateVariantDownloadUrl\x12\x1f.file.VariantDownloadUrlRequest\x1a .file.VariantDownloadUrlResponseb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -85,8 +85,26 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _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
+  _globals['_COMPRESSIONSTATUSREQUEST']._serialized_start=3082
+  _globals['_COMPRESSIONSTATUSREQUEST']._serialized_end=3125
+  _globals['_COMPRESSIONSTATUSRESPONSE']._serialized_start=3128
+  _globals['_COMPRESSIONSTATUSRESPONSE']._serialized_end=3260
+  _globals['_GETVARIANTSREQUEST']._serialized_start=3262
+  _globals['_GETVARIANTSREQUEST']._serialized_end=3343
+  _globals['_GETVARIANTSRESPONSE']._serialized_start=3345
+  _globals['_GETVARIANTSRESPONSE']._serialized_end=3409
+  _globals['_COMPRESSEDVARIANT']._serialized_start=3412
+  _globals['_COMPRESSEDVARIANT']._serialized_end=3739
+  _globals['_RECOMPRESSIONREQUEST']._serialized_start=3741
+  _globals['_RECOMPRESSIONREQUEST']._serialized_end=3830
+  _globals['_RECOMPRESSIONRESPONSE']._serialized_start=3832
+  _globals['_RECOMPRESSIONRESPONSE']._serialized_end=3888
+  _globals['_VARIANTDOWNLOADURLREQUEST']._serialized_start=3891
+  _globals['_VARIANTDOWNLOADURLREQUEST']._serialized_end=4037
+  _globals['_VARIANTDOWNLOADURLRESPONSE']._serialized_start=4040
+  _globals['_VARIANTDOWNLOADURLRESPONSE']._serialized_end=4180
+  _globals['_EMPTY']._serialized_start=4182
+  _globals['_EMPTY']._serialized_end=4189
+  _globals['_FILESERVICE']._serialized_start=4192
+  _globals['_FILESERVICE']._serialized_end=5479
 # @@protoc_insertion_point(module_scope)

file_hub_client/rpc/gen/file_service_pb2_grpc.py

@@ -106,6 +106,26 @@ class FileServiceStub(object):
                 request_serializer=file__service__pb2.ListFilesRequest.SerializeToString,
                 response_deserializer=file__service__pb2.FileListResponse.FromString,
                 _registered_method=True)
+        self.GetCompressionStatus = channel.unary_unary(
+                '/file.FileService/GetCompressionStatus',
+                request_serializer=file__service__pb2.CompressionStatusRequest.SerializeToString,
+                response_deserializer=file__service__pb2.CompressionStatusResponse.FromString,
+                _registered_method=True)
+        self.GetCompressedVariants = channel.unary_unary(
+                '/file.FileService/GetCompressedVariants',
+                request_serializer=file__service__pb2.GetVariantsRequest.SerializeToString,
+                response_deserializer=file__service__pb2.GetVariantsResponse.FromString,
+                _registered_method=True)
+        self.TriggerRecompression = channel.unary_unary(
+                '/file.FileService/TriggerRecompression',
+                request_serializer=file__service__pb2.RecompressionRequest.SerializeToString,
+                response_deserializer=file__service__pb2.RecompressionResponse.FromString,
+                _registered_method=True)
+        self.GenerateVariantDownloadUrl = channel.unary_unary(
+                '/file.FileService/GenerateVariantDownloadUrl',
+                request_serializer=file__service__pb2.VariantDownloadUrlRequest.SerializeToString,
+                response_deserializer=file__service__pb2.VariantDownloadUrlResponse.FromString,
+                _registered_method=True)
 
 
 class FileServiceServicer(object):
@@ -197,6 +217,31 @@ class FileServiceServicer(object):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def GetCompressionStatus(self, request, context):
+        """压缩服务相关API
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def GetCompressedVariants(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 TriggerRecompression(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 GenerateVariantDownloadUrl(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 add_FileServiceServicer_to_server(servicer, server):
     rpc_method_handlers = {
@@ -270,6 +315,26 @@ def add_FileServiceServicer_to_server(servicer, server):
                     request_deserializer=file__service__pb2.ListFilesRequest.FromString,
                     response_serializer=file__service__pb2.FileListResponse.SerializeToString,
             ),
+            'GetCompressionStatus': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetCompressionStatus,
+                    request_deserializer=file__service__pb2.CompressionStatusRequest.FromString,
+                    response_serializer=file__service__pb2.CompressionStatusResponse.SerializeToString,
+            ),
+            'GetCompressedVariants': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetCompressedVariants,
+                    request_deserializer=file__service__pb2.GetVariantsRequest.FromString,
+                    response_serializer=file__service__pb2.GetVariantsResponse.SerializeToString,
+            ),
+            'TriggerRecompression': grpc.unary_unary_rpc_method_handler(
+                    servicer.TriggerRecompression,
+                    request_deserializer=file__service__pb2.RecompressionRequest.FromString,
+                    response_serializer=file__service__pb2.RecompressionResponse.SerializeToString,
+            ),
+            'GenerateVariantDownloadUrl': grpc.unary_unary_rpc_method_handler(
+                    servicer.GenerateVariantDownloadUrl,
+                    request_deserializer=file__service__pb2.VariantDownloadUrlRequest.FromString,
+                    response_serializer=file__service__pb2.VariantDownloadUrlResponse.SerializeToString,
+            ),
     }
     generic_handler = grpc.method_handlers_generic_handler(
             'file.FileService', rpc_method_handlers)
@@ -660,3 +725,111 @@ class FileService(object):
             timeout,
             metadata,
             _registered_method=True)
+
+    @staticmethod
+    def GetCompressionStatus(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/GetCompressionStatus',
+            file__service__pb2.CompressionStatusRequest.SerializeToString,
+            file__service__pb2.CompressionStatusResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def GetCompressedVariants(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/GetCompressedVariants',
+            file__service__pb2.GetVariantsRequest.SerializeToString,
+            file__service__pb2.GetVariantsResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def TriggerRecompression(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/TriggerRecompression',
+            file__service__pb2.RecompressionRequest.SerializeToString,
+            file__service__pb2.RecompressionResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def GenerateVariantDownloadUrl(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/GenerateVariantDownloadUrl',
+            file__service__pb2.VariantDownloadUrlRequest.SerializeToString,
+            file__service__pb2.VariantDownloadUrlResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

file_hub_client/rpc/protos/file_service.proto

@@ -22,6 +22,12 @@ service FileService {
     rpc RenameFile (RenameFileRequest) returns (File);
     rpc DeleteFile (DeleteFileRequest) returns (Empty);
     rpc ListFiles (ListFilesRequest) returns (FileListResponse);
+    
+    // 压缩服务相关API
+    rpc GetCompressionStatus (CompressionStatusRequest) returns (CompressionStatusResponse);
+    rpc GetCompressedVariants (GetVariantsRequest) returns (GetVariantsResponse);
+    rpc TriggerRecompression (RecompressionRequest) returns (RecompressionResponse);
+    rpc GenerateVariantDownloadUrl (VariantDownloadUrlRequest) returns (VariantDownloadUrlResponse);
 }
 
 // ========= 数据结构定义 =========
@@ -195,4 +201,64 @@ message GcsUrlInfo {
     optional string error = 4;
 }
 
+// ========= 压缩服务相关结构 =========
+
+message CompressionStatusRequest {
+    string file_id = 1;
+}
+
+message CompressionStatusResponse {
+    string status = 1;  // pending, processing, completed, failed
+    optional string error_message = 2;
+    repeated CompressedVariant variants = 3;
+}
+
+message GetVariantsRequest {
+    string file_id = 1;
+    optional string variant_type = 2;  // image, video, thumbnail
+}
+
+message GetVariantsResponse {
+    repeated CompressedVariant variants = 1;
+}
+
+message CompressedVariant {
+    string variant_name = 1;
+    string variant_type = 2;
+    string media_type = 3;
+    int32 width = 4;
+    int32 height = 5;
+    int64 file_size = 6;
+    string format = 7;
+    optional int32 quality = 8;
+    optional double duration = 9;
+    optional int64 bitrate = 10;
+    optional int32 fps = 11;
+    double compression_ratio = 12;
+    string stored_path = 13;
+}
+
+message RecompressionRequest {
+    string file_id = 1;
+    optional bool force_reprocess = 2;
+}
+
+message RecompressionResponse {
+    string task_id = 1;
+    string status = 2;
+}
+
+message VariantDownloadUrlRequest {
+    string file_id = 1;
+    string variant_name = 2;  // large/medium/small/thumbnail
+    optional int32 expire_seconds = 3;
+    optional bool is_cdn = 4;
+}
+
+message VariantDownloadUrlResponse {
+    string url = 1;
+    optional string error = 2;
+    optional CompressedVariant variant_info = 3;  // 返回变体详细信息
+}
+
 message Empty {}

file_hub_client/rpc/sync_client.py

@@ -284,8 +284,17 @@ class SyncGrpcClient:
         # 添加默认元数据
         metadata.update(self.default_metadata)
 
-        # 添加/覆盖传入的元数据
-        metadata.update(kwargs)
+        # 自动检测用户真实IP
+        from ..utils.ip_detector import get_current_user_ip
+        auto_detected_ip = get_current_user_ip()
+        if auto_detected_ip and 'x-user-ip' not in metadata:
+            # 只有在没有设置过user_ip的情况下才使用自动检测的IP
+            metadata['x-user-ip'] = auto_detected_ip
+
+        # 添加/覆盖传入的元数据，但跳过None值以避免覆盖有效的默认值
+        for k, v in kwargs.items():
+            if v is not None:
+                metadata[k] = v
 
         # 处理 request_id（优先级：显式传入 > metadata中的x-request-id > RequestContext > 自动生成）
         if request_id is not None:
@@ -317,7 +326,7 @@ class SyncGrpcClient:
         """
         self.default_metadata.update(kwargs)
 
-    def set_user_context(self, org_id: str, user_id: str, role: Role = Role.ACCOUNT, actor_id: Optional[str] = None):
+    def set_user_context(self, org_id: str, user_id: str, role: Role = Role.ACCOUNT, actor_id: Optional[str] = None, user_ip: Optional[str] = None):
         """
         设置用户上下文信息
         
@@ -326,16 +335,34 @@ class SyncGrpcClient:
             user_id: 用户ID
             role: 用户角色（默认为 ACCOUNT）
             actor_id: 操作者ID（如果不同于 user_id）
+            user_ip: 用户IP地址（实际请求用户的IP，如前端用户的IP）
         """
         self._user_context = UserContext(
             org_id=org_id,
             user_id=user_id,
             role=role,
-            actor_id=actor_id
+            actor_id=actor_id,
+            user_ip=user_ip
         )
         # 更新到默认元数据
         self.update_default_metadata(**self._user_context.to_metadata())
 
+    def set_user_ip(self, user_ip: Optional[str]):
+        """
+        设置或更新用户IP地址
+        
+        Args:
+            user_ip: 用户IP地址（实际请求用户的IP，如前端用户的IP）
+        """
+        if self._user_context:
+            self._user_context.user_ip = user_ip
+            # 先移除旧的x-user-ip（如果存在）
+            self.default_metadata.pop('x-user-ip', None)
+            # 更新到默认元数据（只有非None值会被添加）
+            self.update_default_metadata(**self._user_context.to_metadata())
+        else:
+            raise ValueError("必须先调用 set_user_context 设置用户上下文，然后才能设置用户IP")
+
     def get_user_context(self) -> Optional[UserContext]:
         """获取当前用户上下文"""
         return self._user_context

file_hub_client/schemas/__init__.py

@@ -16,6 +16,11 @@ from .file import (
     GcsUrlInfo,
     GetGcsUrlResponse,
     BatchGcsUrlResponse,
+    CompressedVariant,
+    CompressionStatusResponse,
+    GetVariantsResponse,
+    RecompressionResponse,
+    VariantDownloadUrlResponse,
 )
 from .folder import (
     FolderInfo,
@@ -73,6 +78,11 @@ __all__ = [
     "GcsUrlInfo",
     "GetGcsUrlResponse",
     "BatchGcsUrlResponse",
+    "CompressedVariant",
+    "CompressionStatusResponse",
+    "GetVariantsResponse",
+    "RecompressionResponse",
+    "VariantDownloadUrlResponse",
 
     # 文件夹相关
     "FolderInfo",