feishu-sticker

Feishu Sticker Skill 是一款专为飞书（Lark）生态设计的图片自动化发送工具，旨在将本地图片以原生贴纸形式发送至指定用户或群组。其核心用法围绕命令行接口展开，用户可通过 --target 指定接收方（支持用户ID或群组ID），配合 --file 发送特定图片，或使用 --query/--emotion 基于关键词或情绪标签智能搜索贴纸目录。Skill 会自动处理图片上传至飞书 CDN 的流程，通过 MD5 哈希缓存 image_key 避免重复上传，并对超过 5MB 的图片及 GIF 文件进行自动压缩和 WebP 格式转换，显著提升传输效率。

该 Skill 的显著优点在于其完善的自动化能力与工程健壮性。首先，智能缓存机制有效减少了 API 调用次数和网络带宽消耗；其次，集成 ffmpeg-static 实现的 GIF 转 WebP 功能在保证视觉效果的同时优化了文件体积；再者，代码层面实施了严格的安全检查，包括文件路径解析验证（防止目录遍历攻击）和敏感操作的环境变量隔离。此外，依赖版本已完全锁定（package-lock.json），且所有网络请求均限定于飞书官方 API 端点，确保了运行的稳定性与可预期性。

然而，该 Skill 也存在一定局限性。其功能强依赖于飞书开放平台生态，用户必须预先配置 FEISHU_APP_ID 和 FEISHU_SECRET 环境变量并具备相应的 API 权限，配置门槛较高。同时，由于使用 spawnSync 调用外部 ffmpeg 进程进行格式转换，在极端情况下可能受限于系统进程调度或二进制文件兼容性（尽管已使用静态链接版本）。此外，所有上传的图片将永久存储于飞书 CDN，对于高度敏感或机密内容的分享存在固有的隐私风险。

该工具特别适合以下群体：需要在飞书群组中频繁分享自定义表情包的内容运营团队、构建内部娱乐或通知机器人的开发者、以及希望通过自动化脚本提升内部沟通趣味性的办公自动化爱好者。对于已深度使用飞书作为协作平台、且具备基础 Node.js 环境配置能力的技术团队而言，此 Skill 能显著简化贴纸管理流程。

使用风险方面，除上述提及的图片上传至第三方 CDN 的隐私考量外，用户需注意定期清理本地缓存文件（memory/feishu_image_keys.json）以防索引膨胀。虽然代码中已实现完善的错误处理和重试机制（最多3次），但在网络不稳定或飞书 API 限流时仍可能出现发送失败。建议在生产环境使用前，充分测试贴纸目录的权限配置及 ffmpeg 转换流程在目标系统上的兼容性。