lightcraft-cli 是 Lightcraft 技能集合中的公共执行契约技能,定位为 CLI 命令查询与调用的统一入口,而非替代具体领域技能做出照片修改决策。
用途:当用户显式要求查询 Lightcraft 命令与控件、检查 JSON 计划,或直接调用 Lightcraft CLI 时使用本技能。它提供目录、能力身份、计划结构和执行回执等公共约定,供上层技能或用户按统一格式进行查询与执行。
主要能力:固定 CLI 版本为 0.2.1,运行环境要求 Python 3.11+。平台支持方面,macOS arm64/x86_64、Linux aarch64/x86_64、Windows x64/x86 已通过固定 CLI 原生 CI;Windows x86 指 64 位主机上的 32 位进程。宿主、视觉与移动设备需单独验收。技能脚本可独立使用,不猜测开发者路径。
使用方式:先将 SKILL_DIR 设为宿主实际加载本 SKILL.md 的绝对目录,然后执行 python3 -I -B "$SKILL_DIR/scripts/bootstrap.py" --no-install 进行环境检查,到此结束。查询或执行可能触发缺失运行时的固定安装,仅在已有相应授权时使用。执行前按需阅读公共运行契约,领域步骤见操作与验收。执行时需先确定原片、持久照片库、目标照片、用户修改范围及输出根,并复用已核实的安装和已有阶段。
输出与恢复:交接时需提供照片 ID/库位置、原片身份、当前设置、版本化执行回执和实际输出。编辑、保存、解码、重开、视觉分别验收;零退出只表示待验证。UNKNOWN 不重放;部分成功保留已生效步骤;NotSaved 区分内存修改与未落盘。已知导出冲突在执行前拒绝,摘要检测不提供回滚或通用沙箱。
适用场景:需要查询 Lightcraft CLI 命令与控件、检查 JSON 计划、直接调用 CLI,或在多技能协作中作为公共执行契约入口时使用。全流程操作应使用 lightcraft-use 技能。安装命令为 npx skills add full-aigc-skills/lightcraft-skills --skill lightcraft-use。跨技能交接按名称和安装命令进行,不读取兄弟目录。
限制:本技能不决定照片修改内容;不提供回滚或通用沙箱;UNKNOWN 状态不重放;环境检查脚本仅做检查,安装需已有授权;宿主、视觉与移动设备支持暂未提供详细验收说明。