# 使用指南

## 开始观察

将应用放在“应用程序”后打开。巡航默认每 30 秒观察一次；首次采样建立基线，下一次才会出现进程 CPU。通知没有授权时仍会在窗口里显示异常。登录启动默认关闭，可以在设置开启并查看系统状态。

主窗口关闭后应用继续在菜单栏工作。菜单栏可以重新打开窗口、立即采样、暂停或恢复观察。退出巡航后不再采样。暂停、休眠及采样间隔异常会中断持续高占用的证据，恢复后重新观察。

## 处理异常

工作台先显示需要关注的任务，再显示其他运行进程。进入详情可查看来源、区间 CPU、驻留内存、已运行时间和累计 CPU 时间。启动命令在本机按需展开，可能包含项目路径或敏感参数，分享屏幕前请留意。

巡航只确认“在观察区间里持续高占用”，不会宣称已经确定死循环。构建、渲染、测试也可能正常使用大量 CPU。

- **查看任务详情**：查看来源与观察依据；未进行退出操作时，任务会继续运行。
- **静音 1 小时**：本次任务暂时不提醒；可以提前恢复提醒。
- **请求退出**：确认后发送 SIGTERM，让任务尝试正常退出。
- **强制结束**：再次确认后发送 SIGKILL，可能丢失未保存的工作。

操作只针对你选择的单个任务，不会自动结束一组子进程。每次发送信号前都会重新核对进程身份、用户、可执行文件和命令，系统关键进程受到保护。操作后约 2 秒复查，结果会持续显示：“已确认退出”表示目标任务已结束；“仍在运行”时可以继续等待；“暂时无法确认”表示进程信息不可读取，需要重新采样或在活动监视器核对，不能视为已经退出。

## 记录与外观

记录保存在本机，最多保留 30 天、500 条。可搜索和筛选；“导出全部”会保存保留期限内的全部记录，不受当前筛选影响。记录和导出的 JSON 包含固定任务类别、必要的 PID、事件时间与结果，不含原始命令、文件路径、API Key 或 AI 回答。导出文件由你选择保存位置，不会自动上传；“清空”会在确认后删除本机全部记录。

设置提供系统、银白浅色、石墨深色。表格、侧栏、弹窗与菜单栏使用相同外观规则。

## 可选 AI 建议

在设置填写 Chat Completions 兼容服务的 Base URL、模型 ID 与 API Key。Base URL 不包含 `/chat/completions`。点击“保存服务与密钥”会一起校验并保存配置及本次填写的新 Key；Key 留空时保留此服务地址已有的密钥。Key 进入 macOS 钥匙串，按服务地址隔离，不随地址变化自动迁移。

远程服务使用 HTTPS；精确的 localhost、127.0.0.1、::1 可使用 HTTP。本地服务不要求认证时可以留空 Key。巡航不会安装或启动模型。

点击分析后先阅读接收服务和实际摘要，确认后才发出请求。摘要包含固定任务类别、CPU/内存数值、运行时间及观察时间；不包含命令、路径、PID、用户名、项目源码和日志。AI 回答只供参考，不能发出进程操作。你需要回到本地操作按钮独立确认。

如果出现认证、额度、模型、网络或超时问题，界面会给出相应原因；本地监控继续可用。请求最长约 45 秒，回答大小受限；不跟随服务重定向。服务商是否留存请求由服务商政策决定，`store: false` 不是对所有服务的数据留存保证。

## 常见问题

**为什么进程 CPU 超过 100%？** 多线程进程可以使用多个逻辑核心；整机 CPU 按全部核心计算。

**为什么看不到某个进程？** 巡航只列出当前用户可读取的进程，macOS 可能限制部分进程信息。

**为什么提醒没弹出？** 检查巡航通知权限、系统专注模式、当前任务是否静音，以及是否已经达到持续观察时间。关闭通知不影响窗口内显示。

**登录启动提示需要批准？** 打开 macOS“系统设置 → 通用 → 登录项”，按系统显示处理。换位置或更换签名后可能需要重新设置。

**数据如何删除？** 在设置或记录页清除本地记录，在 AI 设置删除对应 Key。更多细节见随附隐私说明。
