SuperAPI AI 工具集

designcraft-cli-setup

编程与开发

查看项目

更新于 11-02 01:06

技能介绍

用途

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,不登录账号,不升级到锁定版本以外的制品。
  • 下载链接可用不等于制品可信,每次须校验归档摘要与二进制摘要;摘要或安装回执不匹配时保留目录供诊断,不静默重装。
  • 安装成功仅证明锁定二进制的本地身份检查,不代表宿主已发现技能、模型路由或创作能力通过,这些需分别验收。
  • 命令查询或零退出码不等于交付通过,仍需检查实际文件、保存重开与内容结果。
  • 执行失败时未知结果不得自动重放写入;同路径输出需先保护已有文件。