docs: 手册审查修正(前缀同键空间表述/WS验证预期)

- .env PUSH_EXTERNAL_KEY_PREFIX 注释纠错: 两租户前缀与各自老项目完全
  相同(同键空间)——这正是切换/回滚不产生重复 UniService 线索的依据;
  原稿写成'与老项目隔离'方向反了。两租户之间互异即可, 勿改。
- WS 验证预期收敛为 HTTP/1.1 101(curl 已强制 --http1.1, 不可能是 HTTP/2),
  模板与手册 §3.5 同步。

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-10-14 09:52:23 +08:00
parent 96131ebdec
commit 7808f8a299
2 changed files with 5 additions and 3 deletions
+1 -1
View File
@@ -149,5 +149,5 @@ server {
# curl -sI https://<租户域名>/static/widget.js | grep -i cache # Cache-Control: no-cache
# curl -s -i --http1.1 -H "Connection: Upgrade" -H "Upgrade: websocket" \
# -H "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==" -H "Sec-WebSocket-Version: 13" \
# https://<租户域名>/ws/chat | head -1 # HTTP/2 101 或 HTTP/1.1 101
# https://<租户域名>/ws/chat | head -1 # 期待 HTTP/1.1 101
# =============================================================================
+4 -2
View File
@@ -78,7 +78,9 @@ PUSH_API_URL=https://uniservice.server.hnxinyouhe.com/open/v1/inquiry/push
PUSH_API_KEY=<开启时用>
PUSH_EXTERNAL_KEY_PREFIX=ai-kefu-jc # 平台兜底前缀;两租户已各自配
# ai-kefu(auto)/ ai-kefu-jc(jiancai),
# 与老项目线索键隔离,勿改!
# 与各自老项目线索键**同键空间**(切换/
# 回滚不产生重复线索的依据),勿改;
# 两租户之间互异即可
# ⚠ 推送探测 env 回退(已知项,CLAUDE.md Phase 4 清理单 #2):租户 push URL
# 空槽时回退 env PUSH_API_URL(默认即真 UniService 生产址)——后台凭据页点
# 「探测」会对真实服务发空批量 POST({"messages": []},按契约应为无操作,
@@ -204,7 +206,7 @@ curl -s https://chat2.agent.hnxinyouhe.com/health # {"status":"ok",..
curl -sI https://chat2.agent.hnxinyouhe.com/static/widget.js | grep -i cache
curl -s -i --http1.1 -H "Connection: Upgrade" -H "Upgrade: websocket" \
-H "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==" -H "Sec-WebSocket-Version: 13" \
https://chat2.agent.hnxinyouhe.com/ws/chat | head -1 # 期待 101
https://chat2.agent.hnxinyouhe.com/ws/chat | head -1 # 期待 HTTP/1.1 101
```
## 4. 存量迁移(老 jc / auto 项目 → 本平台)