升级

其他 社区 v1.1.0

技能解读

设计思路

gstack-upgrade 是 gstack 自身的「自我升级」skill——支持两种触发:preamble 检测到新版自动跑(inline upgrade flow),用户主动 /gstack-upgrade 跑(standalone)。还要处理「全局装一份 + 项目里 vendored 一份」这种双轨布局,team mode 时要自动清理项目里残留的 vendored 副本,保证团队共享同一全局版本。

Inline upgrade flow(被 preamble 触发)

Step 1-3:检测 UPGRADE_AVAILABLE <old> <new>,按用户配置(auto-upgrade 或 4 选项 AskUserQuestion)决定走 / 跳过 / 推迟。

Step 4-5:跑实际升级(git pull / curl 安装脚本 / 复制 release tarball),写「just-upgraded-from」标记,清掉 last-update-check / update-snoozed 缓存让下一次 preamble 不再误报。

Step 6:Show What's New 读 $INSTALL_DIR/CHANGELOG.md,找 old → new 之间的全部条目,按主题汇成 5-7 条 bullet。focus on user-facing changes——内部 refactor 除非很关键否则跳过。

gstack v{new} — upgraded from v{old}!

What's new:
- [bullet 1]
- [bullet 2]
- ...

Happy shipping!

Step 7:Continue——升级完成,回到用户原本调用的 skill。

Standalone usage(/gstack-upgrade 直调)

  1. gstack-update-check --force 强制刷新(绕过 cache)。
  2. 看是否 UPGRADE_AVAILABLE:
    • 有 → 走 Steps 2-6
    • 无 → 检查项目里有没有 stale vendored 副本:
      • 没 vendored 副本:「You're already on the latest version (v{version}).」
      • 有 vendored 副本 + team mode = true:移除 vendored 副本,告诉用户提交 .gitignore 的变化
      • 有 vendored 副本 + team mode ≠ true:对比 PRIMARY_VER 与 LOCAL_VER,差异时同步 local;一致时确认两份都最新

适合谁

  • 用 gstack 工具链的所有人
  • 团队负责人——确保大家都跑同版本
  • 多项目切换、有 vendored 历史的工程师

不适合

  • 不是 gstack 用户
  • 离线 / 内网环境无法访问 release 源

配套

gstack(生态入口)、document-release(发布前文档体检)、ship(发布主流程)。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
92 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@garrytan · v1.1.0 · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Bun
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步:询问用户(或自动升级)

首先,检查是否启用了自动升级:如果是`AUTO_UPGRADE=true`或`AUTO_UPGRADE=1`:跳过AskUserQuestion。记录“自动升级 gstack v{old} → v{new}...”并直接执行步骤 2。如果自动升级过程中`./setup`失败,请从备份(`.bak`目录)恢复并警告用户:“自动升级失败 — 恢复以前的版本。手动运行`/gstack-upgrade`重试。”否则,使用 AskUserQuestion:

02
第 2 步:检测安装类型

上面打印的安装类型和目录路径将在所有后续步骤中使用。

03
第 3 步:保存旧版本

使用下面第 2 步输出中的安装目录:

04
第四步:升级

使用步骤 2 中检测到的安装类型和目录:对于 git 安装(global-git、local-git):先快进 (#2517) — 与会话更新自动升级使用的策略相同。 `--autostash` 通过拉取进行本地编辑;渲染足迹污垢首先被丢弃,因为它是可再生的并且会毒害隐藏(#2569):

05
步骤 4.5:处理本地销售的副本

使用步骤 2 中的安装目录。检查是否还有本地供应的副本,以及团队模式是否处于活动状态: 如果 `LOCAL_GSTACK` 非空且 `TEAM_MODE` 为 `true`:删除供应的副本。团队模式使用全局安装作为单一事实来源。告诉用户:“删除了`$LOCAL_GSTACK`处的供应副本(团队模式处于活动状态 - 全局安装是事实来源)。准备好后提交`.gitignore`更改。”

06
步骤 4.75:运行版本迁移

`./setup`完成后,运行新旧版本之间的版本迁移脚本。迁移处理仅靠`./setup`无法覆盖的状态修复(过时的配置、孤立的文件、目录结构更改)。迁移是 `gstack-upgrade/migrations/` 中的幂等 bash 脚本。每个都被命名为`v{VERSION}.sh`,并且仅在从旧版本升级时运行。请参阅 CONTRIBUTING.md

07
步骤 4.8:停止任何过时的守护进程(无条件)

在升级之前启动的浏览守护进程会继续为旧二进制文件的代码提供服务,直到它停止为止 - 它会在 `git reset --hard` 和 `./setup` 中幸存,因为正在运行的进程保存旧的可执行文件 (#2551)。始终使用步骤 2 中检测到的安装目录运行此步骤。将 `<install dir from Step 2>` 替换为之前的实际安装目录

08
第 6 步:展示新内容

阅读`$INSTALL_DIR/CHANGELOG.md`。查找旧版本和新版本之间的所有版本条目。总结为按主题分组的 5-7 个项目符号。不要不知所措——专注于面向用户的变化。跳过内部重构,除非它们很重要。格式:

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。