docs: clarify RPC/Cloudflare tunnels are local-only

README.md

@@ -22,7 +22,7 @@
 | Twenty Workspace | ✅ 已创建（admin@yehwang.com，workspace 已 ACTIVE） |
 | Twenty API Key | ✅ 已在库内生成并写入 `.env`，GraphQL 验证通过 |
 | 商机写入 | ✅ `create_opportunity` 实测创建 company/person/opportunity/note/task |
-| 业务 RPC | ✅ 测试服 24503/24505/24506/24509 外网被封，已用 SSH 隧道（`scripts/rpc-tunnel.sh`） |
+| 业务 RPC | ✅ 本地开发用 SSH 隧道（`scripts/rpc-tunnel.sh`）；测试/生产应直连内网 RPC，不需要隧道 |
 | 邮件通知（OTP） | ✅ 163 SMTP 已配置，实测验证码邮件已送达 163 收件箱 |
 | Email 渠道 | ✅ 163 收件（imap-proxy 绕过 Unsafe Login）+ AI 回复邮件（模板）已实测 |
 | IMAP 代理 | ✅ `services/imap-id-proxy`（LibreDesk 不发 IMAP ID，163 会拒绝 SELECT） |
@@ -80,15 +80,17 @@ crm-new/
 │   ├── configure-email.js     # 配置 163 SMTP（通知/OTP 邮件）
 │   ├── add-email-inbox.js     # 配置 Email Inbox + 默认外发模板 + Automation
 │   ├── e2e-widget-jwt.js      # 端到端验证 widget JWT + 订单工具
-│   ├── rpc-tunnel.sh          # 测试服 JSON-RPC 端口 SSH 隧道（bridge 依赖）
-│   ├── public-https.sh        # Cloudflare Tunnel 公网 HTTPS + 白名单网关
+│   ├── rpc-tunnel.sh          # 仅本地开发：测试服 RPC 端口 SSH 隧道
+│   ├── public-https.sh        # 仅本地联调：Cloudflare Quick Tunnel + 白名单网关
 │   ├── set-public-url.js      # 更新 LibreDesk app.root_url
 │   ├── import-kb-helpcenter.js  # 旧 KB -> 帮助中心文章（幂等）
 │   ├── verify-rag.js         # 临时助手 + preview，验证检索/引用
-│   └── smoke.sh
+│   ├── smoke.sh
+│   └── serve-web.sh           # 仅本地预览 demo 页面
 ├── web/                      # 站点接入：ai-snippet.js + demo.html（widget JWT 演示）
-├── docs/                     # 架构、LibreDesk 配置、接口对照、迁移说明、运维手册
+├── docs/                     # 架构、LibreDesk 配置、环境差异、上线/运维手册
 │   ├── go-live.md            # 上线文档（范围/切流/验收/监控/回滚）
+│   ├── environments.md       # 本地开发 vs 测试/生产：RPC/Cloudflare 隧道差异
 │   ├── human-routing.md      # Email/WhatsApp 人工团队分配
 │   └── plan-a.md             # 方案 A：bridge 接管 AI 编排进度
 └── deploy/nginx.conf.example
@@ -107,6 +109,8 @@ bash scripts/bootstrap.sh
 bash scripts/smoke.sh
 ```
 
+> `scripts/rpc-tunnel.sh`、`scripts/public-https.sh`、`scripts/serve-web.sh` 仅本地开发/联调使用；测试/生产环境不需要，见 [docs/environments.md](docs/environments.md)。
+
 启动完成后：
 
 1. **LibreDesk**（`System`，密码见 `.env` 的 `LIBREDESK_SYSTEM_USER_PASSWORD`）
@@ -184,6 +188,8 @@ bash scripts/serve-web.sh          # http://localhost:8088/demo.html
 
 ## 运维
 
+环境差异见 [docs/environments.md](docs/environments.md)（RPC 隧道/Cloudflare 隧道仅本地开发用）。
+
 上线清单见 [docs/go-live.md](docs/go-live.md)，常用命令见 [docs/runbook.md](docs/runbook.md)（启动/停止/日志/备份/升级/回滚/排错）。
 
 ## 测试