SuperAPI AI 工具集

designcraft-data-merge-badges

设计与创作

查看项目

更新于 11-02 01:06

技能介绍

用途

该技能面向在 DesignCraft 中从 CSV 批量生成可编辑胸牌、会议姓名卡或同版式单记录卡片的场景。适合一个模板、每条记录一页的 90×54 毫米胸牌。输入 CSV 要求唯一且区分大小写的 Name、Role 列,编码为 UTF-8 或 UTF-8 BOM;保留引号内逗号和完整文字,不覆盖 CSV。其他列不进入胸牌。当前执行器支持 1 至 200 条单行字段;既有工程另用副本操作,不运行新图示例覆盖用户文档。

主要能力

  • 读取 CSV 的 Name/Role 字段并批量生成胸牌,逐条预览。
  • 处理长姓名溢出:22pt 溢出时重新预览 18pt、14pt;不能再小,不能截断或自动改名。
  • 使用 preflight.run 检查缺字,document.inspect 检查溢出。
  • 合并后生成新文档,核对实际 records/pages、缺图及溢出。
  • 输出可编辑模板、合并工程、PDF、逐页 PNG 及检查结果。
  • 中文任务通过 fetch_font.py 获取 Noto 字体,获取失败则停止。

使用方式

先读实际方法、原始模板配方、当前命令证据和 GitHub 来源。配方含固定合成数据,实际执行须换成用户授权数据。先审查字段、记录数、输出位置和印刷尺寸。复制字体进任务工程旁 Document Fonts 时保留许可证;本技能不安装系统字体。

中文任务先用字体来源提供的固定摘要获取 Noto 字体。保存空白模板,再重开加载 Document Fonts;之后创建字段。file.new 会重置字体环境,不能加载字体后又新建文档。

data.source.select 真正选择数据源;data.fields 只列字段。Name/Role 分别在空故事中插入 data.placeholder.add,不能把 NAME/ROLE 示例文字留在字段后。

text.select 使用 UTF-8 字节位置,不用字符数。data.preview 的 record 从 1 开始;逐条 story.get 比对完整字段,document.inspect 查溢出,preflight.run 查缺字。

data.preview.stop 恢复原字段,核对故事仍为占位符,再保存可编辑模板。data.merge 生成新文档,核对实际 records/pages、缺图及溢出;不能以模板预览当作完整合并结果。

保存合并工程及 PDF;新进程重开,逐页核对标题、姓名、角色全文和预检,生成每页 PNG 查看。默认不生成多合一拼版或裁切标记,正式印刷另核对交付规范。

可执行入口:英文且内置字体覆盖输入时,使用 python3 <本技能目录>/scripts/build_badges.py --cli <designcraft-cli> --csv <输入.csv> --output-dir <不存在的输出目录>。中文任务先执行 python3 <本技能目录>/scripts/fetch_font.py --directory <任务字体目录>,按返回的 fontFile 调用上述入口并加 --font-file <字体路径>;也可传入有使用权的字体和 --font-family,但仍须真实预检。字体与许可证仅放任务目录。命令用 argv,stdout 为 ASCII 转义 JSON 以保留 Windows 中文路径。

同画面 MCP 场景交给 designcraft-editor 技能,独立安装:npx skills add full-aigc-skills/designcraft-skills --skill designcraft-editor。在同一会话读取 execute/inspect_document/get_story 等实际 schema,逐步绑定真实返回值,再 preview、stop、merge 与保存;原生 $N 或手册 $ref 不能直接传给 MCP。当前内置 Web 运行时可用 LXGW WenKai,经 font.list 和预检确认后,可在退出预览后用 font.replace 将示例字体替换为它,再逐条预览与合并;品牌指定字体不得静默替换。

适用场景

会议胸牌、活动姓名卡、同版式单记录卡片的批量排版与可编辑输出,需按 CSV 记录逐条预览和验证的场合。

限制

  • 当前执行器仅支持 1 至 200 条单行字段。
  • 不能把数据表截图当成排版,不能以模板预览当作完整合并结果。
  • 姓名排版低于 14pt 不可再小,不能截断或自动改名;仍溢出、缺字或其他错误时停止并保留草稿让用户确认。
  • 本技能不安装系统字体,字体与许可证仅放任务目录。
  • 默认不生成多合一拼版或裁切标记,正式印刷需另核对交付规范。
  • 本技能属于开发预发布场景,CLI、Windows 和目标宿主的当前验证状态以配套记录为准。
  • 胸牌是版式内容,不是门禁认证或身份凭证。