pi-fff-non-ascii-guard

介绍

这个Skill主要解决一个特定但棘手的问题：当使用fff-core这类文件操作工具时，如果遇到包含非ASCII字符（如中文、日文、特殊符号）的文件名，可能会因UTF-8字节边界错误而导致程序意外崩溃（panic）。它通过在文件处理流程前介入，主动识别这些“问题文件名”，并将其重命名为安全的ASCII格式，从而确保后续流程的稳定运行。

使用方式非常直接。在您的Pi Agent环境中安装此扩展后，它会在fff-core处理文件之前自动运行。您无需手动干预，扩展会扫描目标目录，将检测到的非ASCII文件名（例如“测试文档.txt”）重命名为兼容的格式（如“ce_shi_wen_dang.txt”或使用其他编码规则），从而为fff-core铺平道路。

它非常适合那些工作流严重依赖fff-core进行文件批量操作（如复制、移动、批量重命名），但又经常需要处理国际化、多语言文件名的开发者、系统管理员或内容管理者。尤其是在团队协作或处理来自不同地区、系统的文件时，此Skill能有效避免因文件名编码问题导致的整个脚本或任务中断。

使用建议方面，请注意此Skill是作为fff-core的前置“守卫”而设计，并非一个通用的文件重命名工具。其主要目标是保证兼容性而非保留原意，重命名后的文件名可能失去可读性。因此，如果您的后续流程极度依赖原始文件名的语义，可能需要评估影响。同时，建议在重要操作前进行测试，并了解其重命名规则。