用途:在任意仓库中安装并配置 Prelude(darkmatter/prelude)——一个 devshell UI 套件,包含 nix develop 欢迎横幅(MOTD)、交互式命令选择器(x)、Markdown 文档查看器和主题化 Starship 提示符。无需克隆 Prelude 仓库。
主要能力:提供 flake-parts 模块;非 flake-parts 的 flake 可用 prelude.lib.evalModule。全部从已发布的 flake 运行。查看文档:nix run github:darkmatter/prelude#skill -- install(消费者完整走查)与 -- options(生成 prelude.* 参考)。
新装用法:从项目根目录运行 nix run github:darkmatter/prelude -- wizard(需交互终端),设置标题与 FIGlet 字体、项目名、命令、组件开关、MOTD、主题;生成 prelude.nix(完整选项模板)、title.txt 和 .envrc(内容为 use flake)。-o path 可移动前两者;向导拒绝 -o flake.nix,且从不写入或替换 flake。完全没有 flake 时用 nix flake init -t github:darkmatter/prelude#default 生成起始脚手架。接入时合并而非替换 flake.nix:加入 inputs.prelude.url、imports 中 inputs.prelude.flakeModules.default 与 ./prelude.nix,并在 devShell 中仅添加 config.packages.prelude-shell,不要添加 packages.prelude。非 flake-parts 场景用 evalModule 就地求值同一 sidecar,模块参数通过 _module.args 包装模块传递。
激活与定制:nix develop 为完整交互 devshell;direnv(nix-direnv)加载缓存环境,lorri 改走 eval "$(lorri export direnv-adapter)",自定义 shellHook 使用 eval "$(prelude-preflight)",不要在 shellHook 中 export -f。可在生成的 prelude.nix 中调整主题、prelude.commands.<key> 目录项与 prelude.docs.pages。
限制与注意:Git 型 flake 会忽略未跟踪文件,需按需 git add;也可用 nix develop path:. 与 nix flake check path:. 在可信工作树上验证。非交互 nix develop -c 默认静默。资料未提供定价与更多平台信息。