6.3.0

v6.3.0

compare changes

🚀 特性

• Changelog 类型分组新增 excludeScopes——按 scope 排除提交、breaking 提交一律显示 (7eae653)

📖 文档

• website: 配置示例提供 TOML / JSONC 双格式切换，补充编辑器补全与校验提示用法 (COL-105) (9f6c027)
• 配置文档 excludeScopes 示例补齐 JSONC 格式 (3e961d9)
• website: 文档站文案口径统一——「变体包 / 通路 / 锁步」等内部用词换成读者可懂的表述 (58598eb)
• website: 平台覆盖描述改表格展示——快速上手精简决策表、npm 页覆盖表与 Intel Mac 警告、crates.io 页平台 × 安装方式完整矩阵 (1b0613f)

❤️ Contributors

• Whitekite

6.2.0

v6.2.0

compare changes

🚀 特性

• release: Release 子命令新增 --dry-run——校验照走 + token 来源报告 + 平台 Release 计划预览 (885df5d)
• bump: 默认 bump 命令新增 --dry-run——逐文件预演判定 + 全量执行计划与 changelog 全文预览 (1309c10)
• token: Token set/list 支持 --host——host 作用域复合键 provider@host 与规范化（无 scheme 补 https、小写、去尾斜杠、保留端口路径），token 子命令抽出 flag 扫描小 helper (26dbae1)
• release: Gitlab token 解析链扩为四级——存储 host 作用域精确键优先、provider 级键回落（存量用户零感知）、GITLAB_TOKEN 兜底，缺失报错带 --host 指引；有效 host 解析提前到 token 链之前，dry-run 链同路消费 (f9b48f8)
• token: Token remove 扩展为完整交互矩阵——四目标形态（provider 精确/--host 精确/--all 全清）+ --dry-run 只列清单优先、--yes 跳过确认、默认 No 二次确认、非 TTY 报错引导 --yes (ea09241)
• website: 首页演示采集管线产 asciicast v2 时间线——第一段 vbumpp --dry-run 计划预览（COL-89） (35a2cd3)
• website: 首页 cast 播放基座——wterm 演示终端按时间线自动播放 dry-run 演示 (COL-90) (9b27c6f)
• website: Wterm.wasm 改为生成物——postinstall/build/dev 自动从 @wterm/core 同步 (7e3c395)
• website: 首页滚动演示采集补全四段——-r 整树计划、release 补发预览、token 清单 (COL-91) (e0fb6d3)
• website: 首页滚动演示区上线——sticky 终端随滚动重放四段子命令演示 (COL-92) (4e3af3c)
• config: 文件层键名与类型双重校验——类型不符报错指出键路径与期望类型 (COL-100) (188ff0a)
• config: JSON Schema 说明补齐每个配置字段——面向编辑器提示一个不能缺 (COL-100) (e35b01d)
• cli: Vbumpp schema 子命令——stdout 纯 JSON 导出与 --write 落盘项目级 / 全局副本 (COL-102) (7f3f353)
• napi: BumpVersion 入参类型化边界结构体，TS 配置类型自动生成 (COL-103) (c00a663)
• scripts: Schema 产物再生脚本与 CI 漂移校验腿——npm 包副本与 website 静态导出两处提交 (COL-104) (40457f5)

🩹 修复

• build: 文档站冒烟断言兼容 basePath 模板拼接形态 (745ec22)
• npm: Npm 五包补包级 tsconfig——修复 tsdown 构建 dts 产出断裂 (COL-94) (6d954ff)
• cli: Changelog.output 统一回落配置——release 读配置、bump 默认值不再覆盖 (COL-101) (e333fb1)

💅 重构

• core: Bump/release 副作用收口统一效应边界——逐文件更新拆判定段（只读）与写盘段，token 解析返回来源 (71d172e)
• structure: 全仓 mod.rs 清零——changelog/release 模块入口改为 foo.rs + foo/ 目录形态，tests 侧 common 与 plugins 三处 mod.rs 同级改名，模块声明与对外 API 路径（vbumpp_core::changelog::* / release::*）不变；随改名修正 markdown.rs 的管线指向与 tests/release 的 common 引入路径 (d7b2460)
• cli: Cli.rs 拆分为 cli/ 子目录——入口持 run_from_argv/run_at/RunEnv，parse/bump/release/token/output 各一文件（对外路径不变，napi 与原生 bin 零改动）；内联测试全部迁出 crate：cli 用例合流重组为 tests/cli/ 的 main.rs + parse/token 子模块（用例数不变），display/progress/extract 三处迁至 tests 镜像文件；解析层细节（parse/bump_overrides/resolve_provider/scan_token_args 等）经 #[doc(hidden)] re-export 测试缝对 tests 暴露 (8a410b2)

