发布版本

变更记录

在 content/changelog/unreleased/index.md 记录用户可见的变化、配置要求和实际修复。 合并同类条目，不记录内部重构、测试细节或仅属于消费站点的变化。

发布时将该 bundle 移至 content/changelog/vX.Y.Z/index.md， 把 title 和 slug 设为 vX.Y.Z，把 date 和 lastmod 设为发布日期。 新建 unreleased bundle。集合布局会自动列出版本页面。

配套标签

将 SKILL.md 的 metadata.version 和 module/theme.toml 的 version 更新为同一本次版本号并提交。 在同一提交上创建两个标签；下面以 0.1.0 和当前 HEAD 为例：

swban base/git tag v0.1.0 HEAD                                                     #标记项目版本
swban base/git tag module/v0.1.0 HEAD                                              #标记 Go Module 版本
swban base/git push --atomic --no-follow-tags origin tag v0.1.0 tag module/v0.1.0  #发布两个标签

此处 swban 代表已准备的 Skill 入口。 两个标签都指向整个仓库的同一提交。v0.1.0 用于项目发布和提取 Skill； module/v0.1.0 供 Go 将子目录 Module 识别为 v0.1.0。 因为 Module 根目录是 module/，仅有项目标签不能提供该 Module 的语义版本。 这是 Go 的子目录 Module 标签规则。 GitHub Release 使用 v0.1.0，无需再为 module/v0.1.0 创建 Release。 若附带 Skill ZIP，包含 Skill 目录和许可证，排除 .tools、node_modules 和缓存。

GitHub Release

需要 GitHub CLI 时再准备和登录：

swban base/gh/ensure            #准备 GitHub CLI
swban base/gh auth login --web  #登录 GitHub

版本页面上线、标签推送完成后，为 GitHub Release 添加说明链接：

swban base/gh release create v0.1.0 --verify-tag --notes https://banyan.swaw.com/changelog/v0.1.0/  #链接发布说明

需要附件时，追加 Skill ZIP 路径。--verify-tag 防止命令隐式新建标签。

版本显示

Powered by 使用 Hugo 的 hugo.Deps 读取实际主题 Module 版本。 本地替换显示“Local development”；Module 的提交和未提交状态用于诊断。 站点基于时间戳的构建／PWA 版本与主题发布版本独立。