# 测试服实例配置变更记录（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 删除该句即可。