Skip to content

Jira 事项抽屉 ​

浏览、编辑 Jira Cloud 或自托管 Server/Data Center 的 issue,并把它们关联到 worktree,方式与关联 Linear 或 GitHub 事项完全一致。

在任务抽屉中,Jira 与 GitHub、Linear 并列。你可以浏览 Jira issue、更新它们,并直接从任意 issue 创建 worktree,全程不必离开 DevAgent。

连接 Jira 站点 ​

  1. 打开侧边栏的 Tasks 条目,在来源选择器中选择 Jira —— 即便还没保存任何凭据,Jira 默认也会与 GitHub、Linear 并列出现。
  2. 点击 Connect Jira,弹出 Connect Jira site 对话框。
  3. 选择 Cloud 或 Self-hosted (Server / Data Center)。

Cloud

Self-hosted

  • Jira base URL —— 你的 Server/DC 基础地址(如果 Jira 不在 / 路径下,需包含路径)。
  • 认证方式:
    • Personal access token —— Bearer PAT(现代 Server/DC 首选)。
    • Username and password —— 供不支持 PAT 的旧实例使用的 Basic auth。
  1. 点击 Connect。DevAgent 会校验凭据并加载你的站点。

你可以连接多个 Atlassian 站点。连接站点后,Tasks 头部会出现站点选择器;选择 All sites 可跨站点合并显示 issue。

如果你完全不使用 Jira,可通过 设置 → 任务 将它从来源选择器中隐藏。

使用 Jira ​

  • 启用各来源后,任务抽屉会在一个统一列表中同时显示 GitHub、Linear 和 Jira 的 issue。
  • 打开某个 issue,可在侧边抽屉中查看完整描述、评论和元数据。你可以就地编辑状态(通过可用的状态流转)、优先级、指派人和自定义字段。
  • 在抽屉的评论编辑器中添加评论。
  • 如果你不小心关闭了 New Jira issue 对话框(Escape、Cancel、点击外部或关闭),标题和描述会保留。在同一次应用会话中重新打开对话框时会恢复这些文本;成功创建后草稿清空,且不会在应用重启后保留。issue 类型及其他选择器仍使用它们通常的打开时默认值。
  • 从 Jira issue 创建 worktree 会预填任务名称,并把 worktree 关联到该 issue,这样评审与 issue 就始终绑定在一起。
  • 在 Create workspace 对话框中,你也可以把 Jira issue URL(https://…/browse/ABC-123)粘贴到名称字段,或把该字段切换为 Jira 搜索并按文本选取一个 issue。DevAgent 会填好工作区名称、关联 issue,并在 worktree 卡片上显示 key + 摘要以及 View on Jira。粘贴功能支持多站点:当多个已连接站点都匹配 URL 来源时,DevAgent 会询问使用哪个站点;当没有匹配时,它会提示该站点尚未连接。
  • DevAgent 会按仓库记住你上次使用的任务来源,因此以 Jira 驱动的仓库下次打开时默认选择 Jira。

凭据存放位置

你的 Atlassian API token 或自托管凭据通过操作系统密钥链加密并存储在本地 —— 它们只用于调用你配置的 Jira 站点。如果你不再使用 DevAgent,可在 Atlassian 账户设置中吊销这些 token。

后续步骤 ​

DevAgent 桌面客户端文档