ZFONT-CLI
从 zfont.cn 智能搜索、推荐并下载免费商用字体，支持递归解压字体包提取 TTF、OTF、TTC 格式文件并提供安装或传输方案。
Like a lobster shell, security has layers — review code before you run it.
License
SKILL.md
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
```
Files
1 totalComments
Loading comments…