docs: 第三轮审查补充——官网嵌入交付、真人验收清单、事实卡审核关卡、上线观察期
Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
@@ -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 |
|
||||
|
||||
Reference in New Issue
Block a user