客户报「几室几厅 + 多少平」时：直接在搜索框输入平方数（如 113），自动调出该平方附近的方案；也可用下面平方区间/风格筛。找到后把该方案文件夹里整套图发客户。809 张已上 R2 公网（前缀 docs/避坑资料/5-装修效果图/），链接可直接发客户；本机副本在 ~/Downloads/装修避坑资料/5-装修效果图/。要单张直链：在 Akke 仓查 scripts/r2/manifest.json 的 url 字段。
客户想看某个空间（厨房/卧室/衣柜/阳台…）或某种风格的效果图时用。点开看封面 + 该套张数和路径，把整套发客户。共 11252 张（另有等量缩略图），已全部上 R2。看图挑图走图集站：upio.ai/akke/xiaoguotu（32 个分类，点开即大图，链接可直接发客户）。⚠️ 对外只用 xiaoguotu/v2/… 链接，老路径含素材来源店名，别外发。
知识图集 = 一张张干货图（厨房布局尺寸/定制衣柜/开关插座/家电尺寸/避坑清单…），客户要"清单/参考图"时按主题搜、整套发。726 张（117 个主题）已上 R2，全部带「有大有小」品牌水印，链接可直接发客户。前缀 images/知识图集v2/<主题>/NNNN.jpg，按主题挑图走图集站：upio.ai/akke/zhishi（15 个内容主题:卫生间/厨房/水电/开关插座/尺寸/材料/避坑清单…）。单张直链查 Akke 仓 scripts/r2/zhishi-catalog.json。⚠️ 对外只用 v2：旧前缀 images/知识图集/ 是无水印裸图、文件名还带素材来源店名，别外发。
有大有小原创图文
重写自源料 · 我方版式带 logo · 零版权风险，可直接发客户每篇 = 一段可直接发的精要 + A4 PDF + 6 张图文卡。点缩略图看大图。
▸ 原始资料（内部参考，第三方版权文件，勿直接转发客户）
全部文档资料（PDF/Excel/Word），家装宝典 + 避坑全流程合集 + 避坑手册等。搜名字或按来源筛。
这一页给 夏夏评估 用：现在建成了什么、要做的自动化链路长什么样、有没有更好的方案、以及推演出来的坑。
一、现状：建成了什么
| 资产 | 规模 | 状态 |
|---|---|---|
| 场景话术（真实数据驱动） | 27 条 | ✅ 已建（挖 26 万条评论 + 718 条私信提炼） |
| 文档资料 + 精简说明 | 314 份 / 594MB | ✅ 每份都有「精要文字」；314 份全部已上云 |
| 装修方案图（按平方） | 49 套 / 809 张 / 406MB | ✅ 已索引（平方智能调取）；✅ 已上云 |
| 效果图库（空间/风格） | 11252 张 + 等量缩略图 / 19GB | ✅ 已索引；✅ 已上云（含品牌水印） |
| 知识图集 | 117 组 / 726 张 / 327MB | ✅ 已索引；✅ 已上云 |
二、目标链路
用户发消息（"求个避坑指南"） ↓ ① 关键词/意图匹配 ← 【核心缺口·要新建】 ↓ ② 云电脑浏览器自动发【精要信息】（纯文字·不带链接 ⚠️） ↓ ③ 对方认可 ↓ ④ 要对方微信（不发我方微信号 ⚠️） ↓ ⑤ 企业微信加上好友 ↓ ⑥ 发【对应文档资料】（链接/文件） ↓ ⑦ 后续回复 → 企微自动代回
零件盘点：多数已有，缺中间一层
| 环节 | 现状 |
|---|---|
| 抖音 DM 捕获 + 自动回复（云电脑 DOM 通道） | ✅ 已有 |
| 知识库内容（精要 + 链接） | ✅ 已有 |
| 加微信 CTA / 4 轮硬门 / 资料钩模板池 | ✅ 已有 |
| 企微自动代回（wecom_reply_loop） | ✅ 已有 |
| 关键词 → 对应资料 的匹配层 | ❌ 要新建（核心） |
| 投递状态机（防重发/回收转化） | ❌ 要新建 |
knowledge_articles 是死表，没有任何代码读它）三、方案 v2（推演后改进版）
原始 v1 设计是「词典 + LLM 兜底 → 全自动发 → 认可后要微信 → 改 llm.ts 挂进管线」。推演后有 4 处实质改进：
匹配层：两层 → 三层，加向量检索
真实客户话极口语（"求个辟坑手册师傅谢谢"、"我看看清单就行"），纯词典漏接率高。而 Supabase migrations 里已预留 embedding vector(1536) 注释列（pgvector）——白捡的能力。
→ L1 词典（精确·零成本） + L2 向量（语义兜底） + L3 LLM（仲裁消歧）
精要文案：罐头 + LLM 轻改写（不是纯罐头轮换）
纯罐头 = 高频雷同文案 → 抖音限流风险。原方案"备 2-3 个变体"只是治标。
→ 罐头内容（保准确）+ LLM 按当前对话轻改写（保多样），天然千人千面。护栏：改写后校验关键数字未被篡改。
要微信时机：按意向强度分层，不是一刀切"认可信号"
真实数据里「只报平方就问价」9786 条是最强意向信号——这种人应当直接要微信，别再多绕一轮（每多一轮多一次流失）。
→ 强意向（报平方/预算/户型）→ 精要 + 直接要微信；泛意向（"求份资料"）→ 先发精要建信任 → 认可后再要。
架构：改成旁路服务，不侵入 llm.ts ⭐
原方案要改 src/lib/llm.ts——高危路径、影响全部 DM、必须走 PR、坏了牵一发动全身。
→ 独立 kb-delivery 模块：poll agent 先问它「这条要不要发罐头」，返回 null 就走原 LLM 管线。零侵入高危路径 · 独立开关 · 独立灰度 · 坏了不影响主 DM。
四、推演：拿真实客户原话走一遍，暴露 4 个漏洞
| # | 推演场景（真实原话） | 暴露的问题 | 对策 |
|---|---|---|---|
| 1 | "113平三室多少钱" | 命中"报价"，但该发的是话术+效果图，不是文档 | 条目分 type（文档/场景/图集），按 type 决定发什么 |
| 2 | "我家那个坑爹装修公司" | 含"坑" → 误命中「避坑指南」，把抱怨当索取！ | ⭐ 必须「主题 × 索取意图」双命中（求/要/发我/有没有）才发罐头。只看主题词必然误伤 |
| 3 | "板材环保吗，我家有小孩" → 追问"ENF和E0差多少" | 发完精要不该立刻要微信，该继续答 | 精要发完进入正常对话，加微信由意向信号触发 |
| 4 | 客户多轮里反复提"避坑" | 重复发同一罐头 | kb_deliveries 唯一约束：同会话同条目只发一次 |
五、全自动的安全护栏（已选全自动 → 必须有）
| 情况 | 动作 |
|---|---|
| L1 词典命中 + 索取意图 | ✅ 自动发精要 |
| L2 向量 / L3 LLM 高置信 | ✅ 自动发精要 |
| 低置信 / 无命中 / 无索取意图 | ⛔ 不发罐头，静默退回现有话术 |
另配：kill switch（一键停）· 灰度 1 个账号 · 每日上限 · 防重发 · 全量留痕（发错能回溯调词典）。
六、⚠️ 抖音风控红线（不可越）
- 抖音私信绝不发外链（限流/封号）→ 精要只发纯文字，链接只在企微发
- 绝不发我方微信号（现有代码已如此）→ 只能问对方要微信，我们企微去加
- 避免高频雷同文案 → 靠「罐头 + LLM 轻改写」（改进 2）
七、分阶段落地
| 阶段 | 内容 | 验收 |
|---|---|---|
| P0 | 建表 + 导入知识库 + 匹配器（主题×意图 三层） | 拿 26 万条真实评论离线回测，量化命中率/误命中率 |
| P1 | 旁路服务挂上，灰度 1 个账号自动发精要 | 一周无误发、加微转化有提升 |
| P2 | 意向分层 → 要微信 → 微信号回填 → 企微待加队列 | 闭环到企微 |
| P3 | 企微侧自动发资料 | 端到端跑通 |
| P4 | 转化回收：哪条精要勾微信最强 | 数据驱动迭代词典/文案 |
八、请夏夏重点评估的开放问题
- 「主题 × 意图」双命中够不够防误发？还有没有别的误命中模式（推演 2）
- 旁路服务 vs 改 llm.ts——旁路真能拿到足够上下文吗？会不会和现有 LLM 话术打架/重复发
- 意向分层要微信——强意向直接要微信，会不会太急把人吓跑？阈值怎么定
- 抖音风控——自动发中等长度文案（80-110字）的实际限流风险？现有云电脑通道跑过多大量
- 企微资料交付：发链接 / 发文件 / 都发？（尚未决定，已做成可插拔）
- 向量检索值不值得上？还是词典 + LLM 就够（成本 vs 召回）
设计文档全文：docs/specs/2026-07-13-kb-keyword-delivery.md（Akke 仓库 · 分支 feat/quanwu-dingzhi-kb）