@topmindspace/tms-skills 0.1.19 → 0.2.0

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+## [0.2.0] - 2026-09-29
+
+### 新增三个写作/配图技能
+
+- **topmind-wechat-post `0.1.0`**：公众号文章全生命周期技能（由 topmind-wechat 适配改名）。
+  交付包 / 审校改写 / 质量三关（事实·逻辑·去 AI 味 ≥85）/ 状态同步 / 微信内联排版（`md2wechat --embed-images`）/ 发布清单。
+  适配点：frontmatter 去 topmind-pack 专有键（`degradation`/`action_category`/`entrypoint`），
+  跨 skill 引用改为通用表述，`writing-quality.md` 改用技能自带 `scan_ai_flavor.py`
+  （原引用本机 `~/.workbuddy` 路径），`md2wechat.py` 缺失输入改干净报错（原 Traceback）。
+- **topmind-x-article `0.1.0`**：X 长文一键发布。`md2x.py` 把 Markdown 转可直接粘贴进
+  X Article 编辑器的纯文本（标题→纯文本行、加粗/斜体去标记、链接→`文字（url）`、
+  图片→`[图N]`+文末配图清单、表格→"项：值"列表）；`references/publish-checklist.md`
+  沉淀实战经验（首评置顶补信息、图序核对、发布后抓回核对）。缺失输入干净报错。
+- **topmind-cover `0.1.0`**：文章封面配图，X / 公众号共用。设计铁律（震撼·醒目·主题突出：
+  一图一主题、大标题 ≤10 字、四周 8% 留白）+ 5 套风格模板；
+  `crop-cover.py` 从 16:9 主图中央裁出公众号 900×383 版（X 用 1200×675），落盘命名规范。
+  缺失输入 / 非图片干净报错。
+- 每个新技能带轻量 CI 门禁：`package_skill.py --check`（frontmatter/版本/引用完整性/禁用文件）、
+  `audit_skill.py` / `audit_docs.py` / `audit_styles.py` / `audit_css.py`、`negative_tests.py`
+  （异常输入不崩溃）。`ci_privacy_scan.py` 全仓通过。
+
 ## [0.1.19] - 2026-09-28
 
 ### 排版修复 · 大纲篇章化 · 参考资料去假 · 图标真导出 · PPTX 高保真增强

package/README.en.md

@@ -77,8 +77,11 @@ See [top-ppt-html/README.md](./top-ppt-html/README.md) and [SKILL.md](./top-ppt-
 | Skill | Version | What it does |
 |-------|---------|--------------|
 | [`top-ppt-html`](./top-ppt-html/) | **0.1.19** | Formal business decks: paginated HTML + editable 16:9 PPTX; dual delivery · MD3-inspired density; 3 modes × 9 styles; strict 0/0 |
+| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.1.0** | WeChat article lifecycle: package, review, 3 quality gates, inline typography & publish checklist |
+| [`topmind-x-article`](./topmind-x-article/) | **0.1.0** | X long-form one-click publish: Markdown → paste-ready plain text + cover + checklist |
+| [`topmind-cover`](./topmind-cover/) | **0.1.0** | Cover art for X / WeChat: striking, theme-focused; size specs + style templates + crop tooling |
 
-Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) is also **0.1.19** (whole-repo same-tag releases).
+Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) is **0.2.0** (whole-repo same-tag releases).
 
 ## Install
 
@@ -88,7 +91,7 @@ Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspa
 npx @topmindspace/tms-skills list
 npx @topmindspace/tms-skills install top-ppt-html
 npx @topmindspace/tms-skills install top-ppt-html --to ./.claude/skills
-npx @topmindspace/tms-skills@0.1.19 install top-ppt-html   # pin
+npx @topmindspace/tms-skills@0.2.0 install top-ppt-html   # pin
 ```
 
 ```bash

package/README.md

@@ -75,8 +75,11 @@
 | 技能 | 版本 | 做什么 |
 |------|------|--------|
 | [`top-ppt-html`](./top-ppt-html/) | **0.1.19** | 正式商务演示：HTML 可翻页 + 16:9 可编辑 PPTX；双交付 · MD3 密度克制；三模式 × 九风格；strict 0/0 |
+| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.1.0** | 公众号文章全生命周期：交付包、审校改写、质量三关、微信内联排版与发布清单 |
+| [`topmind-x-article`](./topmind-x-article/) | **0.1.0** | X 长文一键发布：Markdown 原稿转可直接粘贴的纯文本 + 封面图 + 发布清单 |
+| [`topmind-cover`](./topmind-cover/) | **0.1.0** | 文章封面配图（X / 公众号共用）：震撼醒目主题突出，尺寸规范 + 风格模板 + 裁剪落盘 |
 
