@topmindspace/topmind-writing-skills 0.8.44 → 0.8.45

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## [0.8.45] - 2026-10-18
+
+> 根包 0.8.44 → **0.8.45**（patch）；技能版本：topmind-wechat-post 0.3.15 → 0.3.16、topmind-x-article 0.4.21 → 0.4.22、topmind-revise 0.1.0 → 0.1.1、topmind-briefs 0.2.23 → 0.2.24、topmind-cover 0.4.12 → 0.4.13、topmind-format 0.1.8 → 0.1.9、topmind-viral-posts 0.3.15 → 0.3.16（后四个只是随包共享副本更新）；topmind-poster 0.1.6 不变。
+
+### 新增（长文交付改造：单源 Markdown，HTML 按需）
+
+- 长文改为一个文章文件夹 `<文章名>/`：唯一源稿 `<文章名>.md`（frontmatter 五项 title / date / status / tags / cover，H1 = title = 文件名）、`images/`（按出现顺序编号）、`cover/`、私有 `素材来源.md`、`raw/`、`out/`（派生产物，可随时重建）。默认只交付 Markdown，Obsidian 里直接能看；要 X 版或公众号版时再派生到 `out/`。
+- 新增共享脚本 `article_scaffold.py`（建文章文件夹；文件名安全化、最长 80 字；已存在就报错，不覆盖）和 `check_article.py`（E 级：frontmatter 五项、标题一致、图片存在、编号顺序与出现顺序一致（后出现的图序号反而更小才报）、无 `![[ ]]` / callout / `:::`；W 级：没被引用的图、远程图片、编号不连续或带 11a 这类插入后缀、自制图标注 W18；有 E 退出码 1）。
+- topmind-wechat-post / topmind-x-article 默认组合 topmind-revise：写完先由 revise 执行改稿与质量三关（嵌入模式，完整报告落 `out/改稿报告.md`），HTML / 纯文本只在用户要时生成。
+
+### 变更
+
+- `md2x-html.py`：源稿没有 `[图N]` 时直接按文档顺序读独占一行的 `![]()`（路径相对 md 所在目录，代码块内不动，远程图片跳过并告警），不再需要派生 `X长文.md`；图片下一行的「来源：」渲染成小号灰字图注；`--cover` 缺省读 frontmatter 的 `cover`；`--out` 缺省 `<文章文件夹>/out/X长文.html`；有 `[图N]` 却没给图片来源时直接报错。`--images-from` / `--images` 旧用法保留。
+- `md2x.py`：列表默认 `plain`（「· 」「1）」，二级缩进两格），`--list-style emoji` 可选；`--out` 缺省 `out/X发布稿.txt`。
+- `md2wechat.py`：二级标题有手写序号（「一、」「1.」）时原样保留，不再剥离、不再叠加自动编号，导读用「·」；新增 `--auto-number` 恢复旧行为；`--out-dir` 缺省 `<输入目录>/out`、`--slug` 缺省文件名、`--asset-root` 缺省输入目录；图片后的「来源：」行渲染成图注。
+- wechat-post：`new-article.py` 默认建新结构，`--legacy --slug` 保留旧的 `YYYY-MM-DD-slug/公众号稿.md`；`sync-status.py` / `sync-mapping.py` / `push-to-topstream.py` 新旧结构都认，新结构只改 frontmatter 的 status、不改目录名，旧包的 `-released` 改名逻辑不变；`lint-wechat.py` 对新源稿里的 `:::` 报错（`公众号稿.md` 或 `--legacy` 只告警）；`direction / source_file / target_file / word_count` 改为可选字段。
+- `de_ai_lint.py` 的 W18：图片下一行写了「来源：自制，数据：…」也算标清楚；`audit-provenance.py` 的 `--draft` 可以直接给文章文件夹。
+- 文档：wechat-post / x-article 的 SKILL.md、README 与 references（workflow、typography-rules、element-spec、known-pits、x-html-format、x-format、publish-checklist）换成新文件夹与按需派生；x-article 的「文本派生铁律」「HTML 占位符」「配图错位」三节合并为「派生规则」；`writing-principles.md` 第六节改为「单源、按需派生」。
+- 旧交付包只读兼容，不自动迁移。
+
 ## [0.8.44] - 2026-10-18
 
 > 根包 0.8.43 → **0.8.44**（patch）；技能版本：新增 topmind-revise **0.1.0**；topmind-briefs 0.2.22 → 0.2.23、topmind-cover 0.4.11 → 0.4.12、topmind-format 0.1.7 → 0.1.8、topmind-viral-posts 0.3.14 → 0.3.15、topmind-wechat-post 0.3.14 → 0.3.15、topmind-x-article 0.4.20 → 0.4.21；topmind-poster 0.1.6 不变。

package/README.en.md

@@ -19,7 +19,7 @@
 
 ### topmind-wechat-post · WeChat article authoring
 
-Full lifecycle for WeChat articles: delivery package, review & rewrite, three quality gates (facts / logic / de-AI-flavor), WeChat inline typography (images must be embedded), publish checklist and status sync. Python stdlib only — zero dependencies.
+Full lifecycle for WeChat articles: single-source article folder (`<title>/<title>.md`), review & rewrite, three quality gates (run by topmind-revise by default: facts / logic / de-AI-flavor), WeChat inline typography on request (images must be embedded, output goes to `out/`), publish checklist and status sync. Hand-written heading numbers are kept as written; legacy `公众号稿.md` packages stay readable. Python stdlib only — zero dependencies.
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-wechat-post
@@ -27,7 +27,7 @@ npx @topmindspace/topmind-writing-skills install topmind-wechat-post
 
 ### topmind-x-article · One-click X long-form publishing
 
