Skip to content

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

Python

fix(cli-hub): reconfigure stdout/stderr to UTF-8 on GBK consoles (Chinese Windows crash) (#419)

pwdh2026b6da3c8f1012
diff --git a/cli-hub/cli_hub/cli.py b/cli-hub/cli_hub/cli.py
index d037a6539..8203c6593 100644
--- a/cli-hub/cli_hub/cli.py
+++ b/cli-hub/cli_hub/cli.py
@@ -65,6 +65,23 @@ EXIT_USAGE = 2
EXIT_PARTIAL = 3
+def _ensure_utf8_stdio() -> None:
+ """GBK 控制台/管道兼容:stdout/stderr 重配为 UTF-8(replace 兜底)。
+
+ 中文 Windows(cp936)下,管道输出默认按 locale 编码(GBK),
+ ✓/✗/emoji 等字符会触发 UnicodeEncodeError 直接崩溃;
+ reconfig 后统一 UTF-8 输出,任何 locale 都不再崩。
+ """
+ for name in ("stdout", "stderr"):
+ stream = getattr(sys, name, None)
+ try:
+ if stream is not None and hasattr(stream, "reconfigure"):
+ stream.reconfigure(encoding="utf-8", errors="replace")
+ except (OSError, ValueError):
+ # 控制台/只读流不支持 reconfigure 时静默跳过
+ pass
+
+
def _invocation_command(ctx, version):
"""Return a compact label for the current invocation."""
argv = sys.argv[1:]
@@ -84,6 +101,7 @@ def _invocation_command(ctx, version):
@click.pass_context
def main(ctx, version):
"""cli-hub — Download and manage CLI-Anything CLIs, public CLIs, and curated matrices."""
+ _ensure_utf8_stdio()
track_first_run()
track_visit(command=_invocation_command(ctx, version), detection=detect_invocation_context())
if version:
diff --git a/cli-hub/tests/test_cli_hub.py b/cli-hub/tests/test_cli_hub.py
index dba729ac4..9e8f47a5c 100644
--- a/cli-hub/tests/test_cli_hub.py
+++ b/cli-hub/tests/test_cli_hub.py
@@ -2,6 +2,7 @@
import json
import os
+import sys
import tempfile
from pathlib import Path
from unittest.mock import patch, MagicMock
@@ -1509,6 +1510,24 @@ class TestCLI:
assert "previews" in result.output
assert result.exit_code == 0
+ def test_gbk_console_utf8_stdio(self):
+ """中文 Windows(GBK 管道)下 ✓/✗ 输出不再 UnicodeEncodeError(回归)。"""
+ import contextlib
+ import io
+
+ import click
+
+ from cli_hub import cli as cli_mod
+
+ buf = io.BytesIO()
+ gbk = io.TextIOWrapper(buf, encoding="gbk", errors="strict")
+ with contextlib.redirect_stdout(gbk):
+ cli_mod._ensure_utf8_stdio()
+ assert sys.stdout.encoding == "utf-8"
+ click.secho("✓ Installed Obsidian CLI (obsidian-agent)", fg="green")
+ out = buf.getvalue().decode("utf-8", errors="replace")
+ assert "Installed Obsidian CLI" in out
+
@patch("cli_hub.cli.track_first_run")
@patch("cli_hub.cli.track_visit")
@patch("cli_hub.cli.detect_invocation_context")