From a7a500ecb0f1f7c030fed040940ca5b9b94588dc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=B5=85=E5=BF=B5?= Date: Tue, 29 Sep 2026 11:56:18 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E7=AC=AC=E4=B8=89=E8=BD=AE=E5=AE=A1?= =?UTF-8?q?=E6=9F=A5=E8=A1=A5=E5=85=85=E2=80=94=E2=80=94=E5=AE=98=E7=BD=91?= =?UTF-8?q?=E5=B5=8C=E5=85=A5=E4=BA=A4=E4=BB=98=E3=80=81=E7=9C=9F=E4=BA=BA?= =?UTF-8?q?=E9=AA=8C=E6=94=B6=E6=B8=85=E5=8D=95=E3=80=81=E4=BA=8B=E5=AE=9E?= =?UTF-8?q?=E5=8D=A1=E5=AE=A1=E6=A0=B8=E5=85=B3=E5=8D=A1=E3=80=81=E4=B8=8A?= =?UTF-8?q?=E7=BA=BF=E8=A7=82=E5=AF=9F=E6=9C=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Code --- ...09-29-building-materials-ai-kefu-design.md | 36 ++++++++++++++++--- 1 file changed, 32 insertions(+), 4 deletions(-) diff --git a/docs/superpowers/specs/2026-09-29-building-materials-ai-kefu-design.md b/docs/superpowers/specs/2026-09-29-building-materials-ai-kefu-design.md index b99a7a7..f2fe6be 100644 --- a/docs/superpowers/specs/2026-09-29-building-materials-ai-kefu-design.md +++ b/docs/superpowers/specs/2026-09-29-building-materials-ai-kefu-design.md @@ -77,6 +77,9 @@ CLAUDE.md 记录上游项目路径与 changelog 目录，维护时对照。 - **只收录可验证硬事实**，WordPress 模板化填充内容（物流/客服段落）一律不收 - **不含**：价格、交期、产能硬数据、MOQ——未知一律走"转客户经理"兜底 - 防编造原则（统一兜底/不扩展）原样保留 +- **审核关卡（必经步骤）**：事实卡初稿完成后，需求方业务侧（懂管道产品的人） + 逐条过目确认，审核通过才可上线——AI 说的每句公司情况都来自这张卡，卡错则 + AI 一本正经说错话 ### 4.3 `extractor.md`（信息提取字段） 中文键画像字段改建材语义： @@ -137,7 +140,7 @@ CLAUDE.md 记录上游项目路径与 changelog 目录，维护时对照。 | LLM | 智谱 GLM（glm-4-flash），Key 复用或新建均可 | | 端口 | 8017（汽车项目 8016 旁） | | 域名 | 实施时需求方提供（如 ai.hesupipe.com） | -| 前端联系 | WhatsApp `+8615937108317`（官网主号码）、邮箱 `hesu@hesuu.com`（备选号 15890151617，实施时确认） | +| 前端联系 | WhatsApp 与邮箱默认值见 §11（实施时需求方确认） | **开发期安全流程（漏洞 2 修订）**：开发与验收阶段 `PUSH_ENABLED=false` + `scripts/mock_uniservice.py` 本地联调 + NOTIFY_EMAIL 指测试邮箱； @@ -156,16 +159,40 @@ CLAUDE.md 记录上游项目路径与 changelog 目录，维护时对照。 - **GDPR（第二轮深挖新增项）**：挂件首次对话前加一行 "By chatting, you agree to our privacy policy"（隐私政策页放 hesupipe.com， WordPress 侧）；上线前完成，不阻塞开发 +- **官网嵌入交付（第三轮补充，必交付物）**：产出一段可直接粘贴的挂件嵌入代码 + （script 标签 + data-* 配置示例）+ 给官网管理员的一页接入说明 + （贴在哪、怎么配主题色/位置/WhatsApp 号）。系统做完≠有人用——官网不挂上去， + 买家看不到，等于白做 ## 9. 测试策略 +### 9.1 自动化测试（LLM 全 mock，验证代码正确性） + 1. 全量拷贝 170+ 测试 → 更新含文案断言的用例（HESU/VOLT/车型示例 → HESUPIPE/管材场景） 2. **多语言墙专项**：西语/俄语价格句必须拦截；DN800/PN16/SDR11/SCH40/ ISO4427/20ft 规格形态不得误杀；"USD 1200/ton"、"$500/ton"、€ 报价必须拦截 3. **阿语数字提取**：٠١٢٣٤٥٦٧٨٩ 形式号码提取并转 ASCII -4. extractor 建材字段提取用例；语言跟随冒烟用例 -5. `pytest` 全绿 + `widget-test.html` 手动验收 + mock_uniservice 联调验收 +4. extractor 建材字段提取用例 +5. `pytest` 全绿 + `widget-test.html` 挂件手动验收 + mock_uniservice 联调验收 + +### 9.2 真人验收（真实 LLM，验证 AI 表现——mock 测不了这些） + +pytest 全绿只证明代码没写错，不证明 AI 聊得好。上线前用真 Key 实聊验收清单 +（参考汽车项目 `docs/test-checklist.md` 改写）： + +- 英文问价 / 西语问价 / 问 MOQ / 要样品 / 问交期 / 问认证 → 一律不正面回答， + 引导留资，回复语言跟随客户 +- 客户留电话 → 画像更新、触发邮件（测试邮箱）+ mock 推送 +- 客户中途换号码 → 更正邮件触发、不重复轰炸 +- 已留资后再问价 → 不再索要联系方式 +- 建材规格聊天（DN110 PN16 之类）→ 不误杀、正常聊 +- 管理后台能看到上述会话、画像 chips、意向分级、推送日志 + +### 9.3 上线观察期（第一周） + +上线不是终点。第一周跑 `scripts/breach_rate.py`（同步多语言词表后）观测： +漏放的价格形态、误杀的规格数字，发现即补正则。参考项目当年也是逐圈修出来的。 ## 10. 风险登记 @@ -175,6 +202,7 @@ CLAUDE.md 记录上游项目路径与 changelog 目录，维护时对照。 | 事实卡收录模板化内容导致编造 | 中 | §4.2 只收硬事实 + 人工审核事实卡 | | GDPR 欧洲合规 | 低 | §8 隐私提示；不阻塞 | | 双项目长期同步代价 | 低 | CLAUDE.md 记录血缘；changelog 对照 | +| 与汽车项目共用智谱 Key/SMTP 额度 | 低 | 现量小无碍；某一方爆量时再拆分独立账号 | | glm-4-flash 多语言提取/评估退化 | 低 | 测试覆盖；必要时升级模型 | ## 11. 需求方提供的凭据/资源（实施时） @@ -185,6 +213,6 @@ CLAUDE.md 记录上游项目路径与 changelog 目录，维护时对照。 | SMTP 账号密码 | 复用参考项目 .env | | UniService API Key | 复用参考项目 .env（同一 CRM 账号） | | NOTIFY_EMAIL | 管道业务询盘收件邮箱（需求方指定） | -| WhatsApp 号码二选一 | 15937108317 / 15890151617 | +| WhatsApp 号码二选一 | 15937108317（官网主号码）/ 15890151617；邮箱 hesu@hesuu.com | | 客服头像图 | HESUPIPE logo 或管道主题图 | | 部署域名 + 服务器 | 如 ai.hesupipe.com |