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