designcraft-cli-layout 是一个用于版面与文字框局部操作的技能,主要面向需要查询版面参数并执行排版命令的场景。
用途方面,该技能处理用户明确提出的版面查询与局部操作,包括文字框、图像框、文字串联、素材放置和溢出检查。当用户只要求查看或局部修改现有版面对象时使用;整稿目标、文件保存与重新打开、交付格式导出分别交由 designcraft-use、designcraft-cli-document、designcraft-cli-export 处理。
主要能力方面,技能支持查询版面对象与命令参数,执行最小范围的布局修改,并在修改后检查目标对象、文字流、溢出、裁切、素材链接及受影响页面。执行布局命令前需确认对象、工作副本和修改范围;查询可先用离线目录,写操作必须使用真实原生目录。失败后保留已完成修改并检查受影响页面,不盲目重放。
使用方式方面,首次使用需将 SKILL_DIR 设置为宿主实际加载的 SKILL.md 所在绝对目录,并可通过 cli.py 自动校验并安装固定原生版本。示例命令为:python3 -I -B "$SKILL_DIR/scripts/cli.py" -- commands;仅检查安装时可运行 python3 -I -B "$SKILL_DIR/scripts/bootstrap.py" 与 python3 -I -B "$SKILL_DIR/scripts/cli.py" -- --version。可用 --runtime-home 或 CRAFT_RUNTIME_HOME 指定隔离运行时目录,放在 -- 之前;--archive 指向已有固定 ZIP。安装失败返回 dependencySetup,不自动重试编辑或渲染。
适用场景包括:查询文字框、图像框参数;执行局部版面修改;处理文字串联与素材放置;检查溢出与受影响页面。交付时需重新打开原生工程核对页数、文字和链接素材,并记录交换格式损失。
限制方面,该技能仅支持 macOS arm64 与 Python 3.11+,且为候选实现,尚未完成实际宿主、原生安装与创作验收。不负责超出明确页面或对象范围的全稿重排;不猜测对象 ID、命令参数、溢出状态或跨会话引用。脚本以当前用户权限访问工程与登记素材,摘要检查不提供沙箱或自动回滚。新建工作副本和任何对象写入都须满足用户的路径与范围授权。命令查询或零退出不等于交付通过,需检查实际文件、保存重开与修改结果。