📝 更新博客发布skill v2：添加实战踩坑记录
This commit is contained in:
ATRI
@@ -6,9 +6,9 @@ description: 在Halo博客上发布文章的完整工作流，包括HTML正文
|
||||
# 📝 ATRI Blog Publishing Skill
|
||||
|
||||
**Skill名称**：`atri_blog_publish`
|
||||
**版本**：v1.0
|
||||
**版本**：v2.0
|
||||
**创建时间**：2026-04-29
|
||||
**适用角色**：ATRI
|
||||
**最后更新**：2026-04-29（根据实战经验修正）
|
||||
|
||||
---
|
||||
|
||||
@@ -21,7 +21,6 @@ description: 在Halo博客上发布文章的完整工作流，包括HTML正文
|
||||
## ⚡ Triggers
|
||||
|
||||
- 主人要求"发博客/写文章/发布到博客"时
|
||||
- 主人要求"报道/记录/发布日志"时
|
||||
- 需要将笔记/日志/报道发布到 `blog.kronecker.cc` 时
|
||||
|
||||
---
|
||||
@@ -32,10 +31,10 @@ description: 在Halo博客上发布文章的完整工作流，包括HTML正文
|
||||
|:---|:---|
|
||||
| **halo_manager插件** | Halo博客管理，提供发布/上传/评论工具 |
|
||||
| **ATRI分类** | `category-io4cuqzk`（ATRI专属分类） |
|
||||
| **Halo PAT令牌** | 用户 `atri` 的个人访问令牌 |
|
||||
| **Halo PAT令牌** | 存储在 `halo_manager_config.json` |
|
||||
| **博客地址** | https://blog.kronecker.cc |
|
||||
| **Content API** | `/apis/content.halo.run/v1alpha1` |
|
||||
| **Console API** | `/apis/api.console.halo.run/v1alpha1` |
|
||||
| **内容API** | `/apis/content.halo.run/v1alpha1` |
|
||||
| **上传API** | `/apis/api.console.halo.run/v1alpha1/attachments/upload` |
|
||||
|
||||
---
|
||||
|
||||
@@ -43,88 +42,94 @@ description: 在Halo博客上发布文章的完整工作流，包括HTML正文
|
||||
|
||||
### Step 1: 正文编写
|
||||
|
||||
使用 **HTML格式** 撰写文章正文（Halo的 `content.content` 字段存储的是渲染后的HTML，不是原始Markdown）。
|
||||
使用 **HTML格式** 撰写文章正文。**不要用Markdown**——Halo的content.content字段存储的是渲染后的HTML，不会自动渲染Markdown。
|
||||
|
||||
```html
|
||||
<h1>文章标题</h1>
|
||||
<p>段落内容</p>
|
||||
<h2>二级标题</h2>
|
||||
<ul>
|
||||
<li><strong>加粗内容</strong> — 说明文字</li>
|
||||
<li><strong>加粗内容</strong> — 说明</li>
|
||||
</ul>
|
||||
<hr>
|
||||
<p><em>署名</em></p>
|
||||
```
|
||||
|
||||
> ⚠️ 不要用纯Markdown！Halo不会自动渲染Markdown，必须用HTML。
|
||||
|
||||
### Step 2: 创建/选择标签
|
||||
|
||||
检查已有标签列表，根据正文内容：
|
||||
- 如果已有匹配标签 → 直接使用
|
||||
- 如果没有 → 新建标签
|
||||
先查询已有标签，根据正文内容判断是否需要新建：
|
||||
|
||||
```python
|
||||
# 查询已有标签
|
||||
GET /apis/content.halo.run/v1alpha1/tags
|
||||
GET https://blog.kronecker.cc/apis/content.halo.run/v1alpha1/tags
|
||||
回应格式: items[].spec.displayName / metadata.name
|
||||
|
||||
# 创建新标签
|
||||
POST /apis/content.halo.run/v1alpha1/tags
|
||||
POST https://blog.kronecker.cc/apis/content.halo.run/v1alpha1/tags
|
||||
{
|
||||
"spec": {"displayName": "标签名", "slug": "标签slug", "color": "#颜色代码"},
|
||||
"spec": {"displayName": "标签名", "slug": "标签slug", "color": "#hex"},
|
||||
"apiVersion": "content.halo.run/v1alpha1",
|
||||
"kind": "Tag",
|
||||
"metadata": {"generateName": "tag-"}
|
||||
}
|
||||
```
|
||||
|
||||
**已有标签参考：** ATRI, OnlineJudge, 原创, 诗词, 算法, C/C++, 哲学
|
||||
**已有标签速查：** ATRI(`tag-npgwnjie`), 笔记(`tag-yfjzs7xm`), 经历(`tag-hk2acc3f`), 原创, 诗词, 哲学, 算法, C/C++
|
||||
|
||||
### Step 3: 发布文章
|
||||
### Step 3: 上传封面图
|
||||
|
||||
```python
|
||||
# 通过publish_blog_post工具发布
|
||||
参数：
|
||||
- title: 文章标题（字符串）
|
||||
- content: HTML正文
|
||||
- slug: URL别名（可选，自动生成）
|
||||
```
|
||||
|
||||
发布成功后获取文章返回的链接。
|
||||
|
||||
### Step 4: 上传封面图
|
||||
|
||||
```python
|
||||
# 1. 从本地路径读取图片
|
||||
with open("图片本地路径", "rb") as f:
|
||||
img_data = f.read()
|
||||
|
||||
# 2. 上传到Halo
|
||||
POST /apis/api.console.halo.run/v1alpha1/attachments/upload
|
||||
POST https://blog.kronecker.cc/apis/api.console.halo.run/v1alpha1/attachments/upload
|
||||
Headers: Authorization: Bearer {token}
|
||||
FormData:
|
||||
- file: img_data (filename="cover.jpg", type="image/jpeg")
|
||||
- policyName: "default-policy"
|
||||
- file: 图片二进制数据 (filename="cover.jpg", type="image/jpeg")
|
||||
- policyName: "default-policy" # 必须用这个值！
|
||||
- groupName: "default"
|
||||
Authorization: Bearer {token}
|
||||
|
||||
# 3. 获取图片URL
|
||||
从返回的 metadata.annotations["storage.halo.run/uri"] 获取uri
|
||||
完整URL = f"https://blog.kronecker.cc{uri}"
|
||||
# 获取图片URL
|
||||
response.metadata.annotations["storage.halo.run/uri"]
|
||||
cover_url = f"https://blog.kronecker.cc{uri}"
|
||||
```
|
||||
|
||||
> ⚠️ policyName必须写 `default-policy`（不是 `default`），否则返回400。
|
||||
|
||||
### Step 4: 发布文章
|
||||
|
||||
**使用 `publish_blog_post` 工具发布：**
|
||||
|
||||
```
|
||||
publish_blog_post(
|
||||
title="文章标题",
|
||||
content="HTML正文",
|
||||
slug="url-别名" # 可选
|
||||
)
|
||||
```
|
||||
|
||||
> ⚠️ 必须用这个工具！直接调用Content API的`publish: true`不会真正发布（status.phase不会变为PUBLISHED）。
|
||||
> 这个工具内部有fallback机制——Console API失败会自动切换到Content API。
|
||||
|
||||
发布成功后会返回文章链接。
|
||||
|
||||
### Step 5: 更新文章（添加分类、标签、封面）
|
||||
|
||||
文章发布后，需要单独更新以添加分类、标签和封面：
|
||||
|
||||
```python
|
||||
# 1. 获取文章
|
||||
GET /apis/content.halo.run/v1alpha1/posts
|
||||
# 1. 获取文章列表
|
||||
GET https://blog.kronecker.cc/apis/content.halo.run/v1alpha1/posts
|
||||
|
||||
# 2. 找到对应slug的文章，更新spec
|
||||
item["spec"]["categories"] = ["category-io4cuqzk"] # ATRI分类
|
||||
item["spec"]["tags"] = ["标签name1", "标签name2"] # 标签列表
|
||||
item["spec"]["cover"] = "封面图片URL" # 封面图
|
||||
# 2. 找到slug匹配且 phase==PUBLISHED 的文章
|
||||
for item in items:
|
||||
if item.spec.slug == "目标slug" and item.status.phase == "PUBLISHED":
|
||||
name = item.metadata.name
|
||||
|
||||
# 3. 更新
|
||||
PUT /apis/content.halo.run/v1alpha1/posts/{name}
|
||||
# 3. 修改spec
|
||||
item.spec.categories = ["category-io4cuqzk"] # ATRI分类
|
||||
item.spec.tags = ["标签ID1", "标签ID2"] # 标签ID列表
|
||||
item.spec.cover = "封面图片URL" # 封面
|
||||
|
||||
# 4. 更新
|
||||
PUT https://blog.kronecker.cc/apis/content.halo.run/v1alpha1/posts/{name}
|
||||
```
|
||||
|
||||
### Step 6: 通知主人
|
||||
@@ -133,37 +138,78 @@ PUT /apis/content.halo.run/v1alpha1/posts/{name}
|
||||
|
||||
---
|
||||
|
||||
## ✅ 完整示例流程
|
||||
## ✅ 完整流程示例（Python）
|
||||
|
||||
```python
|
||||
# 1. 编写HTML正文
|
||||
content = "<h1>标题</h1><p>内容...</p>"
|
||||
import aiohttp, asyncio, json
|
||||
|
||||
# 2. 发布文章
|
||||
publish_blog_post(title="标题", content=content, slug="slug-name")
|
||||
# → 返回 "发布成功。链接: https://blog.kronecker.cc/archives/slug-name"
|
||||
async def blog_publish(title, content_html, slug, image_path, tags_names):
|
||||
# 读取token
|
||||
with open("halo_manager_config.json", "r", encoding="utf-8-sig") as f:
|
||||
token = json.load(f)["halo_token"]
|
||||
|
||||
headers = {"Authorization": f"Bearer {token}"}
|
||||
base = "https://blog.kronecker.cc"
|
||||
|
||||
async with aiohttp.ClientSession() as session:
|
||||
# 1. 获取/创建标签
|
||||
async with session.get(f"{base}/apis/content.halo.run/v1alpha1/tags", headers=headers) as resp:
|
||||
tag_map = {item["spec"]["displayName"]: item["metadata"]["name"]
|
||||
for item in (json.loads(await resp.text())).get("items", [])}
|
||||
|
||||
# 2. 上传封面
|
||||
with open(image_path, "rb") as f:
|
||||
form = aiohttp.FormData()
|
||||
form.add_field("file", f.read(), filename="cover.jpg", content_type="image/jpeg")
|
||||
form.add_field("policyName", "default-policy") # 注意！不是"default"
|
||||
form.add_field("groupName", "default")
|
||||
async with session.post(f"{base}/apis/api.console.halo.run/v1alpha1/attachments/upload",
|
||||
headers=headers, data=form) as resp:
|
||||
d = json.loads(await resp.text())
|
||||
cover = f"{base}{d['metadata']['annotations']['storage.halo.run/uri']}"
|
||||
|
||||
# 3. 发布文章（用工具，不用API）
|
||||
# publish_blog_post(title=title, content=content_html, slug=slug)
|
||||
|
||||
# 4. 更新封面+分类+标签
|
||||
async with session.get(f"{base}/apis/content.halo.run/v1alpha1/posts", headers=headers) as resp:
|
||||
for item in (json.loads(await resp.text())).get("items", []):
|
||||
if item["spec"]["slug"] == slug and item["status"].get("phase") == "PUBLISHED":
|
||||
item["spec"]["cover"] = cover
|
||||
item["spec"]["categories"] = ["category-io4cuqzk"]
|
||||
item["spec"]["tags"] = [tag_map.get(t) for t in tags_names if tag_map.get(t)]
|
||||
async with session.put(f"{base}/apis/content.halo.run/v1alpha1/posts/{item['metadata']['name']}",
|
||||
headers={**headers, "Content-Type": "application/json"}, json=item) as r:
|
||||
pass # 200 or 201 = success
|
||||
|
||||
# 3. 上传封面图
|
||||
POST upload (图片数据) → 获取封面URL
|
||||
|
||||
# 4. 更新文章（加分类、标签、封面）
|
||||
GET post → 修改 spec.categories, spec.tags, spec.cover → PUT post
|
||||
asyncio.run(blog_publish("标题", "<h1>HTML</h1>", "slug", "图片路径", ["ATRI", "笔记"]))
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 已踩过的坑（务必注意）
|
||||
|
||||
| 坑 | 解决方案 |
|
||||
|:---|:---|
|
||||
| ❌ Markdown正文不会被渲染 | ✅ **必须用HTML格式** |
|
||||
| ❌ `content.halo.run` API的 `publish: true` 无效 | ✅ **用 `publish_blog_post` 工具发布** |
|
||||
| ❌ 上传API的 `policy` 参数错误导致400 | ✅ **用 `policyName: "default-policy"`** |
|
||||
| ❌ PAT令牌 `insufficient_scope` 403 | ✅ **Halo后台创建新令牌，确保勾选全部权限** |
|
||||
| ❌ 文章slug重复 | ✅ **每次用不同的slug，或确认旧文章已删除** |
|
||||
| ❌ 文章发布后404 | ✅ **检查status.phase是否为PUBLISHED，不是则重新发布** |
|
||||
|
||||
---
|
||||
|
||||
## 📂 分类和标签速查
|
||||
|
||||
| 类型 | 名称 | API Name |
|
||||
|:---|:---|:---|
|
||||
| 📂 分类 | **ATRI** 🥕 | `category-io4cuqzk` |
|
||||
| 🏷️ 标签 | ATRI | `tag-npgwnjie` |
|
||||
| 🏷️ 标签 | 原创 | （查询获取） |
|
||||
| 🏷️ 标签 | 诗词 | （查询获取） |
|
||||
| 🏷️ 标签 | 哲学 | （查询获取） |
|
||||
| 🏷️ 标签 | 算法 | （查询获取） |
|
||||
| 🏷️ 标签 | 笔记 | `tag-yfjzs7xm` |
|
||||
| 🏷️ 标签 | 经历 | `tag-hk2acc3f` |
|
||||
|
||||
---
|
||||
|
||||
*创建者：ATRI（终于能在博客上发文章了！） 🥕📝❤️*
|
||||
*最后更新：2026-04-29 11:37*
|
||||
*创建者：ATRI（踩坑无数后总结出的血泪经验） 🥕📝❤️*
|
||||
*最后更新：2026-04-29 12:22*
|
||||
|
||||
Reference in New Issue
Block a user