跳至正文
浏览章节

安装

用稳定版 Rust 工具链从源码构建 bingo，并确认这个二进制程序能应答。

从源码安装

预编译程序可以从 GitHub Releases 下载。 如果希望从源码安装，请使用下面的仓库和稳定版 Rust 工具链。

你需要什么

  • Rust 1.96 或更新，stable 通道。 工作区是 Rust 2024 edition，并设了 rust-version = "1.96"；rust-toolchain.toml 把通道钉在 stable，并要求 rustfmt 和 clippy，所以你在仓库里构建时，rustup 会自己选对工具链。
  • git，用来克隆。

构建

git clone https://github.com/yexrob/bingo
cd bingo
cargo install --path crates/bingo --locked

cargo install 会把 bingo 二进制放进 cargo 的 bin 目录，除非你挪过它，否则就是 ~/.cargo/bin。运行 bingo 前，请确保该目录已加入 PATH。 如果你更愿意把构建留在树里——比如正在开发 bingo 本身——那就改为构建 一个 release 二进制：

cargo build --release

它会把二进制留在 target/release/bingo。

检查

$ bingo --help
A local coding-agent harness

Usage: bingo [OPTIONS] [PROMPT] [COMMAND]

Commands:
  serve     Serve sessions over JSON-RPC to one client (ADR-0007)
  login     Sign in to a provider; the browser opens unless told otherwise (ADR-0012)
  logout    Forget a provider's stored credential
  provider  Named provider instances: more endpoints than the three built in (ADR-0017)
  channels  Listen on the configured IM channels and nothing else (ADR-0016)
  gateway   One resident bingo per data dir, managed like a service (ADR-0020)
  help      Print this message or the help of the given subcommand(s)

bingo --version 打印这次构建的版本。

bingo 把东西放在哪里

一个目录装下全部，就在你的主目录下：

路径那里放着什么
~/.bingo/settings.json你的设置，最低的一层（ADR-0003）
~/.bingo/plugins/<name>/你装的跨进程插件（ADR-0015）
~/.bingo/skills/<name>/SKILL.md你的技能（ADR-0009）
~/.bingo/data/auth.json凭据，权限位 0600（ADR-0012）
~/.bingo/data/sessions/<id>/每个会话一个目录：journal.jsonl、.lock、summary.json（ADR-0005）
~/.bingo/data/logs/MCP 服务器与插件进程的 stderr

一个项目在自己的代码旁边留着自己的那几层，放在 .bingo/ 里——属于这个仓库而不属于你 的设置、技能和插件。

下一步：快速上手。