@topmindspace/tms-skills 0.3.0 → 0.3.5

package/topmind-wechat-post/scripts/md2wechat.py

@@ -217,7 +217,10 @@ def highlight(code, lang, scheme=None):
     if not rules:
         return html.escape(code, quote=False)
     palette = scheme or CTX.get("hl_scheme") or HIGHLIGHT
-    pattern = re.compile("|".join("(?P<%s>%s)" % (name, pat) for name, pat in rules), re.S)
+    pattern = _HL_PATTERN_CACHE.get(key)
+    if pattern is None:
+        pattern = re.compile("|".join("(?P<%s>%s)" % (name, pat) for name, pat in rules), re.S)
+        _HL_PATTERN_CACHE[key] = pattern
     out = []
     pos = 0
     for m in pattern.finditer(code):
@@ -335,6 +338,22 @@ HAN_RE = re.compile("[%s]" % HAN)
 PANGU_A = re.compile(r"([%s])([A-Za-z0-9])" % HAN)
 PANGU_B = re.compile(r"([A-Za-z0-9])([%s])" % HAN)
 
+# render_inline() 的行内模式：预编译在模块级，避免每行重复走 re 缓存查找
+# （666k 行级调用 × 10 个模式时，re.sub 的字符串模式查找是可观开销）。
+INLINE_CODE_RE = re.compile(r"`([^`]+)`")
+INLINE_IMG_RE = re.compile(r"!\[([^\]]*)\]\(([^)\s]+)(?:\s+\"[^\"]*\")?\)")
+INLINE_LINK_RE = re.compile(r"\[([^\]]+)\]\(([^)\s]+)\)")
+INLINE_BADGE_RE = re.compile(r"\[!([^\]]+)\]")
+INLINE_HL_RE = re.compile(r"==([^=]+)==")
+INLINE_UNDER_RE = re.compile(r"\+\+([^+]+)\+\+")
+INLINE_U_RE = re.compile(r"&lt;u&gt;(.+?)&lt;/u&gt;")
+INLINE_MARK_RE = re.compile(r"~~([^~]+)~~")
+INLINE_STRONG_RE = re.compile(r"\*\*([^*]+)\*\*")
+INLINE_EM_RE = re.compile(r"(?<![*\w])\*([^*\n]+)\*(?!\*)")
+
+# highlight() 的语言联合模式缓存：同一语言的多段代码块只编译一次
+_HL_PATTERN_CACHE = {}
+
 
 def pangu(text):
     text = PANGU_A.sub(r"\1 \2", text)
@@ -363,7 +382,7 @@ def render_inline(raw):
         return CODE_TOKEN % (len(spans) - 1)
 
     text = esc(raw)
-    text = re.sub(r"`([^`]+)`", lambda m: stash(m.group(1)), text)
+    text = INLINE_CODE_RE.sub(lambda m: stash(m.group(1)), text)
 
     if use_pangu:
         text = pangu(text)
@@ -371,22 +390,37 @@ def render_inline(raw):
     strong = 'font-weight:600;color:%s;' % theme["text_strong"]
     em = 'font-style:normal;color:%s;' % theme["text_muted"]
 
-    # images
+    # images（行内图与独立成行图共用同一正则语义）
     def img_repl(m):
         alt, src = m.group(1), m.group(2)
+        # 行内图片同样走图片管线：本地文件解析 → 复制到 images/ → 登记清单，
+        # 否则 --embed-images 找不到文件、清单漏项、计数为 0（历史 bug：
+        # 段落里的 ![alt](x.png) 被原样保留相对路径，粘贴到公众号后整图消失）。
+        resolver = CTX.get("img_resolve")
+        if resolver and not re.match(r"^(https?:|data:|//)", src):
+            src = resolver(html.unescape(src))
         caption = ' alt="%s"' % alt if alt else ""
         return ('<img src="%s"%s style="max-width:100%%;height:auto;'
                 'border-radius:3px;vertical-align:middle;">') % (src, caption)
 
