工作原理

chefe sync 把你那一份 chefe.toml 编译成 .chefe/ 下的原生 manifest，接着 chefe install 把每一份交给真正的工具，由它们求解并构建出一个共享的统一环境。

flowchart TB
    subgraph recipe["一份食谱（chefe.toml）"]
        direction LR
        D["[deps]<br/>conda"]
        PY["[python.deps]"]
        NP["[nodejs.deps]"]
        CG["[rust.deps]"]
    end

    subgraph compiled["chefe sync 生成 .chefe/"]
        direction LR
        PT["pixi.toml"]
        PJ["package.json"]
    end

    subgraph solve["chefe install 调用真正的工具"]
        direction LR
        PIXI["pixi<br/>conda-forge + Python"]
        NPM["npm"]
        CARGO["cargo<br/>via pixi run cargo"]
    end

    ENV(["一个已激活的环境<br/>.chefe/ 前缀加入 PATH"]):::brand

    D --> PT
    PY --> PT
    NP --> PJ
    CG -. 无文件，就地安装 .-> CARGO

    PT --> PIXI
    PJ --> NPM

    PIXI --> ENV
    NPM --> ENV
    CARGO --> ENV

    classDef brand fill:#eab308,stroke:#1a1a1a,stroke-width:2px,color:#1a1a1a;

• 结构由 chefe 的 schema 校验，而包规格说明始终是各工具自己的职责。
• 通过 chefe add 和 chefe remove 编辑 chefe.toml 会保留你的注释和格式。
• pixi 是 conda 和 Python packages 的底层引擎，其他language/toolchain则是其上轻薄而显式的一层。

快速上手

chefe init                 # scaffold a chefe.toml
chefe add ripgrep          # conda is the default resolver
chefe add torch -l python
chefe add prettier -l nodejs
chefe install              # provision every language/toolchain at once
chefe tree                 # what's declared vs installed, per language/toolchain

接下来请看 manifest 参考 和 命令参考。