禅道全文搜索支持五种方式：一、顶部全局搜索框实时模糊匹配；二、各模块高级搜索组合条件筛选；三、“我的查询”保存复用检索逻辑；四、文档中心专属全文搜索；五、URL参数触发预置搜索。

如果您在禅道中需要快速定位需求、任务、Bug、用例或文档等任意类型的数据，但无法通过固定菜单逐级查找，则可能是未掌握其全局搜索机制。以下是使用禅道全文搜索功能的具体操作方法：

一、使用顶部全局搜索框

禅道界面右上角始终显示一个带放大镜图标的搜索输入框，该入口支持跨模块实时模糊匹配，覆盖当前用户权限范围内的所有可检索对象。

1、点击右上角搜索框，光标自动聚焦。

2、输入关键词（如“登录失败”“验证码”“V1.0测试”），无需选择模块，系统自动启用全文索引扫描。

3、下拉列表即时显示匹配项，含类型标识（如【需求】、【Bug】、【任务】）及所属产品/项目名称。

4、点击任一结果，直接跳转至对应详情页。

二、进入高级搜索页面进行组合条件筛选

当需限定范围、排除干扰或复用查询逻辑时，应使用各模块内置的高级搜索功能，其底层依赖同一全文检索引擎，但支持字段级约束与逻辑组合。

1、进入目标模块（如“产品→需求”“测试→Bug”“项目→任务”）。

2、点击页面中的【搜索】按钮，展开高级搜索面板。

3、在字段下拉菜单中选择“标题”“描述”“重现步骤”“备注”等支持全文检索的字段。

4、在对应输入框中填写关键词，可使用通配符“*”（如“订单*超时”）。

5、最多可添加六个条件，支持“且”逻辑组合；留空某字段即忽略该条件。

6、点击【搜索】执行检索，结果页顶部显示命中总数及高亮关键词。

三、利用“我的查询”保存并复用全文搜索条件

高频使用的全文检索组合可固化为快捷入口，避免重复配置，提升后续检索效率。

1、完成一次高级搜索后，确保结果符合预期。

2、点击搜索结果页上方的【保存】按钮。

3、在弹出窗口中输入查询名称（如“本周高优先级Bug”“含‘兼容性’的全部用例”）。

4、点击确定，该查询即出现在页面右上角“我的查询”下拉菜单中。

5、后续只需点击“我的查询”→选择已命名项，即可一键执行相同全文检索逻辑。

四、通过文档中心启用文档专属全文搜索

自禅道17.2版本起，文档模块独立集成全文检索能力，支持对文档标题、正文、附件文本（OCR识别后）进行联合匹配。

1、切换至“文档”视图，点击左侧导航栏【文档库】或【我的文档】。

2、在文档列表上方找到【搜索】输入框（区别于顶部全局搜索框）。

3、输入自然语言关键词（如“接口规范”“数据库设计说明”）。

4、系统自动解析语义并返回相关文档卡片，卡片内匹配段落将高亮显示。

5、点击文档标题打开后，页面内所有匹配关键词均保持绿色高亮。

五、使用URL参数触发预置全文搜索

适用于嵌入外部系统链接或批量分发特定检索结果，通过构造标准GET参数可绕过界面直接加载全文搜索结果页。

1、确认目标模块URL基础路径（如Bug列表页为 /bug-browse-all-0-0.html）。

2、在URL末尾添加参数 ?searchTerm=关键词 （URL编码处理中文，如 searchTerm=%E7%99%BB%E5%BD%95%E5%A4%B1%E8%B4%A5）。

3、回车访问，页面自动执行该关键词的全文检索并展示结果。

4、支持追加 &type=bug 或 &type=story 等参数限定对象类型，type值必须为禅道内部数据表名小写形式。