核心用法
zfont-agent-cli 是一款面向设计师与开发者的字体获取自动化工具,通过调用 ZFONT.CN 官方开放接口实现全链路闭环:
1. 智能搜索:输入关键词后,系统自动判断精确/模糊匹配,返回 Markdown 表格结果,隐藏敏感 ID 字段。
2. 直链获取:选定字体后静默调用 /down/ 接口获取 CDN 直链,跳过浏览器跳转。
3. 安全下载:内置域名白名单校验(files.zfont.cn),使用 wget 下载至 /tmp 目录。
4. 灵活交付:支持「原压缩包」或「提取后字体文件」两种模式,自动匹配 Windows/macOS/Linux 三平台安装指引。
显著优点
- 零成本商用:接入 ZFONT.CN 全量免费商用字体库,免除版权风险。
- 流程自动化:从搜索到交付 5 步闭环,无需人工干预跳转或解压。
- 跨平台友好:终端输出适配 Windows CMD/PowerShell、macOS Terminal、Linux Shell。
- 安全校验:下载前强制校验域名,防止劫持或恶意文件注入。
潜在缺点与局限性
- 依赖网络稳定性:ZFONT.CN 服务可用性直接影响功能;无本地缓存机制。
- 临时文件风险:默认写入
/tmp,多用户环境可能存在权限或残留问题。 - 无字体预览:仅返回文字简介,无法即时查看字形效果。
- 平台锁定:直链域名白名单硬编码,若 CDN 变更需手动更新技能。
适合人群
- 需要快速获取免费商用字体的 UI/UX 设计师、前端开发者。
- 批量部署字体环境的运维人员。
- 对版权敏感但不愿遍历官网下载流程的效率型用户。
常规风险
- 供应链风险:ZFONT.CN 若停止服务或变更 API,技能将失效。
- 临时文件泄露:
/tmp目录在部分系统为全局可读,敏感项目建议配合umask或私有目录使用。 - 未验证字体完整性:无 SHA256 校验,极端情况下存在 CDN 投毒可能(虽概率极低)。