-Markdown draft → one-click-copy HTML (rich text, images embedded) / plain-text fallback (`md2x.py`: images → `[图N]`, tables → "item: value" lists, lists → emoji bullets because plain-text X does not render Markdown lists) + cover art + publish checklist. Publishing is done by hand-pasting; fetch the text back for verification after posting.
+Delivers one `<title>.md` by default (after topmind-revise); when you want to post on X, derives into `out/` on request: one-click-copy HTML (rich text; reads the source's `![]()` lines and embeds images in order, "来源：" lines become captions) / plain-text fallback (`md2x.py`: images → `[图N]`, tables → "item: value" lists, lists → "·" / "1）" with emoji optional, because plain-text X does not render Markdown lists) + cover art + publish checklist. Publishing is done by hand-pasting; fetch the text back for verification after posting.
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-x-article
@@ -119,7 +119,7 @@ The writing skills share one rule set (`shared/references/`, copied into each sk
 
 Also:
 
-- **Originals first** (`image-sourcing.md`): find official / original-post / third-party images before writing and log sources in a private list inside the delivery package; self-made charts are a fallback and must be labeled 自制 with the data source.
+- **Originals first** (`image-sourcing.md`): find official / original-post / third-party images before writing and log sources in the private `素材来源.md` inside the article folder; self-made charts are a fallback and must be labeled 自制 with the data source.
 - **De-AI pass is mandatory**: rewrite boundaries first (change wording, never facts or certainty); W warnings need a decision rather than a zero count; the regression set `scripts/test_lint_rules.py` keeps normal writing from being flagged. topmind-format reports hits without rewriting.
 - **Fixed revision order** (`revision-workflow.md`): facts → logic → cut redundancy → de-AI → voice check → layout → fidelity check → over-edit check; back up first and report before/after word counts (`count_words.py`). `topmind-revise` runs it when installed.
 
@@ -145,16 +145,16 @@ Every skill ships sample outputs written by us (fictional or neutral topics; no
 
 | Skill | Version | What it does |
 |-------|---------|--------------|
-| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.15** | WeChat article lifecycle: package, review, 3 quality gates, inline typography & publish checklist |
-| [`topmind-x-article`](./topmind-x-article/) | **0.4.21** | 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.4.12** | Cover art for X / WeChat (X master 1500×600 / 5:2): striking, theme-focused; 22-style cover style library + 16:9 X short-post cover scene + 24 title treatments + 7-layer scene recipe + 55 example images (22 styles × 2 sizes + 11 variant samples) + 1 style overview |
-| [`topmind-briefs`](./topmind-briefs/) | **0.2.23** | Short-form briefs (WeChat + X): one topic, one chart; data rankings / paper explainers / product alerts / mechanism explainers; sources → images → content → layout; one copy-ready plain-text X block (no HTML by default, emoji optional, no AI tone), links / images sent separately; asks before generating any image |
-| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.15** | X viral short posts: 18 template types + combinations, duanzi layout (blank lines, no emoji, plain bullet lines), one copy-ready plain-text block per post with hashtags last, links / images sent separately, classification tags listed separately; asks before generating an image |
-| [`topmind-format`](./topmind-format/) | **0.1.8** | X plain-text formatter: to duanzi (blank lines, no emoji) / to short post (paragraphing + sensible lists, emoji optional); layout only, words unchanged, with a fidelity check; one copy-ready plain-text body, links / images sent separately |
-| [`topmind-revise`](./topmind-revise/) | **0.1.0** | Revision and quality check: edit, tighten, de-AI, three quality gates and fidelity audit; four modes (audit / revise / embed / quick); every change maps to a rule code, with an over-edit guard; the long-form skills use it by default |
+| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.16** | WeChat article lifecycle: single-source article folder, review, 3 quality gates (revise by default), inline typography on request & publish checklist |
+| [`topmind-x-article`](./topmind-x-article/) | **0.4.22** | X long-form: single-source Markdown (revise by default) → on-request one-click-copy HTML (images/prompt copy, click-to-zoom images) / plain-text fallback + cover + checklist |
+| [`topmind-cover`](./topmind-cover/) | **0.4.13** | Cover art for X / WeChat (X master 1500×600 / 5:2): striking, theme-focused; 22-style cover style library + 16:9 X short-post cover scene + 24 title treatments + 7-layer scene recipe + 55 example images (22 styles × 2 sizes + 11 variant samples) + 1 style overview |
+| [`topmind-briefs`](./topmind-briefs/) | **0.2.24** | Short-form briefs (WeChat + X): one topic, one chart; data rankings / paper explainers / product alerts / mechanism explainers; sources → images → content → layout; one copy-ready plain-text X block (no HTML by default, emoji optional, no AI tone), links / images sent separately; asks before generating any image |
+| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.16** | X viral short posts: 18 template types + combinations, duanzi layout (blank lines, no emoji, plain bullet lines), one copy-ready plain-text block per post with hashtags last, links / images sent separately, classification tags listed separately; asks before generating an image |
+| [`topmind-format`](./topmind-format/) | **0.1.9** | X plain-text formatter: to duanzi (blank lines, no emoji) / to short post (paragraphing + sensible lists, emoji optional); layout only, words unchanged, with a fidelity check; one copy-ready plain-text body, links / images sent separately |
+| [`topmind-revise`](./topmind-revise/) | **0.1.1** | Revision and quality check: edit, tighten, de-AI, three quality gates and fidelity audit; four modes (audit / revise / embed / quick); every change maps to a rule code, with an over-edit guard; the long-form skills use it by default |
 | [`topmind-poster`](./topmind-poster/) | **0.1.6** | HTML+CSS → high-res long image / poster / infographic PNG: headless Chrome 2× screenshot + auto-trim; "one image per section" batch workflow (generator + renderer) |
 
-Installer [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) is **0.8.44** (whole-repo same-tag releases).
+Installer [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) is **0.8.45** (whole-repo same-tag releases).
 
 ### Which skill, and how they combine
 

package/README.md

@@ -17,7 +17,7 @@
 
 ### topmind-wechat-post · 公众号创作
 
-公众号文章全生命周期：交付包、审校改写、质量三关（事实 / 逻辑 / 去 AI 味）、微信内联排版（图片必内嵌）、发布清单与状态同步。脚本纯 Python 标准库，零依赖。
+公众号文章全生命周期：单源文章文件夹（`<文章名>/<文章名>.md`）、审校改写、质量三关（默认组合 topmind-revise：事实 / 逻辑 / 去 AI 味）、按需出微信内联排版（图片必内嵌，产物进 `out/`）、发布清单与状态同步。手写小标题序号原样保留；旧 `公众号稿.md` 交付包只读兼容。脚本纯 Python 标准库，零依赖。
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-wechat-post
@@ -25,7 +25,7 @@ npx @topmindspace/topmind-writing-skills install topmind-wechat-post
 
 ### topmind-x-article · X 长文一键发布
 
-Markdown 原稿 → 一键复制 HTML（富文本，配图内嵌）/ 纯文本兜底（`md2x.py`：图片→`[图N]`、表格→"项：值"列表、列表→emoji 项目符号，因为 X 纯文本不渲染 Markdown 列表）+ 封面图 + 发布清单。发布走人工粘贴，发布后抓回核对。
+默认交付一份 `<文章名>.md`（先过 topmind-revise）；要发 X 时再按需派生到 `out/`：一键复制 HTML（富文本，直接读源稿的 `![]()` 按顺序内嵌配图，「来源：」行成图注）/ 纯文本兜底（`md2x.py`：图片→`[图N]`、表格→"项：值"列表、列表→「·」「1）」，emoji 可选，因为 X 纯文本不渲染 Markdown 列表）+ 封面图 + 发布清单。发布走人工粘贴，发布后抓回核对。
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-x-article
@@ -119,7 +119,7 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 
 另外：
 
-- **原图优先**（`image-sourcing.md`）：写字之前先找官方 / 原帖 / 第三方原图，来源记进交付包里的私有信源清单；自制图只作兜底，标「自制」和数据来源。
+- **原图优先**（`image-sourcing.md`）：写字之前先找官方 / 原帖 / 第三方原图，来源记进文章文件夹里的私有 `素材来源.md`；自制图只作兜底，标「自制」和数据来源。
 - **去 AI 味必过**：先守改写边界（只改表达，不改事实和确定性）；W 警告不要求清零，要求每条有结论；规则回归测试 `scripts/test_lint_rules.py` 守住「不应报」的正常写法。topmind-format 只报告命中、不改字。
 - **固定改稿流程**（`revision-workflow.md`）：事实 → 逻辑 → 删冗余 → 去 AI 味 → 核心经验对照 → 排版 → 保真审计 → 过度改稿检查；每轮先备份，报改前 / 改后字数（`count_words.py`）。装了 `topmind-revise` 就由它执行。
 
@@ -145,16 +145,16 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 
 | 技能 | 版本 | 做什么 |
 |------|------|--------|
-| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.15** | 公众号文章全生命周期：交付包、审校改写、质量三关、微信内联排版与发布清单 |
-| [`topmind-x-article`](./topmind-x-article/) | **0.4.21** | X 长文一键发布：Markdown 原稿 → 一键复制 HTML（含配图/提示词复制、图片点击放大）/ 纯文本兜底 + 封面图 + 发布清单 |
-| [`topmind-cover`](./topmind-cover/) | **0.4.12** | 文章封面配图（X / 公众号共用，X 主尺寸 1500×600 / 5:2）：震撼醒目主题突出；22 种封面风格库 + X 短文 16:9 封面场景 + 24 种标题花式 + 七层场景配方 + 55 张示例图（22 种风格 × 2 尺寸 + 11 张变体样张） + 1 张风格总览图 |
-| [`topmind-briefs`](./topmind-briefs/) | **0.2.23** | 干货短文（公众号 + X 双平台）：一件事讲透，数据榜单/论文解读/新品速递；信源 → 原图 → 内容 → 排版；X 版交付一段可复制纯文本（默认不出 HTML，emoji 可选，去 AI 味），链接 / 原图 / 配图另发，无原图先询问配图 |
-| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.15** | X 引流段子/爆款短篇：18 大类型模板 + 组合玩法，段子体（行间空行，零 emoji，分点不加符号）、每条一段可复制纯文本、话题标签在末行，链接 / 原图另发、分类标签另列；无原图先询问再走 topmind-cover |
-| [`topmind-format`](./topmind-format/) | **0.1.8** | X 纯文本格式化：转段子（行间空行，零 emoji）/ 格式化成短文（分段 + 合理列表，emoji 可选），只动排版不改字，带原文保真校验；交付一段可复制纯文本，链接 / 原图另发 |
-| [`topmind-revise`](./topmind-revise/) | **0.1.0** | 改稿与质检：改稿、精简、去 AI 味、质量三关与保真审计；四种模式（只审不改 / 改稿 / 嵌入 / 快审），每处改动对应规则编号，防过度改稿；长文技能默认组合 |
+| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.16** | 公众号文章全生命周期：单源文章文件夹、审校改写、质量三关（默认组合 revise）、按需出微信内联排版与发布清单 |
+| [`topmind-x-article`](./topmind-x-article/) | **0.4.22** | X 长文：单源 Markdown（默认组合 revise）→ 按需出一键复制 HTML（含配图/提示词复制、图片点击放大）/ 纯文本兜底 + 封面图 + 发布清单 |
+| [`topmind-cover`](./topmind-cover/) | **0.4.13** | 文章封面配图（X / 公众号共用，X 主尺寸 1500×600 / 5:2）：震撼醒目主题突出；22 种封面风格库 + X 短文 16:9 封面场景 + 24 种标题花式 + 七层场景配方 + 55 张示例图（22 种风格 × 2 尺寸 + 11 张变体样张） + 1 张风格总览图 |
+| [`topmind-briefs`](./topmind-briefs/) | **0.2.24** | 干货短文（公众号 + X 双平台）：一件事讲透，数据榜单/论文解读/新品速递；信源 → 原图 → 内容 → 排版；X 版交付一段可复制纯文本（默认不出 HTML，emoji 可选，去 AI 味），链接 / 原图 / 配图另发，无原图先询问配图 |
+| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.16** | X 引流段子/爆款短篇：18 大类型模板 + 组合玩法，段子体（行间空行，零 emoji，分点不加符号）、每条一段可复制纯文本、话题标签在末行，链接 / 原图另发、分类标签另列；无原图先询问再走 topmind-cover |
+| [`topmind-format`](./topmind-format/) | **0.1.9** | X 纯文本格式化：转段子（行间空行，零 emoji）/ 格式化成短文（分段 + 合理列表，emoji 可选），只动排版不改字，带原文保真校验；交付一段可复制纯文本，链接 / 原图另发 |
+| [`topmind-revise`](./topmind-revise/) | **0.1.1** | 改稿与质检：改稿、精简、去 AI 味、质量三关与保真审计；四种模式（只审不改 / 改稿 / 嵌入 / 快审），每处改动对应规则编号，防过度改稿；长文技能默认组合 |
 | [`topmind-poster`](./topmind-poster/) | **0.1.6** | HTML+CSS → 高清长图 / 海报 / 信息图 PNG：无头 Chrome 2× 截图 + 自动裁白；「一段一图」分段图批量出图（生成器 + 渲染器） |
 
-安装器 [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) 为 **0.8.44**（整仓同 tag 发版）。
+安装器 [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) 为 **0.8.45**（整仓同 tag 发版）。
 
 ### 怎么选、怎么组合
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/topmind-writing-skills",
-  "version": "0.8.44",
+  "version": "0.8.45",
   "description": "TopMindSpace 写作技能合集 — 通过 npm / npx 安装技能（公众号长文、X 长文、干货短文、X 引流短帖、改稿与质检、封面图、长图海报）。只出稿与发布包，不代发。",
   "license": "MIT",
   "author": "TopMindspace",

package/topmind-briefs/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.24 (2026-10-18)
+
+- 随包共享脚本更新：`md2x-html.py` 能直接读源稿的 `![]()` 按顺序嵌图、「来源：」行渲染成图注、`--out` 缺省 `out/X长文.html`（原有 `--images-from` 用法不变）；`md2wechat.py` 默认保留手写小标题序号（`--auto-number` 恢复旧行为），`--out-dir` / `--slug` 有缺省值
+- `de_ai_lint.py` 的 W18：图片下一行写了「来源：自制，数据：…」也算标清楚
+
 ## 0.2.23 (2026-10-18)
 
 - 写法规则改为引用共享的 `core-voice.md`：首行一句话题陈述、事实讲完就停（去掉收尾句）、列表默认「·」、话题标签默认 2 个；引语正文写「人名：中文意思」；未完全确认的热点首行用一次「？！」，不写泛泛的「据报道」

package/topmind-briefs/README.en.md

@@ -7,7 +7,7 @@ A brief is not a long-form article — **no HTML by default**: the workflow is v
 The X version is one copy-ready plain-text block (emoji optional); **links (including sources), original images and any generated images are sent separately**, never mixed into the body.
 The WeChat version is ~300–800 Chinese characters of Markdown. With no original image it asks before generating one.
 
-- Version: **v0.2.23** (ships with `@topmindspace/topmind-writing-skills@0.8.44`)
+- Version: **v0.2.24** (ships with `@topmindspace/topmind-writing-skills@0.8.45`)
 
 ## Install
 

package/topmind-briefs/README.md

@@ -7,7 +7,7 @@
 X 版交付一段可直接复制的纯文本（emoji 可选），**链接（含来源）、原图、配图另发**，不和正文混在一起；公众号版约 300–800 字 Markdown。
 没有原图时先问要不要配图（`topmind-cover`）；链接那一条写明来源名称、发布时间与 URL。
 
-- 版本：**v0.2.23**（随 `@topmindspace/topmind-writing-skills@0.8.44` 发布）
+- 版本：**v0.2.24**（随 `@topmindspace/topmind-writing-skills@0.8.45` 发布）
 
 ## 安装
 

package/topmind-briefs/SKILL.md

@@ -3,7 +3,7 @@ name: topmind-briefs
 description: "干货短文：一件事讲透，X + 公众号双平台。短文不是长文——默认不出 HTML：工作流按「核实一手信源 → 找原帖原图 → 写内容 → 排版」；X 版交付一段可直接复制的纯文本（首行一句话题陈述、合理分段与列表、去 AI 味、emoji 可选且只用 TopMind 体系、末行默认 2 个话题标签），链接（含来源）、原图（1–2 张）、配图另发，绝不混进正文；公众号版是 300–800 字 Markdown；没有原图时主动询问是否配图，不擅自生图。尊重原始信息、原图、原文。只交付不代发。Use when 写短文、公众号短文、X 短文、发快讯、简讯、速报、数据榜单、榜单速报、论文解读、新品速递、来篇短的、短平快、brief；信息密度型（数据、榜单、发布）走本技能。Do NOT use for 把现成文字格式化、转段子、排版（→ topmind-format）、X 长文与发 X 文章（→ topmind-x-article）、公众号长文与公众号排版 HTML（→ topmind-wechat-post）、引流互动型短帖、段子、涨粉帖、互关帖、爆款短篇（→ topmind-viral-posts）、单独出长图/海报/信息图 PNG（→ topmind-poster）、封面与头图（→ topmind-cover）、单独改稿、去 AI 味与质检（→ topmind-revise）、把稿子发出去（→ topmind-x，须用户确认）。"
 license: MIT
 metadata:
-  version: "0.2.23"
+  version: "0.2.24"
   action_category: "write"
   triggers: "写短文, 公众号短文, X 短文, 发快讯, 快讯, 简讯, 速报, 干货短文, 论文解读, 数据榜单, 榜单速报, 新品速递, brief, 来篇短的, 短平快, 发个快讯"
   author: "TopMindSpace"

package/topmind-briefs/package.json

@@ -9,5 +9,5 @@
     "type": "git",
     "url": "git+https://github.com/topmindspace/topmind-writing-skills.git"
   },
-  "version": "0.2.23"
+  "version": "0.2.24"
 }

package/topmind-briefs/references/image-sourcing.md

@@ -13,7 +13,7 @@
 ## 二、自制图规则
 
 - 图内或图注写明「自制」和数据来源，例如「自制，数据：xx 官方 2026-09」。
-- 公众号稿 / X长文.md 的图片行写成 `![自制，数据：xx](images/NN-xx.png)`；`lint_x_post.py --md` / `--long` 会对没标清的自制图报 W18。
+- 长文源稿 `<文章名>.md` 的自制图写成 `![自制，数据：xx](images/NN-xx.png)`，或在图片下一行写「来源：自制，数据：xx」；`lint_x_post.py --md` / `--long` 会对没标清的自制图报 W18。
 - 不用 AI 生成的图冒充原图或数据图；示意图标「示意」。
 
 ## 三、私有信源清单（不进公开仓库）

package/topmind-briefs/references/writing-principles.md

@@ -33,7 +33,7 @@
 > 能用可视化传达的，不用文字啰嗦。这是 X 和公众号共同的内容要求。
 
 1. **表格 > 段落**：对比类内容用简单表格，不写大段文字。
-2. **列表 > 段落**：并列要点用列表，不写成长段。公众号稿用 Markdown 列表；X 纯文本帖不渲染 Markdown，用 emoji 项目符号（🔹 / 1️⃣，规则见 `x-post-format.md`）。
+2. **列表 > 段落**：并列要点用列表，不写成长段。长文源稿用 Markdown 列表；X 纯文本帖不渲染 Markdown，默认用「·」「1）」，emoji 项目符号可选（规则见 `x-post-format.md`）。
 3. **"概要 + 列表"**：信息密集的节，先给一句概要（这节的结论），再用列表展开论据。
    不写长段论述；非写不可的长段，拆成多个短段或转成"概要+列表"。
 4. **图表 > 描述**：数据趋势用图表，图片用素材原图。
@@ -165,7 +165,8 @@ AI 味多数来自句式，不是单个词。下面每一类都给出改法，
 > 以下为 topmind 工作区默认规约；其他用户可通过环境变量或 CLI 参数覆盖，
 > 技能本身不强制依赖特定目录结构。
 
-1. **目录规约（默认）**：公众号+X 创作包放在工作区的长文类专题下（按类别**名称**找「长文」，
+1. **目录规约（默认）**：一篇长文一个文章文件夹 `<文章名>/`，里面只有一份源稿 `<文章名>.md`
+   （外加 `images/`、`cover/`、`素材来源.md`、`raw/`、`out/`），放在工作区的长文类专题下（按类别**名称**找「长文」，
    兼容旧名「创作」「专题」；专题默认 `{当年}-公众号`），正式稿 HTML 交付到 role:delivery 类别
    （以工作区 `topmind.yaml` 的实际目录为准，例如 `88-输出/`）。编号与年份不写死。
    覆盖方式：`--base` 参数 > `TOPMIND_WECHAT_BASE` > `TOPMIND_WORKSPACE`（按名称发现类别）；
@@ -173,7 +174,10 @@ AI 味多数来自句式，不是单个词。下面每一类都给出改法，
 2. **云端备份**：所有文章创作结果默认在云端工作区按规约格式目录备份存档，
    方便找回/暂存。
 3. **封面默认 2 版**：每篇长文默认提供至少 2 版不同风格 cover 供用户选择。
-4. **双平台同步**：默认 X + 公众号双版，不分长短文。
+4. **单源、按需派生**：长文默认只交付一份 Markdown（`<文章名>.md`，Obsidian 里直接能看）；
+   用户要哪个平台的版本，再从它派生到 `out/`（X 长文 HTML / 纯文本 → `topmind-x-article`，
+   公众号 HTML → `topmind-wechat-post`）。`out/` 是生成文件，不手改；改稿永远只改源稿，改完重新派生。
+   短文、段子、回复不变：一段可复制纯文本，链接、原图另发。旧的「公众号稿 + 派生 X 稿」交付包只读兼容。
 
 ## 七、研究深度要求（用户给定主题）
 

package/topmind-briefs/scripts/de_ai_lint.py

@@ -290,8 +290,15 @@ def image_label_hits(lines: list[str], start: int):
         if not m:
             continue
         alt, path = m.group(1), m.group(2)
-        if SELFMADE_HINT_RE.search(alt + " " + path) and not (SELFMADE_HINT_RE.search(alt) and SOURCE_HINT_RE.search(alt)):
-            out.append((start + off, "W18", "自制图没标清楚：图注（alt）里写「自制」和数据来源，例如「自制，数据：xx 官方」"))
+        # 新结构里出处写在图片下一行（可隔一个空行）的「来源：」，也算图注
+        nxt = ""
+        for k in (off + 1, off + 2):
+            if k < len(lines) and lines[k].strip():
+                nxt = lines[k].strip() if re.match(r"^来源[：:]", lines[k].strip()) else ""
+                break
+        label = alt + " " + nxt
+        if SELFMADE_HINT_RE.search(alt + " " + path) and not (SELFMADE_HINT_RE.search(label) and (SOURCE_HINT_RE.search(alt) or nxt)):
+            out.append((start + off, "W18", "自制图没标清楚：图注（alt）或下一行「来源：」里写「自制」和数据来源，例如「来源：自制，数据：xx 官方」"))
     return out
 
 

package/topmind-briefs/scripts/md2wechat.py

@@ -14,9 +14,16 @@ Supported beyond CommonMark:
   - four heading-2 style variants
 
 Usage:
+    python3 md2wechat.py --input <文章名>/<文章名>.md --embed-images
+        # 文章文件夹结构：--out-dir 缺省 <文章名>/out，--slug 缺省文件名，
+        # --asset-root 缺省文章文件夹
     python3 md2wechat.py --input 稿.md --out-dir 交付包 --slug foo \
         --asset-root /path/to/repo [--theme theme.json] [--link-mode footnote] \
-        [--embed-images]
+        [--embed-images] [--auto-number]
+
+Headings: 二级标题写了「一、」「1.」这类手写序号就原样保留，不再自动编号；
+都没写时按主题样式自动编号。--auto-number 恢复旧行为（剥离手写序号后统一编号）。
+Images: 图片后紧跟（或隔一个空行）的「来源：……」行渲染成图注样式。
 
 Outputs:
     <out-dir>/<slug>-公众号版.html   full page, copy body section into WeChat
@@ -581,13 +588,16 @@ def match_img_only(line):
         return None
     return line[2:k], src
 CAPTION_RE = re.compile(r"^\*(.+)\*\s*$")
+# 图片后紧跟的「来源：」行渲染成图注（core-voice V14）；中间最多隔一个空行
+SOURCE_RE = re.compile(r"^(来源[：:].+)$")
 TABLE_SEP_RE = re.compile(r"^\|?[\s:|-]+\|[\s:|-]*$")
 CONTAINER_RE = re.compile(r"^:::+\s*(\w+)?\s*(.*)$")
 
 CN_NUM = "一二三四五六七八九十壹贰叁肆伍陆柒捌玖拾"
 
-# 标题里手写的中文/阿拉伯序号。序号应由排版层生成（可换样式、可加引用），
-# 写进标题文本后就变成了不可编程的字符串。这里统一剥离后重新编号。
+# 标题里手写的中文/阿拉伯序号。默认：稿子里的二级标题带手写序号（「一、」「1.」）就原样保留，
+# 排版层不再自动编号；二级标题都没写序号时才按主题样式自动编号。--auto-number 恢复旧行为：
+# 一律剥离手写序号后由排版层重新编号。
 # 注意：\d{1,2}[、.．](?!\d) 带负向断言，避免把「3.4× 成本」这类
 # 以数字开头的标题误剥成「4× 成本」。
 HAND_NUM_RE = re.compile(
@@ -625,6 +635,16 @@ def para_style(theme):
             % (theme["para_gap"], theme["line_height"], theme["align"]))
 
 
+def keep_hand_num(theme):
+    return bool(theme.get("_keep_hand_num"))
+
+
+def detect_hand_numbers(lines):
+    """二级标题里有没有手写序号（「一、」「1.」「第一章」）。"""
+    return any(HAND_NUM_RE.match(l.strip()[3:].strip())
+               for l in lines if l.strip().startswith("## "))
+
+
 def render_heading(level, text, theme, index=None):
     accent = theme["accent"]
     if level == 1:
@@ -633,12 +653,18 @@ def render_heading(level, text, theme, index=None):
         return ('<p style="font-size:20px;font-weight:700;color:%s;'
                 'text-align:center;margin:0 0 18px;line-height:1.5;'
                 'letter-spacing:0.5px;">%s</p>'
-                % (theme["text_strong"], render_inline(HAND_NUM_RE.sub("", text).strip() or text)))
+                % (theme["text_strong"], render_inline(text.strip() if keep_hand_num(theme)
+                                                       else (HAND_NUM_RE.sub("", text).strip() or text))))
 
     if level == 2:
         style = theme.get("h2_style", "number")
