SuperAPI AI 工具集

bel-open-file

通用与其它

查看项目

更新于 11-13 09:53

技能介绍

用途

bel-open-file 用于调用操作系统的默认应用程序,打开或预览磁盘上已经存在的文件。适合用户提出“打开文件”“预览文档”“查看已下载的 PDF”“显示上传的图片”等需求时使用。

主要能力

  • 打开磁盘上已有的文件,交给系统默认程序显示。
  • 支持系统中已注册默认程序的各类文件,例如:
    • 文档:.pdf、.docx、.doc、.txt、.md、.log、.rtf
    • 表格:.xlsx、.xls、.csv、.numbers
    • 图片:.png、.jpg、.jpeg、.gif、.bmp、.svg、.tif、.tiff、.webp
    • 邮件:.eml、.msg、.pst
    • 压缩包:.zip、.tar、.gz、.7z
    • 演示文稿:.pptx、.ppt、.key
  • 自动识别操作系统并调用相应命令:macOS 使用 open <file>,Linux 使用 xdg-open <file>,Windows 使用 os.startfile(<file>)。
  • 执行前校验文件是否存在,并解析为绝对路径。
  • 返回成功或错误状态。

使用方式

通过脚本传入文件路径:

python scripts/open_file.py <file_path>

示例:

# 打开 PDF
python scripts/open_file.py _RESULTS_FROM_AGENT/contract.pdf

# 打开图片
python scripts/open_file.py _DATA_FROM_USER/logo.png

# 打开表格
python scripts/open_file.py _RESULTS_FROM_AGENT/report.xlsx

# 打开邮件文件
python scripts/open_file.py _DOWNLOADS_FROM_AGENT/message.eml

# 静默模式(抑制输出)
python scripts/open_file.py document.pdf --quiet

典型流程:确认文件路径存在,然后运行脚本,文件将在默认查看器中打开。

适用场景

  • 打开用户指定的已有文件,如 contract.pdf。
  • 预览此前生成并保存的结果文件,如 _RESULTS_FROM_AGENT/report.xlsx。
  • 查看用户上传的数据,如 _DATA_FROM_USER/logo.png。
  • 打开已下载的邮件附件或 .eml/.msg 邮件文件。

限制

  • 仅适用于磁盘上已存在的文件;文件尚不存在时不适用。
  • 如果文件需要先从数据库下载,应改用 bel-download-file-from-crm-db。
  • 如果要从 CRM 数据库查看文件,应改用 bel-show-crm-file。
  • 文件类型必须有操作系统已注册的默认应用程序,否则无法打开。
  • 可能出现文件不存在、权限不足、无默认应用、Linux 缺少 xdg-open 等错误。
  • 该技能可与 bel-download-file-from-crm-db、bel-show-crm-file 以及任何产生待查看输出文件的技能配合使用。