wechat-media-writer 2.2.12 → 2.2.14

package/SKILL.md

@@ -64,17 +64,28 @@ Token 缓存在 `~/.wechat/token_cache.json`（自动管理，2小时有效期
 
 ## 7段式书评结构
 
-每篇读书拆解文章固定7个章节，**不使用数字编号**，直接以章节标题呈现：
-
-| 序号 | 标题                 | 内容要点                                    |
-| ---- | -------------------- | ------------------------------------------- |
-| 1    | 先搞懂写书的这个人   | 作者生平、学术/职业背景、成书时代、写作动机 |
-| 2    | 全书脉络 | 逐章概括核心逻辑线，用框图提炼主线          |
-| 3    | 三个颠覆认知的真相  | 选3个最有穿透力的论点，附书中案例           |
-| 4    | 这本书的短板，不吐不快       | 根据书籍实际情况灵活呈现：有短板则评短板，无明显漏洞则评适用边界或争议点，不强制批判             |
-| 5    | 读完真正留下的东西           | 读完能带走的三样东西，个人成长视角          |
-| 6    | 四条拿来就用的行动项     | 3-4条可操作建议，具体到执行步骤             |
-| 7    | 值不值得花时间读   | ★评分 + 适合/不适合人群清单                 |
+每篇读书拆解文章固定7个章节，**不使用数字编号**，直接以**口语化章节标题**呈现。
+
+**章节标题必须严格使用以下 7 个口语化标题**（不要替换为其他书面化或近义表达）：
+
+| 顺序 | 章节标题（**口语化，必须使用**）         | 内容要点                                      |
+| ---- | ------------------------------------------ | --------------------------------------------- |
+| 1    | 先搞懂写书的这个人                         | 作者生平、学术/职业背景、成书时代、写作动机   |
+| 2    | 全书脉络                                   | 逐章概括核心逻辑线，用框图提炼主线            |
+| 3    | 三个颠覆认知的真相                         | 选 3 个最有穿透力的论点，附书中案例           |
+| 4    | 这本书的短板，不吐不快                     | 根据书籍实际情况灵活呈现短板/适用边界/争议点 |
+| 5    | 读完真正留下的东西                         | 读完能带走的三样东西，个人成长视角            |
+| 6    | 四条拿来就用的行动项                       | 3-4 条可操作建议，具体到执行步骤               |
+| 7    | 值不值得花时间读                           | ★评分 + 适合/不适合人群清单                   |
+
+> ⚠️ **禁止使用以下书面化版本**（AI 之前常误用）：
+> - ❌ 作者背景与创作时代
+> - ❌ 全书完整逻辑思维导图
+> - ❌ 三大颠覆性核心论点
+> - ❌ 批判性客观评析
+> - ❌ 收获与成长
+> - ❌ 现实落地应用方案
+> - ❌ 星级评分与适配人群
 
 
 ## 主题色规范
@@ -219,11 +230,22 @@ urls = download_theme_images("books", "/tmp/images", count=6)
 3. **分辨率**：宽高乘积
 4. **色彩多样性**：RGB 通道差值（避免纯灰/单色图）
 
-下载 6 张主题图后会自动按美学评分降序重命名为 `img_1.jpg` ~ `img_6.jpg`，
+### 内容图比例要求
+
+公众号正文配图应使用**横向图**（宽 > 高），与微信文章阅读体验最佳：
+
+| 优先级 | 比例 | 备注 |
+| --- | --- | --- |
+| ⭐⭐⭐ 优先 | 4:3 (1.33) | 视觉最舒适，公众号默认容器适配 |
+| ⭐⭐ 次选 | 3:2 (1.50) | 经典相机比例，普适性强 |
+| ⭐ 备选 | 16:9 (1.78) | 偏宽，电影感 |
+| ❌ 避免 | 竖向 (h > w) | 微信展示高度 > 600px 显突兀 |
+
+下载时会自动跳过竖向图和比例异常的候选。下载 6 张主题图后会自动按美学评分降序重命名为 `img_1.jpg` ~ `img_6.jpg`，
 其中 `img_1.jpg` 就是评分最高的，被 `pick_best_cover()` 选中裁剪为 900x500 封面。
 
 **支持的主题**：`abstract` / `books` / `nature` / `technology` / `business`
-每个主题预存 8 张精选 Pexels 候选（见 `THEME_CANDIDATES`），实地测试可用率 100%。
+每个主题预存 8 张精选 Pexels 候选（见 `THEME_CANDIDATES`），按 4:3 > 3:2 > 16:9 优先级排序。
 
 ### 第三步：上传图片到微信
 
@@ -333,16 +355,16 @@ python3 scripts/publish.py --title "标题" --content-file content.html --cover-
 
 ### 字数参考
 
