背景
BitFun 已支持 CLI 模式(src/apps/cli/),基于 ratatui + crossterm 构建终端用户界面,支持交互式 TUI、单次执行、会话管理、ACP 协议服务等多种模式,与桌面版共享同一 bitfun-core 内核。
当前 CLI 的使用方式是通过 cargo run 或 cargo build --release 从源码构建,缺少便捷的分发渠道。
目标
为 bitfun-cli 构建 Homebrew 包,让 macOS 用户可以一键安装:
方案建议
第一阶段:自定义 Tap(推荐立即执行,无需审核)
创建组织下的 Homebrew Tap 仓库(如 GCWing/homebrew-tap),托管 formula,用户通过以下方式安装:
brew tap GCWing/tap
brew install bitfun-cli
Formula 要点:
- 二进制名称:
bitfun-cli(由 src/apps/cli/Cargo.toml 定义)
- 当前版本:
0.2.7
- 需要按 macOS 架构分别构建(aarch64-apple-darwin / x86_64-apple-darwin)
- 附带
test do 块执行 bitfun-cli --version 验证
第二阶段:homebrew-core 官方(稳定后推进)
当版本达到 1.0.0、项目积累足够知名度后,再提交到 homebrew-core,实现 brew install bitfun-cli 无前缀安装。homebrew-core 对 0.x 版本和知名度有严格审核门槛。
相关工作
- CLI 源码:
src/apps/cli/src/main.rs
- 构建命令:
pnpm run cli:build(即 cd src/apps/cli && cargo build --release)
- 支持的模式:交互式 TUI(默认)、单次执行(
exec)、会话管理(sessions)、配置管理(config)、ACP 协议(acp)、健康检查(health)
可选扩展
- 添加 GitHub Actions 工作流自动构建并发布到 Tap
背景
BitFun 已支持 CLI 模式(
src/apps/cli/),基于 ratatui + crossterm 构建终端用户界面,支持交互式 TUI、单次执行、会话管理、ACP 协议服务等多种模式,与桌面版共享同一bitfun-core内核。当前 CLI 的使用方式是通过
cargo run或cargo build --release从源码构建,缺少便捷的分发渠道。目标
为
bitfun-cli构建 Homebrew 包,让 macOS 用户可以一键安装:方案建议
第一阶段:自定义 Tap(推荐立即执行,无需审核)
创建组织下的 Homebrew Tap 仓库(如
GCWing/homebrew-tap),托管 formula,用户通过以下方式安装:Formula 要点:
bitfun-cli(由src/apps/cli/Cargo.toml定义)0.2.7test do块执行bitfun-cli --version验证第二阶段:homebrew-core 官方(稳定后推进)
当版本达到 1.0.0、项目积累足够知名度后,再提交到 homebrew-core,实现
brew install bitfun-cli无前缀安装。homebrew-core 对 0.x 版本和知名度有严格审核门槛。相关工作
src/apps/cli/src/main.rspnpm run cli:build(即cd src/apps/cli && cargo build --release)exec)、会话管理(sessions)、配置管理(config)、ACP 协议(acp)、健康检查(health)可选扩展