-    text = re.sub(r"!\[([^\]]*)\]\(([^)\s]+)\)", img_repl, text)
+    text = INLINE_IMG_RE.sub(img_repl, text)
 
     # links
     def link_repl(m):
         label, url = m.group(1), m.group(2)
         if link_mode == "footnote" and footnotes is not None:
-            if url not in [f["url"] for f in footnotes]:
+            # url→序号字典：原写法每次链接都扫全表两次（O(n²)），长文链接多时明显变慢
+            fidx = CTX.get("footnote_idx")
+            if fidx is not None and url in fidx:
+                idx = fidx[url]
+            elif fidx is not None:
                 footnotes.append({"url": url, "label": label})
-            idx = [f["url"] for f in footnotes].index(url) + 1
+                idx = len(footnotes)
+                fidx[url] = idx
+            else:  # 外部直接调 render_inline 且未初始化索引时，走原来的线性查找
+                if url not in [f["url"] for f in footnotes]:
+                    footnotes.append({"url": url, "label": label})
+                idx = [f["url"] for f in footnotes].index(url) + 1
             return ('%s<sup style="font-size:11px;color:%s;'
                     'padding-left:1px;">[%d]</sup>'
                     % (label, theme["accent"], idx))
@@ -396,13 +430,12 @@ def render_inline(raw):
         return ('<span style="font-size:13px;color:%s;word-break:break-all;">'
                 '%s（%s）</span>' % (theme["text_light"], label, url))
 
-    text = re.sub(r"\[([^\]]+)\]\(([^)\s]+)\)", link_repl, text)
+    text = INLINE_LINK_RE.sub(link_repl, text)
 
     # badges: [!文本]
     # 不用 display:inline-block：公众号对非常规 display 值支持不稳定，
     # 徽章是纯行内元素，padding 足够撑开视觉。
