> 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/ren-lian-shi-bie.md).

# 人脸识别

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

### 它是如何工作的

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

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

人脸识别按每个云盘分别范围生效。在一个云盘中建立索引的面孔，在另一个云盘中不可见，也无法搜索。

<figure><img src="/files/fdb23bbb48ef5422392aa74fb9cca334451f32da" alt=""><figcaption></figcaption></figure>

### 创建档案

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

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

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

无论你采用哪种方式，都应提供质量良好的样本图片：

1. 为该个人输入姓名。
2. 选择一张或多张样本图片，帮助系统学习这个人的外貌。

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

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

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

### 按人物搜索

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

例如，搜索 **“JJ 扔橄榄球”** 会返回 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://academy.shade.inc/shade-academy/shade-academy-zh/ai-gong-ju/ren-lian-shi-bie.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
