WordPress 開放 AI 存取方案研究

一、重點摘要

二、各方案詳細評估

// 自訂 must-use plugin（wp-content/mu-plugins/ai-elementor-access.php）
register_rest_route('ai-kunhang/v1', '/update-widget', [
    'methods'  => 'POST',
    'callback' => 'ai_update_elementor_widget',
    'permission_callback' => function() {
        // 只允許特定自訂能力
        return current_user_can('ai_edit_widgets');
    },
    'args' => [
        'page_id'   => ['required' => true, 'type' => 'integer'],
        'widget_id' => ['required' => true, 'type' => 'string'],  // Elementor widget ID
        'html'      => ['required' => true, 'type' => 'string'],  // 新 HTML 內容
    ],
]);

# 透過 SSH 遠端執行 WP-CLI
ssh user@kunhang.com.tw "wp post update 123 --post_content='<new content>'"

三、管制措施詳解

3.1 最小權限原則

// 在 mu-plugin 或 functions.php 中建立專用角色
function create_ai_agent_role() {
    add_role('ai_agent', 'AI Agent', [
        'read' => true,
        // 只給能修改頁面的最小能力
        'edit_pages' => true,
        'edit_published_pages' => true,
        // 明確不給的能力
        'publish_pages' => false,  // 不能直接發佈
        'install_plugins' => false,
        'manage_options' => false,
        'delete_pages' => false,
    ]);
    // 加入自訂能力
    $role = get_role('ai_agent');
    $role->add_cap('ai_edit_widgets');
}
add_action('init', 'create_ai_agent_role');

3.2 只允許改特定 Elementor Widget

// 在自訂 endpoint 中限制可操作的頁面
const ALLOWED_PAGE_IDS = [123, 456, 789];  // kunhang 網站的特定頁面 ID

function ai_update_elementor_widget(WP_REST_Request $request) {
    $page_id = $request->get_param('page_id');

    // 白名單檢查
    if (!in_array($page_id, ALLOWED_PAGE_IDS)) {
        return new WP_Error('forbidden', '此頁面不在允許修改清單中', ['status' => 403]);
    }

    // 建立修改前的 revision（備份）
    wp_save_post_revision($page_id);

    // 修改指定 widget 的 HTML
    $elementor_data = get_post_meta($page_id, '_elementor_data', true);
    $data = json_decode($elementor_data, true);

    $widget_id = $request->get_param('widget_id');
    $new_html  = wp_kses_post($request->get_param('html'));  // 清洗 HTML

    // 遞迴找到 widget 並更新
    $updated = update_widget_in_tree($data, $widget_id, $new_html);

    if (!$updated) {
        return new WP_Error('not_found', '找不到指定的 widget ID', ['status' => 404]);
    }

    // 儲存更新（狀態改為 pending review，不直接 publish）
    update_post_meta($page_id, '_elementor_data', wp_slash(json_encode($data)));
    wp_update_post(['ID' => $page_id, 'post_status' => 'pending']);

    // 記錄操作日誌
    ai_log_operation($page_id, $widget_id, get_current_user_id());

    return ['success' => true, 'message' => '修改已儲存為待審核狀態'];
}

3.3 備份和回滾機制

三層備份策略

Elementor 快取刷新（每次修改後必做）：

POST /wp-json/neoservice/v1/flush-css

或透過 WP-CLI：

wp elementor flush-css

3.4 IP 白名單

方法一：Cloudflare WAF Rules（推薦，因 kunhang.com.tw 已用 Cloudflare）

Cloudflare Dashboard → Security → WAF → Custom Rules：

(http.request.uri.path contains "/wp-json/ai-kunhang/")
AND
(not ip.src in {你的Hetzner伺服器IP/32 Claude雲端IP/32})

→ 動作：Block

方法二：.htaccess（Apache）

<LocationMatch "^/wp-json/ai-kunhang/">
    Order Deny,Allow
    Deny from all
    Allow from 195.x.x.x  # Hetzner Claude 伺服器 IP
</LocationMatch>

方法三：mu-plugin 層 IP 檢查

add_filter('rest_authentication_errors', function($result) {
    if (strpos($_SERVER['REQUEST_URI'], '/ai-kunhang/') !== false) {
        $allowed_ips = ['195.x.x.x'];  // Hetzner IP
        $client_ip = $_SERVER['HTTP_CF_CONNECTING_IP'] ?? $_SERVER['REMOTE_ADDR'];
        if (!in_array($client_ip, $allowed_ips)) {
            return new WP_Error('ip_blocked', '不允許的 IP', ['status' => 403]);
        }
    }
    return $result;
});

3.5 操作日誌 / 審計

function ai_log_operation($page_id, $widget_id, $user_id) {
    $log_entry = [
        'time'      => current_time('mysql'),
        'user_id'   => $user_id,
        'page_id'   => $page_id,
        'widget_id' => $widget_id,
        'ip'        => $_SERVER['HTTP_CF_CONNECTING_IP'] ?? $_SERVER['REMOTE_ADDR'],
    ];
    // 寫入自訂 table 或 option（短期快取）
    $logs = get_option('ai_operation_logs', []);
    array_unshift($logs, $log_entry);
    $logs = array_slice($logs, 0, 100);  // 保留最近 100 筆
    update_option('ai_operation_logs', $logs);
}

3.6 雙重確認機制（AI 改完要人工確認才上線）

工作流程設計：

function notify_admin_for_review($page_id, $widget_id) {
    $preview_url = get_preview_post_link($page_id);
    $message = "AI 已更新頁面 #{$page_id} 的 widget {$widget_id}，請審核後發佈：{$preview_url}";

    wp_remote_post(DISCORD_WEBHOOK_URL, [
        'body' => json_encode(['content' => $message]),
        'headers' => ['Content-Type' => 'application/json'],
    ]);
}

四、推薦方案與實作路線圖

實作優先順序

風險矩陣總覽

五、給 kunhang.com.tw 的具體建議

• 1
  短期（今天可做）：Cloudflare WAF Rule

  在 Cloudflare 建立 WAF Rule，把 /wp-json/ 路徑限制只允許特定 IP 存取（Hetzner Claude 伺服器 IP），立即降低外部攻擊風險。
• 2
  中期（這週）：建立 ai_agent 角色 + Application Password

  建立專用 ai_agent 角色 + Application Password，開始用標準 REST API 測試 Elementor 頁面修改流程，確認 JSON 格式正確後再自動化。
• 3
  長期（有空時）：自訂 mu-plugin

  撰寫自訂 mu-plugin，限縮到只能改指定頁面的指定 widget，加上 Discord 通知 + 人工確認門。
• 4
  評估安裝 elementor-mcp-api

  如果覺得自訂 mu-plugin 維護麻煩，這個外掛提供現成的 widget 級別操作介面，程式碼開源可審查（GPL-3.0）。

六、參考資源

• WordPress MCP Security Guide
• WordPress REST API Security Hardening
• elementor-mcp-api GitHub（bvisible）
• elementor-mcp GitHub（msrbuilds）
• WordPress MCP Adapter 官方文件
• WordPress Application Passwords 官方文件
• WordPress REST API Capability Restriction
• Cloudflare WAF Rules for WordPress
• WordPress 7.0 AI Agent Infrastructure Security