用途:为 Next.js 项目中的 MDX 文章生成专属 SVG 视觉资源,包括文章封面以及真正有助于理解内容的内联图表和流程图,并把图片引用写回文章。
主要能力:读取并分析文章,识别封面需求与适合配图的概念(架构/系统图、前后对比、分步流程或管线、层级/树/模块结构、决策流程图);生成封面 SVG 与内联图 SVG,更新 MDX 中的图片引用以及 frontmatter 的 coverImage 字段。
输入:slug、articlePath(content/articles/<slug>.mdx)、mode(cover | inline | both)、theme(light | dark | auto)。输出为结构化交接信息,包含 slug、生成文件列表、mdxUpdated、insertedImageRefs、coverImageValue 与 notes。
项目约定:文章位于 content/articles/.mdx,图片位于 public/images/articles/ 并以 /images/articles/filename.svg 引用;coverImage 接受 slug 风格字符串。封面 SVG 尺寸 800×450,内联图默认 800×450,纵向流程图可用 600×700。SVG 使用 globals.css 中 --pres- 派生的硬编码十六进制色值,因为 public/ 下的 SVG 不能用 CSS 变量;globals.css 变更后需重新派生色值。
流程:先分析文章定位配图点,再生成封面并更新 frontmatter,随后生成内联图并在对应段落后插入带描述性 alt 文本的 markdown 引用,最后自检图片是否真正增加价值,无效图片应删除。
限制与检查点:若提议超过 3 张内联图,需先让用户确认图列表;文章较短且配图价值不大时建议跳过内联图。不制作演示幻灯片,不创建 ASCII 卡片封面组件。文章卡片实际渲染的是在 src/components/covers/index.ts 注册的 ASCII 封面,而非 coverImage SVG;该字段目前不会自动显示,仅可用于未来场景(如 OG 图片、文章头图);若用户想要卡片图,应改用 ascii-cover 技能。除非为合理放置图片,否则不重构文章章节。收费、价格等信息暂未提供。