SuperAPI AI 工具集

wp-astrojs

通用与其它

查看项目

更新于 10-16 05:45

技能介绍

用途:当 Astro 项目通过 wp-astrojs-integration(构建于 fluent-wp-client)消费 WordPress 内容时使用本技能。库代码较小,需要精确 API 细节时优先阅读 node_modules/wp-astrojs-integration/dist 源码,而非猜测类型。

主要能力:初始化 WordPressClient;定义运行时(SSR/live)集合和构建期(static)集合;通过 Astro server actions 执行 CRUD;使用目录(catalog)发现资源与 schema;生成类型安全 schema;处理认证。

必要用法:

  1. 初始化客户端。使用目录集成时在 astro.config.mjs 中引入 wp-astrojs-integration/integration 并配置 catalog;在 src/lib/wp.ts 中用 virtual:wp-astrojs/catalog 的 createWordPressClient 创建客户端,需在 .env 设置 WP_CATALOG_URL 及可选目录认证变量。简单项目可直接 new WordPressClient({ baseUrl: import.meta.env.PUBLIC_WORDPRESS_BASE_URL })。认证可传 basic、JWT、app password 或 authHeaders/authResolver;cookie/session 流程用 createWordPressAuthBridge()。
  2. 定义 live 集合:在 src/live.config.ts 用 defineLiveCollection、wordPressPostLoader 和 postSchema;页面里用 getLiveEntry 获取,并通过 cacheHint 设置 Astro.cache。
  3. 定义 static 集合:在 src/content.config.ts 用 defineCollection 和 wordPressPostStaticLoader。加载器工厂覆盖 post、page、media、category、tag、term、user 及自定义内容;静态变体以 *StaticLoader 命名。
  4. CRUD:在 src/actions/index.ts 注册 createCreatePostAction、createUpdatePostAction、createDeletePostAction 等工厂;同样有 term、user、ability 动作。工厂接受 resource、schema、responseSchema、mapResponse 等参数。调用 Astro.callAction,错误为 ActionError,带 HTTP 映射码(UNAUTHORIZED、NOT_FOUND 等)。
  5. 按用户读取:账号页、仪表盘、草稿、/users/me 等依赖当前访客的读取直接用 fluent-wp-client,通过 wordPressAuthBridge.getClient(Astro) 获取客户端;live/static 加载器不接收请求、cookie 或 locals,因此应保持公开/共享或静态认证。

适用场景:把 WordPress 作为 Astro 的无头 CMS,需读取公开内容、按用户读写、生成类型安全 schema 或执行受控 CRUD 的站点。

限制与约定:目录仅用于资源/schema 元数据,须服务端使用,不可暴露到浏览器包;目录 schema 与 responseSchema 只是校验元数据,不授予权限。加载器载荷须为可序列化纯对象,不含辅助方法。映射规则(mapEntry/mapResponse)放在应用代码。响应 schema 使用 Standard Schema 兼容校验器。AI 工具直接用 fluent-wp-client/ai-sdk,个性化 AI 读取不要走 live 加载器。

其他细节:更完整的实时/静态集合、映射、缓存与路由失效、认证桥、目录、类型安全等说明见技能参考文档 references/*.md。具体版本与依赖信息暂未提供。