SuperAPI AI 工具集

designcraft-scenario-playbooks

设计与创作

查看项目

更新于 11-02 01:06

技能介绍

用途与定位

DesignCraft 排版场景技能用于指导在 DesignCraft 环境中完成一组具体排版任务,包括活动海报排版、简报串接、双页说明、活表格、品牌文案修订、溢出修复、出血审阅稿和交互阅读链接。技能从 8 条具体流程中选择任务,由 recipes.json 提供有序参数,并用命令证据与来源记录实际方法和工作流参考。资料中的文案、页面及示例数据均为原创演示,不执行 InDesign JSX。

主要能力与使用方式

使用前先确认单位和范围:运行 designcraft-cli --version 及 commands;CLI 不随本技能安装,缺失时应按官方发行说明选择系统版本并遵守安装授权。本文的原生命令与插件 Web 桥可能不同,实际宿主应先读 schema。可用 font.list 检查本次使用字体;示例采用运行时自带的 Source Serif 4 / Source Sans 3,不默认要求安装商业字体。

坐标、字号、出血均以点为单位,1 毫米 = 72/25.4 点。rect 顺序为 [左, 上, 右, 下],不是 [x, y, 宽, 高]。frame.create.spread 从 0 开始,图中位置是跨页坐标;file.exportPdf.pages 按 1 开始的页面位置,两者不能混用。text.select.anchor/focus 是 UTF-8 字节,不能把中文字符数直接当偏移。

在编辑器就绪后,用同一个 MCP 服务的 execute 逐步调用,具体封装以 tools/list 为准。先创建文本框,保存真实返回的 id/story,再传给后续方法;用 inspect_document、get_story 和 render_page 核对结构与页面。独立 CLI 的文件操作不能证明内嵌编辑器已同步。

手册中的 capture 为返回值命名,{"$ref":"title.story"} 必须绑定实际值,不能原样发给 CLI/MCP。CLI 原生支持 $N.story 等引用,可用编译脚本生成:python write_script.py --recipes recipes.json --scene event-poster --output steps.json,两个输入路径需换成本技能实际路径。随后执行 designcraft-cli script steps.json --save new.designcraft --export review.pdf --export exchange.idml。编译脚本只重排引用,不执行排版,所有业务仍由原生 CLI 完成。

已有文档编译时加 --existing,再执行 script steps.json --in input.designcraft --save new.designcraft。该模式跳过 newDocumentOnly 并重排引用,但仍须先调整本次位置、页数、故事和样式冲突,不能把完整新文档示例原样塞入已有版面;不要手工只删 file.new 而保留旧 $N 编号。MCP 直接使用实际返回值;只有 CLI 脚本的引用解析器会解释 $N。

结果检查与限制

每次输出应采用未占用的新路径,因为原生 CLI 不会防止覆盖。保留可编辑 .designcraft 和需要的 IDML、PDF。重开后查询 document.inspect、story.get、table.get;检查预检 issues,不靠退出码或文件头宣称完整交付。溢出修复应先证明确有 overset,再检查修复后消失且内容未删;字体、行距、图片和分页变化后需重新检查。

模板中的 assertions 只适用于示例输入。应逐页查看实际 PDF,核对阅读顺序、数据、换行和对象覆盖。出血与 PDF 导出成功不代表 CMYK、PDF/X、印厂或无障碍验收。交互 PDF 含注释也不代表目标网站可用,示例 URL 必须替换。此外,遇到先规划阅读顺序再排页、长文按故事流排版、把印前发现转成待处理项时,可读取商店工作流适配并使用对应 Craft 方法和实际结果检查;上游技能不作为运行依赖。将 SVG 导入原生版式、交付可编辑 PPTX、使用 Flex 模块排版或跨文档加载样式时,需先读 main 新增工作流与版本边界,不能把目录数量当作实际验收。