@topmindspace/tms-skills 0.4.1 → 0.6.0

package/CHANGELOG.md

@@ -1,3 +1,66 @@
+## [0.6.0] - 2026-09-30
+
+> 根包 0.5.0 → **0.6.0**（minor，本轮是功能轮）；技能版本：topmind-cover 0.2.0 → **0.3.0**、
+> topmind-x-article 0.2.0 → **0.3.0**、topmind-wechat-post 保持 0.1.0（无变更）、
+> top-ppt-html 保持 0.2.1（无变更）。
+
+### topmind-cover 0.3.0（X 封面主尺寸改为 5:2）
+
+- X Article 封面主尺寸从 1200×675（16:9）改为 **1500×600（5:2）**：SKILL.md 尺寸表、
+  流程步骤（横构图 5:2）、`scripts/crop-cover.py`、`scripts/negative_tests.py` 全量对齐
+- topmind-x-article README 中英封面引用同步为 `cover-1500x600.png` / 1500×600
+- `assets/examples/` 旧样张仍为 16:9 版，README 已明确标注"旧版、仅供风格参考"，不重制
+
+### topmind-x-article 0.3.0（图片点击放大 lightbox）
+
+- `scripts/md2x-html.py`：正文图与封面预览新增 lightbox——点击放大看原图，
+  支持新标签页打开原图 / 下载原图，Esc / 点背景 / 关闭按钮退出；**不屏蔽右键**
+  （`oncontextmenu` 未添加），放大后可右键另存或直接截图
+- 加固：嵌套代码围栏（四反引号开栏）不会被内部三反引号提前关闭；未闭合围栏文末自动收尾；
+  标题从 frontmatter 之后的首个一级标题提取；图片/封面缺失时干净报错
+- 技能 README 中英补 lightbox 说明
+
+### 文档与元数据
+
+- 根 README 中英：技能表（x-article 0.3.0、cover 0.3.0 + 新描述）、安装器版本 0.6.0、钉版本示例 `@0.6.0`
+- 四技能 README 中英「同 tag」引用全部 → `@topmindspace/tms-skills@0.6.0`
+- `docs/PUBLISHING.md`：当前线（安装器 0.6.0、cover 0.3.0、x-article 0.3.0）与整仓同 tag 示例 v0.6.0
+
+## [0.5.0] - 2026-09-29
+
+> 根包 0.4.1 → **0.5.0**（minor，本轮是功能轮）；技能版本：topmind-x-article 0.1.0 → **0.2.0**、
+> topmind-cover 保持 0.2.0（纯文档新增）、topmind-wechat-post 保持 0.1.0（纯文档）、top-ppt-html 保持 0.2.1（无变更）。
+
+### topmind-x-article 0.2.0（新功能：HTML 一键复制发布链路）
+
+- 新增 `scripts/md2x-html.py`：原稿 → 单文件 HTML（内联样式 + 配图 base64 内嵌 +
+  页顶「一键复制全文」+ 每图 `[图N]` 编号/下载按钮 + 每提示词块「复制提示词」按钮 + 封面仅预览/下载）
+- 按 X 编辑器真实语法重写（v3）：提示词块改 `<blockquote>`（X 不识别粘贴的 `<pre>` 为代码块，
+  原生代码块只能走 Insert 菜单）；`#` 标题不进剪贴板（手动填 X 标题栏）；复制前 JS 自动剥离按钮/UI；
+  GFM 表格转列表（X 粘贴丢弃 `<table>`）；新增有序列表、裸链接转超链接
+- 提示词复制双通道文档：作者侧用 HTML「复制提示词」按钮（发布前取用文本）；
+  读者侧一键复制必须转为 X 原生 Code 块（Insert → Code 手动逐块转换，原生代码块带 native copy button）
+- README 中英重写用法（HTML 首选、txt 兜底）
+
+### topmind-cover（文档，保持 0.2.0）
+
+- 新增 `references/cover-prompts.md`（436 行）：11 风格可直接拷贝的中文提示词手册 +
+  参考图复刻学习区（设计语言拆解 + 学习版提示词 + 原创红线）+ 外部调研
+  （小红书六大高互动类型各 1 条、YouTube 高 CTR 范式、公众号/X 规则，8 个来源链接）+
+  14 种内容类型场景组合推荐表 + 通用负面提示词中英 + 变量速查表
+
+### topmind-wechat-post（文档，保持 0.1.0）
+
+- `references/wechat-constraints.md`：已发布正文不可能保留 JS 复制按钮（JS 被剥离，
+  第三方排版器的复制按钮只存在于其本地预览页）；代码围栏只负责高亮/折行/可读性，
+  不得在正文中承诺「一键复制」；需复制即用走评论区置顶/附件/小程序文档等站外链路
+
+### 文档与元数据
+
+- 根 README 中英：技能表（x-article 0.2.0 + 新描述）、安装器版本 0.5.0、钉版本示例 `@0.5.0`
+- 四技能 README 中英「同 tag」引用全部 → `@topmindspace/tms-skills@0.5.0`
+- `docs/PUBLISHING.md`：当前线（安装器 0.5.0、x-article 0.2.0）与整仓同 tag 示例 v0.5.0
+
 ## [0.4.1] - 2026-09-29
 
 > **本版备发**（tag v0.4.1 待打；npm 待发布；commit = 本轮审计报告落盘时的 `git log` 首条）。

package/README.en.md

@@ -63,10 +63,10 @@ npx @topmindspace/tms-skills install topmind-cover
 |-------|---------|--------------|
 | [`top-ppt-html`](./top-ppt-html/) | **0.2.1** | 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.2.0** | Cover art for X / WeChat: striking, theme-focused; 11-style cover style library + 26 example images (incl. 3 alt samples) + 1 style overview |
+| [`topmind-x-article`](./topmind-x-article/) | **0.3.0** | X long-form one-click publish: Markdown → one-click-copy HTML (images/prompt copy, click-to-zoom images) / plain-text fallback + cover + checklist |
+| [`topmind-cover`](./topmind-cover/) | **0.3.0** | Cover art for X / WeChat (X master 1500×600 / 5:2): striking, theme-focused; 11-style cover style library + 26 example images (incl. 3 alt samples) + 1 style overview |
 
-Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) is **0.4.1** (whole-repo same-tag releases).
+Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) is **0.6.0** (whole-repo same-tag releases).
 
 ## Install
 
@@ -76,7 +76,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.4.1 install top-ppt-html   # pin
+npx @topmindspace/tms-skills@0.6.0 install top-ppt-html   # pin
 npx @topmindspace/tms-skills uninstall top-ppt-html --to ./.claude/skills
 ```
 

package/README.md

@@ -61,10 +61,10 @@ npx @topmindspace/tms-skills install topmind-cover
 |------|------|--------|
 | [`top-ppt-html`](./top-ppt-html/) | **0.2.1** | 正式商务演示：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.2.0** | 文章封面配图（X / 公众号共用）：震撼醒目主题突出；11 风格封面风格库 + 26 张示例图（含 3 张 alt 样张） + 1 张风格总览图 |
+| [`topmind-x-article`](./topmind-x-article/) | **0.3.0** | X 长文一键发布：Markdown 原稿 → 一键复制 HTML（含配图/提示词复制、图片点击放大）/ 纯文本兜底 + 封面图 + 发布清单 |
+| [`topmind-cover`](./topmind-cover/) | **0.3.0** | 文章封面配图（X / 公众号共用，X 主尺寸 1500×600 / 5:2）：震撼醒目主题突出；11 风格封面风格库 + 26 张示例图（含 3 张 alt 样张） + 1 张风格总览图 |
 
-安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 为 **0.4.1**（整仓同 tag 发版）。
+安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 为 **0.6.0**（整仓同 tag 发版）。
 
 > SKILL.md frontmatter 除标准 `name`/`description` 外，本仓库扩展了 `action_category` / `triggers` / `triggers_cn` / `updated` 字段供安装器与路由使用。
 
@@ -76,7 +76,7 @@ npx @topmindspace/tms-skills install topmind-cover
 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.4.1 install top-ppt-html   # 钉版本
+npx @topmindspace/tms-skills@0.6.0 install top-ppt-html   # 钉版本
 npx @topmindspace/tms-skills uninstall top-ppt-html --to ./.claude/skills
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/tms-skills",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "TopMindspace 智能体技能 monorepo — 通过 npm / GitHub npx 安装技能（top-ppt-html：HTML+PPT 双交付，正式商务演示文稿）。",
   "license": "MIT",
   "author": "TopMindspace",

package/top-ppt-html/README.en.md

@@ -10,7 +10,7 @@
 **Let ideas fly — make good thinking visible.** A high-craft skill for **demo reports / formal business presentations**: **HTML + PPT dual delivery** — day-to-day, present with paginated HTML like slides; export **layout-faithful editable PPTX** when needed. **MD3-inspired**: fitting information density, restrained type / shapes / color. Core craft is layout, typography, color, and content structure — not gadget soup.
 
 - Skill id: `top-ppt-html`; brand: **TopPPT HTML**
-- Version: **v0.2.1** (same tag as `@topmindspace/tms-skills@0.4.1`)
+- Version: **v0.2.1** (same tag as `@topmindspace/tms-skills@0.6.0`)
 - **Agent entry**: `SKILL.md` → `references/playbook.md` (L1) → L2 on demand
 - **Human maintainers**: this README (install / commands / layout); do not treat it as the generation spec
 
@@ -55,7 +55,7 @@ Also: arrow-key paging; **Esc** closes modals. After style/theme change, re-run
 
 ```bash
 npx @topmindspace/tms-skills install top-ppt-html
-npx @topmindspace/tms-skills@0.4.1 install top-ppt-html
+npx @topmindspace/tms-skills@0.6.0 install top-ppt-html
 npx github:topmindspace/tms-skills install top-ppt-html
 ```
 

package/top-ppt-html/README.md

@@ -10,7 +10,7 @@
 **让 idea 飞，好想法被看见。** 为**演示报告 / 正式商务演示**而生的高品质演示文稿技能：**HTML + PPT 双交付**——日常用可翻页 HTML 等同幻灯片；需要时再导出**版式保真可编辑 PPTX**。参考 **MD3**：合适信息密度、克制文字/图形/颜色。核心工艺是版式、排版、色彩与内容组织——不是 gadget 堆砌。
 
 - 技能标识：`top-ppt-html`；品牌名：**TopPPT HTML**
-- 版本：**v0.2.1**（与 `@topmindspace/tms-skills@0.4.1` 同 tag）
+- 版本：**v0.2.1**（与 `@topmindspace/tms-skills@0.6.0` 同 tag）
 - **智能体入口**：`SKILL.md` → `references/playbook.md`（L1）→ L2 按需
 - **人类维护者**：本 README（安装 / 命令 / 目录）；勿把本文件当生成规范
 

package/topmind-cover/README.en.md

@@ -4,7 +4,7 @@
 
 A reusable skill for generating cover art for X long-form posts and WeChat articles. Goal: **striking, eye-catching, theme-focused**.
 
-- Version: **v0.2.0** (same tag as `@topmindspace/tms-skills@0.4.1`)
+- Version: **v0.3.0** (same tag as `@topmindspace/tms-skills@0.6.0`)
 
 ## Style gallery
 
@@ -12,7 +12,7 @@ A reusable skill for generating cover art for X long-form posts and WeChat artic
   <img src="https://github.com/topmindspace/tms-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 11 cover-style overview" width="960" />
 </p>
 
-11 styles (clean white / background blur / paper collage / news flash / giant-type manifesto / tutorial steps / minimalist / editorial magazine / viral dry-goods / brand launch / fun IP, light-first ordering): use cases, palette stories, abstract design principles, and Chinese+English prompt recipes in [`references/cover-styles.md`](./references/cover-styles.md); full-size per-style shots in [`assets/examples/`](./assets/examples/).
+11 styles (clean white / background blur / paper collage / news flash / giant-type manifesto / tutorial steps / minimalist / editorial magazine / viral dry-goods / brand launch / fun IP, light-first ordering): use cases, palette stories, abstract design principles, and Chinese+English prompt recipes in [`references/cover-styles.md`](./references/cover-styles.md); full-size per-style shots in [`assets/examples/`](./assets/examples/). Prefer writing your own prompts and sending them straight to an image model (bypassing the skill)? See [`references/cover-prompts.md`](./references/cover-prompts.md) — a copy-paste prompt compendium plus cross-platform viral-cover research.
 
 ## Install
 
@@ -26,20 +26,20 @@ npx @topmindspace/tms-skills install topmind-cover
 1. **Refine the title**: lock the title copy first (usually ≤ 10 chars) using that style's title rules; rewrite until it lands — no drawing yet.
 2. **Composition brief**: one-sentence brief (theme / audience / mood / visual metaphor / palette direction) before composing the prompt.
 3. Input: article title + 3 theme keywords + platform (x / wechat / both, default both).
-4. Generate with the agent's image-generation capability (landscape 16:9, 8% margin on all sides).
+4. Generate with the agent's image-generation capability (landscape 5:2, 8% margin on all sides).
 5. **Impact self-check** (required): pass every item in the [impact self-check list](./SKILL.md#冲击力自检清单); on failure, tweak the prompt and regenerate, max 3 attempts.
 6. Crop and save:
 
 ```bash
 python3 scripts/crop-cover.py <main-image> --out-dir <package>/images/
