SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场artcraft-cli-setup

artcraft-cli-setup

部署与运维

查看项目

更新于 10-15 16:53

技能介绍

用途

ArtCraft CLI 安装诊断技能负责首次安装、摘要校验、版本检查与缺失运行时排障。与同包技能按名称交接，单独安装即可使用，不读取兄弟目录。使用本项目的本地编排 CLI；上游 ArtCraft 是 Tauri 应用，不安装或冒充同名官方 CLI。

主要能力

  • 首次安装与公开 CLI 入口。
  • 摘要校验、版本检查与缺失运行时排障。
  • 基础入口安装固定 Node 与编排包。
  • workflow.py 按任务图安装所需领域技能源和原生 CLI，不要求全局 Node。
  • 安装成功、命令目录存在与创作任务完成分别报告。

使用方式

执行实现收敛在内置的 artcraft-harness 技能（随插件捆绑安装；单独安装用 npx skills add full-aigc-skills/artcraft-skills --skill artcraft-harness）。将 HARNESS_DIR 设置为该技能实际加载目录（绝对路径）；本技能的 SKILL_DIR 只用于读取自身的 examples/ 与 references/，脚本执行路径一律使用 $HARNESS_DIR/scripts/。

将 SKILL_DIR 设置为宿主实际加载的本 SKILL.md 所在目录（绝对路径）。用户级安装可能位于 ~/.agents/skills/artcraft-cli-setup，项目级可能位于 .agents/skills/artcraft-cli-setup，插件可能位于其 skills/artcraft-cli-setup 或宿主缓存目录；以实际加载路径为准，不按当前工作目录猜测，也不搜索后随意选择重复版本。技能目录与 CLI 的用户数据安装目录是两个独立位置。

命令示例：

: "${SKILL_DIR:?请先设置为本 SKILL.md 的实际所在目录}" python3 -I -B "$HARNESS_DIR/scripts/bootstrap.py" --runtime-only python3 -I -B "$HARNESS_DIR/scripts/cli.py" -- --version python3 -I -B "$HARNESS_DIR/scripts/cli.py" -- --help

CLI argv 在 -- 后，原生子命令必须放首位。安装参数放分隔符前；--runtime-home 可隔离缓存。锁定制品摘要失败、损坏安装或不支持平台时停止；不改 PATH、不执行浮动升级。原生帮助入口是 --help；launcher 自身 --help 只说明启动参数。

场景操作：先读取系统/架构、Python 版本及用户已有授权；按上述 --runtime-only 运行本技能 bootstrap.py；手动预装已选领域可显式使用 --plugin，省略选择参数是完整安装兼容入口，不是每个项目的必要步骤。核对 JSON 回执中的可执行路径、摘要与版本；不依赖 shell PATH。重复调用复用固定安装，失败停止并记录具体错误。

本项目 --help 定义 run/status/cancel/package/verify-package；语义计划走 workflow.py，不能将上游 Tauri 的账号/供应商方法当编排 CLI 命令。

不修改 PATH、不使用 sudo；版本损坏保留并报错，不自动升级。

原生组合与源工程修订使用 artcraft-harness 技能的 scripts/workflow.py；读取工作流合同，模板在本技能 examples 内。只修改授权对象，原生工程和依赖素材保留，派生格式损失读取交换报告。

适用场景

  • 首次安装 ArtCraft CLI 与运行时。
  • 摘要校验、版本检查。
  • 缺失运行时排障。
  • 安装失败时读取首次使用诊断，按回执定位当前技能自身的 setup 入口；安装失败与原生调用失败分别处理。
  • 需要模板之外的原生操作时，读取本技能完整领域命令组件，使用自带 domain_commands.py 查询 2646 条命令、实际 MCP 参数及交接选定领域。

限制

  • 当前支持 macOS arm64、Python 3.11+。
  • 不修改 PATH、不使用 sudo；版本损坏保留并报错，不自动升级。
  • 锁定制品摘要失败、损坏安装或不支持平台时停止。
  • 命令非零退出不算完成；需要查看真实保存工程、导出、尺寸及媒体解码。
  • 超时结果标 unknown，先检查原任务/工程，不能自动重放编辑。
  • 本技能不提供虚构的登录接口；本地 headless 不要求云账户。
  • 遇到 runtime_upgrade_busy 时，保留旧运行时、原工程和账本，不删除租约或强行修改状态。
  • 模式目录候选的分类、参数差异与拒绝边界见模式目录使用；Vector desktop／bridge 重复命令尚未完成执行资格，不能按 headless 目录回退。
  • 完整 GUI、跨编辑器保真与创作质量按实际证据陈述。