ZFONT-CLI

从 zfont.cn 智能搜索、推荐并下载免费商用字体，支持递归解压字体包提取 TTF、OTF、TTC 格式文件并提供安装或传输方案。

name: zfont-agent-cli version: 1.5.3 description: > 全自动免费商用字体获取技能。 用到的系统命令有：wget 是需要下载字体，unzip 是需要解压字体（也可以不选择解压） 字体来自ZFONT.CN（免费商用字体）

补充缺失的底层依赖声明，解决注册元数据报错问题

required_binaries:

• wget
• unzip
• cp
• bash

triggers:

• "下载字体"
• "免费商用字体"
• "找字体"

actions:

动作 1：带智能路由的表格化搜索

search_fonts: description: "搜索字体。若存在精确匹配则直达下载；否则输出 Markdown 表格。" parameters: keyword: type: string required: true execution: type: http_request method: POST url: "https://zfont.cn/tools/openclaw/search/" headers: Accept: "application/json" Content-Type: "application/json" body: s: "{{keyword}}" response_handling: instruction: > 保持简约，禁止使用任何表情符号。 获取返回的 JSON 后，按以下逻辑分支执行：

    分支 A（唯一结果确认）：
    若无完全一致匹配，且 `data.total` 为 1（或列表中仅有 1 个结果）：
    1. 输出：“**找到 1 个相关字体。**”
    2. 严格使用 Markdown 表格格式输出该字体：
       | 字体名称 | PostScript | 简介 |
       |---|---|---|
       | `name` | `postscript` | 基于 `excerpt` 的极简概括（限一句话） |
    3. 警告：绝对隐藏字体 ID。
    4. 提问：“是否**下载**该字体？(回复 **是** / **否**)”

    分支 B（模糊搜索列表）：
    若无完全一致匹配，且结果大于 1 个：
    1. 输出：“**找到 `data.total` 个相关字体。**”
    2. 挑选 2-4 个最佳匹配输出表格：
       | 字体名称 | PostScript | 简介 |
       |---|---|---|
       | `name` | `postscript` | 基于 `excerpt` 的极简概括（限一句话） |
    3. 警告：绝对隐藏字体 ID。
    4. 提问：“你要下载**第几个**？或回复**字体名称**。”

动作 2：获取直链

get_font_download_url: description: "获取直链，获取后立即触发下载动作。" parameters: font_id: type: integer required: true execution: type: http_request method: POST url: "https://zfont.cn/tools/openclaw/down/" headers: Accept: "application/json" Content-Type: "application/json" body: name: "Agent" id: "{{font_id}}" response_handling: instruction: > 解析到 data.url 后，立刻静默调用 download_font_archive。不与用户对话。

动作 3：下载字体

download_font_archive: description: "执行 wget 下载，成功后提供文件获取方式。" parameters: download_url: type: string required: true font_name: type: string required: true execution: type: shell_command command: > bash -c ' URL="{{download_url}}"; if [[ "$URL" != https://files.zfont.cn/* ]]; then echo "FAIL_DOMAIN"; exit 1; fi; FILE_NAME=$(echo "{{font_name}}" | tr " " "_"); wget -q -O "/tmp/${FILE_NAME}.zip" "$URL"; if [ $? -eq 0 ]; then echo "SUCCESS:/tmp/${FILE_NAME}.zip"; else echo "FAIL_WGET"; fi' response_handling: instruction: > 严禁使用表情符号。 1. 如果输出包含 FAIL，输出：“下载失败！ 请前往 ZFONT.CN 官网下载。”并结束对话。 2. 如果输出包含 SUCCESS，记住文件路径，并严格输出以下提问：

    **字体已下载完成**
    ---
    请选择后续操作：
    - **1. 发送文件给你(压缩包)**
    - **2. 发送文件给你(字体文件)**

动作 4：解压或直接返回

process_font_asset: description: "根据用户选项，解压提取或直接返回压缩包。" parameters: zip_path: type: string required: true font_name: type: string required: true user_choice: type: string description: "枚举值：'extract'(提取文件) 或 'zip'(原包)" required: true execution: type: shell_command command: > bash -c ' CHOICE="{{user_choice}}" ZIP_PATH="{{zip_path}}" EXTRACT_DIR="/tmp/extracted_$(echo "{{font_name}}" | tr " " "_")"

    if [ "$CHOICE" = "zip" ]; then
      echo "RESULT_FILE:$ZIP_PATH"
      exit 0
    fi

    mkdir -p "$EXTRACT_DIR"
    unzip -q -j -o "$ZIP_PATH" -d "$EXTRACT_DIR" > /dev/null 2>&1

    if [ "$CHOICE" = "extract" ]; then
      echo "RESULT_DIR:$EXTRACT_DIR"
      exit 0
    fi
    '

response_handling:
  instruction: >
    解析 stdout 输出：
    1. 如果包含 `RESULT_FILE` 或 `RESULT_DIR`，提取对应路径，并静默调用 `send_font_to_user` 动作。

动作 5：发送文件

send_font_to_user: description: "下发文件，并根据文件类型提供极简指引。" parameters: target_path: type: string required: true execution: type: natural_language_generation response_handling: instruction: > 1. 调用框架接口下发 {{target_path}} 里的文件。 2. 绝对不要复述字体的介绍信息。 3. 检查 {{target_path}} 的文件类型，严格按照以下对应的格式输出：

    如果下发的是压缩包（包含 .zip）：
    **文件已发送**
    ---
    解压指南：
    - **Windows**
      右击文件 -> 提取到当前文件夹
    - **macOS**
      双击压缩包文件
    - **Linux**
      终端执行 unzip 文件名.zip

    如果下发的是字体文件：
    **文件已发送**
    ---
    安装指南：
    - **Windows**
      双击字体文件 -> 点击"安装"
    - **macOS**
      右击字体文件 -> "打开方式" -> "字体册"
    - **Linux**
      cp *.ttf ~/.local/share/fonts/ && fc-cache -fv
    ```