文档 / 审查 / Jira 事项抽屉

Jira 与 GitHub 和 Linear 并排显示在任务抽屉中。浏览 Jira 问题、更新它们，并基于任意问题创建工作树，而无需离开 Orca。

连接 Jira 站点¶

1. 打开 任务 侧边栏条目，并从来源选择器中选择 Jira —— 默认情况下，Jira 与 GitHub 和 Linear 并排显示，即使尚未保存任何凭据。
2. 点击 连接 Jira。将出现 连接 Jira 站点 对话框。
3. 选择 云 或 自托管（Server / Data Center）。

云

• Jira Cloud 站点 URL —— 例如 https://example.atlassian.net。
• Atlassian 邮箱 —— 你 Atlassian 账户上的地址。
• Atlassian API 令牌 —— 在 id.atlassian.com → 安全 → API 令牌 创建一个。

自托管

• Jira 基础 URL —— 你的 Server/DC 基础地址（如果 Jira 不在 / 下，则包含路径）。
• 身份验证方法：
• 个人访问令牌 —— Bearer PAT（现代 Server/DC 的首选方式）。
• 用户名和密码 —— 用于没有 PAT 的旧实例的 Basic 身份验证。

尽可能对云和自托管 Jira 使用 https:// URL。Orca 会在 Authorization 请求头中发送凭据；纯 HTTP 可能会在网络中暴露它们。如果服务器仅提供 HTTP，请在连接之前将其置于受信任的 HTTPS 隧道或 VPN 之后。

1. 点击 连接。Orca 会验证凭据并加载你的站点。

你可以连接多个 Atlassian 站点。连接站点后，任务标题栏中会出现站点选择器；选择 所有站点 以合并它们之间的问题。

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

使用 Jira¶

• 启用每个来源后，任务抽屉会以统一列表显示 GitHub、Linear 和 Jira 问题。
• 打开一个问题，可在侧边抽屉中查看完整描述、评论和元数据。内联编辑状态（通过可用转换）、优先级、负责人和自定义字段。
• 从抽屉的评论编辑器中添加评论。
• 如果你不小心关闭 新建 Jira 问题 对话框，标题和描述会保留 —— 按 Escape、取消、点击外部或关闭。在同一应用会话中重新打开对话框时，文本会恢复；成功创建后草稿会清除，并且不会在应用重启后保留。问题类型和其他选择器仍使用其通常的打开时默认值。
• 从 Jira 问题创建工作树会预填任务名称，并将工作树链接到该问题，从而让评审和问题保持关联。
• 在 创建工作区 对话框中，你还可以将 Jira 问题 URL（https://…/browse/ABC-123）粘贴到名称字段，或将字段切换为 Jira 搜索并按文本选择问题。Orca 会填写工作区名称、链接问题，并在工作树卡片上显示问题键 + 摘要，带有 在 Jira 中查看。粘贴支持多站点：当多个已连接站点匹配 URL 源时，Orca 会询问使用哪个站点；当没有匹配时，它会提示该站点未连接。
• Orca 会记住每个仓库最近使用的任务来源，因此以 Jira 为主的仓库下次打开时默认使用 Jira。

你的 Atlassian API 令牌或自托管凭据会通过操作系统密钥链加密并 本地存储 —— 它们仅用于调用你配置的 Jira 站点。如果你停止使用 Orca，请从 Atlassian 账户设置中吊销令牌。

后续步骤¶

• Linear 条目抽屉 —— 针对 Linear 的相同流程。
• 托管评审、问题与 Actions —— 一旦 Jira 问题进入进行中，就将工作树移交给托管评审。
• 从 Orca 提交并推送 —— 无需离开 Orca 即可发布分支。