SuperAPI AI 工具集

open-file

通用与其它

查看项目

更新于 10-16 07:17

技能介绍

用途:在 macOS 上打开本地文件或目录,并可用指定应用打开;当用户提出“打开”“启动”或在某应用中查看文件时使用。

主要能力:

  • 用 open 打开文件或目录;open '<directory>' 会在访达中打开。
  • 指定应用打开文件。
  • 处理 procNotFound 错误:应用未运行时先启动再打开。
  • 支持 URL scheme 深链接,跳到应用内的具体条目,而不只是打开文件。
  • 支持从对话上下文推断目标文件与目标应用。

使用方式: 指令形式为 /open-file <path> [app]。未提供路径时,从对话上下文推断(如刚创建或讨论过的文件);若提到应用(如“在 Obsidian 中”),使用 open -a 或该应用的 URL scheme。

工作流程:

  1. 解析路径并转为绝对路径;相对路径按当前工作目录解析。
  2. 校验目标存在: [ -e '<path>' ] && echo "EXISTS" || echo "NOT_FOUND" 若不存在,告知用户并停止。
  3. 打开文件。指定应用: open -a '<App Name>' '<path>' 使用默认应用: open '<path>'
  4. 处理 procNotFound:应用未运行时执行 open -a '<App Name>' && sleep 3 && open -a '<App Name>' '<path>' 即先启动应用、等待初始化后重试。
  5. 向用户确认文件已打开。

URL scheme 深链接(用于跳到应用内具体条目): Obsidian:open -a "Obsidian" && sleep 3 && open 'obsidian://open?vault=<vault>&file=<url-encoded-path>' VS Code:code '<path>' 或 open 'vscode://file/<absolute-path>' 路径片段需做 URL 编码,尤其是 emoji、中日韩字符和空格。

注意事项与限制: 始终用单引号包裹路径,以处理空格和特殊字符;open -a 可一步完成启动应用并打开文件,两步式“先启动再打开”仅在 URL scheme 调用、且应用必须先运行时使用。该技能面向 macOS,其他平台行为与可用命令暂未提供。