添加gfilter专用worker (#103)

Co-authored-by: kdletters <kdletters@qq.com>
Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/103
Co-authored-by: Linghong <ink29535@proton.me>
Co-committed-by: Linghong <ink29535@proton.me>

deploy/env/api-server.env.example

@@ -17,6 +17,10 @@ GENARRATIVE_EXTERNAL_GENERATION_WORKER_POLL_INTERVAL_MS=2000
 GENARRATIVE_EXTERNAL_GENERATION_WORKER_LEASE_SECONDS=600
 GENARRATIVE_EXTERNAL_GENERATION_WORKER_JOB_TIMEOUT_SECONDS=900
 GENARRATIVE_EXTERNAL_GENERATION_WORKER_LONG_JOB_TIMEOUT_SECONDS=1800
+# 父流程只访问同机 BgFilter worker；内部 Token 只通过受保护文件共享，不写明文 env。
+GENARRATIVE_BGFILTER_WORKER_BASE_URL=http://127.0.0.1:8083
+GENARRATIVE_BGFILTER_INTERNAL_TOKEN_FILE=/etc/genarrative/secrets/bgfilter-worker.token
+GENARRATIVE_BGFILTER_WORKER_CONNECT_TIMEOUT_MS=2000
 GENARRATIVE_API_MAX_CONCURRENT_REQUESTS=512
 GENARRATIVE_API_ADMIN_MAX_CONCURRENT_REQUESTS=16
 GENARRATIVE_API_SHUTDOWN_OUTBOX_FLUSH_TIMEOUT_MS=5000
@@ -30,9 +34,12 @@ GENARRATIVE_WALLET_REFUND_OUTBOX_DIR=/var/lib/genarrative/wallet-refund-outbox
 GENARRATIVE_WALLET_REFUND_OUTBOX_BATCH_SIZE=100
 GENARRATIVE_WALLET_REFUND_OUTBOX_FLUSH_INTERVAL_MS=1000
 GENARRATIVE_WALLET_REFUND_OUTBOX_MAX_BYTES=67108864
-GENARRATIVE_EDITOR_BGFILTER_REQUEST_TIMEOUT_MS=180000
-GENARRATIVE_EDITOR_BGFILTER_CIRCUIT_FAILURE_THRESHOLD=3
-GENARRATIVE_EDITOR_BGFILTER_CIRCUIT_COOLDOWN_SECONDS=300
+# N 与单图估时：父子共同派生 attempt = N×est×2、callBudget = 2×attempt+1s 的公式输入；
+# 单一来源放共享 env，专属 worker env 不重复定义。旧固定 REQUEST_TIMEOUT_MS 已删除。
+GENARRATIVE_BGFILTER_WORKER_CONCURRENCY=16
+GENARRATIVE_EDITOR_BGFILTER_SINGLE_IMAGE_ESTIMATE_MS=5000
+GENARRATIVE_EDITOR_BGFILTER_BASE_URL=http://58.87.105.82/bgfilter
+GENARRATIVE_EDITOR_BGFILTER_TOKEN=
 # BgFilter 失败后的中间兜底：阿里云通用抠图（SegmentCommonImage）。AccessKey 留空则跳过该层，
 # BgFilter 失败直接本地 editor_green_screen 去背；填入后恢复 BgFilter→阿里云→本地三级兜底。
 # AccessKey 也可复用标准 SDK 命名 ALIBABA_CLOUD_ACCESS_KEY_ID / ALIBABA_CLOUD_ACCESS_KEY_SECRET。

deploy/env/bgfilter-worker.env.example

@@ -0,0 +1,18 @@
+# 复制到 /etc/genarrative/bgfilter-worker.env；只放专用进程独占参数和可选日志覆盖。
+# provider、OSS、内部 Token 文件、N（CONCURRENCY）与单图估时统一来自先加载的 api-server.env，禁止在此重复定义。
+# systemd unit 会强制设置 GENARRATIVE_PROCESS_ROLE=bgfilter-worker。
+
+GENARRATIVE_ENV=production
+GENARRATIVE_BGFILTER_WORKER_HOST=127.0.0.1
+GENARRATIVE_BGFILTER_WORKER_PORT=8083
+# Q：admission 保险丝，只防连接风暴；正常业务不应触达，显式配置时必须 >= N。
+GENARRATIVE_BGFILTER_WORKER_MAX_REQUESTS=2048
+# flat / complex 熔断只由本进程维护；两种模式共享参数，但状态互相独立。
+GENARRATIVE_EDITOR_BGFILTER_CIRCUIT_FAILURE_THRESHOLD=3
+GENARRATIVE_EDITOR_BGFILTER_CIRCUIT_COOLDOWN_SECONDS=120
+
+GENARRATIVE_API_LOG=info,tower_http=info
+GENARRATIVE_OTEL_ENABLED=true
+OTEL_SERVICE_NAME=genarrative-bgfilter-worker
+OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4318
+OTEL_RESOURCE_ATTRIBUTES=deployment.environment=production,service.namespace=genarrative

deploy/env/health-patrol.env.example

@@ -2,6 +2,9 @@
 # 默认不启用 Pingora shadow 巡检；只有同时配置 base URL 与 probe token 才会检查。
 
 GENARRATIVE_HEALTH_PATROL_API_BASE_URL=http://127.0.0.1:8082
+# 巡检是独立进程，不读取 bgfilter-worker.env；若自定义了 GENARRATIVE_BGFILTER_WORKER_PORT，
+# 必须在此同步改为相同端口，否则巡检会持续误报 worker 不健康。
+GENARRATIVE_HEALTH_PATROL_BGFILTER_BASE_URL=http://127.0.0.1:8083
 GENARRATIVE_HEALTH_PATROL_SPACETIME_BASE_URL=http://127.0.0.1:3101
 GENARRATIVE_HEALTH_PATROL_PUBLIC_BASE_URL=http://127.0.0.1
 # 默认公网入口仍按 Nginx 巡检；Pingora 直连切换后改为 pingora-direct。