安全加固全解jianying-editor-skill 的路径穿越防护与工程自修复机制【免费下载链接】jianying-editor-skillSkill for Agent automating JianYing (CapCut Chinese version) video editing.项目地址: https://gitcode.com/gh_mirrors/ji/jianying-editor-skilljianying-editor-skill 是一款面向 AI Agent 的剪映CapCut 国内版自动化剪辑技能支持素材导入、字幕生成、录屏变焦与工程导出。在自动操作本地文件时路径穿越防护和工程自修复是它最容易被忽略、却最关键的两项安全能力——本文带你用 5 分钟看懂这套机制如何保护你的草稿目录以及为什么它让新手也能放心使用自动化剪辑工具。为什么自动化剪辑工具需要安全加固自动化剪辑的本质是 AI 帮你读写本地的草稿文件夹draft_info.json等文件。这里天然存在两类风险️路径穿越Path Traversal如果项目名里藏着../../之类的逃逸符恶意或失误的代码可能删掉草稿根目录之外的文件损坏工程剪映版本升级如 v5.9 的draft_info.json架构或程序中断可能导致草稿缺少关键 JSON 文件工程打不开。jianying-editor-skill 在 v1.5.0 就专门做了一轮安全加固见 CHANGELOG.mdsanitized draft project names and blocked path traversal/out-out-of-root delete净化项目名、拦截越界删除added cloud download URL/header/size guards云端下载 URL 防护路径穿越防护三道安全闸门核心实现都在 scripts/core/project_base.py 中形成了改名 → 拼路径 → 删除前再校验的三重防线。闸门一项目名净化Sanitization_sanitize_project_name方法会清洗用户传入的项目名scripts/core/project_base.py#L199-L208把:/\|?*和所有控制字符替换成下划线——堵住反斜杠、斜杠等路径分隔符循环移除所有..——这正是路径穿越的元凶净化后为空直接报错避免隐形的非法名称。被改名时还会打印警告例如[warn] project_name sanitized: .. - __方便你第一时间发现异常输入。闸门二安全路径拼接_safe_join_root所有草稿路径都必须经过_safe_join_rootscripts/core/project_base.py#L210-L214先用os.path.abspathnormpath把路径彻底规范化再用os.path.commonpath验证结果仍在草稿根目录之内否则直接抛出Unsafe path detected错误。即使前面净化漏网这里也逃不出去。闸门三越界删除拦截_safe_remove_dir自修复时确实需要删除损坏的草稿文件夹但_safe_remove_dirscripts/core/project_base.py#L216-L222设了两道保险拒绝直接删除草稿根目录本身拒绝删除根目录之外的任何路径Refuse to remove path outside root。简单说只允许在栅栏内施工且绝不允许拆掉栅栏。这套守卫还有配套保障环境自举 scripts/utils/skill_path.py先读JY_SKILL_ROOT环境变量再依次探测.agent/.trae/.claude等技能目录全部路径都做了abspath规范化找不到时列出已尝试路径给出清晰报错单测覆盖安全守卫有专门单元测试tests/test_wrapper.py仓库自检tools/check_repo_hygiene.py 防止运行时产物被误提交从源头保持仓库干净。工程自修复overwriteTrue 一键救活损坏草稿当草稿被判定为损坏缺少draft_info.json/draft_content.json或draft_meta_info.json时JyProject的行为取决于overwrite参数scripts/core/project_base.py#L52-L81场景overwriteTrue默认overwriteFalse检测到损坏草稿自动清理损坏文件夹并重建提示Use overwriteTrue to auto-fix保持只读加载失败强制重建工程尝试降级重建allow_replaceTrue剪映占用文件自动切换剪映回主界面释放锁最多重试 3 次同左并给出手动操作提示注意这里的删除走的正是上面的_safe_remove_dir——自修复本身就运行在路径穿越防护的保护伞下两个机制是配套的。 新手用法初始化工程时直接写JyProject(我的视频, overwriteTrue)即可完整示例见 SKILL.md 的快速开始小节和 examples/my_first_vlog.py。动手验证用 API Validator 体检你的环境想确认自己环境里的防护与修复链路都正常吗项目内置了环境诊断工具python SKILL_ROOT/scripts/api_validator.py它会真实创建一个诊断工程、导入素材、写入文本并保存走通创建 → 写入 → 保存全链路支持--strict严格模式输出机器可读结果scripts/api_validator.py。总结安全不是口号而是可验证的工程️路径穿越防护项目名净化 根内路径校验 越界删除拦截三重闸门配合单测与仓库卫生检查工程自修复overwriteTrue自动清理损坏草稿并重建锁冲突自动释放重试可验证性api_validator.py让你随时对安全链路做回归体检。对普通用户来说这意味着即使 AI 自动化替你操作本地文件你的草稿目录也只会在栅栏内被施工——放心自动化安全有兜底。 更多资料安全政策见 SECURITY.md完整 API 文档见 docs/api.md。【免费下载链接】jianying-editor-skillSkill for Agent automating JianYing (CapCut Chinese version) video editing.项目地址: https://gitcode.com/gh_mirrors/ji/jianying-editor-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
