微信公众号运营 Skill

# 微信公众号运营 Skill

这是一个微信公众号运营技能，允许你通过自然语言管理微信公众号，包括创建文章草稿、发布文章和分析数据。

## 可用功能

### 1. 草稿管理
- **创建草稿**: 创建新的文章草稿
- **查看草稿列表**: 列出所有草稿
- **查看草稿详情**: 获取特定草稿的详细信息
- **删除草稿**: 删除指定的草稿
- **获取草稿总数**: 查询草稿箱中的草稿总数

### 2. 文章发布
- **发布文章**: 将草稿发布到公众号
- **查看发布状态**: 检查文章发布状态
- **查看已发布文章**: 列出已发布的文章
- **获取文章详情**: 获取已发布文章的详细信息
- **删除已发布文章**: 删除已发布的文章

### 3. 数据分析
- **分析文章数据**: 查看文章的阅读量、分享数等统计数据
- **自定义日期范围分析**: 分析指定日期范围内的数据

### 4. 素材管理
- **上传图片**: 上传图片作为封面或文章素材

## 使用方法

当用户请求执行微信公众号相关操作时，使用Python脚本调用相应的功能。

### 工具路径
Python脚本位于: `/home/user/wechat-operation/src/wechat_operations.py`

### 配置文件
需要配置文件: `/home/user/wechat-operation/config.json`

配置文件格式:
```json
{
  "app_id": "你的微信公众号AppID",
  "app_secret": "你的微信公众号AppSecret"
}
```

## 命令示例

### 草稿管理

#### 创建草稿
```bash
python3 /home/user/wechat-operation/src/wechat_operations.py draft create \
  --title "文章标题" \
  --content "文章内容或文件路径" \
  --author "作者名" \
  --thumb "封面图片素材ID"
```

#### 列出草稿
```bash
python3 /home/user/wechat-operation/src/wechat_operations.py draft list --offset 0 --count 20
```

#### 删除草稿
```bash
python3 /home/user/wechat-operation/src/wechat_operations.py draft delete MEDIA_ID
```

### 发布管理

#### 发布文章
```bash
python3 /home/user/wechat-operation/src/wechat_operations.py publish submit MEDIA_ID
```

#### 查看发布状态
```bash
python3 /home/user/wechat-operation/src/wechat_operations.py publish status PUBLISH_ID
```

#### 列出已发布文章
```bash
python3 /home/user/wechat-operation/src/wechat_operations.py publish list --offset 0 --count 20
```

### 数据分析

#### 分析最近N天的数据
```bash
python3 /home/user/wechat-operation/src/wechat_operations.py analytics --days 7
```

#### 分析指定日期范围
```bash
python3 /home/user/wechat-operation/src/wechat_operations.py analytics \
  --begin 2024-01-01 \
  --end 2024-01-07
```

## 处理用户请求的指南

当用户提出以下类型的请求时，使用此技能：

### 1. 创建和发布文章
**用户**: "帮我写一篇关于XX的公众号文章并发布"
**处理步骤**:
1. 根据用户需求生成文章内容
2. 使用 `draft create` 创建草稿
3. 获取返回的 media_id
4. 使用 `publish submit` 发布文章
5. 向用户报告发布状态

### 2. 管理草稿
**用户**: "查看我的草稿列表" 或 "删除某个草稿"
**处理步骤**:
1. 使用 `draft list` 查看草稿
2. 根据需要使用 `draft delete` 删除草稿

### 3. 数据分析
**用户**: "分析一下我最近的文章表现" 或 "看看上周文章的阅读量"
**处理步骤**:
1. 使用 `analytics` 命令获取数据
2. 解析返回的JSON数据
3. 用易读的方式向用户展示关键指标（阅读量、分享数等）

## 注意事项

1. **首次使用**: 确保用户已经配置了 `config.json` 文件
2. **素材ID**: 创建文章时如果需要封面图，需要先上传图片获取 thumb_media_id
3. **内容格式**: 文章内容支持HTML格式
4. **API限制**: 注意微信API的调用频率限制
5. **日期范围**: 数据统计API有日期范围限制（如阅读数据最大3天）

## 错误处理

当API返回错误时，检查返回的 `errcode` 和 `errmsg` 字段，向用户提供清晰的错误说明。

常见错误码:
- `40001`: access_token 过期或无效
- `40007`: 非法的 media_id
- `45009`: 接口调用超过限制
- `47001`: POST 数据格式错误
- `85064`: 找不到草稿

## API文档参考

基于微信公众号官方API:
- 草稿箱管理: https://developers.weixin.qq.com/doc/offiaccount/Draft_Box/Add_draft.html
- 发布能力: https://developers.weixin.qq.com/doc/offiaccount/Publish/Publish.html
- 数据统计: https://developers.weixin.qq.com/doc/offiaccount/Analytics/Analytics_API.html