"""文件管理模块 对应前端源码: api/core/common.ts + api/teamwork/document.ts """ from aibridge.client import JNPFClient from aibridge.models import APIResponse class FileAPI: """文件管理 API""" def __init__(self, client: JNPFClient): self._client = client self._doc_prefix = "/api/file/Document" # ==================== 通用文件操作 ==================== def get_download_url(self, file_type: str, file_name: str = "") -> APIResponse: """获取下载文件链接""" return self._client.request("GET", f"/api/file/Download/{file_type}/{file_name}") def get_pack_download_url(self, file_type: str, data: dict) -> APIResponse: """获取打包下载链接""" return self._client.request("POST", f"/api/file/PackDownload/{file_type}", data=data) def preview(self, data: dict) -> APIResponse: """预览文件""" return self._client.request("GET", "/api/file/Uploader/Preview", params=data) def chunk_merge(self, data: dict) -> APIResponse: """分片组装""" return self._client.request("POST", "/api/file/merge", data=data) def template_download(self, url: str, data: dict = None) -> APIResponse: """下载导入示例模板""" return self._client.request("GET", f"/api/{url}/TemplateDownload", params=data) def import_preview(self, url: str, data: dict = None) -> APIResponse: """导入预览""" return self._client.request("GET", f"/api/{url}/ImportPreview", params=data) def import_data(self, url: str, data: dict) -> APIResponse: """导入数据""" return self._client.request("POST", f"/api/{url}/ImportData", data=data) def get_import_exception_data(self, url: str, data: dict) -> APIResponse: """导出错误数据""" return self._client.request("POST", f"/api/{url}/ImportExceptionData", data=data) # ==================== 知识管理/文档管理 ==================== def get_all_list(self, data: dict = None) -> APIResponse: """获取知识管理列表(全部文档)""" return self._client.request("GET", self._doc_prefix, params=data) def create_folder(self, data: dict) -> APIResponse: """添加文件夹""" return self._client.request("POST", self._doc_prefix, data=data) def update(self, data: dict) -> APIResponse: """修改文件名/文件夹名""" doc_id = data.get("id") return self._client.request("PUT", f"{self._doc_prefix}/{doc_id}", data=data) def batch_delete(self, ids: list) -> APIResponse: """批量删除文件/文件夹""" return self._client.request("POST", f"{self._doc_prefix}/BatchDelete", data={"ids": ids}) def get_folder_tree(self, ids: list = None) -> APIResponse: """获取知识管理列表(文件夹树)""" return self._client.request("POST", f"{self._doc_prefix}/FolderTree", data={"ids": ids or []}) def get_info(self, doc_id: str) -> APIResponse: """获取文件/文件夹信息""" return self._client.request("GET", f"{self._doc_prefix}/{doc_id}") def move_to(self, to_id: str, ids: list) -> APIResponse: """批量移动文件/文件夹""" return self._client.request("PUT", f"{self._doc_prefix}/Actions/MoveTo/{to_id}", data={"ids": ids}) def share_cancel(self, ids: list) -> APIResponse: """批量取消分享""" return self._client.request("POST", f"{self._doc_prefix}/Actions/CancelShare", data={"ids": ids}) def create_share(self, ids: list, user_ids: list) -> APIResponse: """批量分享文件/文件夹""" return self._client.request("POST", f"{self._doc_prefix}/Actions/Share", data={"ids": ids, "userIds": user_ids}) def create_single_share(self, doc_id: str, user_ids: list) -> APIResponse: """单个分享文件/文件夹""" return self._client.request("POST", f"{self._doc_prefix}/Actions/ShareAdjustment/{doc_id}", data={"userIds": user_ids}) def get_share_out_list(self, data: dict = None) -> APIResponse: """获取我的共享列表""" return self._client.request("GET", f"{self._doc_prefix}/Share", params=data) def get_share_tome_list(self, data: dict = None) -> APIResponse: """获取共享给我列表""" return self._client.request("GET", f"{self._doc_prefix}/ShareTome", params=data) def get_share_user_list(self, document_id: str) -> APIResponse: """获取共享人员""" return self._client.request("GET", f"{self._doc_prefix}/ShareUser/{document_id}") # ==================== 回收站 ==================== def get_trash_list(self, data: dict = None) -> APIResponse: """获取回收站列表""" return self._client.request("GET", f"{self._doc_prefix}/Trash", params=data) def trash_delete(self, ids: list) -> APIResponse: """回收站(批量彻底删除)""" return self._client.request("POST", f"{self._doc_prefix}/Trash", data={"ids": ids}) def trash_recovery(self, ids: list) -> APIResponse: """回收站(批量还原)""" return self._client.request("POST", f"{self._doc_prefix}/Trash/Actions/Recovery", data={"ids": ids}) def pack_download(self, ids: list) -> APIResponse: """批量下载文件""" return self._client.request("POST", f"{self._doc_prefix}/PackDownload", data={"ids": ids}) def document_merge(self, data: dict) -> APIResponse: """分片组装(知识库)""" return self._client.request("POST", f"{self._doc_prefix}/merge", data=data) def upload_blob(self, data: dict) -> APIResponse: """上传 Blob(流程归档)""" return self._client.request("POST", f"{self._doc_prefix}/UploadBlob", data=data)