slack-search

Slack 搜索

此技能提供有效搜索 Slack 的指导，帮助查找消息、文件和信息。

适用场景

每当你需要在 Slack 中查找信息时，都可使用此技能，包括用户要求你查找消息、对话、文件或人员，或者你需要收集背景信息，以便回答有关 Slack 中动态的问题。

搜索工具概览

工具	使用场景
slack_search_public	仅搜索公开频道。无需用户同意。
slack_search_public_and_private	搜索所有频道，包括私密频道、私信和群组私信。需要用户同意。
slack_search_channels	按名称或描述查找频道。
slack_search_users	按姓名、电子邮件或角色查找人员。

搜索策略

先广泛搜索，再缩小范围

1. 从简单的关键词或自然语言问题开始。
2. 如果结果过多，添加筛选条件（in:、from:、日期范围）。
3. 如果结果过少，移除筛选条件并尝试同义词或相关词语。

选择合适的搜索模式

• 自然语言问题（例如，“项目 X 的截止日期是什么时候？”）：适用于模糊、概念性的搜索，尤其是在你不知道确切关键词时。
• 关键词搜索（例如，project X deadline）：适用于查找具体、精确的内容。

多次搜索

不要依赖单次搜索。将复杂问题拆分成更小的搜索：

• 首先搜索主题
• 然后搜索特定人员的贡献
• 接着在特定频道中搜索

搜索修饰符参考

位置筛选条件

• in:channel-name：在特定频道内搜索
• in:<#C123456>：按频道 ID 搜索频道
• -in:channel-name：排除某个频道
• in:<@U123456> 或 in:@username：搜索与某个用户的私信

用户筛选条件

• from:<@U123456>：搜索特定用户（按 ID）发出的消息
• from:username：搜索某个用户（按 Slack 用户名）发出的消息
• to:<@U123456>：搜索发送给特定用户的消息
• to:me：搜索直接发送给你的消息
• creator:@username：搜索由特定人员创建的画布

内容筛选条件

• is:thread：仅搜索线程中的消息
• is:saved：仅搜索你保存的消息
• has:pin：搜索已置顶的消息
• has:link：搜索包含链接的消息
• has:file：搜索带有文件附件的消息
• has::emoji:：搜索带有特定表情回应的消息
• hasmy::emoji:：搜索你用特定表情回应过的消息

日期筛选条件

• before:YYYY-MM-DD：搜索某日期之前的消息
• after:YYYY-MM-DD：搜索某日期之后的消息
• on:YYYY-MM-DD：搜索某日期当天的消息
• during:month：搜索某个月期间的消息（例如，during:january）

文本匹配

• "exact phrase"：匹配确切短语
• -word：排除包含某个词的消息
• wild*：通配符匹配（* 前至少需要 3 个字符）

文件搜索

要搜索文件，请设置 content_types="files" 参数，并在查询中使用 type: 筛选条件：

• type:images、type:documents、type:pdfs、type:spreadsheets、type:presentations
• type:canvases、type:lists、type:emails、type:audio、type:videos

示例：content_types="files" type:pdfs budget after:2025-01-01

以上所有标准修饰符（in:、from:、日期等）也适用于文件搜索。

有用的参数

除了查询字符串，搜索工具还接受一些能显著改善结果的参数：

• sort：score（相关性，默认值）或 timestamp（最新优先）；可与 sort_dir（asc/desc）搭配使用。
• content_types：messages（默认值）或 files。
• only_my_channels：将搜索范围限制为你所属的频道。
• limit：每页结果数（上限为 20）；使用返回的 cursor 翻页。

后续查看结果

找到相关消息后：

• 对于任何带有线程的消息，使用 slack_read_thread 获取完整的线程上下文。
• 使用带有 oldest/latest 时间戳的 slack_read_channel 阅读周边消息，以获取上下文。
• 如果结果中出现用户 ID，使用 slack_read_user_profile 确认用户身份。
• 使用 slack_read_file 阅读文件搜索结果中出现的文件内容。
• 使用 slack_list_channel_members 查看你找到的频道中有哪些成员。

常见问题

• 布尔运算符无效。 不支持 AND、OR、NOT。请使用空格（隐式 AND）和 - 排除内容。（重复使用同一修饰符，例如两个 from:，会对这些值执行 OR 运算。）
• 括号无效。 不要尝试使用 () 对搜索词分组。
• 搜索并非实时。 最近几秒内发布的消息可能不会出现在搜索结果中。要查看最新消息，请使用 slack_read_channel。
• 私有频道访问权限。 需要包含私有频道时，请使用 slack_search_public_and_private，但请注意，这需要用户同意。

备注

• **范围：**此技能负责搜索_工作区内容_：Slack 中的消息、文件、频道和人员。若要搜索并阅读 docs.slack.dev 上的官方 Slack_平台文档_（关于 Slack 功能的概念性问题和操作指南），请改用 slack:slack-docs 技能。