核心功能与使用方式
Ghost Publishing Pro 是一套面向生产环境的 Ghost CMS 自动化技能，并非简单的 API 包装器。它涵盖 17 个工作流，核心用法包括：
- 发布与邮件一体化：单次 API 调用即可发布文章并推送给订阅者（
status: published+email_segment: all必须同请求），这是最关键的特性，事后无法通过 API 补发邮件。 - 内容更新：必须先 GET 获取
updated_at字段，再在 PUT 请求中原样带回，否则返回 409 冲突。 - 图片上传：使用 Python requests 的 multipart/form-data，避免 curl（macOS zsh 下静默失败）和浏览器 fetch（CORS 阻断）。
- 批量操作：支持 Squarespace/WordPress/Substack 迁移、批量摘要更新、站点健康审计、GSC 索引修复等高级工作流。
显著优点
- 生产验证：源自真实 Ghost Pro 新闻通讯运营和完整 Squarespace 博客迁移经验，包含大量实战踩坑记录。
- 零依赖轻量：除可选的
fast-xml-parser外，核心功能仅依赖 Node.js 内置模块和 curl，无 npm 生态膨胀。 - 安全设计：强制使用专用 Integration Key（非所有者凭证），JWT 令牌 5 分钟过期、内存存储、不输出到日志，支持即时吊销。
- 执行门控：6 道强制前置检查（凭证存在性、
updated_at获取、邮件原子性、批量操作审批、权限边界、上传方法），防止常见操作事故。
局限性与风险
- 权限硬边界：站点设置、代码注入、重定向上传、员工管理等所有者级操作明确无法通过 Integration Token 完成，返回 403 是预期行为，需手动在 Ghost Admin 操作。
- 邮件一次性：
email_segment仅在首次发布时生效，错过无法 API 补救。 - 批量操作不可逆：更新、标签批量分配等无原生回滚机制，需人工审批。
- 令牌有效期短：5 分钟 JWT 在大型批量作业中需定期刷新（建议每 50 posts）。
适合人群
Ghost 专业用户、 newsletter 运营者、内容迁移需求者、希望将 Ghost 纳入 AI 工作流的技术写作者。不适合需要频繁修改站点设置或主题代码的完全无代码用户。
常规风险
凭证文件需严格限制文件权限（~/.openclaw/credentials/ghost-admin.json），避免进入版本控制或共享目录；批量操作前务必确认作用范围。