feishu_fabu/FEISHU_SETUP.md

# 飞书机器人配置指南

## 📋 当前状态

| 项目 | 状态 |
|------|------|
| WordPress 发布脚本 | ✅ 已部署并测试通过 |
| 飞书机器人脚本 | ✅ 已部署并测试通过 |
| Webhook 服务器 | ✅ 已启动并运行在 8080 端口 |
| 飞书开放平台配置 | ⏳ 待配置 |

## 🌐 飞书开放平台配置步骤

### 步骤 1：登录飞书开放平台

1. 打开 [飞书开放平台](https://open.feishu.cn/)
2. 使用您的飞书账号登录
3. 进入您的应用管理页面

### 步骤 2：获取应用凭证

1. 在应用管理页面，点击 **凭证与基础信息**
2. 记录以下信息：
   - **App ID**（如：`cli_a1b2c3d4e5f6`）
   - **App Secret**（如：`aBcDeFgHiJkLmNoPqRsTuVwXyZ`）

### 步骤 3：配置事件订阅

1. 进入 **事件与回调** 页面
2. 选择 **长连接** 方式（推荐，无需公网 IP）
3. 点击 **添加事件**
4. 搜索并添加以下事件：
   - `im.message.receive_v1`（接收消息）

### 步骤 4：配置权限

1. 进入 **权限管理** 页面
2. 搜索并开通以下权限：
   - `im:message:send_as_bot`（以机器人身份发送消息）
   - `im:message:receive`（接收消息）
   - `im:chat:readonly`（获取群信息）
   - `contact:user.base:readonly`（获取用户信息）

### 步骤 5：配置 Webhook URL

如果您使用 **Webhook** 方式（需要公网 IP 或域名）：

1. 在 **事件与回调** 页面
2. 选择 **Webhook** 方式
3. 填写请求地址：
   ```
   http://您的服务器 IP:8080/webhook
   ```
4. 点击 **保存**

### 步骤 6：更新配置文件

编辑 `/www/wwwroot/wp-publish/feishu_config.py`：

```python
# 飞书应用凭证
FEISHU_APP_ID = 'cli_您的AppID'
FEISHU_APP_SECRET = '您的AppSecret'
```

### 步骤 7：重启服务

```bash
systemctl restart wp-publish
```

### 步骤 8：发布应用版本

1. 在应用管理页面
2. 点击 **创建版本**
3. 填写版本号和更新说明
4. 提交审核（内部应用通常自动通过）

## 📝 使用说明

### 发布文字文章

直接发送文字内容：
```
这是一篇测试文章
```

### 发布带指令的文章

使用指令格式：
```
#标题 AI 发展趋势
#分类 ai
人工智能正在改变世界...
```

### 发布 Word 文档

发送 `.docx` 格式的 Word 文档

### 查看帮助

发送 `#帮助` 查看完整使用说明

## 🔧 故障排除

### 检查服务状态

```bash
systemctl status wp-publish
```

### 查看日志

```bash
tail -f /www/wwwroot/wp-publish/logs/feishu_bot.log
tail -f /www/wwwroot/wp-publish/logs/webhook_server.log
```

### 测试发布功能

```bash
cd /www/wwwroot/wp-publish
python3 feishu_bot.py
```

## 📞 技术支持

如有问题，请查看日志文件获取详细错误信息。