SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场filmcraft-cli-media

filmcraft-cli-media

设计与创作

查看项目

更新于 10-16 10:18

技能介绍

用途

FilmCraft 素材检查与导入技能负责检查已有音视频、图片和素材引用，导入并收集或重关联素材。该技能与同包技能按名称交接，单独安装即可使用，不读取兄弟目录。技能调用固定发布的 filmcraft-cli，并保留原生编辑工程。

主要能力

  • 检查已有音视频、图片与素材引用。
  • 导入、收集或重关联素材。
  • 提供首次安装与公开 CLI 入口。
  • 提供 workflow.py、commands.py 等命令入口，支持查询、描述与运行命令。
  • 支持原生组合与源工程修订的工作流操作。

使用方式

首次使用需将 SKILL_DIR 设置为宿主实际加载的本 SKILL.md 所在目录（绝对路径），不按当前工作目录猜测。技能目录与 CLI 的用户数据安装目录是两个独立位置。

安装与入口示例：

: "${SKILL_DIR:?请先设置为本 SKILL.md 的实际所在目录}"
python3 -I -B "$SKILL_DIR/scripts/bootstrap.py"
python3 -I -B "$SKILL_DIR/scripts/cli.py" -- --version
python3 -I -B "$SKILL_DIR/scripts/cli.py" -- commands --json

CLI argv 在 -- 后，原生子命令必须放首位。安装参数放分隔符前；--runtime-home 可隔离缓存。锁定制品摘要失败、损坏安装或不支持平台时停止；不改 PATH、不执行浮动升级。原生帮助入口是 help；launcher 自身 --help 只说明启动参数。

完整命令入口需显式提供读取根与写入根：

: "${READ_ROOT:?Set READ_ROOT to an existing independently authorized directory}"
: "${RUNTIME_HOME:?Set RUNTIME_HOME to an existing independently authorized directory}"
: "${SKILL_DIR:?Set SKILL_DIR to an existing independently authorized directory}"
: "${WRITE_ROOT:?Set WRITE_ROOT to an existing independently authorized directory}"
python3 -I -B "$SKILL_DIR/scripts/commands.py" list --filter QUERY
python3 -I -B "$SKILL_DIR/scripts/commands.py" describe COMMAND_ID
python3 -I -B "$SKILL_DIR/scripts/commands.py" run "$SKILL_DIR/examples/commands-advanced.json" --output /absolute/new-command-result --runtime-home "$RUNTIME_HOME" --read-root "$SKILL_DIR" --read-root "$READ_ROOT" --write-root "$WRITE_ROOT" --write-root "$RUNTIME_HOME"

describe <id> 核对参数，再用 exec <id> <JSON> 或 run <JSONL>；写命令必须同批次保存或配合 --save-as。probe 用于核对流、帧率和音轨；移动素材后按摘要重新链接，不能凭同名替换。

权限与边界

公开 workflow.py 和 commands.py run 必须显式提供 --read-root READ_DIRECTORY --write-root WRITE_DIRECTORY（可重复）；根须为已存在的规范真实目录，来自用户或宿主授权，不能从计划或素材元数据推导。计划、素材及源交付须位于读取根，交付及其父目录须位于写入根。--runtime-home 是安装维护目录，须位于独立明确授权的写入根；编辑原生进程始终禁止修改该缓存、技能、登记输入和源工程。

当前根隔离执行支持 macOS headless；桌面入口须同时隔离本次拥有的签名应用和 MCP 客户端，只开放分配的 loopback 控制端口。无法确认隔离的外部 bridge 明确拒绝。低层 Python 测试 API 不是公开授权入口。

旧 cli.py 原生转发的工程读取与编辑也需要在 -- 前提供独立根参数；仅精确版本/帮助/无工程目录查询兼容旧调用。模型下载须单独使用 --model-maintenance。

输入与交付

输入为用户已确认的任务、素材、工程或对象、输出目录与修改范围；需要现有工程时先核对摘要。返回实际 CLI 结果、保存后的原生工程、需要的派生输出与核验记录。安装成功、命令目录存在与创作任务完成分别报告。

场景操作

核对本场景输入、原生工程、目标对象、版本和输出边界。按场景指南选择当前命令，保存独立检查点后执行；完成后重开原生工程并检查实际输出与非目标内容。

原生组合与源工程修订使用本技能自带 scripts/workflow.py；读取工作流合同，模板在本技能 examples 内。只修改授权对象，原生工程和依赖素材保留。

核验与恢复

命令非零退出不算完成；需要查看真实保存工程、导出、尺寸及媒体解码。超时结果标 unknown，先检查原任务/工程，不能自动重放编辑。现有原生工作流支持另存修订；对应项目摘要不符时拒绝覆盖。

按需参考与交接

安装/诊断需要时交给 filmcraft-cli-setup，完整任务路由交给 filmcraft-use；缺少技能时使用 npx skills add full-aigc-skills/filmcraft-skills --skill <skill-name>。不通过相邻文件路径加载其他技能。

本技能不提供虚构的登录接口；本地 headless 不要求云账户。完整 GUI、跨编辑器保真与创作质量按实际证据陈述。工作区分段素材消费候选见分段素材。固定发布及 Art 集成仍待验收，不能把候选交接当作完整五插件交付。

环境与限制

当前支持 macOS arm64、Python 3.11+；固定 CLI 安装到用户数据目录。连续操作优先使用本技能自带的任务级会话：启动一次，逐计划检查、保存和返工，共享同一 FilmCraft 实例；任务结束才退出。单次 run 仍保持原兼容行为。GUI 任务可先使用本技能自带的固定桌面安装；安装、启动与实际 GUI 编辑分别核验。