零、本地已经能跑（B 路线）

1. cd demo && python3 server.py，打开 http://127.0.0.1:4176
2. 要真模型：export LLM_API_KEY=sk-...（OpenAI 兼容端点，默认 DeepSeek），不填则自动用本地模板
3. 要直发：export WECOM_CORP_ID / WECOM_AGENT_ID / WECOM_SECRET，签名接口已实现并缓存 ticket
4. 客户档案存在 demo/clients.json，改阶段/痛点会自动落盘

一、侧边栏挂载

1. 企业微信管理后台 → 应用管理 → 自建 → 建一个应用，拿 corpId / agentId / secret
2. 应用详情页 → 配置到聊天工具栏 → 添加页面，URL 填本页的线上地址
3. 应用需开通「客户联系」权限，否则 single_chat_tools 入口调不通

二、前端鉴权（关键，签错就全部失效）

1. 引入 jweixin-1.6.0.js，先 ww.register 再 ww.agentConfig
2. 后端算签名：sha1(jsapi_ticket=..&noncestr=..&timestamp=..&url=..)，url 用当前页 location.href.split('#')[0]
3. jsApiList 必须含 sendChatMessage / getContext / getCurExternalContact

三、后端要补三个接口

1. /signature 返回 agentConfig 参数，缓存 jsapi_ticket（有效期 7200 秒）
2. /client/:externalUserId 返回客户档案：阶段、抄经天数、意向、上次跟进、痛点原话
3. /reply 入参 = 客户原话 + 档案 + 阶段，出参 = 三条候选（带 tag 和 why）

四、想省掉「粘贴」这一步 只能开会话内容存档（管理工具 → 会话内容存档），服务版 900 元/人/年，企业版 1800。开通后客户端会出现存档提示，这行提示会一直被客户看到。存档是按 seq 增量拉取，单次上限 1000 条，只能回溯 5 天，所以必须自建服务定时落库，再推给侧边栏。
五、不建议做的 用智能机器人自动回客户。这套生意成交靠人，机器只能帮人省时间，不能替人回话。