libredesk/docs/testspace-config-changes.md

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