@topmindspace/topmind-writing-skills 0.7.1

package/topmind-cover/references/impact-language.md

@@ -0,0 +1,94 @@
+# 冲击力设计语言（抽象原则清单）
+
+> 用途：给封面 prompt 编写者的"敢用力"依据。与 `cover-styles.md` 的原创铁律配合使用——
+> 本文件只给可迁移的抽象原则，不给具体版式；任何原则落地时，版式与配色不得与第三方封面构成实质相似。
+> 具体版式红线见 `docs/audit-2026-09-29-round5.md` 第一节差异审查表。
+
+## 一、字体：字是第一眼
+
+1. **标题字高目标冲击 1/3（空间允许时），底线 ≥1/4。**——为什么有效：封面在信息流里先以缩略图出现，字小等于没写标题；1/3 是"一眼即主题"的经验阈值，空间不够时才退到 1/4。
+2. **全图只给一处强调**（一个关键词或一个数字），用字号/色彩/描边等手法与其它文字拉开断层式差距。——为什么有效：处处强调等于没有强调，单点强调才能形成视觉锚。
+3. **字色与底色明度差拉到最大**（深底配浅字、浅底配深字）。——为什么有效：对比是可读性的前提，也是缩略图下抓住注意力的最廉价手段。
+4. **数字优先于文字做视觉钩子。**——为什么有效：数字比文字更快被大脑处理，且自带"具体、可验证"的信任感，3 秒内信息密度最高。
+5. **字体性格与内容情绪一致**（硬朗/书法/圆润/纤细各有脾气）。——为什么有效：字形本身就是情绪，字形与内容违和会直接削弱信任。
+
+## 二、色彩：0.3 秒的情绪预告
+
+6. **一主色 + 一强调色；强调色只出现在一处或一类元素上。**——为什么有效：色彩记忆点来自克制，第二种强调色出现画面就"吵"了。
+7. **主色与底色/字色形成明确对立**（明暗对立或冷暖对立二选一）。——为什么有效：对立产生张力，张力产生注视；没对比的画面在信息流里直接隐身。
+8. **底色明度走极端**（极浅或极深），避开中间灰。——为什么有效：极端的明度选择让画面有"立场"，中间灰最安全也最容易被滑过。
+9. **情绪色与题材匹配**（科技/活力/阅读感各有对应的色彩情绪）。——为什么有效：读者在读字之前，先被颜色"说服"一半。
+
+## 三、构图：先有动线，再摆元素
+
+10. **先定一条主阅读动线，再摆元素；全图只允许一条。**——为什么有效：眼睛需要被引导，没有动线的画面信息是散的，3 秒内形不成记忆。
+11. **文字区与视觉主体分区明确、互不遮挡。**——为什么有效：字被挡=信息丢失；分区让大脑一次只处理一类信息，认知负荷最低。
+12. **留白是设计元素，不是"没画完"。**——为什么有效：留白制造对比、托出主体；满版无呼吸的画面在小图下糊成一团。
+13. **每张图必须有一个记忆点元素**（形象、数字、符号、质感四选一）。——为什么有效：人记不住"一张好看的图"，只记得住一个具体的"东西"。
+
+## 四、信息层级：3 秒能读到什么
+
+14. **3 秒测试：遮住细节，3 秒内能说出"这是什么、为什么值得点"。**——为什么有效：封面的唯一 KPI 是点击率，3 秒读不懂=设计失败。
+15. **信息分层、各司其职：钩子（为什么停）→ 主题（这是什么）→ 背书（凭什么信）。**——为什么有效：对应读者"被吸引→懂主题→信可信"的决策链，缺一层就断一环。
+16. **背书层只给"点击理由"**（数据、筛选口径、作者身份三选一）。——为什么有效：标题负责"是什么"，背书负责"凭什么信你"，分工不清两头都弱。
+17. **元素总数 ≤5。**——为什么有效：每多一个元素，视觉权重就被稀释一分；克制是冲击力的另一面。
+
+## 五、质感：不单调的来源
+
+18. **纯色底必须配一种背景质感**（纸纹/噪点/光影渐变/细微纹理四选一）。——为什么有效：AI 生成的纯色底最容易显"塑料感"，一层细微质感立刻拉开与模板图的差距。
+19. **质感只做背景层，不进文字区。**——为什么有效：质感是氛围组，进了文字区就是噪音；克制使用才"高级"。
+20. **保留一处手工感/真实感细节**（笔触、纸纹、真实小物件、自然光影四选一）。——为什么有效：AI 图最缺的是"人味"，一个不完美的细节让画面可信度上升。
+
+## 六、保守陷阱清单（前几轮样张犯过的错）
+
+| # | 保守错误 | 纠正方向 |
+|---|---|---|
+| 1 | 标题太小（字高 <1/5 画面） | 先定标题字高目标 1/3（底线 ≥1/4），再摆其他元素；标题是视觉重心，不是配角 |
+| 2 | 对比太弱（灰底灰字、强调色饱和度不足） | 字色底色明度差拉满；强调色敢用高饱和，但只用一处 |
+| 3 | 画面太平（元素平均用力、无重心、无动线） | 先定一条主阅读动线和一个最大元素，其他全部让路 |
+| 4 | 元素太多太碎（>5 个、装饰无节制） | 每加一个元素就问"删掉它会损失什么"，答不上来就删 |
+| 5 | 数字不敢放大（数据藏在角落小字里） | 真实数字是天然钩子，值得给最大字号或最跳的颜色（只给一处） |
+| 6 | 质感不敢加（纯色底一片死平） | 至少加一层纸纹/噪点/光影，放在背景层 |
+| 7 | 情绪不敢给（断言、感叹全磨平） | 在标题或背书层保留一处情绪支点（断言/感叹/反问三选一），只一处 |
+| 8 | 配色求稳（全用安全中性色） | 主色敢选有情绪的颜色；要克制的是"颜色数量"，不是"颜色性格" |
+
+## 七、文字装饰系统（第九轮新增：文字排印与装饰）
+
+**总原则：中文正确性永远优先于花样。**图像模型对中文大字的渲染能力有限，任何装饰不得导致错字、乱码、笔画粘连。装饰是"放大记忆点"的手段，不是"堆花样"的目的——每张图选 2~3 种装饰，用到就够，多一种就问自己一次"删掉它会损失什么"（参见第四条规则）。
+
+### 7.1 六种可靠装饰（按优先级从高到低）
+
+| # | 装饰 | 效果 | 风险 | 适用风格 | 提示词写法（具体可执行） |
+|---|---|---|---|---|---|
+| 1 | 关键词变色高亮 | 1~2 个关键词换强调色，成为全图视觉锚点；3 秒内眼睛先被"有色"字抓住 | 一句话超 3 色会吵；低对比配色（浅灰底白字）直接隐身 | gan-huo、news-flash、tutorial-steps、magazine、white-clean、bg-blur、paper-collage | 把"翻车"两字换成朱红 #E6392B，其余字米白 #FAF6EC；整句只用这两种颜色 |
+| 2 | 字号对比 | 关键词放大 1.3~1.6 倍，信息层级瞬间拉开，钩子词拥有最大视觉权重 | 放大超 1.6 倍易挤占构图、导致换行断裂；数字放大优先于文字放大 | big-type、gan-huo、news-flash、magazine、bg-blur | 标题中"暴跌"二字字号放大到其余字的 1.5 倍，其余字保持原字号，不换行 |
+| 3 | 文字底部色块/描边 | 色块衬底：关键词下垫一块实色矩形，街头海报感，远距离可读；描边：深底浅字时勾勒字形，字更"跳" | 色块过厚会吞掉字下半部；浅色字+浅色色块对比不足；描边过粗导致笔画粘连 | brand-launch（色块）、big-type（描边）、ip-fun（色块）、white-clean（色块/马克笔横条） | "暴跌"两字下方垫一块朱红 #E6392B 实色矩形，矩形高度为字高的 1.2 倍，字为米白压在色块上；描边写法：米白字加 2px 深灰描边，描边宽度不超过笔画宽度的 1/5 |
+| 4 | 轻微阴影/立体 | 字从底色上"浮"起来，增加纵深；轻微立体（1~2 层错位）有质感 | 三重叠加（描边+阴影+立体）必糊；阴影过重显脏；深色底+深色阴影等于没加 | big-type、brand-launch、ip-fun | 标题字加一层向右下 45° 的柔和投影，投影颜色 #000000 不透明度 30%，偏移距离为字高的 1/10；立体写法：字后方加一层同字形、朱红 #E6392B、向右下错位 4px 的色块字，只错位一层 |
+| 5 | 手绘下划线/圈注/箭头 | 手绘感=人味（参见第 20 条），划线给关键词"划重点"，圈注给数据"画圈强调"，箭头给动线"指路" | 线条过粗会压住字；圈注套住整句等于没强调；箭头超过 2 个画面变流程图 | gan-huo（圈注）、news-flash（箭头）、tutorial-steps（下划线/箭头）、white-clean（马克笔横条）、paper-collage（圈注） | 在"翻车"两字下方画一条手绘感波浪下划线，朱红 #E6392B，线宽为笔画宽度的 1/2，略带抖动不压字；圈注写法：用朱红马克笔笔触把"23.2%"圈起来，圈略大于字、不压笔画；箭头写法：从标题指向配图的红色手绘箭头，一条，线条粗细均匀 |
+| 6 | 适度旋转 | 印章/标签/角标类小元素倾斜 ≤8°，打破呆板，制造"贴上去"的真实感 | 大标题旋转必乱码；竖排+旋转组合必翻车；旋转超 8° 显廉价 | 仅用于印章/标签/角标小元素（如"实测""必看"角标），不用于大标题 | 右上角"实测"角标整体顺时针旋转 6°，字不转、整体转；大标题保持水平，一个字都不许倾斜 |
+
+### 7.2 八风格装饰指定（每风格 2~3 种必用）
+
+| 风格 | 必用装饰 | 理由 |
+|---|---|---|
+| gan-huo（干货） | ①关键词变色高亮 ②色块衬底 ③手绘圈注 | 干货风靠"划重点"建立信任：变色定锚点、色块给海报感、圈注圈住关键数据，三件套=把"值得收藏"写在脸上 |
+| big-type（大字报） | ②字号对比 ③描边 ④轻微立体 | 大字报的全部冲击力来自字本身：字号对比拉层级、描边让字跳、轻微立体给纵深，三者都作用于字形、不引入外部元素，字即画面 |
+| brand-launch（品牌发布） | ③色块衬底 ④轻微阴影 | 品牌发布要"贵气+仪式感"：色块衬底是发布会主视觉的经典语言，轻微阴影给字高级的浮起感，克制不用手绘元素以免掉价 |
+| tutorial-steps（教程步骤） | ①关键词变色高亮 ⑤手绘下划线/箭头 | 教程风需要"指路感"：变色标出每步关键词，下划线/箭头串起步骤动线，读者一眼知道先看哪、后看哪 |
+| ip-fun（IP 趣味） | ③色块衬底 ④轻微立体 | IP 趣味风要"潮玩感"：色块衬底像贴纸，轻微立体像徽章凸起，两者叠加出潮玩包装的质感，忌用严肃的手绘批注 |
+| news-flash（新闻快讯） | ①关键词变色高亮 ②字号对比 ⑤手绘箭头 | 快讯风=突发感：变色+放大双管齐下让爆点词在信息流里"炸"出来，一条箭头指向配图、制造"正在发生"的现场感 |
+| minimal（极简） | 只用一点睛色块（③的克制版） | 极简的冲击力来自克制本身：只允许一处色块衬底点睛，多一种装饰就破功；变色、旋转、手绘一律不用 |
+| magazine（杂志风） | ①关键词变色高亮 ②字号对比 | 杂志封面语言就是"大标题+关键词强调"：变色给情绪、字号对比给层级，两种都作用于标题排印本身，不加外部装饰以保编辑感 |
+| white-clean（白色清新） | ①关键词变色高亮 ③色块衬底/马克笔横条 ⑤手绘下划线 | 清新风靠"撞色+横条"制造亲和的干货感：变色定锚点、马克笔横条给"划重点"的人味；每次只用其中 2~3 种，小装饰（星星/感叹号）至多 2 处 |
+| bg-blur（背景虚化） | ①关键词变色高亮 ②字号对比 | 虚化风的冲击力全在"虚实对比"上：标题只用变色+放大两种装饰，背景光斑不抢戏；标题必须压清晰区 |
+| paper-collage（纸感拼贴） | ①关键词变色高亮 ⑤手绘圈注 | 拼贴风要"手作感"：变色给标题关键词，圈注只圈最小标签一处；纸片本身已是装饰，标题装饰 2 种封顶 |
+
+### 7.3 装饰禁令清单（Worker B：写入各风格"绝不"清单）
+
+1. **禁透视变形大标题**——大标题做透视/扭曲/弧形排列，中文必乱码；要动感用轻微立体代替。
+2. **禁一句话超 3 种颜色**——标题内颜色种类（含字色、色块色、描边色）不得超过 3 种，超了画面就"吵"。
+3. **禁描边+阴影+立体三重叠加**——三种效果最多同时用一种（big-type 可用描边+轻微立体两种，但不得再加阴影）。
+4. **禁竖排+旋转组合**——竖排文字不得再叠加任何旋转；旋转只允许用于印章/标签类小元素，且 ≤8°，大标题永远水平。
+5. **禁色块吞字**——色块衬底高度不得超过字高的 1.3 倍，色块与字色必须明暗对立（深底浅字或浅底深字），对比不足宁可不用。
+6. **禁装饰压笔画**——手绘下划线/圈注/箭头不得压住文字笔画；圈注只圈 1~2 个词或一个数字，圈住整句等于没强调。
+7. **禁装饰超 3 种**——单张图装饰种类不得超过 7.2 表中该风格指定的数量（minimal 只许 1 种）；多一种就问"删掉它会损失什么"。