-        # 先剥离手写序号，再按主题样式决定是否由排版层补编号
-        plain = HAND_NUM_RE.sub("", text).strip() or text.strip()
+        if keep_hand_num(theme):
+            # 保留手写序号：标题原样输出，不再补排版层编号
+            plain = text.strip()
+            index = None
+        else:
+            # 先剥离手写序号，再按主题样式决定是否由排版层补编号
+            plain = HAND_NUM_RE.sub("", text).strip() or text.strip()
         t = render_inline(plain)
         num = ""
         if "number" in style and index:
@@ -672,7 +698,8 @@ def render_heading(level, text, theme, index=None):
                 % (theme["text_strong"], accent, num, t))
 
     if level == 3:
-        t = render_inline(HAND_NUM_RE.sub("", text).strip() or text)
+        t = render_inline(text.strip() if keep_hand_num(theme)
+                          else (HAND_NUM_RE.sub("", text).strip() or text))
         return ('<h3 style="font-size:16px;font-weight:600;color:%s;'
                 'margin:26px 0 12px;line-height:1.5;">%s</h3>'
                 % (theme["text_strong"], t))
@@ -878,12 +905,18 @@ def render_hr(theme):
             'margin:0 auto;"></section></section>' % theme["accent"])
 
 
-def render_figure(src, caption, theme, alt=""):
+def render_figure(src, caption, theme, alt="", source=None):
     cap = ""
     if caption:
         cap = ('<p style="font-size:13px;color:%s;text-align:center;'
                'margin:9px 0 %s;line-height:1.6;">%s</p>'
-               % (theme["text_light"], theme["para_gap"], render_inline(caption)))
+               % (theme["text_light"], "4px" if source else theme["para_gap"], render_inline(caption)))
+    if source:
+        cap += ('<p style="font-size:12px;color:%s;text-align:center;'
+                'margin:%s 0 %s;line-height:1.6;">%s</p>'
+                % (theme["text_light"], "0" if caption else "9px", theme["para_gap"],
+                   render_inline(source)))
+        caption = caption or source
     border = ""  # MD3 优雅：图片无边框，只保留圆角
     altattr = ' alt="%s"' % esc(alt) if alt else ""
     # 图片一律 max-width:100%，绝不用 width:100%：正文容器约 677px，
