环境要求
- Rust 1.99.0(由 rust-toolchain.toml 钉死,rustup 会自动安装;rustfmt 与 clippy 组件同样钉住)
- macOS(Apple Silicon / Intel)、Linux(X11 或 Wayland)、Windows
- Linux 构建依赖:pkg-config libfontconfig1-dev libfreetype-dev libxkbcommon-dev libwayland-dev libx11-dev libgl1-mesa-dev libasound2-dev
- macOS 构建依赖:Xcode Command Line Tools(xcode-select --install)
- 打开主窗口需要真实显示器;--headless 不需要(CI 用的就是它)
诚实状态
打不开时退出码 3 并给出容器的原始原因,绝不退化成"打开成空工程";--save-as 是原子替换(临时文件 → fsync → rename),失败时旧文件一字未改;没有 --open 时存的是内置演示工程并在输出里明说;未知开关退出 2 并打印用法。
实时引擎现在已经能产生音频了(确定性地合成工程里的 MIDI 音符)。声相定律、噪声门、压缩器、限制器、侧链触发、走带控制与 EQ 曲线显示都已合入。它还**不做**:MPE;主窗口启动时用的仍是演示工程。什么算已验证、什么仍是 PENDING,见仓库里的 docs/ledger/gate-status.md。
构建
git clone https://github.com/gradetwo/yeban.git
cd yeban
cargo build --release # 构建整个工作区(首次需要几分钟)
cargo build --release -p yeban-app # 只构建桌面 GUI 二进制
运行
cargo run --release -p yeban-app # 打开桌面主窗口(需要显示器)
cargo run --release -p yeban-app -- --headless # 无需显示器:打印 headless ok 后退出 0
cargo run --release -p yeban-app -- --help # 全部开关 + 组合语义 + 退出码
# 下面这些都不需要显示器
cargo run --release -p yeban-app -- --save-as demo.yeban # 把内置演示工程写成 .yeban
cargo run --release -p yeban-app -- --open demo.yeban --headless # 打开它并打印读到了什么
cargo run --release -p yeban-app -- --open demo.yeban --export-elements e.txt # 导出语义元素清单
cargo run --release -p yeban-mcp # Intent API v2 的 stdio 形态(MCP 服务)
测试
cargo test --workspace
cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings