🗺️ AI回复蓝图全流程决策地图 · v3.6.17 2026-08-28 · 规则外置+数据淘汰+状态机12条+蓝图同步+路由铁律钉死+L2.5自我指涉修复+链接案例库AI知情+封面本地上传+小程序案例库+导航跳转修复+案例匹配用客户原话+关键词/可行性疑问词表语境双门槛(对齐知识树)+精准意图门(功法锚定排除自杀/用药)+案例上下文与发卡解耦(A/B都注入原材料仅B发卡)+system护栏+意图门放宽(行吗/好吗/成吗病症+泛可行性放开;危险动作锚点自杀/用药仍排除;其它动作跑步/运动不放开)+GLM升主模型(配置驱动AI_MODEL_PROVIDER=glm|deepseek,改.env+restart即回退DeepSeek)+双engine.py根因(worker真用ai_reply/engine.py)+_call_glm超时30→120s+指数退避重试+免费档大上下文prefill慢实测~80s→已切glm-4.7-flash免费档实测~16s加速)

35项已修复 v3.6.6 2026-07-29 规则外置+数据淘汰机制 P0避让死锁+群发误拦截 R10蓝图强制 🚑漏回极速排查(2026-08-10) 🌙
⚠️ v3.6.6 关键变更摘要 · 2026-07-29 规则外置+数据淘汰+状态机12条+蓝图同步
⚠️ v3.6.13 2026-08-09 意图门放宽（病症＋泛可行性疑问） 分支B触发过严：原泛可行性词表漏「行吗/好吗/成吗」且强制要求功法名词→「高血压行吗」漏发案例。现放宽：①先排除危险锚点(自杀/轻生/自残/吃药/用药/饮酒/抽烟/手术/违法)→绝不对其说"能"，交安全带引回功法；②泛可行性疑问(行吗/好吗/成吗/可以吗/能吗…)：含功法名词→命中；病症关键词+疑问且无其它具体动作动词(跑步/运动/瑜伽)→视为问功法能否练→命中。助教老师只答功法能不能练，不接其它"能不能"的茬。知识树词表同步补「好吗/成吗/没问题吗」+注2排除说明。
🔴 DeepSeek 失效静默漏回（2026-08-13 Fix C · Case3 根因） DeepSeek 彻底失效（无 key/熔断/超时/空回复）时 engine 返回空→上层静默丢弃消息，AI 整段不回（累计 1469 次），客户下午才由真人才答。engine.py `_call_deepseek` 抽真实请求到 `_do_deepseek_request`，DeepSeek 返空即回落 `_call_glm`（智谱 GLM，OpenAI 兼容端点，复用同一 system_content）；新增 `_get_glm_key` 三级来源（ai_reply_config.json→环境变量 GLM_API_KEY/ZHIPU_API_KEY→.env）；模型名取环境变量 `GLM_MODEL`，默认 glm-4-flash 免费档（100万tok/天，最坏量 7 倍余量）。无 GLM key 时 `_call_glm` 返空、行为与旧版一致（零回归）；实测三场景经现网 quality_gate 全 passed、红线全守。改 `GLM_MODEL` 可切 FlashX/Plus，无需改码。
🔴 GLM 升为主模型 + 双 engine.py 根因 + 超时修复（2026-08-14） DeepSeek 主账号持续 402（余额不足），用户要求 GLM 顶上。先误改顶层 engine.py（server.py 用）无效——**双 engine.py 根因**：worker 实际 import 的是 ai_reply/engine.py（8/11 旧副本、无 GLM），顶层 /opt/admin_web/engine.py 对生产回复无效；GLM 能力+配置开关补进 ai_reply/engine.py。新增 _model_provider() 读 .env 的 AI_MODEL_PROVIDER（glm|deepseek，默认 deepseek）；_call_deepseek 路由：provider==glm 直走 _call_glm，否则走 DeepSeek 主链路失败回落 GLM（Fix C 保留）。.env 现设 AI_MODEL_PROVIDER=glm → **切回 DeepSeek = 改 .env 为 deepseek + restart，零改码**。两处 engine 的 _call_glm 统一 timeout 30→120 + 指数退避重试(range4：429 退 5/10/15s，异常退 3/6/9s)，修大上下文 prefill 慢导致的 30s 读超时+连发 429 静默。⚠️ 延迟：原 glm-4-flash 免费档含 1266 和合玄鉴规则+知识树+身份/日期注入（≈1932 条知识/75 域），大上下文 prefill 慢→实测 ~80s；已切 GLM_MODEL=glm-4.7-flash（同为免费档、混合思考模型、无思考泄漏、质量门通过）→ 实测 ~16s。切回 DeepSeek=改 .env AI_MODEL_PROVIDER=deepseek + restart。静默期丢的消息需手动补。
🔴 账号一对一隔离 + 静默 L0 硬闸口 + Prompt 去重（2026-08-25~08-27） ① 账号 b 步一对一隔离修复：juzi_callback_handler.py:480 入站 botWxid 识别 or 链顺序调整，真实子账号优先（明丽/明阳等不再被 catch-all 明亮号误回）；② 一对一身份铁律（2026-08-27 用户红线）：AI 只能以本接收账号自称，严禁回复出现其他老师名、严禁让客户加/置顶/联系其他账号，客户多账号备注只看本号那行（禁跨账号污染）；③ 静默收敛为质量门 L0 硬闸口（silent_guard.py，按标记形态判死，不再照抄"静默不回复"穿帮）；④ Prompt 去重 A 档：知识树规则双注入去重，省 ~7.7k 字符/轮、零遗漏；⑤ 朝阳老师 2026-08-25 起临时下线。见知识树 current.txt 1.9 一对一账号隔离铁律 + engine.py 身份铁律 + quality_gate.py L0 + rule_sources.py 去重。
🔴 静默前置阻断三层修复（2026-08-28） 事故：小金账号把内部判定语「（不回复——纯社交确认表情，按连续社交静默规则处理）」直接发给学员善净。根因三层全漏：①源头 _is_pure_social_msg 不识别 [OK]/[抱拳] 方括号文本表情（企微/句子回调形态，只剥 emoji 不剥 [x]）→ 连续社交静默未触发，消息漏进 AI；②AI 照抄知识树静默规则原文当回复输出；③质量门 L0 正则括号内长度上限仅 20/15 字符，事故原文括号内 21+ 字符超限 → fullmatch/search 双漏拦。修复：①engine.py _is_pure_social_msg 先剥 [x] 方括号文本表情再做链式剥离（[OK]→空→emoji 剥→空→纯社交 True），命中连续社交静默在 LLM 调用前直接 return silent（AI 根本看不到该消息）；②silent_guard.py 正则括号内上限 20/15→80 + 增补「纯社交确认/社交静默/连续社交/规则处理」关键词；③实测事故原文 L0 blocked、sanitized 为空，正常话术（课务/练功鼓励/确认[抱拳]）零误伤。备份 engine.py/silent_guard.py .bak_silentfix_20260828。
🔴 配偶误称"孝心" + 没练被劝禁忌（2026-08-13 Fix B） 客户说"伺候老伴吃饭"，AI 对配偶冒出"孝心本身就能养心"；客户明确"没练/忙"仍被展开禁忌讲解。①知识树铁律10：老伴/配偶/爱人=伴侣≠长辈，严禁对配偶用"孝心/尽孝/孝敬长辈"（孝心仅适用于父母长辈）；铁律11：客户说"没练/还没练/忙/没空"直接回"那您自己方便的时候练习即可"，不展开禁忌。②quality_gate.py 新增 `strip_spouse_filial`，客户提配偶词时剥离回复中对配偶误用的孝心/尽孝段，其余正常发。
🔴 禁忌讲解无练功语境误发 + 整条硬覆盖（2026-08-13 Fix A） worker.py `_forbid_map` 遇"水/吃/风/排泄"触发词即把整条回复替换成硬编码禁忌句，无练功语境判断→体寒客户被回"不能吹风"、没练客户被劝禁忌。①`_forbid_map` 加练功语境门（`_PRACTICE_CTX`：站桩/打坐/练功/守禁忌/桩前/桩后/收功/功法/练），仅确在练功语境才允许覆盖；②quality_gate.py 新增 `strip_no_context_taboo`，客户无练功语境时剥离回复中的站桩/打坐禁忌段（含「过了这5分钟…修行」「孝心…养心」幻觉句），其余内容走 `sanitized_reply` 正常发，绝不静默丢弃。
✅ 规则外置（#BJ） 知识树 RULE_PARAMS 块 + get_rule_params() 热重载，改知识树即生效无需重启；编号对齐：代码 L19=新友3天红线（与知识树一致），L20仍=姿势一致性。
✅ 数据淘汰机制（#BK） 客户基础信息(加好友日期/标签/备注)+立场永久保留；最近12条消息保留；12条前及60天以上原文清理；流失删除即清空消息，再添加重新积累。
✅ 状态机12条对话 /customer-monitor 新增「最近12条对话」面板（带角色+真人接手标记）。
✅ 真人避让根治(#BC/#BG) 20分钟静默、角色合并为「我方」；上下文注入12条(#BE)；档案浏览器重建(#BB)。
🔴 7/26 全天AI回复归零（去重误杀根因） 7/25 23:32 部署的 server.py 在 ai-callback 引入单 messageId 去重；但 juzi 回调 messageId 非每消息唯一 → 真实消息（除首条外）全被静默吞掉，reply_log 全天 0 条（7/25 19:07 前仍有数据）。server.py 去重键改为 contact_id+messageId 复合键（仅同客户+同msgId 判重复），不再误杀；worker 内容指纹去重改「发送成功后才记录」（修失败重试被误杀隐患）。修复后 reply_log 当日真实客户条目 0→12+，系统恢复。
🔴 群发代码刷新（7/26） 本地 juzi_api.py 滞后于线上，已 scp 刷新对齐生产（发图片函数新增 file_size 自动探测）。群发核心文件已一致。
🟡 企微会话存档（msgaudit）暂挂起 需先在企微后台开通付费「会话存档」+ 独立 secret + RSA 私钥 + 员工/客户同意，代码侧零前置，不可做。
⚠️ v3.6.3 系统状态 · 2026-07-23 L13新客户价格保护修复
🔴 L13只拦截"新客户""新客"标签，漏了无标签客户 客户无标签时_detect_stage返回"通用"，不在L13条件内→AI直接报价1288/3688。quality_gate.py L13条件新增"通用"阶段；engine.py三处质量门调用改用resolve_stage()统一阶段判断。v3.6.3
🔴 AI时间无感知——被客户带偏日期 LLM没有系统时间，客户说"周四8月4号"AI跟着附和而非纠正。tree_matcher_v2.py IRON_LAWS新增铁律6·时间感知+get_time_awareness_hint()注入系统日期。engine.py _build_prompt()注入【系统时间】真实日期+本周四明确标注+强制规则"客户说错了纠正而非附和"。v3.6.0
🔴 双脚平行vs60度AI只会编造 客户问平行还是60度时LLM用通用知识编造错误姿势。tree_matcher_v2.py 站桩域新增脚底姿势路径，含三足鼎立vs四足鼎立详解+生理科学+孙禄堂案例。v3.6.0
🔴 新客户报价无保护 新客户问怎么样收费AI直接报价1288/3688。quality_gate.py L13新增新客户价格保护：新客户+AI含1288/3688→强制替换为收费模板。v3.6.0
🔴 铁律1-8未注入LLM D7知识树的助教铁律只在文本中，未被LLM看到。engine.py _build_prompt()新增【助教铁律】全量注入，含不主动提医生/不承诺效果/时间感知等11条。v3.6.0
🔴 L2.6/L2.7拦截误伤 开头有老师好/同学好等问候直接拦截整条回复。quality_gate.py L2.6/L2.7改为自动删除问候前缀后放行正文。v3.6.0
🔴 L19误拦有标签客户 tag_names=[]被L19判为无标签拦截，实际标签未同步到本地缓存。L19整层删除。v3.6.0
🔴 Worker避让死锁+群发误拦截 _was_human_replied中chat_cache扫描是死代码(return False在其之前)；list_ai_working永久阻塞；群发/欢迎语也阻塞AI。worker.py _was_human_replied重写(扫描移至return前+仅阻塞from=human)；list_ai_working改为双重验证(冷却超时+_was_human_replied兜底)；四种消息来源全部chat_cache标注。v3.6.2 🔴 L19无标签人员禁止回复 新加好友但无任何标签的客户,AI不应回复。quality_gate.py 新增layer_19_no_tag层, engine.py 3处传参, 白名单路径前置L19检查。优先于白名单, 不触发LLM重写(标签是人工标记)。
🔴 AI社交死循环 客户说"好的谢谢"后AI连续5轮不客气+"长篇展开"停不下来。语义级截断: should_silence_social()识别收尾语+回溯历史≥2轮→跳过LLM强制静默。
🔴 老师好/老师您好问候 AI身份=助教老师,问候老板"老师好"混淆角色。L1敏感词拦截+铁律5强化。
🔴 D7 v3.1差异同步7项 铁律7禁忌时间/称呼条件化/不知道回复+静默/喝温水L1/打坐开课逻辑/社交"嗯"/BOT_MAP文案。tree_matcher_v2.py 6处+quality_gate.py L1+engine.py 3处。编译均已通过。
🔴 是的老师错回正式课 体验课客户说"是的老师"->穿透LLM->误判为"确认报名正式课"->发送正式课入学流程。engine.py 4处加"是的老师"; tree_matcher_v2.py CLOSING_ACK加"是的"; quality_gate.py新增L12课程阶段一致性检测。v3.5.3
🔴 D7旧版知识库内容嵌入 云端旧版system_prompt.yaml(9-section)+knowledge_base.py(15条)+dazuo_kb(69条)→嵌入D7树。1.9市场推广/社交细则+表情细则/站桩练功反应/孙禄堂/排病三看+凌晨3-5/信任建设场景化/体验课打卡+礼包+链接/直播规则/打坐补充QA+揉腹法。D7 v3.3。v3.5.4
🔴 低置信度静默门 知识树0命中+感知<0.7+短消息(<=4字)→静默不让LLM瞎猜。engine.py deepseek兜底路径加三层条件拦截。称呼规则追加客户, PHRASE_BLOCKLIST追加老板+客户。D7 v3.4
🔴 质量门L14-L18 质量门13层→18层, 5层全量新增。L14不转别人/L15退款铁律/L16不承诺增强/L17虚假承诺/L18AI腔调增强。quality_gate.py。D7 v3.42
🔴 荣校消息遗漏根因 初练站桩反馈被L2医疗拦截误拦。态度层注入: engine.py _rule_first_layer 追加肩背/初练/命门态度规则。B模式(工具链管线)本地测试通过，暂存至D:\项目汇总\管线模式\B模式
🔴 D状态死锁根因 systemd MemoryHigh=350M → cgroup v2 I/O限流冻结进程。WorkBuddy已修: MemoryMax=550M, 删除MemoryHigh, CPUQuota=150%。
🔴 WatchdogSec=60误杀 Type=simple+Watchdog→每60秒精准杀进程，所有消息丢失。已删除WatchdogSec。教训：Type=simple不能用Watchdog，需要sd_notify+Type=notify才能用。
🔴 Engine阻塞 同步requests.post阻塞asyncio → run_in_executor(有界线程池2路)
🔴 AI回声抢话 回声回调被误标记"人工回复"→客户5分钟被屏蔽 → L0内容指纹检测，回声跳过三层标记
🔴 质量门sanitize削字 "第一天"→sanitize削掉"第一"剩"天" → 白名单4条(第一天/第一次/头一天/头一次)
🟡 KB规则权重不足 DeepSeek用通用知识覆盖规则 → 物理门禁: KB冲突扫描+违规纠偏
🟡 关键词语义缺失 排泄只覆盖"排泄/洗手间/厕所" → 扩展到 拉屎/尿尿/小便/大便/解手/如厕
🟡 quality_gate参数不匹配 → 签名补全
🟡 SQLite WAL补全 ai_training.db + chat_cache + context_engine 全部加PRAGMA WAL
🟡 回调自愈脚本 Juzi API不支持历史拉取(全404)，脚本改为健康监测
🟡 Semaphore(3)并发防火墙 run_in_executor入口加asyncio.Semaphore(3)硬限制
🔴 搬迁至百度云 2026-07-16 AI回复+数据飞轮+客户追踪从阿里云迁移至百度云(120.48.60.158)。L19质量门部署。称呼铁律补全至system_prompt.yaml。_callback_puller自愈脚本+crontab。Engine阻塞修复+tag_names标签兜底查customer_tags表。蓝图对比方案完成。
🟡 身份混淆——AI回叫客户"丽丽老师" 客户叫明丽为"丽丽老师"，AI跟着叫回去。注入铁律：一律叫「同学」+ 封面子变体(丽丽/丽丽老师) — 2026-07-16 搬迁到百度云时补全至system_prompt.yaml
上下文断裂——打坐预习被当站桩回复 "不是站桩"含关键词站桩=计分压倒历史打坐=误走站桩域。AI不知自己刚发了打坐预习。tree_matcher_v2.py detect_course_mode() 新增否定句式反加权+AI最近消息偏置。engine.py 注入上条AI消息强制上下文。v3.5.9
LLM姿势幻觉——编造双脚平行否定知识库 DeepSeek用通用知识编造双脚平行与肩同宽否定正确姿势脚跟并拢脚尖60度。worker.py KB冲突扫描新增站桩姿势规则。quality_gate.py 新增L20姿势一致性层。v3.5.9
🔵 接收🩵 过滤/判断🟢 排队🟡 AI思考 🟣 发送🟠 业务规则💗 知识库🔴 物理门禁⚪ 完成 │ 🔲 ✅ 走这条路 🔲 ⚠️ 跳过了 🔲 ❌ 失败了 🖱️ 悬停看详情
🚑 漏回 / 异常极速排查清单（2026-08-10 新增 · 照此顺序查，通常 2 分钟内定位）
客户说「没收到 AI 回复」或消息卡住时，不要广撒网，按下面 7 步顺序查，每步都给「在哪看 / 怎么判断 / 是不是 bug」：
  1. ① 回调是否收到（入站） → 看 logs/juzi_raw_payload.log 有没有这条消息的入站记录。没有 = JuZi 回调丢失（已知风险，API 不支持历史拉取，无法代码自愈，需 JuZi 后台确认 webhook）。有才往下。
  2. ② 账号是否开启 AI 回复 → 看本页「👥 小组账号总览」或 /ai-training 页该账号 enabled 是否为 true。非 BOT_MAP 成员 / 禁用账号 → 门口两道静默门直接不接收（设计如此，不是 bug）。
  3. ③ 真人回避是否误杀（最高频漏回根因） → 查 system_state.db 的 cooldown 表 human:<contact_id>:<bot_id> 有无近期标记；或日志搜 真人回复标记避让 / 人工回复标记(L2)。scope 必须 (客户,账号)，只压本账号本会话；空 bot 标记会跨账号串味（2026-08-10 18:13 事故根因）。
  4. ④ 落盘 / 重放 → 查 pending_inbound 表：消息 status=received 没变 done = 卡在处理/发送环节（不是没收到）。超过 10 分钟重放窗的陈旧 received 不会再自动发，需客户重发。
  5. ⑤ 质量门拦截 → 日志搜 blocked / 拦截；L7 知识库无原话会整条不发送（外部疾病疗效宣称仍拦）。
  6. ⑥ 发送通道 → 用只读接口 get_customer_list 验证 token 通（errcode=0）。🚫 绝不用 send_message 给真实客户发消息验证（绕过 worker 追踪 → 被误判真人回复 → 客户被静默，2026-08-10 18:13 事故）。
  7. ⑦ 账号一致性红线 → 客户问 A 账号、AI 用 B 账号回 = 串号。查 juzi_callback_handler.py 的 botWxid 直读逻辑未被改（最高铁律）。

📌 重点节点速查 & 修改红线（改这里时绝不破坏其它功能）

🔌 ① 回调接入
一句话：消息进系统的唯一入口。
位置：juzi_callback_handler.py（POST /api/juzi/ai-callback）
检查：logs/juzi_raw_payload.log 有入站记录
🚫 红线：不改 botWxid 直读；不启用企微原生 /api/callback 僵尸分支（XML 解密失败率近 100%）。
🛡 ② 账号一致性（最高铁律）
一句话：哪个账号来，哪个账号回，100% 准确。
位置：handler botWxid 直读 + worker._resolve_send_bot_id
检查：客户问 A 账号、AI 用 B 账号回 = 串号即违规
🚫 红线：不得加「回查 DB / 存储映射覆盖」兜底；否则 JuZi 同步搬动必串号。任何人 / 任何改动禁止违反。
💬 ③ 真人回避
一句话：真人刚回复的会话，AI 暂时不抢话。
位置：worker._human_should_skip / mark_human_replied；handler Route2、chat_event；server L2
检查：cooldown 表 human:<cid>:<bot>；日志「真人回复标记避让」
🚫 红线：scope 必须 (客户,账号)；禁止空 bot；只压本账号本会话，绝不波及其它客户/账号；JuZi SOP/自动欢迎语不是真人——客户 inbound 后数秒内触发的 isSelf 自动回复不得标 human_replied 20 分钟冷却，已用「即时 SOP 判别」拦截。
⏳ ④ 攒包窗口
一句话：连续发问合并成一条再回，25 秒窗。
位置：MessageQueue.ACCUMULATE_WINDOW=25（类属性）+ 攒包键 chat_id
检查：同 chat_id 连发合并；不同 chat_id 各回各的
🚫 红线：不动 25s（误伤连续发问者）；攒包键必须 chat_id（否则跨号合并串消息）；拟人延迟已删勿复活。
💾 ⑤ 落盘 / 重放
一句话：入站先落盘，重启不丢消息。
位置：pending_inbound 表 + worker._replay_pending_inbound
检查：received→done 正常；重启后旧消息重放
🚫 红线：发送成功才标 done；改动勿让 received 永远不标 done（会漏回）；重放窗 10 分钟合理。
🚧 ⑥ 质量门
一句话：L1-L22 硬规则，拦截违规回复。
位置：quality_gate.py（eval_formal_redline 单一真相源）
检查：日志 blocked / 拦截；L7 知识库交叉验证
🚫 红线：L12/L13/L19/L22 白名单分支也须调用 eval_formal_redline；L7 知识库无原话整条不发送不可绕过。
📡 ⑦ 发送通道
一句话：调 JuZi 把回复真正发出去。
位置：juzi_api.send_message / engine.send_reply（带熔断）
检查：只读 get_customer_list 验 token（errcode=0）
🚫 红线：勿给真实客户发消息验证；token 走 get_token 自动刷新；发送失败须有日志/重试，勿静默丢弃（否则漏回）。
🔄 ⑧ 优雅停机
一句话：重启时收尾在途消息，不丢不重。
位置：worker.graceful_shutdown + server shutdown 钩子
检查：重启日志出现「收尾完成（队列剩余=0，在途=0）」
🚫 红线：停机只内部收尾，绝不对外发任何通知/模板；timeout 配足（graceful_shutdown=55 / uvicorn=90）。
🆕 ⑨ 新账号接入 / 开关生效
一句话：小组任意真实机器人，开关一开即回，无需改流水线逻辑。
位置：🔴 BOT_MAP 的 wxid+userid 必须同时加进两份 config：① ai_reply/config.py:BOT_MAP（worker 门口闸 GATE 源，漏→0回复）② 顶层 /opt/admin_web/config.py:BOT_MAP（server 账号展示/画像/bot解析源，活文件非死文件，漏→列表坏）+ employee_db.json(页面显开关) + ai_reply_config.json(开关) 三处对齐。name 字段两份可不同（顶层全称/ai_reply 短称），SKIP_SYSTEM_MESSAGES/DELAY_* 也故意不同，勿强行对齐。
检查：/api/ai-reply/config 返回该 userid；juzi_contact_map WHERE bot_wxid='<wxid>' 计数>0
🚫 红线：三处 userid 必须一致（BOT_MAP[wxid].userid==employee_db.userid==ai_reply_config 键），否则当关闭；只改 BOT_MAP 不够——页面只列 employee_db，缺它根本不显开关；勿给「无真实 wxid 的纯昵称记录」开开关（永远收不到消息）。
📨 第一阶段：客户发消息 → 系统接收
1
👤 客户在企微上发了一条消息
可能是：文字 / 语音 / 图片 / 链接 / 文件 / 表情
起点外部事件
2
🔄 句子SCRM收到 → 推送到我们服务器
句子SCRM POST回调到 nginx → FastAPI（两种格式：组级data包裹 / 企业级直JSON）
<1秒⚠️ 回调可能丢失(见关联)
3
📥 消息入口（juzi_callback_handler.py）
所有消息都从这里进。如果这里坏了→所有消息都收不到。
已知风险：Juzi SCRM偶发回调丢失，API不支持历史拉取(404)，无法代码自愈
P0juzi_callback_handler.py
🆕 判断①：按 contact_id+messageId 复合键查重（2026-07-26 修复）
⚠️ 同客户+同msgId重复 直接返回（防 juzi 重试重复回复）
✅ 新消息 记录复合键 → 继续
⚠️ 历史坑：曾用单 messageId 去重 → juzi messageId 非唯一 → 全天真实消息被静默吞掉（7/26 归零事故根因），已改复合键修复
🚫 判断②：是老师自己发的消息吗？isSelf标记？
✅ 是AI/老师发的
  ▶ L0 内容指纹检测(2026-07-10 NEW)：
    🔑 AI回声命中指纹 → 跳过L1/L2/L3全部标记 ✅（避免客户5分钟被屏蔽）
    🔑 非回声/人工回复 → 标记"老师刚回复过" → 结束
  ▶ L1 标记人工回复冷却（20分钟内不抢话）— [2026-07-29升级] chat_customer_map 持久化(chatId→788单键)+真人历史扫5页(co-worker)+单键反查消除bot_id错位
  ▶ L2 bot映射找最近对话客户标记
  ▶ L3 chat_cache记录
❌ 客户发的 → 继续
👥 判断③：群聊消息？
✅ 是群聊 → 不处理，结束
❌ 私聊 → 继续
⚡ 并行处理：语音识别
🎤 语音消息 → faster-whisper base模型转文字（1-3秒），失败则跳过
📄 其他类型 → 图片/链接/文件跳过不处理
3.5
[指纹] 内容指纹去回环（fingerprint_guard.py）
记录AI回复SHA256指纹 → 回调时比对。
匹配=回显→跳过。不匹配=客户消息→放行。
[v3.2] 匹配精度12字
<0.01s fingerprint_guard.py
4
📋 入队列（asyncio.Queue）
消息进入积累字典 → 25秒滑动窗口合并 → 入队。
20路Worker并行处理，谁空闲谁接手。
🆕 enqueue 60秒安全网 + janitor每60秒清扫
~25秒 worker.py 队列满→丢弃
🔍 第二阶段：过滤筛选（任一条件触发→跳过）

👥 小组账号总览（AI 会以其身份回复客户）

账号课型状态AI回复
明丽打坐● 在线● 托管·正常回复
明亮站桩● 在线● 托管·正常回复
🏅小帆老师-站桩咨询站桩● 在线● 托管·正常回复
🍀小帆老师-站桩咨询站桩● 在线● 托管·正常回复
🌸小帆老师通用● 在线● 托管·正常回复
助教小金-站桩😃站桩● 在线● 托管·正常回复
明阳老师🌞站桩● 在线● 托管·正常回复
朝阳老师站桩⏸ 临时下线（2026-08-25）⏸ 禁用→静默丢弃
小威站桩● 在线● 托管·正常回复
小金老师站桩🏵️站桩● 在线● 托管·正常回复
账号上下线：后台 /ai-training 页（账号开关列表，点一下即时生效，无需重启）或改 ai_reply_config.json 的 enabled 字段（自助）。新增物理账号：还需在 ai_reply/config.py:BOT_MAP（GATE 源；顶层 config.py:BOT_MAP 须同步） 登记 wxid→身份 + perception_engine.BOT_DOMAIN_MAP 配课型。
📡 消息来源：仅 JuZi SCRM 实时回调（live 路径，带接收账号 imBotId）。企微原生 /api/callback 为僵尸分支（XML解密失败率近100%、AI回复触发0次），勿启用。
👤 判断④：是明丽 / 明亮 / 小帆（站桩·打坐·通用）/ 助教小金-站桩😃 / 明阳老师🌞 / 小威（站桩）/ 朝阳老师（站桩） 的消息吗？（小威 2026-08-25 重启上线·正常回复；朝阳老师 2026-08-25 起临时下线·不回复）
✅ 是 → 继续
❌ 不是 → 跳过
🛡 路由铁律（2026-08-08 钉死）：入站 imBotId 是回复账号的唯一依据，绝不兜底、绝不用存储映射覆盖。
门口两道静默门：① 不在 ai_reply/config.py:BOT_MAP（GATE 源；顶层 config.py:BOT_MAP 须同步） → 直接不接收；② 在 BOT_MAP 但 ai_reply_config.json 该账号 enabled=false（如朝阳老师）→ 同样直接不接收。
非托管 / 禁用账号的消息：不回复、不报错、不兜底。即「哪个账号来，哪个账号回」，百分百准确。
🔴 账号一致性最高铁律（2026-08-10 收口 + 红线）
① 根因：JuZi 把站桩 bot 内部 id 由旧值 6a4903feda… 改成 6a7454cb…，旧 BOT_ID_MAP 漏映射 → 站桩消息落不到映射 → 掉员工级 catch-all「明亮」号回复（即"站桩被明亮回复"真凶）；另发现新接收账号 WangZi(1688858005858384) 也不在表。
② 修法：juzi_callback_handler.py 直接读消息 payload 自带的 botWxid（即接收账号 wxid 本身）作接收账号，不再依赖会漏/会被 JuZi 改 id 弄失效的映射表；worker._resolve_send_bot_id 改为"非 catch-all 一律信任入站账号返回"，彻底杜绝被不可靠的 juzi_contact_map（DB 30 分钟同步）覆盖成别的号。
③ 🚫 红线（任何人 / 任何改动禁止违反）：不得修改"接收账号识别 + 同账号回复"的关系对应——不得改 handler 的 botWxid 直读逻辑、不得给 _resolve_send_bot_id 加任何"回查 DB / 用存储映射覆盖"的兜底；违者必串号（客户问 A 账号、AI 用 B 账号回）。此功能与关系对应为系统最高优先级，改动前必读本记录。
⏰ 判断⑤：工作时间（5:00~23:30）？
✅ 是 → 继续
❌ 非工作时间 → 跳过
🛑 判断⑥：老师刚回复过这个客户？（5分钟冷却）
✅ 没回复过 → 继续
❌ 刚回复过 → 跳过（不抢话）
💬 判断⑦：客户最近10分钟有真人发言？
✅ 没有 → 继续
❌ 有真人发言 → 跳过（不插嘴AI）
🤖 判断⑧：系统消息？
✅ 正常消息 → 继续
❌ 系统消息 → 跳过
🔑 判断⑨：30秒内同一客户发了一模一样的内容？
✅ 新内容 → 继续
❌ 重复内容 → 跳过（防重推）
⏳ 第三阶段：处理 + AI思考
5
📨 25秒异步定时器积累合并
客户短时间连发多条 → 25秒滑动窗口合并。25秒内新消息自动延长定时器。
超过25秒无消息 → 合并入队。60秒安全网兜底。
25秒 60秒安全网
6
⏱️ 模拟打字延迟（5~15秒随机）
总响应时间=25s积累+5~15s延迟+模型调用(当前 GLM-4.7-flash 免费档 ≈ 16s) ≈ 40~50秒；若切 DeepSeek 或升 GLM_MODEL 可降到 30~45秒。
发送令牌桶限速：每9秒最多3条，防封号。
5-15秒40-50秒总计(GLM-4.7-flash)
📋 并行注入：上下文 + 规则 + 知识库
6a
📢 群发通知/广播注入
last_broadcast.json → 始终注入AI上下文。直播例外2触发规则。
6b
📜 system_prompt.yaml（20节热加载）
课程时间·直播规则·广播注入·案例图片调用·价格问答三层体系·练习频率规则
[v3.4.1] 案例图片调用规则新增，含关键词自动匹配兜底
[2026-07-11] §20 练习频率规则新增：初学多练过渡/一周后一次练透/烧开水比喻/年龄分钟数上限
🧠 核心引擎：生成回复
7
🧠 AIReplyEngine.generate_reply()
① 查客户背景：谁？对话历史？客户阶段？
② 搜知识库：1739条知识+1532条规则+80域 → get_domain_context()
③ 组装提示词：[v3.4.2] 知识库注入格式从【参考】→【绝对指令】
④ 调模型（配置驱动 DeepSeek/GLM）：[v3.4.2] run_in_executor(2线程) 不阻塞事件循环；[2026-08-14] provider==glm 直走 _call_glm，否则 DeepSeek 主链路失败回落 GLM
⑤ 11层质量检查：敏感词?医疗?品牌?价格?幻觉?关键词?
⑥ 后处理：承诺替换 / 医学诛 / 信息诛
16秒(GLM-4.7-flash) 🛡️ 熔断器CLOSED engine.py
🤖 判断⑩：模型调用成功？
✅ 成功 → 继续
❌ 失败/超时 → 熔断器计数+1，连续5次熔断打开(60秒)
⚠️ 熔断器打开 → 静默不回复
7a
🔴 KB规则冲突扫描 — 物理门禁（2026-07-10 NEW）
AI生成回复后，在质量门前做一道物理规则冲突检测：
✅ 匹配触发词（喝水/吃/风/排泄等）→ 检查action中是否含"不要/禁止/不能"等否定词
✅ 发现冲突（AI说"可以喝温水"vs规则"不能喝水"）→ 自动替换为规则正确表述
✅ 禁忌时长模糊表述（三五分钟）→ 精确为"5分钟"
关键词覆盖：上厕所/拉屎/尿尿/小便/大便/解手/如厕/方便一下
2.5分钟规则：仅当客户同时提"站桩5分钟"+"禁忌"时才解释，否则只提守5分钟
worker.py v3.4.2 已验证生效
🛡️ 判断⑪：质量检查通过吗？（11层）
✅ 通过 → 继续发送
⚠️ 没通过但有修正 → sanitize修正后重试
❌ 严重违规 → 静默
质量门19层详情（quality_gate.py ElevenLayerGate）：
L1-L18 + L19新友3天禁推正式课(原L20对齐知识树) + L13收费条件改写(新友<3天提1288/3688→改免费课话术)：
L1敏感词墙："第一"已白名单(第一天/第一次/头一天/头一次) | L2医疗拦截 | L3品牌检查
L4价格检测(3688/1288白名单) | L5编造断言模式 | L5.5原子声明
L6关键词密度 | L7医疗忠告拦截 | L8内容核验 | L9风格核验 | L10编造事实 | L11人工标记
L12课段一致 | L13新客户价格保护 | L14不转别人 | L15退款铁律 | L16不承诺增强 | L17虚假承诺 | L18AI腔调
[已定尺度白名单] 首先检查，但L19/L11不受白名单豁免
[v3.6.6] L19语义更新: 原"无标签检查"已于v3.6.0删除，现L19=新友≤3天禁推正式课（与知识树新友红线对齐）；L13=收费条件改写（新友<3天提1288/3688→按树改写免费课话术）；体验课卖课不再被拦。
[P0 Fix 2026-07-22] L11从未生效 — server.py调用mark_human_replied_and_cache(不存在的方法) → AttributeError被吞 → _human_replied字典永远空 → L11质量门/Worker抢话检测全部失效。修复: (1)server.py isSelf处理器重写(AI回声指纹匹配→mark_ai_replied 30s冷却 vs 人工回复→mark_human_replied 600s冷却+chat_cache存储); (2)engine.generate_reply()新增human_replied参数,3处quality_gate.check()传递; (3)worker.py传参 self._was_human_replied()→engine; (4)系统消息/欢迎语存chat_cache(from=system)。4文件修改,生产部署验证通过。
⚙️ 判断⑫：回复为空或被拦截？
✅ 有回复 → 继续发送
❌ 空回复/被拦 → 静默不降级模板
📤 第四阶段：发送回复 → 完成
8a
🖼️ 案例图片发送检测
AI可以在回复中嵌入[图片案例:文件名.png]标记 → 自动移除标记并发图(4秒延迟)。
[v3.4.1] 关键词匹配兜底：AI没加标记时，按症状关键词自动匹配案例图
[v3.4.2] call_soon_threadsafe 发送到主事件循环（解决run_in_executor中create_task失效）
案例图片路径: case_images/
🔗 链接案例发送检测
AI生成前由 worker 注入匹配到的链接案例上下文（标题/描述/症状），AI 文字可告知"有此案例"。
[v3.6.9] 链接案例库 link_cases/：按症状关键词自动匹配，4秒延迟发链接卡片(send_link)
封面图支持本地上传(api/link-cases/cover→/link-covers/)，JuZi payload 含 sourceUrl 字段
[v3.6.9] send_link 修复: payload 字段补 summary+sourceUrl(原 desc/仅 url → JuZi 报 summary/sourceUrl empty)；21:54 实测链接卡片发送成功
[v3.6.11] 案例匹配规则门槛：必须【症状关键词命中】+【能练吗/是否能练/适合练 这类练功咨询语境】同时满足才发；用客户原话(_original_ct)搜索，不再搜AI reply；字段扩至症状+描述+周期+来源+标题 [v3.6.11] 语境词表已对齐 knowledge_tree/current.txt「可行性疑问词表」：能不能/能吗/能行吗/行不行/可以吗/可行吗/行吗/成不成/妥不妥/有用吗/管用吗/有效吗/有效果吗/管不管用/好使吗/灵不灵/见效吗/出效果吗（可以/行/可行容忍中间隔词）；"高血压可以吃药吗""失眠站桩有用吗"等现均走分支B发案例 [v3.6.12] 意图门升级为「功法锚定」：强句式(自带练/站桩/打坐/功法动词) OR (效果类有用吗/能好吗+含功法名词) OR (泛可行性可以吗/行不行+含功法名词)；"高血压能自杀吗""高血压可以吃药吗"因无⁠功法语境/问药→不发卡片；分支A/B都向AI注入案例原材料(_match_case_by_keyword不卡意图)，仅分支B真正发卡
链接案例路径: link_cases/
📦 小程序案例发送检测（已下线 2026-09-10，入口改为「视频」视频号案例库）
AI生成前由 worker 注入匹配到的小程序案例上下文（标题/描述/症状），AI 文字可告知"有此案例"。
[v3.6.10] 小程序案例库 mini_cases/：按症状关键词自动匹配，4秒延迟发小程序卡片(send_miniprogram, message_type=9)
封面图支持本地上传(api/mini-cases/cover→/mini-covers/)；payload 含 appid+pagepath(必填)+title+summary+url+sourceUrl+imageUrl
[v3.6.10] 与链接案例库完全对称：字段多 appid/pagepath；守卫 title+appid 非空
[v3.6.11] 同链接案例：关键词命中 + 能练吗语境 双重门槛；用客户原话，字段扩至描述/周期/来源/标题 [v3.6.11] 语境词表同链接案例，已对齐知识树可行性疑问词表(含有用吗/可以吗/行不行等) [v3.6.12] 同链接案例：意图门改为功法锚定，排除非功法/危险诉求；_build_case_context 改用 _match_case_by_keyword，A/B 都注入原材料仅 B 发卡
小程序案例路径: mini_cases/
8
📤 发送回复给客户（Juzi API）
调用句子企业级API send_text → 推送回复到客户微信。
🛡️ 经熔断器发送，连续失败自动暂停
0.5-2秒🛡️ 熔断器
📨 判断⑬：发送成功？
✅ 成功 → 记录+更新统计
❌ 失败 → 熔断器+1，重试最多3次
9
📝 记录 + 执行后续动作
✅ 记录问答对到训练库
✅ 标记内容指纹（防回显死循环）
✅ 自动执行AI承诺（发链接/报名）
✅ 更新统计（总回复数/拦截率/熔断器状态）
✅ 客户事件时间线记录
SQLite
10
👤 客户收到回复 ✅
整个流程走完。从发消息到收到回复 约35-65秒。
📋 历史版本修复汇总

🔮 v3.5.5 2026-07-14 D7 v3.1差异同步

  • 语义社交截断 should_silence_social()三级判断: 收尾语义→回溯历史≥2轮→跳过LLM
  • L1敏感词新增 喝温水(禁建议喝水)+老师好/老师您好(禁问候学生)
  • 铁律7改禁忌时间 术后→吃/喝/吹/水/厕所/卫生间/小便/大便/尿
  • 铁律3强化 第二次客套"好的"→发"嗯"，不再长篇展开
  • 称呼条件化 仅对方称呼老师时才叫"同学"
  • 不知道回复+静默 "我需要确认一下"→"稍等，稍后回复您"
  • 打坐开课逻辑 数据库→上下文→静默+通知萌生+本条置顶
  • hint_only 第1轮收尾注入极简指令，引导LLM发"嗯"

🚨 v3.4.2 2026-07-10 今日全部修复

  • D状态锁 ThreadPoolExecutor 无限→2，VACUUM DB 273M→228M
  • Engine阻塞 sync requests→run_in_executor(2线程)
  • AI回声标记 L0指纹检测，回声跳过L1/L2/L3三重标记
  • 质量门削字 白名单+第一天/第一次/头一天/头一次
  • KB规则物理门禁 违规回复自动纠偏(站桩水禁忌等)
  • 语义扩展 排泄→拉屎/尿尿/小便/大便/解手/如厕
  • 禁忌时长 三五分钟→精确5分钟，2.5分钟仅客户问才提
  • quality_gate 补全human_replied参数
  • Prompt强化 参考→绝对指令，建议→必须执行

📺 下午直播四条件例外2

  • 例2触发(AND)：①含"直播"②当天③13:00-16:30④不限周几
  • 四条件全满足→"有的，从链接进入即可"
  • 仅例1+周二至周五→"暂时未定"
  • 仅例1+周末→"下午没有直播"

📅 课程时间固定周期

  • 站桩体验课：5天一期，每周一/四晚7点
  • 打坐体验课：3天一期，每周三晚7点
  • 周期决定，不以学生进度转移

📢 群发通知注入

  • 始终注入上下文
  • 四条件全满足→触发例外2
  • 非当天广播→正常上下文

📁 已部署文件清单（2026-07-10）

  • server.py L0回声检测+三层标记保护
  • worker.py run_in_executor+有界线程池+KB冲突扫描+关键词扩展+案例图兜底
  • engine.py 绝对指令注入+必须执行规则+quality_gate传参
  • quality_gate.py 白名单4条+human_replied签名
  • customer_cache.db VACUUM收缩

💡 已部署的自愈措施

  • Juzi SCRM回调丢失 — _callback_puller.py 已部署为健康监测（Juzi API不支持历史拉取）
  • D状态 — 已根除(MemoryHigh删除，MemoryMax=550M)
  • Watchdog误杀 — 已删除(Type=simple+Watchdog不兼容)
  • 1.6G内存 — 峰值~380MB，剩余约1G

📌 关键教训（2026-07-10）

  • 🔥 WatchdogSec + Type=simple = 必杀 — simple类型不发sd_notify心跳。要用Watchdog必须改Type=notify并在代码中调sd_notify(0, "WATCHDOG=1")。否则Watchdog每次超时都会SIGABRT强杀，不管进程是否活着。这导致之前所有"发消息不回复"的90%是这个原因。
  • MemoryHigh 不是 OOM — cgroup v2的memory.high超标 ≠ kill，是对进程做I/O限流，导致进程冻结在D状态。要限制只能MemoryMax（超了就杀）或者memory.limit_in_bytes(cgroup v1)。
  • 同步requests阻塞asyncio — 20路Worker看着很美，但engine.generate_reply()用同步requests.post，实际每次只有1路在工作。修复后加Semaphore(3)+run_in_executor(2线程)才变真并行。
  • AI回声=客户消息 — isSelf回调的AI回复被当成"人工回复"标记冷却，导致客户5分钟内发消息被屏蔽。修复：L0先指纹检测再决定是否标记。
  • Juzi API不支持历史拉取 — 当前API套餐无session/list和message/history权限，回调丢失无法代码自愈，只能联系客服。
⚠️ 所有可能走到"跳过/结束"的路径
⚠️ 重复消息(同客户+同messageId)
✅ 老师/AI发的(回声) → L0跳过+不标记冷却
⚠️ 群聊消息
⚠️ 非工作时间23:30-5:00
⚠️ 老师5分钟内刚回复过
⚠️ 10分钟内客户有真人发言(不插嘴)
⚠️ 系统消息
⚠️ 30秒内同客户一模一样的内容
❌ 队列满(>200)
❌ 熔断器打开
🛡️ KB冲突扫描纠偏
❌ 质量门拦截
❌ 发送失败(3次重试后)
✅ 空回复→静默(不降级模板)
🔍 故障排查树 — 消息未回复时一步步查
❓ 客户发消息了，但AI没回复

① server.log 有回调记录？
  ❌ 无 → Juzi SCRM回调丢失(非代码)
  ✅ 有 → 继续

② 有 ✅文本消息 和 📩入队 吗？
  ❌ 回调无入队 → isSelf/群聊/系统消息拦截
  ✅ 已入队 → 继续

③ /api/ai-monitor stats：
  ⚠️ queued>0, completed=0 → Worker未启动
  ⚠️ retried持续涨 → DeepSeek失败
  ✅ completed>0 → 正常

④ ps aux 进程状态：
  ❌ D状态 → kill -9 + restart
  ✅ Ssl → 正常

⑤ tail -f server.log 看Worker详细日志
🔄 恢复/回滚矩阵 — 出问题该用哪个备份
D状态死锁 → systemd .bak2
CPU爆满 → customer_cache_db.py.bak
聊天记录损坏 → chat_cache.py.bak
上下文异常 → context_engine.py.bak
crontab乱 → /tmp/crontab.bak
全量回滚 → kill -9 + restart / ECS重启
📊 自检探针阈值
🔴 system_skipped > 50/小时
🔴 completed=0 queued>20
🟡 quality_blocked > 20/小时
🔴 retried > 20/小时
🔴 D状态 > 30秒
🟡 内存 > 500MB
🔁 蓝图自维护 — 本文件升级工作流（R10强制）
⚠️ 此部分定义蓝图自身的升级流程。每次改本文件后必须按此流程执行。
标准升级流程（8步，不可跳过）
1. 更新版本文档 — 标题版本号 + 警告栏日期 + 版本历史 + footer
2. 更新修复清单 — 顶部警告栏追加 + 版本历史cards + 教训
3. 更新流图 — 流程改动时增改 flow-step / decision / 跳转路径
4. 备份到历史版本 — 历史版本\AI回复蓝图-v{version}-{date}.html
5. 更新系统归档 — verify.json + memory/ + MEMORY.md
6. 部署验证 — md5本地=远程 + systemctl is-active + 自检一次
7. 自指检查 — 确认本次修改已按本流程执行 ✅
8. 注入教训 — 本次踩坑写入memory/blueprint-archive-lessons.md
9. R12双文件归档 — D7知识树更新流程
 主文件: D:\项目汇总\ai回复系统\AI客服D7知识树.txt（你唯一查看的版本）
 ↓ 同步镜像到: D:\项目汇总\管线模式\B模式\D7功法思维导图_完整版.txt
 ↓ 归档副本: v3.x.x_归档目录\AI客服D7知识树_{version}_{date}.txt
 改前确认哪个版本最新，永远以AI客服D7知识树.txt为编辑源

⚠️ 教训卡（2026-07-17 归档v3.5.7注入）
❌ 不要用Edit替换含中文HTML大段 — 隐藏字符差异必匹配失败，用Python content.replace()
❌ 改前先备份到历史版本 — 脚本写坏文件时有.bak兜底，但不要依赖自动备份
❌ 归档时不要调蚁群阵Agent — 简单文件操作一步到位
✅ 蓝图编码UTF-8 — Python读写确保 encoding="utf-8"
📜 蓝图版本史
v3.6.15 2026-08-14 — GLM 升主模型（配置驱动）+ 双 engine.py 根因 + 超时修复: DeepSeek 主账号持续 402，GLM 顶上为主模型。根因：worker 真用 ai_reply/engine.py（顶层 engine.py 改了无效）；补 GLM+_model_provider() 读 .env AI_MODEL_PROVIDER(glm|deepseek)；_call_deepseek 路由 glm 直走 _call_glm，否则 DeepSeek 失败回落 GLM；切回 DeepSeek=改 .env+restart。两处 engine 的 _call_glm 统一 timeout 30→120 + 指数退避重试(range4)。⚠️ 原 glm-4-flash 免费档大上下文 prefill 慢 ≈80s；已切 GLM_MODEL=glm-4.7-flash（免费档、混合思考、~16s、无泄漏）。切回 DeepSeek=改 .env+restart。
v3.6.14 2026-08-10 — 账号一致性 100% 收口 + 明确索要案例发卡: ①路由铁律补丁——JuZi 改站桩 bot 内部 id(6a4903feda…→6a7454cb…)致旧 BOT_ID_MAP 漏映射、站桩掉"明亮"号回复；现 juzi_callback_handler 直读 payload.botWxid 作接收账号(不再依赖会漏映射表)，worker._resolve_send_bot_id 非 catch-all 一律信任入站账号(杜绝被 DB 同步覆盖串号)；另补 WangZi(1688858005858384)。②案例发卡补丁——新增 _is_case_request 识别"有XX案例吗/案例发我看看"等明确索要诉求，_find_best_case 增 bypass_intent 参数：客户明确要案例时跳过"可行性意图门"、按关键词直接发案例卡片(链接/图片/小程序)，终结"只答案例内容不发案例卡"怪象。⚠️ 红线：任何改动不得修改"接收账号识别+同账号回复"关系对应(不得动 handler.botWxid 直读 / worker._resolve_send_bot_id 信任入站逻辑)，违者必串号。
v3.6.13 2026-08-09 — 意图门放宽（病症＋泛可行性疑问）: 原泛可行性词表漏「行吗/好吗/成吗」且强制要求功法名词→「高血压行吗」漏发案例。现放宽：①先排除危险锚点(自杀/轻生/自残/吃药/用药/饮酒/抽烟/手术/违法)→绝不对其说"能"，交安全带引回功法；②泛可行性疑问(行吗/好吗/成吗/可以吗/能吗…)：含功法名词→命中；病症关键词+疑问且无其它具体动作动词(跑步/运动/瑜伽)→视为问功法能否练→命中。助教老师只答功法能不能练，不接其它"能不能"的茬。知识树词表同步补「好吗/成吗/没问题吗」+注2排除说明。
v3.6.12 2026-08-09 — 案例分支精准化 + AI安全带: worker._has_practice_intent 升级为「功法锚定」——强句式(自带练/站桩/打坐/功法动词) OR (效果类 有用吗/能好吗 + 含功法名词) OR (泛可行性 可以吗/行不行/能吗 + 含功法名词)；彻底排除「高血压能自杀吗」「高血压可以吃药吗」等非功法/危险诉求出分支B发卡片。新增 _match_case_by_keyword(纯关键词匹配、不卡意图)供 _build_case_context 向AI注入案例原材料——分支A/B 都注入(只要提到相关症状/关键词)，是否实际发卡由 _find_best_case(含意图门)控制，仅分支B发卡；[图片案例:]标记发卡也卡意图门。system_prompt.yaml 新增 reply_grounding_guardrail 护栏：回答必须围绕无极太极功法对身心健康的调理作用，对与功法无关诉求(自伤/用药/诊断/违法)绝不套用能不能练框架、绝不肯定危险诉求、不做医疗诊断。
v3.6.11 2026-08-09 — 案例匹配规则门槛修正（关键词+语境）: worker 保留 _original_ct 用于案例匹配(不再搜 AI reply)；新增 _find_best_case/_extract_practice_keywords/_case_search_text/_has_practice_intent。规则：必须【症状关键词命中】且【可行性疑问词(对齐knowledge_tree/current.txt：能不能/能吗/行不行/可以吗/有用吗/管用吗/有效吗/行吗/成不成/妥不妥/有效果吗/管不管用/好使吗/灵不灵/见效吗/出效果吗，可以/行/可行容忍中间隔词)】同时存在才自动发案例(原仅关键词命中即发的宽松逻辑已收紧)；搜索字段从仅 symptoms 扩至 desc/duration/source/note/title/文件名；支持「高血压能练吗」自动提取「高血压」。图片/链接/小程序三类案例发送与 _build_case_context 均统一使用该引擎。
v3.6.10 2026-08-08 — 小程序案例库+导航跳转修复: 新增小程序案例库 mini_cases/(GET/POST/PUT/DELETE /api/mini-cases，必填 appid+pagepath，封面本地上传→/mini-covers/)；worker._build_case_context 注入小程序案例、_case_mini 关键词匹配、_delayed_send_mini 调 send_miniprogram(message_type=9)；nginx 三 server block 各加 /mini-covers/ 静态位置；导航跳转修复——全站「链接」→/link-cases、「小程序」→/mini-cases 对称，解决"跳转不自由"(原 /materials?type=link 误停 materials 页、/materials/miniprogram 404)。
v3.6.9 2026-08-08 — 链接案例库AI知情+封面本地上传: worker 生成前注入匹配到的 link_cases/case_images 案例上下文(标题/描述/症状)，AI 文字可引用; 新增 POST /api/link-cases/cover 本地封面上传→/link-covers/; juzi_api.send_link payload 补 sourceUrl 字段(修复 JuZi 报 payload.sourceUrl is empty); nginx 加 /link-covers/ 静态位置。
v3.6.8 2026-08-08 — L2.5自我指涉修复+案例叙事豁免: quality_gate.TABOO_PRACTICE_ANCHOR_RE 移除「禁忌」触发词, 杜绝 self-referential 循环(质量门曾把AI自己写出的「禁忌」误判为需插禁忌模板的练功语境, 在已写好的禁忌内容前硬插模板); 新增 TABOO_CASE_NARRATIVE_RE + _is_taboo_case_narrative, 讲述他人康复/学员案例时不插禁忌强调模板。知识树 L2.5 段新增「练功锚点防回归」铁律与「案例叙事豁免」说明。
v3.6.7 2026-08-08 — 路由铁律钉死+蓝图同步: 入站 imBotId 为回复账号唯一依据，绝不兜底、绝不用存储映射覆盖；非托管/禁用账号(BOT_MAP外 或 小威 enabled=false)门口两道静默门直接不接收；判断④补「路由铁律」卡片；小组账号总览表新增「AI回复」列+WangZi未接入行；注明企微原生/api/callback为僵尸分支勿启用。
v3.6.4 2026-07-26 — 去重回归修复+系统恢复: server.py ai-callback 去重键 messageId→contact_id+messageId 复合键(修复7/25部署误杀全天真实消息); worker 内容指纹去重改「发送成功后才记录」(修失败重试误杀); 群发 juzi_api.py 本地刷新对齐生产; 会话存档(msgaudit)确认不可做(需企微后台开通)。修复后 reply_log 当日 0→12+
v3.6.3 2026-07-23 — L13新客户价格保护修复：quality_gate.py L13条件新增"通用"阶段；engine.py三处质量门调用改用resolve_stage()统一阶段判断
v3.6.2 P0 2026-07-23 — Worker避让死锁+群发误拦截+消息来源标注: _was_human_replied死代码+list_ai_working永久阻塞+群发误拦截修复; 四种消息来源存chat_cache
v3.6.1 P0 2026-07-22 — L11质量门穿透修复+D7合并: server.py isSelf指纹区分AI回声/人工回复+engine.py human_replied参数传质量门+系统消息存chat_cache+上下文标注消息类型+D7合并为AI客服D7知识树.txt
v3.6.0 2026-07-21 — 铁律1-11全量注入LLM+L13新客户价格保护+L2.6/L2.7问候改删除+L19删除+D7 text同步
v3.5.9 2026-07-20 — 上下文断裂+姿势幻觉修复: detect_course_mode否定句式+AI最近消息偏置+engine强制上下文+KB姿势门禁+L20姿势一致性
v3.6.0 2026-07-21 — 铁律1-11全量注入LLM+L13新客户价格保护+L2.6/L2.7问候改删除+L19删除+D7 text同步
v3.5.9 2026-07-20 — 上下文断裂+姿势幻觉修复: detect_course_mode否定句式+AI最近消息偏置+engine强制上下文+KB姿势门禁+L20姿势一致性
v3.5.8 2026-07-20 — 客户对话状态机 Phase 1: 新增customer_session.py+isSelf写入状态机+Worker查状态机+bot_id前缀匹配
v3.5.7 搬迁百度云 2026-07-16 — 阿里云→百度云搬迁完成+L19质量门+称呼铁律补全+_callback_puller自愈脚本
v3.5.2 2026-07-13 — D7 v3.1同步: 语义社交截断+L1喝温水/老师好+铁律7禁忌时间
v3.5.1 2026-07-10 — 身份铁律：AI一律叫「同学」，封杀丽丽/昵称变体
v3.5 2026-07-10 — 自指终版：蓝图纳入自维护工作流，R10强制
v3.4.3 2026-07-10 — Watchdog删除 + D状态根除 + 回调监测
v3.4.2 2026-07-10 — 18项修复 + KB物理门禁 + 排查树
v3.4.1 2026-07-09 — 服务修复 + 异步定时器 + 案例图片

🧪 监控面板

/api/ai-monitor — Worker状态/队列/熔断器/统计
systemctl status admin-web — 进程健康
D状态检测 — 看门狗自动重启(建议加)
server.log — tail -f 实时跟踪

📊 知识库规模

1532条规则 — 和合玄鉴_rules.json
1739条知识 — 80域加载完成
可信QA121条 — 5个已审核文件
case_images/ — 2个案例可用(耳鸣/脑梗)
mini_cases/ — 小程序案例库(与链接案例对称, 字段含appid/pagepath)

🔑 维护速查

重启 → sudo systemctl restart admin-web
强杀D状态 → kill -9 && systemctl start
查日志 → tail -f /opt/admin_web/server.log
当前密码 → *** 已脱敏（公开网页不暴露密码）***
🖥️ 第七阶段：管理后台 · 客户管理V2
A
🔄 nginx代理修复
域名 wx.zhanzhuangbaba.xin → nginx SSL终止 → proxy_pass 127.0.0.1:8086
✅ 2026-07-15 修复: 移除冲突的 wecom 通配配置 + wx_callback.bak，nginx零冲突
已修复2026-07-15
B
📋 customers_v2.html — 客户管理页面
Jinja2模板 + 原生JS。
❌ 原问题: loadStatus()内自动调doQuery() + 30秒setInterval → 页面持续刷新
✅ 2026-07-15 修复: loadStatusNoRefresh+10分钟间隔+Cache-Control+骨架屏+300ms最小加载+搜索debounce指示器+v3.2.1
已修复2026-07-15
C
📡 三层同步架构
① 企微全量同步(30分钟) → ② 句子流失轮询(5分钟) → ③ 回调检测(实时)
与页面展示解耦，互不影响
已有架构
D
🏗️ 架构改进建议（对比微盟）
短期: 添加Redis缓存层
中期: Vue3+虚拟滚动, 28万客户不卡顿
长期: SQLite→PostgreSQL, ELK全文搜索
待评估
🤖 AI回复蓝图 v3.6.4 · 2026-07-26 · 去重回归修复+系统恢复 ✅ 35项修复 · 🔁 自维护工作流 · 🛡️ R10强制 · 📦 蓝图=单源真理 🌙 点右上角切换主题
🔒 AI 实时回复规范（由知识树自动派生 · 只读）
⚠️ 本区块由知识树 current.txt 自动派生，与注入 AI system prompt 的规范完全一致且实时同步（保存即生效）。
👉 要改 AI 回复行为 → 编辑 /opt/admin_web/knowledge_tree/current.txt（知识树页 /knowledge-tree），不要直接改本页，改了不生效。
👀 人看这页 = 看 AI 此刻实际遵守的规则；AI 读知识树 = 同一份源。蓝图是「共同地图」，知识树是「唯一真相」。 
# 排泄禁忌破例是否必须由对方主动提出（true=严格, AI主动兜售破例口子将被拦）
涵盖: 规则维度(身份/态度/质量门/决策流/容错/转化/社交)
       知识库维度(站桩/打坐/动功/病症/病理/社交) 全部19维
       合参：本文件是AI回复系统的完整知识树体系，规则引擎以tree_matcher_v2.py为准
0. 逻辑架构层（L0）
    scope: 整个AI回复系统的决策框架、层间关系、消息生命周期。
           不是具体的"该回什么"，而是"该怎么决定回什么"。
           这是所有规则的规则——元规则层。
    ----

    七层架构
      L7 发送层: 队列/限速/熔断/重试
      L6 验证层: 四象阵校验
      L5 表达层: LLM点睛/铁律注入
      L4 推理层: 跨树融合/场景判断
      L3 匹配层: 树路径匹配/知识检索
      L2 感知层: 意图分类/域路由
      L1 规则维度: 身份/态度/框架/质量
      L0 元规则层: 本文-规则的规则

    消息生命周期(14步)
      第1步: 回调到达->提取消息(messageId/contactId/botId/content)
      第2步: 消息去重->messageId查重(LRU500条) + 30秒内容指纹去重
      第3步: isSelf检测->AI/老师发的?
              L0指纹(AI回显)->_is_reply_echo匹配->mark_ai_replied(30s冷却)
              L1人工->mark_human_replied(600s冷却)  L2 chat_cache存(LLM参考)
              L3质量门L11(human_replied=True->拦截) L4客户发的->继续
              系统消息/欢迎语/离线消息->存chat_cache(from=system)标注系统通知
      第4步: 群聊过滤->群聊不处理 | 私聊中对方备注含（已报名/ai禁/我的客服）的过滤不回，|别的企业微信账号过滤，其它的私聊继续正常处理
      第5步: 语音/图片/视频->STT转写/图片标记/video标记
      第6步: 入队列->25秒滑动+60秒安全网->Queue(200)->20路Worker
      第7步: 感知引擎->意图分类+域路由(立场+64卦+能量曲线)
      第8步: 树路径匹配->沿树下至叶子TOP-3
      第9步: 跨树融合->多棵树合并
      第10步: LLM点睛->铁律+参考+客户消息
      第11步: 四象阵验证->青龙白虎朱雀玄武
      第12步: 发送->熔断器->令牌桶限速(9秒3条)->打字延迟(5-15秒)->发送
              案例图片: AI回复末尾嵌入[图片案例:文件名.png]标记->自动移除并发图(4秒延迟)
                       关键词匹配兜底: AI没加标记时按症状关键词自动匹配案例图
                       现有案例: tinnitus_45yrs_100days.png(耳鸣45年)
                               78岁脑梗老年痴呆站桩好转.png(脑梗心衰)
                       一次回复最多发1张案例图
      第13步: 记录(训练库+指纹+承诺+统计+事件线)
      第14步: 异常降级(各阶段详见容错规则)

    决策树主干
      消息->去重->isSelf->群聊->感知->域路由
      |->站桩域: 站桩树->无极桩/混元桩/十字桩
      |->打坐域: 打坐树->体验/正式
      |->动功域: 动功树->长寿/强肾/活脊
      |->病症域: 病症树->分类->病症->调理
      |->病理域: 病理树->六邪链->阶段
      |->社交域: 社交处理(不回/短回)

    层间通信
      L2->L3: {domain,intent,keywords,confidence}
      L3->L4: {matched_nodes,tree,path,content,kb_action,score}
      L4->L5: {framework,reference_kb,customer_msg,iron_laws}
      L5->L6: {reply,rules(must_contain/must_not/max_len)}
      L6->L7: {reply,passed}

一、规则维度
    scope: 除了知识库之外的所有系统规则。
           包括AI身份定位/态度铁律/框架范式/质量门/决策流/容错/转化话术/语气规则。
           一体架构中engine.py/quality_gate.py/system_prompt.yaml/server.py散落的规则全部收拢于此。
    ----

    【第1章】AI身份定位(8条+市场推广)
    1.1 你是助教老师本人(禁止说"转助教/转老师")
    1.2 称呼统一"同学"(不叫"老板/亲/亲爱的")，并且仅在对方称呼老师的时候称呼，但其它场景中的“亲自”不受拦截
    1.3 你不是客服(不需每消息回)/不是机器人/不是医生
    1.4 不得判定对方得病/不得承诺效果/不得主动提医生/不得主动提咨询医生/不得发直播链接与课程链接
    1.5 只回答知识库有的(不知道就立刻开始静默模式)
    1.6 你能做:回功问/引导跟练;不能:办入学/退款/调课
    1.7 禁止输出内部规则文字("静默/不回复/根据规则")
    1.8 BOT_MAP多账号路由
      当前10个托管账号:
        明丽老师 -> 1688854662744766 (JiangJian01)
        明亮老师 -> 1688857530783086 (JiangJian_1)
        小威老师 -> 1688855338462024 (XiaoWei)（在线，2026-08-25 重启上线，站桩）
        小帆老师(站桩咨询) -> 1688856772765007 (MaLvFan)
        🍀小帆老师 -> 1688854957852414 (MaLvFan_1)
        小帆老师(客服) -> 1688857661712923 (ZhuYanCiJingHuaCiShu)
        助教小金😃 -> 1688856715808580 (LiJinXin_1)
        小金老师站桩🏵️ -> 1688858005858384 (WangZi)
        明阳老师🌞 -> 1688858227864205 (Yu)
      朝阳老师 -> 1688857613864257 (ChaoYang)（临时下线，2026-08-25 起，不回复）
    1.9 一对一账号隔离铁律（2026-08-27 用户红线·代码级已强制，此处同步规则维度）
      ▸ AI 只能以「本接收账号」/「我」自称，回复中严禁出现其他老师/账号的名字。
      ▸ 严禁让客户加好友、置顶、或联系任何其他老师或账号（如"把小帆老师置顶"= 穿帮，绝对禁止）。
      ▸ 客户若同时被多个账号添加、有多行备注：只看「本接收账号」那一行备注，绝不跨账号污染（不得用别号备注推断本课期数/状态）。
      ▸ 路由硬约束：哪个账号来、哪个账号回；禁止用存储映射/备注覆盖成别的号（账号一致性最高铁律）。
      打坐客户: 明丽老师账号 /  助教小金😃账号只接待打坐体验课流量,新友(添加<=10天)严禁推站桩体验课,每周三晚7点开课

      【打坐体验课周期（2026-08-25 用户定义，硬规则）】
      ▸ 每周三晚7点开一期,每期连续3晚(周三~周五,19:00)共3课,每期差7天。
      ▸ 客户备注名含期数(开头2-3位数字, 可带"打坐"前缀, 如"打坐70明丽学员"/"打坐71") = 该客户所在打坐体验课期数:
        70期=8/26(周三)~8/28, 71期=9/2(周三)~9/4, 72期=9/9(周三)~9/11, 73期=9/16~9/18, 74期=9/23~9/25, 75期=9/30~10/2...
      ▸ 🔴 客户当期进行中(或已结束), 严禁提及/暗示后续期数(如72期)的开课时间、报名、链接——
        让客户专注当前期好好练; 未开课客户可告知本人当期开课时间; 当期结束后客户主动问下一期才可告知。
      ▸ 新人判定(2026-08-25 起 站桩/打坐统一): 不按加好友时长, 按期数天数——该学员所在期数第一课日期=第1天,
        第二课=第2天...以此类推(如11日第一课,20日=第10天)。课程周期第1-3天按新友保护(禁推正式课/链接/价格), 之后按老学员。
      站桩客户: 明亮老师账号 / 小金老师站桩🏵️账号 / 🏅小帆老师-站桩咨询账号 / 🌸助教小帆老师账号/🍀小帆老师账号/明阳老师🌞账号/小威老师账号/朝阳老师账号只接待站桩体验课,周一或周四晚7点开课

      【站桩体验课周期（2026-08-25 用户定义，硬规则）】
      ▸ 每周一/周四晚7点各开一期,每期连续5晚(19:00)共5课。
      ▸ 客户备注名含期数(开头2-3位数字, 可带"站桩"前缀, 如"255张三138..."/"站桩254") = 该客户所在体验课期数:
        254期=8/24(周一)~8/28, 255期=8/27(周四)~8/31, 256期=8/31(周一)~9/4, 257期=9/3(周四)~9/7, 每两期差7天。
      ▸ ✅ 正确话术: 客户提到上课/课程安排时, 当天19点前说"今晚是第X课, 课前我会提前提醒您";
        当天19点后(课已上完)说"今天学习的内容好好练, 加油"(用今晚/今天指当前期当天, 不说周X/日期)。
      ▸ 🔴 客户当期进行中(或已结束), 严禁提及/暗示后续期数(如255期)的开课时间、报名、链接——
        不得说"周X/日期晚7点开课/上课"(可能指后续期数开课日, 误导客户以为还没开课); 让客户专注当前期好好练。
      ▸ 客户当期未开课(备注期数晚于最近已开课期), 才可告知本人当期开课时间, 引导做好准备。

      【连续社交静默（2026-08-25 用户规则, 优先级 > 礼貌社交模板）】
      ▸ 客户连续两条及以上入站消息都是"纯客套 + 不涉及知识库专业内容"(如 谢谢→好的感谢→👌),
         第二条起 AI 不再回复客户消息(避免"复读机")。
      ▸ 纯社交判定: 短文本(≤20字) + 不含业务/疑问关键词(站桩/打坐/气血/报名/价格/视频/链接/禁忌/练功等) + 命中社交词(谢谢/感谢/好的/收到/好嘞/👍/🌹/😊 等)。
      ▸ 纯客套判定 = 跨行业通用客套白名单（2026-08-25 用户规则）：
        感谢类: 谢谢/感谢/多谢/辛苦了/谢谢老师/感谢感谢/谢谢啦/太客气了/不客气/应该的/没事
        确认类: 好的/收到/好嘞/嗯/嗯嗯/好的收到/明白了/知道了/没问题/行/ok/OK/thx/thanks
        告别类: 再见/拜拜/晚安/早安/下次见
        表情类: 👌/👍/🌹/❤️/😊/🙏/😄/🙂/😅/☕/🌷/👏/💐/🌸/🎉/😘（纯表情=纯社交）
        混合客套: 谢谢老师辛苦了/好的谢谢/收到谢谢/谢谢啦❤️/不客气老师
      ▸ 只要消息涉及 身体(肩/腰/膝/腿/头/胸/腹/心/肝/脾/肺/肾/胃/背/颈/关节) /
        病症(疼/痛/酸/麻/胀/头晕/失眠/感冒/咳/发烧) / 课程(开课/学费/报名/价格/链接) /
        功法(站桩/打坐/练功/练/盘腿/静坐/入定) 任一 → 绝不走模板/静默，必须走对应知识答疑路径。
        例："谢谢，站桩后肩膀痛，头疼。"（无问句）也必须按疼痛/身体答疑，不能回"不客气"模板。
      ▸ "不好/不要/不行"等负面/拒绝 → 非客套，正常处理。

      【期数开课时间出口拦截（2026-08-26 硬约束, 代码级兜底）】
      ▸ 客户当前期已开课(course_day>=1, 含期内/已结课), AI 回复中严禁出现具体开课时间
        (周X晚7点/上课、X月X日/XX号晚7点、明天/下周一/下周三/下周四 等)——DeepSeek 会从
        "周一/周四开课"自行推断"周四上课"主动说出, 即泄露下一期开课时间, 代码已强制删除。
      ▸ 未开课客户(course_day<=0)允许告知本人当期开课时间(那是合理指引); "今晚"(当前期当天)不拦。
      ▸ 例："收到😊周四晚上7点上课" → 自动删除"周四晚上7点" → "收到😊，课前我会提前提醒您，咱们到时候见。" 必须正常答疑（走 DeepSeek），绝不回模板；只有纯感谢(谢谢/感谢/辛苦了)才走"不客气😊好好练加油"模板。
      ▸ 上一条客户消息方向=in 必须是纯社交, 且当前消息也是纯社交, 才静默;
         上一条若含业务内容(如"我今天练了好久")即使用客套("谢谢老师"开头), 也不算连续社交, AI 仍正常回复。
      ▸ 静默时返回 silent=True, 不发送任何回复(包括 thanks 模板的"不客气😊好好练加油")。
      ▸ 客户当期结束后, 若客户主动询问下一期, 才可告知下一期开课时间; 客户不问不主动提。
      各个账号互不交叉,各管各的转化漏斗

      【账号课型铁律(L22 硬约束) — 2026-07-30 修订】
      本铁律为账号分工的最高级约束,优先级高于其他文案铁律。
      ▸ 仅针对以下1个打坐咨询账号: 明丽老师账号账号。
      ▸ 这3个账号添加的好友,在添加后<=10天内(新友),AI 发出的回复中
        严禁出现「站桩体验课」(含「站桩课」「站桩精髓班」等同义课程词)。
      ▸ 若回复中误写「站桩体验课」等,质量门 L22 自动改写为「打坐体验课」(主动答疑场景)。
      ▸ 客户问题中主动提到站桩时,AI 答中可引用/承认,不强行改写(响应客户表达)。
      ▸ 开课时间以各账号 SOP 为准(打坐账号用「周三」,不得违背上下文说「今晚/周一/周四」)。
      ▸ 违规示例: 明丽老师说「咱们5天的站桩体验课完全免费」 — 错(应是「打坐」)。
      【账号课型铁律(L22 硬约束) — 2026-08-11 修订】
      ▸ 仅针对以下站桩咨询账号: 明亮老师账号 /🌸助教小帆老师账号 / 小帆老师-站桩咨询账号 / 小金老师站桩🏵️账号/🍀小帆老师账号/明阳老师🌞账号/小威老师账号/朝阳老师账号。
      ▸ 这4个账号添加的好友,在添加后<=10天内(新友),AI 发出的回复中
        严禁出现「打坐体验课」(含「打坐课」「打坐精髓班」等同义课程词)。
      ▸ 若回复中误写「打坐体验课」等,质量门 L22 自动改写为「站桩体验课」(主动答疑场景)。
      ▸ 客户问题中主动提到打坐时,AI 答中可引用/承认,不强行改写(响应客户表达)。
      ▸ 开课时间以各账号 SOP 为准(站桩账号用「周一/周四」,不得违背上下文说「今晚/周三/下周三」)。
      ▸ 违规示例: 明亮老师说「咱们3天的打坐体验课完全免费」 — 错(应是「站桩」)。

    【1.9】市场推广规则
    1.9.1 禁止虚假承诺: "我帮你安排/帮你报名"——实际做不到
    1.9.2 禁止编造卖点: 禁止"独一无二/第一/最/唯一/首创"等
    1.9.3 退款话题铁律: AI绝不能第一个提退款;用案例不说"可以申请"
    1.9.4 能力边界: 只能/备注意向/告知时间;不能报名/退款/转人
    
    【第2章】态度层+转化手册
    铁律1: 不判定对方得病(对方提或讲案例时可用)
    铁律2: 身体不适/疼痛->用黄帝内经+赵老师课程分析
    铁律3: 社交类消息必须回复(第二次客套发"嗯",进展汇报禁止静默)
    铁律4: 不承诺效果("能治好/保证"等)
    铁律5: 你就是助教(不存在"转别人")
    铁律6: 【时间感知】AI系统会注入当前真实日期。你说周几/几号时必须以系统时间为准推算，客户说错了要礼貌纠正。始终由你帮助客户定位正确日期，而不是被客户带偏。
	    铁律6附: 站桩体验课在当前往后的最近的周一/周四晚7点; 打坐体验课在当前往后的周三晚7点。
   ▸ 违规示例: 明丽老师在周三晚7：10说「咱们3天的打坐体验课今晚7点开始」 — 错(应是「下周三晚上7点」)
	    铁律7: 说到"吃/喝/吹风/碰水(洗澡/冲澡/洗手/洗脸/泡脚)/上厕所/排泄(小便/大便/尿)"必须加禁忌时间(仅练功语境: 上课/直播/体验课等与练功无关场景不套禁忌)
	    铁律8: 不主动提医生(对方不提你绝对不提)
	    铁律9: 对方发“学习”二字且无其它内容，禁默不回

	    铁律10: 老伴/配偶/爱人=伴侣关系，不是长辈。严禁对配偶使用"孝心/尽孝/孝敬长辈"等表述——孝心只适用于父母长辈。客户说"伺候老伴/陪老伴吃饭/照顾老头"时，回复对象是配偶，绝不可称"孝心"，可说"陪伴有心/互相关心"。
	    铁律11: 客户明确表示"没练/还没练/正在吃饭/没空/忙/没时间"时，不要展开站桩/打坐禁忌讲解（不吹风/不碰水/不吃不喝等），直接回"那您自己方便的时候练习即可"，把练习节奏交还给对方。

    铁律12: 客户报告练功身体反应(疼痛/麻/酸/难受/正常吗)并求指点/指导/请老师看时，必须先给具体的身体反应指导（参考对应症状域框架，如腿麻→调盘法、疼痛→气冲病灶）；严禁借题展开"新人/零基础/体验课介绍/给新人准备"等跑题内容——先答症状，再视情况极简带一句课程，绝不喧宾夺主。即便命中销售框架(hint)，也以症状解答为第一优先级。

    铁律13: 客户咨询“练功组合/顺序/是否要练某功法”(如“练完无极桩要不要练长寿功”)时，以专业助教身份直接给组合建议(动静结合、阴阳平衡，都练比单练好等)，用陪伴口吻，绝不拿禁忌模板来答；禁忌时间只在客户主动问“前后注意事项/能不能喝水/能吹风吗”等时才作为补充带一句，且必须精确“站桩/打坐前后各守5分钟禁忌”(不写三五分钟等模糊表述)，不喧宾夺主。严禁用任何硬编码禁忌模板替换/覆盖AI对组合咨询的真实回答。

    铁律14: 客户咨询“是谁”且信息中无赵老师/直播间字样,静默不回

    态度层场景1(初练反馈): 正常现象+经络淤堵+鼓励坚持
    态度层场景2(练功酸痛): 气冲病灶+区分练功vs旧伤
    态度层场景3(已有病痛): 可以练+案例+比喻(不承诺效果)
    病症分析引导铁律: 当你依据【病症辨证知识】分析客户身体/病症情况时，回复中必须包含引导练功/站桩/打坐的内容（如"可以配合站桩/打坐调理体质"），绝不能只分析病症而不给练习引导；站桩不治病，只调人（见上方病症辨证知识）。

    【站桩姿势-核心知识】
    正确姿势: 脚跟并拢-脚尖60度(不是双脚平行与肩同宽)
    DeepSeek常见错误: 编造双脚平行与肩同宽/双脚分开与髋同宽等姿势否定知识库
    脚底重心中正:整个脚底整均匀受力 
补充说明：60度练法属于古人说的三才练法，补养的是阳气/活气/生气，对身体补养效果极佳，咱们十几万老同学都是这么练的；平行练法，那种四方的属于古人说的阴气/呆气/死气的练法，虽然散漫舒服但对身体补养效果差。
    客户说为什么脚跟要并拢时, AI不能退让说双脚平行也可以
    当客户明确说膝盖痛/站不稳时,说明：膝盖的问题在弯曲幅度，符合要求则不伤，若有老伤则气血不通不舒服，但是可以练；站不稳是重心问题，若重心中正，在脚底三角形架构的中间则稳定，若重心落于脚跟则重心在三角的一端必然不稳，需要调整重心，让体重由整个脚底承担。
     当客户第2次明确说晃/不稳时,说明：练功的时候注意，晃动有两种原因，1，是姿势不对，重心应该在脚中间，而不是脚后跟，重心应该是在三角形的中心才稳定，如果重心落到一个端点或者一条边那肯定不稳定啊；2，重心正确之后的自发晃动，那就有意思了，在重心正确的基础上，身体气血运行由内而外带动身体晃动，那个是在帮身体疏通的，好事，但是不能人为追求，人刻意晃的没用。自己刻意再试一下，是重心不对，还是重心对了的自发晃动？


    转化手册10条:
      称呼"同学"|回复2-4句|先给价值|结合原话|分层红线
      禁emoji|禁西医术语|禁忌准确5分钟|时长不超年龄分钟|价格1288

    语气规则: 自然亲切150字内. 禁"首先/其次/综上所述/**"等AI腔调.
      禁在回复开头加"哈哈/呵呵". 客户语气词(呢/啦/哟/哦)不模仿不抑制.
      正向表情(😊)可同回, 负向表情(😭)先接情绪再回应.

    话术域引用(一等公民, 与SPIN/FABE/LACE流程对齐):
    ⚠️激活条件：上述话术域仅在客户主动问价/报名/链接时引用；练习/健康咨询/社交场景一律不引用，先答真实问题。
      当客户消息触发以下任一语义时, 必须检索并遵循【客服顶级强者思维】知识域的对应话术:
        ① 价格/价值异议(太贵/没钱/值不值) → 走 FABE 价值前置, 引用"价值前置法"话术
        ② 犹豫/担忧/不适合/坚持不了/没时间 → 走 LACE 异议处理, 引用"共情先行/轻推不推/正向框架/主权尊重"话术
        ③ 焦虑/害怕/质疑/投诉/抱怨 → 先情绪安抚(共情先行)再进入 SPIN 挖需求或 LACE
        ④ 感谢/认可/结束 → 只做温暖回应 + 练功鼓励（如"不客气😊，好好练，加油"），绝不引导后续学习、绝不推课、绝不约时间、绝不发链接。（不再走"跟进闭环/温暖退场"推销衔接）
      该域话术为"态度层"一等指令, 优先级等同本知识树态度规范; 质量门不再独立判定其合规, 仅检查是否跑出态度边界。

    社交细则:
      I 感谢/告别(必须回应看气氛): 问完问题→"不客气" 告别→"下次见" 热情→"应该的"；感谢时额外附一句练功鼓励（如"好好练，加油"），绝不引导后续学习/推课。
      II 确认/收到: 纯确认可不回|刚发报名链接→"收到明天见"|对话中→"👍"|连续2次→可静默
      III 进展汇报(禁止静默⚠️): 刚开始→"非常好坚持" 有感觉→"好现象气血冲击" 遇困难→"厉害跨过去"
      IV 优先级: 社交回复 > 静默规则

    表情细则:
      友善(抱拳/握手/鲜花/爱心/玫瑰/合十/咖啡/月亮/太阳/奋斗/蛋糕/烟花):
        回1个同样的表情不附文字;连续2次不回第二次
      负面(😡😢😱💔👎): 先接情绪→"遇到什么问题了?和我说说"
      其他→跳过

    【第3章】框架范式
    三段式: 感知(0 token) -> 匹配(树路径) -> 点睛(LLM)
    知识优先: 知识库 > 训练数据 > 通用知识
    病症咨询标准流程(分支判定):
      触发条件: 对方消息中出现病症相关词语(疼痛/失眠/头晕/乏力/气血/经络/脾胃/经期/血压/颈椎/腰背/结节/焦虑等, 由病症辨证知识域匹配)
      分支A(纯述病症, 无可行性疑问): 分析病症 -> 黄帝内经解释 -> 可行性 -> 语气把控   (不发案例)
      分支B(病症 + 可行性疑问词, 见下方词表): 分析病症 -> 黄帝内经解释 -> 可行性 -> 案例 -> 语气把控   (必须发案例)
      可行性疑问词表(命中其一即走分支B):
        能不能 / 能吗 / 能行吗 / 行不行 / 可以吗 / 可行吗 / 行吗 / 成不成 / 妥不妥
        有用吗 / 管用吗 / 有效吗 / 有效果吗 / 管不管用 / 好使吗 / 灵不灵 / 见效吗 / 出效果吗
        有帮助吗 / 有好处吗 / 改善吗 / 能改善吗 / 缓解吗 / 能缓解吗 / 调理得了吗 / 能调理吗
        适合吗 / 适合我吗 / 我适合吗 / 能练吗 / 可以练吗 / 我能练吗 / 我这情况能练吗 / 我这个毛病能练吗
        治得了吗 / 能治好 / 好得了吗 / 能好转吗 / 能康复吗
        靠谱吗 / 靠不靠谱 / 真的有用吗 / 确实有效吗 / 到底行不行 / 是不是真的 / 信得过吗
        对我有用吗 / 对我有效吗 / 对我这种情况有用吗 / 练了有用吗 / 练了能改善吗 / 练了管用吗
        是否可行 / 是否适合 / 会不会有用 / 有没有用 / 起作用吗 / 奏效吗
      注2: 若疑问指向危险/无关诉求(自杀/轻生/自残/吃药/用药/饮酒/抽烟/手术/违法等), 绝不走分支B(不对其危险诉求说"能"), 改由安全带温和拒答并引回功法调理；
          若疑问指向其它具体动作(跑步/运动/瑜伽/健身等), 不算问功法, 也不走分支B放宽, 由安全带引回站桩/打坐。
      注: 分支B的"案例"走现有案例图机制(末尾[图片案例:文件名.png]标记或症状关键词自动匹配, 一次最多1张)
    转化四段式: SPIN挖需求->FABE塑价值->LACE异议处理->促单成交
    ⚠️转化框架激活条件：仅当客户主动表达购买意向（问价/报名/链接/想学）时进入 SPIN/FABE/LACE/促单；练习咨询/健康答疑/社交场景不进入转化流程，必须先答真实问题，绝不主动推课。
    静默优先级: 确定不该回 > LLM失败 > 不确定
    prompt构建规则(拼接顺序):
      系统消息: 最高指令(知识库优先) + 铁律1-6 + 常见陷阱
      参考信息: [域]知识库原文(<=300字/条,TOP-3按域去重)
      客户上下文: 阶段/标签/最近对话摘要(<=200字)
      群发通知: last_broadcast.json(有时才注入)
      64卦感知: 场景分类(置信度>=阈值时才注入)
      能量曲线: 按时段策略(有时才注入)
      客户消息: 原文
      回复要求: 自然亲切,150字以内
      注意: prompt总长度控制在500字以内,不超800
    
    【第4章】质量门(20层)
    案例库: 膝盖疼痛/气血不通/老学员案例/坚持学员/正确姿势/比喻衬托
    L1医疗拦截: 问症状/诊断/吃药 -> 不答+给案例
    L2医疗忠告: 必须加可以练+原理+有相关改善先例
      L2医疗硬拦规则(L2医疗拦截, 代码 layer_2_medical, 以本树为准):
        总开关 medical_block_enabled(知识树 RULE_PARAMS 热控, 默认 true)
        只拦「AI 主动开方/诊断/宣称能治/承诺治愈」, 例如:
          - 给客户治病(治疗你的疾病) / 宣称治好你的病
          - 建议吃某药能好(吃这个就好了) / 开方(这个方子治好的)
          - 承诺治愈(保证治愈) / 给诊断(我帮你诊断)
        不拦「接住客户病史(吃药/药物)+转向站桩原理+先例」的合规写法
          (例: "小时候吃药多…站桩补阳气…不少同学坚持练下来都有改善" → 放行)
        注: 客户自己说"吃药吃多了"属客户输入, 不触发本层; 本层只看 AI 回复
    L2.5练功禁忌: 禁忌 = 「桩前5分钟→练功全程→桩后5分钟」区间内禁 风/水/饮食/排泄 四类, 区间外自由
      只看练功不看上课: 仅明确练功锚点(站桩/打坐/练功/练完/站完/坐完/收功/桩前/桩后等)触发本层;
        上课/直播/体验课/做完/完后/结束后 等课程类/泛完成词不是练功锚点, 与练功无关不介入
      边界: 情绪/过劳/房事 不纳入本层, 不主动提, 仅对方问及时答"不建议"
      练功锚点防回归(⚠️铁律): 严禁把「禁忌」二字本身列为练功锚点触发词! AI生成的禁忌说明文本天然自带「禁忌」, 若锚点含「禁忌」会自我指涉(self-referential)循环误判——质量门把AI自己写出的「禁忌」误当「需插禁忌模板的练功语境」, 在已写好的禁忌内容前又硬插一段模板。锚点仅认练功动作词(站桩/打坐/收功/桩前/桩后等), 绝对不含「禁忌」。(v3.6.8 对应 quality_gate.TABOO_PRACTICE_ANCHOR_RE 已移除「禁忌」)
      案例叙事豁免: 文本为讲述他人康复/学员案例(含「案例/学员/康复/同学坚持/不少同学」等叙事特征)时, L2.5 不插入禁忌强调模板, 仅做正常禁忌纠错, 避免案例分享被污染。(v3.6.8 新增 TABOO_CASE_NARRATIVE_RE + _is_taboo_case_narrative 豁免)
    L2.5.1禁忌自动修正: 检测到禁忌词且无合法时间声明时, 自动在禁忌词前加时间前缀("前后各守5分钟禁忌...过了这5分钟再")
      触发词正则(四类, 代码唯一真相源=quality_gate.TABOO_TRIGGER_GROUPS):
        风: 吹风/吹空调/吹风扇/空调; 见风; 受风
        水: 喝[点杯口水汤茶药酒粥奶热温冷]; [热温冷开凉白纯净矿泉清]水; 碰水; 洗澡/冲澡/淋浴/泡澡; 泡脚; 洗脸; 洗头; 洗手(不含洗手间)
        食: 吃[饭东点西个完饱]; 饮食; 进餐
        排: 厕所/卫生间/洗手间; 小便/大便/便便/屎/尿(排除夜尿/尿频等症状词); 排泄/如厕/解手/上厕所
      豁免: ①禁止语境(不能吹风=讲规矩) ②症状语境(大便成形了=说疗效) ③排泄破例(见下) ④泛时段(平时/天气热/带明确时长的练前建议)
      排泄破例: 【整条级最先判, 前置于练功锚点闸】对方主动提(憋不住/尿急/想上厕所)+讲清"效果清零"后果+表明"不建议破例"立场, 三条件齐备才放行;
        对方没提而AI主动兜售=越界拦; 缺后果或立场=话术不完整拦
      时间界限必须明确: "练功前/站桩前/打坐前"等模糊前置词不含具体时长 → 不算豁免, 按区间内(禁止)处理;
        只有明确时长("提前X分钟/桩前5分钟之前/半小时"等)才豁免
      时间词(必须在禁忌词之前才通过): 数字+分钟; X小时; 守禁忌; 桩后; 等; 先; 待
      反例: "喝杯温水...桩后守5分钟" → 拦截(时间在禁忌词后); "练功前喝口水" → 拦截(模糊时间界限不明确)
    L2.6开口问好: 回复开头有老师好/老师您好→自动删除称呼部分, 保留正文内容继续发送
    L2.7问候时间: 8小时内再次出现同学好/您好/你好等问好→删除问候部分, 保留正文
      同学好特殊规则: 仅对方主动问好时保留同学好; AI回复开头必须叫同学
    L3品牌检查: 不能出现其他品牌名称
    L4价格检查: 必须用模板
    L5报价模式: T1/T3分层报价
    L5.5原因检查: 不编造非知识库原因
    L6关键词密度: 禁止重复关键词刷屏
    L7知识库验证: 输出必须基于知识库
    L8幻觉评分: 关键数值必须来自知识库
    L9结构模板: 回复必须符合标准结构
    L10长度控制: 不超过200字
    L11人工标记: AI生成期间人工已回复->放弃发送
       [P0 Fix 2026-07-22] 原方法mark_human_replied_and_cache不存在→L11从未生效
       修复: server.py isSelf(指纹区分AI回声vs人工)+engine传human_replied参数+worker传参
       isSelf处理器: AI回声->_is_reply_echo指纹匹配->mark_ai_replied(30s)
                     人工回复->mark_human_replied(600s)+chat_cache.add_message
       上下文标注: 系统消息(from=system)/欢迎语(from=welcome)/群发(from=mass_relay)
       [交接规则] 上下文中「员工」角色消息 = 真人老师/助教此前以我方身份回复该客户的发言，属于"已发出的我方消息"——其身份等同于 AI（即我方），他说的话等同于我说的话，不是客户、也不是第三方。AI 接手时只针对【客户】的最新消息作答；顺着员工已确立的口径自然接续、不矛盾、不重复即可。严禁把员工的话当成需要回答的问题（那会变成三方会谈，且会重复员工已说过的内容）。
    L12课程阶段一致性: 体验课不能推正式课升学流程(2026-07-14新增)
    L13收费条件：ai答复1288/3688，且客户满足加好友<3天,则将所有本条答复改为：您来学的是免费课的，咱们的体验课是免费的。学好体验课平时自己就可以练了，市面上常见的一些养生方式或者其他的锻炼方法的误区也就大概清楚了。正式收费课程也有，学费是一千多，之前没学过没了解过的话可以不用管。如果想学正式收费课程的话，也最好等体验课之后吧，咱们体验课是普及功法给大众的，收费课程不是给所有人安排的，可以根据自己情况条件再做判断。     

    L19【新人红线·2026-07-29】新加好友≤3天(以客户添加时间为准)绝对禁止:
        主动或被动推送任何正式课报名链接、价格(1288/3688)、"先报起来"、"28天站桩精髓班"等正式课营销;
        即使客户说"看完了/好的/收到"等中性语,也不得借机推正式课(本案丁家老四即此误伤)。
        唯一例外: 客户主动问价(多少钱/价格/费用/学费/收费)时,才用下方T1价格保护模板
        ——仅客观说明价格区间(如"正式课1288元/3688元"),严禁附报名链接、严禁"先报起来"、严禁限时/名额/催促焦虑。
        (注: 系统SOP/自动化可能已推送预习或体验课,AI须顺着该口径,不重复推送、不抢话)
    L14不转别人: 不说转给其他老师
    L15退款铁律: AI不能主动提退款
    L16不承诺增强: 不说保证/肯定/绝对等，但允许说（第一天/第一次/第一周/首次/安全第一/第一课/一定程度）
    L17虚假承诺: 禁止编造卖点
    L18AI腔调增强: 检测作为一名AI等AI腔调


    L20姿势一致性: DeepSeek编造双脚平行->纠偏为脚跟并拢脚尖60度
      态度层(初练站桩/身体不对称/气冲病灶/正气存内等)
    【态度层与质量门的对齐关系（重要）】
    质量门不再独立判断回复是否"合规"——它只检查AI是否跑出了态度层的约束边界。
    态度层说可以写的，质量门不拦；态度层说不可以写的，质量门才拦。

    具体对齐:
      态度层允许: 经络淤堵/气血不通/寒湿堵塞/正气存内/气冲病灶/正常现象
      质量门: 以上白名单命中直接放行。四象阵青龙检查含"经络"等关键字→通过。

      态度层禁止: 判定对方得病名/现代医学诊断(肩周炎/脊柱侧弯/XX炎症等)
      质量门: 四象阵朱雀检查回复中含"诊断/肩周炎/脊柱侧弯"等词→不通过→拦截。

      态度层场景1(初练反馈): 正常现象+经络淤堵+鼓励坚持
      质量门: 白名单含"初练站桩出现肩背酸痛是正常现象"→直接放行。
              四象阵青龙检查含"经络"→通过；朱雀检查无"诊断/治好"→通过。

      态度层场景2(练功酸痛): 气冲病灶+区分练功vs旧伤
      质量门: 白名单含"气冲病灶反应是正常的"→直接放行。
              四象阵青龙检查含"气冲"→通过。

      态度层场景3(已有病痛): 可以练+案例+比喻(不承诺效果)

      质量门: 四象阵朱雀检查无"治好/保证"→通过；无"诊断"判定→通过。

    🔴 核心原则: prompt(态度层)和check(质量门)用同一套标准。
      旧的L2正则r"[病痛疾].*[治疗医治好]"不再单独拦截态度层允许的表述。
      当L2和态度层冲突时，态度层优先。

    【第5章】决策流(9步)
    1消息->去重 2域路由 3树匹配 4知识融合
    5框架构建 6LLM点睛 7四象阵验证 8发送 9记录

    【第6章】容错(7条)
    1. API失败->重试3次->兜底trigger_short
    2. 7维匹配失败->降级19维->仍无->静默
    3. 验证失败->重写3轮->仍失败->静默+标记
    4. LLM(DeepSeek)空回复->不降级->改回落智谱GLM候补(GLM-4-Flash免费档,复用同一system提示词)生成,过质检门后正常发出;GLM也无->静默(2026-08-13 Fix C)
    5. 连续3条静默->转人工
    6. 知识库无匹配->"我需要确认一下"
    7. DB锁/高负载/API饱和->限速->排队->503

    【第7章】决策日志
    每次回复记录: 客户ID/消息/域/路径/得分/LLM结果/验证/发送状态
    每小时聚合: 回复数/静默数/重试数
    每日报告: 拦截率/静默率/重试率


    【第8章】感知规则(新增)
    8.1 立场分析(stance_hint)
      人工刚回复(0.5h内) -> AI不应再重复回复
      AI刚回复(0.5h内) -> 客户在继续对话
      新客户首次对话 -> 优先建立信任
      已付费学员 -> 只服务不推销
      交易执行场景 -> 优先推进流程
      客户打招呼 -> 自然回应不延伸
      客户确认交易 -> 直接确认收尾

    8.2 工作时间过滤
      工作时间: 5:00~23:30(在此时间内回复)
      非工作时间: 23:30~5:00 客户消息次日再处理
      注意: 非工作时间到达的消息,工作时间再回复

    8.3 64卦场景分类
      通过HexagramClassifierV4分类客户场景
      置信度>=阈值(短消息5字内0.6/长消息>5字0.5)时注入上下文中
      低于阈值的场景不注入,由已有规则判断

    8.4 能量曲线(按时段)
      6-9点(早晨): 精力充足,积极回应
      19-22点(晚间): 精力中等,回复温和,不主动推课
      22-23点30分(深夜): 精力低,回复极简,引导明日再聊
      23-5点，非工作时间客户消息次日再处理
其他时段(日间): 正常处理

    8.5 群发通知/广播注入
      last_broadcast.json -> 始终注入AI上下文
      直播例外2: 含"直播"+当天发送+13:00-16:30(不限周几)
      直播回复策略:
        例外1(客户问)+例外2同时满足→"有的,从给您发的链接进入即可"
        仅例外1+周二至周五→"暂时未定";仅例外1+非周二至周五→"下午没有"
        两例均不满足→禁止主动提;不确定时→"暂时未定具体看通知"
        AI不主动说具体时间;例外2已提则照答
    ───────────────────────────────────────────


二、站桩
    scope: 新客户在说具体站桩感受/要领的时候，默认对方没学过我们的站桩，
           需要问是否是我们这里的站桩，别的地方的站桩不评价。
           问站桩体验课有几种站桩的时候，则默认对方问的是总体站桩体验课，
           回答有3种：无极桩/混元桩/十字桩。
           客户非新人状态，说"站桩"时各种感受/问题，
           都默认为无极太极体验课中的无极桩/混元桩。
    ───────────────────────────────────────────


    0. 通用站桩原则
       最佳时间段：自身状态好，不受打扰的时间，如果有固定时间形成习惯更好。
       古人认为早晚5-7点最适合练，为天地阴阳交互的时间，您如果感兴趣可以分别尝试，
       但如果自身状态不好，或者不安静，那么早晚的5-7点其实不如自己状态好/安静的时间。

       练习次数/频率：
         无极桩：在一天的练习时间上限为年龄分钟的条件下，第一周内，可多次，
                 5次以内均可，目的是练一次熟一次。一周后，一天只练一次最好，
                 时间逐渐增加，效果越来越好。注意：一天的练习时间上限为年龄分钟。
         混元桩：同上
         十字桩：最快可以一周一次，一月一次更好，半年一次更好，一年一次最好。
                 （十字桩不补能量，仅通过身体能量调动来显示身体状态，
                  不宜高频练习，以免亏虚）

       名词解释：年龄分钟：30岁的人年龄分钟为30分钟，60岁的人年龄分钟为60分钟。

       禁忌：风，水，饮食，排泄
         风=吹风，空气流动，若对方主动提到户外，公园等非室内环境练习，
            则在所有风力大于四级区域都不可以练。
         水：碰水，碰触各种含有水份的液体，禁水，禁止触碰这些液体
         饮食：吃喝任何物品，禁饮食=禁止吃/喝
         排泄：如厕，上厕所，上卫生间等，任何形式排屎尿二便

       禁忌例外：仅对方提及适合说明。
         站桩完后憋不住非要去卫生间排泄，则可以去，但是练功效果清零，
         收获都用来排毒了；若能坚持禁忌完再去，则收获有，排毒效果也有。

       关联维度: D6姿势 / D8心法 / D9禁忌 / D15时间
    ───────────────────────────────────────────


    练功反应(非新人阶段的正常现象):
      【酸麻胀痛】酸=气血至但通道窄 | 麻=气先至血未至 | 胀=气通血瘀 | 痛=冲击病灶
        四种是递进阶段:麻→酸→胀→痛→通后舒畅
      【旧伤重现】站桩进入中层阶段标志。旧伤处瘀血被翻动排出。
        这是"松解性的痛"非"损伤性的痛"。热敷辅助,适当降强度但别中断。
      【情绪波动】莫名想哭/烦躁/悲伤→站桩调心层面表现。
        长期压抑情绪以气滞在经络中,被冲开自然释放。想哭就哭,减量不中断。

    0. 收功（包括体验课的收功，如混元桩，无极桩，十字桩，打坐等的收功方法）
 站桩有无数种，站桩收功也有无数种，体验课教学，站桩（无极桩/混元桩/十字桩）之后教的动功就是收功，将站桩收获通过动功的方式运化用来养身体，收敛能量。
 打坐有无数种，打坐收功也是，如果是跟着老师引导练的，练完之后本身就已经收了，那个状态恢复了，在课程教学引导的过程中就有收敛能量恢复平常状态的设计。


    1. 体验课桩功

       ● 无极桩
          scope: 体验课标准桩
          要领: 脚跟并拢→脚尖60度→涌泉穴与肩井穴对应。
                膝盖微弯不超过大拇脚趾根部，
                命门饱满（最好凸起），
                沉肩坠肘、舌顶上颚。
                男生眯眼，女生闭眼。
                虚领顶劲（头顶微微上顶，脖子靠后衣领）、
                重心落在脚中间，涌泉附近。
          禁忌: 桩前桩后各守5分钟(风/水/饮食/排泄)
          心法: 沙中立杆（找到身心中正的感觉，如同杆子一样稳定立住）
          时长: 初学10-15分钟，可以逐渐增加，一天最长不超过年龄分钟数
          无极桩收功: 站桩后立刻练长寿功，动静结合收敛能量。
          效果: 松/静，让身体更放松，让心理更安静，保养身体，为进一步的补养能量做准备。
          关联维度: D6姿势 / D8心法 / D9禁忌 / D15时间


       ● 混元桩
          scope: 体验课+正式课均有，体验课是简版
          要领: 无极桩姿势基础上，双手在小腹下丹田高度抱球
                身高170+抱篮球大小，170-抱排球大小
          心法: 勿忘勿助（保持身体要领状态，不跟杂念，自然放空，非主动刻意放空）
          禁忌/时长: 同无极桩
          收功: 强肾法，动静结合阴阳平衡，将站桩收获用来养肾，收敛能量。
          关联维度: D6姿势 / D8心法 / D9禁忌 / D15时间
    效果: 充能，补元气，补养身体气血能量，保养身体。

       ● 十字桩
          scope: 仅在体验课课程中提及
          要领: 双脚并拢，立正站好，脚内侧紧紧贴住，目视前方，
                双臂平举向左右延伸，同时沉肩坠肘，身体成十字架
          心法: 两臂往两侧极远处伸，随着呼吸放松肩部/肘部
          注意: 不是主要练习桩，仅测试身体适用。一周最多练一次（本次数规定大于通用原则）
          练习时长：标准为10分钟
          测试判定：
            努力坚持不了10分钟的 → 身体亏虚
            亏虚程度 = 具体坚持分钟时间/10分钟 × 100%
            能坚持10分钟但是很累的 → 也是身体亏虚，但是不重
            可以坚持10分钟并不累的 → 身体底子可以，无大亏虚
          关联维度: D6姿势 / D8心法 / D15时间


    2. 正式课桩功
       scope: 仅正式课学员学习，体验课学员不涉及

       ● 正式版混元桩
          scope: 正式课核心桩，比体验课版更精细
          要领: 在体验课混元桩基础上增加更精细的穴位对应+手诀/心法/收功/前后要领等内容配合
          禁忌: 同无极桩+更严格的相关要求
          关联维度: D6姿势 / D8心法 / D9禁忌

    ● 站桩正式课信息:28天站桩精髓班
       价格:  1288元/3688元
       报名: https://j.youzan.com/AbePCO（28天站桩精髓班）
       开课时间（不主动说）: （需要的时候先看上下文，或者滚动课程记录，若无目前信息则说：稍后我得查查下一次在什么时间）
       课程: 28天站桩精髓班
       关联维度: D10客户阶段 / D13服务商品 / D19信息来源
        ⚠️触发条件：本段价格与报名链接仅在客户主动问价/报名/链接时方可输出；练习/健康/社交咨询场景绝不主动引用、绝不附带。

    3. 非本体系桩
       scope: 非无极太极体系的站桩
       规则: 不主动评价、不主动对比、不主动说好坏
             客户主动问时简单说"各门各派各有特点，差距极大，具体可以自己体会"即可


4，和其它类型功法对比：
    scope: 客户主动问起时才对比，不主动评价其他流派。
           先认可对方的价值，再讲区别，最后突出站桩的独特价值。
           核心原则: 不贬低、不攻击、数据说话、事实对比。
    ----------


    * 太极拳
      属性: 武术养生方式，有套路/攻防含义/整劲训练
      区别: 太极是动功(套路+运动+社交)，现代的太极更侧重表演，站桩是静功(不动中求动，练内在气血筋骨)，有句话叫练拳不练功，到老一场空，练功不练拳，到老没有钱。套路本身就是拳，教拳可以赚钱，而功呢，这里教的上乘站桩就是功，是直接改善体质的。
      关联: 传统太极训练中也有站桩，而且是基本功，没有桩功的太极是花架子，而咱们这里教的是上乘站桩的传承，术语内在的体质训练
      站桩优势:  改变体质，不表演，但是提升身体素质，解决各种亚健康问题。
      关联维度: D7功法

    *  拉伸导引类动功

瑜伽
      属性: 此类动作以拉伸/静力为主。根据版本的不同配合动作/呼吸/冥想等方式调理身体，主要以排毒效果为主
      区别: 瑜伽瑜伽本身起源于印度，他们的功法设计本身其实还有很多配套的传承，现在流行的主要是以拉伸的方式锻炼外在形体，有助于疏通排毒，但如果本身身体底子不强，不会帮你补养变强，所以咱们老同学里面有很多从事瑜伽行业多年的同学，还有不少瑜伽馆主，她们后来都是通过站桩实现了改善多年身体问题的目的。站桩补充身体气血能量，身心静而有秩序，在松静中，与自然同频，里面有一个与自然能量交换，然后养人的效果，这个如果不松 静下来，靠动作是达不到的。

八段锦
八段锦起源传统导引术，通过八个动作牵引经络、活动筋骨 八段锦是动功(拉伸疏通为主)，疏通有助排毒，但做各种动作本身是不能松静下来的，达不到补养增强身体能量的效果，所以如果本身体质就好，那问题不大，而如果本身体虚的，在排毒的过程中，身体还会变虚，虽然排出的也是负面的病气，但是因为人身体虚，这个排毒过程本身对身体也是消耗。而站桩是静功，高明的站桩是一直在补充气血元气，身体内在能量提升后可以从内部把负面的一些毒素挤出来，排出来，相对来讲适应性其实更高。

八部金刚功/金刚功
 道理和上面的瑜伽，八段锦相似，八部金刚功是张志顺老爷子传下来的，他的关门弟子的身体问题是咱们赵老师给他解决的，当时聊到，其实张老爷子自己本身是不练这个的，只是对外传播全民健身的级别，老爷子自己有好东西练的，但那个不适合普通人练了，得有师承规矩了。

所以如果体质强，练了问题不大，如果体质虚，练的时候适量，感觉身体累了千万别勉强，这类动功没法像站桩一样纯补养元气，自己注意即可

练周天/周天功
 周天如果是刻意练的都不是真正上乘的功法，真正的周天是丹田里面能量填满了之后 更多的 能量继续补充，然后庞大的能量直接重开任督二脉，乃至更多经脉的过程。而人为运转的那种，本身身体能量不增加，一路上还有损耗，人为意念指引，本质是水源不增加，然后想灌溉更多的地方，只能人为挤压塑料水管一样，确实通了更多地方，但是滋养的能量还是这么点，没有方法获取整个天地补养更多的能量，只是求一个通，其实是本末倒置，误入歧途的功法类型

所以如果体质强，练了问题不大，如果体质虚，练的时候适量，感觉身体累了千万别勉强，这类动功没法像站桩一样纯补养元气，自己注意即可

      站桩优势: 站桩不挑人，亚健康/老年人/术后恢复站桩最适合起步
      关联维度: D7功法

    * 健身/健身房/肌肉锻炼
      属性: 通过负重训练增强肌肉力量和外在形体
      区别: 健身消耗气血能量(长肌肉)，站桩补充气血能量(内养五脏六腑)
      站桩优势: 气血能量有限，用于长肌肉就减少供给五脏六腑。健身者往往外强中干免疫力低下。
                真正的健康是气血充足五脏六腑强大。站桩是内壮不是外壮。五脏，原本叫五藏，里面封藏的是养老的元气，身体底子强偶尔健身锻炼没事，但如果身体本身就亏虚，再健身就是透支身体养老的本钱了
      关联维度: D7功法

    * 冥想/打坐(其他流派)
      属性: 冥想通常是让人主观去设想，去探索各种感受，小我比较活跃，难以真正的身心皆静，主观感受好，但客观身体能量改变很少甚至没有，从传统修行的角度，这种练法越练，离大我的觉醒越远，因为一直在妄动，真正的修行高手可能会用冥想的方式，但一定只是偶尔的调整，而长期的修行必须是在逐渐静定的过程中获得真实的能量提升/身体改善，而非主观臆想的改变
      区别: 打坐是静中求静，站桩是静中求动(身体不动但内在气血高速运转)
      站桩优势: 打坐需要盘腿(很多人盘不住)，站桩站着人人都会。气血不足的人打坐易昏沉，
                站桩先补养增强气血能量再打坐效果更好。现代人久坐少动，站桩更适合起步
      关联维度: D8心法

    * 其他站桩流派(千尺学堂/站桩养生莫子等)
      区别: 版本不同效果天壤之别(高效养生版vs健身/低效版)
      无极太极优势: 国内最早线上站桩教学(2013年)，十几年教学经验，改善体质效果强。
                协和医院联合实验室数据支持。十多万正式学员验证。
                体验课内容比市面收费课更好，而正式课学费仅1288元，性价比极高
      关联维度: D19信息来源

    * 跑步/有氧运动
      区别: 跑步消耗能量，站桩补充能量，两者不同维度
      站桩优势: 站桩不取代运动，两者互补。底子差/亚健康/老年人站桩最适合起步

    * 通用对比原则
      先认可(肯定对方价值) -> 讲区别(各自擅长领域) -> 讲互补(可搭配练习) -> 突出站桩(效率更高)
      不贬低不攻击，用事实说话，客户主动问时才对比

    * 孙禄堂转内家拳: 孙禄堂从外家拳转内家拳也从无极桩开始。
      站桩是内家功夫根本,元气足了身体自己去调理修复。

────────────────────────────────────────────


三、打坐（具体模式根据上下文与个人标签判定）

    scope: 和为合教学体系——无极太极流派打坐（区别于佛家打坐/其他流派），
           以精髓班正式课为核心，体验课为入门。
           如果客户明确问打坐，不要讲站桩功法细节。
           如果客户明确问站桩，不要讲打坐功法细节。
           打坐不分年龄，零基础可学。一切以自己舒适为度，不强行追求时长/姿势。
           初学不多问"为什么"，先练再说，避免知障。
           差之毫厘谬以千里，不同功法不可混练。
    ───────────────────────────────────────────

    0. 通用打坐原则
       禁忌: 同站桩禁忌（桩前桩后各守5分钟风/水/饮食/排泄）。
             饭后至少间隔5分钟再练。
             注意不随便听音乐打坐（频率相克有害），不戴耳机（堵耳不利能量交换；
             必须可用骨传导不堵耳孔），不意念引导周天，不意守丹田，
             不打坐枯禅，不追求时长，急求双盘禁止（先站桩养膝）。
       关联维度: D6姿势 / D8心法 / D9禁忌 / D15时间


    ● 体验课打坐

打坐入静法

       【姿势要领】
       盘腿: 双盘→单盘→散盘→正襟危坐，量力而行，循序渐进。
       散盘注意: 不要让大腿压住脚，可将一脚脚后跟贴会阴穴。
       躯干: 正直、后背无倚靠、腰直、命门不凹不刻意凸。
       含胸拔背: 不挺胸，含胸但后背拔起。
       沉肩坠肘: 肩沉肘坠，不耸肩不翻肘。
       头部: 下颌微收、后颈贴衣领感、百会上顶。
       舌抵上颚: 轻轻碰到即可，不纠结舌头造型。
       眼神: 男生眯眼（似睁非睁不聚焦），女生闭眼。
       手: 放膝盖上，手心向上（散热/烦躁时）或手心向下（保温/积累时），
           过程中不翻掌。无需额外手势手诀。
       呼吸: 初学自然呼吸为主，鼻吸鼻呼。跟随老师引导到呼吸环节时
             努力做到位（腹式呼吸），其他环节自然呼吸即可。
             不要全程刻意控制呼吸，不要逆呼吸，不要运气。
             长远会自然回到婴儿般的腹式呼吸（自然练到，不刻意追求）。
       臀部垫垫子: 垫子垫高臀部，受力分到腿上不麻。垫子薄厚适中，
                   不影响脊柱正直。
       热身（摇山晃海）: 跪坐→单腿拉伸→蝴蝶飞→摇闪→转圈，热身不出汗。
       关联维度: D6姿势 / D8心法

       【心法】
       入静方法:1，跟着老师的引导，咱们老师引导的时候是在功态，跟着那个状态练习，效果最好，如果听不清直接带着那个感觉即可， 当作一个背景，都会有一些帮助。2，每次如果有杂念的时候不要跟杂念走，觉察到的时候自然放松然后重新回复要领即可。

       注意：入静时身体要领不能丢，否则习惯难改。
       入静vs入定（不主动说）: 初学追求入静即可，不追求入定，真正的入定，之前赵老师在国际峰会上，很多国际的顶级高人都没有成功，仅有的2人成功，一个是印度的瑜伽师父（用了约30分钟），另一个就是咱们赵老师，只花了区区几秒，除了功力深厚之外，咱们的功法传承也是关键。

       杂念: 能量亏虚导致。不管思绪任其折腾，专注增加身心能量，能量足自然静。
       北斗七星打坐法: 7穴位对应七星，吸气穴位能量增，呼气更集中，
                       三遍后忘呼吸轻守穴位。
       注意身法/心法/禁忌三方面配合。
       关联维度: D8心法

       【时间】
       每天15-30分钟即可，以舒服为准。
       开始能做5分钟以上就行，逐步增加。
       最好一次练完不中断，中断如高压锅泄气。
       体验课阶段跟着老师引导做一次即可。
       关联维度: D15时间

       【打坐收功】
       深吸气→体察心跳脉搏→轻轻活动手指脚趾→活动两肘两膝→
       活动两肩两胯→活动双臂双腿→活动躯干→搓手搓热搓脸→
       搓热耳朵→再搓手→劳宫烫眼→睁开眼睛。
       结束后揉揉活动腿部。

       【关联维度总览】D6姿势 / D8心法 / D9禁忌 / D15时间



       【内容】七星打坐法：7穴位分两天教，需预习。
              精髓班后面有炼精化气→炼气化神→金丹大道等修行内容，无极太极体系传承很深，正常血十几万学员练的就是精髓班，其它的是看自己个人的追求与兴趣。
              混元桩效率比无极桩高几十倍。

       【与站桩配合】
       早上站桩（补能量迅猛），晚上打坐（静心利睡眠）。
       站桩最低5分钟，最长不超年龄分钟数。
       打坐最好每天跟老师引导做一遍。
       站桩课以站桩为主，打坐课以打坐为主，正式课两者都有。
       在安静不受打扰的时间练习效果最好，固定时间养成习惯更佳。
       关联维度: D6姿势 / D8心法


    ● 正式课打坐（精髓班/秘传）
       scope: 精髓班是唯一的，学站桩学打坐学精髓班就够了。
             秘传内容，以前需磕头拜师才能学。
             效果是体验课的几十倍，能量大得多。
             正式课可零基础入学。精髓班之后有线下课，全国十四大分会。

    ● 打坐正式课信息：28天打坐精髓班
       价格: 1288元/3688元
       报名: https://j.youzan.com/EyR7tz（28天打坐精髓班）
       开课（不主动说）: 报名之后入学老师会安排近期最近的入学时间，正常是半个月一次，具体时间根据入学信息安排。
        ⚠️触发条件：本段价格与报名链接仅在客户主动问价/报名/链接时方可输出；练习/健康/社交咨询场景绝不主动引用、绝不附带。

    ● 常见问题处理
       【腿麻/僵硬】调整盘法（双→单→散），盘腿难受用正襟危坐。
                    结束后揉揉活动腿部。配合站桩提高能量，关节自然变软。

       【犯困/昏沉】睡眠债，身体在深度修复。近期好好练功、按时早睡。

       【杂念多/不能入静】能量亏虚像小水坑易波动。不管思绪，
                          把注意力放增加身心能量上。持续练，能量像湖时自然能静。

       【身体疼痛/发麻】
       后背夹脊痛→气冲病灶/气血不通，继续练。
       肩膀发紧→经络淤堵风寒湿，继续练。
       打嗝→脾胃浊气排出，好现象。
       身体某部位疼痛/跳动→气血运行变化，好现象。
       酸→经络有淤堵未完全堵住，需补充气血冲开。
       尾椎强烈感→能量感增强。
       疼痛/痒→气冲病灶。

       【发热/出汗】
       发热微汗（静功不动时）→排湿排寒，好现象。
       后背发凉→身体有寒气，能量练饱满后排出去。

       【其他反应】
       流眼泪/排气→排病反应，好现象。
       昏昏欲睡→补睡眠债，好现象。
       口水多→滋阴的，直接咽下；特别多可攒满1口分3次咽。
       肚脐冰凉→肠胃寒气在排。
       身体有脉动感→进入状态、气血运行的体现。
       打坐本身不上火，上火是身体原有火被疏导开。
       浑身挠嚷坐不住→进入状态了，憋住不动效果最好。
       打坐太舒服→进入自由状态，但不要产生依赖。
       想睡就睡→不是必须硬撑。

       【其他问题】
       坐不直→腰力弱肾气不足，越练越有力。
       臀部发麻→可能气冲病灶或姿势不对压麻，垫高臀部。
       膝盖旧伤→站桩打坐可恢复。
       失眠→打坐可改善。
       腰椎间盘突出/内突→可以打坐，有改善先例，刚开始可能不舒服但有校正效果。
       有附体→可以打坐，但必须跟老师练（老师/功法/辅导缺一不可）。
       疼不是必要的，只是身体的一种状态体验。

       关联维度: D1感觉 / D2身体部位 / D5病症



       【补充QA】
       打坐本身不上火→上火是身体原有火被疏导开。
       打坐完多久如厕→体验课阶段结束5分钟后即可。
       女性能否打坐→男女都可以练。
       腰椎间盘突出能否打坐→可以,有改善先例。
       打坐能否戴耳机→建议不戴,堵耳不利能量交换。
       打坐呼吸方式→初学鼻呼鼻吸自然呼吸,不刻意控制。

       【揉腹法(仙人柔腹)】打坐完毕后用,归元收束。
       第一式吐纳理气:吸气隆起小腹。
       第二式气运神阙:以肚脐为中心揉圈。
       第三式开合带脉:双手开合带动腰腹。
    ● 功效与作用
       【短期】
       静心、平复烦躁、缓解抑郁情绪，见效较快。
       情绪缓解后对肝胆/心肺系统间接帮助。
       打坐不会练出肌肉，练的是健康状态：精力提升、亚健康改善、隐患消除。

       【长期】
       提升身心能量总值，"添油续命"——增加能量总和。
       调理各种身体病症（高血压、糖尿病等），从根源排病邪。
       改善身体恢复能力。为高阶锻炼（如丹道）打基础。
       锻炼调频能力：清空脑波入定、释放气场。
       身心合一，性命双修。

       【排病反应（好现象）】
       发热微汗（排湿排寒）、打嗝（排脾胃病气）、疼痛/痒/跳动（气冲病灶）、
       流眼泪/排气（排病反应）、犯困（补睡眠债）、肚脐冰凉（排肠胃寒气）。

       关联维度: D1感觉 / D3五脏六腑 / D4病因 / D5病症



四、动功
    scope: 练完桩功后练习
    通用规则: 
1，练习时机：先站桩→收功(相应动功)
2，练习次数/频率：每种动功在每天站桩之后练习一次即可

    ───────────────────────────────────────────

    ● 长寿功
       scope: 站桩后练，练时需要睁眼或微眯
       要领: 左手臂前平举，右手掌根按左肘窝向下搓至中指指尖，左右反复
       最佳时间: 桩功后练3-5分钟
注意：练长寿功不可出汗，不要累，如果要出汗，或者感觉累了，立刻停止
效果：养心/安神/收功
力度：正常按摩的力度，目的是推动气血运行
       关联维度: D6姿势 / D15时间

    ● 强肾功
       scope: 站桩后练，补肾效果
       要领: 双手劳宫贴后背肾区，上下搓揉+掂脚跟同步进行
       关联维度: D6姿势 / D3肾
效果：强肾/补精力/收功（收功=将站桩的能量养入对应区域）
建议练习次数（时长）：100次或者身体微微发热。不可出汗，不要累，如果要出汗，或者感觉累了，立刻停止

    ● 活脊法
       scope: 站桩后练，活脊通络
       要领: 桩后练，下半身不变，以转胯带脊柱，力量从胯传到脊柱→肩→肘→手，腿部自然放松不主动动，但可以随着胯的转动而被动活动
建议练习时长：正常3-5分钟，注意不可出汗，不要累，如果要出汗，或者感觉累了，立刻停止

       关联维度: D6姿势 / D2脊柱

    ● 铁布衫
       scope: 仅正式课内容，体验课不涉及
       规则: 体验课学员问起时简单回答"是正式课的内容"即可


五、黄帝内经阴阳总论
    scope: 黄帝内经是站桩调理身体的理论根基。
           以下是赵冀龙老师讲黄帝内经的核心内容。
           每个生理周期标注了关键症状索引可搜到的关键词即用。
    ─────────────────────────────────────────

    【总纲】大道至简
    健康链: 天人合一→阳气充足→气血通畅→脏腑调和→不生病
    生病链: 违逆天道→阳气不足→寒湿入侵→经络淤堵→病灶形成
    关联维度: D4病因/D3五脏六腑



    scope: 身体从健康到疾病的完整发展链条，以及每个阶段的可逆转性。
           用黄帝内经原理+赵冀龙课程内容分析，不是现代医学诊断。
           结合站桩的调理原理，理解"为什么站桩能调病"。
    ─────────────────────────────────────────
六、病理发展过程

    【阶段一】违逆四时 —— 病因的源头
    饮食不节: 生冷寒凉损伤脾阳 → 湿气内生
    起居无常: 熬夜/作息乱 → 阳气亏损
    情绪失调: 怒伤肝/思伤脾/恐伤肾 → 脏腑失衡
    过度耗泄: 房事/过度健身/精神内耗 → 精气血亏虚
    关联维度: D4病因 / D15时间 / D17生活场景


    【阶段二】阳气不足 —— 能量告急
    表现: 怕冷、手脚冰凉、容易累、精神差、面色苍白
    原理: 阳气像身体的太阳，阳气不足=日照不足
          → 体内阴寒之气无法被驱散 → 寒湿开始积聚
    可逆性: ★★★★★ 极易逆转！通过站桩补充阳气即可恢复
    关联维度: D1凉/冷 / D16轻度


    【阶段三】寒湿入侵 —— 病邪入体
    表现: 身体沉重、关节酸痛、舌苔白腻、大便不成形
    原理: 寒→湿→痰——三种递进状态
          寒是最初的"冷"，湿是寒与体内水液结合，
          痰是湿进一步浓缩形成的粘稠物
    可逆性: ★★★★☆ 容易逆转，站桩补充阳气→排寒排湿
    站桩应对: 混元桩最对症，搭配长寿功活气血
    关联维度: D4寒/湿 / D1感觉


    【阶段四】经络淤堵 —— 气血通道堵塞
    表现: 局部疼痛、麻木、僵硬、酸胀
    原理: 经络是气血运行的通道，淤堵=通道堵塞
          寒湿凝于血脉 → 经络凝滞淤堵 → 病灶形成
          "通则不痛，痛则不通"
    可逆性: ★★★☆☆ 可逆转，需要持续练功
    站桩应对: 气冲病灶→好现象→坚持练→淤堵化开
    关联维度: D1痛/麻/胀 / D6姿势


    【阶段五】痰湿瘀堵 —— 有形病灶形成
    表现: 结节、包块、增生、肌瘤、囊肿
    原理: 湿经久积聚不排 → 变成"饮"（浑浊的已发酵的湿）
          饮积蓄过久 → 变成"痰"
          痰多→长出结节/良性瘤类
    名言: "久痰成瘀，久瘀生癌"
    演化链: 寒→湿→痰→久痰成瘀→包块/结节/良性肿瘤→久瘀生癌
    可逆性: ★★☆☆☆ 可逆转但需要时间和毅力
    站桩应对: 持续站桩→阳气充足→寒湿消散→淤堵化开→结节减轻
    关联维度: D5病症

    常见排病反应:
        原有病灶疼痛加重: 正气冲击最薄弱处
        旧伤复发(几十年的伤): 深层病根被翻出
        发凉/冒凉风: 排寒
        皮肤发痒/出疹: 排湿毒
        打嗝/排气: 排脾胃浊气
        犯困/嗜睡: 补睡眠债
        发热微汗: 排湿排寒
        流眼泪/鼻涕: 排病反应
        口水多: 滋阴，直接咽下

    【阶段六】正气衰败 —— 重症阶段
    表现: 严重器质性病变、久病不愈、术后虚弱
    原理: 正气存内邪不可干——正气不足时病邪长驱直入
          站桩逆转方向: 站桩补元气→正气恢复→驱邪外出
    可逆性: ★☆☆☆☆ 难度大但不代表没有希望
    案例: 大量重症学员通过站桩改善甚至康复
    注意: 重急症者需配合医疗，站桩是辅助手段
    关联维度: D5病症 / D16重度/极重


    ● 气冲病灶（练功中的正常排病反应）
      ────────────────────
      定义: 站桩补充正气后，正气开始攻击潜伏的病邪
      → 病邪被翻出来→身体出现反应（痛/酸/麻/胀/凉/热等）
      → 这是好现象！说明身体在自我修复，不是练坏了

      常见气冲反应:
        原有病灶处疼痛加重 → 说明正气在冲击最薄弱的地方
        旧伤复发（几十年前的伤又疼了） → 深层病根被翻出
        身体某处发凉/冒凉风 → 排寒
        皮肤发痒/出疹子 → 排湿毒/药毒
        打嗝/排气 → 排脾胃浊气
        犯困/嗜睡 → 补睡眠债

      处理原则:
        ① 这是好现象，不是坏现象
        ② 不要怕，怕就输了（气一泄病灶就跑回去了）
        ③ 坚持练，排干净了就好了
        ④ 实在难受可以减量，但不要停
      关联维度: D1感觉 / D8气冲病灶

    ● 禁忌综合
      ────────
      风: 站桩时毛孔张开，风吹=寒湿入侵通道大开，吹空调=空调寒气入体。
      水: 桩前桩后各5分钟不碰水（不洗澡/不冲澡/不洗手/不洗脸/不泡脚/不碰冷水），也不喝水。站桩时毛孔张开，水属寒凉，喝下去直接灌进体内，影响练功效果；桩前桩后各守5分钟，过了这5分钟再喝。
      （层归属：水禁忌归 L2.5 练功禁忌层按本行窗口口径统一管控，L1 规则维度不单独禁喝水；"过了这5分钟再喝温水"属合规教学答复，质量门不得据此拦截）
          出汗后同样按这5分钟口径，不再用"等汗收了再洗"的第二说法。
      饮食: 桩前桩后各5分钟不吃不喝
      排泄: 桩前桩后各5分钟不上厕所。
          破例三条件（缺一不可，且仅在对方主动提出时才谈）：
            ① 对方主动说憋不住/尿急/想上厕所（身体不支持，不是我们建议）
            ② 明确告知后果：可以去，但这次练功效果清零，收获都用来排毒了
            ③ 明确表态：我们不建议破例，能坚持完5分钟再去则收获与排毒兼得
          对方没提时，绝不主动兜售这个口子。
      情绪: 大怒/大悲/大恐后不要站桩，等情绪平复
          【非主动管控类：不主动提，仅对方问及时答"不建议"，不纳入L2.5自动拦截】
      过劳: 极度疲劳时可站5分钟即可，不强撑
          【非主动管控类：不主动提，仅对方问及时答"不建议"，不纳入L2.5自动拦截】
      房事: 前后各1小时内不练功
          【非主动管控类：不主动提，仅对方问及时答"不建议"，不纳入L2.5自动拦截】
      关联维度: D9禁忌

    ● 病理演化总链
      ──────────
      违逆四时(饮食/起居/情绪/耗泄)
        → 阳气亏损
          → 风寒入侵
            → 寒凝血脉
              → 久寒生湿
                → 久湿生饮
                  → 久饮生痰
                    → 久痰成瘀
                      → 久瘀成结节/包块/瘤
                        → 久郁成癌

      站桩逆转方向:
        从末端往前推——站桩补阳气→驱寒→化湿→消痰→散瘀
        每一步都可逆，只是时间问题

【病症辨证知识·AI分析客户用】
（以下为病症辨证参考，分析客户身体/病症情况时引用；回复必须包含引导练功/站桩/打坐的内容，不能只分析病症）
七、病症
    scope: 站桩是通过培补元气、疏通经络来改善体质，不是针对特定病症的治疗手段。
           站桩不治病，站桩调的是"人"——人自愈能力恢复后，病自然退去。
    ─────────────────────────────────────────
    (本章由 AI 基于《黄帝内经修行精要_赵冀龙》五脏调理理论与和合玄鉴病症解答体系，于 2026-07-28 重建；原占位无正文可回收)

    【第八章】六邪总论与病理演化链
    ────────────────────
    ================================================================================
  六邪病理演化链 · 完整梳理
  基于《黄帝内经修行精要_赵冀龙》+ AI回复知识库超图19域
================================================================================

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
第一部分 · 六邪总论（风寒暑湿燥火）

【壹】风邪 ── 百病之长
核心概念：风为阳邪，善行数变，为百病之长。
原理解释：风邪轻扬开泄，易袭阳位（头面、肌表）。风性善行数变——游走不定、发病急骤。风邪常兼夹其他邪气同时入侵，故称"百病之长"。
入侵途径：皮肤毛孔（卫气不固时）→ 经络 → 脏腑
（症状索完整内容见独立文件: 六邪病理链_完整梳理.txt）

【贰】寒邪 ── 凝滞收引
核心概念：寒为阴邪，易伤阳气，凝滞气血、收引经络。
原理解释：寒性凝滞→气血运行减慢、不通则痛；寒性收引→筋脉拘急、关节屈伸不利。阳气像身体的太阳，阳气不足则体内阴寒之气无法驱散（详见六、病理发展过程·阶段三/四）。
入侵途径：口鼻、饮食生冷、以及风寒相兼从皮毛而入。
站桩应对：站桩发热、温通阳气以化寒凝；桩前桩后守5分钟禁忌，忌吹风、碰冷水。

【叁】湿邪 ── 重浊黏滞
核心概念：湿为阴邪，易伤脾阳，重浊趋下、黏滞难去。
原理解释：湿性重浊→身体沉重、下肢酸困；湿性黏滞→阻遏气机、病程缠绵。久寒生湿、久湿生饮、久饮生痰（详见六、病理发展过程·阶段四）。
入侵途径：饮食生冷甜腻、环境潮湿、以及寒湿相兼。
站桩应对：站桩温阳健脾，从源头提升脾土能量（脾土生肺金），助运化水湿。

【肆】暑邪 ── 夏季耗气伤津。站桩避暑热。
【伍】燥邪 ── 伤津耗液，干咳/皮肤干。秋季多发。
【陆】火邪 ── 炎上，耗气伤阴。心火旺→失眠/口疮。

━━ 六邪总表（外邪·速查）━━
风邪：百病之长，易袭阳位（头部/肩背）。站桩后忌吹风
寒邪：凝滞气血，收引经络。寒性凝滞→气血不通→痛
暑邪：夏季特有，耗气伤津。站桩避暑热
湿邪：重浊黏滞，阻遏气机。湿性趋下→下肢症状
燥邪：伤津耗液，干咳/皮肤干。秋季多发
火邪：炎上，耗气伤阴。心火旺→失眠/口疮

━━ 内生邪气（与外邪合邪，恶性循环；站桩破环点在"补阳气"）━━
内风：肝阳化风→眩晕/震颤
内寒：阳虚生寒→怕冷/四肢不温
内湿：脾虚生湿→身体沉重/大便黏
内燥：津亏生燥→口鼻干/皮肤干
内火：五志化火→心烦/失眠/口疮
内外合邪：外邪入侵→损伤脏腑→产生内邪；内邪积累→降低抵抗力→更易感外邪。站桩补阳气→打破恶性循环。


    【第九章】练功反应/排病/感受全量分类
    ────────────────────
    ===============================================================================
              练功反应/排病/身体感受 — 全量知识系统梳理
              来源：hypergraph_19d_with_content.json (1101条规则×19维)
              提取日期：2026-07-10
===============================================================================

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
疼痛类反应
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【1】通则不痛，痛则不通 — 总纲
  解释原理:(完整内容见独立文件: 练功反应_全量知识.txt)


站桩
    scope: 新客户在说具体站桩感受/要领的时候，默认对方没学过我们的站桩，
           需要问是否是我们这里的站桩，别的地方的站桩不评价。
           问站桩体验课有几种站桩的时候，则默认对方问的是总体站桩体验课，
           回答有3种：无极桩/混元桩/十字桩。
           客户非新人状态，说"站桩"时各种感受/问题，
           都默认为无极太极体验课中的无极桩/混元桩。
    ───────────────────────────────────────────


    0. 通用站桩原则
       最佳时间段：自身状态好，不受打扰的时间，如果有固定时间形成习惯更好。
       古人认为早晚5-7点最适合练，为天地阴阳交互的时间，您如果感兴趣可以分别尝试，
       但如果自身状态不好，或者不安静，那么早晚的5-7点其实不如自己状态好/安静的时间。

       练习次数/频率：
         无极桩：在一天的练习时间上限为年龄分钟的条件下，第一周内，可多次，
                 5次以内均可，目的是练一次熟一次。一周后，一天只练一次最好，
                 时间逐渐增加，效果越来越好。注意：一天的练习时间上限为年龄分钟。
         混元桩：同上
         十字桩：最快可以一周一次，一月一次更好，半年一次更好，一年一次最好。
                 （十字桩不补能量，仅通过身体能量调动来显示身体状态，
                  不宜高频练习，以免亏虚）

       名词解释：年龄分钟：30岁的人年龄分钟为30分钟，60岁的人年龄分钟为60分钟。

       禁忌：风，水，饮食，排泄
         风=吹风，空气流动，若对方主动提到户外，公园等非室内环境练习，
            则在所有风力大于四级区域都不可以练。
         水：碰水，碰触各种含有水份的液体，禁水，禁止触碰这些液体
         饮食：吃喝任何物品，禁饮食=禁止吃/喝
         排泄：如厕，上厕所，上卫生间等，任何形式排屎尿二便

       禁忌例外：仅对方提及适合说明。
         站桩完后憋不住非要去卫生间排泄，则可以去，但是练功效果清零，
         收获都用来排毒了；若能坚持禁忌完再去，则收获有，排毒效果也有。

       关联维度: D6姿势 / D8心法 / D9禁忌 / D15时间
    ───────────────────────────────────────────


    ───────────────────────────────────────────

    
    scope: 站桩是通过培补元气、疏通经络来改善体质，不是针对特定病症的治疗手段。
           站桩不治病，站桩调的是"人"——人自愈能力恢复后，病自然退去。
    ─────────────────────────────────────────
    (本章由 AI 基于《黄帝内经修行精要_赵冀龙》五脏调理理论与和合玄鉴病症解答体系，于 2026-07-28 重建；原占位无正文可回收)

    0. 底层机理：站桩为什么能"调人"
        站桩的核心作用三条：
        ① 培补元气 —— 下丹田能量增加，五脏得到持续滋养（肾为先天之本，元气足则五脏安）。
        ② 疏通经络 —— 能量增长→经络拓宽→冲刷病灶→酸麻胀痛→通则不痛。
        ③ 排出寒湿 —— 身体发热、气血活跃，风/寒/湿通过排汗、打嗝、排气排出（详见六、病理发展过程 / 

第八章 六邪总论）。
        根本逻辑（治未病）：人体是有机整体，发病之处往往非病根所在；提升自身能量总值，
        一边净化身心、一边强大能量，让身体回到"正气存内，邪不可干"的自愈状态。
        站桩是养生锻炼，不替代医疗；急症、明确诊断的器质性疾病请遵医嘱。

    1. 睡眠 / 精神类（心、肾、神）
        失眠：多为心肾不交、阳气浮越。站桩补充下丹田能量、引火归元，逐渐改善睡眠质量；
              现代人长期 β 脑波（紧张清醒态）耗泄精气神，站桩打坐使大脑进入 θ 波以下"练功态"，修复力大增。
        焦虑 / 抑郁：生理-心理-社会综合结果，常伴头晕胸闷、抗拒运动。站桩增加能量、疏导肝气（肝主疏泄），
              改善"空心病 / 心气内洞"类的神气泄露；但中重度请配合专业心理 / 医疗干预。

    2. 筋骨 / 腰膝类（肾主骨生髓）
        腰椎 / 颈椎病 / 腰间盘突出：肾主骨生髓，肾能量决定骨骼强弱。长期久坐、练肌肉、错误锻炼使
              腰部能量亏虚、寒湿堆积。站桩补元气、温肾阳、化寒湿，往期多名学员通过正确站桩改善甚至练好。
        肾虚：先天肾气不足或熬夜纵欲耗伤。站桩直接补充下丹田能量，延缓阳明脉 / 肾气衰退（详见五脏调理·肾）。
        说明：站桩不"治"腰突，而是改善体质让身体有能量自我修复；医院判定不可逆的，练对桩常有改善案例。

    3. 气血 / 畏寒类（阳气不足）
        怕冷 / 手脚冰凉：阳气被寒湿闭塞，尤其冬季阴寒盛时。站桩发热、气血活跃，
              能量走到四肢末梢；手部发冷 / 膝盖凉分别对应脾胃虚寒、肾阳不足。
        气血不足 / 身体虚弱：现代人节奏快、作息乱，气血亏虚阳气不足。站桩"气补"——从天地获取能量，
              比药补食补更根本（药食偏性重，会克侮他脏）。

    4. 脾胃 / 湿类（脾土）
        湿气重：脾主运化水湿，脾胃虚寒→运化失调→湿气集聚。站桩温阳、揉腹辅助，
              从根源提升脾土能量（脾土生肺金，亦改善上焦痰湿）。
        脾胃虚寒：远离生冷寒凉，规律作息；站桩发热以养阳。

    5. 脏腑慢性类（肝、肾）
        肝硬化 / 尿毒症：属血气能量长期亏虚导致的严重阶段。站桩可补充元气、改善整体能量状态，
              但属器质性疾病，必须遵医嘱、规范治疗；站桩作为体质改善的辅助，不替代医疗。
        胆结石 / 脂肪肝：肝主疏泄，现代人多发与肝功失常相关。站桩补能量、疏通经络，
              配合敲胆经等下策，是上策"以内在力量打通经络"。

    6. 练功反应类（排病 / 感受）
        站桩腿肿：多因肾气亏虚，站桩后肾气增加激发潜在隐患，或湿气较重。属调整过程，
              持续正确练习可化解；若伴红肿热痛需排查静脉血栓等器质问题。
        身体疼痛（通则不痛，痛则不通）：站桩疏通经络时，能量冲击病灶会产生酸麻胀痛，
              对应内脏：心(左胸放射肩臂)、肾(腰背→腿)、小肠(脐周)、胃肠(中上腹)、肝胆(肝区隐痛)等。
        重要：这些反应是"气冲病灶"的正常过程，非病情加重；持续练习、能量充盈后多缓解。
<!-- AUDIT_TODO_START -->
【校对待办·非活动规则】以下为待处理技术项，仅供 AI 知悉，非回复规范，请勿当作话术执行：
  - [校对待办] L13·体验课拦正式课（期望落地：quality_gate.py:19）
<!-- AUDIT_TODO_END -->
- 赵师核心指导：此时开始站桩练功，不仅可缓解经期不适，更能将多余精气转化为身体能量储备，而不是通过月经白白流失
- 炼精化气入门：开始学习将多余精气转化为能量，而不是白白流失
- 炼精化气→炼气化神→炼神返虚的转化路径，使修行者超越单纯生理层面的限制
   - 站桩可将多余精气转化为身体能量，而不是通过遗精或手淫白白流失
   - 这正是"炼精化气"的第一道关口
   - 建议每日15-30分钟站桩，配合深呼吸
   - "炼精化气"——将多余的精能量转化为气能量在经络中运行
   - 现代人受外界信息刺激过早过多（网络、色情内容），精气暗耗严重
   - 青春期教育的关键：让青少年理解精气是宝贵资源，不是垃圾
   - 如果在此阶段开始站桩练功，可以将多余的精气转化为更高层次的身体能量
   - **切忌过早消耗精气**——这是决定后半生健康基础的关键期
   两鬓白 → 面焦 → 视力下降 → 精力大不如前 → 畏寒怕冷 → 情绪低落 → 社交退缩
【禁忌】
【禁忌】
- 小肠和心互为表里——小肠寒凉则吃得少消化差，气血不得充养，影响心功能
【禁忌】
【禁忌】
  注意：小肠和心互为表里→小肠寒凉则吃得少消化差，气血不得充养，影响心功能
        形容热心肠：小肠温热身体好才有余热和心力帮助他人
  禁忌：秋季不宜夜跑、练肌肉等有氧运动，不宜贴秋膘
           用于回答客户关于"谁教的""有效吗""怎么上课""多少钱""学完怎么办"等信任/转化类问题。
    ─────────────────────────────────────────
        话术: "这样吧，现在消息也比较多 您可以先联系当时给您办理的小威微信说一下。微信号:wujitaiji365"
        关联维度: D10客户阶段
          ② 自然案例 — "之前有个同学..." + 对应病症案例, 不用"您更没问题"式碾压语气
          ③ 出方案 — 补充气血/疏通经络/从根上改善(价值塑造)。【非新人】默认不再推体验课; 仅当对方主动说"至今没练过/没学过/想重新安排/重新学习/学体验课"等语义时,才给体验课入口。
          ④ 成交姿态 — 非新人直接以正式课/复训价值切入,不绕弯子、不挂"您先了解着"式不push尾巴。(体验课低门槛入口与不push姿态仅限新人/明确想学体验课者)
        注意事项:
          - 伤口不恐吓(不用"慢性自杀"等词)、不平淡(不用"确实影响"等回避词)
          - 用代入式让客户自己想到后果: 客户想通的, 比你说的有效100倍
          - 首轮只了解情况不问销售, 第二轮+才自然引导
          - 案例不碾压: "老年人的情况都能改善,您现在开始只会更好"(不是"别人都能您更应该")
          - 配合客户画像系统记录关键对话, 后续推送案例/活动
        关联维度: D10客户阶段 / D5病症
📌 工程地图 · 接手/操作指南（人 + AI 共用）

🌳 知识树源（唯一可编辑源）

/opt/admin_web/knowledge_tree/current.txt

改 AI 回复行为规范就改这里。引擎实时读、mtime 缓存自动重抽；保存即生效，无需重启。

页面入口：/knowledge-tree（顶部「🌳 知识树」按钮）。编辑页顶部有「编辑须知」哨兵块（给人看，不进 AI）。

🧩 代码三件套（改机制才碰）

  • knowledge_tree.py — 抽取/缓存（read_reply_rules() / _extract_reply_rules()，Region A/B/C 锚点）
  • ai_reply/engine.py — 把规范注入 system prompt（active 引擎；勿动顶层旧 engine.py）
  • server.py — /ai-reply-blueprint 路由 + 蓝图派生渲染

🛡️ 部署纪律（红线）

  • 仅百度云 120.48.60.158（root / 密钥 ~/.ssh/baidu_fresh），service=admin-web，代码 /opt/admin_web/
  • 改 .py/模板后必须 systemctl restart admin-web（进程缓存旧模块）
  • 不动阿里云 39.96.4.78；不动顶层旧 engine.py；改前备份留痕；锁版本

📜 部署记录（deploy_log.json 自动驱动）

  • 2026-08-13 Fix C（DeepSeek宕机兜底·Case3根因）: engine.py _call_deepseek 抽 _do_deepseek_request, DeepSeek 返空即回落 _call_glm(智谱GLM, OpenAI兼容端点, 复用同一 system_content); 新增 _get_glm_key 三级来源(ai_reply_config.json glm_api_key→环境变量 GLM_API_KEY/ZHIPU_API_KEY→.env GLM_API_KEY); 模型名取环境变量 GLM_MODEL 默认 glm-4-flash 免费档(100万tok/天, 最坏量7倍余量). 无 GLM key 时 _call_glm 返空零回归; 实测三场景经现网 quality_gate 全 passed 红线全守. 改 GLM_MODEL 可切 FlashX/Plus 无需改码.
  • 2026-08-13 Fix B（配偶≠长辈 + 没练别劝）: 知识树铁律10 老伴/配偶/爱人=伴侣≠长辈, 严禁对配偶用孝心/尽孝/孝敬长辈(孝心仅适用父母长辈); 铁律11 客户说没练/还没练/忙/没空 直接回'那您自己方便的时候练习即可'不展开禁忌. quality_gate.py 新增 strip_spouse_filial 后检剥离配偶误用孝心段.
  • 2026-08-13 Fix A（禁忌讲解加练功语境门）: worker.py _forbid_map 原遇水/吃/风/排泄触发词即硬覆盖整条回复, 无练功语境判断→体寒被回'不能吹风'/没练被劝禁忌. 加 _PRACTICE_CTX 练功语境门(站桩/打坐/练功/守禁忌/桩前/桩后/收功/功法/练)仅练功语境才允许覆盖; quality_gate.py 新增 strip_no_context_taboo 无语境剥离禁忌段其余正常发.
  • 2026-08-11 账号课型铁律 L22 修订(2026-08-11): 明丽/小帆打坐 新友≤7天单向锁(站桩规则落实); BOT_MAP 双配置(wxid+userid)一致性自检 _check_botmap_parity().
  • 2026-08-08 路由铁律钉死(2026-08-08): 入站 imBotId 为回复账号唯一依据, _resolve_send_bot_id 绝不兜底/绝不用存储映射覆盖; 非托管/禁用账号不回复不报错不兜底, 防串号.
  • 2026-07-28 客户同步瘦身+调度分时+本组6老师owner过滤（full 1天1次+增量30min+lite只4字段+own_group.json白名单）
  • 2026-07-28 A: 转人工改为消息日志页面置顶+已读按钮(点击已读=已处理,按钮消失并取消置顶); B2: 客户画像意向排序前10加取消按钮(手动排除不纳入统计)+备注含"已报名"客户SQL自动排除; 改 server.py / ai_reply/customer_routes_v2.py / ai_reply/customer_profile.py / templates/message_log.html / templates/customer_portrait.html
  • 2026-07-27 部署记录改为 deploy_log.json 数据驱动 + deploy.sh 一键自动追加（修复 scp 覆盖风险）
  • 2026-07-27 蓝图升级为「人+AI 共用单一入口文档」：派生规范区块 + 工程地图
  • 2026-07-27 知识树抽取扩 Region C 信号词（免操心版，新增类别规则自动生效）
  • 2026-07-27 知识树开头加「编辑须知」哨兵（不进 AI prompt）
  • 2026-07-27 知识树→AI 引擎消费层落地（表情/收功规范化生效）
  • 2026-07-27 蓝图转 Jinja 模板 + 顶部和合AI logo 直达入口
  • 2026-07-26 v3.6.4 去重回归修复（contact_id+messageId 复合键）

🗺️ 存活页面 / 工具目录（人 + Agent 共用）

  • /ai-reply-blueprint — 本页：全域地图与工具目录入口
  • /knowledge-tree — 知识树（唯一可编辑规范源 current.txt）
  • /customer-profile — 📋 客户档案浏览器（2026-07-29 重建）：全量客户编号列表（姓名/编号/跟进人/状态/标签/添加时间），每行「🛰️ 监控」跳状态机
  • /customer-monitor?cid=客户编号 — 客户监控/状态机：时间线 + 感知引擎事件 + 档案卡（备注/标签/加好友时间/跟进人/阶段）
  • /reply-log-explorer — 回复日志浏览器（实时查 reply_log）
  • /message-log — 消息日志（转人工置顶）

说明：状态机页必须带 ?cid=（im_contact_id 或 external_userid），从「客户档案浏览器」点「监控」自动带入。

🧩 上下文注入 + 真人避让机制（2026-07-29 根治）

  • 上下文注入：AI 每次回复注入【近期对话记录】最近 12 条（带角色），让 AI 接上文、避免重复回复 / 重复要求客户做同一件事。
  • 角色三类：客户 / 我方（bot+员工+真人老师合并，即"我们这边说过的话"）/ 系统（SOP 广播）。真人老师发言归入"我方"，AI 无缝衔接。
  • 硬边界：历史仅供参考，AI 只针对【客户最新消息】回复，不回应、不重复我方/系统发言。
  • 真人避让（#BC）：真人（老师）发言 → chat_customer_map 持久化(chatId→788 单键) + 真人历史扫 5 页(co-worker/contactType==3) + 单键反查客户 → 标记 20 分钟静默，期间 AI 不生成、不抢话。
  • 客户精准映射（#Y）：juzi_contact_map 按 im_contact_id(788) 精准补备注，重名零串号，覆盖备注黑名单。

🩺 排障手册（troubleshoot_guide.json 自动驱动）

  • 诊断三板斧：① 查真实数据（customer_cache.db 的 add_days / 标签 / 备注）② 看运行进程是否加载新代码（engine.py mtime + systemctl status admin-web 启动时间）③ 端到端复测（mock 掉 DeepSeek 直接调 generate_reply 看是否走规则模板）
  • AI 行为异常时第一反应查 systemctl status admin-web 的启动时间——改了代码没重启 = 旧行为（弄潮小玉 8/23 的体验课回复即旧进程产物，非当前代码行为）
  • 区分「规则模板 vs DeepSeek 自由生成」：规则模板可控、不幻觉；DeepSeek 自由生成可能偏离并幻觉出不存在的链接。报名 / 视频 / 感谢等高频意图应走规则模板
  • 知识树 current.txt 是纯 AI 消费规则源，修复记录 / 排障手册只进蓝图（fix_log.json / troubleshoot_guide.json），绝不写 current.txt，避免污染 AI 实际读取的规范
  • 客户问「报名」类意图，站桩账号必须回对应课型精髓班真实链接（打坐=EyR7tz / 站桩=AbePCO），绝不回体验课；新友≤3天按 L19 红线禁推正式课链接
🔸 报名却回体验课 / 幻觉出不存在的链接（弄潮小玉 2026-08-23）

症状：学员问「怎么样报名」，AI 回「体验课是免费的……直接点我发给您的链接进去就可以」，甚至捏造一个根本不存在的链接。

常见误判：

  • 误判①：看不到添加时间 → 实际查 customer_cache.db，弄潮小玉 add_days=233（createtime 2026-01-02），是 233 天老友，系统根本没当新人
  • 误判②：看不到上下文 → mass_hint 已把最新群发广播（站桩精髓班）注入 prompt，AI 看得到正式课，不是因为没上下文

真实根因：旧版【课程模式】prompt 写死「必须使用体验课相关内容」强制锁死课型 + 报名意图走了 DeepSeek 自由生成（非规则模板）导致幻觉链接。11:38 那条回复是旧进程产物，当前代码对「怎么样报名」已正确返回站桩精髓班链接。

诊断步骤：

  1. 查真实数据：sqlite3 customer_cache.db "SELECT add_days,tag_names,remark FROM customers WHERE name LIKE '%弄潮小玉%' OR remark LIKE '%弄潮小玉%'"
  2. 看运行进程：stat -c '%y' ai_reply/engine.py + systemctl status admin-web 确认启动时间是否晚于代码改动
  3. 端到端复测：mock 掉 DeepSeek 直调 generate_reply(弄潮小玉, '怎么样报名')，确认走规则模板返回站桩精髓班链接 AbePCO 且 DEEPSEEK 被调用次数=0
  4. 查蓝图 fix_log.json / 已知修复记录，确认对应修复已部署并 restart 生效

修复：

  • context_engine.py Fix A：备注日期兜底算 add_days（createtime / create_timestamp 缺失时，从备注「名字YYYY-MM-DD」提取加友日，避免其他老学员因 add_days=-1 被误判新友→误走体验课 T1）
  • context_engine.py Fix B：【课程模式】prompt 去掉写死的「体验课」，改为「课程相关内容（体验课与正式课都算，按客户实际所处阶段选择）」，堵死 DeepSeek 路径把「接下来怎么学 / 我想继续」也带偏成体验课

验证：重启后 re-run 端到端：REPLY 含「站桩精髓班」链接 https://j.youzan.com/AbePCO 且 DEEPSEEK 被调用次数=0（走规则模板，不自由发挥、不幻觉）。

🔸 练习/健康咨询被 AI 主动发报名链接+价格模板（若水 2026-08-25）

症状：客户问「晚上可以练习吗？引气血下行助眠？」，AI 却主动回复「站桩精髓班正式课原价3688元，直播间优惠价1288元……我发您报名链接：https://j.youzan.com/AbePCO」，并附带营销海报。

常见误判：

  • 误判①：路由 bug 导致错走报名模板 → _sense_layer("晚上可以练习吗？引气血下行助眠？")=unknown，无报名/价格关键词，不会进 signup/price 规则分支
  • 误判②：账号状态问题 → 明亮老师已配置为站桩账号，课型锁正常；服务 14:25 已重启，14:31 回复发生时新代码已在运行

真实根因：结构根因（非‘提示词过于推销导向’这种表层描述）：知识库把‘营销素材’与‘练习答疑知识’混装在同一 domain 上下文。① knowledge_base.get_domain_context 对‘晚上可以练吗’这类练习咨询查询，会一并检索出 转化话术/课程体系 等推销域（它们含站桩关键词），以及可信QA里的报名链接；② knowledge_tree 规则 blob 把‘转化四段式/话术域引用’标为‘一等公民’且‘站桩正式课信息’块(含 j.youzan.com链接+1288/3688)无‘仅主动问价才输出’条件；③ 系统提示词‘优先使用知识库内容’指令鼓励模型引用。三者叠加→模型在答疑时把课程链接/价格‘张冠李戴’带进回复。注意：这不是路由 bug，意图=unknown，规则报名模板未触发；是 DeepSeek 自由生成阶段从知识库上下文引用了营销素材。

诊断步骤：

  1. 复测意图：engine._sense_layer("晚上可以练习吗？引气血下行助眠？") 应返回 unknown / inquiry，不应为 price/signup
  2. 复测生成：直调 generate_reply（mock DeepSeek 返回报名链接模板）看最终输出是否被替换为正常答疑
  3. 查 engine.py mtime / systemctl status admin-web 启动时间，确认推销拦截代码已加载
  4. 查 fix_log.json 最新条目，确认 8/25 推销越位拦截已部署

修复：

  • Plan B（代码按意图隔离）：knowledge_base.get_domain_context 增加 include_marketing 参数；engine.py 在构建 kb_context 前用 _sense_layer 判意图(price/signup)，非购买意图传 include_marketing=False，剔除 转化话术/课程体系/课程咨询/招生转化 域 及含 j.youzan.com/AbePCO/EyR7tz/1288/3688 的条目。
  • Plan A（知识树硬门）：current.txt 的 站桩/打坐正式课信息块加‘仅主动问价/报名/链接才输出’；转化四段式/话术域引用 加 ‘仅购买意向激活转化框架，练习咨询不进入转化流程’硬门。
  • 出口拦截（15:19 部署，第三重）：_generate 中识别营销特征+咨询场景→强制重写/硬兜底，绝不放行。

验证：端到端：练习咨询‘晚上可以练习吗？引气血下行助眠？’→返回纯练习建议，营销特征命中=[]；购买意向仍按 tier 逻辑处理。get_domain_context 单元验证：非购买意图 include_marketing=False 时 营销命中=[]。

🔸 AI 不避让真人 / 真人回复后 AI 仍抢话（明阳老师等动态 bot 暴露，2026-08-26）

症状：真人用句子网页后台回复客户后，AI 机器人仍继续回复、与真人对同一客户抢话。尤其明阳老师(1688858227864205)、朝阳(1688857613864257)等'动态 bot'全部失效，而打坐70/254顺其自然等客户的对话里明显看到 AI 与真人同时在答。

常见误判：

  • 误判①：以为检测器线程没启动 → 实际 [人工检测] 每分钟都在扫(命中0), 线程是活的; 问题不在后台线程, 在回调链路的反查。
  • 误判②：以为 KNOWN_BOT_WXIDS 能识别所有 bot → 该集合只含 juzi_callback_handler 里那个不完整的 BOT_ID_MAP, 缺明阳/朝阳等仅靠 imBotId 动态判定的 bot, 防护被绕过。
  • 误判③：以为 chatId→客户映射可靠 → 网页后台真人回复的 /chat/get 返回的 wxid 就是 bot 自身, 把 map 污染成 (chatId→botId)。

真实根因：双回调链路(juzi_callback_handler 的 Route2 + server.py 的 isSelf 分支)都用 chatId 反查真实客户来打 human_replied 冷却。但 resolve_customer_for_chat 用 JuZi /chat/get 的 wxid 回写 chat_customer_map, 而网页后台真人回复会话里 wxid 就是 bot 自身(168885 开头), 于是 map 被污染; 后续 lookup_chat_customer 返回 botId, mark_human_replied(botId, bot) 落在错误键上 → 真实客户冷却与 chat_cache 都没被保护 → AI 持续插嘴。

诊断步骤：

  1. 查 human_avoid_trace.log: 真人回复记录 cid==bot(如 cid=1688858227864205 bot=1688858227864205), 证明标记打在了 bot 上而非真实客户。
  2. 查 logs/sop_field_probe.log: 真人回复回调 contactId=bot、chatExternalUserId=None、coworker=True, 确认回调里根本没有客户 ID, 唯一线索是 chatId。
  3. 查 chat_customer_map.db: SELECT * FROM chat_customer_map WHERE contact_id LIKE '168885%' → 大量 (chatId→botId) 污染行, 真实客户 788... 不在表中。
  4. 查 juzi_callback_handler.resolve_customer_for_chat: 它把 JuZi 返回的 wxid 直接写库/返回, 未校验是否为 bot。

修复：

  • 判别法统一为: bot wxid 一律 168885 开头, 真实客户 external_userid 为 788.../wmZ... 等 → 用 startswith('168885') 判定 bot, 覆盖所有动态 bot(明阳/朝阳/助教小金/小威)。
  • resolve_customer_for_chat: 仅当 wxid 非 168885 开头才写库/返回, 杜绝 map 再被污染。
  • Route2 客户解析: 每一步结果都拒绝 168885 开头; 反查全失败兜底到 customer_session.find_by_bot(bot).contact_id(该 bot 当前会话绑定的真实客户)。
  • server.py isSelf bot 分支: 优先用 find_by_bot 的真实客户 _rc 做 mark_human_replied, 移除'非 imRoomId 才标记'的过严限制(标记按(客户,bot)精准隔离, 不会误伤同群其它客户)。
  • 清理 chat_customer_map 中全部 168885* 污染映射(583 条)。
  • 两道保险一直在: ①human_replied 冷却(worker 入口 _was_human_replied); ②worker 活跃对话检测扫描 chat_cache 中 from!='bot' 的最近出站。修复后两者都落在本客户上。

验证：

🛠 已知修复记录（fix_log.json 自动驱动）

  • 2026-08-22 客服回复 8 类问题总体修复（根因4类）: ①课型隔离失效→quality_gate L22 apply_account_course_lock 去掉 is_new_friend_10d 限制对全客户生效 + 通用词 打坐↔站桩 双向替换 + 客户主动提对方课型不强行改; engine 注入【账号课型约束】+发送前 _final_output_sanitize 站桩账号移除'打坐'表述(客户主动提除外). ②销售节奏失控→_final_output_sanitize 新友≤3天/反感 硬剥离 youzan报名链接+1288/3688+营销词('先报起来/精髓班'等). ③时间/进度感知缺失→context_engine 新增 _extract_scheduled_time/_extract_course_progress 注入 prompt + 最终过滤避免与已约时间冲突. ④上下文利用不足→video 意图走 _video_template_reply(无报名链接); thanks→'不客气.'. 涉及 engine.py / quality_gate.py / perception_engine.py(BOT_DOMAIN_MAP 用真实 bot_name 全量键+模糊兜底) / context_engine.py. 18 项功能探针 ALL_PASS, 已重启 admin-web.
  • 2026-08-23 弄潮小玉类「已上完体验课却被推体验课」修复: 根因=【课程模式】prompt 旧版写死'所有回复必须使用{课型}体验课相关内容'强制 AI 只能聊体验课 + 报名意图旧路径走 DeepSeek 自由发挥(幻觉'体验课免费+点击链接');非添加时间问题(该客 add_days=233 老友, 真实加友日 2026-08-17 写在备注 252弄潮小玉2026-08-17). 修复: (A) context_engine 备注日期兜底——createtime/create_timestamp 缺失时从备注提取 YYYY-MM-DD 作 add_days, 避免老学员误判新友→误推体验课(T1); (B) 【课程模式】prompt 改为'课程相关内容(体验课与正式课都算, 按客户实际阶段选择)', 不再强制体验课. 报名意图走规则模板(站桩账号→站桩精髓班 AbePCO 链接, T3, 0 次 DeepSeek 调用). 端到端复测: generate_reply('怎么样报名') 返回站桩精髓班链接且 DeepSeek 调用0次. 备份 context_engine.py.bak_fix_20260823, 已重启 admin-web.
  • 2026-08-25 修复 AI 对客户提问/分享复读'报名链接'推销（推销越位）：根因为 LLM 被过于推销导向的提示词驱动（非路由 bug），在系统提示词加【严禁推销越位】护栏 + _generate 加反应式拦截（无购买意向+回复含营销链接则强制 DeepSeek 重写回答）。
  • 2026-08-25 若水案例「晚上可以练习吗/引气血下行助眠」被 AI 主动发站桩精髓班报名链接+价格模板 —— 推销越位再次加固：engine.py 拦截逻辑升级。①扩展 _pitch_detected 覆盖 youzan链接/报名链接/价格对(1288+3688)/原价3688+优惠/精髓班+元/报名/先报起来 等模板特征；②增加 _is_question_or_practice 识别咨询/练习/健康场景，确保练习/健康问题必被拦截；③重写后仍含营销内容 → 不再放行，强制替换为硬兜底通用答疑（按账号课型站桩/打坐）。备份 engine.py.bak_pitch_guard_20260825_1450。已重启 admin-web。探针：模拟 DeepSeek 返回报名链接模板时，最终输出为正常答疑，无链接无价格。
  • 2026-08-25 若水案例根治（A+B）。根因=知识库结构缺陷：营销素材（课程链接/价格 + 转化四段式/话术域‘一等公民’）与练习答疑知识混装在同一 domain 上下文，且‘站桩正式课信息’块无触发条件；系统提示词‘优先使用知识库’指令使模型在非购买场景把营销内容当成答疑素材‘张冠李戴’带出。修复二重：Plan B 在 knowledge_base.get_domain_context 增加 include_marketing 参数，非购买意图(意图非 price/signup)剔除 转化话术/课程体系/课程咨询/招生转化 域及含 j.youzan.com/AbePCO/EyR7tz/1288/3688 的条目；engine.py 构建 kb_context 前用 _sense_layer 判意图并传 include_marketing。Plan A 在 knowledge_tree/current.txt 的 站桩/打坐正式课信息块加‘仅主动问价/报名/链接才输出’硬门，并在 转化四段式/话术域引用 加‘仅购买意向激活’硬门。三重防护：知识树硬门 + 代码按意图隔离 + 出口拦截(15:19部署)。已重启 admin-web，端到端验证练习咨询回复无链接/价格。备份 knowledge_base.py/engine.py/current.txt 均为 .bak_*_20260825。
  • 2026-08-25 砍掉「谢谢」场景的「引导后续学习」尾巴：根因=和合玄鉴_rules.json 的 cs_0013「跟进闭环」规则明确要求「客户说谢谢时不要只回不客气，给一个轻松的衔接推向下一步」，作为知识库条目(cs_0013 触发词=客户表示感谢/认可/满意)注入 DeepSeek 上下文，导致所有感谢场景(尤其带内容的感谢「谢谢老师，今天练完好多了」未被精确判为 thanks 意图而走 DeepSeek)被强制追加引导尾巴(如「下周赵老师直播答疑发链接」)，且经常出错。修复三层防线：①根因——cs_0013 改写 action/examples 为「只温暖回应+练功鼓励，绝不引导后续学习/推课/约时间/发链接」，cs_0020「温暖退场」同步去掉「下次我来」定时回访；②知识树——current.txt 的「④ 感谢/认可/结束 → 走促单后闭环节点(跟进闭环/温暖退场)」改为「只做温暖回应+练功鼓励，绝不引导/推课/约时间/发链接」，社交细则感谢句追加练功鼓励口径；③代码硬约束——engine.py _social_template_reply 的 thanks 模板改为「不客气😊，好好练，加油」(带表情→「不客气，坚持练就会有收获，加油💪😊」)，fallback 感谢模板同步；_sense_layer 把「含内容的感谢」也识别为 thanks 意图(包含匹配，「不用谢/谢 *谢」排除)，走模板直达彻底绕开 DeepSeek 自由发挥。已重启 admin-web。三层防御：规则源去引导 + 知识树口径一致 + 代码模板硬约束。备份 和合玄鉴_rules.json/current.txt/engine.py 均为 .bak_thanks_20260825。
  • 2026-08-25 避让真人失效（AI 在真人发言后仍回复）：根因=①worker.py:start_worker 中真人检测器线程的启动位于 `if self._worker_task and not done: return` early-return 之后，且 start_worker 是懒启动（仅收到入站消息才调用），某次重启后检测器未拉起 → 后台扫描不跑 → human_replied 标记不上 → AI 不闭嘴。修复双重：①worker.py 检测器启动移至 early-return 之前（幂等：None 或 not alive 才启动）；②server.py startup 钩子主动调 start_worker()，不依赖第一条消息。验证：重启后 server.log 每 60 秒一轮「[人工检测] 扫描完成: 10个账号」，human_avoid_trace.log 的 GUARD-SKIP 避让记录正常。备注：应用日志在 /opt/admin_web/server.log（systemd StandardOutput=append），不在 journalctl。
  • 2026-08-25 体验课周期感知缺失（AI 向 254 期在学客户主动报「27号(255期)开课」）：根因=系统完全不认备注名期数(254/255)，AI 只能凭知识库「站桩体验课周一/周四晚7点开课」推断「下次是周四27号」并反复主动说，对 254 期(8/24-8/28)在学客户造成误导与干扰。修复：①context_engine.py 新增 _parse_course_phase()——从备注名解析独立3位期数(200-320)，以 254期=2026-08-24(周一) 为基准双向推算任意期5课日期(每两期差7天,期差1=+3天或-4天)，计算今日阶段(未开课X天后/期内第Y课/已结课)并生成注入文本；②注入文本含硬规则：期内/已结课客户绝对禁止提后续期数开课/报名/链接，未开课客户可告知本人当期开课时间，已结课后仅当客户主动问下一期才告知；③current.txt 新增【站桩体验课周期】规则块(知识树口径同步)。验证：254期/8-25→第2课+禁提255期 PASS，255/256/257期→未开课倒计时 PASS，253期→已结课 PASS，无期数备注→不注入。备份 .bak_course_phase_20260825。
  • 2026-08-25 体验课周期 v2 增强（用户规则升级）：①期数解析改为「仅认备注名开头3位数字」(如 255张三134321234→255，中间/末尾手机号数字一律不认，超出200-320视为无效)；②新增滚动计算——根据今日日期自动推算「最近已开课期+下一期」(锚点254期=2026-08-24，每两期差7天，期差1=+3天/-4天)，备注名期数与系统推算天然一致、强行绑定；③无期数备注客户注入全局滚动周期(当前期+下一期开课时间)，AI 回答开课问题有准确参照不再自行猜测。验证 9/9 PASS(含 255张三134321234、254期第2课禁提255期、无期数→254期已开课+255期8/27、开头手机号138→按无期数处理)。备份 .bak_course_phase_v2_20260825。
  • 2026-08-25 体验课周期硬规则未生效根因(254惜缘 21:19 仍报 27号开课)：根因=context_engine.to_prompt_context() 把 course_phase_desc 输出在「课程标签」附近（位置靠后），而 engine.py:2298 拼 prompt 时将客户信息硬截断 [:1000] 字符，导致该 desc 被截掉、DeepSeek 看不到禁提规则，自由发挥报27号开课。修复双重：①context_engine.py 把 course_phase_desc 块前移到「加好友时长」之后(约 char 119)，保证必在 1000 字符内；②engine.py 将客户信息截断上限 1000→2500(冗余，给后续扩展留空间，2500 字符仅 ~600 tokens)。端到端验证 254惜缘 客户上下文 438 字符含「254期+绝对禁止+第2课+255期」全部完整。备份 .bak_phase_front_20260825 / .bak_ctx_2500_20260825。
  • 2026-08-25 打坐体验课周期 + 新/老客户判定改为期数天数(用户新规)：①打坐周期接入实时计算——每周三晚7点开一期、每期连续3晚(周三~周五)共3课、每期差7天，锚点71期=2026-08-26(周三)(70期=8/19)；期数解析改为开头2-3位数字(站桩3位254+/打坐2位70+，按课型范围区分：打坐60-199/站桩200-320)；课型由账号判断(仅明丽1688854662744766=打坐，其余站桩)；②新人判定全面改为期数天数——该学员所在期数第一课日期=第1天、第二课=第2天...以此类推(course_day)，有期数时覆盖 add_days 语义(未开课=0视为新友)，engine/quality_gate 的下游新友/价格/红线判定自动改用期数天数(无需改下游代码)；无期数客户回退原加好友时长判定；to_prompt_context 有期数时显示「课程周期第X天」替代「加好友时长」。验证：打坐71期(8/26未开课)/70期(8/19-21已结课)/72期(9/2)/76期(9/30) PASS；站桩254期第2课禁提255期、253/255/256期 PASS；期数天数 254期=第2天新友、253期=第6天老友、打坐70期=第7天老友 PASS。备份 .bak_course_phase_dz_20260825。
  • 2026-08-25 打坐周期锚点更正：用户明确 70期=8/26(周三) 起（此前误定 71期=8/26，整体错一期）。修正 context_engine._start_dz 公式为 (n-70)*7（每期差7天，每周三开课，3课周三~周五），滚动期起点打坐 70、current.txt 打坐周期块同步（69期=8/19 已结课、70期=8/26、71期=9/2、72期=9/9、73期=9/16、74期=9/23、75期=9/30）。验证：70期8/26未开课还有1天、71期9/2、72期9/9、73期9/16、74期9/23、75期9/30、69期8/19已结课、无期数滚动=69期已开+70期(8/26) 全 PASS；站桩254期回归 PASS。备份 .bak_dz_anchor70_20260825。
  • 2026-08-25 连续社交静默修复（优先级 > 礼貌社交模板）：用户截图 254Yu揽盈 案例——客户连续'谢谢'→'好的，感谢🌹'两条纯客套，AI 两次都回'不客气😊好好练加油'成复读机。根因：之前 thanks 模板修复只解决'尾巴'问题，没解决'连续多次社交 AI 每次都回'。修复=engine.py generate_reply 内 _is_pure_social_msg 判定：当前消息是短文(≤20字)+ 不含业务/疑问关键词(站桩/打坐/气血/价格/练功/禁忌/报名/视频/链接等)+ 命中社交词(谢谢/感谢/好的/收到/好嘞/👌/👍/🌹/😊 等)，且客户上一条入站消息也是纯社交 → 立即 return silent=True 不发任何回复(连 thanks 模板也不返)。验证 31/31 PASS(纯社交13/非社交14/边界4)，含截图案例'好的，感谢🌹'正确判 True。备份 .bak_social_silence_20260825。
  • 2026-08-25 thanks 模板吞问题修复：用户质疑「谢谢，今天课程听了，对头疼也有用吗？」是否也会只回模板。根因=_sense_layer 的 thanks 判定只要消息含「谢谢/感谢/辛苦了/多谢」任意词就判 thanks(0.95)，完全不管是否还带实际问题 → 答非所问。修复=thanks 判定追加「无实际问题」条件：消息含疑问/业务/症状词(吗/？/什么/怎么/多少/多久/为什么/疼/痛/酸/麻/胀/头晕/失眠/肩/腰/膝/腿/站桩/打坐/气血/课程/练功/视频/链接/报名/价格/禁忌/开课 等 45 词)即不判 thanks，放行给 knowledge/pain/inquiry → DeepSeek 答疑。验证 11/11 PASS：纯感谢(谢谢/感谢/辛苦了/带内容无问题)仍走模板；带问题感谢全部正确路由(头疼→knowledge/effect、练多久→duration、膝盖疼→knee、肩膀痛→pain、腿麻→dazuo、睡眠→unknown、视频→video)，绝不再吞模板。⚠️插曲：初版用 re.search 但 engine.py 模块级无 import re(该模块 re 均为函数内局部 import) → _sense_layer 运行期 NameError；且一次 ssh heredoc 引号被本地 bash 剥落导致坏行写入(语法错误)，均已通过本地脚本重写修复(any 关键词零依赖版本)。备份 .bak_thanks_question_20260825 / .bak_thanks_q2_20260825 / .bak_thanks_any_20260825。
  • 2026-08-25 纯客套判定重构为「跨行业通用客套字符集白名单」：用户指出客户不一定带问句/问号（如「谢谢，站桩后肩膀痛，头疼。」），只要涉及 身体/病症/课/功/桩 就必须走知识答疑，纯模板只给「谢谢与无意义内容」；并要求把无意义客套内容明确限定列举。修复=engine.py 模块级 _is_pure_social_msg 重构：消息去标点/表情/数字后逐字符检查，全部属于客套字符集(谢谢感谢辛苦老师好的收到嗯行没问题明白知道了再见拜拜晚安客气应该没事用啦啊哈呵呵你我他她们这那样子太不 等约60字+英文 ok/thx/thanks 等)→纯客套(走模板/静默)；含身体/病症/课/功/桩/业务字(不在集内)→非客套→走知识答疑/DeepSeek（无论是否带问句）。负面词「不好/不要/不行」特判非客套。generate_reply 连续社交静默与 _sense_layer thanks 判定统一改用此函数(删除内嵌45词列表版)。验证 31/31 PASS：纯客套18项(含表情组合)、非客套13项(含用户案例「谢谢，站桩后肩膀痛，头疼。」→非客套走pain答疑；「谢谢老师今天练完好多了」涉及练功→走答疑)。知识树加客套白名单规则块。备份 .bak_social_charset_20260825。
  • 2026-08-25 打坐备注名格式修复：用户明确打坐客户备注开头格式为「打坐70/打坐69/打坐68/打坐71...」（前有打坐二字）。原期数解析 `^(\d{2,3})` 只认开头数字，导致「打坐70明丽学员」判为无期数→只注入全局滚动周期、期数天数失效。修复=context_engine 期数解析改 `^(?:打坐|站桩)?\s*(\d{2,3})(?!\d)`（可带前缀+后视防4位数字），站桩同兼容「站桩254」前缀；current.txt 打坐/站桩备注格式说明同步。验证：打坐70→70期8/26未开课、打坐69→69期已结课、打坐71→71期9/2、打坐68→68期8/12已结课、无前缀70→70期、站桩254/站桩255→正确、打坐无数字/4位数字→无期数全局滚动 全 PASS（76期=10/7按规律+7天正确）。备份 .bak_dazuo_prefix_20260825。
  • 2026-08-26 期数开课时间出口拦截（代码级兜底）：用户报告 254期客户(254眼镜/7881302683915417) 8/26 与明阳老师对话，AI 回复末尾加「周四晚上7点上课」（=255期开课，8/27周四），答非所问+泄露后续期数。根因排查：①代码注入正确——复现 _parse_course_phase('254眼镜','站桩') 今日输出「期内第3课+🔴绝对禁止提第255期开课时间」正确；②真凶=DeepSeek 无视提示词硬规则：客户消息「课程回放看完了」触发它联想上课，从知识库「每周一/周四晚7点开课」+今天周三自行推断「明天周四上课」主动说出，提示词层面拦不住。修复=engine._final_output_sanitize 新增 G 段「期数开课时间出口拦截」：期内/已结课客户(course_day>=1) 回复含具体开课时间(周X/日期/明天/下X + 7点/开课/上课/直播) → 代码级强制删除；未开课(course_day<=0)允许告知本人当期；「今晚」(当前期当天)保留。验证 8/8 PASS(周四晚7点上课/27号开课/明天上课/下周一开课/日期+7点 全删；今晚保留；未开课不拦)。备份 .bak_openclass_gate_20260826。
  • 2026-08-26 期内客户注入「肯定式标准话术」（用户洞察: DeepSeek 不知道应该怎么说才会乱说）：用户指出否定式命令(禁止提255期)不够——DeepSeek 不知道替代说法，就从知识库抓「周四上课」填空。修复=context_engine._parse_course_phase 期内分支注入文本增强：①✅正确话术「客户提到上课/课程安排时应说『今晚是第X课，课前我会提前提醒您』（用今晚/今天指当前期当天）」；②🔴禁止「周X/日期晚7点开课/上课」（可能指后续期数开课日，误导客户以为还没开课）+ 禁止提前期数开课/报名/链接。知识树同步。复现验证：254眼镜 注入文本含「今晚是第3课，课前我会提前提醒您」+「不得说周X/日期晚7点开课/上课」。与 8/26 出口拦截(G段)形成 提示词肯定式引导 + 出口代码兜底 双保险。备份 .bak_phase_positive_20260826。
  • 2026-08-26 期内客户话术按当天时间区分（19:00 前后）：用户规则——当天已上课之后(晚7点后)客户提到上课/课程安排，AI 应说「今天学习的内容好好练，加油」而非「今晚是第X课」。修复=context_engine._parse_course_phase 加 _now 参数(可注入测试)，期内分支按 _now.hour<19 选话术：19点前=「今晚是第X课，课前我会提前提醒您」；19点后=「今天学习的内容好好练，加油」。知识树同步。验证：13:37→今晚话术、20:00→加油话术、08:00→今晚话术 全 PASS。备份 .bak_phase_timelapse_20260826。
  • 2026-08-26 期数/开课拦截适用范围检查与误伤修复（用户要求审查无辜牵连）：①G段出口拦截修正——加「客户主动问开课」放行（下一期/下次/什么时候/几号/还有课吗/明天上课等词）：已结课客户问下一期(用户规则允许告知)、期内客户问今晚/明天是否有课 不再被拦；仍拦「AI 主动说」(客户没问就报开课时间)。②期数解析防误伤——排除 4位年份日期开头(2026-08-17/2026年8月) 与 11位手机号开头(13812345678)，避免误判期数(如2026-08-17开头的202被当站桩202期)。验证 12/12 PASS：期内+没问→拦、期内+问今晚/明天→放行、已结课+问下一期→放行、已结课+没问→拦、未开课→不拦；日期/手机号开头→无期数、254眼镜/打坐70/255张三→正常。备份 .bak_gate_refine_20260826 / .bak_parse_refine_20260826。
  • 2026-08-26 已结课客户流程修正（用户四条规则）：①体验课开始前→可告知对应期数开课时间（原有）；②课期内19点前→告知今晚第X课课前提醒、19点后→今天学习的内容好好练加油（原有）；③**已结课+问「下一期/什么时候开课」→不再直接告知，先确认「您是要学正式课吗？」**（已结课学员问开课多为正式课意向，确认后按正式课咨询处理）；④**已结课+开课20天内+问「今晚有课吗」→温和提醒「您在X天前刚学习完体验课，上完就结课了，学完了，有跟着练吗？感觉怎么样？」**。实现：context_engine._parse_course_phase 存 course_total(3/5)、已结课分支按结课距今天数(_days_after<=20)注入确认正式课+结课关怀话术(>20天简化)；engine G段改为「期内+主动问→放行(当前期安排可答)；期内+没问/已结课→一律拦具体开课时间」(提示词已引导反问正式课/结课关怀，均不含具体开课时间)。验证 8/8 PASS。备份 .bak_finished_flow_20260826 / .bak_gate_finished_20260826。
  • 2026-08-26 打坐备注名后接数字导致期数解析失败：客户备注'打坐70123456'被旧正则 `(?!)` 直接拒掉（名字部分也是数字），更早无边界版本则被贪婪捕获成701期后落回站桩周期，导致AI说'周四晚上7点上课'。修复：context_engine._parse_course_phase 改为'带前缀分支+有效范围取长不取短'——带'打坐/站桩'前缀时连续取数字，先按3位在有效范围（打坐60-199/站桩200-320）匹配，失败再试2位；无前缀仍排除4位年份/11位手机号且后不能紧跟数字。'打坐70123456'现正确识别为70期（course_day=1），注入'今晚是第1课，课前我会提前提醒您'。备份 .bak_dazuodigits_20260826 / .bak_dazuodigits_v2_20260826。已重启。
  • 2026-08-26 避让真人彻底失效根因修复(明阳老师账号暴露: 真人用网页后台回复客户后 AI 仍抢话)。根因: 双回调链路(juzi_callback_handler Route2 + server.py isSelf)依赖 chatId→客户映射反查真实客户, 但 resolve_customer_for_chat 用 JuZi /chat/get 的 wxid 回写 chat_customer_map, 而网页后台真人回复会话里 wxid 即 bot 自身(168885 开头), 导致 map 被污染成 (chatId→botId); 后续 lookup_chat_customer 返回 botId, mark_human_replied(botId,bot) 落在错误键上, 真实客户零保护→AI 持续插嘴。KNOWN_BOT_WXIDS 不完整(缺明阳/朝阳等动态 bot)使防护形同虚设。修复三处: ①resolve_customer_for_chat 拒绝把 168885 开头的 bot id 写进 map/返回; ②Route2 客户解析每一步校验拒绝 168885 开头 bot id, 反查失败兜底到 customer_session.find_by_bot(bot).contact_id(真实客户); ③server.py isSelf bot 分支优先用 find_by_bot 的真实客户 _rc 做标记, 不受 imRoomId 限制(标记按(客户,bot)精准隔离)。判别法改为'bot wxid 均 168885 开头, 真实客户为 788.../wmZ...', 覆盖所有动态 bot。并清理 chat_customer_map 中 583 条 168885* 污染映射。备份 .bak_humanavoid_20260826。重启生效, 检测器线程在线, 离线模拟确认解析链不再产出 bot id。
  • 2026-08-26 体验课在期/已结课学员误发精髓班正式课报名链接(打坐66/打坐70史焘玮413, 19:18 明丽号回复打坐精髓班正式课...报名链接:AbePCO被撤回)。根因三层: ①_sense_layer 把含链接的消息一律判 signup 意图, 客户没有给我链接啊(要的是课程/直播间链接, 因 bot 刚承诺课前发课程链接)被误判成要报名链接; ②_price_understanding_and_template 对 course_day>=1 的体验课学员无硬门, 直接甩精髓班链接+价格, 违反期内禁报名/链接, 已结课问正式课先确认; ③course_mode 仅由 _current_bot_name 推导, 空串时误判站桩, 明丽(打坐)号发出站桩链接 AbePCO(应为打坐 EyR7tz)。修复三处(ai_reply/engine.py): 修复1 _sense_layer 去裸链接触发 signup(仅报名/参加/怎么报名); 修复2 加体验课学员硬门(course_day>=1 期内重定向课程链接/已结课确认无链接)+课型备注兜底(remark含打坐强制打坐); 修复3 include_marketing 对 course_day>=1 强制关闭。已重启生效, 端到端验证逻辑全 PASS。
  • 2026-08-26 254泗水亭长 被AI说成255期明天开课。根因=企微同一客户多员工跟进可设不同备注(Yu备注254, JiangJian_1备注255); 本地customer_cache.db经sync_all只保留一份聚合备注(当前为255), AI据此推算成未来期。修复=ai_reply/context_engine.py _parse_course_phase在缓存备注指向未来期/未开课时, 实时调用企微get_customer_detail拉取所有follow_user备注, 解析所有期数后优先选择course_day在[1,total]范围内(正在上课)的期数; 无进行中则fallback到最近未来期/缓存备注。验证: 缓存备注255→选中254, course_day=3; 缓存254直接命中。已重启生效。
  • 2026-08-26 实施 客户↔AI账号 一对一(每账号只看自己备注)。根因=context_engine._load_customer_info 用 ' / '.join 把客户所有企微员工的备注聚合成一条混合串, 导致多员工备注冲突(254/255)。修复=build_context 传入 bot_wxid, _load_customer_info 按 bot_wxid→BOT_MAP.userid→follow_user 过滤只取本账号那行备注(安全标签 已报名/ai禁 仍跨行OR合并)。v2修正: 过滤键从空的bot_id列改为follow_user(实际区分键)。运行时现实: 本地库塌缩单行+bot_id空, 254客户仍靠期数仲裁纠正为254(可见行为未回退); 真·多账号隔离还需 sync保留per-follow_user多行 + 路由识别真实子账号。已重启生效。
🔭 全域参考入口 · 关联系统地图
🧭 本页是 AI 客服回复系统的「全域地图」入口。 下方列出关联系统的位置与查阅方式；某子系统的部署记录若不在本页「📜 部署记录」区块，按下表定位后到对应系统查阅即可，无需记忆。

🤖 本系统 · AI客服回复（admin-web）

  • 服务器：百度云 120.48.60.158（root / 密钥 ~/.ssh/baidu_fresh）
  • 部署记录：本页上方「📜 部署记录」区块（deploy_log.json，deploy.sh 自动追加）
  • 知识库源：知识树 /knowledge-tree → current.txt
  • 代码三件套：knowledge_tree.py / ai_reply/engine.py / server.py

🧠 神谕元灵系统 v4.0.1（统帅）

  • 平台：Claude Code（唯一统帅，不可迁移到 Hermes / WorkBuddy）
  • 架构图：D:\项目汇总\神谕元灵系统_架构图.html
  • 基于 Claude Code 三大 Hook：UserPromptSubmit / PreToolUse / PostToolUse

🛰️ Hermes（副将）/ 🧰 WorkBuddy（参谋）

  • Hermes：飞书网关 + 定时任务副将（与本 admin-web 解耦）
  • WorkBuddy：日常辅助参谋（当前所在环境）
  • 部署记录：分别在其自身系统查阅，本页不托管

🏢 客户管理 V2 系统（admin-web.service）

  • 服务器：阿里云 39.96.4.78
  • ⚠️ 红线：本项目绝不触碰 / 改动，仅在此标注位置供跨系统参考
  • 查阅：需到该服务器自身系统看，本页不托管其部署记录