-# produces 00-封面.png (1200×675) + 00-封面-公众号.png (900×383, center crop)
+# produces 00-封面.png (1500x600) + 00-封面-公众号.png (900x383, center crop)
 ```
 
 ## Sizes
 
 | Platform | Size | Aspect |
 |----------|------|--------|
-| X Article cover | 1200×675 | 16:9 (master image) |
+| X Article cover | 1500x600 | 5:2 (master image) |
 | WeChat cover large image | 900×383 | 2.35:1 (center crop) |
 
 ## Design rules

package/topmind-cover/README.md

@@ -4,7 +4,7 @@
 
 为 X 长文和公众号文章生成封面图的可复用技能。目标：**震撼、醒目、主题突出**。
 
-- 版本：**v0.2.0**（与 `@topmindspace/tms-skills@0.4.1` 同 tag）
+- 版本：**v0.3.0**（与 `@topmindspace/tms-skills@0.6.0` 同 tag）
 
 ## 风格样张
 
@@ -12,7 +12,7 @@
   <img src="https://github.com/topmindspace/tms-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 11 封面风格总览" width="960" />
 </p>
 
-11 种风格（白色清新 / 背景虚化 / 纸感拼贴 / 资讯快报 / 巨字宣言 / 教程步骤 / 极简留白 / 杂志编辑 / 爆款干货 / 品牌发布 / IP 趣味，浅色优先排序）：适用场景、配色故事、抽象设计原则、中英 prompt 配方见 [`references/cover-styles.md`](./references/cover-styles.md)；单风格大图在 [`assets/examples/`](./assets/examples/)。
+11 种风格（白色清新 / 背景虚化 / 纸感拼贴 / 资讯快报 / 巨字宣言 / 教程步骤 / 极简留白 / 杂志编辑 / 爆款干货 / 品牌发布 / IP 趣味，浅色优先排序）：适用场景、配色故事、抽象设计原则、中英 prompt 配方见 [`references/cover-styles.md`](./references/cover-styles.md)；单风格大图在 [`assets/examples/`](./assets/examples/)。想自己写提示词直接给 AI 生图（不走技能流程），看 [`references/cover-prompts.md`](./references/cover-prompts.md)（可直接拷贝的提示词大全 + 全平台爆款流派调研）。
 
 ## 安装
 
@@ -26,20 +26,20 @@ npx @topmindspace/tms-skills install topmind-cover
 1. **标题提炼**：先定标题文案（一般 ≤10 字），用该风格章节的标题写法规范；不满意重写，不先画图。
 2. **构图简报**：一句话 brief（主题/受众/情绪/视觉隐喻/配色方向），组 prompt 前先写。
 3. 输入文章标题 + 3 个主题关键词 + 平台（x / wechat / both，默认 both）。
-4. 用 agent 的图片生成能力出图（横构图 16:9，四周留白 8%）。
+4. 用 agent 的图片生成能力出图（横构图 5:2，四周留白 8%）。
 5. **冲击力自检**（必做）：按 [SKILL.md 冲击力自检清单](./SKILL.md#冲击力自检清单) 逐项过；不通过→调 prompt 重生成，最多 3 次。
 6. 裁剪落盘：
 
 ```bash
 python3 scripts/crop-cover.py <主图> --out-dir <包>/images/
