命令行界面

什么是命令行界面？

Owlfiles 内置了命令行界面。你可以直接在终端中列出、搜索、复制、移动和删除本地磁盘、SMB、FTP、SFTP、WebDAV、NFS 以及受支持云服务中的文件。

命令行工具会复用已在 Owlfiles 中配置的连接和保存的登录信息，无需额外设置。

运行命令行工具

该命令行工具就是 Owlfiles 应用程序的可执行文件。请在终端中使用完整路径运行：

/Applications/Owlfiles.app/Contents/MacOS/Owlfiles connections

为了减少在默认 zsh shell 中的输入，可以将下面的别名添加到 ~/.zshrc，然后打开一个新的终端窗口：

alias owlfiles="/Applications/Owlfiles.app/Contents/MacOS/Owlfiles"

之后即可运行：

owlfiles connections

下面的示例假设 owlfiles 别名已经可用。

指定文件地址

大多数命令使用 <连接>:<路径> 格式的地址。连接名称就是 owlfiles connections 显示的名称。

• my NAS:/Documents/report.pdf 表示名为“my NAS”的连接中的文件。
• GoogleDrive:1zeRs1TUOYxMwVdYJdHF_ikAaRCMYMcwp 使用 Google Drive 文件 ID 指定项目。
• local:~/Desktop 或 ~/Desktop 表示 Mac 上的文件。未指定连接时，Owlfiles 会将路径视为本地路径。

如果连接名称中包含空格，请用引号将整个地址括起来："my NAS:/Documents"。

命令

列出连接

显示每个已配置连接的名称和协议：

owlfiles connections

列出文件夹内容

使用 ls 列出文件夹内容，并显示修改日期和大小。添加 -a 可以包含隐藏文件。

owlfiles ls "my NAS:/Documents"
owlfiles ls -a MyGoogleDrive:'1WlBH4KpOcIWgNKVVBRmUd5'

获取文件信息

使用 info 显示文件或文件夹的类型、大小和修改日期：

owlfiles info "my NAS:/Documents/report.pdf"

搜索

按名称搜索文件和文件夹。最后可以添加一个数字来控制搜索的文件夹层级，默认值为五层。

owlfiles search "my NAS:/Documents" invoice
owlfiles search Dropbox report.pdf

创建文件夹

owlfiles mkdir "my NAS:/Documents/Archive"

删除

rm 会直接删除文件或文件夹，不会要求确认。请谨慎使用。

owlfiles rm "my NAS:/Documents/old.txt"

复制

来源和目标可以位于不同的连接中。

owlfiles cp "my NAS:/Documents/report.pdf" GDrive:'1WlBH4KpOBl8WXj31pOcIWgNKVVBRmUd5'
owlfiles cp /Users/me/Desktop/photo.jpg "my NAS:/Photos"

移动

在同一连接内或两个连接之间移动文件或文件夹：

owlfiles mv "my NAS:/Documents/report.pdf" MyOneDrive:'CF8821A253295DA6!142'

帮助

owlfiles --help

说明与故障排除

• 找不到连接名称？ 运行 owlfiles connections，并用引号括起包含空格的名称。
• 连接要求登录。 在 Owlfiles 中打开一次该连接并登录。命令行工具会复用保存的登录信息。
• 无法访问本地文件。 在 Owlfiles 中打开一次该文件夹，通过 macOS App Sandbox 授予访问权限。
• 用于脚本。 命令成功时返回状态 0，失败时返回非零状态。错误会写入标准错误输出。