Files
2026-05-18 09:28:15 +08:00

133 lines
5.8 KiB
Python

"""文件管理模块
对应前端源码: 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)