« Changelog History


GCli v3.5.0 Release Notes

Release Date: 2026-06-06 // 10 days ago

  • 🔄 Change Log

    🔨 Refactor

    • 🔨 refactor(gcli): strictMode 收敛为驱动 gflag EnhanceShort，弃用盲拆短选项 c23dc37

    🔋 Feature

    • feat(gflag): CliOpt.Question 声明式交互收集(B7) 743711f
    • feat(gflag): FromStruct 支持 TagRuleField 标签规则 49faaa4
    • feat(gflag): FromStruct 支持匿名嵌套字段展开 2aa7bee
    • feat(gflag): EnhanceShort 短选项规范化预处理(expandShortArgs) daf0646
    • feat(examples): 新增 B4-B7 特性演示命令 60bea2f
    • 🔀 feat(gflag): EnhanceShort 增加语义常量 None/Merge/Attach a0ee47f
    • feat(gcli): 支持全局 EnhanceShort 设置 0c51299

    Other

    • chore(gflag): B6 收尾打磨 ef066ce
    • 📄 docs: 修正短选项合并说明(需 EnhanceShort/strict 开启) 2da8714
    • 📄 docs(plans): B4+B5 标记完成并记录实际落地 668e041
    • 📄 docs: README 介绍最近新增功能(B4-B7) c84ea8a
    • 🔀 test: merge to test files to one file bafa73f
    • 📄 docs(blogs): 新增 v3.4 新特性介绍 blog(中英双语) d8c702c
    • 📄 docs: 补全局 EnhanceShort 说明 + CHANGELOG v3.4.1/v3.5.0 56c914f
    • 📄 docs(blogs): blog 对齐 v3.5.0 发版 + 补全局 EnhanceShort f87c9e3
    • 📄 docs(changelog): v3.5.0 增加 Highlights 总览 a38acdb
    • 📄 docs(blogs): blog 行宽规整(英文 120 折行 / 中文每段一行) 70d4fe4

Previous changes from v3.4.0

  • 🔄 Change Log

    🔨 Refactor

    • 🔨 refactor(gcli): 移除全局默认 --verbose 选项，改由 GCLI_VERBOSE 控制 eb09709
    • 🔨 refactor(gflag): 抽取 validateAll，合并 Parse/ParseOpts 重复校验逻辑 c4f337e
    • 🔨 refactor(gcli): 全局选项统一为单一数据源(App 复用 gOpts) 43b6b43
    • 🔨 refactor(app): findCommandName 改为无副作用返回 foundCmd ee0af38
    • 🔨 refactor(helper): 迁移 helper 至 internal/helper，删除空壳 internal/help_tpl.go a60f0a4

    🔋 Feature

    • feat(help): 支持按 Category 对命令分组显示帮助 9e8fae2
    • feat(gflag): 支持按 Category 对选项分组显示帮助 9dea78d

    🛠 Fixed

    • 🛠 fix(cmd): 修复 Command.Copy() 误清空原命令 Hooks 的 bug 84a3f87
    • 🛠 fix(gflag): Parse 不再静默吞掉内部 panic d4c8b25
    • 🛠 fix(examples): 修复 progress_demo 剩余的 int64 参数类型错误 8fa6121
    • 🛠 fix(app): 修复 help COMMAND 失效与 findSimilarCmd 污染命令注册表 7d62dd8

    Other

    • 🏗 build: 更新 goutil 依赖至稳定版本 v0.7.5 17a5d80
    • 🏗 build(deps): bump github.com/gookit/cliui from 0.2.3 to 0.2.4 (#159) e853f5e
    • 🏗 build(deps): bump github.com/gookit/cliui from 0.2.4 to 0.3.0 (#160) 65a7a11
    • 🏗 build(deps): bump github.com/gookit/goutil from 0.7.5 to 0.7.6 (#161) 80735ef
    • ⚡️ chore: update some docs and fix demo error eff5d6a
    • 📄 docs: 补充命令/选项分类(Category)用法说明 cad1b73
    • 📄 docs(plans): 新增 A/F/G 结构性重构实现计划(待评审) b4a8053
    • ⚡️ chore: update ci config and rm some files 7f614c7
    • 📄 docs(plans): 计划新增 H 项——helper 收敛 internal 并清理死代码 e09d9fb
    • chore: 移除未引用的 gclicom 包 bc0d468
    • chore(app): gofmt 规整 prepareRun 上方 doc 注释(本轮已重度修改该文件) 18f7ed4
    • 📄 docs(todo): 记录重构期间发现的既有问题(help COMMAND 失效等) 6e74bb0
    • chore: gofmt 规整预存格式漂移(gflag/gflag.go、gflag/util.go、tcp_proxy.go) 2f25d9e
    • 📄 docs(todo): 勾选已完成的 A/F/G/H 重构项 0534175
    • 📄 docs: 新增 CHANGELOG 并发布 v3.4.0；version 常量更新为 3.4.0 a781a09
    • 📄 docs(todo): 勾选 CHANGELOG/发版准备项 7e25cd3
    • ⚡️ chore: upgrade dep to latest and update the assert pkg path 9465b8b