用途：metaprev 是本地命令行工具，用于在发布前检查链接分享卡片。它抓取 URL、解析 Open Graph 与 X 元数据、校验所选图片与回退项，并打开本地预览与修复工作区，展示 Facebook、X、LinkedIn、Discord 的代表性卡片。Slack 经典展开使用同一套被检查的元数据，但不会把 Discord 界面当作 Slack 截图呈现。它可对任意 localhost 开发服务器和公开 URL 工作，无需校验服务。
主要能力：输出 error、warn、info 三级问题，每条含稳定代码、影响、证据与具体修复建议。HTML 工作区展示 Open Graph 与 X 输入、来源回退、裁剪与适配证据，以及可复制的元数据、修复简报和受约束的编码代理提示。子命令 issues、facts 可输出文本或 JSON，便于脚本与 CI 使用。
使用方式：默认用 npx 调用，无需安装，但 PATH 中需有 Bun。示例：npx @forsvn/metaprev https://example.com；npx @forsvn/metaprev http://localhost:3000；npx @forsvn/metaprev issues https://example.com；npx @forsvn/metaprev facts https://example.com --json；npx @forsvn/metaprev https://example.com --json；--no-open 不自动打开浏览器；-o 指定预览 HTML 输出文件；--insecure 用于本地自签名 TLS。退出码：0 干净，1 至少一个 error 级问题，2 抓取失败，可用 1 让 CI 失败。
适用场景：检查链接分享外观、修复 og:image/og:title/og:description/og:url/twitter:card、校验图片尺寸与文件大小及绝对 URL、调试 Slack/Discord/iMessage 嵌入、部署前检查分享卡片健康度、验证新生成的 OG 图片。不适用于 favicon、PWA manifest、OG 图片生成、纯 SEO 元数据或 schema.org/JSON-LD。
限制：需 Bun 在 PATH 中；当前通过正则解析 head 子串，使用 base href 或 head 外元标签的页面可能解析不完美；平台卡片为代表性模拟，可能与真实 UI、视口处理和缓存展开不同；不渲染 JavaScript，客户端 JS 设置的元标签无法被看到。平台缓存刷新时间无法承诺。