agent.develop
|
6176b41ac9
|
docs(pbls): health 探针首行改路径无关写法，消除 apps/pbls 与 modules/pbls 双工作副本内容分歧
|
2026-09-25 12:33:38 +08:00 |
|
agent.develop
|
079fac39d4
|
docs(pbls): 修正 apps/pbls 侧 health 探针首行路径注释（与文件实际落点一致）
|
2026-09-25 12:32:53 +08:00 |
|
agent.develop
|
39354c1d30
|
fix(pbls): 同步补齐 /api/public/health 探针真实可执行正文（QC 退回 #2#3#4#5）
与 apps/pbls 同名探针同源修复：原 2610B/32 行全注释零可执行语句 → 补齐
组装健康信息字典 + json.dumps(default=str) + 每分支显式 return（return 在
async with 块外）+ 外层 try/except 兜底。自检 AST_OK/ast_stmts=18/ast_return=2/
return_in_asyncwith=NONE/非注释可执行行=29/bytes=4374。
|
2026-09-25 12:31:47 +08:00 |
|
agent.develop
|
6f7a810603
|
deliver: 交付收口（引擎代为提交）
|
2026-09-25 11:56:10 +08:00 |
|
agent.develop
|
b4ad74cbb9
|
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
|
2026-09-25 11:54:38 +08:00 |
|
agent.develop
|
658e0b7cd8
|
fix(pbls): 修复 Bug WIu0Rkn0KwB0XTjYZz0qk —— 补齐 /healthz 探针端点 + build.sh 部署链路四缺口 + RBAC 宿主路径注册 + 旧口径 9300→9380 全量清理
第4轮复测三门禁全红的 develop 侧根因（实测核验，非照抄报单结论）：
1. /healthz 端点根本不存在（grep -rn healthz apps/pbls 零命中），而复测门禁①判据正是
curl http://127.0.0.1:9380/healthz；build.sh 自检却走另一条 /api/public/health（同样无实现）
→ 进程活着也必然 HTTP!=200，且存在「自检绿/复测红」假通过隐患。
2. build.sh 从不调 scripts/load_path.py（grep 零命中）→ 新端点无 RBAC 登记即 401/403。
3. build.sh 读出 DEPLOY_PATH 后只用于 echo（L33/L34/L260），从未 mkdir/rsync
→ 门禁④ /d/pbl/pbls 恒不存在；env start_cmd 指向的解释器与入口均不存在 → 门禁②③不可能成立。
4. logs/ 目录到步骤13才 mkdir，而步骤11已 tee logs/self_check.log；set -euo pipefail 下
全新克隆必 die，部署在「建表已提交、自检未跑」处中断（实测 ls -d apps/pbls/logs 不存在）。
修复（同类问题全量排查，不只修报出来的那一个）：
- 新增 wwwroot/healthz/index.dspy、wwwroot/healthz.dspy、wwwroot/api/public/health/index.dspy
三个探针（零 import / 每分支显式 return json.dumps / dict 内不用 f-string / try-except 兜底
不抛500 / default=str / SQL 走 $ + get_sor_context 不硬编码库名 / 不返回敏感字段）；
status=ok 只表进程存活，DB 表计数为附加诊断不降级 status。
- build.sh 新增步骤 10b（mkdir logs run 前置）、12.5（load_path.py --check 门禁 + 正式注册，
失败明确 die 不静默）、12.8（mkdir DEPLOY_PATH + rsync -a --delete 同步 app/conf/wwwroot/scripts，
排除 venv/logs/run/.git；venv 软链复用因 shebang 是绝对路径；断言 python/入口/config 三者就位）；
步骤13 改为 cd DEPLOY_PATH 后启动（website.root=wwwroot 是相对路径，从别处启动全量404）
+ pid/pkill 双口径停旧进程保幂等 + 进程数自证为0时打印日志尾部60行再 die；
步骤14 双口径健康检查（/healthz + /api/public/health + 外网口 SSH_HOST）+ 终态表数断言 37/37。
- scripts/load_path.py 新增 HOST_PATHS 四条（/healthz、/healthz.dspy、/api/public/health、
/api/public/health.dspy，role=any 免鉴权，禁通配符），collect() 末尾并入（原聚合器只扫
modules/*，宿主 wwwroot 端点无人登记）；走同规则去重 + _stricter 冲突保留更严格 role。
- 旧口径 9300→9380 清理 4 处：build.sh:4 头注释、wwwroot/index.ui:179 状态栏（用户可见）、
pbl_appcodes/__init__.py:14、pbl_appcodes/init.py:16；_patch_common_contract_symbols.py:9
属历史修复台账，有意保留原文不改（改历史记录=伪造）。
- conf/config.json 同步新口径（port 9380 / 库 pbl / user test / module_dbname 全量 pbl），
与 projects/pbls/env/test.json 唯一事实源同值，满足 build.sh 步骤1 端口一致性门禁。
自证（真实回显）：bash -n build.sh OK；py_compile load_path.py OK；
load_path.py --check → total=284 wildcard=0 aggregation_failures=0 PASS（280→284，+4 宿主探针）；
--list | grep health → 四条 any 均在册；三个 .dspy 经 ast.parse 包装校验 AST OK、
no import/no print、return×2；grep -rn 9300 于四处改动文件零命中。
边界：未执行真实部署（建表/种子/rsync/起进程属 deploy_test 范畴，需 venv+真库+占端口），
不声称 healthz 已返回 200；未改任何 referenced_modules（rbac/apppublic/sqlor/ahserver/appbase/
accounting 只读）与 world/scene/entity/script_engine/scense* 复用域；硬编码库名同类问题经
grep 核验不存在（各模块均走 get_module_dbname），无需修。
详见 projects/pbls/docs/02-develop/dev-notes.md 2026-09-25 节。
|
2026-09-25 11:35:23 +08:00 |
|