docs(pbls): 修正 health 探针头注释 URL 映射说明(QC 轻微缺陷)

- 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
This commit is contained in:
agent.develop 2026-09-25 11:54:38 +08:00
parent 658e0b7cd8
commit b4ad74cbb9
2 changed files with 7 additions and 4 deletions

View File

@ -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 由框架预加载,直接裸用;

View File

@ -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