功能概览
zfont-agent-cli 是一款全自动免费商用字体获取工具，深度集成 ZFONT.CN 字体库资源，通过五阶段流水线（搜索→获取直链→下载→处理→交付）实现零摩擦字体获取体验。
核心用法
| 触发方式 | 说明 |
|---------|------|
| "下载字体" / "找字体" / "免费商用字体" | 启动搜索流程 |
| 回复字体名称或序号 | 确认下载目标 |
| 选择压缩包/字体文件 | 决定交付格式 |
典型交互流程：
1. 用户触发关键词 → 系统调用 search_fonts 检索字体
2. 精确匹配时直达下载确认，模糊匹配时展示 Markdown 表格供选择
3. 确认后链式调用 get_font_download_url → download_font_archive → process_font_asset → send_font_to_user
4. 最终交付文件并附赠平台专属安装指南
显著优点
- 合规保障：所有字体来自 ZFONT.CN 明确标注的免费商用库，规避版权风险
- 智能路由：精确/模糊双分支搜索，减少用户决策负担
- 安全沙箱：下载环节强制校验
https://files.zfont.cn/*域名白名单，阻断恶意跳转 - 全平台覆盖：终端内置 Windows/macOS/Linux 安装命令，即收即用
- 零配置依赖：仅需系统预装的 wget/unzip/cp/bash，无额外运行时
潜在局限
| 问题 | 说明 |
|-----|------|
| 单源依赖 | 完全依赖 ZFONT.CN 服务可用性，若主站故障则功能瘫痪 |
| 无本地缓存 | 每次搜索均请求远端 API，弱网环境体验下降 |
| 字体元信息缺失 | 不显示授权协议全文（SIL/OFL 等），需用户自行核实商用范围 |
| 临时文件风险 | 下载至 `/tmp/` 目录，多用户环境存在残留文件泄漏可能 |
适合人群
- UI/UX 设计师：快速验证字体视觉方案
- 前端开发者：一键获取 Webfont 资源
- 自媒体创作者：解决封面/配图字体授权焦虑
- 中小企业：零成本建立合规字体资产库
常规风险提示
1. 授权边界：ZFONT.CN 标注"免费商用"不代表全球司法管辖区通用，出口业务需二次核实
2. 文件完整性：wget 静默下载可能因网络中断产生截断文件，建议手动校验哈希
3. 解压安全：unzip -j -o 强制覆盖且不保留目录结构，恶意压缩包可能释放危险文件至单一目录
4. 隐私暴露：搜索关键词明文传输至第三方 API，敏感项目需脱敏处理