@@ -1093,7 +1126,9 @@ def convert_blocks(lines, md_path, out_dir, theme, ctx):
     toc_at = None  # 导读落点：首个正文段落之后
 
     # 预扫描：末章是否为收束类，决定它的编号用数字还是 ∞
-    h2_texts = [HAND_NUM_RE.sub("", l.strip()[3:]).strip() or l.strip()[3:].strip()
+    keep = keep_hand_num(theme)
+    h2_texts = [(l.strip()[3:].strip() if keep else
+                 (HAND_NUM_RE.sub("", l.strip()[3:]).strip() or l.strip()[3:].strip()))
                 for l in lines if l.strip().startswith("## ")]
     h2_total = len(h2_texts)
     last_is_summary = bool(h2_total) and bool(SUMMARY_H2_RE.match(h2_texts[-1]))
@@ -1144,8 +1179,8 @@ def convert_blocks(lines, md_path, out_dir, theme, ctx):
             marker = h2_index
             if level == 2:
                 h2_index += 1
-                h2_titles.append(HAND_NUM_RE.sub("", m.group(2)).strip()
-                                 or m.group(2).strip())
+                h2_titles.append(m.group(2).strip() if keep else
+                                 (HAND_NUM_RE.sub("", m.group(2)).strip() or m.group(2).strip()))
                 marker = ("∞" if (last_is_summary and h2_index == h2_total)
                           else h2_index)
             out.append(render_heading(level, m.group(2).strip(), theme, marker))
@@ -1199,14 +1234,24 @@ def convert_blocks(lines, md_path, out_dir, theme, ctx):
         m = match_img_only(stripped)
         if m:
             caption = None
+            source = None
             if i + 1 < n:
                 cm = CAPTION_RE.match(lines[i + 1].strip())
                 if cm:
                     caption = cm.group(1)
                     i += 1
+            # 「来源：」行（紧跟或隔一个空行）→ 图注样式
+            j = i + 1
+            if j < n and not lines[j].strip() and j + 1 < n:
+                j += 1
+            if j < n:
+                sm = SOURCE_RE.match(lines[j].strip())
+                if sm:
+                    source = sm.group(1)
+                    i = j
             src = resolve_image(m[1], md_path, out_dir,
                                 ctx["assets"], ctx["asset_root"])
-            out.append(render_figure(src, caption, theme, alt=m[0]))
+            out.append(render_figure(src, caption, theme, alt=m[0], source=source))
             i += 1
             continue
 
@@ -1243,8 +1288,10 @@ def convert_blocks(lines, md_path, out_dir, theme, ctx):
 
 def convert(md_text, md_path, out_dir, theme, link_mode="footnote",
             render_mermaid=False, asset_root=None, use_pangu=True,
-            toc=True, sign_mode="auto", author="", author_bio=""):
+            toc=True, sign_mode="auto", author="", author_bio="", auto_number=False):
     lines = strip_frontmatter(md_text.split("\n"))
