SuperAPI AI 工具集

obsidian-blog-requirements

写作与研究

查看项目

更新于 10-16 07:19

技能介绍

用途:在准备用 gen-blog 生成博客前,校验 Obsidian 笔记是否符合要求,并诊断生成失败原因。

主要能力与规则:仅当笔记含 blog_publish: true 时才会被收录,缺失该字段则被忽略。已发布文章必需字段包括 blog_title、blog_date、blog_lang、blog_translation_key、blog_category、blog_excerpt。blog_translation_key 需为小写 slug 或路径(a-z0-9 加 -),不能含空格。blog_category 为非空列表,允许多个分类,输出时第一项作为 primaryCategory。关于页面使用 blog_translation_key: about,并需同时提供 zh 和 en。图片可引用库内任意位置的本地文件、外部 URL 或 data URI,生成器会将其复制/规范化到 dist/assets(WebP 加压缩回退),且不修改源文件。

使用方式:确认库路径后运行 npm run generate -- <vaultDir> dist。若生成失败,可参照 references/troubleshooting.md 将错误映射到修复方法;确保每篇发布文章满足 references/frontmatter.md 中的 frontmatter 规则。

限制:资料未提供更多平台、收费或效果信息。