@topmindspace/topmind-writing-skills 0.7.1

package/topmind-wechat-post/scripts/sync-status.py

@@ -0,0 +1,187 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""sync-status.py — 同步公众号交付包的「状态 ⇄ 目录名 ⇄ 字数」。
+
+规则（与专题 topic.md 的目录规范一致）：
+  status = 草稿            → 目录名 YYYY-MM-DD-<中文名>
+  status = 定稿 / 已发布    → 目录名 YYYY-MM-DD-<中文名>-released
+
+同时刷新 frontmatter 的 word_count（正文中文字数）。
+
+Usage:
+    python3 sync-status.py                       # 扫描全部，只报告（dry-run）
+    python3 sync-status.py --apply               # 实际重命名并回写字数
+    python3 sync-status.py --set 定稿 <包目录>    # 改状态 + 同步目录名
+    python3 sync-status.py --base <专题目录>
+"""
+
+import argparse
+import os
+import re
+import sys
+
+def _default_base():
+    """交付包根：CLI --base → env TOPMIND_WECHAT_BASE → env TOPMIND_WORKSPACE 发现 → 惯例路径。"""
+    env = os.environ.get("TOPMIND_WECHAT_BASE") or os.environ.get("TOPMIND_WECHAT_PACKAGE_ROOT")
+    if env:
+        return os.path.abspath(os.path.expanduser(env))
+    ws = os.environ.get("TOPMIND_WORKSPACE")
+    if ws:
+        for rel in (
+            ("40-创作", "2026-公众号"),
+            ("20-专题", "2026-公众号"),
+            ("88-交付", "2026-公众号"),
+        ):
+            p = os.path.join(ws, *rel)
+            if os.path.isdir(p):
+                return p
+        return os.path.join(ws, "40-创作", "2026-公众号")
+    # 惯例：父工作区（可被 CLI 覆盖）
+    return os.path.join(
+        os.path.expanduser("~"), "TopWorkSpace", "topmind-workspace",
+        "40-创作", "2026-公众号")
+
+
+def _default_topstream():
+    env = os.environ.get("TOPSTREAM_ROOT") or os.environ.get("TOPMIND_TOPSTREAM")
+    if env:
+        return os.path.abspath(os.path.expanduser(env))
+    return os.path.join(os.path.expanduser("~"), "TopWorkSpace", "topstream")
+
+DEFAULT_BASE = _default_base()
+
+FINAL_STATUSES = ("定稿", "已发布")
+VALID_STATUSES = ("草稿",) + FINAL_STATUSES
+RELEASED_SUFFIX = "-released"
+
+
+def split_fm(text):
+    """返回 (frontmatter, body, head, tail_sep)；无 frontmatter 时 fm=None"""
+    if not text.startswith("---\n"):
+        return None, text, "", ""
+    i = text.find("\n---", 3)
+    if i < 0:
+        return None, text, "", ""
+    return text[4:i], text[i + 4:].lstrip("\n"), text[:4], text[i:i + 4]
+
+
+def get_field(fm, key):
+    m = re.search(r"^%s:\s*(.*)$" % re.escape(key), fm, re.M)
+    return m.group(1).strip().strip('"') if m else None
+
+
+def set_field(fm, key, val):
+    line = "%s: %s" % (key, val)
+    pat = re.compile(r"^%s:\s*.*$" % re.escape(key), re.M)
+    if pat.search(fm):
+        return pat.sub(line, fm, count=1)
+    return fm.rstrip("\n") + "\n" + line + "\n"
+
+
+def scan(base):
+    """返回 [(dirname, status, word_count, needs_rename, target_name)]"""
+    rows = []
+    for name in sorted(os.listdir(base)):
+        pkg = os.path.join(base, name)
+        draft = os.path.join(pkg, "公众号稿.md")
+        if not os.path.isdir(pkg) or not os.path.exists(draft):
+            continue
+        text = open(draft, encoding="utf-8").read()
+        fm, body, head, sep = split_fm(text)
+        if fm is None:
+            rows.append((name, None, None, False, None, "无 frontmatter"))
+            continue
+        status = get_field(fm, "status") or "草稿"
+        cn = len(re.findall(r"[\u4e00-\u9fff]", body))
+
+        want_final = status in FINAL_STATUSES
+        stem = name[:-len(RELEASED_SUFFIX)] if name.endswith(RELEASED_SUFFIX) else name
+        target = stem + (RELEASED_SUFFIX if want_final else "")
+        rows.append((name, status, cn, target != name, target, ""))
+    return rows
+
+
+def apply_rename(base, name, target, draft_path, fm, body, head, new_fm):
+    """写回 frontmatter 后重命名目录"""
+    open(draft_path, "w", encoding="utf-8").write("---\n" + new_fm + "\n---\n\n" + body)
+    if target != name:
+        os.rename(os.path.join(base, name), os.path.join(base, target))
+
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument("--base", default=DEFAULT_BASE)
+    ap.add_argument("--apply", action="store_true", help="实际执行（默认只报告）")
+    ap.add_argument("--set", metavar="STATUS", choices=VALID_STATUSES,
+                    help="把指定包改成该状态（需配合包名）")
+    ap.add_argument("pkg", nargs="?", help="包目录名（配合 --set 使用）")
+    args = ap.parse_args()
+
+    if not os.path.isdir(args.base):
+        print("✗ 专题目录不存在：%s" % args.base)
+        return 1
+
+    # 单包改状态
+    if args.set:
+        if not args.pkg:
+            print("✗ --set 需要指定包目录名")
+            return 1
+        draft = os.path.join(args.base, args.pkg, "公众号稿.md")
+        if not os.path.exists(draft):
+            print("✗ 找不到：%s" % draft)
+            return 1
+        text = open(draft, encoding="utf-8").read()
+        fm, body, head, sep = split_fm(text)
+        if fm is None:
+            print("✗ 该文件无 frontmatter")
+            return 1
+        fm = set_field(fm, "status", args.set)
+        cn = len(re.findall(r"[\u4e00-\u9fff]", body))
+        fm = set_field(fm, "word_count", str(cn))
+
+        want_final = args.set in FINAL_STATUSES
+        stem = args.pkg[:-len(RELEASED_SUFFIX)] if args.pkg.endswith(RELEASED_SUFFIX) else args.pkg
+        target = stem + (RELEASED_SUFFIX if want_final else "")
+
+        if args.apply:
+            apply_rename(args.base, args.pkg, target, draft, fm, body, head, fm)
+            print("✓ %s → status=%s，目录 %s（%d 中文字）" % (
+                args.pkg, args.set, target if target != args.pkg else "不变", cn))
+        else:
+            print("[dry-run] %s → status=%s，目录将变为 %s" % (args.pkg, args.set, target))
+        return 0
+
+    rows = scan(args.base)
+    if not rows:
+        print("专题下没有交付包：%s" % args.base)
+        return 0
+
+    print("%-44s %-6s %8s  %s" % ("包目录", "状态", "中文字", "待同步"))
+    print("-" * 84)
+    changed = 0
+    for name, status, cn, needs, target, note in rows:
+        if status is None:
+            print("%-44s %-6s %8s  %s" % (name, "-", "-", note))
+            continue
+        flag = "→ " + target if needs else ""
+        print("%-44s %-6s %8s  %s" % (name, status, cn, flag))
+
+        if args.apply:
+            draft = os.path.join(args.base, name, "公众号稿.md")
+            text = open(draft, encoding="utf-8").read()
+            fm, body, head, sep = split_fm(text)
+            fm = set_field(fm, "word_count", str(cn))
+            apply_rename(args.base, name, target, draft, fm, body, head, fm)
+            if needs:
+                changed += 1
+
+    if args.apply:
+        print("\n✓ 已刷新 %d 个包的 word_count，重命名 %d 个目录" % (len(rows), changed))
+    else:
+        pending = sum(1 for r in rows if r[3])
+        print("\n[dry-run] %d 个包目录名与状态不一致，加 --apply 执行" % pending)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/topmind-x-article/README.en.md

@@ -0,0 +1,109 @@
+# topmind-x-article · One-Click X Long-Form Publishing
+
+**[中文](./README.md)** | English
+
+Turn a Markdown draft into a "copy → paste → publish" X long-form (Article) package.
+
+- Version: **v0.4.0** (same tag as `@topmindspace/topmind-writing-skills@0.7.1`)
+
+## Install
+
+```bash
+npx @topmindspace/topmind-writing-skills install topmind-x-article
+```
+
+## Usage
+
+```bash
+# 1. Draft → one-click-copy HTML (preferred)
+python3 scripts/md2x-html.py <draft>.md --out <package>/X长文.html \
+  --images-from 公众号稿.md [--cover cover-1500x600.png]
+# --images-from derives image order from the WeChat draft in document order
+# (required when the X draft is derived from it);
+# never hand-assemble --images (filename sort order != document order —
+# this once misplaced a whole section's images).
+# Open X长文.html in a browser → click the top 「一键复制全文」 button → paste into the X Article editor body
+# (the first # heading is excluded from the clipboard — fill it into X's title field by hand;
+#  upload the cover separately via X's dedicated cover entry)
+
+# 2. Plain-text fallback (when HTML copying misbehaves)
+python3 scripts/md2x.py <draft>.md --out <package>/X发布稿.txt
+
+# 3. Cover: generate a 1200×675 cover with topmind-cover
+
+# 4. Follow references/publish-checklist.md item by item
+```
+
+## Conversion rules
+
+The HTML path follows `references/x-html-format.md`: rich-text paste into the X editor
+(headings/bold/links/lists/quote blocks preserved); ` ``` ` prompt blocks render as quote
+blocks with a 「复制提示词」 copy button; GFM tables become lists (X drops `<table>` on paste);
+the first `#` heading is excluded from the clipboard; images are base64-inlined and numbered
+`[图N]`, with per-image 「下载图片」 download buttons as fallback upload.
+
+Prompt copying is dual-channel: the author side uses the 「复制提示词」 button in the HTML
+(to grab the text before publishing); the reader-side one-click copy can only come from X
+native code blocks (convert each block by hand via Insert → Code — native code blocks carry a
+native copy button, while pasted `<pre>` is discarded by X).
+
+The plain-text fallback follows `references/x-format.md`: headings → plain text lines,
+horizontal rules → blank lines, emphasis markers removed, links → `text（url）`, images →
+`[图N]` (image list appended at the end), tables → "label：value" lists, blockquotes unquoted.
+
+Read the result through once by hand after converting.
+
+## Minimal example
+
+Input (10 lines of markdown):
+
+```markdown
+# Manus 2.0 发布了
+
+**从零重建**的 Agent，新增了 Cue 个人助手。
+
+![发布会现场](cover.png)
+
+| Token 消耗 | -23.2% |
+| 耗时 | -28.2% |
+
+详见[官方博客](https://manus.im/blog)。
+```
+
+`python3 scripts/md2x.py draft.md --out X发布稿.txt` produces:
+
+```
+Manus 2.0 发布了
+
+从零重建的 Agent，新增了 Cue 个人助手。
+
+[图1]
+
+Token 消耗：-23.2%
+耗时：-28.2%
+
+详见官方博客（https://manus.im/blog）。
+
+—— 配图清单 ——
+[图1] 发布会现场
+```
+
+Copy the whole `X发布稿.txt` → paste into the X Article editor → upload images in `[图N]` order → publish.
+
+## Publishing
+
+X long-form posts are currently published by hand-pasting into the X Article editor; the API does not publish long-form. After publishing, do per the checklist: pin a first comment with the extra info, fetch the full text back for verification.
+
+## External dependencies
+
+The following skills are **not in this repo** (usually provided by the user's local workbuddy environment). Missing ones disable the corresponding routed capability; the core flow (draft → text, cover, publish checklist) is unaffected:
+
+- `topmind-x`: 280-char short posts (its xurl only covers short posts, not long-form).
+- `topmind-capture`: the "archive only, don't publish" routing path.
+
+## Development
+
+```bash
+python3 scripts/package_skill.py --check   # pre-publish check
+python3 scripts/negative_tests.py          # bad-input tests
+```

package/topmind-x-article/README.md

@@ -0,0 +1,104 @@
+# topmind-x-article · X 长文一键发布
+
+[English](./README.en.md) | 中文
+
+把 Markdown 原稿变成"复制 → 粘贴 → 发"的 X 长文（Article）发布包。
+
+- 版本：**v0.4.0**（与 `@topmindspace/topmind-writing-skills@0.7.1` 同 tag）
+
+## 安装
+
+```bash
+npx @topmindspace/topmind-writing-skills install topmind-x-article
+```
+
+## 用法
+
+```bash
+# 1. 原稿转一键复制 HTML（首选）
+python3 scripts/md2x-html.py <原稿>.md --out <包>/X长文.html \
+  --images-from 公众号稿.md [--cover cover-1500x600.png]
+# --images-from 从公众号稿按文档顺序派生图片（X 稿由公众号稿派生时必用）；
+# 禁止手工拼 --images 列表（文件名排序 ≠ 文档顺序，曾导致整段配图错位）。
+# 浏览器打开 X长文.html → 点页顶「一键复制全文」→ 粘贴进 X Article 编辑器正文
+# （首个 # 标题不进剪贴板，手动填入 X 标题栏；封面在 X 独立入口单独上传）
+
+# 2. 纯文本兜底（HTML 复制异常时）
+python3 scripts/md2x.py <原稿>.md --out <包>/X发布稿.txt
+
+# 3. 封面图：用 topmind-cover 生成 1200×675
+
+# 4. 按 references/publish-checklist.md 逐项发布
+```
+
+## 转换规则
+
+HTML 链路按 `references/x-html-format.md`：富文本粘贴进 X 编辑器（标题/加粗/链接/
+列表/引用块保留）；` ``` ` 提示词块渲染为引用块 + 「复制提示词」按钮；GFM 表格转列表
+（X 粘贴丢弃 `<table>`）；首个 `#` 标题不进剪贴板；配图 base64 内嵌、按 `[图N]` 编号，
+带不入编辑器时用图下「下载图片」按编号上传。
+
+提示词的复制分双通道：作者侧用 HTML 里的「复制提示词」按钮（发布前取用文本）；
+读者侧一键复制只能来自 X 原生代码块（Insert → Code 手动逐块转换；原生代码块带
+native copy button，粘贴 `<pre>` 会被 X 丢弃，走不过去）。
+
+纯文本兜底按 `references/x-format.md`：标题→纯文本行、分隔线→空行、加粗/斜体/
+行内代码去标记、链接→`文字（url）`、图片→`[图N]`（文末附配图清单）、表格→"项：值"列表、
+引用去 `>`。转完必须人工通读一遍。
+
+## 最小示例
+
+输入（10 行 markdown）：
+
+```markdown
+# Manus 2.0 发布了
+
+**从零重建**的 Agent，新增了 Cue 个人助手。
+
+![发布会现场](cover.png)
+
+| Token 消耗 | -23.2% |
+| 耗时 | -28.2% |
+
+详见[官方博客](https://manus.im/blog)。
+```
+
+`python3 scripts/md2x.py 原稿.md --out X发布稿.txt` 得到：
+
+```
+Manus 2.0 发布了
+
+从零重建的 Agent，新增了 Cue 个人助手。
+
+[图1]
+
+Token 消耗：-23.2%
+耗时：-28.2%
+
+详见官方博客（https://manus.im/blog）。
+
+—— 配图清单 ——
+[图1] 发布会现场
+```
+
+复制 `X发布稿.txt` 全文 → 粘贴进 X Article 编辑器 → 按 `[图N]` 顺序上传配图 → 发布。
+
+## 发布
+
+X 长文目前走人工粘贴发布（X Article 编辑器），API 不发长文。
+发布后按清单做：首条评论置顶补信息、全文抓回核对。
+
+## 外部依赖
+
+以下技能**不在本仓库**（一般随用户侧 workbuddy 环境提供）。缺失时对应路由能力
+不可用，不影响本技能核心流程（原稿转文本、封面、发布清单）：
+
+- `topmind-x`：280 字短推文发布（xurl 只覆盖短推文，不发长文）。
+- `topmind-capture`：「只想存档不发布」时的收录路由。
+
+## 开发
+
+```bash
+python3 scripts/package_skill.py --check   # 发布前校验
+python3 scripts/negative_tests.py          # 异常输入测试
+```

package/topmind-x-article/SKILL.md

@@ -0,0 +1,156 @@
+---
+name: topmind-x-article
+version: 0.4.0
+description: "X 长文（Article）一键发布：Markdown 原稿 → 可直接复制的 X长文.html（富文本一键复制+配图内嵌）/ X发布稿.txt + 封面图 + 发布清单。沉淀自实战。Use when X 长文、发 X 文章、X article、长文发 X。Do NOT use for 短推文（→ topmind-x）、公众号（→ topmind-wechat-post）。"
+action_category: write
+triggers:
+  - X 长文
+  - 发 X 文章
+  - X article
+  - 长文发 X
+  - X 发长文
+  - 转纯文本
+  - X 纯文本
+  - 发 article
+  - 一键复制
+triggers_cn:
+  - 写 X 长文
+  - X 长文发布
+  - 推特长文
+  - twitter 长文
+author: TopMindspace
+license: MIT
+homepage: https://github.com/topmindspace/topmind-writing-skills#readme
+updated: 2026-09-29
+---
+
+# topmind-x-article · X 长文一键发布
+
+把一篇 Markdown 原稿变成"复制 → 粘贴 → 发"的 X 长文发布包。
+
+```
+原稿.md → md2x-html.py → X长文.html（一键复制全文+配图）→ 封面图(topmind-cover) → 发布清单 → 人工粘贴发布
+原稿.md → md2x.py     → X发布稿.txt（纯文本兜底）
+```
+
+## 语言铁律
+
+- **默认中文**：标题、正文、配图文案一律用中文写作，这是默认行为，不需要用户每次声明。
+- **英文是例外**：只有用户**明确说**"写英文文章/帖子"时才用英文。用户消息里夹杂英文词、
+  给英文参考素材、引用英文原文，都不算"要求写英文"。
+- 引用英文一手素材（官方公告、模型卡、论文标题）时保留英文原文，正文主体仍是中文，
+  必要时在旁给中文翻译。
+
+## 工作流
+
+1. **转 HTML**（一键复制的核心，首选）：
+   ```bash
+   python3 scripts/md2x-html.py <原稿>.md --out <包>/X长文.html \
+     --images-from 公众号稿.md [--cover cover-1500x600.png]
+   ```
+   `--images-from` 从公众号稿按文档顺序派生图片（X 稿永远由公众号稿派生时必用）。
+   **禁止手工拼 `--images` 列表**：文件名数字顺序 ≠ 文档顺序
+   （如 `14-kling` 与 `15-china-models` 按名排序会错位），手工传参曾导致整段配图错乱。
+   只有无公众号稿可派生的纯 X 原创稿，才允许用 `--images <图1> <图2> ...`，
+   此时必须逐张核对文件名与 `[图N]` 的对应关系。
+   单文件 HTML：内联样式 + 配图 base64 内嵌。浏览器打开后点页顶
+   「一键复制全文」，富文本（含格式）进剪贴板，去 X 文章编辑器粘贴。
+   转换规则见 `references/x-html-format.md`。
+   - `#` 首个标题**不进剪贴板**：手动填入 X 标题栏（工具栏有三步话术提示）。
+   - 每张配图自动编号 `[图N]`；图片 data-URI 内嵌，能随粘贴带入编辑器最好，
+     带不进去时用图下「下载图片」按钮按编号下载再上传——不用找文件、不用对顺序。
+     点击图片弹出 lightbox 放大看原图（右键可另存/截图，不拦截右键菜单）。
+   - 每个 ``` 提示词块渲染为引用块（X 可识别）+ 右上角「复制提示词」按钮，
+     一键复制该块纯文本。**复制分双通道**：作者侧用 HTML 里的按钮（发布前取用文本）；
+     读者侧一键复制只能来自 X 原生代码块，需在编辑器里 Insert → Code 手动逐块转换
+     （X 原生代码块带 native copy button；粘贴 `<pre>` 会被 X 丢弃，走不过去）。
+     详见 `references/x-html-format.md`「提示词的复制链路（双通道）」。
+   - 封面走 `--cover` 只在页顶预览 + 提供下载；**封面始终在 X 编辑器单独上传**
+     （X 有独立封面入口）。
+2. **转纯文本**（兜底）：`python3 scripts/md2x.py <原稿>.md --out <包>/X发布稿.txt`，
+   规则见 `references/x-format.md`。HTML 复制异常时的备用入口。
+   转完**通读一遍**：X 不渲染 markdown，标记剥离后断句、emphasis 全靠文字本身，
+   读不顺就回原稿改。
+3. **封面图**：调 `topmind-cover`，平台选 `x`，得 1500×600 主图。
+4. **发布清单**：按 `references/publish-checklist.md` 逐项过。
+5. **发布**：用户在 X Article 编辑器粘贴全文、上传封面与配图（按 `[图N]` 编号），
+   人工点发布。**API 不发长文**（topmind-x 的 xurl 只覆盖短推文）。
+6. **收尾**：记录发布时间与链接；全文抓回核对一遍（标题、数字、图序）。
+
+## 目录约定
+
+```
+<包>/
+├── 原稿.md            # 输入（或复用既有原稿）
+├── X长文.html         # 首选复制入口：浏览器打开，一键复制全文
+├── X发布稿.txt        # 纯文本兜底入口
+├── cover-1500x600.png # 封面（topmind-cover 产出，X 编辑器单独上传）
+└── 发布清单.md        # 本次发布 checklist（含时间、链接）
+```
+
+## 实战沉淀
+
+- **事实铁律**：承重事实（数字、排名、发布日期、融资额）逐条回一手来源
+  （官方公告/模型卡/论文/财报）；厂商给的数字标"厂商口径"或"官方口径"；
+  媒体转引标"据 XX 报道"；查不到一手来源的传闻删；推测必须显式标"（推测）"，
+  与事实段落切割，不混写。改稿续写时正文已有数字回源重核（上一轮文本最不可信）。
+- **文字铁律**：去 AI 味、精炼、不编造；看图即得的简单事实不再展开复述；
+  多用第三方客观素材，观点可以撞、表达必须原创。
+- **交付铁律**：发布/分享时直接用交付的 HTML 原文件原样呈现，不临时重新生成版本。
+- 补充信息（邀请码、链接、勘误）**不挤正文**，发在发布后首条评论并置顶
+- 标题 ≤140 字符，首段 3 行内出钩子；配图逐张按 `[图N]` 顺序上传，传完对照清单点一遍
+- 事实修正只改发布包，不回头改已发原文（除非勘误）
+- 提示词密集型文章（如 N 条直出提示词），发布时建议把提示词引用块逐块转为
+  X 原生代码块（Insert → Code → 粘贴 → 删原块，每块约 10 秒）：这是 X 平台唯一可靠的
+  读者侧一键复制链路（原生代码块带 native copy button，已实测确认）
+- X 编辑器对剪贴板 data-URI 图片的处理不稳定：**文本格式一键复制可靠，
+  图片按"能带入则带入，带不入则按编号下载上传"处理**，不要承诺用户图片 100% 一键带图
+
+## When NOT to use
+
+- 280 字短推文 → `topmind-x`
+- 公众号 → `topmind-wechat-post`
+- 只想存档不发布 → `topmind-capture`
+- 写稿（只有发布需求、无原稿时）→ 先走写作技能再回本技能
+
+## 外部依赖
+
+以下技能**不在本仓库**（一般随用户侧 workbuddy 环境提供）；缺失时对应路由能力不可用，
+本技能核心流程（原稿转文本、封面、发布清单）不受影响：
+
+- `topmind-x`：280 字短推文发布（xurl 只覆盖短推文，不发长文）。
+- `topmind-capture`：「只想存档不发布」时的收录路由。
+
+## 实战沉淀（2026-10-01 九月全景项目）
+
+- **HTML 占位符映射铁律**：`md2x-html.py --cover` 注入封面到 `__COVER__`，正文图按序注入
+  `__IMG_01__`–`__IMG_N__`。曾出现错位 bug（封面位置注入 `__IMG_01__`、正文图整体后移、
+  最后一张图跑到 `__COVER__`），原因是占位符替换顺序错误。修复后验收标准：
+  第一张 base64 图解码为 1500×600（封面尺寸），无占位符残留。
+- **X发布稿.txt 图序**：由 `md2x.py` 从 X长文.md 生成，`[图N]` 编号与 HTML 正文图顺序一致，
+  封面不占编号（X 编辑器单独上传封面）。
+
+## 实战沉淀（2026-10-01 九月全景·配图错位修复）
+
+- **错位症状 A**：Grok 4.7 配图落在 Meta 段落之后；"国产模型一览"落在手机段落之后。
+  原因：改稿时只动文字不动图，图片 markdown 行被"落下"到下一段。
+- **铁律**：图片必须紧跟它证明的那段文字（最多隔一段）；改稿移动段落时，图片行一起搬。
+- **错位症状 B（根本原因）**：旧版 X 构建从"六、工具与 Agent"起配图全错
+  （Codex 段配 OpenRouter 图、Harness 段配 AA 榜单图……）。
+  原因：`X长文.md` 里只有裸 `[图N]` 标记，图片靠 `--images` 命令行手工传参；
+  构建时按 `images/*` 文件名排序传入，而文件名数字顺序 ≠ 文档顺序
+  （`14-kling`/`15-china-models` 建图顺序与文档顺序相反；`21-codex`/`22-harness`
+  是后加的，排在 `16-openrouter` 之后）。从图 14 起全部错位一格，
+  图 14/15 互换不易察觉，到图 16（Codex 段）才明显暴露。
+- **根治**：`md2x-html.py` 新增 `--images-from 公众号稿.md`，
+  从公众号稿的 `![]()` 按文档顺序自动派生图片，**不再允许手工排序**；
+  脚本内置校验：`[图N]` 必须连续编号且数量 = 图片数，否则直接报错退出
+  （不静默生成错版）。
+- **构建后必跑三项校验**（缺一不可）：
+  1. 脚本自校验通过（数量/连续性）。
+  2. 嵌入图顺序校验：逐张解码 base64，与源文件按文档顺序比对（像素或字节一致即过）。
+  3. 图文邻近校验：每张图前后各取 6 行，检查是否出现该图主题关键词
+     （如 Grok 图邻近必须有"Grok"）；章节题图（节首图）只查节标题相关性。
+- **派生纪律**：`X长文.md` 永远由 `公众号稿.md` 重新派生（脚本重排 `[图N]`），
+  不手工改编号；派生后 `X发布稿.txt` 同步重生成。
+  `公众号稿.md` 是唯一真源：改图先改公众号稿，再重派生 X 稿，两边永不独立改图。

package/topmind-x-article/package-lock.json

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

package/topmind-x-article/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "topmind-x-article",
+  "version": "0.4.0",
+  "private": true,
+  "description": "X 长文（Article）一键发布：Markdown 原稿转可直接粘贴的纯文本 + 封面图 + 发布清单。",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/topmindspace/topmind-writing-skills.git",
+    "directory": "topmind-x-article"
+  },
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/topmind-x-article/references/publish-checklist.md

@@ -0,0 +1,31 @@
+# X 长文发布清单
+
+发布前逐项打勾，发布后填时间与链接归档。
+
+## 发布前
+
+- [ ] `X长文.html` 浏览器打开一遍：「一键复制全文」按钮可用、配图 11 张按序显示、
+      每个提示词块右上角「复制提示词」可用、封面预览 + 下载正常
+- [ ] `X发布稿.txt` 通读一遍：断句顺、无 markdown 残留标记（HTML 复制异常时的兜底）
+- [ ] 标题 ≤140 字符；首段 3 行内出钩子
+- [ ] 承重数字与原稿一致（转格式不改数字）
+- [ ] 封面图 1500×600 已备好，标题字无错别字
+- [ ] 配图按 `[图N]` 顺序排好，清单与文件一一对应
+- [ ] 话题标签想好（放文末，不超过 3 个）
+- [ ] 提示词密集型文章：规划好哪些提示词块要在 X 里转原生代码块
+      （Insert → Code，读者侧一键复制的唯一链路；纯展示、无需取用的可跳过）
+
+## 发布时
+
+- [ ] 一键复制全文 → X 文章编辑器粘贴 → 封面单独上传 → 配图按 `[图N]` 编号插入
+      （图片若随粘贴带入则跳过上传；带不入则用图下「下载图片」按编号下载再上传）
+- [ ] （提示词类文章推荐）提示词引用块逐块转 X 原生代码块，得读者侧一键复制：
+      HTML 里点该块「复制提示词」→ X 编辑器对应位置 Insert → Code → 粘贴 → 删除原引用块
+- [ ] 预览一遍：图序、段落、标题
+
+## 发布后
+
+- [ ] 首条评论补信息（邀请码 / 链接 / 补充说明），置顶
+- [ ] 记录：发布时间、文章链接
+- [ ] 全文抓回核对一遍（标题、数字、图序），有误用评论勘误
+- [ ] `发布清单.md` 归档进包

package/topmind-x-article/references/x-format.md

@@ -0,0 +1,27 @@
+# X Article 粘贴格式规则
+
+X Article 编辑器对 markdown 支持弱且不稳定。`md2x.py` 按以下规则转纯文本，
+转完人工通读一遍是硬性步骤。
+
+| Markdown | 转后 |
+|----------|------|
+| `#` ~ `######` 标题 | 纯文本行，前后各一空行；标题内的加粗/链接等标记同样剥离 |
+| `标题` + 下一行 `===`（Setext 一级标题） | 同上，转纯文本标题行 |
+| `**加粗**` / `*斜体*` / `***粗斜体***` / `~~删除线~~` / `` `行内代码` `` | 去标记留文字（语气靠文字本身） |
+| `[文字](url)` | `文字（url）`；url 里可含括号，`[文字](url "title")` 的 title 丢弃 |
+| `[文字][ref]` / `[文字][]` / `[文字]`（引用式，有 `[ref]: url` 定义） | `文字（url）`；定义行不进正文 |
+| `![alt](url)` / `![alt][ref]` | `[图N]`，文末附"配图清单"（`[图N] alt`；alt 为空记 `（未写图注）`） |
+| `-` / `1.` 列表 | 保留原符号（含嵌套缩进）；`- [ ]` / `- [x]` 任务列表都去勾选框留 `-`（完成状态不保留） |
+| `>` 引用 | 去掉所有层级的 `>` 留文字；引用内的标题照转 |
+| 表格（行首以 `|` 开头的标准写法；不带前导 `|` 的表格暂不转换） | 逐行转"项：值"列表（单元格内标记同样剥离）；分隔行丢弃，复杂表请手动拆成段落 |
+| `---` / `***` / `___` 分割线（允许空格，如 `* * *`） | 空行 |
+| 代码块（``` 围栏；`~~~` 围栏暂不支持） | 去围栏，内容缩进 4 格；块内行原样保留（块内的 `---` 不再误判分割线） |
+| `\` 转义（如 `\*`） | 去反斜杠留字符 |
+| frontmatter | 整块丢弃（块内非空行须都含 `:` 才认定，文首的 `---` 分割线不会被误吞） |
+
+## 写作时就按 X 想
+
+- 段落短：手机阅读每段 ≤4 行
+- 小标题就是一句话，不依赖加粗撑结构
+- 数字、专有名词第一次出现就写全（剥离标记后无高亮可依靠）
+- 需要强调的词：换说法前置，不要靠 `**`