-安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 同为 **0.1.19**（整仓同 tag 发版）。
+安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 为 **0.2.0**（整仓同 tag 发版）。
 
 ## 安装
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/tms-skills",
-  "version": "0.1.19",
+  "version": "0.2.0",
   "description": "TopMindspace 智能体技能 monorepo — 通过 npm / GitHub npx 安装技能（top-ppt-html：HTML+PPT 双交付，正式商务演示文稿）。",
   "license": "MIT",
   "author": "TopMindspace",
@@ -30,7 +30,10 @@
     "README.en.md",
     "LICENSE",
     "CHANGELOG.md",
-    "top-ppt-html"
+    "top-ppt-html",
+    "topmind-cover",
+    "topmind-wechat-post",
+    "topmind-x-article"
   ],
   "engines": {
     "node": ">=18"

package/topmind-cover/README.md

@@ -0,0 +1,40 @@
+# topmind-cover · 封面配图生成
+
+为 X 长文和公众号文章生成封面图的可复用技能。目标：**震撼、醒目、主题突出**。
+
+## 安装
+
+```bash
+npx @topmindspace/tms-skills install topmind-cover
+```
+
+## 用法
+
+1. 输入文章标题 + 3 个主题关键词 + 平台（x / wechat / both）
+2. 按 `references/cover-styles.md` 选风格模板组 prompt（标题字逐字写进 prompt）
+3. 用 agent 的图片生成能力出图（横构图 16:9，四周留白 8%）
+4. 肉眼检查：标题字逐字正确、主体完整、一眼能说出主题
+5. 裁剪落盘：
+
+```bash
+python3 scripts/crop-cover.py <主图> --slug <slug> --out-dir <包>/images/
+# 产出 00-封面.png (1200×675) + 00-封面-公众号.png (900×383，中央裁剪)
+```
+
+## 尺寸
+
+| 平台 | 尺寸 | 比例 |
+|------|------|------|
+| X Article 封面 | 1200×675 | 16:9（主图） |
+| 公众号封面大图 | 900×383 | 2.35:1（中央裁） |
+
+## 设计铁律
+
+一图一主题；主体占画面 40%+；大标题 ≤10 字高对比；忌元素堆砌、小字密排、多主体打架。
+
+## 开发
+
+```bash
+python3 scripts/package_skill.py --check
+python3 scripts/negative_tests.py
+```

package/topmind-cover/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: topmind-cover
+version: 1.0.0
+description: "文章封面配图生成：X 长文与公众号共用。震撼、醒目、主题突出；平台尺寸规范、风格模板、命名落盘、成图检查一次配齐。Use when 封面、封面图、头图、配图、cover。Do NOT use for 正文插图、PPT/报告封面。"
+action_category: write
+triggers:
+  - 封面
+  - 封面图
+  - 头图
+  - 配图
+  - cover
+triggers_cn:
+  - 公众号封面
+  - X 封面
+  - 文章封面
+author: Muse
+license: MIT
+updated: 2026-09-29
+---
+
+# topmind-cover · 封面配图生成
+
+为 X 长文和公众号文章生成封面图的可复用技能。目标：**震撼、醒目、主题突出**。
+
+```
+标题/主题 → 风格模板 → 生成 → 检查 → 裁剪双尺寸 → 落盘命名
+```
+
+## 尺寸表
+
+| 平台 | 尺寸 | 比例 | 备注 |
+|------|------|------|------|
+| X Article 封面 | 1200×675 | 16:9 | 主尺寸，先按这个生成 |
+| 公众号封面大图 | 900×383 | 2.35:1 | 从 16:9 中央裁剪 |
+
+生成 prompt 里写明"横构图 16:9"；公众号版用 `scripts/crop-cover.py` 从主图中央裁出，不重新生成（保系列一致）。
+
+## 工作流
+
+1. **输入**：文章标题、3 个主题关键词、平台（`x` / `wechat` / `both`，默认 both）、风格（默认按题材自动选，见 `references/cover-styles.md`）。
+2. **组 prompt**：`[风格模板] + 主体描述 + 大标题字（≤10 字，直接用文章标题或其压缩版）+ 横构图16:9 + 四周留白8%`。标题字必须在 prompt 里逐字写明，防 AI 自造错别字。
+3. **生成**：`media.generate_image`，`name` 用 `<slug>-cover`。
+4. **检查**（必做，肉眼看一遍）：
+   - 标题字逐字正确，无错别字、无多字少字
+   - 主体完整不被裁切，画面不杂乱
+   - 一眼能说出主题；说不出就重生成
+5. **裁剪落盘**：
+   ```bash
+   python3 scripts/crop-cover.py <主图> --slug <slug> --out-dir <包>/images/
+   ```
+   产出 `00-封面.png`（1200×675，X/公众号共用主文件）与 `00-封面-公众号.png`（900×383）。
+   公众号包规约：正文引用 `images/00-封面.png`，`图片上传清单.md` 登记两版。
+6. **系列感**：同一系列文章固定色系 + 版式语言，prompt 复用同一风格模板。
+
+## 设计铁律
+
+- 一图一主题；主体占画面 40% 以上，居中或三分法
+- 大标题 ≤10 字，高对比（暗底亮字 / 亮底深字）
+- 四周 8% 安全边距，标题不贴边
+- 忌：元素堆砌、小字密排、多主体打架、标题字错误
+
+## When NOT to use
+
+- 正文插图：主体是文字说明，按正文配图流程走
+- 报告/PPT 封面：走 `top-ppt-html`
+- 只想找现成图：走 `image_search` 技能

package/topmind-cover/package-lock.json

@@ -0,0 +1,16 @@
+{
+  "name": "topmind-cover",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "topmind-cover",
+      "version": "0.1.0",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    }
+  }
+}

