用途：解决 AI 智能体在 Windows 上经 POSIX 兼容 shell 运行时，中文或扩展 Unicode 文本显示乱码的问题。根因是 Windows 系统、Python 3、Windows PowerShell、cmd.exe 默认使用 GBK/GB2312（CP936）编码，而 Git Bash、BusyBox、MSYS2 等 POSIX shell 期望 UTF-8，两者不匹配导致乱码。
主要能力：针对不同层给出修复方案。Python 设置 PYTHONIOENCODING=utf-8 覆盖标准输出编码检测；Windows PowerShell 用 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 设定控制台输出；cmd.exe 及 Windows 原生工具通过 Python 的 subprocess 作为 GBK→UTF-8 桥接，读取时指定 encoding='gbk' 再以 UTF-8 输出。也提供 Python 代码级修复：用 io.TextIOWrapper 包装 sys.stdout 并指定 utf-8。
使用方式：Python 单次执行可用 PYTHONIOENCODING=utf-8 python3 -c "print('中文测试 ✅')"，整个会话可 export PYTHONIOENCODING=utf-8。PowerShell 使用 powershell.exe -NoProfile -Command 加编码设置。cmd.exe 用 subprocess.run 指定 gbk 编码。可用 PYTHONIOENCODING=utf-8 python3 -c "print('charset-fix: 中文测试成功 ✅')" 验证。
适用场景：Windows 配合 Git Bash、BusyBox、MSYS2、WSL 等环境，以及 Claude Code、Codex CLI、Cline、Cursor、GitHub Copilot、OpenClaw 等智能体。
限制：macOS、Linux 与 PowerShell Core（pwsh）默认即 UTF-8，无需修复。资料未提供安装方式、依赖版本、价格或其它平台支持信息。许可为 MIT。