Sloth 项目技术文档

1. 安装指南

1.1 通过下载安装

您可以直接从项目官网下载最新版本的 Sloth 应用程序。下载链接为：

https://sveinbjorn.org/files/software/sloth.zip

下载完成后，解压缩文件并双击 Sloth.app 即可安装并运行。

1.2 通过 Homebrew 安装

如果您已经安装了 Homebrew，可以使用以下命令通过 Homebrew Cask 安装 Sloth：

brew install --cask sloth

请注意，通过 Homebrew 安装的版本可能不是最新版本。

1.3 手动构建

如果您希望手动构建 Sloth，可以按照以下步骤操作：

1. 克隆项目仓库到本地：

   git clone https://github.com/sveinbjornt/sloth.git
   

2. 进入项目目录：

   cd sloth
   

3. 使用 Xcode 打开项目：

   open Sloth.xcodeproj
   

4. 在 Xcode 中选择目标设备并点击“Build”按钮进行构建。

5. 或者，您也可以直接在终端中运行以下命令进行构建：

   make
   

   构建完成后，生成的应用程序将位于 products/ 目录下。

2. 项目的使用说明

2.1 启动应用程序

安装完成后，您可以在应用程序文件夹中找到 Sloth 图标，双击启动应用程序。

2.2 查看系统资源

Sloth 启动后，您将看到一个界面，显示当前系统中所有正在使用的文件、目录、套接字、管道和设备。您可以通过以下方式查看和操作这些资源：

• 查看所有打开的文件、目录、IP 套接字、设备、Unix 域套接字和管道：应用程序主界面会列出所有正在使用的资源。
• 过滤资源：您可以通过名称、访问模式、卷、类型、位置或使用正则表达式来过滤显示的资源。
• 排序资源：可以按进程名称、文件数量、类型、进程 ID、用户 ID、Carbon PSN、Bundle UTI 等进行排序。
• 查看 IP 套接字状态：您可以查看套接字的协议、端口和版本。
• 查看进程间通信：可以查看进程之间建立的套接字和管道。
• 详细信息窗口：点击某个资源，可以查看详细的 macOS 和 Unix 文件/套接字/进程信息。
• 文件操作：右键点击某个文件或目录，可以使用上下文菜单进行文件操作。

2.3 以管理员权限运行

某些操作可能需要管理员权限。Sloth 提供了内置的认证功能，您可以在应用程序中进行认证，以管理员权限运行。

3. 项目 API 使用文档

Sloth 本身是一个图形化用户界面应用程序，没有提供直接的 API 接口。它基于 lsof 命令行工具，解析其输出并展示在界面上。如果您需要使用 lsof 命令行工具，可以直接在终端中运行 lsof 命令来获取系统资源信息。

4. 项目安装方式

Sloth 的安装方式主要有以下几种：

1. 直接下载安装：从项目官网下载最新版本的 .zip 文件，解压缩后双击运行。
2. 通过 Homebrew 安装：使用 Homebrew Cask 安装，命令为 brew install --cask sloth。
3. 手动构建：通过 Xcode 或 make 命令手动构建项目。

通过以上方式，您可以轻松安装并使用 Sloth 应用程序，查看和管理系统中的资源。