From 15b778ecf22e191fb196ca94f73141b385a1c941 Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Tue, 25 Aug 2026 15:05:35 +0800
Subject: [PATCH] docs: clarify Portal YAML precedence (#56)

---
 Local-Development-and-Verification.-.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/Local-Development-and-Verification.-.md b/Local-Development-and-Verification.-.md
index 93a906c..c19476f 100644
--- a/Local-Development-and-Verification.-.md
+++ b/Local-Development-and-Verification.-.md
@@ -318,12 +318,13 @@ git diff --check
 
 内嵌 worker 的运行参数：
 
-| 变量 | 非生产默认 | 生产要求 |
-|---|---:|---|
-| `CHORUS_WORKER_LEASE_SECONDS` | 60 | 必须显式设置，且大于 HTTP 超时 + 5 秒 |
-| `CHORUS_WORKER_POLL_MILLISECONDS` | 250 | 必须显式设置 |
-| `CHORUS_PROVIDER_HTTP_TIMEOUT_SECONDS` | 45 | 必须显式设置 |
-| `CHORUS_PROVIDER_MAX_RESPONSE_BYTES` | 33554432 | 必须显式设置 |
+| YAML 字段 | 环境覆盖变量 | 示例值与约束 |
+|---|---|---|
+| `worker.lease_seconds` | `CHORUS_WORKER_LEASE_SECONDS` | 60；必须大于 HTTP 超时 + 5 秒 |
+| `worker.poll_milliseconds` | `CHORUS_WORKER_POLL_MILLISECONDS` | 250；正整数 |
+| `provider.http_timeout_seconds` | `CHORUS_PROVIDER_HTTP_TIMEOUT_SECONDS` | 45；正整数 |
+| `provider.max_response_bytes` | `CHORUS_PROVIDER_MAX_RESPONSE_BYTES` | 33554432；正整数 |
+| `provider.allowed_ports` | `CHORUS_PROVIDER_ALLOWED_PORTS` | 默认示例为 80/443；仅显式加入所需公开端口 |
 
 `CHORUS_TEST_DISABLE_WORKER=true` 仅供 `CHORUS_ENV=test` 的 Playwright fixture 使用。测试 helper 位于 `portal/web/e2e/fixture`，会按构造用户归属写入受控状态和测试图片；不得打包部署，也不得用于开发或生产数据。mock 上游的自动测试通过依赖注入连接本地 fixture，不允许把回环地址加入生产 SSRF 白名单。