SuperAPI AI 工具集

brain-pdf

办公与效率

查看项目

更新于 10-16 03:47

技能介绍

用途:把 Brain 页面(带 frontmatter 的 Markdown)渲染成出版级 PDF,用于邮件或 Telegram 分享个性化书籍镜像、交付战略阅读手册、生成带页眉页码的简报或报告,以及归档长文。规则是 Brain 页面始终为唯一真源,PDF 只是渲染,不能脱离源页面单独存在。

主要能力:调用 gstack make-pdf 二进制渲染;去除 YAML frontmatter(否则会输出整页原始元数据);清理无法映射字体的 emoji(避免出现方框);默认不加封面和目录,仅在用户明确要求正式输出时添加;支持 DRAFT 水印;支持自定义标题与作者覆盖。

使用方式:先确认页面存在(gbrain get <slug>),再获取原始 Markdown,用 sed 去除 frontmatter,最后以 CONTAINER=1 调用 make-pdf generate 输出 PDF。示例命令:P="$HOME/.claude/skills/gstack/make-pdf/dist/pdf"; [ -x "$P" ] || { echo "make-pdf not installed; install gstack" >&2; exit 1; };CONTAINER=1 "$P" generate "$CLEAN" "$OUT"。容器环境必须设 CONTAINER=1 以跳过 Chromium 沙箱。

依赖与限制:需预先安装 gstack make-pdf,v0.25.1 为软前置依赖,未来 v0.26+ 可能内置回退渲染器;需要 fonts-liberation 和 fonts-noto-cjk 字体(Debian/Ubuntu 容器可 apt install fonts-liberation fonts-noto-cjk),正文字号最小 10pt、正文建议 11pt。Telegram 交付应使用 message 工具的 filePath 附件,不要用原始 MEDIA: 标签(会静默失败)。缺少字体、未安装 gstack 或未确认源页面存在时无法正常渲染。

适用场景:个人知识库长文分享、战略阅读手册、简报报告、长文归档。相关技能包括 book-mirror、strategic-reading 和 publish(后者输出受密码保护的 HTML)。