不只是回答问题
把「知道」和「做到」连起来，减少客户在页面之间来回找。
📚
知识库优先检索
中文 bigram + BM25 检索，回答前先查资料；带引用来源，找不到时不胡编。
🖱️
调用网站 JS 方法
跳转页面、加入购物车、发起结算。只能执行站点声明的动作，参数按类型校验，前端绝不 eval。
🔌
接入 MCP 工具
Streamable HTTP MCP：查订单、查库存、查物流。工具白名单与超时控制，失败不影响文本回答。
🗂️
会话与客户档案
按站点、访客标识、会话标识归档；同一浏览器复用访客 ID，支持历史消息与待人工标记。
🏷️
客户标记
VIP、高意向、售后问题等标签，在会话与客户列表里直接筛选、跟进与导出。
🛡️
可退化的回答引擎
可接 OpenAI 兼容大模型；未配置或调用失败时，自动用知识库摘录与关键词动作兜底。
一次对话怎么完成
检索、推理、工具调用、页面动作、回执，全链路可追踪。
STEP 01
客户提问
组件带上站点密钥、访客标识与会话标识发起请求。
STEP 02
检索知识库
按站点召回最相关资料块，作为回答依据与引用。
STEP 03
生成与调工具
模型可调用 MCP 工具查实时数据，并建议白名单动作。
STEP 04
页面执行并回执
网站执行注册的 JS 方法，组件回报结果，服务端记录会话。
跑起来
零前端构建，本地 SQLite 存储。
npm install
npm run dev
# 管理后台
http://localhost:8787/admin/
# 默认密码 admin123（请改 ADMIN_PASSWORD）
# 演示店铺（带商品、购物车与订单）
http://localhost:8787/demo/
# 生产构建
npm run build
npm start
嵌入客户网站
在管理后台创建站点，复制接入代码：
<script>window.KEFU_CONFIG = { siteKey: "kf_xxx" };</script>
<script async src="https://your-host/widget.js"></script>
- 在「知识库」录入商品、售后、物流等资料
- 在「站点与组件」配置 JS 动作与 MCP 服务
- 在「系统设置」填入大模型 API（可选）
- 客户会话会自动进入「会话记录」与「客户管理」