package/topmind-cover/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "topmind-cover",
+  "version": "0.1.0",
+  "private": true,
+  "description": "文章封面配图生成（X 长文 / 公众号共用）：震撼醒目主题突出，尺寸规范 + 风格模板 + 裁剪落盘。",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/topmindspace/tms-skills.git",
+    "directory": "topmind-cover"
+  },
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/topmind-cover/references/cover-styles.md

@@ -0,0 +1,40 @@
+# 封面风格模板
+
+选风格先看题材，再看系列延续性。同一系列固定一个模板，只换主体与标题字。
+
+## 科技深空（默认 · AI/技术题材）
+
+- 深色底（藏青/墨黑）+ 霓虹线条 + 细颗粒星空
+- 主体：产品/人物半身，面光干净
+- 标题：白色粗黑，字号压住上 1/3
+- 例：Manus 2.0、Cue、AI 智能体题材
+
+## 清新浅色（人物/生活/轻题材）
+
+- 米白/浅灰底 + 柔光 + 大面积留白
+- 主体居中，神态自然
+- 标题：深灰细黑，落在下方 1/4
+- 例：卡牌系列人物、随笔
+
+## 国潮撞色（文化/历史题材）
+
+- 朱红/黛青撞色 + 传统纹样暗纹
+- 主体：国风人物或器物
+- 标题：书法感粗体，竖排亦可
+
+## 硬核评测（产品评测题材）
+
+- 深灰底 + 产品特写 + 数据流装饰
+- 标题：黄/白撞色，配 1 个核心数字（如"32%"）
+- 忌：数字必须与正文一致，承重数字先核实
+
+## 通用 prompt 组装公式
+
+```
+{风格模板一句话}，主体：{主体描述}，
+画面中央大标题“{≤10字标题}”，{暗底亮字/亮底深字}，
+横构图16:9，主体占画面40%以上，四周留白8%，
+极简，不堆砌元素，电影感光影
+```
+
+标题字逐字写进 prompt；生成后第一件事就是检查标题字。

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,58 @@
+#!/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 链接可达")
+
+    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,69 @@
+#!/usr/bin/env python3
+"""封面图裁剪：从 16:9 主图中央裁出公众号 2.35:1 版，并统一落盘命名。
+
+用法：
+    python3 crop-cover.py <主图路径> --slug <slug> --out-dir <包>/images/
+
+产出：
+    <out-dir>/00-封面.png          1200x675  (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": (1200, 675),
+    "00-封面-公众号.png": (900, 383),
+}
+
+
+def main() -> None:
+    ap = argparse.ArgumentParser()
+    ap.add_argument("src", help="16:9 主图路径")
+    ap.add_argument("--slug", default="cover")
+    ap.add_argument("--out-dir", required=True)
+    args = ap.parse_args()
+
+    src = Path(args.src)
+    out_dir = Path(args.out_dir)
+    out_dir.mkdir(parents=True, exist_ok=True)
+
+    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
+
+    # 先按 16:9 中央裁一块基准
+    base_ratio = 16 / 9
+    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))
+
+    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})")
+
+
+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("主图 1200×675", (w, h) == (1200, 675), 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()