← Back to Skills Marketplace
Chinese-Encoding-Handler
by
petersunpingww-droid
· GitHub ↗
· v1.0.0
· MIT-0
95
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install chinese-encoding-handler
Description
解决PowerShell环境中文文件乱码，支持自动编码检测、安全读写及终端中文显示修复。
README (SKILL.md)
Chinese-Encoding-Handler
描述
中文编码处理工具包，解决 PowerShell 环境下中文文件读写乱码问题。提供自动编码检测、安全文件读写和终端显示修复功能。
触发场景
- 读取中文文件时出现乱码
- 写入中文内容后无法正常显示
- PowerShell 终端中文显示异常
- 需要自动检测文件编码
- 处理包含中文的配置文件或数据文件
使用方法
检测文件编码
.\scripts\encoding-detector.ps1 -Path "C:\path o\file.txt"
输出示例：
文件路径：C:\path o\file.txt
检测编码：UTF-8-BOM
置信度：100%
安全读取中文文件
.\scripts\safe-read.ps1 -Path "C:\path o\file.txt"
带编码参数读取：
.\scripts\safe-read.ps1 -Path "C:\path o\file.txt" -Encoding "UTF-8"
安全写入中文文件
.\scripts\safe-write.ps1 -Path "C:\path o\file.txt" -Content "中文内容"
指定编码写入：
.\scripts\safe-write.ps1 -Path "C:\path o\file.txt" -Content "中文内容" -Encoding "UTF-8-BOM"
修复终端显示
.\scripts erminal-fix.ps1
永久修复（需要管理员权限）：
.\scripts erminal-fix.ps1 -Permanent
技术细节
编码检测原理
-
BOM 检测：优先检查文件开头的字节顺序标记（BOM）
- UTF-8-BOM:
EF BB BF - UTF-16-LE:
FF FE - UTF-16-BE:
FE FF
- UTF-8-BOM:
-
内容分析：无 BOM 时，通过字节分布和常见中文字符编码特征判断
- GBK/GB2312：双字节字符特征
- UTF-8：多字节序列特征
-
置信度评分：根据匹配程度给出 0-100% 置信度
UTF-8-BOM 优势
- ✅ 兼容性好：Windows 程序（记事本、Excel）识别准确
- ✅ 跨平台：Linux/macOS 正常读取
- ✅ 无乱码风险：明确标识编码格式
- ⚠️ 注意：某些 Unix 工具可能不兼容 BOM
兼容性说明
| 系统 | 支持程度 | 备注 |
|---|---|---|
| Windows PowerShell 5.1 | ✅ 完全支持 | 推荐 UTF-8-BOM |
| Windows PowerShell 7+ | ✅ 完全支持 | 默认 UTF-8 |
| Linux/macOS | ✅ 支持 | 建议无 BOM UTF-8 |
| CI/CD 环境 | ✅ 支持 | 需确保终端 UTF-8 |
故障排除
常见问题 Q&A
Q1: 为什么读取文件还是乱码？
- 检查文件编码是否被正确识别
- 尝试手动指定
-Encoding参数 - 使用
encoding-detector.ps1重新检测
Q2: 写入的文件在记事本打开乱码？
- 使用
-Encoding "UTF-8-BOM"参数 - 避免使用纯 UTF-8（无 BOM）
Q3: PowerShell 终端显示中文为方框？
- 运行
terminal-fix.ps1 - 检查终端字体是否支持中文
- 使用
-Permanent参数永久修复
Q4: 批量处理文件时部分失败？
- 检查文件权限
- 确认文件未被其他程序占用
- 查看错误日志定位具体文件
错误代码说明
| 错误码 | 含义 | 解决方案 |
|---|---|---|
| ERR-001 | 文件不存在 | 检查路径是否正确 |
| ERR-002 | 权限不足 | 以管理员身份运行 |
| ERR-003 | 编码检测失败 | 手动指定编码参数 |
| ERR-004 | 文件被占用 | 关闭占用程序后重试 |
| ERR-005 | 终端设置失败 | 检查注册表权限 |
相关资源
Usage Guidance
Do not run any 'terminal fix' or other scripts referenced by this skill until you have the actual script files and have reviewed them yourself. Important points to consider before installing or running anything: 1) The package is documentation and tests only—there are no scripts in scripts/ as the SKILL.md claims. That means an agent or you would need to fetch code from the referenced GitHub repo (or elsewhere) before the skill can work; fetching and executing remote PowerShell without verifying source and integrity is risky. 2) The documented terminal-fix can make permanent changes to your PowerShell profile or system code page and may require administrator privileges—only allow that after inspecting the script and confirming it does only the expected, minimal changes. 3) Ask the publisher for a signed release, a direct install spec (official release URL), or include the .ps1 files in the package; verify file hashes and review the scripts for any network calls, credential exfiltration, or obfuscated logic before running. If the owner supplies the actual scripts and a clear install/release process, re-evaluation could move this to benign; currently the absence of implementation + potential for persistent system modification is why this is suspicious.
Capability Analysis
Type: OpenClaw Skill
Name: chinese-encoding-handler
Version: 1.0.0
The skill bundle describes a PowerShell utility for handling Chinese character encoding but lacks the actual .ps1 source code for the core scripts (encoding-detector.ps1, safe-read.ps1, safe-write.ps1, terminal-fix.ps1), preventing a full security audit. Documentation in README.md and SKILL.md reveals high-risk capabilities, specifically the ability to modify the PowerShell profile ($PROFILE) via the '-Permanent' flag in 'terminal-fix.ps1', which is a common persistence and auto-execution vector. While the stated intent is benign, the combination of arbitrary file I/O and profile modification without visible source code warrants caution.
Capability Assessment
Purpose & Capability
The SKILL.md and multiple delivery/review documents describe four core scripts (encoding-detector.ps1, safe-read.ps1, safe-write.ps1, terminal-fix.ps1) under a scripts/ directory and show test runs, but the provided file manifest contains only docs and test data—no scripts/ directory or .ps1 script files. That means the package does not actually contain the implementation it claims to provide, which is an incoherence between stated purpose and actual contents.
Instruction Scope
Runtime instructions tell the agent (or user) to execute local PowerShell scripts (e.g., .\scripts\terminal-fix.ps1 -Permanent) which read/write files and can alter terminal/profile settings. Those actions can modify system state and may require administrator privileges. The SKILL.md does not include the code, so following its instructions would require obtaining code from an external source (the SKILL.md references a GitHub repo) — this expands the runtime scope beyond the package and grants the agent discretion to fetch/execute external code.
Install Mechanism
No install spec is provided (instruction-only). Low friction normally, but because the package lacks the scripts it documents, an installer or the agent might be expected to fetch code from the referenced GitHub URL. There is no controlled install URL, release artifact, or integrity information in the package, so any ad-hoc fetch would be higher risk.
Credentials
The skill requests no environment variables or credentials, which is appropriate for a local encoding helper. However, its instructions include making permanent terminal/profile changes (writing to $PROFILE, setting code page) and running operations that may require elevated privileges. Those privileged effects are not declared or constrained in metadata, so the package asks implicitly for system-level changes without proportional disclosure or safeguards.
Persistence & Privilege
Metadata does not request 'always: true' and model invocation is allowed (normal), but the documented terminal-fix operation can persist changes to the user profile or system settings when run with -Permanent (and may require admin rights). A package that makes permanent system-level changes should include its scripts and clear provenance; here the scripts are missing, so the only way to perform persistence would be to fetch/execute external code—this combination increases risk.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install chinese-encoding-handler - After installation, invoke the skill by name or use
/chinese-encoding-handler - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Chinese encoding detection, safe read/write, terminal fix
Metadata
Frequently Asked Questions
What is Chinese-Encoding-Handler?
解决PowerShell环境中文文件乱码，支持自动编码检测、安全读写及终端中文显示修复。 It is an AI Agent Skill for Claude Code / OpenClaw, with 95 downloads so far.
How do I install Chinese-Encoding-Handler?
Run "/install chinese-encoding-handler" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Chinese-Encoding-Handler free?
Yes, Chinese-Encoding-Handler is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Chinese-Encoding-Handler support?
Chinese-Encoding-Handler is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Chinese-Encoding-Handler?
It is built and maintained by petersunpingww-droid (@petersunpingww-droid); the current version is v1.0.0.
More Skills