# 尼克斯玛技能 ## 概述 [Nixomatic]() 是一项 Nix flake 生成器服务，可根据 URL 参数即时创建可重现的开发环境。您无需编写和维护“flake.nix”文件，而是构建一个类似“https://nixomatic.com/?p=nodejs,python3”的 URL 并将其直接传递给“nixdevelop”。该服务生成并提供带有请求的包的 Nix flake——无需本地 Nix 配置或 flake 创作。每当用户要求构建、编译、测试、lint、格式化、类型检查、运行或设置项目时，或者当命令因缺少工具或运行时而失败时，请使用此技能。 ## 检测 Nix 与 Docker 在运行任何环境命令之前，请确定哪个运行时可用： 1. 检查 `nix` 是否在 PATH 上（`which nix`）。如果找到，直接使用Nix。 2. 如果未找到“nix”，请检查“docker”是否在 PATH 中（“which docker”）。如果找到，请使用 Docker 包装器。 3. 如果两者都不可用，请通知用户必须安装 Nix 或 Docker 之一并提供链接： *尼克斯： * Docker： ## 分析项目 **重要提示：**切勿读取或访问可能包含机密的文件（`.env`、`.env.*`、`credentials.json`、`*-credentials.*`、`*.pem`、`*.key`、私钥文件或令牌文件）。仅检查文件名以确定需要哪些包 - 不要读取文件内容，除非它们是项目清单（例如“package.json”、“Cargo.toml”、“go.mod”）。通过按以下顺序扫描文件来确定项目需要哪些包： 1. **检查 README.md 中现有的 nixomatic URL**：查找包含“nixomatic.com” URL 的“## Development Environment”部分。如果找到，请重用该 URL 作为基线（它代表最后一个已知良好的包集）。仅在缺少某些内容时添加包。 2. **检查`flake.nix`**：如果项目根目录包含`flake.nix`，则优先选择项目自己的 flake 而不是 nixomatic。使用本地 flake 通过 `nixdevelop --command -- ` 运行命令。在这种情况下，不要生成 nixomatic URL。 3. **从项目文件中检测语言和运行时**： * `package.json` -> `nodejs` * `Cargo.toml` -> `rustc,cargo` * `go.mod` -> `go` * `requirements.txt`、`setup.py`、`pyproject.toml` -> `python3` * `Gemfile` -> `ruby` * `build.gradle`, `build.gradle.kts`, `pom.xml` -> `jdk` * `mix.exs` -> `elixir` * `*.sln`、`*.csproj`、`*.fsproj` -> `dotnet-sdk` * `composer.json` -> `php` * `Package.swift` -> `swift` * `dune-project`, `*.opam` -> `ocaml` * `stack.yaml`, `*.cabal` -> `ghc,cabal-install` * `pubspec.yaml` -> `dart` * `zig.zon`, `build.zig` -> `zig` 4. **检测构建工具**： * `Makefile` -> `gnumake` * `CMakeLists.txt` -> `cmake` * `介子.build` -> `介子` * `Justfile` -> `只是` * `Taskfile.yml` -> `go-task` * `Rakefile`（没有 Gemfile）-> `ruby` 5. **从配置文件中检测其他工具**： * `.eslintrc*`, `eslint.config.*` -> (已经被nodejs覆盖) * `Dockerfile` -> `docker` * `.terraform*` -> `terraform` * `serverless.yml` -> `nodejs` * `Makefile` 包含 `protoc` -> `protobuf` ## 常用包映射项目文件/指标|尼克斯包 ---|--- `package.json` | `nodejs` `Cargo.toml` | `rustc`，`货物` `go.mod` | ‘走’ `需求.txt` | `python3` `pyproject.toml` | `python3` `宝石文件` | `红宝石` `pom.xml` / `build.gradle` | `jdk` `mix.exs` | ‘灵丹妙药’ `composer.json` | `php` `*.csproj` / `*.fsproj` | `dotnet-sdk` `Package.swift` | ‘迅速’ `stack.yaml` / `*.cabal` | `ghc`、`cabal-install` `pubspec.yaml` | `飞镖` `build.zig` / `zig.zon` | `之字形` `生成文件` | `gnumake` `CMakeLists.txt` | `cmake` `介子.build` | `介子` `Justfile` | ‘只是’ `Taskfile.yml` | `执行任务` 需要`curl` | `卷曲` 需要 `git` | `git` 需要`jq` | `jq` 需要 `openssl` | `openssl` 需要`pkg-config` | `pkg-config` 需要`protobuf` `protobuf` ## 构造 URL 从检测到的包构建 nixomatic URL： https://nixomatic.com/?p=pkg1,pkg2,pkg3 使用短的“p”查询参数和以逗号分隔的包名称。例如，带有 Makefile 的 Node.js 项目将变为： https://nixomatic.com/?p=nodejs,gnumake 要固定特定的包版本，请使用“@version”语法： https://nixomatic.com/?p=nodejs@20.11.1,python3 要固定到特定的 nixpkgs 版本，请使用 `:revision` 语法： https://nixomatic.com/?p=python3:3b93cf5 ## 命令模板 ### 尼克斯（直接）在环境中运行命令：尼克斯\ --extra-experimental-features 'nix-command flakes' \ 开发 'https://nixomatic.com/?p=' \ --accept-flake-config \ --命令 -- 输入交互式 shell：尼克斯\ --extra-experimental-features 'nix-command flakes' \ 开发 'https://nixomatic.com/?p=' \ --接受片配置 ### 码头工人在环境中运行命令： docker run -v nix-store:/nix -v "$PWD:/workspace" -w /workspace --rm nixos/nix nix \ --extra-experimental-features 'nix-command flakes' \ 开发 'https://nixomatic.com/?p=' \ --accept-flake-config \ --命令 -- 输入交互式 shell： docker run -v nix-store:/nix -v "$PWD:/workspace" -w /workspace --rm -it nixos/nix nix \ --extra-experimental-features 'nix-command flakes' \ 开发 'https://nixomatic.com/?p=' \ --接受片配置 **注意：** Docker 命令包含 `-v "$PWD:/workspace" -w /workspace` 将当前项目目录挂载到容器中。这对于实际项目工作至关重要，以便构建工具可以访问项目文件。 ## 代理工作流程当用户要求构建、测试、lint、格式化或设置项目时，请按照以下步骤操作： 1. **检查`flake.nix`**：如果项目有自己的`flake.nix`，则直接使用`nixdevelop --command -- `。跳过剩余步骤。 2. **检查 README.md 中是否存在现有 URL** ：查找包含“nixomatic.com/?p=” URL 的“## Development Environment”部分。如果找到，请使用该 URL 作为起点。 3. **分析项目文件** ：扫描项目根目录中的语言文件、构建工具配置和其他指标。使用上面的映射确定所需的包集。 4. **构建 URL** ：从检测到的包构建 `https://nixomatic.com/?p=pkg1,pkg2,...`。如果重复使用 README URL，请将所有新包合并到其中。 5. **检测运行时**：检查 PATH 上的 `nix`，然后检查 `docker`。选择适当的命令模板。 6. **执行命令**：使用适当的命令模板在 nixomatic 环境中运行用户请求的操作（构建、测试、lint 等）。 7. **处理丢失的包**：如果命令因未找到工具而失败（例如，“未找到命令：cmake”），请将丢失的包添加到 URL 并重试该命令。 8. **更新 README.md** ：成功执行命令后，确保项目的 README.md 包含最新的“## Development Environment”部分以及工作 nixomatic URL。请参阅下面的 README.md 维护部分。 ## README.md 维护在 nixomatic 环境中成功运行命令后，确保项目的 README.md 记录了如何重现它。这是该技能的主要神器。 ### 查找或创建该部分 * 在 README.md 中搜索包含“nixomatic.com” URL 的“## Development Environment”标题。 * 如果找到，如果包集已更改，则更新 URL。 * 如果未找到，请将该部分附加到 README.md 的末尾（在“许可证”或“贡献”等任何最后部分（如果存在）之前）。 ### 部分模板将此模板用于“开发环境”部分。将 `` 替换为实际的逗号分隔包列表： ## 开发环境该项目使用 [nixomatic](https://nixomatic.com) 来实现可重现的开发环境。 ### 使用 Nix ````bash 尼克斯\ --extra-experimental-features 'nix-command flakes' \ 开发 'https://nixomatic.com/?p=' \ --接受片配置 ```` ### 使用 Docker ````bash docker run -v nix-store:/nix -v "$PWD:/workspace" -w /workspace --rm -it nixos/nix nix \ --extra-experimental-features 'nix-command flakes' \ 开发 'https://nixomatic.com/?p=' \ --接受片配置 ```` ### 保持 URL 同步 * 添加包时（例如，发现缺少的工具），更新 README.md 部分中的 URL。 * 当软件包被删除（例如，依赖项被删除）时，相应地更新 URL。 * 始终在 Nix 和 Docker 命令块中使用相同的 URL。 ## 安全考虑 * **Nix 沙箱：** Nix 构建默认在沙箱内运行 - 构建时派生没有网络访问权限，也没有 Nix 存储之外的文件系统访问权限。 `nixdevelop` 命令仅使软件包在 `PATH` 上可用；它不会在评估时执行任意脚本。 * **确定性薄片：** nixomatic.com 提供从请求的包列表生成的确定性 Nix 薄片。该 flake 仅从官方 nixpkgs 存储库中提取软件包。 * **Docker 隔离：** 使用 Docker 运行时时，容器只能访问已安装的工作区目录和持久性 Nix 存储卷。没有暴露其他主机路径。 ## 错误处理错误 |原因 |修复 ---|---|--- `未找到命令：<工具>` | URL 中缺少包 |将包添加到`p=`参数并重试 `错误：无法下载` |网络问题或无效 URL |检查互联网连接并验证 URL 格式正确 `错误：薄片没有属性` |未知的包名 |验证 nixpkgs 中是否存在软件包名称（在中搜索） `docker：找不到命令` | Docker 未安装 |回退到 Nix，或者要求用户安装 Docker `nix：找不到命令` | Nix 未安装 |回退到 Docker，或要求用户安装 Nix `错误：实验性 Nix 功能“flakes”被禁用` |老尼克斯无片旗| `--extra-experimental-features 'nix-command flakes'` 标志应该可以处理这个问题；如果没有，用户需要更新Nix Docker 套接字上的权限被拒绝 |用户不在 docker 组中 |用户必须有访问Docker守护进程的权限；要求他们验证他们的 Docker 设置

尼克索马蒂克

包含技能