小栈AI综合助手 — 安装使用说明

版本：3.0.0 | 适用于 PHP 8.0 ~ 8.3 | WordPress 6.0+

---

一、环境要求

项目	最低要求
PHP	8.0 及以上
WordPress	6.0 及以上
SourceGuardian Loader	16.0.2 及以上（必须）

---

二、安装 SourceGuardian Loader（关键步骤）

插件核心代码使用 SourceGuardian 16 加密保护，PHP 必须加载 SG Loader 扩展才能运行，否则会提示 “未安装 SourceGuardian Loader” 并无法使用。

2.1 检查是否已安装

进入 WordPress 后台 → 工具 → 站点健康 → 信息 → 找到 PHP 扩展列表，搜索 SourceGuardian。如果有，说明已安装，跳过下面步骤。

也可以上传一个 phpinfo.php 文件到网站根目录，内容如下：

<?php phpinfo(); ?>

访问后 Ctrl+F 搜索 SourceGuardian，如果看到 SourceGuardian Loader Support => enabled 即为已安装。

2.2 宝塔面板安装（推荐）

宝塔面板已内置 SG Loader，一键安装即可。

1. 进入宝塔面板 → 软件商店
2. 找到正在使用的 PHP 版本（如 PHP 8.2）
3. 点击「设置」→「安装扩展」
4. 找到 SourceGuardian → 点击「安装」
5. 等待安装完成后，务必继续看 2.3 节配置！

2.3 重要：添加 Hybrid VM 配置（必做！）

安装扩展后，还需要在 php.ini 中添加一行配置，否则加密文件无法解密运行。

操作步骤：

1. 宝塔面板 → 软件商店 → PHP → 设置 → 配置文件
2. 拉到文件最底部，另起一行粘贴：

sourceguardian.enable_vm_hybrid=1

3. 保存 → 重启 PHP

注意：php.ini 有两份（CLI 命令行和 FPM Web 服务），宝塔面板的「配置文件」修改的是 FPM 版本。如果你的网站使用 CLI 模式运行 PHP 任务，也需要在 /www/server/php/XX/etc/php-cli.ini 中加同样一行。

2.4 手动安装（非宝塔环境）

如果未使用宝塔面板，按以下步骤操作：

第一步：下载 Loader

访问 SourceGuardian 官方下载页：

https://www.sourceguardian.com/loaders/download.php

根据你的 PHP 版本、操作系统、线程安全类型选择对应的 Loader 文件。文件名格式为：

ixed.8.x.lin    （Linux 64位）
ixed.8.x.win    （Windows 64位）

第二步：放置文件

将下载的文件放到 PHP 扩展目录（通过 php -i | grep extension_dir 查看路径）。

第三步：编辑 php.ini

在 php.ini 末尾添加：

extension=ixed.8.2.lin    ; 文件名根据实际下载的文件名填写
sourceguardian.enable_vm_hybrid=1

第四步：重启 PHP 服务

# 宝塔
/etc/init.d/php-fpm-82 restart

# 通用
systemctl restart php8.2-fpm

---

三、安装插件

1. WordPress 后台 → 插件 → 安装插件 → 上传插件
2. 上传 xzdbk-ai.zip
3. 点击「现在安装」
4. 安装完成后点击「启用」

插件启用后，左侧菜单会出现「小栈AI」入口。

---

四、激活授权

1. 进入「小栈AI」→「授权管理」
2. 输入授权码
3. 点击「激活」

未激活状态下部分功能受限。

---

五、常见问题

Q1：启用插件后网站白屏 / 500 错误

几乎都是 SourceGuardian 配置问题，请逐项检查：

1. 确认 SG 扩展已安装：php -m | grep SourceGuardian 有输出
2. 确认 php.ini 中已添加 sourceguardian.enable_vm_hybrid=1 ← 90% 的问题都是这个
3. 确认添加后已重启 PHP
4. 如果使用宝塔，确认修改的是正确 PHP 版本的配置文件

开启 WordPress 调试模式查看更多错误信息：

在 wp-config.php 中添加：

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', true);

错误信息会写入 wp-content/debug.log，可以查看具体原因。

Q2：PHP 8.3 网站偶尔 502 错误

PHP 8.3 + SourceGuardian Loader 16.0.2 存在已知兼容性问题，可能导致 PHP 工作进程偶发崩溃。解决方案：

在 PHP-FPM 配置文件中添加进程回收机制。

宝塔路径：软件商店 → PHP 8.3 → 设置 → 配置文件 → 找到 pm.max_requests 行（如没有则在末尾添加）：

pm.max_requests = 500

保存并重启 PHP。这会让每个工作进程处理 500 个请求后自动重启，避免内存问题累积导致崩溃。

Q3：提示“运行错误[19]：Loader版本过旧”

你的 SourceGuardian Loader 版本低于加密时使用的版本。前往官网下载最新版 Loader：

https://www.sourceguardian.com/loaders/download.php

Q4：重新安装或迁移网站后插件无法使用

1. 检查新服务器的 PHP 版本是否 ≥ 8.0
2. 重新安装 SourceGuardian Loader
3. 重新添加 sourceguardian.enable_vm_hybrid=1
4. 使用授权码重新激活

---

六、版本信息

项目	版本/值
插件版本	3.0.0
加密方案	SourceGuardian 16
Loader 最低版本	16.0.2
兼容 PHP	8.0 / 8.1 / 8.2 / 8.3
兼容 WP	6.0+

---

七、注意事项

1. 插件文件受版权保护，禁止反编译、破解或二次分发
2. 更换域名或服务器前，请先在后台解绑授权，迁移后重新激活
3. PHP 8.3 用户建议配置 pm.max_requests = 500 参数
4. 授权码与域名绑定，一个授权码仅限一个站点使用