介绍
# WordPress REST API Skill (Advanced)
## 目的 提供一个可用于生产环境的 WordPress REST API 自动化 CLI。此技能专注于内容工作流（文章/页面）、分类法（分类/标签）、用户读取以及无需外部 HTTP 库的安全自定义请求。
## 最佳适用场景 - 您需要一个稳定的 CLI 用于自动化和机器人工作流。 - 您需要用于流水线的 JSON 输入/输出。 - 您更喜欢无额外依赖的简单 HTTP 方式。
## 不适用场景 - 您必须处理 OAuth 流程或复杂的基于浏览器的身份验证。 - 您需要高级媒体上传（分块流式传输）。
## 要求 - Node.js 18+（用于原生的 `fetch`）。
## 一次性设置 1. 启用 WordPress REST API（现代 WordPress 中默认启用）。 2. 为 WordPress 用户创建一个应用程序密码 (Application Password)。 3. 确认用户拥有正确的角色（例如，编辑者/管理员）。
## 安装 ```bash cd wordpress npm install ```
## 运行 ```bash node scripts/wp-cli.js help node scripts/wp-cli.js posts:list --query per_page=5 node scripts/wp-cli.js posts:create '@post.json' ```
您也可以使用 npm： ```bash npm run wp -- posts:list --query per_page=5 ```
## 凭据 支持的选项（优先匹配第一个）： - Basic auth 令牌：`WP_BASIC_TOKEN`（`user:app_password` 的 base64 编码） - 用户 + 应用程序密码：`WP_USER` + `WP_APP_PASSWORD` - JWT Bearer 令牌：`WP_JWT_TOKEN`
## 必需的环境变量 - `WP_BASE_URL`（例如，`https://example.com`）
## 输入约定 - JSON 可以是内联的，或通过 `@path` 从文件加载。 - 查询参数使用 `--query key=value`（可重复）或 `--query key1=value1,key2=value2`。
## 命令映射（高层级） 文章 (Posts)： - `posts:list`、`posts:get`、`posts:create`、`posts:update`、`posts:delete`
页面 (Pages)： - `pages:list`、`pages:get`、`pages:create`、`pages:update`、`pages:delete`
分类法 (Taxonomy)： - `categories:list`、`categories:create` - `tags:list`、`tags:create`
用户 (Users)： - `users:list`、`users:get`
高级 (Advanced)： - `request`（原始方法 + 路径）
## 操作指南 - 对于只读列表调用，优先使用 `context=view`。 - 暂存内容时使用 `status=draft`。 - 在编排器中实现对 `429` 和临时性 `5xx` 错误的重试机制。
## 预期输出 - 输出 JSON 到标准输出；错误时返回非零退出码。
## 安全说明 - 切勿记录或提交令牌或应用程序密码。 - 尽可能使用专用的低权限 WordPress 账户。