Windows AI 代理中文乱码修复技能 — gkd2323c-charset-fix

技能简介

gkd2323c-charset-fix 是一款专注解决 Windows 终端中文乱码的实用技能，面向 Claude、Codex、Claude Code 等在 Windows 上干活的 AI 编程代理。场景很常见：在 Git Bash 或 MSYS2 这类 POSIX shell 里让 Agent 跑 Python、PowerShell、cmd.exe 命令，输出的中文和 Unicode 字符变成一串问号或方块——根因是 POSIX shell、Python 解释器、PowerShell 控制台、cmd.exe 各自的编码口径不一致，GBK 与 UTF-8 在同一条管道里互相踩踏。这个技能给出分工具、分场景的定向修复方案：Python 会话改 UTF-8 输出、PowerShell 设置控制台输出编码、cmd.exe 与原生工具走 GBK 解码桥，并附带本地验证步骤，帮 Agent 先诊断是谁在乱码，再用最小改动修好。Skillstore 质量评分 81 分（silver 档），riskLevel 为 safe，MIT 许可，页面浏览 70 次、安装 44 次，是本批候选中安装量最高的技能。

核心能力

• 乱码成因诊断：解释 Windows POSIX shell 为什么会出现中文或 Unicode 输出乱码，能区分是 Python、PowerShell 还是 cmd.exe 在作怪。
• Python UTF-8 输出修复：给出 Python 命令与会话级别的 UTF-8 输出设置，让 Agent 读到的中文不再错乱。
• PowerShell 控制台编码设置：展示 Windows PowerShell 控制台输出编码的正确设置方式。
• GBK 解码桥：为 cmd.exe 与 Windows 原生工具提供 GBK 解码桥接，兼容不支持 UTF-8 的老工具。
• 本地验证闭环：为 Claude Code、Codex CLI 等 Agent 提供修复后的本地验证步骤，用中文与 Unicode 样例确认真的修好了。
• 团队规范沉淀：可生成可复用的团队终端编码配置说明，让全组 Windows 环境口径一致。

安装配置

1. 环境前置：Windows 系统 + Git Bash / MSYS2 等 POSIX shell，安装 Node.js（用于 npx skillstore 命令）与 Claude / Codex / Claude Code 任一客户端。
2. 一键安装：执行 npx skillstore add gkd2323c/charset-fix，技能写入本地 Agent 技能目录。
3. 权限说明：技能带外部命令与网络风险标记（external_commands, network），其辅助脚本会执行本地诊断命令——安装前可先审阅脚本内容，不从不可信来源粘贴诊断命令。
4. 权限范围界定：明确只在受影响的工具 / 会话上应用修复，不要顺手改整个系统区域设置。

使用步骤

1. 复现乱码：在 Windows Git Bash 中让 AI 代理运行产生中文输出的命令，确认乱码现象。
2. 发起诊断：用"Fix Garbled Output"或"Diagnose Tool Source"模板，让技能定位乱码来自 Python、PowerShell 还是 cmd.exe。
3. 定向修复：按诊断结果选择对应方案——Python 会话走 UTF-8 输出设置，PowerShell 走控制台编码设置，cmd.exe 走 GBK 解码桥。
4. 样例验证：执行技能提供的本地验证步骤，用一段中文与 Unicode 文本样例确认输出恢复正常。
5. 固化配置（团队）：用"Create Team Guidance"模板把验证过的设置整理成团队规范文档，供其他成员复用。
6. 保持会话级：默认只在当前会话生效；除非团队已测试过永久改动，否则不要改系统区域设置或代码页。

适用场景

• Windows 上的 Agent 输出修复：Git Bash / MSYS2 中 Claude Code、Codex CLI 输出中文不可读时的急救。
• 团队终端标准化：统一使用 Codex CLI / Claude Code / Cursor 的 Windows 团队，沉淀可复制的编码配置。
• 乱码问题排查：快速判断乱码责任方（Python / PowerShell / cmd.exe），避免盲目改配置。
• Python 中文输出：Windows POSIX shell 下 Python 脚本打印中文错乱的修复。
• 老工具兼容：不支持 UTF-8 的 Windows 原生命令行工具接入中文流水线时的桥接。

适用人群

• 在 Windows 上使用 AI 编程代理的开发者：直接受益人群，尤其经常处理中文内容。
• Windows 平台的运维与支持工程师：需要快速排查终端显示问题。
• 团队工具链负责人：负责统一成员开发环境配置。
• Python / PowerShell 开发者：在混合 shell 环境中遇到输出错乱的所有人。
• 教育与培训场景：讲解字符编码（GBK / UTF-8）在 Windows 上实际冲突的生动案例。

工作原理

技能的核心是"分层诊断 + 最小改动"：终端乱码从来不是单一组件的问题，而是 POSIX shell 的 locale、Python 的标准输出编码、PowerShell 控制台代码页、cmd.exe 的活动代码页四层各说各话的结果。技能让 AI 代理先用本地诊断命令逐层定位责任方，再只对出问题的那一层动手——Python 用 UTF-8 输出设置、PowerShell 用控制台编码设置、cmd.exe 用 GBK 解码桥，而不是粗暴地把整个系统区域设置改掉。修复后用中文与 Unicode 样例做回归验证。技能明确三条边界：只针对 Windows 混合 shell 场景；不改系统区域设置与永久代码页；PowerShell Core 默认 UTF-8 通常无需修复。辅助脚本只跑本地诊断命令，Skillstore 审计确认无提示注入、无数据外传、无用户可控命令执行。

官方链接

• Skillstore 详情页：
• GitHub 仓库：
• 一键安装：npx skillstore add gkd2323c/charset-fix
• Manifest：