Signus 字体签名

面向用户的语言

• 除非用户明确要求使用其他语言，否则所有面向用户的文本一律使用英文编写。

运行时依赖

• Node.js 18 或更高版本。
• 首次运行前，请在本 skill 目录下安装依赖：

cd /home/node/.openclaw/workspace/skills/signus-font-signature && npm install

输入参数

请提供且仅提供以下一种身份信息来源：

• name（例如："Allon Mason"），或
• firstName + lastName，或
• initials（例如："AM"）

可选参数：

• count —— 返回图片的最大数量。

校验规则

• 仅接受一种身份信息来源。
• 拒绝空值或仅包含空白字符的输入。
• 若提供了 count，则将其视为数值型上限。

执行命令

node /home/node/.openclaw/workspace/skills/signus-font-signature/scripts/generate_font_signatures.js ''

示例：

node /home/node/.openclaw/workspace/skills/signus-font-signature/scripts/generate_font_signatures.js '{"name":"Allon Mason","count":10}'

node /home/node/.openclaw/workspace/skills/signus-font-signature/scripts/generate_font_signatures.js '{"firstName":"Allon","lastName":"Mason"}'

详细执行流程

1. 解析输入载荷（payload），并将身份信息标准化为 name 字段。
2. 创建输出目录：
   • ~/.openclaw/media/signatures-font/-/
3. 向固定可信主机（https://api.signus.ai）发起字体签名生成请求，按如下顺序尝试接口：
   • 主用接口：POST /api/signus/v0/signature-generations/font
   • 备用接口：POST /api/signus/v0/users/me/signature-generations/font
4. 根据响应的 Content-Type 类型分别处理：
   • 若为 ZIP 或 octet-stream：使用进程内 JS 解压库（adm-zip）解压，并提取其中的图像文件；
   • 若为 JSON：读取 payload.thisPageItems[] 数组，然后依次下载每张图片，地址格式为：
     • /api/signus/v0/signature-generations/font/{generationId}/signatures/{generatedSignatureId}/{clean|watermark}.png
5. 返回结果包含：
   • count
   • directory
   • signatures[]: { id, filePath }
6. 通过 message action=send 指令将图像发送至聊天界面，参数为 media=。

认证模型

• 本 skill 不处理 API token 或基于环境变量的凭据。
• 默认假设主公开接口可在不提供显式 Authorization 请求头的情况下直接调用。
• 备用路径 /users/me/... 可能仅在存在隐式会话/认证上下文的环境中可用。
• 若您的部署需强制启用显式认证，请先更新脚本设计（默认不得将密钥注入请求载荷中）。

安全说明

• 不读取任何环境变量。
• 不执行任何 Shell 命令。
• 网络请求目标固定为 https://api.signus.ai。
• 仅向 ~/.openclaw/media/signatures-font/ 目录下写入文件。
• 请确保本 skill 与 signus-signature（基于 AI WebSocket 的手写签名）严格分离。