用途：生成客户可读的 Markdown 数据目录，其 YAML frontmatter 是有效的 DS_CATALOG_V1 机器契约，并显式保留不确定性，避免将推断或假设的关系呈现为已确认。
主要能力：按业务粒度盘点实体，记录来源访问、层级、体量、profile 指针、分类、血缘与待解决问题；为每个关系分配稳定的 rel-* 标识，记录端点、最大基数、两端最小值、成对连接键字段、置信度与证据依据；核对覆盖计数；从 YAML 事实渲染人类可读章节，并以规范免责声明结尾。
使用方式：确认项目名称与调用方批准的持久输出路径；准备数据源清单与访问状态、业务实体名称与粒度、已声明关系、现有 profile 路径、隐私分类或标准引用；用 scripts/validate_catalog.py 校验，命令为 uv run python scripts/validate_catalog.py <catalog.md>。包内提供 catalog-contract.md、dcat-crosswalk.md、provenance.md、ds-catalog-v1.md、northwind-catalog.md、assets/ds-catalog-v1.schema.json 等资源。
适用场景：需要客户可读且机器可校验的数据目录、实体关系声明、隐私引用与血缘记录的场景。
限制：目录丰富由用户驱动，缺失来源时仅可建议，不得静默修改；来源位置记录为路径或连接引用，不得嵌入凭据；DCAT 对齐为非约束性，目录为原生 YAML 而非 RDF，不作 DCAT 一致性声明；层级记录与层级行为分离；渲染与语义权威分离；实体粒度、关系端点、连接键配对或端点最小值不明确时应停止并请求澄清；证据不足时保留推断或假设置信度；调用方未确认目标前不得持久写入；引用值或 DPIA 状态未知时交由隐私流程处理。契约、工作流、模式、模板、示例与校验器为仓库原创内容，采用 CC BY 4.0 许可。