v3.8.0

Change Log

Refactor

• refactor(gcli): 抽出 AppOptions, 每-App 解析状态不再共享单例 7e52e9a

Feature

• feat(gflag): 增加 Parser.InheritOptsFrom 选项合并基元 323219f
• feat(gcli): Command.SharedOpts 共享选项定义 + 分发时合并(含幂等) 77f2391
• feat(gcli): help 渲染继承选项分组(Inherited Options) b704f29
• feat(gflag): 增加 CliOpt.TypeName() 类型名访问器 ff308c0
• feat(docgen): markdown 命令文档生成(CmdMarkdown/AppMarkdown/MarkdownTree) 58d21b6
• feat(docgen): man page 命令文档生成(CmdMan/ManTree) 9189f4c
• feat(builtin): GenDoc 命令导出 md/man 文档 a64140e
• feat(docgen): man Examples 多行保留 81a0fda

Fixed

• fix(gcli): 共享 Required 校验改用类型感知判空 87951f0
• fix(docgen): Examples 清除颜色标签并渲染内置变量; index.md 显示版本 52bd7f6
• fix(gflag): FromStruct 展开未导出类型的匿名内嵌结构体 3ab62c7

Other

• docs(plan): add D2 persistent-options implementation plan 27c4582
• docs(plan): D2 增加现状 vs 持久选项的直观对照表 edcaf4e
• docs(plan): D2 选项 API 命名采用 SharedOpts 1f87aee
• docs(plan): D2 顶部加修订记录 894395c
• test(gcli): 共享选项继承/任意位置/局部优先/Required 用例 bf4ef0c
• docs: 三层选项模型(SharedOpts)说明 a42019e
• docs(plan): 标记 D2.1 完成, 记录复核备注与剩余项 8827ef9
• docs: 记录 D2.5 help 继承分组, 更新计划/TODO 进度 ec01234
• docs: 记录 D2.6 AppOptions 拆分, D2 收官 55e4b78
• chore: move some codes position on gcli.go 74a2b1a
• docs(changelog): 按实际 tag 边界拆分 v3.6.0/v3.7.0/v3.8.0 41f8129
• chore: bump version const to 3.8.0 2bff2a5
• docs(plan): add D3 doc-generation(man/markdown) plan 0b1ad99
• docs: 记录命令文档生成特性, 标记 D3 完成 14981b6
• docs(changelog): docgen 条目改为英文, 与其余条目一致 4cf2a7e
• chore: move some exampels to subdir c20f103
• chore: rename file and update some code style 1654d31
• chore: update changelog and todo, rm a file edb4e70
• docs(compare): 更新对比文档至 v3.8.0 能力 55c6460
• docs(readme): 重整功能介绍并缩减 color/cliui 周边章节 0368684
• docs(readme): update some md style in readme e571b2a
• docs(blogs): 新增 v3.8 What's New 博客(中英双语) 2d09963
• docs(changelog): 标记 v3.8.0 发布日期 2026-06-22 6740c62
• docs: 澄清匿名嵌套展开与 tag 规则无关(README + v3.8 博客) f03fe4e