用途
designcraft-cli-setup 用于 DesignCraft 固定原生 CLI 的首次安装、安装状态检查和安装失败排查。它不承担普通排版编辑任务,也不负责查询原生命令;这两类请求分别交给 designcraft-use 与 designcraft-cli。
主要能力
- 记录目标平台(macOS 架构)、Python 版本和隔离的 runtime-home 目录。
- 进行只读检查:查看锁文件、目标目录与已安装身份,核对摘要、版本和安装回执。
- 在取得本次网络下载与文件写入的明确授权后,从锁定 URL 获取固定制品,校验归档与二进制摘要并安装。
- 安装失败时保留日志和已有文件,按错误分类报告,不自动重试写入,也不覆盖无法核验的旧文件或异常目录。
- 分层验证:核对安装回执、版本输出与命令发现记录,并单独标记插件发现、模型路由和创作验收状态。
使用方式
将 SKILL_DIR 设置为宿主实际加载的本 SKILL.md 所在绝对目录。技能可独立安装到项目 .agents/skills、用户技能目录或插件缓存,不猜测兄弟目录,不修改技能文件。
查询命令:
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,仍会校验归档与二进制摘要。
相关技能安装命令:
npx skills add full-aigc-skills/designcraft-skills --skill designcraft-use
npx skills add full-aigc-skills/designcraft-skills --skill designcraft-cli
适用场景
- 用户明确要求检查 DesignCraft 固定 CLI 是否已安装。
- 首次安装该运行时。
- 排查固定 CLI 安装失败,需要保留现场供人工核对。
限制与安全边界
- 当前仅支持 macOS arm64 与 Python 3.11+;平台不符时不尝试兼容安装。
- 资料说明其为候选实现,尚未完成实际宿主、原生安装与创作验收。
- 安装会联网获取固定制品并写入用户选择的 runtime-home,必须先取得覆盖该操作的授权;只读检查不等于安装许可;普通排版目标不被解释为下载运行时的授权。
- 不使用 sudo,不修改 PATH,不登录账号,不升级到锁定版本以外的制品。
- 下载链接可用不等于制品可信,每次须校验归档摘要与二进制摘要;摘要或安装回执不匹配时保留目录供诊断,不静默重装。
- 安装成功仅证明锁定二进制的本地身份检查,不代表宿主已发现技能、模型路由或创作能力通过,这些需分别验收。
- 命令查询或零退出码不等于交付通过,仍需检查实际文件、保存重开与内容结果。
- 执行失败时未知结果不得自动重放写入;同路径输出需先保护已有文件。