本工具用于一次性检查全库 Markdown 的 YAML frontmatter 是否符合推荐规范(字段齐全、日期格式正确、布尔/状态合法)。

推荐字段(顺序建议保持一致)

---
title: 
tags: []
type: card|moc|source|canvas|project|area|resource|archive|guide
created: YYYY-MM-DD
modified: YYYY-MM-DD
publish: true|false
status: draft|review|done|archived
aliases: []
up: []
---

使用方法

  • Windows PowerShell:
python Extras/Scripts/frontmatter_validator.py .
  • macOS/Linux:
python3 Extras/Scripts/frontmatter_validator.py .

执行完成后,控制台会输出存在问题的文件与问题明细;不做任何修改,便于批量修复前的确认(dry-run)。

说明

  • 该脚本为零依赖实现,仅解析顶层 key: value 行,复杂嵌套将被忽略但不影响检查;
  • 可按需扩展校验规则(如私密信息扫描);
  • 建议定期运行,保持元数据健康,提升 Bases/发布流效果。