SuperAPI AI 工具集

designcraft-cli-export

设计与创作

查看项目

更新于 11-02 01:06

技能介绍

用途

designcraft-cli-export 用于将已存在且可打开的 DesignCraft 工程导出为用户指定格式与位置的文件,支持 PDF、图片、IDML 与 EPUB。工程的新建或整体修订应交给 designcraft-use,工程的重新打开与保存应交给 designcraft-cli-document。

主要能力

技能通过固定摘要制品安装的原生 CLI 执行导出。首次使用时,将 SKILL_DIR 设置为宿主实际加载的本 SKILL.md 所在绝对目录;在用户已授权必要依赖的情况下,公开的 cli.py 会自动校验并安装固定原生版本到用户数据目录,不使用 sudo,不修改 PATH。可用 --runtime-home 或环境变量 CRAFT_RUNTIME_HOME 指定隔离运行时目录(放在 -- 之前),用 --archive 指向已有固定 ZIP,仍会校验归档与二进制摘要。

查询命令示例:

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

导出示例(素材路径与输出位置须替换为当前任务实际授权路径):

python3 -I -B "$SKILL_DIR/scripts/cli.py" -- run --in /absolute/path/input.designcraft --export /absolute/path/output.pdf

使用方式

工作流分为五步:核对源工程(路径、摘要、页面数、目标格式、是否需要另存工作副本);从固定 CLI 的真实命令目录查询支持的导出操作与参数;确认输出范围(目标路径、文件类型、覆盖授权、预期页数/尺寸、需保留内容);执行并核验文件(存在、摘要、格式、页数/尺寸,失败或 UNKNOWN 时读取回执,不自动重放);说明损失并审阅(检查关键文本、链接素材与视觉结果,分别记录实测损失与未验证项)。

交付物包括原生 .designcraft 工程、收集素材与字体许可清单、逐页预览及适用的 PDF/IDML/EPUB。重新打开原生工程核对页数、文字和链接素材;交换格式损失单独记录。结构化产物清单字段、重开核验记录和状态含义见 references/artifact-manifest.md,可用 scripts/artifact_manifest.py 校验;NOT_RUN 表示只核对了产物身份,不能作为重开通过证据。单独核对导出文件结构可用 scripts/format_probe.py --file <绝对路径>,其覆盖范围与 PASS/PARTIAL 边界见 references/format-checks.md,探针结果不是视觉、内容、可编辑性、损失或原生支持验收。逐页预览审阅见 references/page-review.md,仅在工程重开通过后使用 scripts/page_review.py 校验记录。局部修订与修订后导出身份重验见 references/revision-evidence.md 及 scripts/revision_evidence.py。

适用场景

适用于用户已提供可打开的 DesignCraft 工程,并明确要求输出 PDF、图片、IDML 或 EPUB 的情况。执行前必须阅读本技能的执行与验收细节。

限制与注意事项

当前为候选实现,尚未完成实际宿主、原生安装与创作验收,仅支持 macOS arm64、Python 3.11+。不把研究源码或本地开发分支支持的格式推定为固定 CLI 支持,以真实目录为准。不覆盖既有输出,除非用户授权;失败后先检查是否已有有效文件。以当前用户权限读写源工程和目标目录。导出格式转换可能丢失编辑能力或语义。导出成功不证明源工程保存或重开通过;一个格式成功不证明其他格式可用;零退出不证明文件完整;图片预览尺寸不是文档页数;内部 PDF/X 检查不等于外部认证。旧导出记录可能过期,输入变化后需重新验证。执行失败先核对工程与输出,未知结果不重放写入,同路径输出需先保护已有文件。原生安装、宿主技能发现与模型自然语言选用是分别验收的门禁。