压缩包体检·ZIP目录预览·损坏校验·重名路径检查
用户说“压缩包打不开、先看看里面是什么”时,确认当前AI的文件与Python能力后执行只读检查。用户不需要学习命令;AI读取报告解释具体结果。可先运行虚构示例。
python "{baseDir}/scripts/zip_check.py" "{baseDir}/examples/示例资料.zip" --out "新的压缩包检查目录"
python "{baseDir}/scripts/zip_check.py" "{baseDir}/examples/示例资料.zip" --check-crc --out "新的压缩包校验目录"
默认仅看目录,不读文件内容。--check-crc才在内存中流式解压并核对可读条目的CRC,不写出条目。包上限200MB、10000条目;声明展开总量200MB、单项100MB以内才执行CRC。加密条目和不支持的压缩算法标未核验,不尝试密码;超限不强行展开。目录列出绝对路径、跳转、Windows特殊名称、符号链接、忽略大小写后的重名及文件/目录父路径冲突。
状态需按report.json解释:crc_passed只代表所列可读文件通过CRC;inspection_incomplete仍有未核验;issues_found有路径/目录风险或CRC错误;empty_zip为空包;not_readable_zip只证明当前不能按完整ZIP读取,不能凭单一报错断定损坏、缺卷或伪后缀的具体原因。CRC不证明未缺文件、无病毒、来源可信或可安全执行。
首版不支持RAR/7Z或分卷重组,不自动解压、不打开包内程序、不联网。原文件不变,输出目录须不存在;报告含文件名,留在本机,不随技能包公开真实清单。
SkillHub 渠道示例说明
本渠道不接收DOCX、XLSX或ZIP附件,因此改附透明的Python标准库示例生成器,不联网、不读取用户文件。首次试样例先运行:
python "{baseDir}/examples/make_examples.py" --out "新的样例目录"
随后将上述命令中的原examples路径改为新样例目录,或直接提供用户指定的文件/模板。生成器仅创建合成样例,不能把样例检查结果当用户文件检查结果。核心功能脚本与完整渠道包相同。