1. 快速接入

登录后进入「概览 → 添加网站」，填写网站名称和域名。保存后会得到一行脚本，把它放在网站每个页面的底部（一般在 footer 模板里），客服按钮就会出现在网页右侧。

<script src="https://kf.sy555.cn/widget/w.js" data-key="你的网站key" async></script>

脚本地址是固定的 /widget/w.js。官网更新代码后，会自动加载新代码，不需要修改已投放的代码。

WordPress 可以写在主题的 functions.php：

add_action('wp_footer', function () {
    echo '<script src="https://kf.sy555.cn/widget/w.js" data-key="你的网站key" async></script>';
});

2. 域名校验

挂件请求会带上页面来源域名。服务端会把它和你在后台填写的域名对比，只接受完全匹配或子域名。比如填写 baidu.com，www.baidu.com 也可以使用。

本地调试时，localhost 和 127.0.0.1 始终放行。上线前请确认后台域名与真实域名一致，否则挂件不会加载。

3. 配置 AI 精灵

在站点详情的「AI 精灵」区域打开开关，选择形象、写性格、填问答。本地引擎不需要任何外部服务，完全在服务器内匹配问答；如果希望回答更灵活，可以选 DeepSeek，并填入对应的 API Key 和模型名。

问答建议一行问题、一行答案：

问 网站叫什么？
答 AI精灵客服，提供网页在线客服与 AI 接待。

问 你叫什么名字？
答 我是小语，你的 AI 精灵客服。

问 联系方式
答 电话 400-800-0000，邮箱 service@example.com。

问 价格
答 基础版免费7天，旗舰版 29 元/年。

问 产品详情
答 一行代码接入网页客服，AI 与人工自由切换。

问题写得越接近访客的口语，命中率越高。回答里可以用 {name} 和 {site} 占位符。

4. 接待与转人工

访客默认由 AI 精灵接待。你打开「会话记录」后，发送任意回复会自动把会话切到人工；也可以点击「交给 AI」重新交给精灵。会话结束后访客再次发言会重新排队。

所有会话按站点隔离，客服账号只能看到自己的站点。未读数量会显示在导航和站点卡片上。

5. 充值与套餐

登录后，点击余额与套餐进行充值与购买，如果没到账，可以提交工单咨询。

套餐按「站点数 + 有效期」计算，购买后 sites_limit 提升到套餐上限，有效期在原到期时间上累加。邀请返利按订单金额的固定比例进入邀请人返利余额，可用于提现，不可购买套餐。

6. 更新日志

2026-11-01 · v1.0.1

• 套餐调整为按年计费：基础版 ¥9 元/ 年、专业版 ¥19 元/ 年、旗舰版 ¥29 元/ 年，价格已同步。
• 首页与价格页的购买按钮统一跳转到「余额与套餐」，未登录时先跳转登录，不再出现点击后退出登录的问题。
• 账号登录有效期调整为 24 小时，超时自动退出。
• 新增首页公告弹窗开关：默认关闭，开启后仅在首页弹出，点击「我知道了」关闭；保存新公告前不再重复显示。
• 新增屏蔽词功能，命中屏蔽词的问题统一提示无法回答。
• 新增邮件日志，可查看验证码与续费邮件内容、发送时间和发送成功/失败状态。
• 登录页新增找回密码入口，通过注册邮箱验证码重置密码。
• 新增邀请返利提现申请。
• 聊天记录默认保留 90 天。
• 自定义精灵头像支持选择裁剪区域，保存后立即生效，无需刷新。
• 全站图片上传上限统一为 5MB；仅自定义精灵头像支持拖动、缩放裁剪，工单与提现图片直接预览上传；大图会自动压缩后上传。
• 挂件欢迎气泡每次刷新都会提示；AI 或人工回复后，右下角按钮显示红色未读条数。
• 手机端挂件固定右下角，侧栏导航改为每行两个；登录后头部改为「控制台 / 退出」。
• 修复手机端页面适配、工单中心布局、底部导航等问题。
• 取消访客超时自动结束会话，会话仅由客服手动结束。

常见问题

挂件不显示怎么办？

先在浏览器控制台看是否有报错；再确认脚本地址可访问、key 正确、站点域名填写一致。如果网站有严格 CSP，需要允许加载本站的脚本。

换了域名要重新接入吗？

脚本不用换，只要到后台把站点域名改成新域名即可，Key 保持不变。

AI 答非所问？

优先增加问答条目，并在性格里说明回答边界。云端引擎的温度固定较低，若仍不稳定，可以把模型换成更擅长中文客服的版本。

手机端客服窗挡住了内容？

可以点击右上角最小化，最小化后只保留右下角按钮。