# AI 智能搜索
> 用自然语言搜索全景作品与素材，按语义理解关键词后展示匹配结果。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/search/start
- 所属模块：AI 服务与广场
- 页面用途：面向全站用户的 AI 语义搜索页。输入关键词后，先做语义理解提取关键词，再按标签（全景作品/全景素材）匹配内容，结果以卡片列表展示并支持下拉加载。搜索结果与关键词会同步到链接，便于分享与回退。
- 适用用户：查找全景作品与素材的全站用户
- 访问条件：公开访问

## 2. 功能说明

- 标签页：全景作品 / 全景素材（获取失败时回退为默认两项）
- 两步搜索：先做语义理解提取关键词，再执行搜索
- 关键词缓存：同一关键词不重复做语义理解，翻页复用
- 搜索动画：显示“语义理解中 → 搜索中”并配合旋转特效
- 结果卡片：封面、标题、简介、作者头像/昵称/会员标签、浏览量、时长、创建时间
- 作者可点击进入其主页
- 无限加载：滚动接近底部自动加载更多，带骨架屏，每页 20 条
- 未搜索时展示热门搜索词与功能特点
- 搜索结果与关键词同步到链接，切换标签按新类型重搜

## 3. 业务说明

### 搜索范围

| 标签 | 搜索对象 |
| --- | --- |
| 全景作品 | 全站已发布的全景作品 |
| 全景素材 | 素材库中的全景素材 |

## 4. 使用说明

1. 进入页面，未搜索时可点击热门词
2. 输入关键词回车，先语义理解再搜索
3. 滚动到底部加载更多
4. 切换标签按新类型重搜

## 5. 规则与限制

- 关键词为空时提示请输入搜索关键词
- 语义理解失败时回退用原始关键词，避免重复请求
- 切换标签时会清空旧数据
- 每页 20 条，按总数与已加载数量判断是否还有更多

## 6. 状态与异常

- 未搜索：展示搜索引导、热门词与功能特点
- 搜索中：全屏加载动画与“语义理解中...”等文案
- 无结果：显示“未找到相关内容，请尝试其他关键词”
- 加载更多：骨架屏与“加载中...”；到底显示“已加载全部数据”
- 搜索失败时提示，可稍后重试
- 加载更多失败时回退页码并提示重试

## 7. 相关文档

- [我的全景素材](https://9kvr.cn/site/tour/media/media-list.md)
- [我的全景作品](https://9kvr.cn/site/tour/fast/scene-list.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验