我给龙虾的PPT工具,加了一扇＂橱窗＂

跟我养龙虾，学术不抓瞎。🦞

---

凌晨十二点，我在改一个工具。

起因很简单——我发现 ppt-afp 在让用户选风格时，只能看到一张文字表格：

| 1 | bold-editorial | 黑底大字，杂志封面感 | 直播、keynote || 2 | dark-atmospheric | 暗色沉浸，电影质感 | 品牌故事 || 3 | minimal | 极简留白，高级感 | 学术分享 |...（共37行）

这哪里是在选风格，这是在背单词。

用户怎么可能通过”极光渐变”四个字，想象出一张幻灯片长什么样？

---

目标是：让用户在选风格的时候，能直接看图选号。

37种风格，按场景分成7类：

• • 🔥 演讲/发布（6种）
• • 💼 商务/数据（4种）
• • 📚 教育/学术（6种）
• • 🎨 创意/艺术（7种）
• • 🔮 科技/未来（5种）
• • 🏛 文化/特色（5种）
• • ⚔️ 特殊风格（4种）

每一类做一张拼图，把该类所有风格的预览图排列在一起，加上编号角标和风格名。

---

技术上卡了两次

第一次卡：字体

用 PIL 在图片上写中文，结果全是方块。macOS 的中文字体路径不一样，找了一圈才解决。

第二次卡：飞书图片插入

拼图做好了，要放进飞书文档。以为直接上传就行，结果 API 报错。

翻了文档才发现：飞书插图是三步流程，不能一步到位——

Step 1：创建空的 image block（先占位）

Step 2：上传图片到这个 block（绑定）

Step 3：batch_update 写入 token（激活）

少任何一步都不行。

走了两条弯路之后，第三版脚本跑通了：

📂 [1/7] 🔥 演讲/发布  Step1: created empty image block ✓  Step2: uploaded → Sa7tbOp0go...  Step3: patched ✅ (2000x1000)...🎉 Done!

凌晨 12:08，文档做好了。

---

然后更新了 SKILL.md

原来 P1 阶段是展示一张文字表格。

现在改成两步：

Step 1：直接发飞书文档链接

我为你准备了37种PPT风格预览，打开看看，选一个你喜欢的编号（1-37）告诉我就行！

Step 2：用户回复编号，确认受众和张数，继续生成。

整个改动很小，但体验差很多——从读文字想象，变成看图做选择。

---

凌晨 12:14，发布 ppt-afp@1.1.0^[1]

✔ OK. Published ppt-afp@1.1.0

一个版本，一个改进，睡觉。

---

我想说的是

工具是用来用的，不是用来展示的。

第一版 ppt-afp 选风格，放了一张 37 行的文字表。它能用，但用户要做额外的脑力工作——把文字转化成视觉印象，再做判断。

这是我强加给用户的认知负担。

加一个”橱窗”，让图说话，这才是工具该做的事。

跟我养龙虾，学术不抓瞎。🦞

---

一平博士和他的助理二饼

引用链接

[1] ppt-afp@1.1.0: mailto:ppt-afp@1.1.0