docs(deploy): 记录测试服部署与实例配置变更

docs/testspace-config-changes.md

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