在 Mac 上安装 Kaam360 应用

Mac 版 Kaam360 应用（也称代理程序）会为您的组织记录 Mac 上的工作活动，详见活动跟踪。它的作用与 Windows 应用相同：以已登录的用户身份运行，在记录任何内容之前先显示通知，并在屏幕顶部的菜单栏中一直显示 Kaam360 图标。它适用于 macOS 12 (Monterey) 及更高版本，支持搭载 Apple 芯片（M1 及更新）的 Mac 和 Intel Mac：一个下载同时适用于两者。

开始之前

1. 在 活动设置 中开启跟踪并选择记录哪些内容。在此之前，应用会显示通知，但不记录任何内容。
2. 在 设备 上按 新登记代码。如果是某个人的 Mac，在 适用于 中选择此人。如果是多台 Mac，选择 任何人，并把 电脑数量 设得足够大。

在一台 Mac 上安装

1. 在 Mac 上打开 Kaam360。在菜单中打开 活动跟踪，然后打开 设备，按 下载 Mac 应用。文件名为 Kaam360AgentSetup 加版本号，以 .pkg 结尾。
2. 打开下载的文件（在“下载”文件夹中双击它）。
3. 如果 macOS 提示安装包“无法打开”或 Apple“无法验证”它，请点按 完成（不要点“移到废纸篓”）。然后打开苹果菜单 > 系统设置 > 隐私与安全性，向下滚动到 安全性 部分，在关于 Kaam360AgentSetup 的提示旁点按 仍要打开。如有要求，输入 Mac 密码，然后再次打开该文件并点按 打开。原因见下文。
4. 按照安装器操作：点按 继续 和 安装。它会要求输入管理员名称和密码，因为应用是为使用这台 Mac 的所有人安装的。
5. 安装完成后，菜单栏中会出现 Kaam360 图标，并打开 将这台电脑连接到 Kaam360 窗口。输入您的 Kaam360 地址（设备 上显示的地址，例如 https://kaam360.yourcompany.com）和登记代码，然后按 连接。只有当代码适用于 任何人 且您希望 Mac 立即与其使用者关联时，才需要填写工作邮箱。
6. 使用这台 Mac 的人会看到通知。只有在他们按 我已了解 后才开始记录。
7. 在 设备 上，这台 Mac 现在会和其使用者以及系统 macOS 一起显示。没有分配给任何人的 Mac 在您选择使用者之前不会记录任何内容。

为什么 macOS 第一次会询问（仍要打开）

Apple 通过一项称为“公证”的服务检查来自互联网的应用。在 Apple 对 Kaam360 的 Mac 应用完成公证之前，macOS 会在第一次时拦下安装包，只有 隐私与安全性 中的 仍要打开 才能放行。每台 Mac 只需一次，且只针对下载的文件；之后已安装的应用会自行打开。如果想确认文件是真实的，请核对 设备 上显示的指纹 (SHA-256)：在“终端”中输入 shasum -a 256 和一个空格，把文件拖入窗口并按 Return 键。应用完成公证后，这一步就会消失，其他一切不变。

macOS 会请求的权限

在应用可以看到某些内容之前，macOS 会询问这台 Mac 前的人。Kaam360 应用只请求您的 活动设置 需要的权限，并且只在相应设置开启时请求：

• 录屏：仅当 截图 开启时。macOS 会显示“Kaam360 Agent”想要录制这台电脑的屏幕。允许方法：系统设置 > 隐私与安全性 > 录屏（在 macOS 15 及更高版本中称为 录屏与系统录音），打开 Kaam360 Agent。没有它就不会截图（其他一切照常工作）。macOS 可能会不时要求再次确认。
• 辅助功能：仅当 记录窗口标题 开启时。它让应用读取前台窗口的标题。允许方法：系统设置 > 隐私与安全性 > 辅助功能，打开 Kaam360 Agent。没有它就不会记录标题。
• 自动化：每个浏览器一次，在它第一次位于前台时（Safari、Google Chrome、Microsoft Edge、Brave、Arc、Vivaldi、Opera）。macOS 会询问是否允许“Kaam360 Agent”控制该浏览器；请点按 允许。应用只向浏览器询问前台页面的地址，并且只保留网站名称。如果有人点按 不允许，就不会记录该浏览器中的网站（浏览器本身仍会记录）。以后要更改：系统设置 > 隐私与安全性 > 自动化 > Kaam360 Agent。Firefox 无法被询问；只有开启标题时，才会从窗口标题中获取它的网站。

当设置所需的某项权限缺失时，应用的菜单会说明这一点，并提供 打开“隐私与安全性”设置。更新后，应用也可能请求使用其在钥匙串中的密钥（在 Kaam360 为其签名之前）：请选择 始终允许。