package/topmind-cover/scripts/audit_css.py

@@ -0,0 +1,39 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""CSS 审计：本组技能无 CSS 资产；若未来加入 .css 文件，则做括号配平基础检查。"""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+NAME = ROOT.name
+errors: list[str] = []
+
+
+def main() -> None:
+    print(f"[audit_css] {NAME}")
+    css_files = [p for p in ROOT.rglob("*.css") if ".git" not in p.parts and "dist" not in p.parts]
+    if not css_files:
+        print("  ✓ 无 CSS 资产，跳过")
+        print(f"\n[audit_css] {NAME}: 通过")
+        return
+    for css in css_files:
+        text = css.read_text(encoding="utf-8")
+        balanced = text.count("{") == text.count("}")
+        print(("  ✓ " if balanced else "  ✗ ") + f"{css.name} 括号配平")
+        if not balanced:
+            errors.append(css.name)
+    if errors:
+        print(f"\n[audit_css] {NAME}: {len(errors)} 项失败")
+        sys.exit(1)
+    print(f"\n[audit_css] {NAME}: 全部通过")
+
+
+if __name__ == "__main__":
+    main()

package/topmind-cover/scripts/audit_docs.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""文档审计：references 完整性与内部链接可达性（任一不过 → 退出码 1）。"""
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+NAME = ROOT.name
+errors: list[str] = []
+
+
+def check(cond: bool, msg: str) -> None:
+    print(("  ✓ " if cond else "  ✗ ") + msg)
+    if not cond:
+        errors.append(msg)
+
+
+def main() -> None:
+    print(f"[audit_docs] {NAME}")
+    md_files = [p for p in ROOT.rglob("*.md") if ".git" not in p.parts and "dist" not in p.parts]
+    check(len(md_files) >= 2, f"md 文档 ≥2（实 {len(md_files)}，含 SKILL.md/README.md）")
+
+    refdir = ROOT / "references"
+    if refdir.is_dir():
+        refs = sorted(refdir.glob("*.md"))
+        check(len(refs) >= 1, f"references/*.md ≥1（实 {len(refs)}）")
+        for md in refs:
+            check(md.stat().st_size > 0, f"references/{md.name} 非空")
+
+    for md in md_files:
+        text = md.read_text(encoding="utf-8")
+        rel = md.relative_to(ROOT).as_posix()
+        for link in set(re.findall(r"\]\(([^)]+)\)", text)):
+            if link.startswith(("http://", "https://", "#", "mailto:")):
+                continue
+            target = (md.parent / link.split("#")[0]).resolve()
+            if link and not target.exists():
+                # 允许指向脚本/资源等非 md 文件的相对链接缺失检查放宽到 md
+                if target.suffix == ".md":
+                    check(False, f"{rel} 悬空链接: {link}")
+    check(True, "内部 md 链接可达")
+
+    # 反引号代码引用中的路径可达（审计 轻微-15 门禁盲区：之前只查 [text](path) 形式，
+    # `references/pan-style.md` 这类反引号引用曾漏网）。抓取反引号内的 references/*.md
+    # 与 scripts/* 路径并校验存在；glob/占位符写法（* ? < > |）跳过。
+    backtick_path_re = re.compile(r"(references|scripts)/([\w.\-/]+)")
+    line_suffix_re = re.compile(r":\d+(?:-\d+)?$")
+    backtick_bad = 0
+    for md in md_files:
+        text = md.read_text(encoding="utf-8")
+        rel = md.relative_to(ROOT).as_posix()
+        for span in set(re.findall(r"`([^`]+)`", text)):
+            for kind, p in backtick_path_re.findall(span):
+                p = line_suffix_re.sub("", p)
+                if not p or any(c in p for c in "*?<>|"):
+                    continue
+                target = md.parent / kind / p
+                if not target.exists():
+                    target = ROOT / kind / p
+                if not target.exists():
+                    backtick_bad += 1
+                    check(False, f"{rel} 反引号引用不可达: `{kind}/{p}`")
+    check(backtick_bad == 0, f"反引号内 references/scripts 引用可达（扫描 {len(md_files)} 个 md 文件）")
+
+    if errors:
+        print(f"\n[audit_docs] {NAME}: {len(errors)} 项失败")
+        sys.exit(1)
+    print(f"\n[audit_docs] {NAME}: 全部通过")
+
+
+if __name__ == "__main__":
+    main()

