从形状正则到显式白名单:get-shit-done 安装器 3628 修复如何防止 Hook 误删
从形状正则到显式白名单get-shit-done 安装器 #3628 修复如何防止 Hook 误删【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-done本文基于仓库变更集文档 3628-bundled-hook-whitelist.md类型标记为 Security关联 issue #3628解析 get-shit-done 安装器迁移层的一次关键安全修复bundled-gsd-hook分类器为何不能依赖命名形状正则自动删除用户目录下的hooks/gsd-*文件以及显式白名单BUNDLED_GSD_HOOK_FILES CI 漂移守卫如何保证自动删除范围 实际发布文件集合。读完本文你能理解该安装器prompt-user阻塞流程的完整决策链并掌握白名单 双向漂移测试这一可复用的防误删模式。背景#3610 修复了升级中断却引入了静默误删要理解 #3628需要先理解它修补的对象。get-shit-done 提供一层**安装器迁移installer migration**架构见 docs/installer-migrations.md其设计目标第一条就是Protect user data by default并区分三类文件Managed fileGSD 安装并记录在安装清单manifest中的文件未被修改时可自动替换User-owned file用户自己创建的文件绝不能因为恰好位于 GSD 目录下就被删除Unknown file既不在清单中、又未被归类为用户所有的文件除非有明确证据被迁移显式归类否则一律保留。此前 #3610 解决了一个升级硬中断问题全新执行npx get-shit-done-cclatest --codex时目标目录如~/.codex/hooks/里残留着上一版本 GSD 自带的 hook 文件安装器清单无法证明这些文件受管理于是被归类为GSD 风格文件但无清单证据需要用户显式选择assertInstallerMigrationsUnblocked直接抛错终止升级见 tests/bug-3610-installer-migration-bundled-hooks-classification.test.cjs 的文件头注释。#3610 的修复是在分类器classifyPromptUserAction中新增bundled-gsd-hook类别凡是形如hooks/gsd-name.{js,sh,cjs,mjs}的文件都自动判定为官方自带 hook默认为remove安装器随后会写入新版本覆盖。问题在于它使用的是形状正则/^hooks\/gsd-[^/]\.(?:js|sh|cjs|mjs)$/这条正则匹配的是任何符合该命名形状的文件而不是 npm 包中实际发布的 13 个 hook。变更集文档 3628-bundled-hook-whitelist.md 明确指出受害对象有两类用户自写的自定义 hook例如hooks/gsd-personal-experiment.js旧版本 GSD 发布、但当前版本已退役的 hook 文件。这两类文件在首次基线扫描first-time-baseline scan时会被静默自动分类并删除——属于无声的数据丢失silent data loss这正是该变更集被标记为type: Security的原因。修复实现从匹配形状改为白名单精确命中修复落在 get-shit-done/bin/lib/installer-migration-report.cjs。分类器不再依赖正则形状而是查询一个冻结的显式白名单集合与 npm 发行版中hooks/目录下实际发布的 13 个文件一一对应// #3628: explicit whitelist of bundled hook files shipped in the npm // distribution under hooks/. const BUNDLED_GSD_HOOK_FILES Object.freeze(new Set([ hooks/gsd-check-update-worker.js, hooks/gsd-check-update.js, hooks/gsd-context-monitor.js, hooks/gsd-graphify-update.sh, hooks/gsd-phase-boundary.sh, hooks/gsd-prompt-guard.js, hooks/gsd-read-guard.js, hooks/gsd-read-injection-scanner.js, hooks/gsd-session-state.sh, hooks/gsd-statusline.js, hooks/gsd-update-banner.js, hooks/gsd-validate-commit.sh, hooks/gsd-workflow-guard.js, ]));可以核对仓库根目录 hooks/ 目录其中 13 个gsd-*.{js,sh}文件与白名单完全一致另有lib/子目录两个辅助文件不会被[^/]的形状约束误匹配。两个实现细节值得注意Object.freeze(new Set([...]))白名单是模块级不可变常量single point of truth测试会断言它必须以Set类型导出保证调用方可以用has()做 O(1) 成员探测且运行期无法被意外篡改白名单条目强制使用 POSIX 斜杠且带hooks/前缀与分类器接收的relPath规范化形态严格对齐见下文测试断言。分类器的完整决策链哪些文件自动处理哪些交还用户classifyPromptUserActioninstaller-migration-report.cjs对每个被阻塞的prompt-user动作按relPath做三类判定未命中任何一类则返回null落入既有的阻塞或提示block-or-prompt流程用户保留控制权判定条件返回类别 / 默认选择过期的 SDK 构建产物relPath匹配^get-shit-done/sdk/(dist|src)/stale-sdk-build-artifact→remove每次安装都会重新生成删除无损用户可见的 skill 锚点relPath匹配^skills/gsd-[^/]/SKILL\.md$user-facing-skill→keep用户自有内容必须保留官方自带 hook#3628 白名单BUNDLED_GSD_HOOK_FILES.has(relPath)bundled-gsd-hook→remove以上皆否——null不自动分类走人工确认修复后白名单分支的注释把安全边界写得很直白与形状匹配但不在白名单内的文件用户自写 hook、旧版本退役 hookfall through 到 block-or-prompt 流程。当白名单命中后动作由materializeResolutioninstaller-migration-report.cjs具体化keep→baseline-preserve-user幂等保留remove→backup-and-remove——删除前先在迁移日志目录gsd-migration-journal/runId-backups/留一份回滚备份。即使自动删除也不是物理抹除这一点与 docs/installer-migrations.md 中backup-and-remove动作类型的定义用户会得到清晰报告并可检查备份一致。非交互non-TTY场景由resolveInstallerMigrationPromptsForNonTtyinstaller-migration-report.cjs驱动当安装器无法交互式提问时优先读取环境变量GSD_INSTALLER_MIGRATION_RESOLVE取值keep/remove作为操作者覆写未设置时才走上述分类器安全默认值。无法安全默认的动作会被过滤回result.blocked最终由assertInstallerMigrationsUnblocked抛出按原因分组的错误信息每组最多展示 3 条示例路径并提示设置GSD_INSTALLER_MIGRATION_RESOLVEchoice可在非交互环境下解决。换言之白名单机制把可无脑处理的文件和必须人来拍板的文件切开了白名单内的 13 个文件自动清理白名单外的一切文件升级不会静默动、而是阻塞并给出可操作的解决途径。CI 漂移守卫白名单必须与磁盘上的hooks/双向一致变更集文档强调了配套防线tests/bug-3628-bundled-hook-classifier-whitelist.test.cjs 是一个漂移守卫任何方向的漂移都会让 CI 失败白名单 → 磁盘方向test 第 66-79 行遍历BUNDLED_GSD_HOOK_FILES每个条目断言对应的hooks/文件名在磁盘上真实存在——防止删除了某个 hook 文件却忘了从白名单移除磁盘 → 白名单方向test 第 81-93 行用readdirSync扫描hooks/下所有gsd-*.{js,sh,cjs,mjs}文件断言每个都在白名单内——防止新增发布 hook 却忘了加白名单后果是该 hook 在升级时反而会被当作未知文件阻塞或者在旧版本逻辑下被误当用户文件结构约束test 第 37-64 行白名单必须是Set、非空且每个条目都以hooks/开头、使用 POSIX 斜杠、包含gsd-前缀。测试还覆盖了负向与边界情形确保修复没有破坏 #3610 既有边界test 第 108-139 行hooks/gsd-personal-experiment.js、hooks/gsd-my-custom-guard.sh、hooks/gsd-team-policy.cjs、hooks/gsd-retired-hook.js、hooks/gsd-old-statusline.js、hooks/gsd-experimental.mjs这 6 个用户自有/退役样例必须返回null不得自动分类嵌套目录hooks/gsd-helpers/index.js不得被分类保留 #3610 引入的层级边界非gsd-前缀的hooks/my-custom-hook.js不得被分类。正向测试则遍历白名单全部 13 项断言每一项的分类结果恰好是{ category: bundled-gsd-hook, choice: remove }。小结一条值得借鉴的自动删除安全边界#3628 的教训可以浓缩为一句话任何自动删除/覆盖逻辑的判定依据必须是发行版实际发布物清单而不是命名形状相似性。形状正则hooks/gsd-*.js只能回答它看起来像官方文件白名单才能回答它就是官方文件。其工程组合是单一事实来源Object.freeze的显式Set白名单与发行版hooks/目录一一对应分类器未命中即返回null把控制权交还 block-or-prompt 流程用户文件永不静默消失即使命中白名单删除路径也是backup-and-remove迁移日志保留回滚备份双向漂移守卫测试锁死白名单 ↔ 磁盘发行物的同步关系任何一方改动都会立刻在 CI 暴露。相关延伸阅读安装器迁移架构 docs/installer-migrations.md、非 TTY 解析的早期规格变更集 3541-installer-migration-prompt-user-resolution.md、上游问题修复测试 tests/bug-3610-installer-migration-bundled-hooks-classification.test.cjs 与 #3610 变更集 3610-codex-install-bundled-hooks-blocker.md。【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-done创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