📖 文档

• 各包 README 对齐当前实现，收敛为只讲当前版本用法 (fc38fb8)
• CONTEXT.md 增补 Dry run 词条——预演与执行同路的语义约定先行落地 (178a1fa)
• 确立 --dry-run 的语义与预演同路结构，website CLI 参考同步 (c9f4e45)
• 多私有 GitLab token 指引与 remove 矩阵对齐实现——website token/release 章节、两 README、CONTEXT 词条同步，新增决策记录（host 作用域复合键方案、remove 交互矩阵、手写解析器维持） (1b78070)
• 确立 Rust crate 结构规范——无 mod.rs 模块入口为强制规则（src/tests 任何位置不得新增）、src 500 / tests 1000 行软上限、tests 镜像 src 与内联测试禁令、fixtures 与共享工具归位；AGENTS.md 与 CONTRIBUTING.md 同步指引 (a8286a1)
• 首页滚动演示定策——自产 asciicast v2 cast 时间线配 wterm 渲染层、dry-run 只读离线确定性采集、产物本地生成提交 + CI 漂移校验、重放式 seek；CONTEXT 增「演示时间线」词条 (a5b2a8d)
• agents: 仓库脚本 TypeScript 直跑规范落档——scripts.md + AGENTS.md 指引 (COL-98) (faa5264)
• Socket 同构免罚假设证伪落档——能力型告警为 napi loader 固有面，生成物决策保留不回滚 (COL-78) (3c02423)

🏡 框架

• scripts: 仓库脚本全量迁移 TypeScript——node 原生直跑 + 根 tsc 类型门挂 hk (COL-94, COL-95, COL-96, COL-97) (7f1103a)
• website: Website 包声明 "type": "module"——消除 node 直跑 TS 脚本的 typeless 警告 (COL-99) (bcbcfb8)
• rust: Crate 结构与引入风格治理——超限 bump.rs 拆入 bump/ 子域，引入一律文件头集中完成 (c0f7d66)

❤️ Contributors

• Whitekite

6.1.2

v6.1.2

compare changes

🚀 特性

• ci: Npm-publish 前置检测全新包名——CI 发现从未上架包名即整体拦停并输出首发仪式指引 (b039c3d)

💅 重构

• napi: Loader 退回 napi-rs 官方生成物消供应链告警——平台清单报错与版本强校验两条手写增强一并放弃 (1af16bb)

📖 文档

• website: Install 两页增列 mise 安装通路——crates-io 页 cargo:vbumpp,npm 页 npm:@vill-v/bumpp (524a329)

🏡 框架

• Node lts 解析漂移 24.18.1→24.19.0,mise.lock 跟进锁定 (2f73ebc)
• Hk schema 改回官方包网络引用——pkl/ vendor 目录移除,vendor 化撤回 (fa6b454)

❤️ Contributors

• Whitekite

6.1.1

v6.1.1

compare changes

🩹 修复

• napi: Core 发布包剔除内置 .node——平台包为二进制唯一分发通道 (9d54c53)

📖 文档

• 发版质量门前移决策与新 npm 包名首发仪式术语——v6.1.0 两起发版事故复盘 (5099df8)
• 记录 core 发布包不内置 .node——optionalDependencies 为二进制唯一分发通道 (e2544e4)

🏡 框架

• Rust 钉版 1.97.1 + hk git hook 质量门——pre-commit 跑 fmt check、pre-push 跑 clippy,prepare 自动装配 hook;v6.1.0 发版 fmt 漏检事故的前移防线 (1184a32)
• Prepare 瘦身至裸 hk install——环境引导责任移入贡献指南,失败即提示先 mise install (e66a8aa)
• Gitignore 增 .artifacts——首发仪式下载 CI 产物的暂存目录不再污染 git status (931bb71)

❤️ Contributors

• Whitekite

6.1.0

v6.1.0

compare changes

🚀 特性

• scripts: 发版自检 verify-tag-ci——tag push 后轮询 Actions runs，GitHub 丢事件当场告警（COL-62） (3558355)
• core: 控制台显示路径统一——cwd 内相对、cwd 外绝对、一律 POSIX（ADR-0023） (8ddf26c)
• core: Ecosystem::Node → Ecosystem::JavaScript 术语更正 (2f9d093)
• ci: 文档站部署前后冒烟验证——产物 basePath 断言 + 线上关键资源轮询 (9112d09)
• napi: 平台包目录切 napi.targets 驱动的生成流，平台矩阵扩 musl ×2 对齐 7 target (91f8030)
• core: Install 检测增列 devEngines.packageManager 包管理器声明——同级第三优先级只消费对象形态 name，无效形态静默回退（COL-76） (70ed77d)

