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

filmcraft-harness

设计与创作

查看项目

更新于 11-03 22:31

技能介绍

FilmCraft Harness 是 FilmCraft 技能套件的唯一执行实现。首次安装、原生命令会话、原生剪辑工作流、桌面会话与任务级会话都收敛在本目录 scripts/ 内。filmcraft-use、filmcraft-cli 及各领域技能是薄文档技能，只提供场景指引、计划示例与参考契约，实际执行一律经由本技能的入口。

用途与定位：执行任何 FilmCraft 命令前，先把 HARNESS_DIR 设为本 SKILL.md 所在目录（宿主实际加载的绝对路径），不要假设当前工作目录就是技能目录。用户级安装可能位于 ~/.agents/skills/filmcraft-harness，项目级可能位于 .agents/skills/filmcraft-harness，插件可能位于其 skills/filmcraft-harness 或宿主缓存目录，以宿主实际加载路径为准。

主要能力（六个入口）：

  1. scripts/bootstrap.py：首次使用安装器，下载校验锁定 FilmCraft 制品，返回 JSON executable；版本与摘要以 scripts/runtime.lock.json 为准。
  2. scripts/cli.py：原生转发 CLI，安装校验后直连锁定可执行文件（--version、commands --json、describe 等）；工程读取与编辑须在 -- 前提供独立根参数。
  3. scripts/commands.py：原生命令入口，支持 list / describe / check / run 执行 craft-command-plan/v1 计划，输出恒为 JSON。
  4. scripts/workflow.py：原生剪辑计划执行器，从已有素材制作带字幕短片，自动安装、收集、保存重开、导出与解码检查。
  5. scripts/desktop.py：固定桌面安装入口，校验签名应用身份并登记本地 bridge；启动与 GUI 编辑验收单独记录。
  6. scripts/task_session.py：任务级 JSONL 会话入口，启动一次所属编辑器，逐计划检查、保存和返工；任务结束才退出。

使用方式：领域技能（filmcraft-use 等）提供场景指引与计划示例，执行路径一律换成本目录 HARNESS_DIR/scripts/。公开 workflow.py 与 commands.py run 必须显式提供 --read-root READ_DIRECTORY --write-root WRITE_DIRECTORY（可重复）；根须为已存在的规范真实目录，来自用户／宿主授权。安装范围是用户数据目录，不需要 sudo。资料给出了 bootstrap.py 的调用命令，以及 cli.py --version、commands.py list --filter、commands.py describe COMMAND_ID 的原生命令直连与命令目录查询示例，还给出 workflow.py 的 --plan、--output、--read-root、--write-root、--runtime-home 参数调用示例；任务级会话与桌面安装分别见 task_session.py --help 与 desktop.py --help。

权限与边界：权限边界由 scripts/execution_permissions.py 强制，原生子进程运行在 macOS 系统沙箱内。具体任务先读取本技能任务模板，按对应输入、首次任务、失败边界、局部修订和核验执行。

与领域技能的关系：filmcraft-use 提供完整任务路由与交付合同，执行仍走本 harness；filmcraft-cli 与各场景技能（setup/project/media/timeline/audio/subtitles/color/motion/export/multicam/transcript）提供场景知识与参数契约，执行仍走本 harness；领域技能文档中的 SKILL_DIR 指领域技能自身目录（用于读取其 examples/、references/），脚本执行路径一律换成本目录 HARNESS_DIR/scripts/。执行合同（命令目录、参数契约与技能路由）见各领域技能 references/command-usage.md 与 command-reference.md；本技能 references/ 内保存执行契约快照（command-coverage.json、native-command-snapshot.json）。

适用场景：需要首次安装 FilmCraft、直连原生命令、按计划执行剪辑工作流、进行桌面安装或任务级连续会话的场合。限制：须先正确设置 HARNESS_DIR；公开 workflow 与 commands run 需显式提供已授权的读写根目录；原生子进程受 macOS 系统沙箱与权限脚本约束。资料未提供具体收费、价格、支持的平台范围（除提及 macOS 沙箱）及效果信息。