跳转到主要内容

发布命令

列出发布

# All releases
apollo release list

# Filter by project
apollo release list -p "Apollo"

# Filter by status
apollo release list -p "Apollo" -s in_progress

查看发布详情

显示发布元数据、按状态分布的任务统计和完成百分比:
apollo release view "v2.1.0"
v2.1.0
────────────────────────────────────────────────────────────
  Version: 2.1.0
  Status:  In Progress
  Date:    3/1/2026
  Project: Delfin One
  ID:      550e8400-...

  Tasks (18)
  Progress: 67% — 12/18 done
  In Progress: 3 | Todo: 2 | Blocked: 1

  In Progress    #142 Fix authentication bug
  In Progress    #147 Add retry logic
  Done           #130 Implement login flow
  ...

创建发布

apollo release create \
  -n "v2.2.0" \
  -p "Delfin One" \
  -v "2.2.0" \
  -d 2026-04-01 \
  --description "Q2 feature release"
选项:
Flag描述
-n, --name <name>发布名称(必填)
-p, --project <name>项目名称或 ID(必填)
-v, --version <version>版本号字符串(如 2.2.0
-d, --date <date>目标发布日期(YYYY-MM-DD)
--description <desc>发布描述

更新发布

创建后可更新任何发布字段:
# Change status
apollo release update "v2.2.0" -s in_progress

# Update target date and description
apollo release update "v2.2.0" -d 2026-05-01 --description "Pushed to May"

# Rename
apollo release update "v2.2.0" -n "Q2 Release"
选项:
Flag描述
-n, --name <name>新的发布名称
-v, --version <version>新的版本号字符串
-s, --status <status>新状态(plannedin_progressreleased
-d, --date <date>新的目标日期(YYYY-MM-DD)
--description <desc>新描述

将任务分配到发布

通过显式 ID 或筛选条件将任务关联到发布:
# Assign specific tasks
apollo release assign-tasks "v2.2.0" --ids "id1,id2,id3"

# Assign all unassigned todo tasks in a project
apollo release assign-tasks "v2.2.0" -p "Apollo" -s todo --unassigned-only
选项:
Flag描述
--ids <id1,id2,...>要分配的逗号分隔的任务 ID
-p, --project <name>按项目筛选任务
-s, --status <status>按状态筛选任务
--unassigned-only仅分配尚未归属发布的任务

项目命令

列出项目

apollo project list

查看项目详情

显示项目的任务摘要统计(按状态分类):
apollo project view "Apollo"

导出项目数据

以多种格式导出项目信息。适用于报告、备份和集成:
# Export as JSON (default)
apollo project export "Apollo" --include-tasks --include-releases

# Export tasks as CSV
apollo project export "Apollo" --include-tasks --format csv > tasks.csv

# Export as Markdown
apollo project export "Apollo" --include-tasks --include-releases --format markdown
选项:
Flag描述
--format <type>输出格式:json(默认)、csvmarkdown
--include-tasks在导出中包含所有项目任务
--include-releases在导出中包含所有项目发布
格式详情:
格式内容
JSON完整的结构化数据 — 项目 + 任务 + 发布以 JSON 格式输出
CSV仅任务 — 每个任务一行,列包括:ID、Title、Status、Priority、Assignee、Due Date
Markdown可读报告,包含项目元数据、任务表格和发布列表

状态面板

status 命令为您提供个人概览 — 您在所有项目中的任务、即将到来的截止日期和阻塞项:
apollo status