Skip to content

建议构建bitfun-cli的brew包发布到brew的仓库中 #757

@harryfan1985

Description

@harryfan1985

背景

BitFun 已支持 CLI 模式(src/apps/cli/),基于 ratatui + crossterm 构建终端用户界面,支持交互式 TUI、单次执行、会话管理、ACP 协议服务等多种模式,与桌面版共享同一 bitfun-core 内核。

当前 CLI 的使用方式是通过 cargo runcargo build --release 从源码构建,缺少便捷的分发渠道。

目标

bitfun-cli 构建 Homebrew 包,让 macOS 用户可以一键安装:

brew install bitfun-cli

方案建议

第一阶段:自定义 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions