qwenpaw-skills
87 lines
2.8 KiB
Markdown
87 lines
2.8 KiB
Markdown
---
|
||
name: emlog
|
||
description: 发布文章到 emlog 博客。当用户提到「发文章」「发布到博客」「blog」「emlog」「article_post」「微语笔记」等时使用。基于 emlog REST API，支持文章发布、文章列表、分类查询、草稿管理、微语笔记等功能。
|
||
---
|
||
|
||
# emlog 博客发布 Skill
|
||
|
||
通过 emlog REST API 与博客系统交互，支持发布文章、查询文章、获取分类、管理草稿、发布微语等。
|
||
|
||
## 前置条件
|
||
|
||
- 博客需开启 API 功能（后台：系统-设置-API 设置）
|
||
- 需要 API 秘钥（后台可查看）
|
||
|
||
## 环境变量
|
||
|
||
| 变量 | 说明 | 默认值 |
|
||
|------|------|--------|
|
||
| `EMLOG_BASE_URL` | 博客站点地址，如 `https://blog.apescale.com` | `https://blog.apescale.com` |
|
||
| `EMLOG_API_KEY` | API 秘钥（后台系统-设置-API 设置） | 无 |
|
||
|
||
## 使用方式
|
||
|
||
```bash
|
||
# 发布文章（推荐：内容较长时用文件传参）
|
||
python3 scripts/emlog.py post \
|
||
--title "文章标题" \
|
||
--content-file /tmp/article.md \
|
||
--sort-id 14 \
|
||
--tags "QwenPaw,TencentDB"
|
||
|
||
# 发布文章（内容较短时直接传）
|
||
python3 scripts/emlog.py post --title "标题" --content "正文内容" --sort-id 14
|
||
|
||
# 获取分类列表
|
||
python3 scripts/emlog.py sorts
|
||
|
||
# 文章列表（可按分类过滤）
|
||
python3 scripts/emlog.py list --sort-id 14 --count 10
|
||
|
||
# 文章详情
|
||
python3 scripts/emlog.py detail --id 123
|
||
|
||
# 草稿列表
|
||
python3 scripts/emlog.py drafts
|
||
|
||
# 发布微语笔记
|
||
python3 scripts/emlog.py note --text "这是一条微语"
|
||
```
|
||
|
||
## 鉴权方式
|
||
|
||
脚本默认使用**免签名鉴权**（传 `api_key` 参数），简单可靠，建议配合 HTTPS 使用。
|
||
如需签名鉴权，可传 `--sign` 参数（自动计算 `md5(req_time + api_key)`）。
|
||
|
||
## 发布参数说明（article_post）
|
||
|
||
| 参数 | 必填 | 说明 |
|
||
|------|------|------|
|
||
| `title` | ✅ | 标题 |
|
||
| `content` | ✅ | 内容（支持 Markdown，emlog 会保存 raw 原文） |
|
||
| `excerpt` | ⬜ | 摘要 |
|
||
| `sort_id` | ⬜ | 分类 ID（`emlog.py sorts` 可查） |
|
||
| `tags` | ⬜ | 标签，半角逗号分隔 |
|
||
| `draft` | ⬜ | `y` 存草稿 / `n` 发布（默认 `n`） |
|
||
| `post_date` | ⬜ | 发布时间 `2026-08-08 12:00:00` |
|
||
| `alias` | ⬜ | 文章别名 |
|
||
| `top` | ⬜ | 首页置顶 `y`/`n` |
|
||
| `allow_remark` | ⬜ | 允许评论 `y`/`n` |
|
||
|
||
## 常见错误
|
||
|
||
| 返回 msg | 含义 | 处理 |
|
||
|----------|------|------|
|
||
| `sign error` | 签名错误 | 检查 API 秘钥 / 时间戳 |
|
||
| `api is closed` | 未开启 API | 后台系统-设置-API 设置开启 |
|
||
| `API function is not exist` | 接口名错误 | 检查 `rest-api` 参数 |
|
||
| `parameter error` | 必填参数缺失 | 检查 title/content |
|
||
|
||
## 返回格式
|
||
|
||
```json
|
||
{ "code": 0, "msg": "ok", "data": { "article_id": 14 } }
|
||
```
|
||
|
||
`code=0` 表示成功，`code=1` 表示失败（看 `msg`）。
|