publish-weekly

用途

Publish Weekly（草稿发布）用于将本地生成的周刊 Markdown 文件发布到 Payload CMS 的 weekly 集合中，并始终保持为草稿（status: draft）。它适合用来自动化周刊内容的入库流程：先把 Markdown 草稿写入 CMS，再由人工在后台确认后发布。

前置条件

使用前需要准备以下环境变量：

PAYLOAD_API_KEY：来自 Payload users 集合为某个用户生成的 API Key，用于认证。
PAYLOAD_BASE_URL（推荐）：Payload/Next.js 服务的公开地址，例如 http://localhost:3000。
BARK_PUSH_URL（可选）：完整的 Bark 推送端点，例如 https://push.example.com/push/token/；未配置时跳过通知。

输入

技能从 /weekly 命令的参数块中获取以下输入：

week_id：如期号 Y26W12，写入 issueNumber。
title：写入 title。
filename：周刊 Markdown 文件名，从工作目录读取该文件内容，写入 content。
current_date：写入 publishDate（ISO 日期字符串）。

可选输入：

summary：周刊描述/摘要，写入 summary。若未提供则从 content 提炼，若文章开头已包含“摘要/导语”则优先复用。
tags：标签字符串数组，例如 ["模型", "工具"]，写入 tags 数组字段。
links：链接列表，对象数组，形如 [{ label, url }]，写入 links。

发布目标与接口

Collection：weekly
查询：GET {BASE_URL}/api/weekly?where[issueNumber][equals]={week_id}&limit=1
创建：POST {BASE_URL}/api/weekly
更新：PATCH {BASE_URL}/api/weekly/{id}

认证方式通过 HTTP Header 完成，必须使用 Payload 的 API Key 认证头：

Authorization: users API-Key {PAYLOAD_API_KEY}
Content-Type: application/json

字段映射

发布或更新时写入以下字段：

title（text, required）：{title}
summary（textarea, required）：若提供 {summary} 则直接使用；否则从 content 提炼 1-2 句话（不超过 200 字）。
content（textarea, required）：读取 {filename} 的完整 Markdown 内容。
issueNumber（text, required, unique）：{week_id}
status（select, required）：固定写入 draft
publishDate（date, required）：{current_date}，建议 YYYY-MM-DD

可选字段（若无就留空/不传）：

links（array）：{links}，元素结构为 { label: string, url: string }
tags（array）：将 {tags}（字符串数组）转换为 [{ value: string }]

请求 Body 示例：

{
  "title": "Agili 的 AIGC 周刊（Y26W12）",
  "issueNumber": "Y26W12",
  "publishDate": "2026-03-25",
  "status": "draft",
  "summary": "本期聚焦推理模型的工程化落地，以及一批值得试用的生产力工具。",
  "content": "# ...完整 Markdown...",
  "links": [{ "label": "在线阅读", "url": "https://aigc-weekly.agi.li" }],
  "tags": [{ "value": "模型" }, { "value": "工具" }]
}

行为约束

幂等：优先按 issueNumber == week_id 查询。若已存在，用 PATCH 更新（覆盖 title/summary/content/publishDate/status/links/tags）；若不存在，用 POST 创建。
保持草稿：无论是创建还是更新，都必须写入 status: "draft"。
产物落盘：将创建/更新成功的响应 JSON 保存为 published/{week_id}.json，用于后续恢复与审计。
失败可诊断：若请求失败，输出 HTTP 状态码、响应 body（若有）、请求的 URL，但不泄露 PAYLOAD_API_KEY。

草稿通知

草稿通知仅在 Payload POST/PATCH 成功且响应已保存到 published/{week_id}.json 后执行：

若未配置 BARK_PUSH_URL，直接跳过。
向 BARK_PUSH_URL POST JSON，5 秒超时：title 为 {week_id}｜周刊草稿已生成，body 为 {title}，url 为 {PAYLOAD_BASE_URL 去掉末尾斜杠}/admin/collections/weekly/{CMS 响应中的文档 id}。
必须用 JSON 序列化工具构造请求体，不得用字符串拼接生成 JSON；同时要求 HTTP 成功且响应 JSON 的 code === 200。
通知失败只输出超时、HTTP 状态或响应码等诊断，不打印 BARK_PUSH_URL 或任何凭据；不得将已成功写入的草稿判为失败，也不得删除审计产物。

适用场景与限制

适用于已将周刊 Markdown 写好、需要自动写入 Payload CMS 作为草稿的发布流程。使用前提是具备可用的 Payload 服务地址与用户 API Key，且目标集合为 weekly。当前资料未提供其他 CMS 平台的兼容说明、价格或收费信息，也未提供除草稿发布与可选通知之外的扩展功能说明。