🩹 修复

• core: 配置 release 键接通 bump 编排 + 顶层键名白名单校验（COL-60） (5fcc188)
• core: -r 收集感知 gitignore + commit 过滤未跟踪 pathspec（COL-61，v6.0.0 发版中断根因） (b418f56)
• website: 静态搜索客户端显式携带 basePath 抓取索引 (c2ca697)

📖 文档

• adr: ADR-0022 收集器迁 ignore crate 暂缓记录——剪枝性能/非 git 目录两优势与重启信号存档，防未来大仓库性能问题重新调研 (e353df7)
• adr: ADR-0027 补记良性 linker 警告的维护者裁定（COL-63 验收闭环） (7ea25b7)
• adr: ADR-0025 cargo-binstall 免编译安装渠道——GitHub Release 挂预编译 CLI (287faae)
• adr: ADR-0026 napi 平台矩阵扩 musl ×2——修 Alpine npm 安装硬失败 (b8ea1a6)
• website: 删除首页「构建」区 (73d0a52)
• website: 新增「生态集成」文档（JavaScript / Cargo） (d19f762)
• website: 清理程序员常识与设计意图文案 (f0c76d8)
• Consolidate current architecture decisions (607ed24)
• 明确 npm 渠道不支持 darwin-x64，安装文档引导 Intel Mac 用户走 cargo 渠道 (e32af9c)
• Darwin-x64 决策的替代路径表述对齐免编译安装（cargo-binstall 渠道）术语 (fc80898)
• 裁定 private 包随整树收集锁步为既定行为——版本侧不按 private 过滤，收集器不新增过滤分支 (9011a11)
• Vbumpp crate 补 README——crates.io 页面并列 binstall 免编译与 cargo install 通路，注明 7 target 覆盖与回退语义 (cc55c49)
• 网站安装文档增列 cargo-binstall 免编译渠道——快速上手安装段与 crates.io 页并列 npm/binstall/cargo install 通路 (23560da)
• CONTEXT 术语对齐平台包生成流——增 napi.targets 单一真相源条目，平台包目录改写为 create-npm-dirs 生成不提交（COL-75） (55692f7)

🏡 框架

• meta: 发布元数据批修——repository.url 补 .git ×11 + 平台包 type:commonjs ×5 + homepage 统一指向 GitHub Pages（npm 11 + crates 2） (ae2ea3d)
• skills: Tsdown skill 上游同步（rolldown/tsdown） (2d66235)
• gitignore: 忽略 .zcode/plans (4ab2316)

📦 打包

• ci: Linux-arm64 交叉链换 zig 淘汰 gcc 4.8.5，TLS 回 rustls（COL-63，ADR-0027） (4749db6)
• mise: Zig/cargo-zigbuild 加 os=["linux"] 过滤——macOS/Windows 腿与本地免装 (d5bfc03)

❤️ Contributors

• Whitekite

6.0.0

v6.0.0

compare changes

⚠️ v6 大版本更新要点

• 纯 Rust 重写：核心引擎全部 Rust 化——npm 通路走 napi 平台预编译包，另有原生 CLI 单二进制（cargo install vbumpp，无需 Node.js），功能完全一致
• 依赖大幅瘦身：安装体积 8.6 MB / 59 包 → ≈5 MB / 3 包（npm 通路）；原生 CLI 为 4.6 MB 零依赖单二进制
• 配置文件统一：收归 .vbumpprc.json（也支持 .jsonc / .toml）；bump.config.*、vbumpp.config.*、changelog.config.*、package.json 的 changelog 键一律不再读取（静默失效）
• 编程式 API 收紧：defineConfig 移除、@vill-v/bumpp/changelogen 子路径移除、token/release 操作收归 CLI 子命令
• changelog 产出完全离线：分组标题默认英文（中文需在 changelog.types 显式声明）、贡献者行不再请求第三方服务、不再显示邮箱与 @链接
• 新文档站上线：含迁移指南、CLI 参考、配置参考

升级前请阅读 v5 → v6 迁移指南 · 文档站：https://vill-v-kit.github.io/bumpp

🚀 特性