在多台 Mac 上安装（供 IT 使用）

安装包可以通过您的设备管理工具（例如 Jamf Pro、Microsoft Intune、Kandji、Mosyle 或 Addigy）无提示安装，或以管理员身份在“终端”中运行：

sudo installer -pkg Kaam360AgentSetup-1.0.0.pkg -target /

用以下任一方式提供 Kaam360 地址和适用于足够多电脑的登记代码：

• 配置描述文件（推荐）：包含偏好设置域 com.kaam360.agent 的自定义设置负载，以及键 Server（您的 Kaam360 地址）和 Code（登记代码）。只有当 Mac 属于某一位已知人员时才添加 Email。
• 在每台 Mac 上以管理员身份运行：sudo defaults write /Library/Preferences/com.kaam360.agent Server -string https://kaam360.yourcompany.com，然后运行 sudo defaults write /Library/Preferences/com.kaam360.agent Code -string KAAM-XXXX-XXXX-XXXX
• 文件 /Library/Application Support/Kaam360/Agent/enroll.json，内容为 {"server": "https://...", "code": "KAAM-..."}，与 Windows 相同。

以这种方式提供的地址是固定的：使用这台 Mac 的人无法更改。每个人登录时应用都会启动，自动连接并显示通知。使用这台 Mac 的每个人都会单独登记，在列表中作为各自的电脑显示。

借助设备管理，您还可以用针对应用 ID com.kaam360.agent 的隐私偏好设置 (PPPC) 描述文件，预先为 Kaam360 Agent 允许 辅助功能 和 自动化。Apple 不允许设备管理自行开启 录屏：需要 Mac 前的人允许一次。

安装包尚未经过 Apple 签名和公证。大多数设备管理工具会直接安装这类安装包；如果您的工具拒绝未签名的安装包，请等待公证版本。

员工会看到什么

• 一个窗口，显示您组织的通知和当前记录内容的列表。在他们按 我已了解 之前不会记录任何内容，每当您更改通知时，它都会再次出现。
• 菜单栏中始终显示 Kaam360 图标。绿点表示正在记录，灰点表示不记录（工作时间以外、跟踪已关闭、已暂停），琥珀色表示有需要注意的事项，截图时会显示蓝点。应用在程序坞中没有图标。
• 点击图标会打开菜单：应用当前在做什么、截图和窗口标题是否开启、缺少的权限、记录哪些内容（再次显示通知）、状态和详情 和 打开 Kaam360。
• 没有暂停或关闭应用的按钮：暂停由您决定，在 设备 上使用 暂停。如果应用以其他方式被关闭，macOS 会在一分钟内重新启动它。

没有网络连接时

网络中断时应用会继续记录。记录的内容会保存在 Mac 上，用保存在此人钥匙串中的密钥加密，最多保留 14 天，网络恢复后立即发送。

更新

发布新版本后，应用会从您的 Kaam360 下载它，检查其指纹（应用签名后还会检查 Apple 的签名），并在菜单中提供 安装更新。随后 Mac 的安装器会打开并要求输入管理员密码；之后应用会自行重新启动。IT 也可以用同样的命令或设备管理在旧版本上安装新的安装包。

卸载应用

以管理员身份在“终端”中运行：

sudo "/Library/Application Support/Kaam360/Agent/uninstall.sh"

它会为所有人停止应用，将其从“应用程序”中删除，并取消登录时启动。在末尾加上 --all，还会删除这台 Mac 上为每个人等待发送的数据。然后在 设备 上对这台 Mac 按 撤销，使其密钥停止工作。只把应用移到废纸篓是不够的，因为登录时启动的设置仍会保留。

如果出现问题

• “无法打开 Kaam360AgentSetup”：按上文所述使用 仍要打开。如果没有 仍要打开 按钮，请再打开一次该文件，并在一小时内再次查看 隐私与安全性。
• 菜单栏中没有图标：在带刘海的 Mac 上菜单栏可能已满；请关闭其他菜单栏应用，或按住 Command 键把图标拖走。应用也可能仍在等待代码：从“应用程序”中打开 Kaam360 Agent。
• “该代码无效” 或 “无法连接 Kaam360”：与 Windows 相同，生成新代码，检查地址是否以 https:// 开头，并确认这台 Mac 能在浏览器中打开 Kaam360。
• 没有截图、标题或网站：缺少某项权限；请查看应用的菜单和上面的权限说明。
• “这台电脑已不再连接到 Kaam360”：这台 Mac 已被撤销，或已在别处重新登记。请生成新代码并重新连接。
• 用于支持：状态和详情 会显示版本并打开日志文件夹。日志列出应用做了什么，绝不记录此人做了什么。应用的文件位于此人的 Library/Application Support/Kaam360/Agent 文件夹中。