-# 产出 00-封面.png (1200×675) + 00-封面-公众号.png (900×383，中央裁剪)
+# 产出 00-封面.png (1500×600) + 00-封面-公众号.png (900×383，中央裁剪)
 ```
 
 ## 尺寸
 
 | 平台 | 尺寸 | 比例 |
 |------|------|------|
-| X Article 封面 | 1200×675 | 16:9（主图） |
+| X Article 封面 | 1500×600 | 5:2（主图） |
 | 公众号封面大图 | 900×383 | 2.35:1（中央裁） |
 
 ## 设计铁律

package/topmind-cover/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-cover
-version: 0.2.0
+version: 0.3.0
 description: "文章封面配图生成：X 长文与公众号共用。震撼、醒目、主题突出；平台尺寸规范、11 种风格模板、命名落盘、成图检查全流程覆盖。Use when 文章封面、封面图、头图、题图、cover。Do NOT use for 正文插图、PPT/报告封面。"
 action_category: write
 triggers:
@@ -75,10 +75,10 @@ updated: 2026-09-29
 
 | 平台 | 尺寸 | 比例 | 备注 |
 |------|------|------|------|
-| X Article 封面 | 1200×675 | 16:9 | 主尺寸，先按这个生成 |
-| 公众号封面大图 | 900×383 | 2.35:1 | 从 16:9 中央裁剪 |
+| X Article 封面 | 1500×600 | 5:2 | 主尺寸，先按这个生成 |
+| 公众号封面大图 | 900×383 | 2.35:1 | 从 5:2 主图中央裁剪（左右各裁约 3%） |
 
-生成 prompt 里写明"横构图 16:9"；公众号版用 `scripts/crop-cover.py` 从主图中央裁出，不重新生成（保系列一致）。
+生成 prompt 里写明"横构图 5:2"；公众号版用 `scripts/crop-cover.py` 从主图中央裁出，不重新生成（保系列一致）。
 
 ## 工作流
 
@@ -95,7 +95,7 @@ updated: 2026-09-29
    ```bash
    python3 scripts/crop-cover.py <主图> --out-dir <包>/images/
    ```
-   产出 `00-封面.png`（1200×675，X/公众号共用主文件）与 `00-封面-公众号.png`（900×383）。
+   产出 `00-封面.png`（1500×600，X/公众号共用主文件）与 `00-封面-公众号.png`（900×383）。
    公众号包规约：正文引用 `images/00-封面.png`，`图片上传清单.md` 登记两版。
 7. **系列感**：同一系列固定色系 + 版式语言，prompt 复用同一风格模板。
 

package/topmind-cover/assets/examples/README.md

@@ -5,6 +5,8 @@
 另附 `overview.png`（11 宫格总览：3 行 × 4 列缩略图 + 风格名标注，选风格时先看它）。
 
 - `<style>.png`（1200×675，X 长文封面 / 公众号共用主尺寸）
+  > 注：现行主尺寸已改为 1500×600（5:2），见 `../SKILL.md` 尺寸表。
+  > 本目录样张为 16:9 旧版，仅作风格参考，不重制。
 - `<style>-wechat.png`（900×383，公众号封面大图，中央裁剪版）
 - `<style>-alt.png`（1200×675，同风格第二张演示样张；白色清新 / 背景虚化 / 纸感拼贴
   三种新风格各有 2 张：主样张与 alt 样张用了不同的优选组合）

package/topmind-cover/package.json

@@ -1,6 +1,6 @@
 {
   "name": "topmind-cover",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "private": true,
   "description": "文章封面配图生成（X 长文 / 公众号共用）：震撼醒目主题突出，尺寸规范 + 11 种风格模板 + 裁剪落盘。",
   "license": "MIT",