package/topmind-cover/scripts/audit_skill.py

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""技能入口审计：SKILL.md 结构完整性（任一不过 → 退出码 1）。"""
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+NAME = ROOT.name
+errors: list[str] = []
+
+
+def check(cond: bool, msg: str) -> None:
+    print(("  ✓ " if cond else "  ✗ ") + msg)
+    if not cond:
+        errors.append(msg)
+
+
+def main() -> None:
+    print(f"[audit_skill] {NAME}")
+    text = (ROOT / "SKILL.md").read_text(encoding="utf-8")
+
+    m = re.search(r"^triggers:\s*\n((?:  - .+\n?)+)", text, re.M)
+    triggers = re.findall(r"^  - (.+)$", m.group(1), re.M) if m else []
+    check(len(triggers) >= 1, f"triggers ≥1（实 {len(triggers)}）")
+
+    check("When NOT to use" in text or "何时不用" in text, "含 When NOT to use / 何时不用")
+
+    has_workflow = bool(re.search(r"工作流|Workflow|用法|Usage", text))
+    check(has_workflow, "含工作流/用法说明")
+
+    fm = re.match(r"^---\r?\n([\s\S]*?)\r?\n---", text)
+    desc = ""
+    if fm:
+        dm = re.search(r'^description:\s*"([^"]*)"\s*$', fm.group(1), re.M)
+        if dm:
+            desc = dm.group(1).strip()
+        else:
+            dm = re.search(r"^description:\s*>\-\s*\n((?:[ \t]+.*\n?)+)", fm.group(1), re.M)
+            if dm:
+                desc = " ".join(l.strip() for l in dm.group(1).splitlines())
+    check("Use when" in desc or "用" in desc, "description 含使用场景")
+    check("Do NOT use" in desc or "不用" in desc, "description 含不适用场景")
+    check(len(desc) <= 1024, f"description ≤1024（实 {len(desc)}）")
+
+    if errors:
+        print(f"\n[audit_skill] {NAME}: {len(errors)} 项失败")
+        sys.exit(1)
+    print(f"\n[audit_skill] {NAME}: 全部通过")
+
+
+if __name__ == "__main__":
+    main()

package/topmind-cover/scripts/audit_styles.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""样式资产审计：主题/风格资源有效性（任一不过 → 退出码 1）。
+
+本组技能无 CSS 样式表：若存在 assets/themes/*.json 则校验 JSON 可解析；
+references 风格文档非空（已由 audit_docs 覆盖，此处做存在性断言）。
+"""
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+NAME = ROOT.name
+errors: list[str] = []
+
+
+def check(cond: bool, msg: str) -> None:
+    print(("  ✓ " if cond else "  ✗ ") + msg)
+    if not cond:
+        errors.append(msg)
+
+
+def main() -> None:
+    print(f"[audit_styles] {NAME}")
+    themes = sorted((ROOT / "assets" / "themes").glob("*.json")) if (ROOT / "assets" / "themes").is_dir() else []
+    if themes:
+        for t in themes:
+            try:
+                json.loads(t.read_text(encoding="utf-8"))
+                check(True, f"assets/themes/{t.name} JSON 可解析")
+            except (OSError, json.JSONDecodeError) as e:
+                check(False, f"assets/themes/{t.name} 解析失败: {e}")
+    else:
+        check(True, "无主题 JSON 资产（本技能不依赖主题文件）")
+
+    refdir = ROOT / "references"
+    has_style_doc = refdir.is_dir() and any(refdir.glob("*.md"))
+    check(has_style_doc, "references 风格/格式文档存在")
+
+    if errors:
+        print(f"\n[audit_styles] {NAME}: {len(errors)} 项失败")
+        sys.exit(1)
+    print(f"\n[audit_styles] {NAME}: 全部通过")
+
+
+if __name__ == "__main__":
+    main()