-    text = re.sub(
-        r"\[!([^\]]+)\]",
+    text = INLINE_BADGE_RE.sub(
         r'<span style="font-size:11px;line-height:1.6;'
         r'color:' + theme["accent"] + r';background:' + theme["accent_soft"] + r';'
         r'padding:1px 6px;border-radius:2px;margin:0 2px;'
@@ -411,8 +444,7 @@ def render_inline(raw):
     )
 
     # ==高亮== before bold so inner markup still works
-    text = re.sub(
-        r"==([^=]+)==",
+    text = INLINE_HL_RE.sub(
         r'<strong style="font-weight:600;color:' + theme["text_strong"] + r';'
         r'background:' + theme["accent_soft"] + r';padding:1px 3px;'
         r'border-radius:2px;">\1</strong>',
@@ -424,20 +456,19 @@ def render_inline(raw):
     underline = ('<span style="border-bottom:2px solid %s;font-weight:600;'
                  'color:%s;">\\1</span>'
                  % (theme["accent_light"], theme["text_strong"]))
-    text = re.sub(r"\+\+([^+]+)\+\+", underline, text)
-    text = re.sub(r"&lt;u&gt;(.+?)&lt;/u&gt;", underline, text)
+    text = INLINE_UNDER_RE.sub(underline, text)
+    text = INLINE_U_RE.sub(underline, text)
 
     # ~~荧光笔~~：半高亮。用纯色浅底，不用 linear-gradient
     # （渐变在公众号会被静默丢弃，退化成无底）。
-    text = re.sub(
-        r"~~([^~]+)~~",
+    text = INLINE_MARK_RE.sub(
         r'<span style="background:%s;font-weight:600;color:%s;">\1</span>'
         % (theme["accent_soft"], theme["text_strong"]),
         text,
     )
 
-    text = re.sub(r"\*\*([^*]+)\*\*", r'<strong style="%s">\1</strong>' % strong, text)
-    text = re.sub(r"(?<![*\w])\*([^*\n]+)\*(?!\*)", r'<em style="%s">\1</em>' % em, text)
+    text = INLINE_STRONG_RE.sub(r'<strong style="%s">\1</strong>' % strong, text)
+    text = INLINE_EM_RE.sub(r'<em style="%s">\1</em>' % em, text)
 
     for idx, code in enumerate(spans):
         text = text.replace(
@@ -454,12 +485,12 @@ def render_inline(raw):
 HEADING_RE = re.compile(r"^(#{1,6})\s+(.*)$")
 FENCE_RE = re.compile(r"^```(\w*)\s*$")
 HR_RE = re.compile(r"^(-{3,}|\*{3,}|_{3,})\s*$")
-IMG_ONLY_RE = re.compile(r"^!\[([^\]]*)\]\(([^)\s]+)\)\s*$")
+IMG_ONLY_RE = re.compile(r"^!\[([^\]]*)\]\(([^)\s]+)(?:\s+\"[^\"]*\")?\)\s*$")
 CAPTION_RE = re.compile(r"^\*(.+)\*\s*$")
 TABLE_SEP_RE = re.compile(r"^\|?[\s:|-]+\|[\s:|-]*$")
 CONTAINER_RE = re.compile(r"^:::+\s*(\w+)?\s*(.*)$")
 
-CN_NUM = "一二三四五六七八九十"
+CN_NUM = "一二三四五六七八九十壹贰叁肆伍陆柒捌玖拾"
 
 # 标题里手写的中文/阿拉伯序号。序号应由排版层生成（可换样式、可加引用），
 # 写进标题文本后就变成了不可编程的字符串。这里统一剥离后重新编号。
@@ -741,10 +772,13 @@ def render_table_cards(head, body, theme):
 
 
 def render_hr(theme):
-    # 宽度用百分比：公众号端 px 固定值在不同屏宽下表现不一致
-    return ('<p style="text-align:center;margin:32px 0;">'
-            '<span style="display:inline-block;width:12%%;height:2px;'
-            'background:%s;"></span></p>' % theme["accent"])
+    # 宽度用百分比：公众号端 px 固定值在不同屏宽下表现不一致。
+    # 不用 display:inline-block：audit_inline 会把它判为 WARN，而这是生成器
+    # 自己的输出、用户无从修复——自检永远带一条洗不掉的 WARN 等于没有自检。
+    # 块级 section + margin:0 auto 居中，视觉与原来完全一致。
+    return ('<section style="margin:32px 0;">'
+            '<section style="width:12%%;height:2px;background:%s;'
+            'margin:0 auto;"></section></section>' % theme["accent"])
 
 
 def render_figure(src, caption, theme, alt=""):
@@ -880,6 +914,10 @@ def resolve_image(src, md_path, out_dir, assets, asset_root):
         if os.path.exists(candidate):
             abs_path = candidate
     if not os.path.exists(abs_path):
+        # 本地文件缺失：登记缺失记录再返回原 src（HTML 保留占位 <img>，
+        # embed 会跳过并提示"未内嵌"，上传清单与计数也不会漏掉这一项）
+        assets.append({"src": src, "local": None, "remote": False,
+                       "missing": True})
         return src
     img_dir = os.path.join(out_dir, "images")
     os.makedirs(img_dir, exist_ok=True)
@@ -1099,8 +1137,14 @@ def convert(md_text, md_path, out_dir, theme, link_mode="footnote",
     CTX["theme"] = theme
     CTX["link_mode"] = link_mode
     CTX["footnotes"] = ctx["footnotes"]
+    CTX["footnote_idx"] = {}
     CTX["use_pangu"] = use_pangu
     CTX["hl_scheme"] = build_code_scheme(theme)
+    # 行内图片解析器：render_inline 里的 ![alt](src) 通过它走 resolve_image，
+    # 与独立成行的图片共享「复制到 images/ + 登记清单」管线。
+    abs_md = os.path.abspath(md_path)
+    CTX["img_resolve"] = lambda s: resolve_image(
+        s, abs_md, out_dir, ctx["assets"], ctx.get("asset_root"))
 
     body = convert_blocks(lines, md_path, out_dir, theme, ctx)
 
@@ -1324,6 +1368,26 @@ def build_notice(embedded, n_images):
     return head + tail
 
 
+# audit_inline 的值级检查：原来是 8 次全正文 re.search（re.I 下每次都扫完整 MB 级
+# body，大正文里 audit_inline 能占近一半耗时）。合并为一次单遍扫描：命中哪个分支
+# 报哪条，收集命中的分支序号后按原列表顺序输出——与原来逐条 search 的结果完全一致。
+_AUDIT_VALUE_PATTERNS = [
+    ("linear-gradient", "ERROR", "linear-gradient（渐变被静默丢弃，退化成无背景。改纯色）"),
+    ("box-shadow", "ERROR", "box-shadow（阴影被丢弃）"),
+    ("rgba\\(|hsla\\(", "ERROR", "rgba()/hsla() 颜色（透明度不被支持，改纯色十六进制）"),
+    ("var\\(--", "ERROR", "CSS 变量（不支持，值必须写死）"),
+    ("@media|@keyframes", "ERROR", "@media/@keyframes（媒体查询与动画不被支持）"),
+    ("\\sclass=", "ERROR", "class 属性（公众号会剥离，样式必须内联）"),
+    ("\\sid=", "WARN", "id 属性（正文里无意义，可能被剥离）"),
+    ("<img[^>]*width=\"", "WARN", "<img> 上的 width 属性（公众号不保证保留，宽度用内联 style）"),
+]
+_AUDIT_VALUE_RE = re.compile(
+    "|".join("(?P<g%d>%s)" % (i, pat)
+             for i, (pat, _lv, _msg) in enumerate(_AUDIT_VALUE_PATTERNS)),
+    re.I,
+)
+
+
 def audit_inline(body):
     """正文的平台合规自检，返回 [(级别, 说明)]，空列表即通过。
 
@@ -1383,18 +1447,15 @@ def audit_inline(body):
             elif prop == "border-radius":
                 add("WARN", "border-radius（圆角可能被丢弃，降级为直角；属可接受的优雅降级，勿依赖圆角做视觉区分）")
 
-    for pat, lv, msg in [
-        (r"linear-gradient", "ERROR", "linear-gradient（渐变被静默丢弃，退化成无背景。改纯色）"),
-        (r"box-shadow", "ERROR", "box-shadow（阴影被丢弃）"),
-        (r"rgba\(|hsla\(", "ERROR", "rgba()/hsla() 颜色（透明度不被支持，改纯色十六进制）"),
-        (r"var\(--", "ERROR", "CSS 变量（不支持，值必须写死）"),
-        (r"@media|@keyframes", "ERROR", "@media/@keyframes（媒体查询与动画不被支持）"),
-        (r"\sclass=", "ERROR", "class 属性（公众号会剥离，样式必须内联）"),
-        (r"\sid=", "WARN", "id 属性（正文里无意义，可能被剥离）"),
-        (r"<img[^>]*width=\"", "WARN", "<img> 上的 width 属性（公众号不保证保留，宽度用内联 style）"),
-    ]:
-        if re.search(pat, body, re.I):
-            add(lv, msg)
+    hit = set()
+    for m in _AUDIT_VALUE_RE.finditer(body):
+        for i in range(len(_AUDIT_VALUE_PATTERNS)):
+            if m.group("g%d" % i) is not None:
+                hit.add(i)
+                break
+    for i in sorted(hit):
+        _pat, lv, msg = _AUDIT_VALUE_PATTERNS[i]
+        add(lv, msg)
 
     # ---- 图片宽度：小图被拉伸是高频问题
     for m in re.finditer(r'<img[^>]*style="([^"]*)"', body):
@@ -1414,6 +1475,22 @@ def audit_inline(body):
     return out
 
 
+def atomic_write(path, text):
+    """原子写文件：先写临时文件再 rename，写一半失败（磁盘满/断电）时
+    不会留下半截产物——要么是旧文件，要么是没有文件，绝不残缺。"""
+    tmp = path + ".tmp"
+    try:
+        with open(tmp, "w", encoding="utf-8") as fh:
+            fh.write(text)
+        os.replace(tmp, path)
+    except BaseException:
+        try:
+            os.unlink(tmp)
+        except OSError:
+            pass
+        raise
+
+
 def write_manifest(out_dir, slug, title, assets, diagrams, theme, footnotes,
                    embedded=False):
     lines = ["# 图片上传清单 · %s" % title, ""]
@@ -1435,9 +1512,12 @@ def write_manifest(out_dir, slug, title, assets, diagrams, theme, footnotes,
                 size = "%.0f KB" % kb if kb < 1024 else "%.1f MB" % (kb / 1024)
             if a.get("remote"):
                 lines.append("| %d | %s（远程） | %s | `%s` |" % (idx, a["src"], size, a["src"]))
+            elif a.get("missing"):
+                lines.append("| %d | ⚠ 本地文件缺失：`%s` | — | `%s` |"
+                             % (idx, a["src"], a["src"]))
             else:
                 lines.append("| %d | `%s` | %s | `%s` |"
-                             % (idx, a.get("basename", ""), size, a["src"]))
+                             % (idx, a.get("basename") or "", size, a["src"]))
         lines.append("")
         lines.append("图片目录：`images/`（公众号单图建议 < 2 MB，宽度 1080 px 左右）")
         lines.append("")
@@ -1472,8 +1552,7 @@ def write_manifest(out_dir, slug, title, assets, diagrams, theme, footnotes,
                     theme.get("h2_style", "number"),
                     theme.get("code_scheme", "mono")))
     path = os.path.join(out_dir, "图片上传清单.md")
-    with open(path, "w", encoding="utf-8") as fh:
-        fh.write("\n".join(lines))
+    atomic_write(path, "\n".join(lines))
     return path
 
 
@@ -1522,8 +1601,13 @@ def main():
         sys.exit("错误：找不到输入文件 %s" % args.input)
 
     theme = load_theme(args.theme)
-    with open(args.input, encoding="utf-8") as fh:
-        md_text = fh.read()
+    try:
+        with open(args.input, encoding="utf-8") as fh:
+            md_text = fh.read()
+    except UnicodeDecodeError:
+        sys.exit("错误：输入文件不是有效的 UTF-8 编码 %s" % args.input)
+    except OSError as e:
+        sys.exit("错误：无法读取输入文件 %s（%s）" % (args.input, e))
 
     os.makedirs(args.out_dir, exist_ok=True)
     body, assets, diagrams, footnotes = convert(
@@ -1560,8 +1644,7 @@ def main():
                             embed_stats["count"] if embed_stats else len(assets)),
     )
     html_path = os.path.join(args.out_dir, "%s-公众号版.html" % args.slug)
-    with open(html_path, "w", encoding="utf-8") as fh:
-        fh.write(page)
+    atomic_write(html_path, page)
 
     manifest = write_manifest(args.out_dir, args.slug, title, assets, diagrams,
                               theme, footnotes, embed_stats is not None)

package/topmind-wechat-post/scripts/negative_tests.py

@@ -55,6 +55,38 @@ def main() -> None:
         r = run("sync-status.py", ["--set", "定稿", str(td / "nope-pkg")])
         check("sync-status 缺失包干净报错", r.returncode != 0 and "Traceback" not in r.stderr, r.stderr[:100])
 
+        # 6. md2wechat 行内图片走图片管线（复制/embed/清单/计数）
+        png = ("iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk"
+               "+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==")
+        import base64 as _b64
+        (td / "a.png").write_bytes(_b64.b64decode(png))
+        (td / "inline.md").write_text(
+            "# t\n\n段落 ![行内图](a.png) 后续文字。\n", encoding="utf-8")
+        r = run("md2wechat.py", ["--input", str(td / "inline.md"),
+                                 "--out-dir", str(td / "o6"), "--slug", "t6",
+                                 "--embed-images"])
+        html = (td / "o6" / "t6-公众号版.html").read_text(encoding="utf-8")
+        manifest = (td / "o6" / "图片上传清单.md").read_text(encoding="utf-8")
+        check("md2wechat 行内图片被内嵌", r.returncode == 0 and
+              "data:image/png;base64," in html, r.stdout[:200])
+        check("md2wechat 行内图片进清单", "a.png" in manifest)
+
+        # 7. md2wechat 大写数字序号同样被剥离
+        (td / "num.md").write_text(
+            "# t\n\n## 第叁章 大写序号\n\n正文。\n", encoding="utf-8")
+        r = run("md2wechat.py", ["--input", str(td / "num.md"),
+                                 "--out-dir", str(td / "o7"), "--slug", "t7"])
+        html = (td / "o7" / "t7-公众号版.html").read_text(encoding="utf-8")
+        check("md2wechat 大写数字序号剥离",
+              "第叁章" not in html and ">01</span>" in html)
+
+        # 8. md2wechat 分隔线不触发自家合规 WARN（inline-block）
+        (td / "hr.md").write_text("# t\n\n---\n\n正文。\n", encoding="utf-8")
+        r = run("md2wechat.py", ["--input", str(td / "hr.md"),
+                                 "--out-dir", str(td / "o8"), "--slug", "t8"])
+        check("md2wechat 分隔线无 inline-block 告警",
+              "inline-block" not in r.stdout, r.stdout[:200])
+
     if fails:
         print(f"\n[negative_tests] {len(fails)} 项失败")
         sys.exit(1)

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

@@ -4,6 +4,8 @@
 
 Turn a Markdown draft into a "copy → paste → publish" X long-form (Article) package.
 
+- Version: **v0.1.0** (same tag as `@topmindspace/tms-skills@0.3.5`)
+
 ## Install
 
 ```bash
@@ -23,10 +25,47 @@ python3 scripts/md2x.py <draft>.md --out <package>/X发布稿.txt
 
 ## Conversion rules
 
-The X Article editor has weak, unstable markdown support, so `md2x.py` converts to plain text per `references/x-format.md`: headings → plain text lines, horizontal rules (`---` / `***` / `___`) → blank lines, bold/italic markers removed (including `***bold-italic***`), links → `text（url）`, images → `[图N]` (image list appended at the end), tables → "item: value" lists.
+The X Article editor has weak, unstable markdown support, so `md2x.py` converts to plain text per `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, `\` escapes restored.
 
 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.

package/topmind-x-article/README.md

@@ -4,6 +4,8 @@
 
 把 Markdown 原稿变成"复制 → 粘贴 → 发"的 X 长文（Article）发布包。
 
+- 版本：**v0.1.0**（与 `@topmindspace/tms-skills@0.3.5` 同 tag）
+
 ## 安装
 
 ```bash
@@ -24,12 +26,48 @@ python3 scripts/md2x.py <原稿>.md --out <包>/X发布稿.txt
 ## 转换规则
 
 X Article 编辑器对 markdown 支持弱且不稳定，`md2x.py` 按 `references/x-format.md`
-转纯文本：标题→纯文本行、分隔线（`---` / `***` / `___`）→空行、加粗/斜体去标记
-（含 `***粗斜体***`）、链接→`文字（url）`、图片→`[图N]`（文末附配图清单）、
-表格→"项：值"列表。
+转纯文本：标题→纯文本行、分隔线→空行、加粗/斜体/行内代码去标记、链接→`文字（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 不发长文。
@@ -40,7 +78,7 @@ X 长文目前走人工粘贴发布（X Article 编辑器），API 不发长文
 以下技能**不在本仓库**（一般随用户侧 workbuddy 环境提供）。缺失时对应路由能力
 不可用，不影响本技能核心流程（原稿转文本、封面、发布清单）：
 
-- `topmind-x`：280 字短推文发布（其 xurl 只覆盖短推文，不发长文）。
+- `topmind-x`：280 字短推文发布（xurl 只覆盖短推文，不发长文）。
 - `topmind-capture`：「只想存档不发布」时的收录路由。
 
 ## 开发

package/topmind-x-article/SKILL.md

@@ -1,16 +1,22 @@
 ---
 name: topmind-x-article
 version: 0.1.0
-description: "X 长文（Article）一键发布：Markdown 原稿 → 可直接粘贴的 X发布稿.txt + 封面图 + 发布清单。沉淀自实战。Use when X 长文、发 X 文章、X article、长文发 X。Do NOT use for 短推文（→ topmind-x）、公众号。"
+description: "X 长文（Article）一键发布：Markdown 原稿 → 可直接粘贴的 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/tms-skills#readme
@@ -49,11 +55,10 @@ updated: 2026-09-29
 └── 发布清单.md        # 本次发布 checklist（含时间、链接）
 ```
 
-## Manus 2.0 实战沉淀
+## 实战沉淀
 
 - 补充信息（邀请码、链接、勘误）**不挤正文**，发在发布后首条评论并置顶
-- 长文标题 ≤140 字符，首段 3 行内出钩子
-- 配图逐张按 `[图N]` 顺序上传，传完对照清单点一遍
+- 标题 ≤140 字符，首段 3 行内出钩子；配图逐张按 `[图N]` 顺序上传，传完对照清单点一遍
 - 事实修正只改发布包，不回头改已发原文（除非勘误）
 
 ## When NOT to use
@@ -61,11 +66,12 @@ updated: 2026-09-29
 - 280 字短推文 → `topmind-x`
 - 公众号 → `topmind-wechat-post`
 - 只想存档不发布 → `topmind-capture`
+- 写稿（只有发布需求、无原稿时）→ 先走写作技能再回本技能
 
 ## 外部依赖
 
 以下技能**不在本仓库**（一般随用户侧 workbuddy 环境提供）；缺失时对应路由能力不可用，
 本技能核心流程（原稿转文本、封面、发布清单）不受影响：
 
-- `topmind-x`：280 字短推文发布（其 xurl 只覆盖短推文，不发长文）。
+- `topmind-x`：280 字短推文发布（xurl 只覆盖短推文，不发长文）。
 - `topmind-capture`：「只想存档不发布」时的收录路由。

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

@@ -5,16 +5,19 @@ X Article 编辑器对 markdown 支持弱且不稳定。`md2x.py` 按以下规
 
 | Markdown | 转后 |
 |----------|------|
-| `#` / `##` 标题 | 纯文本行，前后各一空行 |
-| `**加粗**` / `*斜体*` | 去标记留文字（语气靠文字本身） |
-| `[文字](url)` | `文字（url）` |
-| `![](alt)` | `[图N]`，文末附"配图清单" |
-| `-` / `1.` 列表 | 保留原符号 |
-| `>` 引用 | 去 `>` 留文字 |
-| 表格 | 转"项：值"列表；复杂表拆成段落 |
-| `---` 分割线 | 空行 |
-| 代码块 | 去围栏，内容缩进 4 格 |
-| frontmatter | 整块丢弃 |
+| `#` ~ `######` 标题 | 纯文本行，前后各一空行；标题内的加粗/链接等标记同样剥离 |
+| `标题` + 下一行 `===`（Setext 一级标题） | 同上，转纯文本标题行 |
+| `**加粗**` / `*斜体*` / `***粗斜体***` / `~~删除线~~` / `` `行内代码` `` | 去标记留文字（语气靠文字本身） |
+| `[文字](url)` | `文字（url）`；url 里可含括号，`[文字](url "title")` 的 title 丢弃 |
+| `[文字][ref]` / `[文字][]` / `[文字]`（引用式，有 `[ref]: url` 定义） | `文字（url）`；定义行不进正文 |
+| `![alt](url)` / `![alt][ref]` | `[图N]`，文末附"配图清单"（`[图N] alt`；alt 为空记 `（未写图注）`） |
+| `-` / `1.` 列表 | 保留原符号（含嵌套缩进）；`- [ ]` / `- [x]` 任务列表都去勾选框留 `-`（完成状态不保留） |
+| `>` 引用 | 去掉所有层级的 `>` 留文字；引用内的标题照转 |
+| 表格（行首以 `|` 开头的标准写法；不带前导 `|` 的表格暂不转换） | 逐行转"项：值"列表（单元格内标记同样剥离）；分隔行丢弃，复杂表请手动拆成段落 |
+| `---` / `***` / `___` 分割线（允许空格，如 `* * *`） | 空行 |
+| 代码块（``` 围栏；`~~~` 围栏暂不支持） | 去围栏，内容缩进 4 格；块内行原样保留（块内的 `---` 不再误判分割线） |
+| `\` 转义（如 `\*`） | 去反斜杠留字符 |
+| frontmatter | 整块丢弃（块内非空行须都含 `:` 才认定，文首的 `---` 分割线不会被误吞） |
 
 ## 写作时就按 X 想