项目管理
Paid把 Carbon 质量问题关联到 Linear 或 Jira,让工程团队在自己的工具中跟踪。
Carbon 可以把的动作任务关联到 Linear 或 Jira 问题。状态、负责人和备注双向同步。
Linear
使用 Linear API 密钥(以 lin_api 开头)认证。
在 Linear 中创建 Webhook
在 Linear 的 API 设置中新建 Webhook,粘贴 Carbon 设置说明中显示的 URL
(/api/webhook/linear/<你的公司 ID>),使 Linear 的变更能到达 Carbon。
复制签名密钥
Linear 在 Webhook 详情页显示 signing secret(签名密钥)。粘贴到 Webhook Signing Secret。 Carbon 随后只接受 Linear 签名且不超过一分钟的 Webhook 请求。
粘贴 Linear API 密钥
提供你的 Linear API 密钥。Carbon 会检查 lin_api 前缀。
动作任务同步
把不合格项动作任务关联到 Linear 问题。Carbon 双向同步状态、负责人和备注。
| 设置 | 控制内容 |
|---|---|
| API 密钥 | 你的 Linear API 密钥——Carbon 检查 lin_api 前缀。 |
| Webhook 签名密钥 | 可选。设置后,没有有效 Linear 签名的 Webhook 请求会被拒绝。 |
没有保存密钥的 Webhook 仍兼容旧配置,但 Carbon 无法认证其请求。请为每个 Webhook 配置密钥。
Jira
通过 OAuth 连接。唯一的设置是可选 Webhook 密钥。
通过 OAuth 授权
在 Jira 中授权 Carbon。
在 Jira 中创建 Webhook(可选)
要立即把 Jira 变更发送到 Carbon,请在 Jira 的 System → WebHooks 中创建一个
Webhook,URL 使用 Carbon 设置说明中显示的值(/api/webhook/jira/<你的公司 ID>),
订阅 Issue updated 和 Issue deleted。填写 Webhook 的 Secret 字段,并把
同一值粘贴到 Carbon 的 Webhook Secret。保存后,Carbon 只接受 Jira 已签名的 Webhook 请求。
关联动作任务
把不合格项动作任务关联到 Jira 问题。Carbon 双向同步状态、负责人和备注。
| 设置 | 控制内容 |
|---|---|
| Webhook 密钥 | 可选。设置后,没有有效 Jira 签名的 Webhook 请求会被拒绝。 |
只有在服务端配置了 JIRA_CLIENT_ID 时才会出现 Jira。参见环境变量。