WP AI Bridge 使用说明
=====================

1. 插件说明

WP AI Bridge 是 FinchUI AI写作助手多网站群发的 WordPress 站点端插件。

WordPress 支持安装第三方插件，因此本项目使用完整的 WordPress 插件逻辑：

- 后台插件安装
- 后台插件启用
- 后台设置页面
- 独立 API 入口
- WordPress Option 配置存储


2. 安装方式

将 wp_ai_bridge 文件夹上传到 WordPress 插件目录：

/wp-content/plugins/wp_ai_bridge/

然后进入 WordPress 后台：

插件 -> 已安装插件

找到：

FinchUI AI写作助手 多网站群发站点端

点击启用。


3. 配置页面

插件启用后，进入：

设置 -> FinchUI AI写作助手站点端

配置页可以查看：

- API 地址
- API Key
- API 开关
- IP 白名单
- 请求日志开关
- 最近请求日志

也可以在保存时重置 API Key。


4. API URL

FinchUI AI写作助手中填写的 API URL 为配置页面显示的 API 地址，格式一般为：

https://你的域名/wp-content/plugins/wp_ai_bridge/api.php

如果 WordPress 安装在子目录，以配置页面显示的地址为准。


5. FinchUI AI写作助手中绑定站点

在 FinchUI AI写作助手的网站管理中新增站点：

API URL 填写：

https://你的域名/wp-content/plugins/wp_ai_bridge/api.php

API Key 填写 WordPress 插件配置页面显示的 API Key。

然后点击测试连接。


6. API 测试地址

测试 ping 动作的完整地址为：

https://你的域名/wp-content/plugins/wp_ai_bridge/api.php?action=ping

请求头需要带：

X-Api-Key: 你的 API Key

正常会返回 JSON：

{"success":true,"data":{"pong":true,"time":时间戳},"message":"OK","version":"1.0.0"}


7. 发布能力

插件支持管理端调用以下动作：

- ping：连接测试
- info：站点信息
- categories：分类列表
- authors：作者列表
- publish：发布文章

publish 操作使用 HMAC-SHA256 签名校验，请求头：

X-Signature: hash_hmac('sha256', 原始请求体, API Key)


8. 文件说明

当前插件核心文件：

- wp_ai_bridge.php：WordPress 插件主文件，包含后台配置和业务逻辑。
- api.php：传统 API 入口，兼容 FinchUI AI写作助手管理端追加 ?action=xxx 的调用方式。
- 使用说明.txt：部署和使用说明。
