使用 Raycast 搜索 Confluence 或 Jira

发布: (2026年1月15日 GMT+8 15:07)
7 min read
原文: Dev.to

I’m happy to help translate the article, but I need the full text you’d like translated. Could you please paste the content (excluding the source line you already provided) here? Once I have the text, I’ll translate it into Simplified Chinese while preserving the formatting, markdown, code blocks, URLs, and technical terms as requested.

前言

如果你使用过 Alfred 但还没有尝试过 Raycast,值得一试。免费计划已经足够日常使用(参见 Raycast vs Alfred)。

免费用户无法使用 Raycast 内置的数据同步,但仍可通过 Raycast 的 Export/Import Settings & Data 加上 iCloud Drive 进行同步。

Source:

背景

在我们公司,我们使用 Atlassian 的 ConfluenceJira 作为知识库和项目管理工具。

我们经常打开 Wiki 和 Jira 页面来查找信息。要找到特定的文章或问题,通常需要以下几个步骤:

  1. 打开网站
  2. 将焦点放到搜索框
  3. 输入查询内容
  4. 过滤搜索结果

稍微快一点的方式是将常用链接加入书签,或为 Raycast 创建 QuicklinksAliases 以便快速访问。

Quicklinks 在某些场景下非常有用——例如使用以下方式搜索文档

https://developer.mozilla.org/en-US/search?q={Query}

其中 {Query} 为动态参数(即你想搜索的内容)。任何支持基于 URL 的搜索参数的站点都可以采用这种方式——比如 Google 的

https://www.google.com/search?q={Query}

然而,这种搜索方式并不适用于内部公司的 Wiki/Jira 站点,且使用 Quicklinks 来搜索内部文档也并不理想。随着时间推移,你需要访问或保存的链接数量只会不断增加——无论是浏览器书签还是 Quicklinks。

于是我们产生了构建一个 Raycast 扩展的想法,以支持对 Confluence 和 Jira 的快速搜索(以及少量简单操作)。恰好,我们的自托管(Data Center)部署也支持通过 Personal Access Tokens 进行身份验证,这是一种与外部程序安全集成的方式。了解更多

开始之前

安装 Raycast 后,前往 Raycast Store 并安装 Atlassian Data Center (Self‑Hosted) 扩展。

运行此扩展中的命令时,它会引导您完成一些初始设置。请准备以下信息:

  • Confluence Base URL – 例如 https://confluence.example.com/
  • Confluence PAT – 前往公司 Confluence 站点 → 个人资料(头像) → Personal Access TokensCreate token请妥善保管令牌;若泄露,请立即撤销
  • Jira Base URL – 例如 https://jira.example.com/
  • Jira PAT – 按与 Confluence 相同的方式创建

提示: 由于上述字段为必填项,如果您只使用其中一个,可以用任意非空值填充另一个。

使用指南

提示: 您还可以根据自己的习惯为每个命令设置别名,以便更快访问。

可用命令

Confluence

  • 搜索内容 – 搜索页面(文章)、博客帖子、附件和评论;支持收藏
  • 搜索空间 – 搜索空间
  • 搜索用户 – 搜索用户

Jira

  • 搜索问题 – 搜索问题;支持一些简单操作,如转换问题状态和创建工作日志
  • 看板视图 – 查看看板,例如当前的活跃冲刺
  • 工作日志视图 – 查看您的工作日志
  • 通知视图 – 查看通知(如果有“未读”消息,搜索问题列表也会显示提示)
  • 管理字段 – 帮助 搜索问题 在搜索结果中显示更多信息

过滤器(每个搜索面板中均包含)

搜索内容

  • 所有内容
  • 全文搜索 – 将搜索范围从 title ~ "xxx" 扩展到 text ~ "xxx"
  • 最近查看
  • 最近更新
  • 我创建的
  • 我贡献的
  • 提及我的
  • 我的收藏
  • 我关注的

搜索问题

  • 所有问题
  • 全文搜索 – 将搜索范围从 summary ~ "xxx" 扩展到 text ~ "xxx"
  • 未解决问题
  • 我的未解决问题
  • 分配给我的
  • 我报告的
  • 最近创建
  • 最近更新
  • 最近解决
  • 最近查看
  • 我关注的

如前所述,快捷链接会随时间不断增加。收藏文章是一个不错的替代方案(操作面板提供快速的 收藏/取消收藏 操作)。搜索时,只需切换到 我的收藏 选项。

高级查询

您也可以输入完整的 CQLJQL 进行自定义高级查询:

管理自定义字段(Jira)

由于 Jira 允许自定义字段——且每个实例差异很大——管理字段 命令帮助 搜索问题 显示更多信息。

  1. 打开 管理字段
  2. 搜索您想要的字段(例如 Test Engineer)。
  3. 点击 添加到搜索

选中的字段现在会出现在 搜索问题 列表中。

Manage Fields screenshot

截图

因为 Raycast List 空间有限,许多额外信息只能隐藏在工具提示中。
将光标移到图标、标题、副标题、时间戳、头像等上即可显示。

Confluence

Confluence 截图

Jira

Jira 截图

更多截图

其他

  • Lark Documents – 搜索 Lark 文档
  • Cursor – 常用:搜索最近的项目
  • DeepWiki – 非常适合问答,可快速了解某些库的内部实现
Back to Blog

相关文章

阅读更多 »