Utf8

opencode-plugin-utf8

OpenCode plugin that ensures UTF-8 encoding for shell environments, fixing Chinese character garbled text on Windows

维护活跃

GitHub 星标

月装机量

近 7 天 17

综合评分SCORE

30.8

生态多维模型

快速安装与配置

opencode.json

写入当前项目的 opencode.json，只对这个仓库生效。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-plugin-utf8@1.0.0"]
}

opencode 启动时会通过内嵌运行时自动加载 npm 依赖并缓存至本地目录，无需手动在全局环境执行安装。

README.md

OpenCode 插件：自动为 shell 环境注入 UTF-8 编码配置，解决 Windows 上中文乱码问题。

在 Windows 环境下使用 OpenCode 时，PowerShell 和 Python 子进程默认使用系统编码（如 GBK），导致中文输出乱码。本插件自动注入编码配置，无需手动设置��[...]

插件通过两个 hook 实现：

shell.env — 为所有 shell 命令注入 Python UTF-8 环境变量：
- PYTHONIOENCODING=utf-8
- PYTHONUTF8=1
tool.execute.before — 在 PowerShell 命令前添加编码设置：
- [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
- [Console]::InputEncoding = [System.Text.Encoding]::UTF8

npm install opencode-plugin-utf8

在 OpenCode 配置文件 (opencode.json 或 opencode.jsonc) 中添加：

{
  "plugin": ["opencode-plugin-utf8"]
}

或者本地开发时使用文件路径：

{
  "plugin": ["./node_modules/opencode-plugin-utf8/src/index.js"]
}

MIT