动态Harness:编程智能体在SWE-bench Verified达82.6%的核心机制

动态Harness:编程智能体在SWE-bench Verified达82.6%的核心机制

SWE-bench Verified 82.6% 这个数字,是编程智能体领域最近值得花时间细看的一个标杆。论文项目代号 openJiuwen,核心不是又换了一个更大的模型,也不是把测试用例喂回去让模型背答案,而是把重点放在“长程编码智能体”的执行过程上…

2026/10/24 23:53:16 阅读更多 →
Claude文本水印验证API:从原理到接入的完整指南

Claude文本水印验证API:从原理到接入的完整指南

之前大家讨论 AI 内容检测时,普遍依赖“生成痕迹”“语言风格”这类相对模糊的判断方式,效果并不稳定。Anthropic 开放 Claude 文本水印验证 API 之后,AI 生成内容的验证第一次有了从模型侧出发的技术方案。本文围绕这套 API 的申请路径、调用…

2026/11/6 20:15:41 阅读更多 →
动态Harness:编码智能体在SWE-bench Verified上突破82.6%的关键工程

动态Harness:编码智能体在SWE-bench Verified上突破82.6%的关键工程

“openJiuwen 论文:面向长程编码智能体的动态 harness 达到 SWE-bench Verified 82.6%”——很多关注编码智能体(Coding Agent)方向的开发者,最近都看过这个标题。SWE-bench Verified 是目前衡量大模型真实代码修复能力最受认可的…

2026/11/10 7:01:23 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