# Yehwang 客服知识库 (Customer Service Knowledge Base)

面向 **Chatwoot + ai-bridge + Twenty** AI 客服系统的知识库。内容为英文（客户群体为欧洲 B2B 零售商/店主，官方 FAQ 原文亦为英文），AI 在回复时按客户语言翻译即可。

## 内容来源（均为权威来源，非编造）

每个 md 文件都在 frontmatter 的 `source_url` 字段、以及正文标题下的「📎 来源 / Source」行里标注了**确切来源地址**，可点击核对/更新。汇总：

| 来源地址 | 对应文件 |
|---|---|
| https://www.yehwang.com/about-us.html | 00-about |
| https://www.yehwang.com/register.html | 00-about, 01-registration |
| https://www.yehwang.com/order.html | 02-ordering, 09-membership |
| https://www.yehwang.com/pre-order.html | 03-pre-order |
| https://www.yehwang.com/payment.html | 04-payment |
| https://www.yehwang.com/shipment.html | 05-shipping |
| https://www.yehwang.com/returns.html | 06-returns |
| https://www.yehwang.com/factory-direct.html | 07-factory-direct |
| https://www.yehwang.com/other-questions-1987986538 | 01-registration, 10-products |
| https://www.yehwang.com/membership-307802756 | 09-membership |
| https://dropshipping.yehwang.com/ · /about-us · /faq/{register,order,payment,shipment,returns} | 08-dropshipping |
| 数仓表 `wa_dim.dim_product_full` / `wa_dim.dim_user_full`（快照 2026-06-25） | 00-about, 09-membership, 10-products |
| 内部文档 `公司介绍.md.txt`（业务背景） | 00-about |

> 官网 FAQ 答案为 JS 折叠加载，用 Playwright 渲染后抓取；原始抓取数据存档于 `_source/`。

## 文件结构（一主题一文件，问答块切分，适配 RAG）

- `index.md` — 导航
- `00-about-yehwang.md` — 公司是谁、卖什么、两种履约模式
- `01-registration-account.md` — 注册 / 账号 / 找店 / 图片授权
- `02-ordering.md` — 下单 / 起订 €30 / 数量折扣 / 改单取消 / 优惠码
- `03-pre-order.md` — 预购规则
- `04-payment-vat-invoice.md` — 支付方式 / VAT / 发票
- `05-shipping-delivery.md` — PostNL/DHL 物流 / 运费 / 时效 / Brexit
- `06-returns-refunds.md` — 退换货 / 缺件 / 残次 / 定制品
- `07-factory-direct.md` — 工厂直发（中国直发全球）
- `08-dropshipping.md` — 一件代发（Shopify 接入）
- `09-membership-rewards.md` — 会员等级 / 阶梯量折扣 / 奖励
- `10-products-and-jewelry-care.md` — 品类盘 / 价格带 / 材质 / 珠宝护理

## 给 ai-bridge 的接入建议

1. **切块**：每个 `### Q:` 问答块作为一个 chunk（已天然分段）。frontmatter 里的 `keywords` 可并入 embedding 文本提升召回。
2. **向量化**：数仓 `.env.local` 已含 `DASHSCOPE_API_KEY`（`text-embedding-v3`，多语言），可直接复用，对欧洲多语种问法召回友好。
3. **system prompt 约束**：要求 AI 仅依据知识库作答；涉及金额/时效/政策时引用具体条款；无法回答时转人工（`helpdesk@yehwang.com` / `service@yehwang.com`）。
4. **联系方式**：自营/网站业务 `helpdesk@yehwang.com`、电话 `+31 318 668 171`；工厂直发 `service@yehwang.com`。

## 维护

- 政策类内容随官网 FAQ 变化需同步；商品/等级类数据可定期从数仓刷新（脚本见 `scratchpad` 或重跑聚合）。
- 标 `⚠️ 待核对` 的条目为需业务确认后补全的细节（如各国运费表、各国 VAT 税率表）。

_最后更新：2026-06-25_