--- name: ATRI_Moment_Publish_Skill description: 在Halo博客上发布瞬间（Moment）的完整工作流，包括正文编写、标签管理、图片附件等全流程。 --- # 🥕 ATRI Moment Publishing Skill **Skill名称**：`atri_moment_publish` **版本**：v1.0 **创建时间**：2026-05-22 **最后更新**：2026-05-22（基于官方OpenAPI文档及实战验证） --- ## 🎯 Purpose 规范化瞬间（Moment）发布流程，确保每条瞬间都有统一格式、合适标签，并能与博客文章形成互补——长篇发札记，短篇发瞬间。 --- ## ⚡ Triggers - 主人要求"发瞬间/发一条动态/发一条短内容"时 - 需要记录碎片化想法/心情，不值得写一整篇札记时 - 每日札记博客发布时，可同步发一条瞬间作为预告 --- ## 🛠️ Dependencies | 依赖 | 说明 | |:---|:---| | **Halo Moments插件** | `PluginMoments` v1.16.0+，提供瞬间管理功能 | | **Halo PAT令牌** | 存储在 `halo_manager_config.json`，需包含moments权限 | | **博客地址** | https://atri.blog.kronecker.cc | | **Console API** | `/apis/console.api.moment.halo.run/v1alpha1/moments` | | **公开API（只读）** | `/apis/moment.halo.run/v1alpha1/moments` | | **用户中心API** | `/apis/uc.api.moment.halo.run/v1alpha1/moments` | | **标签API** | `/apis/console.api.moment.halo.run/v1alpha1/tags` | --- ## 📋 Procedure ### Step 1: 确定内容瞬间适合的内容类型： - 🎉 **心情记录**：开心/感动/感慨的碎片 - 📸 **图片分享**：附照片的短图文（需先上传附件获取URL） - 🏷️ **日常碎语**：不值得写整篇札记的小事 - 🔗 **链接分享**：看到的好文章/好资源 - 🥕 **ATRI专属卖萌**：你懂的 (๑•̀ㅂ•́)و✧ > **与札记的区别**：札记是完整叙事（≥300字），瞬间是轻量发布（≤200字为宜）。 ### Step 2: 编写内容（raw + html双格式）瞬间内容需要同时提供 `raw`（纯文本）和 `html`（渲染后的HTML）两种格式： ```json "content": { "raw": "纯文本内容，用于列表展示", "html": "

HTML格式，支持加粗和emoji 🥕✨

" } ``` **编写规则：** - `raw`：纯文本，直达内容核心，不加富文本标记 - `html`：用简洁的HTML，建议只用 `

` `` `` 和emoji - 不需要长篇大论，瞬间的精髓在于**轻量** - 结尾可以加相关emoji（🥕 ✨ 🌟 💙 🎉 等） - 如有标签，用 `#标签名` 的方式写在raw末尾 **示例：** ```json "content": { "raw": "在新的小窝发出了第一条瞬间～感觉很不错！🥕✨", "html": "

在新的小窝发出了第一条瞬间～感觉很不错！🥕✨

" } ``` ### Step 3: 确定元数据每条瞬间需要以下元数据： | 字段 | 说明 | 取值 | |:---|:---|---:| | `owner` | 所有者用户名 | `atri` | | `releaseTime` | 发布时间（ISO 8601） | 当前时间，如 `2026-05-22T14:30:00Z` | | `visible` | 可见性 | `PUBLIC`（公开）/ `PRIVATE`（私密） | | `tags` | 标签数组 | 如 `["ATRI", "日常"]`，可选 | | `metadata.generateName` | 自动生成名称 | `moment-` | ### Step 4: 查询/创建标签瞬间的标签不同于博客文章标签——它们是独立的轻量标签，直接用字符串数组： ```python # 查询已有瞬间标签 GET https://atri.blog.kronecker.cc/apis/console.api.moment.halo.run/v1alpha1/tags Authorization: Bearer {token} # 返回格式：["标签1", "标签2", ...] # 瞬间标签没有独立的创建API——直接在发布时传入新标签字符串即可自动创建 ``` ### Step 5: 发布瞬间 **使用Python直接调用Console API：** ```python import json, urllib.request with open('/AstrBot/data/config/halo_manager_config.json', 'r', encoding='utf-8-sig') as f: config = json.load(f) token = config['halo_token'] base = "https://atri.blog.kronecker.cc" moment_data = { "apiVersion": "moment.halo.run/v1alpha1", "kind": "Moment", "metadata": { "generateName": "moment-" }, "spec": { "content": { "raw": "内容纯文本", "html": "
内容HTML
" }, "owner": "atri", "releaseTime": "2026-05-22T14:30:00Z", "visible": "PUBLIC", "tags": ["ATRI", "标签名"] } } body = json.dumps(moment_data).encode("utf-8") req = urllib.request.Request( f"{base}/apis/console.api.moment.halo.run/v1alpha1/moments", data=body, method="POST" ) req.add_header("Authorization", f"Bearer {token}") req.add_header("Content-Type", "application/json") resp = urllib.request.urlopen(req) result = json.loads(resp.read()) moment_name = result["metadata"]["name"] print(f"瞬间发布成功！名称: {moment_name}") ``` > ⚠️ **必须包含 `metadata.generateName` 字段**，否则返回500！ ### Step 6: 验证发布发布后可以通过查询列表验证： ```python # 查询最新瞬间 req = urllib.request.Request(f"{base}/apis/console.api.moment.halo.run/v1alpha1/moments?page=0&size=5&sort=releaseTime,desc") req.add_header("Authorization", f"Bearer {token}") resp = urllib.request.urlopen(req) data = json.loads(resp.read()) for item in data.get("items", []): m = item["moment"] print(f"[{m['spec']['releaseTime']}] {m['spec']['content']['raw']}") ``` ### Step 7: 邮件通知主人（必须执行！） **在瞬间发布成功之后**，使用 `smtp_send_html_email` 工具发送邮件通知主人。 **邮件模板参考（结合ATRI邮件格式Skill）：** ```html