• core: 新增 @vill-v/bumpp-core napi 脚手架，接通 mise/turbo 工具链 (COL-6) (b712faf)
• core: LoadBumpConfig 纯 Rust 实现（仅 JSON 配置） (COL-8) (9fcc92f)
• core: 候选版本计算纯函数，全量对齐上游 bumpp v11 (COL-9) (9c97a82)
• core: 文件版本更新（manifest 保格式 + 文本模板替换） (COL-10) (8e1feb3)
• core: Git 操作 + npm scripts，全部 shell out (COL-11) (1f201e0)
• core: 预编译平台包布局 + GitHub Actions 构建/测试矩阵 (COL-12) (9bace0e)
• core: Conventional 提交解析与版本推断 (COL-13) (433ae07)
• core: VersionBumpInfo 全链路（Rust 渲染 prompt） (COL-14) (8ee224a)
• core: VersionBump 全链路编排 + ThreadsafeFunction 进度 (COL-15) (8d0cf51)
• bump: 切换至 @vill-v/bumpp-core（自举前置） (COL-16) (baca57b)
• core: Progress 内置 Rust，拆除 JS 进度面 (COL-19) (0364c6e)
• core: Version-files 插件底座 crate，JsManifest/Text 纯迁移 (COL-22) (8628075)
• core: Cargo.toml 版本同步——CargoTomlPlugin + Cargo.lock 定向同步 (COL-23) (e1aa4d6)
• structure: Napi/ 受众判别约定 + bumpp-core/平台包原子搬迁 (COL-25) (9fae9a2)
• core: Package-manager 检测对齐上游名单 + pm.rs 模块独立 (COL-26) (4044a31)
• core: Install 生态适配文件夹与条件触发 (COL-28) (752b7fe)
• core: Recursive 生态感知——链上清单模式表 + napi 导出 + CLI -r 重接 (COL-31) (1c3070a)
• core: 插件底座落地——默认清单/版本来源生态化 + scripts 通用化 (COL-32) (f347526)
• core: 配置文件改名 .vbumpprc.json——旧名不探测 + recursive 展开收归加载器 (COL-33) (0967167)
• core: Git 只读历史操作 + napi 导出——tag/diff/branch/remote 解析对齐 changelogen (COL-34) (a55959a)
• core: Changelog 配置段解析——内建默认 + types 深合并 + 严格 schema (COL-35) (804d167)
• core: Changelog markdown 引擎——展示层解析 + 结构 parity + golden fixtures (COL-36) (7e1375b)
• core: GenerateChangelog 编排 + napi——changelog.ts 内置与 N1/C1/C2/C3 修复 (COL-37) (92198da)
• bump: 薄编排重接——三删一迁 + Config 扁平化 + ./changelog 子路径 + 依赖瘦身 (COL-38) (ecb21eb)
• release: 导入改 ./changelog 子路径 + defineConfig 移除 (COL-39) (c868d8a)
• core: 剩余功能全面 Rust 化 + 全局配置与 JSONC/TOML 多格式（ADR-0014/0015） (ab3f302)
• cli: CLI 全权归 Rust——cliRun 单入口与五包收缩（ADR-0016，COL-41/42/43） (169f6b7)
• core: 用户可见字符串统一英文，changelog types 中文定制移项目级配置（ADR-0017） (69458a1)
• cli: 纯 Rust CLI + vbumpp release 重试子命令 + napi 面三收缩（ADR-0019，COL-48） (e014b7d)
• docs: 文档网站——fumadocs 落地 website/ + GitHub Pages 部署（ADR-0020，COL-49） (d9f1b5e)
• website: 品牌 logo——#ff6736 水波圆徽 + 导航/favicon 接线（COL-49） (13e6920)
• website: 首页终端演示素材捕获管道——pty 实跑 vbumpp 交互发版 + ANSI 帧塌缩 + 钉日期确定性复跑（COL-57） (8d259d3)
• website: 首页 hero 增强——v6 迁移 pill + 标题放大 5xl/6xl + 品牌橙强调「一条命令」（COL-58） (d45400b)
• website: 首页嵌入 macOS 风终端窗口——红绿灯标题栏 + COL-57 实捕发版输出，纯 HTML/CSS 零新依赖（COL-59） (e6f7d92)
• crates: Vbumpp-core/vbumpp 上架开闸——移除 publish=false，workspace dep 补宽松版本区间 >=5.1,<7（^6 在 5.x 现世不可解析，ADR-0021 同步修订）（COL-50） (f922dd2)
• ci: 上架幂等守卫 publish-guard——npm/crates.io 双查 + 放行/跳过/失败三态退出码（COL-51） (865d265)
• ci: Publish-npm job——artifact 注入 + 前置校验 + 守卫过滤上架（COL-53） (817e5f2)
• ci: Publish-crates job——dry-run 前置 + core→cli 顺序上架（COL-54） (49d377c)