-| 章节       | 字数          |
-| ---------- | ------------- |
-| 作者背景   | 400-600       |
-| 逻辑导图   | 600-800       |
-| 三大论点   | 1200-1800     |
-| 批判评析   | 600-800       |
-| 收获与成长 | 600-800       |
-| 落地方案   | 600-800       |
-| 星级评分   | 400-500       |
-| **总计**   | **4000-6000** |
+| 章节                   | 字数          |
+| ---------------------- | ------------- |
+| 先搞懂写书的这个人     | 400-600       |
+| 全书脉络               | 600-800       |
+| 三个颠覆认知的真相     | 1200-1800     |
+| 这本书的短板，不吐不快 | 600-800       |
+| 读完真正留下的东西     | 600-800       |
+| 四条拿来就用的行动项   | 600-800       |
+| 值不值得花时间读       | 400-500       |
+| **总计**               | **4000-6000** |
 
 ## 值不值得花时间读排版规范
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wechat-media-writer",
-  "version": "2.2.12",
+  "version": "2.2.14",
   "description": "微信公众号书评、影评文章自动生成与发布 - Skill",
   "main": "index.js",
   "bin": {

package/scripts/image_downloader.py

@@ -2,8 +2,8 @@
 """
 图片下载模块
 - 每个主题预存 8-10 张精选 Pexels 候选 ID（已实地测试可用）
-- 下载时跳过 404 候选
-- 提供 aestheTics_score() 函数评估图片"精美度"，便于封面自动挑选
+- 下载时跳过 404 候选，并校验宽高比（优先 4:3 / 3:2 横向图）
+- 提供 aesthetics_score() 函数评估图片"精美度"，便于封面自动挑选
 """
 
 import os
@@ -14,20 +14,23 @@ from PIL import Image, ImageStat
 
 
 # 精选 Pexels 候选 ID（每个主题 8-10 张，实地下载验证）
-# 选择标准：构图饱满、色彩丰富、主题鲜明、与书评/影评审美契合
+# 选择标准：
+#   1) 比例优先 4:3 (1.33) 其次 3:2 (1.5) 横向构图（宽 > 高）
+#   2) 主题契合（书评/影评主题）
+#   3) 构图饱满、色彩丰富、画面精美
 THEME_CANDIDATES = {
     "books": [
-        # Pexels 搜索"book"结果中精选的高质量图
-        415078,  # 草地上开本书（封面候选极佳）
-        433333,  # 书堆黑白（封面候选极佳，构图饱满）
-        4861364,  # 两人读书
-        5913138,  # 书+花+咖啡
-        6001171,  # 床上读书
-        7034613,  # 书架书+植物
-        1792734,  # 阳光读书
-        11197155,  # 古书桌上
-        13580974,  # 翻开的书页
-        904616,  # 咖啡+书+花俯拍
+        # 横向 3:2 主力 - 已实地下载验证为"读书/书"主题
+        415078,  # 3:2 - 草地上开本书（封面候选极佳）
+        904616,  # 3:2 - 咖啡+书+花俯拍
+        1319854,  # 3:2 - 图书馆书墙（精装）
+        4974915,  # 3:2 - 翻书动作
+        2228547,  # 3:2 - 翻书
+        1370295,  # 3:2 - 开本书
+        2099683,  # 16:9 - 翻书动作
+        # 已剔除：以下 ID 在 Pexels 搜索结果中出现但主题不契合（风景、人物特写、粉背景等）
+        # 4239031 (电脑前背影)、36729918 (粉背景酒杯)、2820896 (街舞)、
+        # 1444442 (手部彩绘)、261949 (报纸)、1438072 (笔记本咖啡不够书主题)
     ],
     "abstract": [
         1108572,  # 抽象光影
@@ -164,6 +167,30 @@ def aesthetics_score(image_path):
     return round(total, 2)
 
 
+def is_valid_landscape(image_path, min_ratio=1.2, max_ratio=2.0):
+    """校验图片是横向图且比例在合理范围
+
+    横向比例：1.2 ~ 2.0
+    排除：竖向图、纯单色图（细节过低）
+    """
+    try:
+        img = Image.open(image_path)
+        w, h = img.size
+        if w < h:
+            return False
+        ratio = w / h
+        if not (min_ratio <= ratio <= max_ratio):
+            return False
+        # 校验不是纯色图（stddev 极低 = 纯色/几乎无细节）
+        stat = ImageStat.Stat(img.convert("RGB"))
+        avg_stddev = sum(stat.stddev) / 3
+        if avg_stddev < 15:  # 几乎纯色，丢弃
+            return False
+        return True
+    except Exception:
+        return False
+
+
 def download_theme_images(theme, output_dir, count=6):
     """根据主题下载多张精美图片
 
@@ -176,13 +203,24 @@ def download_theme_images(theme, output_dir, count=6):
     downloaded = []  # 临时文件列表
     failed_pids = []
 
-    # 1) 全部下载到临时文件
+    # 1) 全部下载到临时文件（仅保留横向图：1.2 ≤ ratio ≤ 2.0）
     for i, pid in enumerate(candidates):
         if len(downloaded) >= count:
             break
         tmp_path = os.path.join(output_dir, f"_tmp_{theme}_{i}_{pid}.jpg")
         if download_pexels_image(pid, tmp_path):
-            downloaded.append(tmp_path)
+            if is_valid_landscape(tmp_path):
+                downloaded.append(tmp_path)
+            else:
+                # 不是横向图或纯色图，丢弃
+                try:
+                    img = Image.open(tmp_path)
+                    w, h = img.size
+                    ratio = w / h if h > 0 else 0
+                    print(f"  跳过 {pid}（{w}x{h}，比例 {ratio:.2f} 不符合横向规范）")
+                except Exception:
+                    print(f"  跳过 {pid}（无法校验）")
+                os.remove(tmp_path)
         else:
             failed_pids.append(pid)