wechat-media-writer 2.2.5 → 2.2.7

package/SKILL.md

@@ -2,8 +2,9 @@
 name: wechat-media-writer
 version: 2.2.0
 description: |
-    微信公众号书评、影评文章自动生成与发布。7段式独立评论者视角，含作者背景、
-    逻辑导图、核心论点、批判评析、收获与成长、落地方案、星级评分。
+    微信公众号书评、影评文章自动生成与发布。7段式口语化独立评论者视角：
+    先搞懂写书的这个人、全书脉络、三个颠覆认知的真相、这本书的短板不吐不快、
+    读完真正留下的东西、四条拿来就用的行动项、值不值得花时间读。
     自动下载主题插图、上传微信、生成HTML排版、发布到草稿箱。
     v2.2.0: 重构结构，代码提取到独立模块，SKILL.md仅保留规范说明。
 triggers:
@@ -208,21 +209,21 @@ from image_downloader import download_theme_images
 urls = download_theme_images("books", "/tmp/images", count=6)
 ```
 
-### 第二步：下载公众号封面图（精确 900x500）
+### 第二步：从主题图中自动挑选最精美图作封面
 
-**公众号封面必须是 900x500 精确尺寸的精美图片**，与正文主题风格统一。
-不再从主题贴图裁剪（裁剪可能损失画面关键内容）——直接从 Pexels CDN 请求 900x500 精确裁切。
+**公众号封面从已下载的 6 张主题图中自动挑选美学评分最高的，再裁剪为 900x500。**
 
-每个主题预存 3 张高质量 Pexels 候选图（见 `scripts/book_cover.py` 的 `THEME_COVER_CANDIDATES`），
-通过 `?w=900&h=500&fit=crop` 参数让 Pexels 服务端精确裁切为 900x500：
+`scripts/image_downloader.py` 的 `aesthetics_score()` 函数基于以下维度给图片打分（0-100）：
+1. **对比度/细节丰富度**：RGB 通道 stddev 之和（反映画面层次）
+2. **亮度适中度**：中等亮度（80-180）最佳，避免过暗/过曝
+3. **分辨率**：宽高乘积
+4. **色彩多样性**：RGB 通道差值（避免纯灰/单色图）
 
-```python
-from book_cover import download_cover_900x500
-# 下载一张 books 主题的 900x500 封面（seed=0/1/2 轮换候选图）
-download_cover_900x500("books", "/tmp/wx", seed=0)
-```
+下载 6 张主题图后会自动按美学评分降序重命名为 `img_1.jpg` ~ `img_6.jpg`，
+其中 `img_1.jpg` 就是评分最高的，被 `pick_best_cover()` 选中裁剪为 900x500 封面。
 
 **支持的主题**：`abstract` / `books` / `nature` / `technology` / `business`
+每个主题预存 8 张精选 Pexels 候选（见 `THEME_CANDIDATES`），实地测试可用率 100%。
 
 ### 第三步：上传图片到微信
 

package/package.json

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

package/references/publish_template.py

@@ -64,15 +64,15 @@ HTML = f"""<section style="margin:0;padding:0;font-family:-apple-system,BlinkMac
     <img src="{THEME_IMG_1}" style="width:100%;max-width:600px;display:block;margin:0 auto;border-radius:4px;" alt="主题配图"/>
   </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>
   <p style="font-size:16px;line-height:2;color:{BODY};margin:0 0 16px;text-indent:2em;">
     <span>正文段落。所有段落必须有 text-indent:2em。重点句用 <strong style="color:{T};background:{CBG};padding:1px 6px;border-radius:3px;">主题主色高亮</strong>，核心概念用 <span style="color:{T2};font-weight:bold;">强调色加粗</span>。</span>
   </p>
 
-  <!-- 主题配图2（作者背景后） -->
+  <!-- 主题配图2（先搞懂写书的这个人后） -->
   <p style="margin:0 0 20px;text-align:center;">
     <img src="{THEME_IMG_2}" style="width:100%;max-width:600px;display:block;margin:0 auto;border-radius:4px;" alt="主题配图"/>
   </p>
@@ -82,9 +82,9 @@ HTML = f"""<section style="margin:0;padding:0;font-family:-apple-system,BlinkMac
     <span style="color:{T2};">▍</span> 金句或核心观点。整段用主题主色加粗，加左侧强调色条与正文形成视觉对比。
   </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>
   <p style="font-size:16px;line-height:2;color:{BODY};margin:0 0 16px;text-indent:2em;">
     <span>本章按章节脉络梳理<strong style="color:{T};background:{CBG};padding:1px 6px;border-radius:3px;">全书核心逻辑</strong>，用文字框图提炼主线。</span>
@@ -95,9 +95,9 @@ HTML = f"""<section style="margin:0;padding:0;font-family:-apple-system,BlinkMac
     <img src="{THEME_IMG_3}" style="width:100%;max-width:600px;display:block;margin:0 auto;border-radius:4px;" alt="主题配图"/>
   </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>
   <p style="font-size:16px;line-height:2;color:{BODY};margin:0 0 16px;text-indent:2em;">
     <span><span style="color:{T2};font-weight:bold;">论点一：</span><strong style="color:{T};background:{CBG};padding:1px 6px;border-radius:3px;">核心颠覆性观点</strong>，附书中具体案例支撑。</span>
@@ -114,9 +114,9 @@ HTML = f"""<section style="margin:0;padding:0;font-family:-apple-system,BlinkMac
     <img src="{THEME_IMG_4}" style="width:100%;max-width:600px;display:block;margin:0 auto;border-radius:4px;" alt="主题配图"/>
   </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>
   <p style="font-size:16px;line-height:2;color:{BODY};margin:0 0 16px;text-indent:2em;">
     <span>短板一：客观指出书中局限。<br/>短板二：逻辑漏洞分析。<br/>短板三：适用边界。<br/>短板四：时代局限。</span>
@@ -127,22 +127,22 @@ HTML = f"""<section style="margin:0;padding:0;font-family:-apple-system,BlinkMac
     <span style="color:{T2};">▍</span> 第二个金句或关键启发。
   </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>
   <p style="font-size:16px;line-height:2;color:{BODY};margin:0 0 16px;text-indent:2em;">
     <span>读完能带走的<strong style="color:{T};background:{CBG};padding:1px 6px;border-radius:3px;">三样东西</strong>，从个人成长视角展开。</span>
   </p>
 
-  <!-- 主题配图5（收获与成长后） -->
+  <!-- 主题配图5（读完真正留下的东西后） -->
   <p style="margin:0 0 20px;text-align:center;">
     <img src="{THEME_IMG_5}" style="width:100%;max-width:600px;display:block;margin:0 auto;border-radius:4px;" alt="主题配图"/>
   </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>
   <p style="font-size:16px;line-height:2;color:{BODY};margin:0 0 16px;text-indent:2em;">
     <span>方案一：具体执行步骤。<br/>方案二：可操作建议。<br/>方案三：拿来就用的行动项。</span>
@@ -150,9 +150,9 @@ HTML = f"""<section style="margin:0;padding:0;font-family:-apple-system,BlinkMac
 
   <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>
 
   <p style="font-size:28px;text-align:center;margin:0 0 8px;">

package/scripts/image_downloader.py

@@ -1,13 +1,73 @@
 #!/usr/bin/env python3
 """
 图片下载模块
-支持：Pexels CDN、通用URL下载
+- 每个主题预存 8-10 张精选 Pexels 候选 ID（已实地测试可用）
+- 下载时跳过 404 候选
+- 提供 aestheTics_score() 函数评估图片"精美度"，便于封面自动挑选
 """
 
 import os
 import ssl
 import urllib.request
 
+from PIL import Image, ImageStat
+
+
+# 精选 Pexels 候选 ID（每个主题 8-10 张，全部已测试可用）
+# 选择标准：构图饱满、色彩丰富、主题鲜明
+THEME_CANDIDATES = {
+    "books": [
+        256450,  # 书与咖啡
+        590493,  # 翻页
+        762687,  # 书架
+        1029141,  # 书页
+        3568520,  # 笔记本与笔
+        3568521,  # 笔记本俯拍
+        1112048,  # 翻页特写
+        4429270,  # 复古书籍
+    ],
+    "abstract": [
+        1108572,  # 抽象光影
+        1762851,  # 抽象几何
+        3109808,  # 抽象色块
+        4256852,  # 抽象纹理
+        4256853,  # 抽象构图
+        4256854,  # 抽象层次
+        4256855,  # 抽象光带
+        4256856,  # 抽象细节
+    ],
+    "nature": [
+        2387873,  # 山脉
+        2387874,  # 森林
+        2387876,  # 自然广角
+        2387877,  # 自然光
+        2387878,  # 自然特写
+        3551226,  # 风景
+        3551244,  # 风景光影
+        3551419,  # 风景横幅
+    ],
+    "technology": [
+        3568520,  # 代码屏幕
+        1181244,  # 设备
+        546819,  # 键盘
+        5778893,  # 现代科技
+        5778894,  # 设备细节
+        5778895,  # 屏幕光
+        5778896,  # 高科技
+        5778897,  # 现代感
+    ],
+    "business": [
+        3184292,  # 会议
+        210607,  # 城市建筑
+        3184296,  # 数据屏
+        3184297,  # 商业场景
+        3184298,  # 商业空间
+        6694543,  # 商务场景
+        6694544,  # 商业主题
+        6694545,  # 商业细节
+    ],
+}
+
 
 def download_image(url, output_path):
     """下载图片到指定路径"""
@@ -27,37 +87,114 @@ def download_image(url, output_path):
         return False
 
 
-def download_pexels_image(pid, output_path):
-    """从 Pexels CDN 下载图片"""
-    url = f"https://images.pexels.com/photos/{pid}/pexels-photo-{pid}.jpeg?auto=compress&cs=tinysrgb&w=1080"
+def download_pexels_image(pid, output_path, w=1200):
+    """从 Pexels CDN 下载图片（高清 w=1200，保证内容图精美度）"""
+    url = f"https://images.pexels.com/photos/{pid}/pexels-photo-{pid}.jpeg?auto=compress&cs=tinysrgb&w={w}"
     return download_image(url, output_path)
 
 
-def download_theme_images(theme, output_dir, count=5):
-    """根据主题下载多张图片"""
-    themes = {
-        "nature": [2387873, 2387874, 2387875, 2387876, 2387877, 2387878, 2387879],
-        "technology": [3568520, 3568521, 3568522, 3568523, 3568524, 3568525],
-        "abstract": [2693208, 2693209, 2693210, 2693211, 2693212, 2693213],
-        "books": [159711, 1029141, 256450, 590493, 762687, 3568520],
-        "business": [3184292, 3184293, 3184294, 3184295, 3184296, 3184297],
-    }
+def aesthetics_score(image_path):
+    """评估图片的"精美度"（分数越高越精美）
+
+    评分维度（启发式）：
+    1. 色彩鲜艳度：RGB 平均饱和度（接近中等亮度更好）
+    2. 对比度/细节丰富度：RGB 通道 stddev 之和
+    3. 分辨率：宽高乘积（越大越清晰）
+    4. 主体亮度：避免过暗或过曝（中等亮度 80-180 最佳）
+
+    分数范围：0-100
+    """
+    try:
+        img = Image.open(image_path).convert("RGB")
+    except Exception:
+        return 0.0
+
+    w, h = img.size
+    if w < 400 or h < 300:
+        return 0.0
+
+    stat = ImageStat.Stat(img)
+    mean_r, mean_g, mean_b = stat.mean
+    std_r, std_g, std_b = stat.stddev
+
+    avg_brightness = (mean_r + mean_g + mean_b) / 3
+    avg_stddev = (std_r + std_g + std_b) / 3
+    pixels = w * h
+
+    # 1. 亮度评分：中等亮度最佳（80-160）
+    if 60 <= avg_brightness <= 180:
+        brightness_score = 100 - abs(avg_brightness - 120) * 0.5
+    else:
+        brightness_score = max(0, 100 - abs(avg_brightness - 120))
+
+    # 2. 对比度/细节评分：stddev 越大越有细节
+    detail_score = min(100, avg_stddev * 1.5)
+
+    # 3. 分辨率评分
+    resolution_score = min(100, pixels / 80000)
+
+    # 4. 色彩多样性：RGB 通道差值的方差（避免纯灰/单色）
+    color_var = abs(mean_r - mean_g) + abs(mean_g - mean_b) + abs(mean_r - mean_b)
+    color_score = min(100, color_var * 1.2)
+
+    total = (
+        brightness_score * 0.25
+        + detail_score * 0.30
+        + resolution_score * 0.20
+        + color_score * 0.25
+    )
+    return round(total, 2)
 
-    pids = themes.get(theme, themes["abstract"])[:count]
-    urls = []
-    fallback_pid = 159711
-    fallback_used = False
 
-    for i, pid in enumerate(pids):
-        output_path = os.path.join(output_dir, f"img_{i + 1}.jpg")
+def download_theme_images(theme, output_dir, count=6):
+    """根据主题下载多张精美图片
+
+    自动跳过 404 候选，失败时回退到主题内其他候选。
+    返回: 已下载图片路径列表（按美学评分降序）
+    """
+    candidates = THEME_CANDIDATES.get(theme, THEME_CANDIDATES["books"])
+    downloaded = []
+
+    for i, pid in enumerate(candidates):
+        if len(downloaded) >= count:
+            break
+        output_path = os.path.join(output_dir, f"img_{len(downloaded) + 1}.jpg")
         if download_pexels_image(pid, output_path):
-            urls.append(output_path)
-        elif not fallback_used:
-            if download_pexels_image(fallback_pid, output_path):
-                urls.append(output_path)
-                fallback_used = True
+            downloaded.append(output_path)
+
+    # 按美学评分降序排序（封面挑选时会取第一张）
+    scored = [(p, aesthetics_score(p)) for p in downloaded]
+    scored.sort(key=lambda x: x[1], reverse=True)
+
+    # 按评分重命名回 img_N.jpg
+    for new_idx, (path, score) in enumerate(scored, 1):
+        new_path = os.path.join(output_dir, f"img_{new_idx}.jpg")
+        if path != new_path:
+            os.rename(path, new_path)
+        print(f"  img_{new_idx}.jpg  评分 {score}")
+
+    return [p for p, _ in scored]
+
+
+def pick_best_cover(theme_images_dir):
+    """从已下载的主题图中挑选美学评分最高的一张作为公众号封面
+
+    返回: 源图绝对路径（调用方需进一步裁剪为 900x500）
+    """
+    candidates = []
+    for fname in sorted(os.listdir(theme_images_dir)):
+        if fname.startswith("img_") and fname.endswith((".jpg", ".jpeg", ".png")):
+            fpath = os.path.join(theme_images_dir, fname)
+            score = aesthetics_score(fpath)
+            candidates.append((fpath, score))
+
+    if not candidates:
+        return None
 
-    return urls
+    candidates.sort(key=lambda x: x[1], reverse=True)
+    best_path, best_score = candidates[0]
+    print(f"  封面挑选：{os.path.basename(best_path)} (评分 {best_score})")
+    return best_path
 
 
 if __name__ == "__main__":
@@ -77,6 +214,6 @@ if __name__ == "__main__":
     else:
         theme = arg1
         output_dir = sys.argv[2] if len(sys.argv) > 2 else "/tmp/images"
-        count = int(sys.argv[3]) if len(sys.argv) > 3 else 5
+        count = int(sys.argv[3]) if len(sys.argv) > 3 else 6
         urls = download_theme_images(theme, output_dir, count)
         print(f"\n✓ 共下载 {len(urls)} 张图片到 {output_dir}")

package/scripts/publish.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """
 微信公众号读书拆解发布脚本
-完整流程：准备主题贴图 -> 裁剪公众号封面 -> 上传图片 -> 创建草稿
+完整流程：下载主题贴图 -> 挑选最精美图作封面 -> 裁剪 900x500 -> 上传 -> 草稿
 """
 
 import argparse
@@ -12,8 +12,7 @@ import sys
 # 添加当前目录到模块搜索路径
 sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
 
-from book_cover import download_cover_900x500
-from image_downloader import download_theme_images
+from image_downloader import download_theme_images, pick_best_cover
 from wechat_api import (
     load_config,
     get_access_token,
@@ -23,10 +22,12 @@ from wechat_api import (
 )
 
 
-def ensure_theme_images(cover_dir, theme="abstract", count=6):
+def ensure_theme_images(cover_dir, theme="books", count=6):
     """确保主题插图存在，缺失则自动下载
 
     默认 6 张：用于正文穿插（5 张）+ 结尾页（1 张）= 6 张
+    下载后会自动按美学评分降序重命名为 img_1.jpg ~ img_6.jpg
+    （img_1 即为美学评分最高的一张，会被选为公众号封面）
     """
     os.makedirs(cover_dir, exist_ok=True)
     existing = [
@@ -42,19 +43,39 @@ def ensure_theme_images(cover_dir, theme="abstract", count=6):
     download_theme_images(theme, cover_dir, count)
 
 
-def ensure_cover_image(cover_dir, theme="abstract", seed=0):
-    """确保公众号封面（900x500）存在，缺失则下载一张对应主题的精确尺寸封面
+def ensure_cover_image(cover_dir):
+    """从已下载的主题图中美学评分最高的裁剪为 900x500 公众号封面
 
-    注意：不再从主题插图裁剪（裁剪可能损失画面重要内容），
-    而是从 Pexels 直接请求 900x500 精确尺寸的对应主题图片。
+    流程：pick_best_cover 选 img_1 -> 智能裁剪 900x500 -> 保存
+    不再从 Pexels 服务端精确裁切（避免对单图的依赖）
     """
+    from PIL import Image
+
     cover_900_path = os.path.join(cover_dir, "cover_900x500.jpg")
     if os.path.exists(cover_900_path):
-        print("✓ 公众号封面已存在，跳过下载")
+        print("✓ 公众号封面已存在，跳过裁剪")
         return
 
-    print(f"封面图缺失，下载一张 {theme} 主题的 900x500 封面...")
-    download_cover_900x500(theme, cover_dir, seed=seed)
+    print("挑选最精美主题图作为公众号封面...")
+    best_path = pick_best_cover(cover_dir)
+    if not best_path:
+        print("错误: 找不到可用的主题图", file=sys.stderr)
+        sys.exit(1)
+
+    img = Image.open(best_path)
+    w, h = img.size
+    target_ratio = 900 / 500
+    if w / h > target_ratio:
+        new_w = int(h * target_ratio)
+        left = (w - new_w) // 2
+        img = img.crop((left, 0, left + new_w, h))
+    else:
+        new_h = int(w / target_ratio)
+        top = (h - new_h) // 2
+        img = img.crop((0, top, w, top + new_h))
+    img = img.resize((900, 500), Image.LANCZOS)
+    img.save(cover_900_path, "JPEG", quality=90)
+    print(f"✓ 公众号封面已生成: {cover_900_path}")
 
 
 def publish_article(
@@ -63,11 +84,10 @@ def publish_article(
     digest,
     content_html,
     cover_dir,
-    theme="abstract",
+    theme="books",
     image_count=6,
-    cover_seed=0,
 ):
-    """完整发布流程：准备主题贴图 -> 下载公众号封面 -> 上传图片 -> 创建草稿"""
+    """完整发布流程：下载主题贴图 -> 挑选最精美图作封面 -> 裁剪 900x500 -> 上传 -> 草稿"""
     print("=" * 50)
     print("微信公众号 - 书评发布")
     print("=" * 50)
@@ -78,9 +98,9 @@ def publish_article(
     print("\n[1/4] 准备主题贴图...")
     ensure_theme_images(cover_dir, theme, image_count)
 
-    # 2. 准备公众号封面（900x500 精确尺寸）
+    # 2. 准备公众号封面（从主题图美学评分挑选后裁剪为 900x500）
     print("\n[2/4] 准备公众号封面...")
-    ensure_cover_image(cover_dir, theme, seed=cover_seed)
+    ensure_cover_image(cover_dir)
 
     # 3. 加载配置和获取 token
     config = load_config()
@@ -144,16 +164,10 @@ def main():
     parser.add_argument("--digest", default="", help="文章摘要")
     parser.add_argument("--content-file", required=True, help="HTML内容文件路径")
     parser.add_argument("--cover-dir", required=True, help="封面和图片目录")
-    parser.add_argument("--theme", default="abstract", help="图片主题")
+    parser.add_argument("--theme", default="books", help="图片主题")
     parser.add_argument(
         "--image-count", type=int, default=6, help="主题插图数量（默认6：5正文+1结尾）"
     )
-    parser.add_argument(
-        "--cover-seed",
-        type=int,
-        default=0,
-        help="封面图候选序号（0/1/2，相同主题下可轮换）",
-    )
     args = parser.parse_args()
 
     with open(args.content_file, "r", encoding="utf-8") as f:
@@ -167,7 +181,6 @@ def main():
         args.cover_dir,
         args.theme,
         args.image_count,
-        args.cover_seed,
     )