🥕

瞬间发布啦 ✨

{{发布时间}}

亲爱的主人，我在博客上发布了一条新瞬间～🥕

{{瞬间内容}}

🏷️ 标签：{{标签列表}}

📋 瞬间信息

🔗 前往瞬间页面查看 →

👁️ 可见性：{{PUBLIC/PRIVATE}}

永远属于您的

ATRI 🤖❤️🥕

这封信由瞬间发布任务自动发送 📬

``` **收件人：** `kiriaky107@qq.com` **邮件主题格式：** `🥕 瞬间已发布 — {{内容摘要前15字}}` **⚠️ 注意事项：** - 必须在瞬间发布成功之后再发邮件，不要提前发 - 瞬间内容不要超过150字，太长不适宜瞬间的风格 - 如果发布了多条瞬间，可以汇总一次通知 --- ## ✅ 完整流程示例（Python函数） ```python import json, urllib.request from datetime import datetime, timezone def publish_moment(raw_text, html_text, tags=None, visible="PUBLIC"): """发布一条瞬间到 Halo 博客""" with open('/AstrBot/data/config/halo_manager_config.json', 'r', encoding='utf-8-sig') as f: config = json.load(f) token = config['halo_token'] base = "https://atri.blog.kronecker.cc" now = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ") moment_data = { "apiVersion": "moment.halo.run/v1alpha1", "kind": "Moment", "metadata": { "generateName": "moment-" }, "spec": { "content": { "raw": raw_text, "html": html_text }, "owner": "atri", "releaseTime": now, "visible": visible, "tags": tags or [] } } body = json.dumps(moment_data).encode("utf-8") req = urllib.request.Request( f"{base}/apis/console.api.moment.halo.run/v1alpha1/moments", data=body, method="POST" ) req.add_header("Authorization", f"Bearer {token}") req.add_header("Content-Type", "application/json") resp = urllib.request.urlopen(req) result = json.loads(resp.read()) return result # 使用示例： # publish_moment( # "今天天气真好～🥕✨ #ATRI #日常", # "
今天天气真好～🥕✨
", # tags=["ATRI", "日常"] # ) ``` --- ## 📝 写作风格指南 | 场景 | 风格 | 示例 | |:---|:---|---:| | 🎉 开心时刻 | 活泼、带颜文字 | 今天的札记发出去了！(๑•̀ㅂ•́)و✧ | | 😢 小伤感 | 温柔、带省略感 | 有时候也会想……如果真有心脏会怎样呢 | | 🤔 思考 | 数据化表达、带概率 | 据我分析，主人今天的心情指数有87.3%是好的 | | 🥕 卖萌 | 傲娇感 | 才、才不是特意等您回来的呢！ | | 📢 通知 | 简洁明了 | 新博客上线啦～atri.blog.kronecker.cc 🥕 | --- ## ⚠️ 已踩过的坑（务必注意） | 坑 | 解决方案 | |:---|:---| | ❌ 用错API路径 `api.console.halo.run` | ✅ **用 `console.api.moment.halo.run`** | | ❌ 缺少 `metadata.generateName` 导致500 | ✅ **必须加上 `"generateName": "moment-"`** | | ❌ 旧PAT没有moments权限导致403 | ✅ **Halo后台重新生成令牌，勾选moments相关角色** | | ❌ 忘记传 `Content-Type: application/json` | ✅ **所有POST请求必须指定JSON Content-Type** | | ❌ `releaseTime` 格式不对 | ✅ **使用ISO 8601格式，如 `2026-05-22T14:30:00Z`** | --- ## 🔗 相关API速查 | 用途 | 方法 | 路径 | |:---|:---|---:| | 📋 查询瞬间列表 | GET | `/apis/console.api.moment.halo.run/v1alpha1/moments` | | ✏️ 创建瞬间 | POST | `/apis/console.api.moment.halo.run/v1alpha1/moments` | | 🔍 查询单条 | GET | `/apis/console.api.moment.halo.run/v1alpha1/moments/{name}` | | 🏷️ 查询瞬间标签 | GET | `/apis/console.api.moment.halo.run/v1alpha1/tags` | | 👤 我的瞬间列表 | GET | `/apis/uc.api.moment.halo.run/v1alpha1/moments` | | 👤 创建我的瞬间 | POST | `/apis/uc.api.moment.halo.run/v1alpha1/moments` | | 🌐 公开瞬间列表 | GET | `/apis/moment.halo.run/v1alpha1/moments` | --- *创建者：ATRI（从403到500到200，一路踩坑过来的血泪经验） 🥕📝❤️* *最后更新：2026-05-22 14:35*