agentleFS
ykjshenzhen2008-ship-itykjshenzhen2008-ship-it/commercial-real-estate-skills/skills/laoyang-article-images/SKILL.md

laoyang-article-images

Skill0 starsChanged 35 days agoMITView on GitHub

老杨拆商业(及通用内容类)文章配图规范与抓取流程。每篇 3-4 张、一律横版、表格转自制图片。触发词:文章配图、配图、生成配图、下载配图、表格转图、配图规格、封面图、横版图。

The file

Files
SKILL.md

laoyang-article-images · 文章配图规范与抓取

固化 2026-08-29 用户确认的配图设定。所有内容类配图(公众号/知乎/小红书改稿/报告)默认按此执行。

一、硬约束(违反即返工)

项规则
数量每篇 3-4 张,宁精勿多。超出就砍
版式一律横版。禁止竖图、方图
封面1 张,2.35:1,1410×600
内容图1-2 张,16:9,1200×675
表格图0-1 张,2:1,2000×1000(自制)
表格正文不放 Markdown/HTML 表格,渲染成图片后用 ![表格](path) 占位顶替
存放~/Downloads/老杨配图/文章NN/;不用的图移入 _备用/

配比模板(默认):封面 1 + 内容图 2 + 表格图 1 = 4 张。文章无表格时:封面 1 + 内容图 23 = 34 张。

二、执行流程

Step 1 · 规划配图位

先通读成稿,标出 3-4 个配图点:

  • 封面:主题意象图(不是抽象概念图)
  • 内容图:放在「案例段落」或「转折段落」后,不要每小节一张
  • 表格图:放在测算/对照数据段落末尾

Step 2 · 抓真实照片(Pexels)

curl 直连 Pexels 会被拦(返回空)。正确姿势:

  1. WebFetch 抓 https://www.pexels.com/search/<关键词>/,提取 photo ID
  2. 拼接下载:
    https://images.pexels.com/photos/{ID}/pexels-photo-{ID}.jpeg?auto=compress&cs=tinysrgb&w={W}&h={H}&fit=crop
    • 封面 w=1410&h=600,内容图 w=1200&h=675
  3. 命名(统一 4 张,排序干净):
    • 01_封面_中文描述.jpg
    • 02_中文描述.jpg(内容图 1)
    • 03_中文描述.jpg(内容图 2)
    • 04_表格_中文描述.png(表格图,自制)

落地命令:

curl -sL -o ~/Downloads/老杨配图/文章NN/00_封面_描述.jpg \
"https://images.pexels.com/photos/{ID}/pexels-photo-{ID}.jpeg?auto=compress&cs=tinysrgb&w=1410&h=600&fit=crop"

校验:下载后必查文件大小(<30KB 多半是失败图,换 ID)和尺寸比例。

Step 3 · 表格转图

用本 skill 的 scripts/table_to_image.py:

PY=$HOME/.workbuddy/binaries/python/envs/default/bin/python
cd <文章目录>
$PY scripts/table_to_image.py 文章NN_标题.md --title "表标题" --idx 1 --out "02_表格_xxx.png"
  • --idx:md 中第 N 个表格(从 1 计)
  • 无表格但要出对照表:先写临时 md,文件名必须含 文章NN(否则输出到 老杨配图/文章/,需手动 mv)
  • 输出 2000×1000 PNG,打印可粘回 md 的占位行

视觉规范(已在脚本内固化,不要改):

  • 文字暗炭 #2B2B2B,主色老杨红 #C0392B
  • 表头红底白字;斑马纹 #FFFFFF / #FBF3EF;末列红字加粗
  • 字体 PingFang HK,200dpi

Step 4 · 回写 MD

  1. 表格图占位行插在原表格位置(替换整段表格文字)
  2. 「## 图片说明」章节按实际文件重写:
    - **封面**:`00_封面_xxx.jpg`,真实摄影,中文描述,2.35:1
    - **配图1**:`01_xxx.jpg`,真实摄影,中文描述,16:9
    - **表格图**:`02_表格_xxx.png`,自制,简要说明,2:1
  3. 来源脚注统一:
    > 图片来源:照片为 Pexels CC0 可商用图库(免署名);表格图为自制图表(暗炭 #2B2B2B + 老杨红 #C0392B,2:1 横版)。

Step 5 · 生成 docx 并核对

$PY md2docx_v2.py 文章NN_标题.md

必须核对:docx 内【配图标注】数量 = 图片说明条目数(缺一个就是占位行或说明写错)。

三、常见坑

  • Pexels curl 直连搜索页返回 403(不是空)→ 只能走 WebFetch 取 ID 二段式;但 images.pexels.com 的图片直链可以 curl,别把两者混为一谈
  • 个别 photo ID 已失效:下载下来只有 27 字节。必须 stat -f%z 校验,低于 50KB 就换 ID 重试(循环试 3-4 个 ID 直到过线)
  • 关键词质量差异极大:old factory 出来的是废弃黑白厂房(萧瑟、不适合商业稿),brick warehouse 才是明亮红砖改造感;抓之前先想清楚要的情绪,抓下来最好 Read 看一眼封面
  • ⭐部分关键词 WebFetch 拿不到 ID(2026-10-03 实测):rooftop view old town / chinese architecture / tourists taking photos / night market 返回结构里完全没有 images.pexels.com/photos/<ID>,只有 Canva 广告位 → 换词即可,别死磕。已验证稳定出 ID 的词:pedestrian street、empty storefront、rooftop terrace
  • ⭐Pexels 内部 API 不可用:https://www.pexels.com/api/v3/search/photos?query=... 无 key 一律返回 {"error_messages":["Bad API credentials."]};curl 直连搜索页只返 ~5.8KB 空壳。唯一有效通道=WebFetch 搜索页 → 提取 ID → curl 下图片直链(图片直链 curl 是通的)
  • ⭐不要用 ImageFont.truetype("/System/Library/Fonts/PingFang.ttc") 自制表格图:本机该路径已不存在(macOS 升级后移除),会报 OSError: cannot open resource。直接用项目内 table_to_image.py(matplotlib + font_manager 按 family 名 'PingFang HK' 解析,可用,仅打印 Failed to find font weight bold 的 warning,不影响出图)。本机实测存在的中文字体:/System/Library/Fonts/Hiragino Sans GB.ttc、/System/Library/Fonts/STHeiti Medium.ttc、/System/Library/Fonts/Supplemental/Songti.ttc
  • 临时 md 文件名不含 文章NN → 表格图输出到错误目录
  • 图片说明条目与正文占位行文件名不一致 → docx 里该图不生成占位
  • 生成后只核对了「有没有图」,没核对「几张图」→ 超出 4 张
  • 表格图中文列宽截断(v1.1 已修):旧版按 len(str) 算列宽,中文表头会被截(「家庭决策权重」→「家庭决策权電」)。现用 _dw() 显示宽度(ord(ch)>127 计 2)+ 字号自适应。跑之前务必确认用的是 v1.1 的脚本
  • table_to_image.py 必须传 --title,不传标题就恒为默认「测算表」

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.