zt-devops-cli 0.1.9

DevOps 平台迭代管理 CLI

DevOps CLI

蓝鲸 DevOps 平台迭代管理命令行工具。

打包

python -m pip install --upgrade build twine
python -m build
twine upload dist/*

安装

• 源码安装

pip install -e .

• pip安装

pipx install zt-devops-cli

使用

登陆

首次运行时会自动打开浏览器，请登录蓝鲸 DevOps。登录成功后 cookie 会缓存到本地。

zt-devops-cli login

空间管理

zt-devops-cli project list

ZTeam 项目列表

zt-devops-cli zteam-project list --project f39507

迭代管理

迭代列表

zt-devops-cli sprint list --project k64352

迭代提测列表

zt-devops-cli sprint test-list --project b9f157 \
  --search "BSC_V26.701.01" \
  --num 1 \
  --size 10

创建迭代

zt-devops-cli sprint create --project k64352 \
  --title "迭代名称" \
  --start-date 2026-04-04 \
  --end-date 2026-05-30 \
  --purpose "迭代目标"

启用迭代

zt-devops-cli sprint start --project k64352 --sprint-id <id>

删除迭代

zt-devops-cli sprint delete --project k64352 --sprint-id <id>

完成迭代

zt-devops-cli sprint done --project k64352 --sprint-id <id>

任务管理

查询任务列表（TASK）

zt-devops-cli task list --project f39507 \
  --start-date 2026-04-01 \
  --end-date 2026-04-30 \
  --creator zt07905

缺陷管理

查询缺陷列表（BUG）

zt-devops-cli bug list --project b9f157 \
  --num 1 \
  --size 20 \
  --no-remember

新增缺陷（BUG）

zt-devops-cli bug create --project b9f157 \
  --title "test" \
  --owner zt07905 \
  --zteam-project-id 15678224 \
  --field f05cf2f5dc614dbaa05a13894abb5683=9Clfj3I8fR \
  --field f672b38532614f428828d9a68a514e24=bgEHPFOjFt \
  --field 684f26d36cd747f68dde32104a701956=3129a9cd7315457eb2963bfe19919e72 \
  --field bcee87c140d3475496a2a31c236631f4=vENjmMhXMC \
  --field 8756c5b483434c2bb54bd6bc6586b09b=

新增任务（TASK）

zt-devops-cli task create --project <project-id> \ # 通过 project list 获取
  --title "<任务标题>" \
  --owner <工号> \
  --estimate-start <预计开始时间： yyyy-MM-dd> \
  --estimate-end <预计完成时间: yyyy-MM-dd> \
  --origin-hours 8.00 \ # 预估工时
  --remain-hours 8.00 \ # 实际工时
  --zteam-project-id <zteam-project-id> # 通过 zteam-project list 获取

配置

• cookie 缓存：~/.zt-devops-cli/cookies.json
• 配置文件：~/.zt-devops-cli/config.yaml