> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 智能搜索
> 使用 AI 通过自然语言查询和语义理解，在您的空间中搜索信息。
智能搜索将 AI 的强大能力引入工作区的信息查找。它不只依赖精确的关键词匹配，而是理解您查询背后的**语义**，即使文档中没有出现完全相同的词语，也能找到相关内容。
## 什么是智能搜索？
智能搜索是一项 AI 驱动的语义搜索功能，帮助您通过自然语言在整个空间中查找信息。它超越了传统关键词匹配，能够理解上下文、关联关系和查询意图。
**与普通搜索的主要区别：**
* **语义理解** — 基于语义查找内容，而非仅匹配精确词语
* **自然语言查询** — 用您自然思考的方式提问
* **跨文档关联** — 理解不同文档之间的关系
* **上下文相关性** — 基于概念相似度排序结果，而非仅看关键词频率
## 如何使用智能搜索
智能搜索通过 Craft Assistant 界面使用：
从工作区的任意视图打开 Craft Assistant。
使用自然语言输入查询内容，可以提问或描述您要查找的内容。
Assistant 将利用 AI 理解您的意图，在整个空间中搜索相关内容。
查看搜索结果，其中包含上下文信息及文档间的关联。
在 Assistant 中使用空间级查询时，智能搜索会自动启用——无需单独开启或激活。
## 示例查询
智能搜索擅长理解您搜索背后的**意图**，而不仅仅是匹配关键词。
### 基于概念的搜索
无需搜索精确词语，可以直接按概念搜索：
* *"查找关于季度规划的文档"* — 即使文档中没有明确出现"季度规划"，也能找到与规划、目标和 Q1/Q2/Q3/Q4 相关的内容
* *"显示所有与营销活动相关的内容"* — 理解"推广"、"推广活动"、"发布"等同义表达
* *"我去年写过哪些关于招聘的内容？"* — 结合时间与主题的理解
### 任务与项目查询
查询工作状态和后续步骤：
* *"项目 Y 还有哪些任务未完成？"*
* *"显示我们关于新功能所做的所有决策"*
* *"查找与设计团队会议相关的笔记"*
### 探索性搜索
发现您可能已经遗忘的关联：
* *"我写过哪些关于远程工作的内容？"*
* *"查找所有涉及预算讨论的内容"*
* *"显示与新员工入职相关的内容"*
## 智能搜索与普通搜索的区别
### 传统关键词搜索
**查询：**"项目规划"
\*\*找到：\*\*包含"项目"和"规划"这两个精确词语的文档
\*\*遗漏：\*\*关于"路线图"、"战略会议"、"季度目标"的内容（相关概念，但用词不同）
### 智能搜索
**查询：***"查找关于项目规划的文档"*
**找到：**
* 包含"项目规划"的文档
* 关于"路线图"和"里程碑"的文档
* 涉及"Q4 战略"的会议记录
* 包含"规划阶段"条目的任务列表
\*\*原因：\*\*AI 理解这些是语义相关的概念，即使使用了不同的术语。
## 使用量与模型
智能搜索需要消耗您的 AI 配额，因为它依赖先进的语言模型来理解您的查询并分析您的内容。
\*\*使用的模型：\*\*智能搜索通常使用 **Fast** 模型处理空间级语义查询，在速度与理解能力之间取得平衡。
使用量因查询复杂度和空间大小而异。您可以在 Assistant 菜单的**使用量与限制**中查看当前用量。
对于已知精确词语的简单关键词搜索，请使用普通搜索（`Cmd+F` / `Ctrl+F`）而非智能搜索，以减少配额消耗。
## 何时使用智能搜索与普通搜索
**使用智能搜索的情况：**
* 不确定文档中使用的确切词语
* 想查找概念上相关的内容
* 在多个文档中探索某个主题
* 需要理解不同内容之间的关联
**使用普通搜索的情况：**
* 已知确切的关键词或短语
* 查找特定文档标题
* 希望快速获得结果而不消耗 AI 配额
* 搜索特定数据，如日期、姓名或 ID
## 平台支持情况
智能搜索通过 Craft Assistant 在 Mac、iPad、iPhone、Windows 和 Web 上的**空间级别**可用，支持所有文档类型、收藏集、任务和日历视图。
## 隐私与数据
智能搜索遵循所有 Craft Assistant 功能相同的隐私原则：
* 您的搜索查询**不会存储**在 Craft 服务器上
* 内容仅在处理单次请求期间发送给 AI 模型提供商
* 您的数据**绝不用于**训练 AI 模型
* 仅记录 token 用量和费用用于使用量追踪
搜索历史保留在您的本地设备上，不会被同步或持久化存储。
## 当前限制
智能搜索专为语义理解设计，但有一些注意事项：
* **仅限空间级别** — 智能搜索在空间级别使用，不适用于单个文档内部（请使用文档搜索或"查找"功能）
* **消耗 AI 配额** — 与普通搜索不同，智能搜索计入您的使用限制
* **处理时间** — 可能比传统关键词搜索耗时更长，尤其是复杂查询
## 获得更好结果的技巧
### 明确说明您的需求
避免模糊查询，提供上下文：
* ❌ *"查找项目相关的东西"*
* ✅ *"查找所有与网站改版项目相关的会议记录和决策"*
### 适当使用时间参考
AI 能理解时间上下文：
* *"我上个季度写过哪些关于预算的内容？"*
* *"显示最近关于新功能的笔记"*
* *"查找六月前后关于这次会议的文档"*
### 组合多个概念
智能搜索可以处理复杂的多维查询：
* *"查找与为移动团队招募设计师相关的任务和笔记"*
* *"显示同时讨论营销策略和预算限制的文档"*
### 优化查询表述
如果第一次结果不够理想，尝试重新表述：
* 补充上下文：*"……特别是关于国际市场的"*
* 更加具体：*"Q1 的会议记录" → "一月和二月的每周站会记录"*
* 换用不同词语：*"客户反馈" → "用户投诉和功能需求"*
## 相关文章
了解传统关键词搜索和快速打开导航
开始使用 AI 驱动的对话和查询
了解不同任务应使用哪个模型
了解 AI 使用量、充值及配额监控