用途
该技能用于对已有的 Dramagic 3.0 角色清单与美术素材进行校验与打包,或配合客户端转换脚本处理遗留 2.0 清单。发布的归档容器为 ZIP,但文件后缀是 .dramagic-character-pack。发布包只包含 manifest.json 及其引用的静态 WebP 文件。
主要能力
- 读取同级的 dramagic-character-pack/references/format.md 与其中的 JSON Schema。
- 按随附 Schema 校验必填字段,并对照提供的语音目录检查语音字段。
- 检查每个角色所需的六项资源是否存在,允许 identity 复用 neutral,但不要因两个清单字段引用同一文件而重复字节。
- 从本技能包根目录运行 tools/package.mjs,传入源目录与新的输出路径;它只复制被引用的媒体,拒绝不安全的路径、重复键和链接,并调用 ZIP 实现选择 store/deflate。它不会执行包内文件或下载媒体。
- 运行权威原生校验器:在客户端检出目录中执行 cargo run --manifest-path src-tauri/Cargo.toml --example validate_character_pack -- PACKAGE;检出目录之外需使用另行提供的兼容校验器,技能包不含预构建二进制。若不可用,须标注结果为未验证,不能称为可导入。
使用方式
- 获取稳定的作者 ID、包 ID 和三段式数字发布版本号;不要虚构官方身份或复用他人命名空间。同名不同内容属于更新,而非新的可信来源。
- 按 Schema 校验字段并核对语音目录。JSON Schema 本身无法检测重复键、解码 WebP、强制 UTF-8 字节预算或证明安全性。
- 确认每个角色的六项必需资源存在,并单独应用美术技能的手动检查清单。
- 运行 tools/package.mjs 生成新输出路径的包。
- 用原生校验器校验成品归档,交付包、校验结果和单独的视觉检查报告。报告、提示词、源截图与工作流文件应放在归档之外。未获用户请求并完成权利/权限检查前不得上传或发布。
遗留输入
客户端导入器只接受 3.0 用户包。客户端检出目录中的作者转换脚本 scripts/convert-character-pack-v2.ts 需要参数 SOURCE OUTPUT AUTHOR_ID PACK_ID VERSION,仅投影清单数据并丢弃旧的根/音频字段,不是完整包转换器。需收集被引用的 WebP 文件,执行同样的打包与校验,并保留原始源目录。
限制与失败处理
若校验器拒绝发布,应报告具体失败并修复生产者/引用,不得禁用校验、改扩展名掩盖损坏文件或添加伪造缺失图片来强行通过。