用途:VectorCraft Harness 是 VectorCraft 技能套件的唯一执行实现。vectorcraft-use、vectorcraft-cli 及各领域技能为薄文档技能,只提供场景指引、计划示例与参考契约,实际执行一律经本技能入口。
主要能力与入口:scripts/bootstrap.py 首次使用安装器,仅用标准库安装锁定的官方 CLI(runtime.lock.json 固定版本与摘要),返回 JSON executable;scripts/cli.py 公开 CLI 通道,按 argv 调用固定二进制;scripts/commands.py 原生命令入口,支持 list / describe / run;scripts/workflow.py 原生矢量操作助手,独立会话、限定读写目录、不可变修订交付、多画板导出与定向改色;scripts/desktop.py 桌面桥接,按固定官方 DMG 安装桌面应用并执行桌面计划。其余 scripts/ 文件为内部依赖,不单独调用。
使用方式:执行前先把 HARNESS_DIR 设为本 SKILL.md 所在目录的绝对路径,不能假设当前工作目录。用户级可能位于 ~/.agents/skills/vectorcraft-harness,项目级可能位于 .agents/skills/vectorcraft-harness,插件可能在 skills/vectorcraft-harness 或宿主缓存目录,以宿主实际加载路径为准。首次安装(无预装 CLI,安装至用户数据目录,不需要 sudo):python3 -I -B "$HARNESS_DIR/scripts/bootstrap.py",返回 JSON executable 后作为 argv 首个元素。原生命令示例:python3 -I -B "$HARNESS_DIR/scripts/cli.py" -- --version;python3 -I -B "$HARNESS_DIR/scripts/commands.py" list --filter QUERY;describe COMMAND_ID。使用 MCP 时显式选择 mcp --headless。
适用场景与限制:当前锁定平台为 macOS arm64,未支持平台返回 unsupported_platform,不应安装其他平台制品。安装位置默认 ~/.local/share/craft-runtimes,可用 --runtime-home 或 CRAFT_RUNTIME_HOME 指定;--archive 接受已下载的锁定 ZIP,但不跳过摘要检查。交付前需重开工程核对画板与导出范围;只读检查无需安装运行时。目录覆盖与直接原生使用不等于所有指令、GUI、交付或 Art 编排均已完成验收。