SuperAPI AI 工具集

bkt

编程与开发

查看项目

更新于 10-16 05:01

技能介绍

用途:bkt 是 Bitbucket Data Center 和 Bitbucket Cloud 的统一 CLI,用于在命令行管理仓库、拉取请求、分支、议题(Cloud)、Webhook、流水线(Cloud)等,并支持结构化输出以便脚本和自动化使用。

主要能力:命令覆盖 pr、repo、branch、commit、status、webhook、auth、context、extension,以及 DC 专属的 project、perms、admin,Cloud 专属的 issue、pipeline、variable。所有命令支持 --json、--yaml、--jq、--template,并提供 bkt api 作为原始 API 逃生通道。平台差异明显:分支创建/删除/保护、权限、自动合并、任务与反应仅 DC;议题、流水线、变量仅 Cloud。

使用方式:先检查安装 bkt --version 与登录状态 bkt auth status。安装可选 brew install avivsinai/tap/bitbucket-cli、scoop、go install github.com/avivsinai/bitbucket-cli/cmd/bkt@latest 或下载二进制。登录示例:Data Center 使用 bkt auth login https://bitbucket.example.com --username alice --token <PAT>;Cloud 可使用 --web 或 --web-token。建议用 bkt context create 绑定主机与项目/工作区及默认仓库,例如 bkt context create dc-prod --host bitbucket.example.com --project ABC --set-active。

适用场景:CI/CD 与容器中可使用无配置鉴权(BKT_TOKEN、BKT_HOST);日常用 bkt pr create、bkt pr checks 42 --wait、bkt pr approve 42、bkt pr merge 42、bkt pr checkout 42 完成评审流程;用 bkt pr list --mine --json 配合 jq 做脚本化处理。

限制:需区分 DC 与 Cloud 命令,未知平台应先确认;Cloud 的 API token 需选用带作用域的 token 并至少具备 Account: Read(read:user:bitbucket),其他作用域按需添加。部分功能平台专属,源构建或 Nix 构建使用 --web 前需设置 BKT_OAUTH_CLIENT_ID 与 BKT_OAUTH_CLIENT_SECRET。其他未在资料中说明的细节暂未提供。