designcraft-data-merge-badges
Installation
SKILL.md
CSV批量胸牌
适合一个模板、每条记录一页的90×54毫米胸牌。原生坐标用点,毫米乘72/25.4。输入CSV要求唯一且区分大小写的Name、Role列,UTF-8或UTF-8 BOM;保留引号内逗号和完整文字,不覆盖CSV。其他列不进入胸牌。当前执行器支持1至200条单行字段,既有工程另用副本操作,不运行新图示例覆盖用户文档。
先读实际方法、原始模板配方、当前命令证据和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查缺字。
- 姓名22pt溢出时重新预览18pt、14pt;不能再小,不能截断或自动改名。仍溢出、缺字或其他错误时停止,保留草稿让用户确认重新排版。
- 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,但仍须真实预检。字体与许可证仅放任务目录,不依赖技能兄弟目录或全局安装。