Skip to content
Back to search

feishu-portfolio-launch

Claude Code skill: 飞书多维表格 → GitHub Pages 作品集网站全流程一键上线

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jane-xiaoer--feishu-portfolio-launch/badge.svg)](/listings/jane-xiaoer--feishu-portfolio-launch)

HTML

<a href="/listings/jane-xiaoer--feishu-portfolio-launch"><img src="/api/listings/jane-xiaoer--feishu-portfolio-launch/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 423 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: feishu-portfolio-launch
  3. description: 从飞书多维表格链接出发,生成并上线作品集网站到 GitHub Pages,并用 GitHub Actions 定时刷新飞书临时媒体链接。适用于视频/图片附件存在飞书、需要对外展示的创作者(AI 视频、摄影、设计、样片库等)。不适合博客、电商、需要后端写入的场景。
  4. ---
  5. # Feishu Portfolio Launch
  6. ## 这个 Skill 做什么
  7. 一句话:**给我飞书多维表格链接,我把作品集网站搭出来,并把“飞书临时链接会过期”这件事自动化处理掉。**
  8. 默认交付物:
  9. - `index.html` 或静态前端页面
  10. - `api/videos.json`
  11. - `api/covers.json`
  12. - `api/portfolio.json`
  13. - `refresh.py`
  14. - `.github/workflows/refresh.yml`
  15. - 带动效的前端交互层(CSS / JS / Canvas / Three.js 均可)
  16. 内置模板资源:
  17. - [`assets/refresh.py`](./assets/refresh.py)
  18. - [`assets/refresh.yml`](./assets/refresh.yml)
  19. - [`assets/portfolio.sample.json`](./assets/portfolio.sample.json)
  20. 目标结果:
  21. - 网站部署在 GitHub Pages
  22. - 飞书媒体链接由 GitHub Actions 每 12 小时自动刷新
  23. - 用户不用保持自己的电脑开机
  24. - 页面不是纯静态排版,至少具备一套完整的入场 / 滚动 / 悬停 / 切页动效
  25. ---
  26. ## 适用场景
  27. ✅ 适合:
  28. - AI 视频 / 图片作品集
  29. - 摄影、设计、创意样片库
  30. - 客户案例展示站
  31. - 任何「内容在飞书附件里,前台只负责展示」的场景
  32. ❌ 不适合:
  33. - 图文博客
  34. - 电商、支付、登录系统
  35. - 需要数据库写入和后端业务逻辑的网站
  36. ---
  37. ## 核心原则
  38. **不要把飞书临时 URL 当成永久资源。**
  39. 飞书附件的播放 / 下载地址会过期。正确做法不是让用户在本地电脑上定时跑脚本,而是:
  40. 1. 从飞书多维表格读取最新记录
  41. 2. 调飞书 API 把附件 `file_token` 解析成临时 URL
  42. 3. 生成 `api/*.json`
  43. 4. 提交回 GitHub 仓库
  44. 5. 让 GitHub Pages 自动重新部署
  45. 也就是:
  46. `Feishu Bitable -> refresh.py -> api/*.json -> GitHub Pages`
  47. ---
  48. ## 执行流程
  49. ### Step 0:环境检查
  50. 先检查本地是否具备初始化所需工具:
  51. ```bash
  52. for cmd in node python3 gh git; do
  53. which "$cmd" >/dev/null 2>&1 && echo "OK $cmd" || echo "MISS $cmd"
  54. done
  55. lark-cli --version >/dev/null 2>&1 && echo "OK lark-cli" || echo "MISS lark-cli"
  56. gh auth status >/dev/null 2>&1 && echo "OK GitHub auth" || echo "MISS GitHub auth"
  57. ```
  58. 如果缺少工具,再让用户安装。
  59. 如果 `gh` 没登录,先完成 GitHub 登录。
  60. ---
  61. ### Step 1:拿到飞书 Base 和正确的数据表
  62. 向用户要飞书多维表格链接,例如:
  63. `https://my.feishu.cn/base/AbCdEfGhIjk`
  64. 从 URL 里解析出 `app_token`。
  65. 然后列出所有表:
  66. ```bash
  67. lark-cli api GET "/open-apis/bitable/v1/apps/${APP_TOKEN}/tables"
  68. ```
  69. **不要默认选第一张表。**
  70. 很多 Base 里会同时存在“空模板表”和“真正有作品的素材表”。要继续读取记录并验证:
  71. - 哪张表有真实附件字段
  72. - 哪张表记录数正确
  73. - 哪张表里字段名是用户要展示的内容
  74. 优先找这些字段:
  75. - 视频字段:`样片` / `视频` / `附件`
  76. - 封面字段:`封面` / `封面图` / `海报` / `图片`
  77. - 标题字段:`内容` / `标题` / `作品名称`
  78. - 分类字段:`类型` / `分类`
  79. - 时长字段:`时长`
  80. - 工具字段:`AI工具` / `工具`
  81. - 排序字段:`序号`
  82. 如果一张表只有 `文本 / 单选 / 日期 / 附件` 这种空模板字段,继续换表,不要生成网站。
  83. ---
  84. ### Step 2:验证飞书权限
  85. 要让 GitHub Actions 能自动刷新,飞书应用必须至少能:
  86. - 读取多维表记录
  87. - 读取附件媒体链接
  88. 执行方案里要显式依赖这 4 个 secrets:
  89. - `LARK_APP_ID`
  90. - `LARK_APP_SECRET`
  91. - `LARK_BASE_TOKEN`
  92. - `LARK_TABLE_ID`
  93. 如果用户本机已经有可用的飞书应用配置,可以复用。否则要明确告诉用户去飞书开放平台补权限和密钥。
  94. ---
  95. ### Step 3:导出结构化作品数据
  96. 不要只提取 `file_token` 列表。
  97. 应构建一份前端可直接消费的结构化数据,至少包含:
  98. - title
  99. - categories
  100. - duration
  101. - tools
  102. - order
  103. - video_token
  104. - cover_token
  105. 推荐输出:
  106. - `api/portfolio.json`:完整作品数组
  107. - `api/videos.json`:`video_token -> tmp_download_url`
  108. - `api/covers.json`:`cover_token -> tmp_download_url`
  109. 结构样例可直接参考仓库内的 `assets/portfolio.sample.json`。
  110. 前端可以继续用静态 HTML + JS,也可以完全由 `portfolio.json` 渲染。
  111. ---
  112. ### Step 4:生成前端页面
  113. 默认生成静态页面,要求:
  114. - 响应式作品网格
  115. - 分类筛选
  116. - 点击卡片播放
  117. - 全屏放大播放
  118. - 只允许一个视频同时播放
  119. - 封面优先使用飞书封面字段,没有封面时允许退化为无 poster
  120. 动效要求默认一起交付,不要只做“能打开”的静态页:
  121. - 首屏至少有一组入场动画,例如标题、说明、统计数字逐段 fade-up
  122. - 导航在滚动后允许出现 blur / background / border 变化
  123. - 卡片 hover 至少有一层轻量反馈,例如上浮、缩放、遮罩、标题变色
  124. - 页面切换或 section 切换应有过渡,不要突兀闪切
  125. - About / 联系方式 / 能力模块这类信息区,优先加 scroll reveal
  126. - 如果用户希望更强视觉表现,可以增加 Canvas 或 Three.js 背景动画
  127. 实现边界:
  128. - 优先用原生 CSS transition / keyframes / IntersectionObserver
  129. - 需要持续运动背景时再用 `requestAnimationFrame`
  130. - 如果用了 Three.js,必须确保移动端不会空白、卡死或遮挡主要内容
  131. - 动画不能影响视频播放、筛选、弹窗、移动端滚动和首屏可读性
  132. - 默认提供降级路径,脚本失败时文字和内容仍然可见
  133. 数据绑定原则:
  134. - HTML 不要写死过期 URL
  135. - 页面运行时拉取 `/api/videos.json` 和 `/api/covers.json`
  136. - 或者直接拉 `/api/portfolio.json` 渲染卡片
  137. 如果用户已有站点,优先保留现有视觉样式,只替换数据来源和刷新机制。
  138. 如果用户明确提到参考现有站点风格,优先复用这些动画类型:
  139. - hero 文案入场
  140. - sticky filter / nav 的滚动状态过渡
  141. - masonry 卡片 hover 动效
  142. - 页面淡入淡出切换
  143. - About 页的 stagger reveal
  144. - 可选的 Three.js / Canvas 背景运动
  145. ---
  146. ### Step 5:创建仓库并部署 GitHub Pages
  147. 标准流程:
  148. ```bash
  149. gh repo create <repo-name> --public --source=. --remote=origin --push
  150. ```
  151. 然后确认 Pages 来源是:
  152. - branch: `main`
  153. - path: `/`
  154. 检查:
  155. ```bash
  156. gh api repos/<owner>/<repo>/pages
  157. ```
  158. 必须确认:
  159. - Pages 已启用
  160. - `cname` 正常(如果有自定义域名)
  161. - source 指向 `main` 和根目录
  162. ---
  163. ### Step 6:生成自动刷新脚本
  164. 刷新脚本应采用下面这条路线:
  165. 1. 用 `app_id + app_secret` 换 `tenant_access_token`
  166. 2. 读取 Bitable records
  167. 3. 从记录里提取视频和封面附件 token
  168. 4. 批量调用 `batch_get_tmp_download_url`
  169. 5. 写入 `api/videos.json`、`api/covers.json`、`api/portfolio.json`
  170. 关键要求:
  171. - 支持分页读取 records
  172. - 批量请求按 5 个 token 一组
  173. - 不要把 token 列表硬编码在脚本里
  174. - 优先从真实表记录动态生成
  175. - 允许多种字段名候选
  176. 推荐文件名:
  177. - `refresh.py`
  178. 优先直接复制 skill 自带模板:
  179. ```bash
  180. cp ~/.claude/skills/feishu-portfolio-launch/assets/refresh.py ./refresh.py
  181. ```
  182. 然后只修改字段候选数组,不要把具体 token 或具体 URL 硬编码进去。
  183. ---
  184. ### Step 7:生成 GitHub Actions Workflow
  185. 不要再使用本地 `launchd` 作为默认方案。
  186. 默认方案必须是 GitHub Actions。
  187. 工作流要求:
  188. - 支持 `workflow_dispatch`
  189. - 支持 `schedule`,默认每 12 小时执行一次
  190. - 执行 `python refresh.py`
  191. - 自动提交 `api/videos.json`、`api/covers.json`、`api/portfolio.json`
  192. 标准 secrets:
  193. - `LARK_APP_ID`
  194. - `LARK_APP_SECRET`
  195. - `LARK_BASE_TOKEN`
  196. - `LARK_TABLE_ID`
  197. 标准文件:
  198. - `.github/workflows/refresh.yml`
  199. 优先直接复制 skill 自带模板:
  200. ```bash
  201. mkdir -p .github/workflows
  202. cp ~/.claude/skills/feishu-portfolio-launch/assets/refresh.yml .github/workflows/refresh.yml
  203. ```
  204. ---
  205. ### Step 8:把 Secrets 配进仓库
  206. 如果当前环境已经有这些值,并且用户明确让你落地,就直接配置:
  207. ```bash
  208. gh secret set LARK_APP_ID -R <owner>/<repo>
  209. gh secret set LARK_APP_SECRET -R <owner>/<repo>
  210. gh secret set LARK_BASE_TOKEN -R <owner>/<repo>
  211. gh secret set LARK_TABLE_ID -R <owner>/<repo>
  212. ```
  213. 然后验证:
  214. ```bash
  215. gh secret list -R <owner>/<repo>
  216. ```
  217. 如果缺值,就停在这里,明确告诉用户缺哪个,不要伪造。
  218. ---
  219. ### Step 9:手动触发并验证整条链路
  220. 完成配置后,立刻手动跑一次 workflow:
  221. ```bash
  222. gh workflow run refresh.yml -R <owner>/<repo>
  223. gh run list -R <owner>/<repo> --limit 3
  224. gh run watch <run-id> -R <owner>/<repo> --exit-status
  225. ```
  226. 再检查线上结果:
  227. ```bash
  228. python3 - <<'PY'
  229. import json, urllib.request, time
  230. url = f'https://<domain-or-pages-url>/api/videos.json?t={int(time.time())}'
  231. with urllib.request.urlopen(url, timeout=20) as r:
  232. data = json.load(r)
  233. print(data.get('_refreshed_at'))
  234. print(data.get('_count'))
  235. PY
  236. ```
  237. 然后抽测 1 条视频:
  238. - 状态码应为 `206` 或 `200`
  239. - `content-type` 应为 `video/mp4` 或可播放媒体类型
  240. 如果线上 `api/videos.json` 还是旧时间:
  241. - 先看 Pages 部署是否完成
  242. - 再看 workflow 是否真的提交了新 JSON
  243. - 再确认 Pages source 是否指向正确分支和目录
  244. ---
  245. ### Step 10:域名绑定
  246. 如果用户要自定义域名,再做:
  247. - `CNAME` 文件
  248. - GitHub Pages custom domain 设置
  249. - DNS 配置引导
  250. 这部分沿用 GitHub Pages 标准流程,不需要和飞书逻辑耦合。
  251. ---
  252. ## 对用户的默认解释
  253. 遇到“网站能打开但视频播不了”,优先判断:
  254. 1. `api/videos.json` 是否还是旧的
  255. 2. 里面的飞书 URL 是否已过期
  256. 3. 自动刷新 workflow 是否失败
  257. 4. Pages 是否还没重新部署
  258. 默认不要先怀疑播放器,也不要先怀疑前端样式。
  259. 如果用户说“页面太死”或者“想要像作品集一样更有呼吸感”,默认增加动画层,而不是只改颜色和排版。
  260. ---
  261. ## 成功标准
  262. 这个 Skill 完成后,至少要满足:
  263. - 网站已上线
  264. - GitHub Pages 可访问
  265. - 视频可播放
  266. - 仓库里有自动刷新 workflow
  267. - 仓库里已有 4 个 `LARK_*` secrets
  268. - 手动触发 workflow 成功
  269. - 线上 `api/videos.json` 的 `_refreshed_at` 是新时间
  270. ---
  271. ## 不要再默认做的事
  272. - 不要默认生成本地 `launchd`
  273. - 不要默认依赖用户 Mac 长期开机
  274. - 不要硬编码所有 `file_token`
  275. - 不要只凭第一张表就继续
  276. - 不要只生成 `videos.json`,忽略封面和结构化记录
  277. ---
  278. ## 参考实现
  279. 如果需要一个已经验证过的做法,先直接复用 skill 仓库自带模板:
  280. - `assets/refresh.py`
  281. - `assets/refresh.yml`
  282. - `assets/portfolio.sample.json`
  283. 实际项目里最终会生成这些文件:
  284. - `refresh.py`
  285. - `.github/workflows/refresh.yml`
  286. - `api/videos.json`
  287. - `api/covers.json`
  288. - `api/portfolio.json`
  289. 优先复用现成仓库模式,再按用户站点样式做适配。