+    theme = dict(theme)
+    theme["_keep_hand_num"] = (not auto_number) and detect_hand_numbers(lines)
     han_chars = sum(len(HAN_RE.findall(l)) for l in lines)
     ctx = {"assets": [], "diagrams": [], "footnotes": [],
            "render_mermaid": render_mermaid, "asset_root": asset_root,
@@ -1320,7 +1367,7 @@ def render_toc(titles, theme):
     # 导读的标记必须跟正文标题一致：
     #  - 标题带编号（h2_style 含 number）→ 导读也用编号；末章收束类用 ∞，避免「导读 04 / 正文 ∞」
     #  - 标题不带编号（center/underline/plain）→ 导读只用中性圆点，不要凭空造出 01/02
-    numbered = "number" in theme.get("h2_style", "number")
+    numbered = "number" in theme.get("h2_style", "number") and not keep_hand_num(theme)
     last_summary = bool(titles) and bool(SUMMARY_H2_RE.match(titles[-1]))
 
     def label(k):
@@ -1696,6 +1743,9 @@ def main():
     ap.add_argument("--author", default="",
                     help="签名区署名；留空则不输出署名行（不再写 {{作者名}} 占位）")
     ap.add_argument("--author-bio", default="", help="签名区一句话简介")
+    ap.add_argument("--auto-number", action="store_true",
+                    help="二级标题一律剥离手写序号、由排版层重新编号（旧行为）；"
+                         "默认：稿里写了「一、」这类序号就原样保留")
     args = ap.parse_args()
 
     if args.list_themes:
@@ -1704,10 +1754,17 @@ def main():
                                            "、".join(t["genre"]) or "（未声明题材）"))
         return
 
