cnb-rs

在命令行中高效管理你的 CNB 平台资源。

WARNING

旧命令 cnb 已改为 cnb-rs。如果你是从旧版本升级，请先阅读 从 cnb 迁移到 cnb-rs。

常用命令

• cnb-rs auth — 认证管理
• cnb-rs api — 直接调 CNB OpenAPI（类 gh api）
• cnb-rs config — 配置管理
• cnb-rs issue — Issue 管理
• cnb-rs pr — PR 管理
• cnb-rs release — Release 管理
• cnb-rs commit — Commit 管理

仓库命令

• cnb-rs repo — 仓库管理
• cnb-rs build — 构建管理
• cnb-rs label — 标签管理
• cnb-rs badge — 徽章管理
• cnb-rs browse — 在浏览器中打开仓库页面
• cnb-rs download — 下载仓库文件
• cnb-rs info — 显示仓库和用户信息

组织与制品管理

• cnb-rs group — 组织管理
• cnb-rs mission — 任务集管理
• cnb-rs registry — 制品库管理
• cnb-rs knowledge — 知识库管理

用户与安全

• cnb-rs user — 用户信息
• cnb-rs gpg-key — GPG 密钥管理

Extension 管理

• cnb-rs ext — 管理 cnb-rs extension（list / install / exec / upgrade / remove 全部 ship；含 24h 自动 update check）

其他命令

• cnb-rs workspace — 云原生工作区管理
• cnb-rs completion — 生成命令行补全脚本
• cnb-rs version — 显示版本信息

选项

--domain <DOMAIN>     指定 CNB 域名（默认: cnb.cool）
--repo <OWNER/REPO>   指定仓库路径
--json                以 JSON 格式输出
--jq <EXPR>           用 mini-jq 筛选 JSON 字段（隐含 --json）
--version             显示版本号
-h, --help            显示帮助信息

mini-jq JSON 筛选

所有支持全局 --json 的命令都支持 --jq <EXPR>，并且 --jq 会隐含启用 JSON 输出。mini-jq 支持以下语法：

表达式	行为
.	保留完整 JSON
.field	提取单个字段
.parent.child	提取嵌套字段
.field1,.field2	保留多个字段
.items[]	遍历数组字段
.items[].field	遍历数组并提取每个元素的字段
.[].field	顶层 JSON 是数组时提取每个元素的字段

字段访问会自动映射数组元素，提取数组元素字段时 .[] 可以省略，例如顶层数组的 .field 与 .[].field 结果一致。单路径中字段不存在时返回 null。筛选结果是字符串时直接输出裸字符串；数组和对象仍输出 JSON。管道、select(...)、数组下标等复杂表达式请 pipe 到外部 jq。

cnb-rs issue view 305 --repo wwvo/cnb-rs/cnb-rs --jq '.title'
cnb-rs issue view 305 --repo wwvo/cnb-rs/cnb-rs --comments --jq '.comments[].body'
cnb-rs issue list --repo wwvo/cnb-rs/cnb-rs -L 3 --jq '.[].number'

示例

$ cnb-rs auth login
$ cnb-rs issue list
$ cnb-rs api /user --jq .username
$ cnb-rs download --files README.md
$ cnb-rs pr create