package/topmind-cover/scripts/crop-cover.py

@@ -0,0 +1,74 @@
+#!/usr/bin/env python3
+"""封面图裁剪：从 5:2 主图中央裁出公众号 2.35:1 版，并统一落盘命名。
+
+用法：
+    python3 crop-cover.py <主图路径> --out-dir <包>/images/
+
+产出：
+    <out-dir>/00-封面.png          1500x600  (X / 公众号共用主文件)
+    <out-dir>/00-封面-公众号.png   900x383   (公众号封面大图，中央裁剪)
+"""
+import argparse
+import sys
+from pathlib import Path
+
+try:
+    from PIL import Image
+except ImportError:
+    sys.exit("需要 Pillow：pip install pillow")
+
+TARGETS = {
+    "00-封面.png": (1500, 600),
+    "00-封面-公众号.png": (900, 383),
+}
+
+
+def main() -> None:
+    ap = argparse.ArgumentParser()
+    ap.add_argument("src", help="5:2 主图路径")
+    ap.add_argument("--out-dir", required=True)
+    args = ap.parse_args()
+
+    src = Path(args.src)
+    out_dir = Path(args.out_dir)
+    try:
+        out_dir.mkdir(parents=True, exist_ok=True)
+    except OSError as e:
+        sys.exit(f"错误：无法创建输出目录 {out_dir}（{e}）")
+
+    if not src.is_file():
+        sys.exit(f"错误：找不到输入图片 {src}")
+    try:
+        img = Image.open(src).convert("RGB")
+    except Exception as e:
+        sys.exit(f"错误：无法读取图片 {src}（{e}）")
+    w, h = img.size
+
+    # 先按 5:2 中央裁一块基准
+    base_ratio = 5 / 2
+    if w / h > base_ratio:
+        cw, ch = int(h * base_ratio), h
+    else:
+        cw, ch = w, int(w / base_ratio)
+    x0, y0 = (w - cw) // 2, (h - ch) // 2
+    base = img.crop((x0, y0, x0 + cw, y0 + ch))
+
+    try:
+        for name, (tw, th) in TARGETS.items():
+            ratio = tw / th
+            bw, bh = base.size
+            if bw / bh > ratio:
+                cw2, ch2 = int(bh * ratio), bh
+            else:
+                cw2, ch2 = bw, int(bw / ratio)
+            x1, y1 = (bw - cw2) // 2, (bh - ch2) // 2
+            out = base.crop((x1, y1, x1 + cw2, y1 + ch2)).resize((tw, th), Image.LANCZOS)
+            dest = out_dir / name
+            out.save(dest)
+            print(f"OK {dest} ({tw}x{th})")
+    except OSError as e:
+        sys.exit(f"错误：写入封面图失败（{e}）")
+
+
+if __name__ == "__main__":
+    main()