-    missing = [n for n, v in (("--input", args.input), ("--out-dir", args.out_dir),
-                              ("--slug", args.slug)) if not v]
-    if missing:
-        sys.exit("缺少必填参数：%s" % "、".join(missing))
+    if not args.input:
+        sys.exit("缺少必填参数：--input")
+    # 文章文件夹结构（<文章名>/<文章名>.md）：--out-dir 缺省 <文章文件夹>/out，
+    # --slug 缺省为文件名，--asset-root 缺省为文章文件夹
+    in_dir = os.path.dirname(os.path.abspath(args.input))
+    if not args.out_dir:
+        args.out_dir = os.path.join(in_dir, "out")
+    if not args.slug:
+        args.slug = os.path.splitext(os.path.basename(args.input))[0]
+    if not args.asset_root:
+        args.asset_root = in_dir
 
     if os.path.isdir(args.input):
         sys.exit("错误：输入是目录不是文件 %s" % args.input)
@@ -1733,6 +1790,7 @@ def main():
         not args.no_pangu,
         toc=not args.no_toc, sign_mode=args.signature,
         author=args.author, author_bio=args.author_bio,
+        auto_number=args.auto_number,
     )
 
     title = args.title

package/topmind-briefs/scripts/md2x-html.py

@@ -2,10 +2,16 @@
 """md2x-html.py — Markdown 原稿 → 可直接复制的 X 长文 HTML（单文件）。
 
 用法：
-    python3 md2x-html.py 原稿.md --out X长文.html \\
-        --images 样张1.png 样张2.png ... [--cover cover-1500x600.png]
+    python3 md2x-html.py <文章名>/<文章名>.md
+        # 文章文件夹结构：直接读源稿里的 ![说明](images/xx.png)，按文档顺序嵌图；
+        # --out 缺省 <文章名>/out/X长文.html，--cover 缺省读 frontmatter 的 cover
+    python3 md2x-html.py X长文.md --out X长文.html --images-from 公众号稿.md   # 旧结构
+    python3 md2x-html.py 原稿.md --out X长文.html --images 1.png 2.png [--cover c.png]
 
 约定（与 md2x.py 对齐）：
+- 源稿没有 `[图N]`、只有独占一行的 `![说明](本地路径)` 时，按文档顺序直接取图（路径相对 md 所在目录），
+  内部换成 `[图N]`，不需要再派生 X长文.md；远程图片无法内嵌，跳过并告警
+- 图片后紧跟（或隔一个空行）的「来源：……」行渲染成小号灰字图注，复制时作为一段文字保留
 - `[图N]` 独占一行 → 按顺序取 --images[N-1]，转成内嵌 data-URI 的 <figure>；
   点击图片弹出 lightbox 放大查看原图（右键可另存/截图，不拦截右键菜单）
 - ``` 围栏代码块（直出提示词）→ <blockquote> + 「复制提示词」按钮。
@@ -78,6 +84,7 @@ body { margin: 0; background: #f7f9fa; color: #0f1419;
 figure.ximg { margin: 22px 0; }
 figure.ximg img { width: 100%; border-radius: 10px; display: block;
                  border: 1px solid #eff3f4; cursor: zoom-in; }
+.article p.src { font-size: 13px; line-height: 1.6; color: #536471; margin: -12px 0 18px; }
 figure.ximg figcaption { display: flex; justify-content: space-between; align-items: center;
                         margin-top: 8px; font-size: 13px; color: #536471; }
 .prompt { position: relative; margin: 14px 0 20px; }
@@ -341,6 +348,51 @@ def inline_md(s):
     return s
 
 
+IMG_LINE_RE = re.compile(r"^\s*!\[([^\]]*)\]\(([^)\s]+)(?:\s+\"[^\"]*\")?\)\s*$")
+
+
+def inline_images(md_text, base):
+    """把独占一行的 ![说明](本地路径) 换成 [图N]，返回 (新文本, 图片绝对路径列表)。
+
+    围栏代码块里的行不动；远程图片无法内嵌，换成一行「（远程图片：url）」并告警。"""
+    out, images, fence = [], [], None
+    for line in md_text.split("\n"):
+        st = line.strip()
+        fm = re.match(r"^(`{3,})", st)
+        if fm:
+            if fence is None:
+                fence = fm.group(1)
+            elif len(fm.group(1)) >= len(fence) and st.strip("`") == "":
+                fence = None
+            out.append(line)
+            continue
+        m = IMG_LINE_RE.match(line) if fence is None else None
+        if not m:
+            out.append(line)
+            continue
+        src = m.group(2)
+        if re.match(r"https?://", src):
+            print("警告：跳过远程图片（无法内嵌）：%s" % src, file=sys.stderr)
+            out.append("（远程图片：%s）" % src)
+            continue
+        images.append(src if os.path.isabs(src) else os.path.normpath(os.path.join(base, src)))
+        out.append("[图%d]" % len(images))
+    return "\n".join(out), images
+
+
+def frontmatter_value(md_text, key):
+    lines = md_text.split("\n")
+    if not lines or lines[0].strip() != "---":
+        return None
+    for ln in lines[1:]:
+        if ln.strip() == "---":
+            break
+        m = re.match(r"^%s:\s*(.+?)\s*$" % re.escape(key), ln)
+        if m:
+            return m.group(1).strip().strip("\"'")
+    return None
+
+
 def md_to_html(md_text, images, cover):
     lines = md_text.split("\n")
     out = []
@@ -510,6 +562,11 @@ def md_to_html(md_text, images, cover):
             continue
 
         close_lists()
+        # 图片后的「来源：」行 → 小号灰字图注（上一个输出块是图片时）
+        if re.match(r"^来源[：:]", s) and out and out[-1].startswith('<figure class="ximg"'):
+            out.append('<p class="src">%s</p>' % inline_md(s))
+            i += 1
+            continue
         # 保留行首缩进（X 稿里用 emoji 项目符号表示二级条目时需要缩进）：
         # 行首 ≥2 个空格 / 全角空格转成 &nbsp;，避免 HTML 把缩进吞掉
         lead = len(line) - len(line.lstrip(" \u3000"))
@@ -541,14 +598,15 @@ def md_to_html(md_text, images, cover):
 
 def main():
     ap = argparse.ArgumentParser(description="Markdown 原稿 → X 长文 HTML（一键复制）")
-    ap.add_argument("md", help="原稿 markdown 路径")
-    ap.add_argument("--out", required=True, help="输出 HTML 路径")
+    ap.add_argument("md", help="原稿 markdown 路径（文章文件夹结构下就是 <文章名>.md）")
+    ap.add_argument("--out", default=None, help="输出 HTML 路径（缺省 <md 所在目录>/out/X长文.html）")
     ap.add_argument("--images", nargs="*", default=[], help="[图N] 对应的图片路径（按顺序）")
     ap.add_argument("--images-from", default=None, metavar="WECHAT_MD",
-                    help="从指定的 markdown（如公众号稿.md）中按文档顺序提取 ![]() 本地图片路径，"
-                         "作为 [图N] 的图片来源。X 稿必须从公众号稿派生时用此项，"
+                    help="从指定的 markdown（如旧结构的公众号稿.md）中按文档顺序提取 ![]() 本地图片路径，"
+                         "作为 [图N] 的图片来源。缺省：源稿自己有 ![]() 就直接读它；"
                          "禁止手工拼 --images 顺序（曾因此出现配图错位）")
-    ap.add_argument("--cover", default=None, help="封面图路径（1500×600，5:2）")
+    ap.add_argument("--cover", default=None,
+                    help="封面图路径（1500×600，5:2）；缺省读 frontmatter 的 cover（相对 md 所在目录）")
     args = ap.parse_args()
 
     if not os.path.isfile(args.md):
@@ -556,6 +614,29 @@ def main():
         sys.exit(1)
     with open(args.md, encoding="utf-8") as f:
         md_text = f.read()
+    md_dir = os.path.dirname(os.path.abspath(args.md))
+    if not args.out:
+        args.out = os.path.join(md_dir, "out", "X长文.html")
+    if not args.cover:
+        fc = frontmatter_value(md_text, "cover")
+        if fc:
+            cp = fc if os.path.isabs(fc) else os.path.normpath(os.path.join(md_dir, fc))
+            if os.path.isfile(cp):
+                args.cover = cp
+            else:
+                print("警告：frontmatter 的 cover 文件不存在，跳过封面：%s" % fc, file=sys.stderr)
+
+    has_markers = any(re.fullmatch(r"\[图\d+\]", ln.strip()) for ln in md_text.split("\n"))
+    if not has_markers and not args.images and not args.images_from:
+        # 新结构：源稿只有 ![]()，直接按文档顺序取图
+        md_text, derived = inline_images(md_text, md_dir)
+        if derived:
+            print("从源稿直接取图：%d 张" % len(derived), file=sys.stderr)
+        args.images = derived
+    elif has_markers and not args.images and not args.images_from:
+        print("源稿里有 [图N] 但没给图片来源：加 --images-from <带 ![]() 的稿子>，"
+              "或把 [图N] 换回 ![说明](images/xx.png)", file=sys.stderr)
+        sys.exit(1)
 
     # 图片来源：优先 --images-from（从公众号稿等源 md 按文档顺序派生），杜绝手工排序错位
     images = list(args.images)