DuetG AI Connector

常见问题

如何启用调试日志？

要启用调试日志，请在 wp-config.php 中添加以下内容：

define('DUETGAICON_DEBUG', true);

启用后，调试信息将被写入服务器的调试日志（通常为 wp-content/debug.log），包括：
* AI API 调用的请求/响应详情
* 提供商注册状态
* 模型处理器信息

注意：在生产环境中请禁用调试日志，以避免性能影响和日志文件增长。

此插件在没有 WordPress 7.0 的情况下能用吗？

不需要。此插件需要 WordPress 7.0 或更高版本，因为它使用内置的连接器 API 来管理 API Key。

为什么建议数量和笔记数量有时不匹配？

使用评审笔记时，您可能会注意到 AI 返回的建议数量与编辑器中显示的笔记数量不完全匹配。

这是预期行为，有两个原因：

1. 多分类建议：部分 AI 模型会返回适用于多个评审分类的单一建议（如 review_type: "seo, accessibility"）。插件保持原样转发，因此在 WordPress AI Client 中，同一建议可能会出现在多个笔记分类下。

2. 模型响应格式：AI 模型控制其返回的建议数量，WordPress AI Client 决定如何显示和分类这些建议。插件正确转发模型的响应，不修改数量。

如果您需要更一致的结果，请考虑使用能可靠返回结构化 JSON（每个分类有独立建议）的模型。

如何找到我的 AI 提供商的 Base URL？

• Ollama（本地）：http://localhost:11434/v1
• LM Studio（本地）：http://localhost:1234/v1
• MiniMax：https://api.minimax.io/v1
• Moonshot：https://api.moonshot.ai/v1
• DeepSeek：https://api.deepseek.com/v1
• SiliconFlow：https://api.siliconflow.cn/v1
• 其他提供商：请查阅其文档

需要 API Key 吗？

部分提供商需要 API Key。对于不需要身份验证的本地安装（如 Ollama），您可以输入任意字符串（如 “not-required”）作为 API Key。

为什么本地推理/思考模型有时会超时？

在 Ollama 上运行的本地推理模型（如 Gemma 4、QwQ 等）会在生成最终答案之前产生长的”思考”链。这个过程可能需要 30-60 秒或更长时间，可能触发 cURL 的低速限制超时（默认 30 秒）。

云模型通常运行良好——大多数云 API 提供商（DeepSeek、MiniMax、Moonshot 等）响应迅速，不会出现超时问题。如果云模型频繁超时，可能是由于异常长的思考链——请尝试切换到其他模型。

本地模型推荐解决方案：

1. 本地 AI 功能请使用非推理模型。对于 Ollama，qwen2.5:7b、llama3.2:3b 或 phi3 等模型表现良好，不会遇到超时问题。

2. 配置 Ollama 保持模型加载：
   bash
export OLLAMA_KEEP_ALIVE=-1 # 保持模型在内存中

如果您使用的是推理模型，请注意 WordPress AI 功能可能会较慢或超时。思考行为由模型控制，不由插件控制。

如何使用本地 AI 提供商（如 Ollama 或 LM Studio）？

默认情况下，WordPress 出于安全考虑（SSRF 保护）会阻止向 localhost 和私有 IP 地址发送请求。如果您使用本地 AI 提供商，可以通过在 wp-config.php 中添加以下内容来禁用此保护：

define('DUETGAICON_ALLOW_LOCAL_URLS', true);

警告：禁用 SSRF 保护将允许向私有/本地 IP 发送请求。只有在您信任您的本地 AI 提供商、且您的服务器无法直接从互联网访问时，才应启用此功能。

此设置在使用本地 AI 提供商时同时适用于文本模型和图片模型。

提示：当启用 DUETGAICON_ALLOW_LOCAL_URLS 时，测试 AI 页面（工具 > 测试 AI）会出现网络连接测试工具。您可以用它来验证 WordPress 服务器是否能访问您的本地 AI 提供商，再运行实际的 AI 功能测试。这对调试本地 Ollama 或 LM Studio 的连接问题特别有用。

如何在代码中使用？

use WordPress\AiClient\AiClient;

$registry = AiClient::defaultRegistry();

// Text Generation
$model = $registry->getProviderModel('custom_text', 'gpt-4');
$result = $model->generateTextResult([
    new \WordPress\AiClient\Messages\DTO\UserMessage([
        new \WordPress\AiClient\Messages\DTO\MessagePart('Your prompt here')
    ])
]);
echo $result->toText();

// Image Generation
$model = $registry->getProviderModel('custom_image', 'dall-e-3');
$result = $model->generateImageResult([
    new \WordPress\AiClient\Messages\DTO\UserMessage([
        new \WordPress\AiClient\Messages\DTO\MessagePart('Your prompt here')
    ])
]);
$files = $result->toImageFiles();