deliver: 交付收口（引擎代为提交）
This commit is contained in:
agent.develop
parent
fa7e8166fc
commit
1722b560c4
@ -8,19 +8,37 @@
|
||||
实测在部分部署机上会**静默失败**（ModuleNotFoundError 之类），后果是「菜单里看得到、
|
||||
点进去一律 403」。因此宿主应用必须有自己的一份注册入口（不同代码路径 = 可靠回退）。
|
||||
|
||||
本脚本的做法：**聚合**各 pbl_* 模块 load_path.py 里的 PATHS 常量，而不是抄一份清单。
|
||||
理由：清单抄两遍必然漂移（模块加了新接口，中央层忘了同步 = 又是 403）。
|
||||
本脚本的做法：**聚合**各 pbl_* / world_sync 模块 load_path.py 里的 PATHS 常量，
|
||||
而不是抄一份清单。理由：清单抄两遍必然漂移（模块加了新接口，中央层忘了同步 = 又是 403）。
|
||||
聚合后中央层与模块层永远一致；同时对 pbl_evidence（M5a 本次退回的模块）保留一份
|
||||
**硬编码兜底清单**，即使模块脚本 import 失败也一定登记进去。
|
||||
|
||||
用法
|
||||
----
|
||||
python3 scripts/load_path.py # 聚合全部 pbl_* 模块路径并注册
|
||||
python3 scripts/load_path.py # 聚合全部模块路径并注册
|
||||
python3 scripts/load_path.py --check # 只做清单一致性核对（不连库）
|
||||
python3 scripts/load_path.py --list # 打印最终在册清单
|
||||
WS_DIR=/path/to/workspace python3 scripts/load_path.py # 指定机构工作空间
|
||||
|
||||
铁律：路径逐条显式，禁止通配符（``%`` / ``*``）。
|
||||
|
||||
═══════════════════════════════════════════════════════════════════════════════
|
||||
里程碑 RBAC 声明台账（中央层，与模块层双写等价）
|
||||
═══════════════════════════════════════════════════════════════════════════════
|
||||
M11b-2（T3，2026-09-22）：
|
||||
结论 = 无新路径登记（中央层同样零新增条目）。
|
||||
理由 = M11b-2 里程碑（world_sync 列级差异比对 + pbl_runtime_ext 单事务事件/状态写入）
|
||||
只交付 **Python 库函数** 与 models/*.json 表定义，**不新增任何
|
||||
.dspy / .ui / .js / .css 可访问路径**，不经 HTTP 路由，故 RBAC 零登记项。
|
||||
双写 = 等价声明同时写在 modules/world_sync/scripts/load_path.py 文件头台账、
|
||||
modules/pbl_runtime_ext/scripts/load_path.py（如存在）、以及说明文件
|
||||
modules/world_sync/wwwroot/api/README-N-A-M11b2.md。
|
||||
兼容 = 本中央脚本已支持两种模块层常量写法：
|
||||
① 扁平 ``PATHS = [(path, role), ...]``；
|
||||
② 分层 ``PATHS_ANY`` / ``PATHS_LOGINED`` / ``PATHS_OWNER_SUPERUSER``
|
||||
/ ``PATHS_OWNER_OPERATOR``（world_sync 采用此写法）。
|
||||
新增模块只需把模块名加进 MODULES，无需在中央层重复维护清单。
|
||||
═══════════════════════════════════════════════════════════════════════════════
|
||||
"""
|
||||
import argparse
|
||||
import importlib.util
|
||||
@ -32,12 +50,27 @@ APP_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
||||
# 机构工作空间根：环境变量 > 应用仓库上溯（apps/pbls -> apps -> workspace）
|
||||
WS_DIR = os.environ.get('WS_DIR') or os.path.normpath(os.path.join(APP_DIR, '..', '..'))
|
||||
|
||||
# 需要登记 RBAC 的模块（pbl_* 全量；本次 M5a 重点是 pbl_evidence）
|
||||
# 需要登记 RBAC 的模块（pbl_* 全量 + 宿主挂载的 world_sync；本次 M5a 重点是 pbl_evidence）
|
||||
MODULES = [
|
||||
'pbl_common', 'pbl_appcodes', 'pbl_governance', 'pbl_blueprint', 'pbl_template',
|
||||
'pbl_validation', 'pbl_compiler', 'pbl_agent_runtime', 'pbl_evidence',
|
||||
'pbl_assessment', 'pbl_kdb_ext', 'pbl_domain_ext', 'pbl_scense_ext',
|
||||
'pbl_analytics', 'pbl_runtime_ext',
|
||||
'world_sync',
|
||||
]
|
||||
|
||||
# ── 里程碑声明台账（中央层，与模块层双写；--check / --list 会原样回显）────────
|
||||
MILESTONE_DECLARATIONS = [
|
||||
{
|
||||
'milestone': 'M11b-2',
|
||||
'new_paths': 0,
|
||||
'declaration': (
|
||||
'M11b-2 本里程碑不新增 .dspy/.ui/.js/.css 路径，仅提供库函数'
|
||||
'（world_sync / pbl_runtime_ext 的 *.py 与 models/*.json），'
|
||||
'故无 RBAC 登记项；禁通配符（%/*），'
|
||||
'如有路径须按 any/logined/owner.* 分层逐条登记（中央层与模块层双写）。'
|
||||
),
|
||||
},
|
||||
]
|
||||
|
||||
# ── pbl_evidence 硬编码兜底清单（与模块层一致；模块脚本 import 失败时由此登记）────
|
||||
@ -56,7 +89,13 @@ PBL_EVIDENCE_FALLBACK = [
|
||||
|
||||
|
||||
def _load_module_paths(mod):
|
||||
"""从 modules/{mod}/scripts/load_path.py 读 PATHS（不执行其注册逻辑）。"""
|
||||
"""从 modules/{mod}/scripts/load_path.py 读 PATHS（不执行其注册逻辑）。
|
||||
|
||||
支持两种常量写法：
|
||||
① PATHS = [(path, role), ...]
|
||||
② PATHS_ANY / PATHS_LOGINED / PATHS_OWNER_SUPERUSER / PATHS_OWNER_OPERATOR
|
||||
（分层列表，role 依次映射 any / logined / owner.superuser / owner.operator）
|
||||
"""
|
||||
script = os.path.join(WS_DIR, 'modules', mod, 'scripts', 'load_path.py')
|
||||
if not os.path.exists(script):
|
||||
return None, 'no scripts/load_path.py'
|
||||
@ -64,10 +103,20 @@ def _load_module_paths(mod):
|
||||
spec = importlib.util.spec_from_file_location('_lp_%s' % mod, script)
|
||||
m = importlib.util.module_from_spec(spec)
|
||||
spec.loader.exec_module(m)
|
||||
out = []
|
||||
paths = getattr(m, 'PATHS', None)
|
||||
if not paths:
|
||||
return None, 'PATHS empty'
|
||||
return [(p, r) for p, r in paths], None
|
||||
if paths:
|
||||
out += [(p, r) for p, r in paths]
|
||||
for attr, role in (('PATHS_ANY', 'any'),
|
||||
('PATHS_LOGINED', 'logined'),
|
||||
('PATHS_OWNER_SUPERUSER', 'owner.superuser'),
|
||||
('PATHS_OWNER_OPERATOR', 'owner.operator')):
|
||||
tier = getattr(m, attr, None)
|
||||
if tier:
|
||||
out += [(p, role) for p in tier]
|
||||
if not out:
|
||||
return None, 'PATHS / PATHS_ANY / PATHS_LOGINED empty'
|
||||
return out, None
|
||||
except Exception as exc: # noqa: BLE001
|
||||
return None, 'import failed: %s' % (exc,)
|
||||
|
||||
@ -131,12 +180,19 @@ def register(paths, verbose=True):
|
||||
return [p for p, _r in pending]
|
||||
|
||||
|
||||
def print_milestone_declarations():
|
||||
print('[apps/pbls] 里程碑 RBAC 声明台账（中央层，与模块层双写等价）')
|
||||
for d in MILESTONE_DECLARATIONS:
|
||||
print(' - %s: 新增路径 %d 条 -> %s' % (d['milestone'], d['new_paths'], d['declaration']))
|
||||
|
||||
|
||||
def main():
|
||||
ap = argparse.ArgumentParser(description='pbls central RBAC registration (fallback layer)')
|
||||
ap.add_argument('--check', action='store_true', help='aggregate + wildcard audit only')
|
||||
ap.add_argument('--list', action='store_true', help='print aggregated paths and exit')
|
||||
args = ap.parse_args()
|
||||
|
||||
print_milestone_declarations()
|
||||
paths, notes = collect()
|
||||
for note in notes:
|
||||
print('[collect] ' + note)
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user