背景 / Background

ArtCraft 是 storytelling 创作软件系列（VectorCraft 矢量绘图、PhotoCraft 图像编辑等），均采用各自的项目文件格式且上游未公开独立的格式文档。本插件面向 QuickLook 用户，填补这两个格式在 Windows 文件管理器中"空格即览"的空缺。

当前仅支持 VectorCraft（.vectorcraft）与 PhotoCraft（.pcraft） 两个格式的预览。如需支持 ArtCraft 系列其他软件的格式（或其他小众格式），欢迎在 Issues 中提出需求。

功能 / Features

• 内嵌预览快路径（纯 C#）：.vectorcraft v1–v4 信封（gzip / v4 blob 尾部 / drawcraft 兼容）、.pcraft 白名单预览（full → preview → thumb）
• CLI 高保真渲染兜底：配置 vectorcraft-cli / photocraft-cli 后，内嵌图缺失或分辨率不足时按 maxRenderSize（默认 512px）实时渲染
• 对抗性安全设计：有界解压、JSON 扫描预算、blob 越界校验、ZIP CRC/加密/ZIP64 检查、路径白名单、渲染子进程超时 Kill——坏文件不拖垮宿主
• 已在 QuickLook v4.5.0 实机通过 14 项对抗评测与 35 项格式探针回归

注意：内嵌预览取决于保存选项 / Embedded preview depends on save options

• VectorCraft：保存时须在 "VectorCraft Options" 对话框勾选 "Preview" 才会内嵌 256px 预览；未勾选的文件无内嵌预览（不影响正常编辑）。
• PhotoCraft：项目包默认携带高分辨率合成图，无需额外操作。
• 没有内嵌预览的文件：配置 CLI 后可直接实时渲染（见 README），无需重新保存。

安装 / Install

保持 QuickLook 正在运行 → 下载下方 QuickLook.Plugin.CraftViewer.qlplugin → 资源管理器中选中按空格 → 点击 Install → 重启 QuickLook。

可选：将 vectorcraft-cli / photocraft-cli 路径写入插件目录的 cli-config.json 以启用高保真渲染（详见 README）。

许可 / License

GPL-3.0（随附 QuickLook.Common，与 QuickLook 一致）