用途
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 以及任何产生待查看输出文件的技能配合使用。