Git-Cliff 新增双输出功能：同时支持文件与标准输出

在软件开发过程中，自动化生成变更日志（CHANGELOG）是持续交付流程中的重要环节。Git-Cliff 作为一款基于 Git 历史的变更日志生成工具，近期针对输出方式进行了功能增强，允许用户同时将生成的变更日志内容写入文件并输出到标准输出（STDOUT）。

功能背景

传统模式下，Git-Cliff 通过 --prepend 参数将变更日志写入指定文件时，会完全抑制控制台输出。这在需要同时进行文件存储和实时处理的场景中存在局限，例如：

1. 需要将变更日志内容自动填充至 GitHub Release 的正文
2. 在 CI/CD 流水线中需要实时捕获日志内容进行后续处理
3. 开发者在本地需要同时查看变更内容和保存文件

技术实现方案

新版本通过两种方式实现双输出能力：

1. 组合参数方案

用户可通过组合现有参数实现：

git-cliff --prepend CHANGELOG.md --output OTHER.md

此时变更日志会同时写入两个文件，通过重定向可将 OTHER.md 内容输出到标准流。

2. 标准输出标识符

更优雅的方案是使用 - 作为特殊标识符表示标准输出：

git-cliff --prepend CHANGELOG.md --output - > captured.log

这种实现具有更好的跨平台兼容性，无需开发者处理不同操作系统的标准流差异。

技术优势

1. 非破坏性变更：完全兼容历史版本参数，不影响现有自动化脚本
2. 管道友好：标准输出可直接接入其他命令行工具进行处理
3. 跨平台支持：自动处理不同操作系统下的标准流差异
4. 灵活组合：支持与 --latest 等参数协同工作

典型应用场景

1. 自动化发布流程：

# 生成变更日志并创建GitHub Release
changelog=$(git-cliff --prepend CHANGELOG.md --output -)
gh release create v1.0.0 -n "$changelog"

2. 实时监控与存储：

# 在CI中同时存储文件和获取内容
git-cliff --prepend CHANGELOG.md --output - | tee release_notes.txt

3. 开发调试：

# 开发时实时查看变更内容同时保存文件
git-cliff --prepend CHANGELOG.md --output - | grep "BREAKING CHANGE"

实现建议

对于工具链开发者，建议：

1. 优先使用 - 标识符方案，避免手动处理 /dev/stdout 等平台特定路径
2. 在Node.js环境中可通过execa等库直接获取标准输出内容
3. 注意处理可能存在的编码问题，建议统一使用UTF-8编码

该功能的引入使得Git-Cliff在自动化工作流中的集成更加灵活，特别是在需要将变更日志内容多路分发的场景下展现出明显优势。开发者现在可以更轻松地构建端到端的发布自动化流水线，同时保持变更日志文件的即时更新。