scan_folder.py 1.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. """文件夹扫描工具:收集指定文件夹下所有 PDF 文件"""
  2. from __future__ import annotations
  3. import asyncio
  4. import os
  5. from backend.tools.base import Tool
  6. def _scan_folder_sync(folder_path: str) -> dict:
  7. """同步遍历文件夹收集 .pdf 文件"""
  8. pdf_files: list[str] = []
  9. for root, _dirs, files in os.walk(folder_path):
  10. for name in files:
  11. if name.lower().endswith(".pdf"):
  12. pdf_files.append(os.path.join(root, name))
  13. # 排序保证顺序稳定
  14. pdf_files.sort()
  15. return {
  16. "folder": folder_path,
  17. "pdf_files": pdf_files,
  18. "count": len(pdf_files),
  19. }
  20. async def scan_folder(folder_path: str) -> dict:
  21. """扫描文件夹,返回所有 PDF 文件路径列表。
  22. 失败时返回 {"error": "..."} 不抛异常。
  23. """
  24. try:
  25. return await asyncio.to_thread(_scan_folder_sync, folder_path)
  26. except Exception as e:
  27. return {
  28. "error": f"文件夹扫描失败: {e}",
  29. "folder": folder_path,
  30. "pdf_files": [],
  31. "count": 0,
  32. }
  33. # ---------- Tool 定义 ----------
  34. _PARAMETERS = {
  35. "type": "object",
  36. "properties": {
  37. "folder_path": {
  38. "type": "string",
  39. "description": "待扫描的文件夹绝对路径",
  40. }
  41. },
  42. "required": ["folder_path"],
  43. }
  44. scan_folder_tool = Tool(
  45. name="scan_folder",
  46. description=(
  47. "扫描指定文件夹,递归收集所有 .pdf 文件路径。"
  48. "返回 {folder, pdf_files, count}。"
  49. ),
  50. parameters=_PARAMETERS,
  51. func=scan_folder,
  52. )