41 lines
2.4 KiB
Markdown
41 lines
2.4 KiB
Markdown
# 测试服实例配置变更记录（2026-10-29 / 10-30）
|
||
|
||
> 实例：测试服 47.76.223.252 `https://wangliang-crm.dev.gaia888.com`（LibreDesk v2.9.1）
|
||
> 代码仓库：www 前端改动已推 `yehwang/storefront-web` 分支 `feature-20261030-libredesk-widget`
|
||
> 本文记录的是**数据库/实例配置**变更（不在代码仓库里，随实例数据保存）。
|
||
|
||
## 1. www 前端 widget 集成（代码）
|
||
|
||
`/data/dev/wangliang/eu-store-front-web`：
|
||
|
||
- 新增 `plugins/libredesk.client.js`：`window.LibredeskSettings = { baseURL, inboxID }` + 动态加载 `{baseURL}/widget.js`，全站加载、匿名访客。
|
||
- `nuxt.config.js`：暴露 `LIBREDESK_BASE_URL` / `LIBREDESK_INBOX_ID`，注册插件。
|
||
- `.env`（不入库）：`LIBREDESK_BASE_URL=https://wangliang-crm.dev.gaia888.com`、`LIBREDESK_INBOX_ID=81b679b0-33fb-4796-9f83-dcc0f43231cc`。
|
||
- 运行方式：`yarn build` 后 `PORT=3015 NODE_ENV=production yarn start`（构建时注入 env，改 .env 后必须重新 build）。
|
||
- 已提交：`ec123c4b feat(widget): 集成 LibreDesk 客服 widget`（分支 `feature-20261030-libredesk-widget`）。
|
||
|
||
## 2. livechat inbox 配置（DB：inboxes.config）
|
||
|
||
| 字段 | 值 |
|
||
| --- | --- |
|
||
| `trusted_domains` | 新增 `wangliang-www.dev.gaia888.com`（CSP `frame-ancestors` 白名单，缺了会导致 widget iframe 被浏览器拒绝、看不到按钮） |
|
||
| `brand_name` | `Yehwang` |
|
||
| `greeting_message` | `Hi! How can we help you today?` |
|
||
| `chat_introduction` | `Ask about products, orders, shipping or returns.` |
|
||
|
||
影响：widget 首页标题/欢迎语/副标题；trusted_domains 决定哪些站点能嵌入 widget。
|
||
|
||
## 3. AI assistant 指令（DB：ai_assistants.instructions）
|
||
|
||
在 `Yehwang Assistant` instructions 末尾追加一条规则：
|
||
|
||
> When the customer greets you (e.g. hi / hello / 你好), reply exactly with: "Hi! How can we help you today? Welcome to Yehwang — ask about products, orders, shipping or returns." Do not add or change anything else in that greeting.
|
||
|
||
效果：客户发 `hi` 时 AI 回复该固定话术（实测一致）。仍由模型生成，规则约束输出。
|
||
|
||
## 4. 回滚方式
|
||
|
||
- 前端代码：`git checkout main`（或 revert `ec123c4b`）后重新 `yarn build` + 重启。
|
||
- inbox 配置：后台 Inbox → Widget 改回，或 `update inboxes set config = config || '{"trusted_domains": [...]}' ...`。
|
||
- AI 规则：后台 AI Assistant → Instructions 删除该句即可。
|