Feishu Papercut Showcase — Git skill for Claude Code

feishu-papercut-showcase

**Claude Code Skill** — 给我一个飞书多维表格链接，我把它做成一个**纸艺剪纸风的滚动展示网站**， 上线 GitHub Pages，并让数据**每天自动同步、链接永不过期、你电脑不用开机**。

合并自两个 skill：[`paper-cut-scroll-site`](https://github.com/Jane-xiaoer)（会做好看的剪纸滚动站）

• `feishu-portfolio-launch`（飞书数据 + 自动同步引擎）。 起源：《实验编程》工作坊 · 飞书多维表格案例。

线上范例：

• 剪纸视觉外壳 → https://xiaoer-workbox-deploy.vercel.app
• 飞书活数据 + 自动刷新 → http://video.xiaoerai.xyz

---

能做什么

给一个飞书多维表格链接，自动完成：

1. 生成原创纸艺外壳 — chigiri-e / Eric Carle 拼贴风的箱子、柜子、道具剪纸片（AI 生成 + 抠透明）。
2. 搭滚动叙事动画 — 一个箱子 打开 → 内容满铺撒开 → 归类 → 飞进柜子/网格 → 点每格看详情，全程一段连续动画 + 音效/惯性光标/微物理打磨层。
3. 接飞书数据 — 从多维表格导出文本 / 链接 / 媒体附件，前端运行时读，不写死会过期的 URL。
4. 上线 GitHub Pages — 免费托管，几分钟可访问。
5. 定时自动同步 — 飞书临时链接 24h 过期，由 GitHub Actions 每 12h 自动换新链接并重新部署。
6. 绑定自定义域名（可选）。

**你只需要：** 提供表格链接 → 在飞书开放平台给应用开一次权限（唯一人工步骤）→ 选风格 → 确认预览。

---

两种模式

• Mode A · 工作箱 / 工具 / 技能展示 — 内容以文本 + 链接为主，每格配一张生成的剪纸图标。
• Mode B · 视频 / 图片作品集 — 内容是飞书里的真附件，剪纸做外壳/相框，媒体链接自动刷新。

适用 / 不适用

✅ 作品集、工具箱、技能墙、样片库、任何「内容在飞书、前台只负责好看地展示」的场景 ❌ 图文博客、电商/支付/登录、需要后端写入的网站

---

安装使用

**方式一：clone 到 skills 目录**

git clone https://github.com/Jane-xiaoer/feishu-papercut-showcase.git \
  ~/.claude/skills/feishu-papercut-showcase

**方式二：只取 SKILL.md**

mkdir -p ~/.claude/skills/feishu-papercut-showcase
curl -o ~/.claude/skills/feishu-papercut-showcase/SKILL.md \
  https://raw.githubusercontent.com/Jane-xiaoer/feishu-papercut-showcase/main/SKILL.md

装好后，在 Claude Code 里说：

「用我的飞书多维表格做一个剪纸风展示站并上线自动同步」+ 甩出表格链接。

---

唯一的人工步骤：飞书应用配置

GitHub Actions 无人值守，用的是**应用租户身份**（不是你的登录态），所以必须：

1. 飞书开放平台建企业自建应用，抄下 App ID / App Secret。
2. 开 2 类权限：bitable:app:readonly（读多维表格）+ 下载云文档媒体，然后发布版本。
3. 把应用加进你那张多维表格当协作者（漏了必报 91403）。
4. 拿到 4 个值交给 Claude：LARK_APP_ID / LARK_APP_SECRET / LARK_BASE_TOKEN / LARK_TABLE_ID。

细节见 `SKILL.md` 的 **Part 2 · Step D2**。

---

能力边界（诚实声明）

自动同步刷的是**文本 + 链接 + 飞书媒体附件**。 **不会**自动刷**新增条目的剪纸画**——每片剪纸是 AI 单独生