前言

如果你用过 Alfred，还没有用过 Raycast，不妨试试，其免费订阅也足够好用（Raycast vs Alfred）。

免费订阅用户无法享用 Raycast 内置的数据同步功能，可借助 Raycast 的 Export/Import Settings & Data + iCloud Drive 进行同步。

背景

我们公司使用 Atlassian 旗下的 Confluence、Jira 做知识库、项目管理。

我们要经常打开 wiki 和 jira 页面查看相关内容，找到一篇目标文章或 Issue，往往需要几个动作才能完成：打开网页、聚焦输入框搜索、筛选...。稍快一点可能是将常用链接添加到书签或者创建 Raycast Quicklink + Alias 方便快速访问。

其中 Quicklink 有些场景很好用，比如检索文档：https://developer.mozilla.org/zh-CN/search?q={Query}，其中 {Query} 表示动态参数，也就是你要搜索的内容。只要是支持链接带参搜索的网站，都可以用这种方式，比如爱范儿的 https://www.ifanr.com/search?query={Query}。

但这种搜索方式在公司内部的 wiki、jira 中行不通。另外，通过创建 Quicklink 的方式其实“不太适合”公司内的文档检索。试想，随着时间积累，要访问、收藏的链接只会越来越多，无论是浏览器书签或 Quicklink 只会越来越多。

于是产生了开发一个 Raycast 扩展的想法，以支持 Confluence 和 Jira 的快速搜索以及部分简单操作。恰好公司私有部署版本（Data Center）也支持以 Personal Access Token 的方式进行身份认证，这是一种安全的认证方式以便于与外部程序集成。了解更多

开始之前

安装 Raycast 后，前往 Raycast Store 安装 Atlassian Data Center (Self-Hosted) 扩展。

使用该扩展的命令时，会引导完成一些初始配置，准备好以下信息：

  • Confluence Base URL：如 https://confluence.example.com
  • Confluence PAT：前往公司 Confluence 网站，在 Profile（头像处） → Personal Access Tokens → Create token（请妥善保管访问令牌，如有泄露，及时撤销）
  • Jira Base URL：https://jira.example.com
  • Jira PAT：创建方式跟 Confluence 同理

PS：由于以上配置做成必填的，如果只用到其一，另一个可以随便填个值，非空便可。

使用指南

PS：还可以根据个人习惯为命令设置 Alias 更方便直达命令

目前 Atlassian Data Center 提供的命令有：

  • Confluence
    • Search Contents - 搜索页面（文章）、博文、附件、评论，支持收藏功能
    • Search Spaces - 搜索空间
    • Search Users - 搜索用户
  • Jira
    • Search Issues - 搜索 Issue，并支持一些简单的操作，比如扭转 Issue 状态、创建 Worklog
    • Board View - 看板，比如当前 Active Sprint
    • Worklog View - 你的工作记录
    • Notification View - 通知列表（若有“未读”消息，在 Search Issues 列表也会提示）
    • Manage Fields - 该命令的作用是辅助 Search Issues 以在搜索结果展示更多内容

每个搜索面板都内置了很多常用的筛选项（日常应该管够了）：

  • Search Contents
    • All Contents
    • Full Text Search - 搜索范围从 title ~ "xxx" 放宽到 text ~ "xxx"，而不仅仅搜索标题
    • Viewed Recently
    • Updated Recently
    • Created by Me
    • Contributed by Me
    • Mention Me
    • My Favourites
    • Watched by Me
  • Search Issues
    • All Issues
    • Full Text Search - 搜索范围从 summary ~ "xxx" 放宽到 text ~ "xxx"
    • Open Issues
    • My Open Issues
    • Assigned to Me
    • Reported by Me
    • Created Recently
    • Updated Recently
    • Resolved Recently
    • Viewed Recently
    • Watched by Me

前面提到时间越长 Quicklink 越多的情况，我认为将文章进行收藏是一个不错的方案（在 Action Panel 提供了快速收藏和取消收藏），检索时切换至 My Favourites 选项便可。

除此之外，还支持键入完整的 CQL 或 JQL 进行定制化的高级查询：

再提一句：

由于 Jira 允许自定义字段，字段类型繁多，加之各家 Jira 实例大不相同，因此添加了 Manage Fields 命令来辅助 Search Issue 以显示更多信息。

比如在 Manage Fields 界面下搜索 Test Engineer 并通过「Add to Search」添加成功，那么 Search Issues 列表下就可以显示该字段信息。

截图

由于 Raycast List 显示的内容有限，很多附加信息只能隐藏在 tooltip 里，可以通过移动光标至图标、标题、副标题、时间、头像等处显示。

▼ Confluence

▼ Jira

更多截图

其他

个人常用的一些 Raycast 扩展，但不一定适合你，按需食用：

1
0