目录内核与治理模型概览

Portico 的 Catalog 目录模块是整个治理门户的数据中心与唯一事实来源（Single Source of Truth）。

核心职责

服务画像登记：记录所有 Agent 的身份标识、中英文元数据、通信渠道与协议入口坐标。
生命周期治理：驱动记录在 draft、internal、pending_public、approved_public 与 rejected 五态之间有序转移。
公开审批缓冲：拦截未经授权的公开暴露行为，强行注入人类审计门禁。
统一投影分发：确保 Web Portal、CLI 以及 MCP 协议端点对外呈现完全一致的目录视图。

目录文件结构

目录数据保存在 data/catalog.json 中，核心包含两部分：

records：当前存活的服务表面列表。
changes：追加写变更历史，记录谁在何时创建或修改了何种字段。

所有底层写操作均受原子文件重命名保护，杜绝因进程被杀导致的 JSON 结构损坏。