wechat-media-writer 2.2.11 → 2.2.13

package/SKILL.md

@@ -145,7 +145,7 @@ Token 缓存在 `~/.wechat/token_cache.json`（自动管理，2小时有效期
 
     <!-- 章节（无数字编号，直接标题） -->
     <p style="font-size:18px;font-weight:bold;color:{T};text-align:center;margin:0 0 16px;line-height:1em;">
-        <span>作者背景与创作时代</span>
+        <span>先搞懂写书的这个人</span>
     </p>
     <p style="font-size:16px;line-height:2;color:{BODY};margin:0 0 16px;text-indent:2em;">
         <span>正文段落。所有段落必须有 text-indent:2em。</span>
@@ -185,7 +185,7 @@ Token 缓存在 `~/.wechat/token_cache.json`（自动管理，2小时有效期
 3. **`<img>` 必须包裹在 `<p>` 中**，且 `style="width:100%;display:block;border-radius:4px;"`
 4. **行高统一 `line-height:2`** — 阅读舒适
 5. **引用块用 `<p>` + `background` + `border-radius:8px`** — 圆角浅背景卡片样式，不要左侧竖条
-6. **章节标题不使用数字编号** — 直接用"作者背景与创作时代"，不用"壹"
+6. **章节标题不使用数字编号** — 直接用"先搞懂写书的这个人"，不用"壹"
 7. **强调文字用 `<strong style="color:{T};">`** — 不是加粗或改色
 8. **重点语句/概念高亮**：用 `<strong style="color:{T};background:{CBG};padding:1px 6px;border-radius:3px;">` 或 `<span style="color:{T2};font-weight:bold;">` — 让主题色贯穿全文
 9. **星标用 `<span>★★★★☆</span>`** — `font-size:28px;color:{T2}`
@@ -219,11 +219,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 优先级排序。
 
 ### 第三步：上传图片到微信
 
@@ -344,7 +355,7 @@ python3 scripts/publish.py --title "标题" --content-file content.html --cover-
 | 星级评分   | 400-500       |
 | **总计**   | **4000-6000** |
 
-## 星级评分与适配人群排版规范
+## 值不值得花时间读排版规范
 
 星级评分部分必须按照以下格式排版，**不使用壹贰叁编号**：
 
@@ -352,15 +363,16 @@ python3 scripts/publish.py --title "标题" --content-file content.html --cover-
 <p style="font-size:14px;color:#ccc;text-align:center;letter-spacing:8px;margin:20px 0;">· · · · · ·</p>
 
 <p style="font-size:18px;font-weight:bold;color:{T};text-align:center;margin:0 0 16px;line-height:1em;">
-    <span>星级评分与适配人群</span>
+    <span>值不值得花时间读</span>
 </p>
 
+<!-- 星级评分（支持 0.1 精度：用透明度表达小数部分，0.3 倍 = 0.7 星） -->
 <p style="font-size:28px;text-align:center;margin:0 0 8px;">
-    <span style="color:{T2};">★★★★☆</span>
+    <span style="color:{T2};">★</span><span style="color:{T2};">★</span><span style="color:{T2};">★</span><span style="color:{T2};">★</span><span style="color:{T2};opacity:0.3;">★</span>
 </p>
 
 <p style="font-size:16px;color:{BODY};text-align:center;margin:0 0 16px;">
-    <span>4 / 5 星</span>
+    <span>4.7 / 5 星</span>
 </p>
 
 <p style="font-size:16px;line-height:2;color:{BODY};margin:0 0 16px;text-indent:2em;">
@@ -394,10 +406,13 @@ python3 scripts/publish.py --title "标题" --content-file content.html --cover-
 <p style="font-size:14px;color:{BODY};text-align:center;margin:0 0 4px;line-height:1.6;">
     <span>作者 · 读书笔记</span>
 </p>
-<p style="font-size:14px;color:{T2};text-align:center;margin:0 0 4px;line-height:1.8;font-weight:bold;">
+<p style="font-size:14px;color:{T2};text-align:center;margin:0 0 24px;line-height:1.8;font-weight:bold;">
     <span>「 一句话总结：核心洞察 」</span>
 </p>
- <p style="text-align:center;margin:24px 0 0;color:#ccc;">· END ·</p>
+<p style="font-size:13px;color:#999;text-align:center;margin:16px 0 24px;letter-spacing:6px;font-weight:bold;">
+    <span>— · END · —</span>
+</p>
+<p style="margin:0;height:1px;line-height:1px;">&nbsp;</p>
 ```
 
 ### 评分格式要求

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wechat-media-writer",
-  "version": "2.2.11",
+  "version": "2.2.13",
   "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)