pi-encoding-fs
为Pi提供透明支持GB系列编码的文件读写编辑工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-encoding-fs。 它的用途是：为Pi提供透明支持GB系列编码的文件读写编辑工具 完整的 Skill 内容见：https://321skill.com/skills/pi-encoding-fs/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“用pi-encoding-fs读取并显示当前目录下那个GBK编码的config.ini文件内容。” 它会调用该Skill的API，自动识别并正确解码文件内容，以UTF-8格式返回给你，避免乱码。或者你可以说：“将这个JSON对象用GB18030编码保存到data.txt。” 它会帮你处理好编码转换并写入文件。
介绍
该Skill主要解决开发者在处理中文GB18030、GBK、GB2312等编码文件时遇到的乱码和操作困难问题。传统工具在跨平台或处理遗留系统文件时，常因编码不匹配导致内容显示错误或操作失败。
使用方式非常简单，它作为Node.js的fs模块的增强替代品，提供了readFile、writeFile、edit、grep等编码感知的API。开发者只需引入此模块，即可像操作UTF-8文件一样，无缝读写GB系列编码的文件，编码转换在底层自动完成。
它非常适合需要处理中文遗留项目、特定行业软件（如财务、政务）生成的数据文件，或维护使用GBK编码的旧网站的中国开发者。对于经常在不同编码环境间切换的团队，此工具能极大提升协作效率。
建议在项目初期就引入，以统一文件处理逻辑。需要注意的是，它主要针对Node.js环境，虽然能透明处理编码，但在处理极端复杂或损坏的编码文件时，仍建议先备份。对于纯前端浏览器环境或非Node.js的后端运行时，则无法直接使用。
核心特点
核心区别在于提供了对GB18030/GBK/GB2312编码的“透明”支持，无需开发者手动指定或转换编码，直接替代原生`fs`模块进行读写；同时集成了`grep`和`edit`等针对文本的便捷操作，而非仅提供基础的编解码函数。
注意事项
不适合用于处理非文本文件（如图片、视频）或非GB系列/UTF-8编码的文本文件。
常见问题
能处理UTF-8文件吗？
可以，它完全兼容UTF-8，并能自动在GB系列编码与UTF-8间转换。
可以在浏览器里用吗？
不能，这是一个Node.js模块，依赖Node.js的文件系统API。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-encoding-fs/raw/index.md 读取 pi-encoding-fs 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-encoding-fs/raw/index.md（查看排版版本）