AI 解读

不确定某个缓存能不能删、某个启动项能不能关？AI 解读 会说明它是什么、操作后可能有什么影响。它只负责解释，不会替你删除文件或更改设置。

#在哪里使用

深度清理、隐私清理、大文件清理、重复文件清理、应用卸载、启动项管理、系统优化 和 系统维护 都支持 AI 解读。把鼠标移到某一项上，点 AI 解读，回答会逐步显示在面板中。你可以 停止生成，把面板 收起 稍后再看，或复制回答。深度清理中的自定义规则暂不支持。

#设置自定义服务

当前版本不提供内置的免费 AI 服务，设置中会显示 当前版本仅支持自定义服务。你需要连接自己的模型服务：

1. 打开 设置 → 扫描与分析 → AI 解读，点 配置…；也可以在 AI 解读面板中点 配置。
2. 选择 自定义服务，填写三项：
   • Base URL：服务商的 API 根地址，不带末尾的 /chat/completions。例如完整接口是 https://api.example.com/v1/chat/completions，就填 https://api.example.com/v1；
   • 模型名称：服务商提供的模型 ID，可能和网页上显示的名称不同；
   • API Key：在服务商控制台创建的密钥。
3. 点 保存并测试 检查连接。测试会发送一次简短请求，可能产生少量费用；只想保存就点 保存。

可以使用任何兼容 OpenAI Chat Completions 接口、支持流式输出的服务，包括模型服务商提供的兼容接口和 API 网关。费用和用量限制由服务商决定。

#高级设置

一般保持默认即可。推理模式 选 关闭推理（兼容服务） 可以减少等待，服务商报错时改回 服务商默认；温度 和 Max Tokens 留空时使用服务商默认值，Max Tokens 设得太小会截断回答；服务商要求额外请求头时，在 自定义请求头 中添加，最多 8 项。

#使用本机模型

本机运行的模型服务只要提供 OpenAI 兼容接口就能使用，Base URL 形如 http://127.0.0.1:端口/v1。地址是 localhost 或 127.0.0.1 时，API Key 可以留空；局域网中其他电脑上的服务需要填写 API Key，服务不校验时可填任意值。HTTP 连接不加密，连接远程服务请使用 HTTPS。

#会发送哪些信息

只有你点 AI 解读 时，浣熊管家才会把这一项的信息直接从 Mac 发给你配置的服务，不经过我们的服务器：

• 项目名称、说明、类型、当前状态和界面语言；
• 相关的完整路径，例如文件位置、启动配置和程序路径，路径中可能包含你的 macOS 用户名；
• 视功能而定的补充信息，例如文件大小和修改时间，启动项的发布者、版本和签名状态，应用的标识符和签名信息，清理前需要关闭的应用。

不会发送文件内容。请求中还会带上 API Key、自定义请求头，以及应用版本和 macOS 版本等基本信息。服务商如何处理这些数据，以它的条款和隐私政策为准。API Key 只保存在这台 Mac 上，点 删除配置 即可清除。

#AI 只解释，不操作

AI 不能删除文件、更改设置或运行命令，所有清理和更改仍要你自己确认。回答可能出错，AI 仅供参考；涉及重要数据时，请先核对位置并备份。

#关闭 AI 功能

在 设置 → 扫描与分析 → AI 解读 关闭开关后，各页面不再显示 AI 解读。已保存的配置会保留，重新打开即可继续使用。

#常见问题

• 认证失败：检查 API Key 是否完整有效，是否和 Base URL 属于同一服务商。
• 模型或接口不存在：检查 Base URL 和模型名称。
• 余额不足或请求受限：到服务商控制台查看余额和限额。
• 服务商拒绝了请求：把推理模式改回 服务商默认。
• 回答被截断：调大或清空 Max Tokens。停止生成后，服务商仍可能计费。