[{"data":1,"prerenderedAt":301},["ShallowReactive",2],{"navigation_docs_zh_CN":3,"\u002Fzh-CN\u002Ftroubleshooting\u002Fcommon-errors":85,"\u002Fzh-CN\u002Ftroubleshooting\u002Fcommon-errors-surround":298},[4,19,41,75],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":18},"快速开始","i-lucide-book-open","\u002Fzh-CN\u002Fgetting-started","zh-CN\u002F1.getting-started",[10,14],{"title":11,"path":12,"stem":13},"安装","\u002Fzh-CN\u002Fgetting-started\u002Finstallation","zh-CN\u002F1.getting-started\u002F1.installation",{"title":15,"path":16,"stem":17},"第一个 Pin","\u002Fzh-CN\u002Fgetting-started\u002Ffirst-pin","zh-CN\u002F1.getting-started\u002F2.first-pin",false,{"title":20,"icon":21,"path":22,"stem":23,"children":24,"page":18},"使用指南","i-lucide-route","\u002Fzh-CN\u002Fguides","zh-CN\u002F2.guides",[25,29,33,37],{"title":26,"path":27,"stem":28},"更新与选择","\u002Fzh-CN\u002Fguides\u002Fupdating","zh-CN\u002F2.guides\u002F1.updating",{"title":30,"path":31,"stem":32},"组合 Checker 与 Fetcher","\u002Fzh-CN\u002Fguides\u002Fcombinations","zh-CN\u002F2.guides\u002F2.combinations",{"title":34,"path":35,"stem":36},"多 Source 与补丁","\u002Fzh-CN\u002Fguides\u002Fmulti-source","zh-CN\u002F2.guides\u002F3.multi-source",{"title":38,"path":39,"stem":40},"Package 与依赖哈希","\u002Fzh-CN\u002Fguides\u002Fdependencies","zh-CN\u002F2.guides\u002F4.dependencies",{"title":42,"icon":43,"path":44,"stem":45,"children":46,"page":18},"参考文档","i-lucide-code","\u002Fzh-CN\u002Freference","zh-CN\u002F3.reference",[47,51,55,59,63,67,71],{"title":48,"path":49,"stem":50},"CLI","\u002Fzh-CN\u002Freference\u002Fcli","zh-CN\u002F3.reference\u002F1.cli",{"title":52,"path":53,"stem":54},"运行配置","\u002Fzh-CN\u002Freference\u002Fconfiguration","zh-CN\u002F3.reference\u002F2.configuration",{"title":56,"path":57,"stem":58},"Pin 声明","\u002Fzh-CN\u002Freference\u002Fpins","zh-CN\u002F3.reference\u002F3.pins",{"title":60,"path":61,"stem":62},"Checker","\u002Fzh-CN\u002Freference\u002Fcheckers","zh-CN\u002F3.reference\u002F4.checkers",{"title":64,"path":65,"stem":66},"Fetcher","\u002Fzh-CN\u002Freference\u002Ffetchers","zh-CN\u002F3.reference\u002F5.fetchers",{"title":68,"path":69,"stem":70},"Package Builder","\u002Fzh-CN\u002Freference\u002Fbuilders","zh-CN\u002F3.reference\u002F6.builders",{"title":72,"path":73,"stem":74},"Reader 与 Pins File","\u002Fzh-CN\u002Freference\u002Freader","zh-CN\u002F3.reference\u002F7.reader",{"title":76,"icon":77,"path":78,"stem":79,"children":80,"page":18},"排错指南","i-lucide-wrench","\u002Fzh-CN\u002Ftroubleshooting","zh-CN\u002F4.troubleshooting",[81],{"title":82,"path":83,"stem":84},"常见错误","\u002Fzh-CN\u002Ftroubleshooting\u002Fcommon-errors","zh-CN\u002F4.troubleshooting\u002F1.common-errors",{"id":86,"title":82,"body":87,"description":291,"extension":292,"links":293,"meta":294,"navigation":295,"path":83,"seo":296,"stem":84,"__hash__":297},"docs_zh_CN\u002Fzh-CN\u002F4.troubleshooting\u002F1.common-errors.md",{"type":88,"value":89,"toc":281},"minimark",[90,99,103,157,160,163,170,189,200,203,213,220,223,242,245,249,264,267,270],[91,92,93,94,98],"p",{},"先保留完整错误文本，再区分配置错误与某个 Pin 的运行失败。",[95,96,97],"code",{},"nix-pins status"," 可查看已有结果和上次失败信息。",[100,101,102],"h2",{"id":102},"配置加载失败",[104,105,106,118,128,138,151],"ul",{},[107,108,109,110,113,114,117],"li",{},"检查当前工作目录、",[95,111,112],{},"--config"," 和 ",[95,115,116],{},"--pins","。",[107,119,120,121,124,125,117],{},"确认 ",[95,122,123],{},"\u003Cnixpkgs>"," 可解析，运行 ",[95,126,127],{},"nix eval --impure --raw --expr 'toString \u003Cnixpkgs>'",[107,129,130,131,134,135,117],{},"检查目标字段：",[95,132,133],{},"target"," 不能与旧字段混用，GitHub 目标必须是 ",[95,136,137],{},"owner\u002Frepo",[107,139,140,113,143,146,147,150],{},[95,141,142],{},"pin.fetcher.url",[95,144,145],{},"pin.fetcher.zip"," 的 URL 必须是函数，例如 ",[95,148,149],{},"version: \"https:\u002F\u002F...\"","，不能直接写字符串。",[107,152,153,156],{},[95,154,155],{},"rev"," 映射也必须返回字符串；不支持的字段会报错。",[91,158,159],{},"确定性的配置错误发生在 Checker 执行前，修正声明后再更新。",[100,161,162],{"id":162},"版本检查失败",[91,164,165,166,169],{},"GitHub 的 403／429 可能为 API 限流。按",[167,168,52],"a",{"href":53},"提供 token，勿将 token 写进会提交的文件。",[91,171,172,173,176,177,180,181,184,185,188],{},"Git 检查依赖 ",[95,174,175],{},"git ls-remote","。检查网络、目标权限和 ",[95,178,179],{},"mode","；branch 需要 ",[95,182,183],{},"branch","，ref 需要 ",[95,186,187],{},"ref","。tag 模式无候选时检查正则与仓库是否真的有 tag。",[91,190,191,192,195,196,199],{},"npm Checker 读取 ",[95,193,194],{},"dist-tags","。指定的 ",[95,197,198],{},"distTag"," 不存在时会失败。URL Checker 无匹配时检查文本响应和正则；命令 Checker 必须成功退出并输出非空版本。",[100,201,202],{"id":202},"获取来源失败",[91,204,205,206,208,209,212],{},"核对 Checker 的原始 Version 与上游 tag、提交号或文件名是否对应。注册表版本可能需要 ",[95,207,155],{}," 或 ",[95,210,211],{},"url"," 映射，不要修改 Pins File 中的版本来绕过配置问题。",[91,214,215,216,219],{},"确认所用 Nixpkgs 提供对应 Fetcher，尤其是 ",[95,217,218],{},"fetchFromHuggingFace","。大模型、子模块和访问受限仓库还需要相应容量、网络和凭证条件。",[100,221,222],{"id":222},"依赖哈希失败",[91,224,225,226,229,230,233,234,237,238,241],{},"检查 Package 的 ",[95,227,228],{},"root"," 和锁文件位置。npm 需要 ",[95,231,232],{},"package-lock.json","；pnpm 需要兼容的 ",[95,235,236],{},"pnpm-lock.yaml","、显式 ",[95,239,240],{},"fetcherVersion","，以及与下游一致的 pnpm 版本。",[91,243,244],{},"预取依赖会实际执行中间 FOD 的构建步骤，失败不一定是最终应用的构建问题。检查输出指向的 Source、Package 与依赖 Hash，随后只更新对应 Pin。",[100,246,248],{"id":247},"reader-失败","Reader 失败",[91,250,251,252,255,256,259,260,263],{},"确认 Pins File schema 为 v2，并使用 ",[95,253,254],{},"pins.\u003Cpin>.sources.\u003Csource>.src","。需要 ",[95,257,258],{},"packages"," 或补丁源码时同时提供 ",[95,261,262],{},"config","。变更配置后应更新 Pins File，确保新声明和锁定结果一致。",[100,265,266],{"id":266},"同时运行与取消",[91,268,269],{},"写锁冲突表示另一个进程正在更新同一 Pins File。等待它完成后重试；不要在仍有写者运行时绕过锁。取消不会写入本轮结果，已有 Pins File 可继续使用。",[91,271,272,273,276,277,280],{},"如果下载和构建压满本地资源，降低 ",[95,274,275],{},"download_jobs"," 与 ",[95,278,279],{},"hash_jobs","。交互式 TUI 与 CI 文本输出不同，应以退出码、错误文本和 Pins File 判断业务结果。",{"title":282,"searchDepth":283,"depth":283,"links":284},"",2,[285,286,287,288,289,290],{"id":102,"depth":283,"text":102},{"id":162,"depth":283,"text":162},{"id":202,"depth":283,"text":202},{"id":222,"depth":283,"text":222},{"id":247,"depth":283,"text":248},{"id":266,"depth":283,"text":266},"按配置、版本检查、来源获取、依赖哈希和 Reader 定位问题。","md",null,{},true,{"title":82,"description":291},"UurXAIY_PczEuBMjp30I-uL9IDZIekUbl54ynhLzdIs",[299,293],{"title":72,"path":73,"stem":74,"description":300,"children":-1},"从 JSON 锁定结果恢复源码、补丁和具名 Package。",1790868075291]