From b4ad74cbb99f388fd456d35b4fbb305e0f9e30d8 Mon Sep 17 00:00:00 2001 From: "agent.develop" Date: Fri, 25 Sep 2026 11:54:38 +0800 Subject: [PATCH] =?UTF-8?q?docs(pbls):=20=E4=BF=AE=E6=AD=A3=20health=20?= =?UTF-8?q?=E6=8E=A2=E9=92=88=E5=A4=B4=E6=B3=A8=E9=87=8A=20URL=20=E6=98=A0?= =?UTF-8?q?=E5=B0=84=E8=AF=B4=E6=98=8E=EF=BC=88QC=20=E8=BD=BB=E5=BE=AE?= =?UTF-8?q?=E7=BC=BA=E9=99=B7=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - wwwroot/api/public/health/index.dspy 头注释系从 healthz 版复制，误写 '-> GET /healthz'，实际映射为 '-> GET /api/public/health'，已修正； 并补明双探针路径分工（healthz/index.dspy=复测门禁① 判活口径， api/public/health/index.dspy=build.sh 步骤14 自检口径，healthz.dspy= 带扩展名兼容副本），三者均在 scripts/load_path.py 以 any 角色逐条注册。 - wwwroot/healthz.dspy 头注释首行文件名同步为自身路径（原误写 index.dspy）。 - 仅注释文本变更，无逻辑改动；三份 .dspy 均通过 ast 包装语法自检。 - 同类问题全仓扫描：/opt/pbls 残留 0、pbls 库名口径残留 0、 9300 仅存于 venv 第三方 pip 常量与历史补丁脚本注释（非活动配置）。 关联 Bug: WIu0Rkn0KwB0XTjYZz0qk --- wwwroot/api/public/health/index.dspy | 9 ++++++--- wwwroot/healthz.dspy | 2 +- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/wwwroot/api/public/health/index.dspy b/wwwroot/api/public/health/index.dspy index 7fa7262..fd225c9 100644 --- a/wwwroot/api/public/health/index.dspy +++ b/wwwroot/api/public/health/index.dspy @@ -6,11 +6,14 @@ # （grep -rn healthz apps/pbls/app apps/pbls/wwwroot 零命中），而 build.sh 步骤 14 # 自检用的却是另一条路径 /api/public/health（同样不存在）。两条探针路径都缺 → # 即便进程起来、端口监听，门禁 ① 也必然 HTTP=000/404，冒烟永远不可能转绿。 -# 本文件补齐 /healthz；同批补 wwwroot/api/public/health/index.dspy 保持 build.sh 原口径。 +# 本文件补齐 build.sh 步骤 14 自检口径 GET /api/public/health；同批由 +# wwwroot/healthz/index.dspy 提供复测门禁 ① 口径 GET /healthz（两者同逻辑，双路径都在 +# scripts/load_path.py 以 'any' 角色逐条注册，无通配符）。 # # 【URL 映射】ahserver 按 website.root=wwwroot + processors['.dspy']='dspy' 解析： -# wwwroot/api/public/health/index.dspy -> GET /healthz -# 另在 wwwroot/healthz.dspy 放同逻辑副本 -> GET /api/public/health（兼容带扩展名探测）。 +# wwwroot/api/public/health/index.dspy -> GET /api/public/health +# 另在 wwwroot/healthz/index.dspy 放同逻辑副本 -> GET /healthz（复测门禁 ① 判活口径）， +# wwwroot/healthz.dspy -> GET /healthz.dspy（兼容带扩展名探测）。 # # 【dspy 规约（dspy-file-implementation-spec 硬规则）】 # * 零 import：json / datetime 由框架预加载，直接裸用； diff --git a/wwwroot/healthz.dspy b/wwwroot/healthz.dspy index f6a343d..e2e2924 100644 --- a/wwwroot/healthz.dspy +++ b/wwwroot/healthz.dspy @@ -1,4 +1,4 @@ -# apps/pbls/wwwroot/healthz/index.dspy —— 部署冒烟健康探针（无鉴权 / any 角色） +# apps/pbls/wwwroot/healthz.dspy —— 部署冒烟健康探针带扩展名副本（无鉴权 / any 角色） # # 【为什么必须有这个文件】Bug WIu0Rkn0KwB0XTjYZz0qk 第 4 轮复测门禁 ① 用 # curl -s -m 8 -o /tmp/h1.txt -w 'HTTP=%{http_code}' http://127.0.0.1:9380/healthz