技能介绍

解决什么问题

NixOS 的文档分散在 nix.dev、NixOS Manual（位于 nixpkgs 仓库）、Nix Pills 和 Release Wiki 等多个来源。回答 Nix 相关问题时，要么在浏览器里反复切换查证，要么凭训练记忆写出可能过时的配置语法。这个技能把官方文档的完整、未修改副本打包进 references/ 目录并每日更新，让回答能基于权威文本生成，而不是依赖可能过期的记忆片段。

它如何工作

核心流程很直接：

主题路由：从用户问题中识别主题，匹配对应参考文件，如安装问题对应 references/install-nix.md，模块编写对应 references/nixos-writing-modules.md
本地优先，联网兜底：答案基于本地副本生成；本地内容不足时，再从 raw GitHub 拉取最新文档
语法区分：明确区分 services.nginx.enable = true; 这类 NixOS 模块选项与 pkgs.mkDerivation { ... } 这类 Nix 语言表达式，避免混用
示例规范：使用当前语法给出示例；涉及 flakes 时同时展示 channels 与 flakes 两种写法
打包建议：优先推荐 callPackage 模式，而非裸 import

覆盖面从入门（安装、first steps、Nix Pills 20 课）到语言概念（flakes、模块系统、固定 nixpkgs 版本），再到配置、管理、开发、打包构建、教程与食谱，几乎覆盖 NixOS 使用链路的全阶段。

适用边界

文档由官方仓库自动生成，滞后于上游提交属正常现象；涉及最新变更时需走 Live Fetching 获取
它是参考知识库而非执行工具，不会替你运行 nix-build 或 nixos-rebuild
对 channels 机制、Nix 2.x 演进等历史背景的解释以文档原文为准，可能需要交叉阅读其他资料
初学者建议从 references/first-steps.md 或 references/nix-pills.md 入手；排障时先查 references/troubleshooting.md 与 references/faq.md