chore(sync): zsy_developcc 全量同步至 qyqy_develop（W26 口径）

- 分支内容对齐 qyqy_develop b6ec3aa，树完全一致（同步后 git diff 为空）
- 覆盖本轮全部交付：客服 Agent 重构（安全路由 / 五出口 / 记忆与画像 / RAG 全链路）
  + 开发文档 62 份编号体系（D1.1 v1.17 索引）
  + 新增 D2.10-客服Agent端到端答辩文档-2026-09-21.html
- 基线：e239eb7（2026-09-17 品牌口径统一快照），本提交为其直接后继

.env.example

@@ -39,6 +39,16 @@ MODEL_ROUTER_CONFIG_REF=local
 MODEL_DEFAULT_ENDPOINT=
 MODEL_FALLBACK_ENDPOINT=
 DEEPSEEK_API_KEY=
+# 通义千问（DashScope）向量化密钥。**同一个 key 要同时以三个变量名存在**
+# 因为三处消费者各读各的名字；写错名字的症状是「运行时读不到密钥」，不是报错：
+#   1) env:QWEN_API_KEY          —— model_endpoint_config.secret_ref 指向它（app/service/model_gateway.py 解析）
+#   2) QWEN_EMBEDDING_API_KEY    —— tools/load_knowledge_milvus.py 直接读
+#   3) DASHSCOPE_API_KEY         —— 其余 DashScope 调用点
+# 2026-09-18 实测：缺 1) 会让知识检索 embedding 直接失败，表现为「客服答不出来 → 强制转人工」，
+# 与词表 / 提示词无关。三处填同一把 key 即可。
+QWEN_API_KEY=
+QWEN_EMBEDDING_API_KEY=
+DASHSCOPE_API_KEY=
 
 SSE_HEARTBEAT_SECONDS=15
 SSE_MAX_CONNECTION_SECONDS=300