【免费下载链接】gsd-coreGit. Ship. Done - Core项目地址https://gitcode.com/gh_mirrors/ge/gsd-core点击查看免费下载导读本文讲解 GSD CoreGit. Ship. Done - Core在全局安装阶段新增的一项安装期防护当机器上残留着旧版独立 SDK 包open-gsd/sdk0.1.0时安装器会通过npm ls -g open-gsd/sdk主动探测并在安装完成前打印清晰的修复提示块。该检测采用fail-closed失败即默认无残留语义——任何 npm/exec 错误都静默视为无 stale 包同时以GSD_SKIP_STALE_SDK_CHECK1环境变量为 CI/测试环境提供旁路开关。读完本文你将掌握这个检测解决的实际问题#3406、其判定逻辑与失败语义、如何在 CI 中正确旁路、以及如何手工复现与验证该检测。一、问题背景为什么残留的 SDK 包会构成阴影1.1 从opengsd/gsd-sdk退役说起GSD 早期曾通过独立的 SDK 包向运行时Claude、Codex 等分发工具链能力。在 model-catalog.cts 的源码注释中可以看到明确记录ADR-0174 退役了opengsd/gsd-sdk包此后 GSD 改为在项目内随安装器捆绑自己的 SDK 垫片shim不再依赖独立发布的 npm 包。这一退役动作带来的副作用是已经通过npm install -g装过旧 SDK 的用户机器上会遗留下一个全局安装的旧包。它不会随 GSD 升级自动消失也不会被卸载流程清理。1.2 阴影shadow的真正危害为什么残留的旧包是危险的关键在子命令能力缺失旧版独立包open-gsd/sdk0.1.0从未支持query子命令而新安装的 GSD 工具链在运行时依赖query子命令来完成能力探测与状态查询如果全局残留的旧包在PATH解析中先于项目内捆绑的 SDK 垫片被命中就会阴影掉新版本——用户以为在用 GSD 提供的 SDK实际执行的是能力缺失的 0.1.0 旧实现导致query调用静默失败或行为异常。这与仓库中另一处已处理的阴影问题同源在 cli-skew-check.cts 中GSD 已经对#1748的场景做了防护——一个陈旧的全局 canary CLI 阴影掉项目本地安装。而 #3406 处理的则是同一类问题的 SDK 包变体旧包不来自 GSD 发布线而是用户手动npm i -g的独立包。一句话总结问题本质安装器可以控制自己写入的文件却无法控制用户机器上早就存在的全局 npm 包——所以必须在安装期主动探测并提醒用户。二、检测机制全局安装时运行npm ls -g open-gsd/sdk2.1 检测时机与触发范围根据 changeset 记录fix-3406-detect-stale-sdk-shadow.md该检测仅作用于全局安装流程触发条件用户执行的是全局安装而非项目局部安装检测动作运行npm ls -g open-gsd/sdk判定结果若发现独立包open-gsd/sdk的 0.1.0 版本存在即该版本从未获得query子命令支持则在安装完成之前打印一个清晰的修复提示块remediation block。这一安装完成前打印的设计是有意的安装流程本身照常推进、不中断但把修复提示放在最后输出确保用户看到告警时整个安装已经可用只需按提示清除残留即可。2.2 为什么选择npm ls -g而不是直接查文件npm ls -g是 npm 原生的全局包清单命令具备两个优势权威性它返回的是 npm 注册表视角下确实已全局安装的包比手工扫描PATH目录更准确能覆盖不同 npm 前缀prefix配置可解析性输出稳定、可程序化解析适合在安装器内部作为子进程消费。测试代码中也能看到该子进程的直接引用在 codex-inherit-smoke.test.cjs 和 install-runtime-artifacts.test.cjs 的注释中都明确写着——设置GSD_SKIP_STALE_SDK_CHECK1的目的是抑制npm ls -g子进程说明该子进程就是检测的实际执行载体。三、fail-closed 语义宁可漏报不可误中断这是整个检测设计中最重要的工程决策。原文描述为Detection is fail-closed: any npm/exec error silently returns no-stale.3.1 什么是这里的fail-closed在安全领域fail-closed通常指失败时关闭拒绝。但在这个场景里它的方向是对安装流程的保护npm ls -g可能因为各种原因失败——npm 未安装、npm 版本过旧不支持该参数、权限不足、网络异常、超时、子进程无法 spawn 等无论何种失败检测器都静默返回无 stale 包no-stale安装流程继续正常推进并成功完成。3.2 为什么这是正确的取舍试想如果反过来做fail-open / 失败即告警并阻塞一次因网络抖动导致的npm ls失败会让每一次全局安装都被迫中断检测工具本身反而成了安装可靠性的新故障源违背了安装器应当健壮的原则。fail-closed 的语义保证了检测只是辅助提醒绝不是安装的前置依赖。即便检测完全失效安装结果与旧版本行为完全一致而检测成功且发现残留时用户获得额外提示。这是一个有则提示、无则静默、失败亦静默的纯增量防护。3.3 与项目既有失败语义的一致性这种检测失败不等于结论为真的写法与 GSD Core 其他模块的工程惯例一致。例如在 verification.cts 中验证状态机的陈旧性检查被设计为三态determined: true, stale: false检查完成、确实无陈旧与determined: false检查未能完成被严格区分后者不允许被静默折叠成无陈旧结论。stale SDK 检测在实现上同样遵守失败不得被解释为成功探测的边界——只是对外表现为静默的 no-stale 默认值避免把不确定性传递给用户。四、检测旁路GSD_SKIP_STALE_SDK_CHECK1环境变量4.1 用途与适用场景该检测受环境变量门控GSD_SKIP_STALE_SDK_CHECK1设置该变量后全局安装会跳过 stale SDK 检测不再 spawnnpm ls -g子进程。官方文档将其用途定位为CI/测试环境CI 流水线每次 CI 都全新拉环境机器上不可能存在用户残留的全局包同时 CI 环境对 npm 子进程的可用性、网络隔离有特殊约束跳过可避免无谓的慢路径自动化测试测试框架需要隔离、可控、可重复的执行环境任何外部全局包探测都会引入不确定性因此测试套件普遍设置该变量。4.2 测试代码中的实际用法在 install.test.cjs 的runGlobalInstall767辅助函数中可以看到标准的隔离模式const prevSkipStale process.env.GSD_SKIP_STALE_SDK_CHECK; // ... process.env.GSD_SKIP_STALE_SDK_CHECK 1; // 抑制 stale-SDK npm 子进程 try { install(true, runtime); } finally { // 恢复原值含原本未设置的情形需 delete if (prevSkipStale undefined) delete process.env.GSD_SKIP_STALE_SDK_CHECK; else process.env.GSD_SKIP_STALE_SDK_CHECK prevSkipStale; }这段代码同时演示了正确的旁路姿势——设置前保存原值finally中恢复避免测试间环境变量泄漏。同样的模式也出现在 install-runtime-artifacts.test.cjs 与 codex-inherit-smoke.test.cjs。值得注意旁路变量只影响是否执行检测不改变 fail-closed 语义本身。即使不设置该变量检测失败也只是静默 no-stale不会阻塞安装——旁路的意义在于省去无谓的子进程开销而非规避失败。五、源码与测试佐证检测逻辑确实活着5.1 回归测试确认两个核心函数仍在导出在 install.test.cjs 中有一段针对#505 移除死 SDK 校验子系统的回归测试其注释明确写明了本项目对 stale SDK 检测的立场The two live stale-standalone-SDK helpers (detectStaleStandaloneSdk,formatStaleStandaloneSdkWarning) are STILL exported as functions — they handle a real user-facing condition (#3406) and MUST NOT be removed.翻译并提炼其要点旧的 SDK 校验子系统installSdkIfNeeded、classifySdkInstall、buildSdkFailFastReport、readGsdSdkVersion、isLegacyGsdSdkShim、trySelfLinkGsdSdk等十余个符号随 ADR-0174 的退役已成为死代码测试断言它们不再从安装入口导出但detectStaleStandaloneSdk和formatStaleStandaloneSdkWarning这两个函数被明确保留为活跃代码——因为它们处理的是#3406 这一真实的用户可见场景严禁随死代码一并删除。这从测试层面印证了stale SDK 检测不是临时补丁而是被纳入活契约的长期维护功能。函数命名也透露了实现结构detectStaleStandaloneSdk负责执行探测封装npm ls -g子进程与版本判定formatStaleStandaloneSdkWarning负责将探测结果格式化为面向用户的修复提示块。5.2 相关辅助面安装器迁移报告中的分类在 installer-migration-report.cts 中安装器迁移报告还存在一个stale-sdk-build-artifact分类choice:remove表明陈旧的 SDK 构建残留是安装器迁移流程中已被识别的清理对象之一——与 #3406 的检测在问题域上同源互补一个是迁移期清理一个是安装期提醒。六、实测与自查如何验证你的环境是否存在残留6.1 手工复现检测条件在未设置GSD_SKIP_STALE_SDK_CHECK的前提下手动执行检测核心命令确认机器状态npm ls -g open-gsd/sdk三种可能的输出及含义输出含义GSD 安装器行为列出open-gsd/sdk0.1.0存在残留的独立 SDK 包无query支持打印修复提示块安装照常完成(empty)或提示无匹配包无残留静默不打印任何提示命令报错npm 缺失/权限/网络检测失败fail-closed视为无残留静默继续6.2 清除残留若确认存在open-gsd/sdk0.1.0通过 npm 标准卸载命令移除全局包即可消除阴影提示块所引导的修复动作即为此类操作npm uninstall -g open-gsd/sdk卸载后可再次运行npm ls -g open-gsd/sdk确认已为空。之后重新执行 GSD 全局安装将不再出现修复提示。6.3 CI 与自动化环境的标准写法在 CI 脚本或测试 runner 中显式旁路export GSD_SKIP_STALE_SDK_CHECK1或单条命令内联GSD_SKIP_STALE_SDK_CHECK1 npm run install:global # 以实际安装命令为准七、总结一屏提示背后的工程取舍fix-3406这个 changeset 表面上是安装时多跑一条 npm 命令、多打一段警告但它浓缩了三个值得借鉴的工程决策边界意识安装器只管自己写入的内容对用户机器上无法控制的全局残留选择探测 提示而非强行清理——不越权删除用户手动安装的包失败安全fail-closed 语义保证检测工具的任何故障都不会成为安装流程的故障源把辅助逻辑与关键路径彻底解耦可控性通过GSD_SKIP_STALE_SDK_CHECK1把检测的成本子进程开销、环境不确定性交给 CI/测试场景自行决策同时用回归测试install.test.cjs锁死检测函数不可随死代码删除的契约。对于在全局环境长期使用 GSD Core 的开发者本文给出的自查清单是升级后若安装输出末尾出现 stale SDK 修复提示按提示npm uninstall -g open-gsd/sdk清掉残留CI 环境统一设置GSD_SKIP_STALE_SDK_CHECK1而检测本身的失败永远不需要你担心——它不会阻止安装完成。赞分享【免费下载链接】gsd-coreGit. Ship. Done - Core项目地址https://gitcode.com/gh_mirrors/ge/gsd-core点击查看免费下载相关推荐get-shit-done 安装期陈旧 SDK 遮蔽检测3406当旧版 gsd-build/sdk 悄然劫持 gsd-sdk shimget shit done 安装期陈旧 SDK 遮蔽检测 3406当旧版 gsd build/sdk 悄然劫持 gsd sdk shim 导读 本文围绕人工智能AI 应用提示工程开发工具工作流自动化AI Agent清洁代码PHP项目教程清洁代码PHP项目教程 1. 项目介绍 本项目是基于Robert C. Martin的《Clean Code》一书为PHP语言编写的代码风格和最佳实践的集合。gsd-core 安装器如何准确探测用户 Shell 的 PATH一次 ✓ GSD SDK ready 误报修复的技术解剖gsd core 安装器如何准确探测用户 Shell 的 PATH一次 ✓ GSD SDK ready 误报修复的技术解剖 安装完成时gsd core上一篇InspectiveC实战教程通过Cycript注入实现SpringBoard消息流实时分析下一篇OpenKore完全指南开源自动化工具实现Ragnarok Online高效游戏管理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考