编程 Agent · Skill · pi.dev

PCafe × PiPi 里的 HTML 演示 Skill

Pi 是一个轻量的终端编程 Agent,会从 ~/.agents/skills/(全局)和项目里的 .agents/skills/ 加载技能。启动时只读技能的名字和描述,需要时才读全文,所以装 pcafe 不会占用多少上下文。

第一步

在 Pi 里安装 PCafe

  1. 用第一条命令(npx skills)安装,或者用第二条命令把 skill 解压到 ~/.agents/skills/。
  2. 重新启动 Pi,它会在启动时发现 pcafe。

装好后新开一个对话,让它说说 pcafe 技能是做什么的,答得上来就说明加载成功。

npx skills add Web-Casa/pcafe -s pcafe -g -a pi -y

或者

mkdir -p ~/.agents/skills && curl -fsSL https://p.cafe/downloads/pcafe-skill.zip -o /tmp/pcafe-skill.zip && unzip -oq /tmp/pcafe-skill.zip -d ~/.agents/skills

第二步

装好之后,和 Pi 一起用

  • 说“用 pcafe 做一份演示”;模型没有自动读 skill 时,输入 /skill:pcafe 强制加载。
  • Pi 的工具少而直接,跑 npx pcafe check 和看截图都够用。
  • 配合任何模型都行,模板和检查规则都在 skill 里。

可以直接复制的提示词

/skill:pcafe 把 talk.md 做成一份 8 页的分享演示,用 swiss 风格。npx pcafe check 输出 PASS 后告诉我。

把文件、读者、页数和完成标准说清楚,比说“做得好看点”有用得多。

成品

用 PCafe 做出来的演示

看全部示例 →

为什么用 PCafe

在 Pi 里做 PPT,为什么还要 PCafe

固定模板,不会跑版

Pi 只负责把内容写进 PCafe 的 270 多个开源模板,排版、字号和配色由模板决定,不会每次都换一个样子。

检查到 PASS 才交付

每页都有字数上限。溢出、重叠、字太小都会报 FAIL,Pi 会删减或拆页,再检查,直到 PASS。

一个离线 HTML 文件

成品是一个 HTML 文件,双击就能放映,不用联网;也能导出 PDF 和可编辑的 PowerPoint。

常见问题

PCafe × Pi 常见问题

Pi 为什么没用上 pcafe?

Pi 只在任务和技能描述对得上时才读全文。直接输入 /skill:pcafe,或在提示里写“用 pcafe 技能”。

PCafe 免费吗?

开源版免费,个人和商业项目都能用,作品保留“由 PCafe 制作”署名。Pro 提供 11 套付费成套模板,并可以去掉署名。

能导出 PowerPoint 吗?

可以。让 Pi 运行 npx pcafe pptx <名字>,文字是可编辑的文本框;也可以导出 PDF。

需要 Node.js 吗?

生成 HTML 需要 Node.js 20.19 以上,由 Pi 运行 npx 命令。没有 Node.js 时,skill 会退回到给你故事线和逐页大纲。

Windows 上怎么装?

npx skills 命令在 Windows 的 PowerShell 里同样能用。解压命令是给 macOS 和 Linux 的;在 Windows 上下载 pcafe-skill.zip,解压到用户目录下对应的 skills 文件夹即可,例如 %USERPROFILE%\.agents\skills。

其他工具

PCafe 也能装进这些工具

全部 Skills 和插件 →看 Pro 模板 →