进行中 · 能力深化

把编曲交还给音乐,把确定性交还给工程

夜半是一台从零设计的原生桌面 DAW。

端到端回路时延预算
≤ 5.5 ms
整数时钟精度
960 PPQ
界面渲染目标
120 FPS
开源许可
GPLv3 + CLAP 例外

界面

内置演示工程:鼓、贝斯、铺底、主音、弦乐与打击乐

用夜半创作的作品

三部曲《慢性崩溃环 THE CHRONIC MOBIUS》

三章——I. 雨声太吵、II. 失语呢喃、III. 潮·失——组成一个沉浸式视觉体验,点击拓扑节点跃迁情绪相位。

试听《雨声太吵》——先听一耳朵;完整体验在三部曲站,视觉配合音乐。

快速开始

环境要求 → 构建 → 运行。下面的命令都可以直接复制粘贴。

环境要求

  • 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

为什么再造一台 DAW

四个不可协商的工程决定。

原生桌面,不要 Web

彻底的 Slint 矢量界面 + cpal 直驱声卡。

960 PPQ 整数时钟

所有时间都是整数 tick。

确定性是可验证的

持久化状态一律使用有序容器。

为 AI 协同而设计的接口

只绑环回、默认关闭、逐请求鉴权。

活着的版本图谱

撤销是领域操作日志的逆向重放。

开源到底,且许可清楚

整体以 GPLv3 发布。

强大功能

已经落地的能力,每一项都由代码与判据背书。

整曲总览图 Songmap

小节级四层诊断:能量、频率、疏密、情绪,附自动异常诊断;Phase 2 加段落期望包络、3 档流派预设与谱面力度虚线。段内自相似度检查已合入,可导出单文件 HTML 报告;分轨频率重叠诊断已合入。

命令行母带

--loudness-target 配 --true-peak-ceiling;目标达不到就响亮失败,绝不静默降级。

批量操作与分轨

--apply-ops 一次提交一批编曲操作;--export-stems 分轨导出,文件名保留中文等 Unicode 轨名。

采样库编辑器

--edit-samples:逐采样 FFT 测基频、音准校到 ±0.5 音分以内,合成力度层并做 RMS 归一化。

音频切片器

--slice-audio:起音检测、按音节切分、变调 / 变速 / 磁带变速,写出 SFZ 采样区。

歌词轨

--export-lyrics:歌词时间轴存进工程,导出 LRC。

工程自带一切

用到的采样与 SFZ 定义内嵌进 .yeban 容器;渲染先查内嵌、再查磁盘;旧工程逐字节不动。

原生预制

4 个 MCP 工具 + 6 个工厂预制(钢琴、大提琴、古典吉他、长笛、萨克斯、鼓组),载入即带调好的处理。

MCP 功能已经很强大:44 个 MCP 意图工具,外加 VST3 插件宿主(进程内),以及经 MCP 直通外部伶人 SVS 服务的歌声合成。

平台支持

macOS 与 Linux 有完整测试。Windows 平台测试尚不充分。UI 层面还在完善。

技术基座

每一个选型都写明了它的角色与许可。

组件 在夜半中的角色 许可
Slint声明式矢量 GUIGPLv3 / 商业双轨
cpal跨平台声卡直驱Apache-2.0
rtrb无锁通道MIT / Apache-2.0
symphonia全格式解码MPL-2.0
rubato多相重采样MIT
Rayon离线渲染并行MIT / Apache-2.0
clackCLAP 插件宿主MIT / Apache-2.0

路线图

以可机械度量的能力切片推进。

  1. 已完成基础

    v0.0.1 Phase -1 · 开源合规大扫除

    许可白名单、依赖审计、法务与商标核验。

  2. 已完成基础

    v0.1.0 Phase 0 · 九大可行性验证

    驱动时延、无锁通道、渲染帧率。

  3. 已完成基础

    v0.2.0 Phase 1 · 数据模型与存储

    工程容器、原子保存、文件锁。

  4. 已完成基础

    v0.4.0 Phase 2 · 实时音频管线

    声卡直驱、内部延迟补偿。

  5. 已完成基础

    v0.6.0 Phase 3 · 编曲工作区

    双视图同构、虚拟化卷帘。

  6. 已完成基础

    v1.0.0 Phase 4 · 意图接口与母带导出

    双协议自动化闭环、离线母带。

  7. 进行中

    now 现在 · 能力深化

    MIDI 人性化(引擎 v2 + L3/L4)、相位对齐(手动 + 自动)、Songmap 分轨频率重叠、Songmap HTML 报告、OTCP 校音驱动、分轨导出中文文件名均已合入;Synth VST3 插件一期已落地,深化继续。

开源与治理

自由软件的承诺要落到可执行的机制上。

GPLv3 + CLAP 例外

项目整体以 GPLv3 开源。

机械化的依赖审计

每个依赖都要通过白名单许可检查。

为人机协作写的工程契约

规范、门禁与开发纪律都以机器可执行的形式存在。

公开的设计过程

架构规范、工程路线图与调研报告都在仓库中公开。

联系

欢迎讨论架构、门禁与音频工程。

邮箱
yeban@wangda.today
源码仓库
github.com/gradetwo/yeban
本网站
yeban.wangda.today