跳转到内容

快速开始

安装

Release 页面 下载适合你平台的发布产物。

如果你只想快速把 cnb-rs 放到本机可执行路径里,也可以直接使用仓库里的安装脚本:

bash
curl -fsSL https://cnb.cool/wwvo/cnb-rs/cnb-rs/-/git/raw/main/scripts/install.sh | bash
powershell
irm https://cnb.cool/wwvo/cnb-rs/cnb-rs/-/git/raw/main/scripts/install.ps1 | iex

如果你希望固定在某个版本,也可以直接从对应 Release 下载版本化脚本:

bash
bash ./cnb-rs-v<VERSION>-install.sh
powershell
powershell -ExecutionPolicy Bypass -File .\cnb-rs-v<VERSION>-install.ps1

如果你希望第一跳和后续附件都走 GitHub,可以改用 GitHub 托管的脚本入口:

bash
curl -fsSL https://raw.githubusercontent.com/wwvo/cnb-rs/main/scripts/install.sh | CNB_RS_INSTALL_SOURCE=github bash
powershell
$env:CNB_RS_INSTALL_SOURCE = "github"; irm https://raw.githubusercontent.com/wwvo/cnb-rs/main/scripts/install.ps1 | iex

这两个脚本会自动识别系统与架构,默认从 CNB Release 下载对应压缩包,也可以通过 CNB_RS_INSTALL_SOURCE=github--source github-Source github 切换到 GitHub Release,并校验 sha256sum.txt。如果你在 shell 管道里用环境变量切换下载源,请把变量放在 bash 那一侧,而不是放在 curl 前面。如果你不显式指定版本,它们会使用仓库当前维护的默认发布版本;如果你下载的是某个 Release 自带的 cnb-rs-v<VERSION>-install.shcnb-rs-v<VERSION>-install.ps1,默认就会安装该版本。它们只安装 cnb-rs 二进制文件,不会附带 .deb / .rpm 的 shell 补全,也不会替代 Windows 的 .msixbundle / .msi 安装流程。

Linux

当前 Linux 原生包覆盖 x86_64-unknown-linux-gnuaarch64-unknown-linux-gnu

bash
# Debian / Ubuntu(x86_64)
sudo dpkg -i ./cnb-rs_*_amd64.deb

# Debian / Ubuntu(arm64)
sudo dpkg -i ./cnb-rs_*_arm64.deb

# Fedora / Rocky / AlmaLinux(x86_64)
sudo dnf install ./cnb-rs-*.x86_64.rpm

# Fedora / Rocky / AlmaLinux(arm64)
sudo dnf install ./cnb-rs-*.aarch64.rpm

如果你的环境不适合 .deb / .rpm,也可以继续下载 .tar.gz 手动解压,并把 cnb-rs 放到 PATH 中。

NOTE

当前只提供 release 附件下载,不提供 apt / yum 软件源托管;其他 Linux 目标目前仍以 .tar.gz 为主。

更多说明见:Linux 安装说明

Windows

Windows 当前提供以下 Windows 原生安装形态:

  • cnb-rs-v<VERSION>-windows-msvc.msixbundle
    • 覆盖 x86_64-pc-windows-msvcaarch64-pc-windows-msvc
    • 适合希望使用 Windows 原生包安装与 execution alias 的用户
  • x86_64-pc-windows-msvc.msi
    • 默认推荐给偏好传统机器级安装的 x86_64 用户
  • aarch64-pc-windows-msvc.msi
    • 推荐给偏好传统机器级安装的 Windows arm64 用户
  • x86_64-pc-windows-gnu
    • 作为 x86_64 GNU toolchain 变体提供
powershell
Add-AppxPackage .\cnb-rs-v<VERSION>-windows-msvc.msixbundle
# 或
msiexec /i .\cnb-rs-v<VERSION>-x86_64-pc-windows-msvc.msi

如果 Windows 提示发布者未受信任,请先从同版本 Release 下载 cnb-rs-v<VERSION>-windows-msvc-signing-cert.cer 并导入,再执行 Add-AppxPackage。更完整的说明见:Windows 安装说明

如果你不希望使用 MSIX 或 MSI,或者当前目标不在上述覆盖范围内,也仍然可以继续使用 release 页面中的 .zip 压缩包附件。

NOTE

当前 .msixbundle / .msix 覆盖 x86_64-pc-windows-msvcaarch64-pc-windows-msvcx86_64-pc-windows-gnu 当前继续使用 .msi

更多说明见:Windows 安装说明

macOS

macOS 当前继续使用 release 页面中的 .tar.gz 压缩包附件;如果你不想手工解压,也可以直接使用上面的 scripts/install.sh

如果你更偏好包管理器方式,也可以直接使用:

bash
# Homebrew(macOS / Linux)
brew tap wwvo/cnb-rs https://cnb.cool/wwvo/cnb-rs/homebrew-cnb-rs.git
brew install wwvo/cnb-rs/cnb-rs
powershell
# Scoop(Windows)
scoop bucket add cnb-rs https://cnb.cool/wwvo/cnb-rs/scoop-cnb-rs.git
scoop install cnb-rs/cnb-rs

边界说明:

  • Homebrew 当前适合 macOS,以及偏好使用 brew 的 Linux 用户
  • Scoop 当前适合 Windows 用户
  • 这两种方式依赖外部分发仓库,不替代 release 页面附件或 MSI 安装包

WARNING

从改名版本开始,原来的 cnb ... 已改为 cnb-rs ...。 如果你是从旧版本升级,请先阅读 从 cnb 迁移到 cnb-rs

登录

bash
cnb-rs auth login
# 或直接指定 Token
cnb-rs auth login --token <YOUR_TOKEN>

基本使用

bash
# 查看当前认证状态
cnb-rs auth status

# 查看仓库信息
cnb-rs info

# 查看 Issue 列表
cnb-rs issue list

# 使用 AI 对话
cnb-rs chat --do "查看我的 Issue 列表"

升级自旧版本

  • 旧命令:cnb ...
  • 新命令:cnb-rs ...
  • 如果你想保留旧输入习惯,请自行配置 shell alias
  • Linux 用户若改用 .deb / .rpm 安装,补全文件会随包一起安装,无需再手工拷贝 Bash / Zsh / Fish 补全脚本

完整迁移说明见:从 cnb 迁移到 cnb-rs

Released under the MIT License.