wenpai
fcd7d596ce
- 项目架构、设计、路线图等文档就位 - CLAUDE.md: 项目定位与治理规则 - Playwright + wp-env E2E 测试基础设施 - 部署脚本和备份配置 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
4.7 KiB
4.7 KiB
WPBridge 常见问题
常见问题解答 (FAQ)
安装与配置
Q: WPBridge 的系统要求是什么？
- WordPress 5.9 或更高版本
- PHP 7.4 或更高版本
- 建议启用 cURL 扩展
Q: 如何安装 WPBridge？
- 下载插件 ZIP 文件
- 在 WordPress 后台进入「插件 > 安装插件 > 上传插件」
- 上传并激活插件
- 进入「设置 > WPBridge」配置
Q: WPBridge 与文派叶子（WPCY）有什么区别？
| 功能 | 文派叶子 (WPCY) | WPBridge |
|---|---|---|
| 目标用户 | 普通用户 | 开发者/高级用户 |
| 主要功能 | 官方源加速 | 自定义源桥接 |
| 配置复杂度 | 开箱即用 | 需要配置 |
| 商业插件支持 | 有限 | 完整支持 |
两者可以同时使用，WPBridge 会自动检测 WPCY 并协同工作。
更新源
Q: 支持哪些类型的更新源？
- JSON API（标准格式）
- GitHub Releases
- GitLab Releases
- Gitee Releases
- ArkPress（文派自托管）
- AspireCloud
- Plugin Update Checker (PUC) 格式
- FAIR Package Manager
Q: 如何添加 GitHub 仓库作为更新源？
- 进入「更新源」标签
- 点击「添加更新源」
- 选择类型为「GitHub」
- 填写仓库 URL，如
https://github.com/owner/repo - 如果是私有仓库，填写 Personal Access Token
- 保存
Q: 更新源不工作怎么办？
- 检查 URL：确保 URL 格式正确
- 测试连通性：在「诊断」页面点击「测试」按钮
- 检查认证：私有源需要正确的 Token
- 查看日志：启用调试模式查看详细日志
- 检查防火墙：确保服务器可以访问更新源
Q: 多个更新源提供同一插件时如何处理？
WPBridge 会：
- 按优先级排序（数字越小优先级越高）
- 比较版本号，选择最高版本
- 如果版本相同，使用优先级最高的源
商业插件
Q: 如何管理商业插件的更新？
- WPBridge 会自动检测商业插件
- 您可以为商业插件配置专用更新源
- 或者使用插件原有的更新机制
Q: 商业插件检测不准确怎么办？
您可以手动标记插件类型：
- 在「概览」页面找到插件
- 点击类型标签
- 选择正确的类型（免费/商业/第三方）
Q: WPBridge 会绕过商业插件的授权验证吗？
不会。WPBridge 只是提供更新源桥接功能，不会绕过任何授权验证。您仍需要有效的授权才能使用商业插件。
性能与缓存
Q: WPBridge 会影响网站性能吗？
WPBridge 设计时考虑了性能：
- 使用缓存减少请求次数
- 支持并行请求
- 后台预热机制
- 失败源冷却机制
Q: 如何清除缓存？
方法一：管理界面
- 进入「诊断」标签
- 点击「清除缓存」按钮
方法二：WP-CLI
wp bridge cache clear
Q: 缓存时间可以调整吗？
可以。在「设置」标签中可以调整缓存时间：
- 1 小时
- 6 小时
- 12 小时（默认）
- 24 小时
API 与集成
Q: 如何使用 Bridge API？
- 在「API」标签生成 API Key
- 在请求头中添加
X-WPBridge-Key: your_key - 调用
/wp-json/bridge/v1/下的端点
详见 API 文档。
Q: API Key 丢失了怎么办？
API Key 只在生成时显示一次。如果丢失：
- 撤销旧的 Key
- 生成新的 Key
Q: 可以与其他系统集成吗？
可以。WPBridge 提供：
- REST API 供外部调用
- WP-CLI 命令供脚本使用
- Webhook 通知功能
故障排除
Q: 插件激活后没有菜单？
- 检查是否有 PHP 错误
- 尝试停用其他插件排查冲突
- 检查用户权限（需要管理员权限）
Q: 更新检查失败？
- 检查网络连接
- 检查更新源 URL 是否可访问
- 查看「诊断」页面的错误信息
- 启用调试模式查看详细日志
Q: 配置丢失了怎么恢复？
如果有备份：
- 进入「设置」标签
- 点击「导入」按钮
- 选择备份的 JSON 文件
如果没有备份，需要重新配置。建议定期导出配置作为备份。
Q: 如何获取调试信息？
- 在「设置」中启用「调试模式」
- 在「日志」标签查看日志
- 或使用「诊断」页面的「导出报告」功能
其他问题
Q: WPBridge 是免费的吗？
基础功能免费，高级功能（如多站点支持）可能需要付费。
Q: 如何获取技术支持？
- 文档：https://wenpai.org/docs/wpbridge
- 问题反馈：https://github.com/ArkPress/wpbridge/issues
- 社区支持：https://wenpai.org/community
Q: 如何参与开发？
WPBridge 是开源项目，欢迎贡献：
- Fork 仓库
- 创建功能分支
- 提交 Pull Request
最后更新: 2026-02-05
