feat: 统一 L1 公网调试入口配置

2026-07-17 16:20:50 +02:00
parent 60fdf72489
commit 9d3f53f7b5
7 changed files with 178 additions and 1 deletions
@@ -47,6 +47,11 @@ description: >-
 - Web 使用 `$unidesk-webdev` 的 `web-probe` custom/local 入口访问 native Web。
 - 微服务项目只启动当前微服务的前端、API、Worker及必要依赖。
 - 前端、API 和 Worker可以分别启动、查看日志、重启和停止。
+- 对用户披露的 native API/Web 调试入口必须是 owning YAML 声明的公网 `IP:port`：
+  - `0.0.0.0` 只表示进程 bind；
+  - `127.0.0.1` 只用于本机 probe 或进程间代理；
+  - bind/probe 地址不得作为 L1 用户入口返回；
+  - 公网 IP、API port 和 Web port 缺失时必须明确失败，不得回退到 localhost 或代码默认值。
 - 适合前后端联调、异步作业、Workflow、网络接口和页面交互的快速开发。

 ## L2 Development