package/topmind-cover/scripts/negative_tests.py

@@ -0,0 +1,71 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""topmind-cover 异常输入测试：crop-cover.py 错误路径干净（任一失败 → 退出码 1）。"""
+from __future__ import annotations
+
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+CROP = ROOT / "scripts" / "crop-cover.py"
+PY = sys.executable
+fails: list[str] = []
+
+
+def run(args: list[str]) -> subprocess.CompletedProcess:
+    return subprocess.run([PY, str(CROP), *args], capture_output=True, text=True, timeout=60)
+
+
+def check(name: str, cond: bool, detail: str = "") -> None:
+    print(("  ✓ " if cond else "  ✗ ") + name + (f" — {detail}" if detail and not cond else ""))
+    if not cond:
+        fails.append(name)
+
+
+def main() -> None:
+    print("[negative_tests] topmind-cover")
+    with tempfile.TemporaryDirectory() as td:
+        td = Path(td)
+
+        # 1. 缺失输入 → 非零退出，无 Traceback
+        r = run([str(td / "nope.png"), "--out-dir", str(td / "o1")])
+        check("缺失输入干净报错", r.returncode != 0 and "Traceback" not in r.stderr, r.stderr[:100])
+
+        # 2. 非图片文件 → 非零退出，无 Traceback
+        (td / "notimg.txt").write_text("hello", encoding="utf-8")
+        r = run([str(td / "notimg.txt"), "--out-dir", str(td / "o2")])
+        check("非图片干净报错", r.returncode != 0 and "Traceback" not in r.stderr, r.stderr[:100])
+
+        # 3. 正常图片产出双尺寸
+        try:
+            from PIL import Image
+            img = Image.new("RGB", (1600, 900), (20, 30, 60))
+            img.save(td / "ok.png")
+            r = run([str(td / "ok.png"), "--out-dir", str(td / "o3")])
+            got_a = (td / "o3" / "00-封面.png").exists()
+            got_b = (td / "o3" / "00-封面-公众号.png").exists()
+            check("正常图片产出双尺寸", r.returncode == 0 and got_a and got_b, r.stderr[:100])
+            if got_a:
+                w, h = Image.open(td / "o3" / "00-封面.png").size
+                check("主图 1500×600", (w, h) == (1500, 600), f"实 {w}×{h}")
+            if got_b:
+                w, h = Image.open(td / "o3" / "00-封面-公众号.png").size
+                check("公众号图 900×383", (w, h) == (900, 383), f"实 {w}×{h}")
+        except ImportError:
+            print("  - 跳过图片生成测试（无 Pillow）")
+
+    if fails:
+        print(f"\n[negative_tests] {len(fails)} 项失败")
+        sys.exit(1)
+    print("\n[negative_tests] 全部通过")
+
+
+if __name__ == "__main__":
+    main()