npm 源不可用时 get-shit-done 如何按 manual-update 步骤从源码仓库手动更新【免费下载链接】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-doneget-shit-done 的常规更新依赖 npm通过npx拉取最新版并运行安装器。当 npm 源不可用发布故障、网络受限或者你本来就工作在源码仓库里时docs/manual-update.md 提供了一条不经过 npm 的手动更新路径在本地克隆的仓库里拉取最新代码、构建 hooks、直接用 Node 运行安装器最后重启运行时让新命令和 agents 生效。适用前提均来自 docs/manual-update.md已安装 Node.js已在本地克隆了该仓库git clone https://github.com/gsd-build/get-shit-done补充一点背景docs/USER-GUIDE.md 的 “Cannot Update via npm” 一节也指向同一份文档说明该流程适用于 “npx因 npm 故障或网络限制失败” 的场景。两份文档对 npm 包的写法略有出入manual-update.md 写npx get-shit-done-cclatestUSER-GUIDE.md 写npx opengsd/get-shit-done-redux但只要 npx 更新走不通都可以改用下面的源码流程。更新步骤主路径以下命令都在本地克隆的 get-shit-done 仓库根目录下执行。按顺序执行# 1. 拉取最新代码 git pull --rebase origin main # 2. 构建 hooks 产物必须执行 — hooks/dist/ 是生成物不随源码提交 node scripts/build-hooks.js # 3. 直接运行安装器 node bin/install.js --claude --global # 4. 清除更新检查缓存让 statusline 指示器复位 rm -f ~/.cache/gsd/gsd-update-check.json执行完第 4 步后重启你的运行时Claude Code / Gemini CLI / 其他你安装了 GSD 的客户端新的 commands 和 agents 才会被加载。每一步的作用与注意点git pull --rebase origin main更新本地克隆到 main 分支最新提交。注意这会改写你本地克隆的工作区执行前先确认克隆里没有未提交的改动。node scripts/build-hooks.js生成hooks/dist/。文档明确标注该目录是生成物、不随源码检出所以这一步是必须执行的跳过它装出来的 hooks 会是缺失或过期的。node bin/install.js --claude --global直接调用仓库里的安装器等价于 npx 背后的动作。--claude和--global都是可替换参数见下一节。rm -f ~/.cache/gsd/gsd-update-check.json这条命令会删除一个缓存文件。它的作用是清掉 GSD 在后台版本检查后写入的结果使 statusline 的更新指示器复位文件不存在时rm -f也会静默成功不会报错。运行时与安装范围怎么选bin/install.js的第一个参数指定运行时。按你实际安装 GSD 的运行时替换--claude表格来自 docs/manual-update.md运行时参数Claude Code--claudeGemini CLI--geminiOpenCode--opencodeKilo--kiloCodex--codexCopilot--copilotCursor--cursorWindsurf--windsurfAugment--augment全部运行时--all第二个参数控制安装范围--global全局安装对所有项目生效--local项目级安装只作用于当前项目。如果你此前是通过 npx 全局安装的这里同样用--global保持行为一致。安装器会替换什么、保留什么手动更新走的是同一个安装器行为与 npm 更新相同对 GSD 管理的目录做 clean wipe-and-replace清除后整体替换范围仅限以 Claude Code 为例~/.claude/get-shit-done/— workflows、references、templates~/.claude/commands/gsd/— 斜杠命令~/.claude/agents/gsd-*.md— GSD agents~/.claude/hooks/dist/— 编译后的 hooks以下内容会被保留不受更新影响未以gsd-为前缀的自定义 agentscommands/gsd/之外的自定义命令你的CLAUDE.md文件自定义 hooks所以这条流程不需要先备份整个~/.claude但要理解它只保护“非 GSD 命名空间”的内容。本地改动过 GSD 文件时的恢复步骤如果你之前改过 GSD 安装目录下的文件安装器会在覆盖前自动把这些被修改的文件备份到gsd-local-patches/。更新完成、运行时重启后执行/gsd-update --reapply把备份的修改合并回新安装的文件。/gsd-update的完整用法见 docs/COMMANDS.md--sync更新并同步 skills--reapply更新并重新应用本地补丁。docs/USER-GUIDE.md 的 “GSD Update Overwrote My Local Changes” 一节也确认了这一点自 v1.17 起安装器会把本地修改的文件备份到gsd-local-patches/再运行/gsd-update --reapply即可找回。更新完成的判断方式文档给出的完成标志有两处更新检查缓存~/.cache/gsd/gsd-update-check.json已被清除GSD statuslinehooks/gsd-statusline.js读取该缓存的更新指示器随之复位重启运行时后新的 commands 和 agents 在会话中可用。如果重启后仍看不到新命令先检查第 2 步node scripts/build-hooks.js是否执行过、第 3 步安装器的运行时参数是否与你正在使用的运行时一致——这两项是文档中该流程仅有的易错点。【免费下载链接】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），仅供参考