用途:将多个项目文件整理为单一可移植的 .zip“上下文包”,供人工评审或代理读取,常用于代码评审、红队/安全审查与项目交接。
主要能力:通过 JSON 清单(file-manifest.json)指定要打包的文件路径与说明字段;支持目录路径,脚本会递归展开目录内所有可读内容;打包时自动在 ZIP 根目录注入 _manifest_notes.md 文档,列出包内内容说明。
使用方式:先编写 file-manifest.json,包含 title、description 以及 files 数组(每项含 path 和 note);然后执行 python3 "scripts/bundle_zip.py" --manifest "../../file-manifest.json" --bundle "output_bundle.zip"。依赖安装可按需执行 pip-compile ./requirements.in 与 pip install -r ./requirements.txt。
限制与注意:若清单中某文件不存在或读取权限出错,不应中止整个归档,而应在 _manifest_notes.md 中明确标注未包含该文件(例如 🔴 NOT INCLUDED),并继续打包其余有效文件;应始终填写 note 字段,因为它是接收方通过 _manifest_notes.md 获取的唯一上下文;避免把下游无法解析的二进制或媒体资源一并打包,也不要静默排除文件。
资料未提供该技能的收费、平台支持、性能指标或版本更新时间等信息。