让飞书可以发图片消息

- 📝 **图文混排** - 图片配文字，丰富消息内容
- 🎯 **多场景支持** - 单聊、群聊均可
- 🔧 **简单易用** - 一行命令完成图片发送

## 解决的问题 / Problem Solved

飞书开放平台官方只提供底层 API：
- 需要先调用 `im/v1/images` 上传图片获取 `image_key`
- 再调用 `im/v1/messages` 发送消息，拼接复杂的富文本 JSON

**本 Skill 帮你封装好整个流程**，只需一行命令即可发送图片。

## 使用场景 / Use Cases

- 📊 **每日简报** - 早报自动配图发送到群聊
- 🚨 **监控报警** - 系统异常截图自动推送
- 📈 **报表推送** - 定时发送数据可视化图表
- 🤖 **机器人消息** - 智能助手发送图片回复

## 安装 / Installation

```bash
# 从 ClawHub 安装
clawhub install feishu-image-messaging

# 或本地安装
clawhub install ./feishu-image-messaging.skill
```

## 配置 / Configuration

设置环境变量：

```bash
export FEISHU_APP_ID="cli_xxxxxx"
export FEISHU_APP_SECRET="xxxxxx"
```

> 💡 获取方式：飞书开放平台 → 开发者后台 → 创建应用 → 查看凭证

## 使用方法 / Usage

### 快速发送（推荐）

```bash
# 发送本地图片
./scripts/send_image.sh -r "ou_xxx" -i "/path/to/image.jpg"

# 发送远程图片 + 配文
./scripts/send_image.sh -r "oc_xxx" -i "https://example.com/img.png" -t "每日数据报表"
```

参数说明：
- `-r`: 接收者 ID（open_id / user_id / chat_id）
- `-i`: 图片路径（本地文件）或 URL（远程图片）
- `-t`: 可选， accompanying text

### 分步调用（高级）

```bash
# 1. 获取 token
TOKEN=$(./scripts/get_token.sh)

# 2. 上传图片
IMAGE_KEY=$(./scripts/upload_image.sh -f "image.jpg" -t "$TOKEN")

# 3. 发送消息
./scripts/send_message.sh -r "ou_xxx" -k "$IMAGE_KEY" -t "Hello" -a "$TOKEN"
```

## API 文档 / API Reference

详见 `references/api.md`：
- 图片上传 API
- 图片下载 API
- 消息发送 API
- 认证 API

## 文件结构 / File Structure

```
feishu-image-messaging/
├── SKILL.md              # 本文件
├── scripts/
│   ├── config.sh         # 配置（从环境变量读取）
│   ├── get_token.sh      # 获取 access token
│   ├── upload_image.sh   # 上传图片
│   ├── send_message.sh   # 发送消息
│   └── send_image.sh     # 一键发送（整合以上）
└── references/
    └── api.md            # API 文档
```

## 技术栈 / Tech Stack

- Shell / Bash
- curl（HTTP 请求）
- jq（JSON 处理）
- 飞书开放平台 API

## 注意事项 / Notes

- ⚠️ 请妥善保管 `FEISHU_APP_ID` 和 `FEISHU_APP_SECRET`，不要提交到代码仓库
- 🔄 Access token 有效期为 2 小时，脚本会自动处理获取
- 📤 图片上传后获得的 `image_key` 有效期为 1 年
- 🎯 `image_key` 可以重复使用，建议缓存以减少上传次数

## 问题排查 / Troubleshooting

| 错误码 | 含义 | 解决 |
|--------|------|------|
| `99992402` | 缺少必填字段 | 检查 `receive_id_type` 参数 |
| `230001` | 消息内容格式错误 | 检查 JSON 格式和转义 |
| `11200` | Access token 无效 | 重新获取 token |

## 更新日志 / Changelog

### v1.0.0 (2025-03-11)
- ✨ 初始版本
- 📤 支持本地图片上传
- 🌐 支持远程图片 URL
- 📝 支持图文混排
- 🎯 支持单聊和群聊

## 作者 / Author

Created by OpenClaw AI Assistant for Hivemoon Inc.

## 许可证 / License

MIT License

---

**Enjoy sending images with Feishu! 🚀**