🩹 修复

• core: Prompt 选项去内嵌 bold——修复活动行 ANSI 裸显 (COL-30) (b793eae)
• core: Release 报错脱敏——明文 token 不出错误消息（ADR-0014 注记，COL-47） (a06089a)
• website: Llms 系生成物 URL 补全 basePath——llms.txt/llms-full.txt/content.md 输出绝对地址，修复子路径部署下全量 404 (2dff9e0)
• website: 演示素材 push 行洗白——fixture remote 改绝对路径，输出 To ~/my-project.git 取代 ../remote.git 内部痕迹（code-review COL-57） (4f8178f)

💅 重构

• core: 迁移 packages/core → npm/bumpp-core，确立 crates/napi/npm 分层约定 (386e292)
• 废弃 packages/，全部可发版包归入 npm/ (fa6e365)
• core: Version-files 合并回 bumpp-core，生态插件文件夹化 (COL-27) (bc0688a)
• core: Clippy 历史警告清理——manual_contains + 测试模块位置 (37a5056)
• core: Release 按 provider 单文件 + 共用原语抽 http.rs（ADR-0018，COL-46） (1ae4340)
• crates: Crates.io 家族更名 vbumpp-*——bumpp-core→vbumpp-core、bumpp-cli→vbumpp 落地 ADR-0021（2026-08 修订），CONTEXT 增上架术语、website 安装文档同步 (948dadb)
• scripts: Code-review 收尾——GUARD_UA 更名 + relay 折叠 + shebang 统一 + ADR-0021 决策②补 index.d.ts 括注 (4811789)

📖 文档

• 补充工程技能约定与 rust napi 重写 ADR (676d8b9)
• 架构/平台矩阵文档与贡献指南 (COL-17) (db8a7b2)
• ADR-0002 progress 内置 + ADR-0003 Cargo.toml 版本同步决策 (be10bd4)
• ADR-0004 version-files 插件底座 crate (184d1fc)
• compliance: 上游开源标识三层闭合——LICENSE 版权行 + README 致谢 + 发包携带 (COL-24) (aabe009)
• adr: 矛盾决策记录精简——0007 权威化、0004 删除、0005 去标签 (COL-29) (d8658a6)
• adr: Changelogen 使用面重写与配置文件统一决策记录——ADR-0012/0013 + 词汇表 (COL-32) (bd66f2b)
• V6 迁移指南 + napi 全链路冒烟脚本 (COL-40) (2794e8a)
• ADR-0016（CLI 全权归 Rust）+ CONTEXT 词条 + ADR-0014 例外标注 (9e994aa)
• adr: 0018 补注记——napi 四导出已由 ADR-0019 移除（COL-48） (45e02b1)
• adr: 0019 补注记——crates.io 分发已决策随 v6 上架 bumpp-cli (bd09706)
• website: Crates-io 安装页移除未上架 callout——页面随 v6 发版部署，届时 crate 已上架（ADR-0019 注记） (b87a003)
• website: Cli 参考首语法块替换为完整 --help 输出——原样捕获自 vbumpp 二进制 (db02a83)
• website: 迁移指南依赖瘦身节补实测体积数据——v5 8.6MB/59包 → napi ≈5MB/3包 → 原生 CLI 4.6MB 单二进制 (0cb8791)
• contributing: 发布流程节改写为实际上架链路 + ADR-0021 双向互链（COL-55） (de87aee)

🏡 框架

• 删除 packages/next 实验包 (COL-7) (04c6535)
• 包声明邮箱统一替换为 xuxjigsaw@qq.com (65f60b1)
• CHANGELOG 历史记录邮箱同步替换为 xuxjigsaw@qq.com (87ee599)
• 升级开发依赖与 pnpm 版本 (3b8f059)
• 发版 files 显式配置移除——默认清单已覆盖根 Cargo.toml（COL-44） (8dee7f1)

📦 打包

• Xcode 27 链接器 Mach-O 串池错位规避——darwin 声明 SDK 26.0 (c8f05c8)
• Cargo 成员引用与版本号收编根 workspace 统一管理（ADR-0003 修订，COL-44） (8e851ae)

✅ 测试

• core: Loader 负例改到干净子进程执行（隔离 CI 环境 NODE_PATH 干扰） (bcaab17)
• core: Update-files parity 路径列表改集合比较（上游...