> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-zh/ai-gong-ju/facial-recognition.md).

# 人脸识别

“人物”功能使用 AI 来检测并识别你云盘中图片和视频里的面孔。一旦为个人添加了标签，你就可以快速找到该人物出现的每个素材，甚至可以将他们的名字与其他搜索词组合起来，准确找到你要找的那个瞬间。

### 工作原理

当素材上传到云盘后，AI 索引文件夹中的任何图片或视频都会自动扫描面孔。未识别的面孔（即尚未关联到已命名档案的面孔）会直接在素材本身中显示，并位于 **详情** 选项卡下的 **未识别面孔** 部分。在那里你可以以该面孔为起点创建档案。

“ **人物** 左侧边栏中的视图只显示已经创建了命名档案的个人。它不是所有检测到面孔的列表，而是已标记人物的目录。

人脸识别按云盘分别作用于各自的范围。在一个云盘中索引的面孔，在另一个云盘中不可见，也无法搜索。

<figure><img src="https://3843445310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FsT9qLz4apFMh4d3DMksH%2FScreenshot%202026-04-27%20at%205.21.49%E2%80%AFPM%20(2).png?alt=media&amp;token=74ae3a47-042f-43f6-9389-63abf715fc52" alt=""><figcaption></figcaption></figure>

### 创建档案

为某个人创建档案有两种方式：

**从素材中：** 打开任何包含未识别面孔的素材，转到 **详情** 选项卡，然后在 **未识别面孔**下找到该面孔。你可以直接在那里创建档案，并自动将该面孔用作示例。

**从“人物”视图中：** 点击 **+ 添加个人** 在右上角，然后输入姓名并手动选择示例图片。

无论你选择哪种方式，都需要提供质量良好的示例图片：

1. 输入该个人的姓名。
2. 选择一张或多张示例图片，以帮助系统了解此人的外貌。

**获得最佳效果的提示：**

* 至少使用一张专门的照片，其中此人的脸部清晰可见、无遮挡且光线良好。
* 再添加 2–3 张示例照片可以显著提高识别准确率，尤其是在不同角度、光照条件或时间段下。
* 避免使用脸部被部分遮挡、处于阴影中或在画面中非常小的样本。

一旦档案保存，系统就会扫描你云盘中的素材，并显示该个人出现的每个实例。

### 按人物搜索

已标记的个人会完全集成到云盘的 AI 搜索中。你可以只按姓名搜索，或者将姓名与其他描述性词语组合起来，以进一步缩小结果范围。

例如，搜索 **"JJ throwing a football"** 将返回 JJ 正在进行该动作的图片和视频，而不是任何包含 JJ 的素材，也不是任何有人在扔橄榄球的素材。

这使你无需手动浏览，就能轻松找到涉及特定人物的特定时刻。

### 注意事项

* 只有 AI 索引文件夹中的素材才会被扫描。如果某个文件夹被排除在 AI 索引之外，其中素材里的面孔将不会出现在“人物”视图中。
* 由于索引是在上传后运行，刚上传的素材可能不会立即显示出来。
* 识别准确率会随着更多、更高质量的示例图片而提高。如果结果看起来不完整，请尝试为该个人档案添加更多样本。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/shade-academy/shade-academy-zh/ai-gong-ju/facial-recognition.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