README.md · README · 148 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # feishu-portfolio-launch
  2. **Claude Code Skill** — 给我飞书多维表格链接,我带你把作品集网站全流程上线。
  3. 适合把视频/图片作品存在飞书、想对外展示的创作者(AI视频、摄影、设计、样片库等)。
  4. ---
  5. ## 能做什么
  6. 给我一个飞书多维表格链接,我自动完成:
  7. 1. **导出飞书数据** — 提取所有附件的 file_token 和字段内容
  8. 2. **生成 HTML 网页** — 瀑布流展示,分类筛选,点击播放,并带完整动画层
  9. 3. **上线 GitHub Pages** — 免费托管,几分钟可访问
  10. 4. **绑定自定义域名**(可选)— DNS 引导 + 自动配置 CNAME
  11. 5. **设置自动刷新** — 飞书链接 24 小时过期,由 GitHub Actions 每 12 小时自动换新链接
  12. **你只需要:** 提供表格链接 → 选风格 → 确认预览 → 在 DNS 控制台加几条记录
  13. ---
  14. ## 适用场景
  15. ✅ 视频 / 图片附件存在飞书多维表格
  16. ✅ 想搭一个对外展示的作品集网站
  17. ✅ 不想写代码,全程让 AI 做
  18. ❌ 博客、电商、需要用户注册登录的场景不适合
  19. ---
  20. ## 安装使用
  21. **方式一:直接复制 SKILL.md**
  22. 把 `SKILL.md` 放到你的 Claude Code skills 目录:
  23. ```bash
  24. mkdir -p ~/.claude/skills/feishu-portfolio-launch
  25. curl -o ~/.claude/skills/feishu-portfolio-launch/SKILL.md \
  26. https://raw.githubusercontent.com/Jane-xiaoer/feishu-portfolio-launch/main/SKILL.md
  27. ```
  28. **方式二:clone 整个仓库**
  29. ```bash
  30. git clone https://github.com/Jane-xiaoer/feishu-portfolio-launch.git \
  31. ~/.claude/skills/feishu-portfolio-launch
  32. ```
  33. 安装后,在 Claude Code 里说:
  34. > 「飞书作品集上线」或「帮我用飞书多维表格搭作品集网站」
  35. Claude Code 会自动调用这个 Skill。
  36. ---
  37. ## 前置条件
  38. 开始前需要装好这几个工具(缺什么 Skill 会告诉你怎么补):
  39. | 工具 | 用途 |
  40. |---|---|
  41. | lark-cli | 访问飞书 API |
  42. | Node.js ≥ 18 | lark-cli 运行环境 |
  43. | Python 3 | 自动刷新脚本 |
  44. | gh (GitHub CLI) | 创建仓库 + 推代码 |
  45. | git | 版本控制 |
  46. 需要的账号:飞书、GitHub、域名注册商(可选)
  47. ---
  48. ## 现在的默认路线
  49. 这个 Skill 现在默认采用:
  50. `Feishu Bitable -> refresh.py -> api/*.json -> GitHub Actions -> GitHub Pages`
  51. 不再默认依赖本地 `launchd` 或者用户自己的电脑长期开机。
  52. 仓库里会生成:
  53. - `refresh.py`
  54. - `.github/workflows/refresh.yml`
  55. - `api/videos.json`
  56. - `api/covers.json`
  57. - `api/portfolio.json`
  58. 并要求配置这 4 个 GitHub Secrets:
  59. - `LARK_APP_ID`
  60. - `LARK_APP_SECRET`
  61. - `LARK_BASE_TOKEN`
  62. - `LARK_TABLE_ID`
  63. Skill 仓库里已经附带可复制模板:
  64. - `assets/refresh.py`
  65. - `assets/refresh.yml`
  66. - `assets/portfolio.sample.json`
  67. 前端默认不是纯静态页。这个 Skill 现在会把下面这些动画能力一起作为标准交付:
  68. - hero 首屏入场动画
  69. - sticky 导航 / 筛选条滚动过渡
  70. - 卡片 hover 动效
  71. - 页面或 section reveal 动画
  72. - 需要时接入 Canvas / Three.js 背景动效
  73. - 保留无动画降级,保证内容可读和移动端可用
  74. ---
  75. ## 实际效果
  76. 用这套方法搭出来的网站示例:**[xiaoerai.xyz](https://xiaoerai.xyz)**
  77. - 46 个 AI 视频作品
  78. - 瀑布流布局,分类筛选
  79. - 首屏、卡片、About 页和背景层都有动画
  80. - 飞书链接由 GitHub Actions 自动刷新
  81. ---
  82. ## License
  83. MIT
  84. ---
  85. ## 📱 关注作者 / Follow Me
  86. 如果这个仓库对你有帮助,欢迎关注我。后面我会持续更新更多 AI Skill、做网站、自动化工作流和创意项目。
  87. If this repo helped you, follow me for more AI skills, website building, automation workflows, and creative projects.
  88. - X (Twitter): [@xiaoerzhan](https://x.com/xiaoerzhan)
  89. - 微信公众号 / WeChat Official Account: 扫码关注 / Scan to follow
  90. <p align="center">
  91. <img src="./follow-wechat-qrcode.jpg" alt="Jane WeChat Official Account QR code" width="300" />
  92. </p>
  93. <p align="center"><strong>中文:</strong>欢迎关注我的公众号,一起研究 AI Skill、网站搭建、自动化流程和创意实验。</p>
  94. <p align="center"><strong>English:</strong> Follow my WeChat Official Account for more AI skills, website building, automation workflows, and creative experiments.</p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.