@topmindspace/tms-skills 0.3.6 → 0.4.1

package/topmind-cover/scripts/crop-cover.py

@@ -31,7 +31,10 @@ def main() -> None:
 
     src = Path(args.src)
     out_dir = Path(args.out_dir)
-    out_dir.mkdir(parents=True, exist_ok=True)
+    try:
+        out_dir.mkdir(parents=True, exist_ok=True)
+    except OSError as e:
+        sys.exit(f"错误：无法创建输出目录 {out_dir}（{e}）")
 
     if not src.is_file():
         sys.exit(f"错误：找不到输入图片 {src}")
@@ -50,18 +53,21 @@ def main() -> None:
     x0, y0 = (w - cw) // 2, (h - ch) // 2
     base = img.crop((x0, y0, x0 + cw, y0 + ch))
 
-    for name, (tw, th) in TARGETS.items():
-        ratio = tw / th
-        bw, bh = base.size
-        if bw / bh > ratio:
-            cw2, ch2 = int(bh * ratio), bh
-        else:
-            cw2, ch2 = bw, int(bw / ratio)
-        x1, y1 = (bw - cw2) // 2, (bh - ch2) // 2
-        out = base.crop((x1, y1, x1 + cw2, y1 + ch2)).resize((tw, th), Image.LANCZOS)
-        dest = out_dir / name
-        out.save(dest)
-        print(f"OK {dest} ({tw}x{th})")
+    try:
+        for name, (tw, th) in TARGETS.items():
+            ratio = tw / th
+            bw, bh = base.size
+            if bw / bh > ratio:
+                cw2, ch2 = int(bh * ratio), bh
+            else:
+                cw2, ch2 = bw, int(bw / ratio)
+            x1, y1 = (bw - cw2) // 2, (bh - ch2) // 2
+            out = base.crop((x1, y1, x1 + cw2, y1 + ch2)).resize((tw, th), Image.LANCZOS)
+            dest = out_dir / name
+            out.save(dest)
+            print(f"OK {dest} ({tw}x{th})")
+    except OSError as e:
+        sys.exit(f"错误：写入封面图失败（{e}）")
 
 
 if __name__ == "__main__":

package/topmind-wechat-post/README.en.md

@@ -4,7 +4,7 @@
 
 Full lifecycle for WeChat articles: delivery package, review & rewrite, three quality gates, status sync, WeChat inline typography, and publish checklist.
 
-- Version: **v0.1.0** (same tag as `@topmindspace/tms-skills@0.3.6`)
+- Version: **v0.1.0** (same tag as `@topmindspace/tms-skills@0.4.1`)
 
 ## Install
 
@@ -60,7 +60,7 @@ Output `demo/demo-公众号版.html` (open in a browser → click "复制正文"
 
 ```html
 <!-- h2 auto-numbered; closing chapters like "总结" get ∞ -->
-<h2 ...><span ...>01</span>Chapter One</h2>
+<h2 ...><span ...>1</span>Chapter One</h2>
 <!-- images inlined as base64, pasted along with the text -->
 <img src="data:image/png;base64,iVBORw0KGgo..." ...>
 ```

package/topmind-wechat-post/README.md

@@ -4,7 +4,7 @@
 
 公众号文章全生命周期：交付包、审校改写、质量三关、状态同步、微信内联排版与发布清单。
 
-- 版本：**v0.1.0**（与 `@topmindspace/tms-skills@0.3.6` 同 tag）
+- 版本：**v0.1.0**（与 `@topmindspace/tms-skills@0.4.1` 同 tag）
 
 ## 安装
 
@@ -59,7 +59,7 @@ python3 scripts/md2wechat.py --input demo.md --out-dir demo --slug demo --embed-
 
 ```html
 <!-- 二级标题自动编号；"总结"类末章编号为 ∞ -->
-<h2 ...><span ...>01</span>第一章</h2>
+<h2 ...><span ...>1</span>第一章</h2>
 <!-- 图片 base64 内嵌，粘贴即带图 -->
 <img src="data:image/png;base64,iVBORw0KGgo..." ...>
 ```

package/topmind-wechat-post/SKILL.md

@@ -50,7 +50,7 @@ updated: 2026-09-29
 | `scripts/scan_ai_flavor.py` | 中文去 AI 味扫描（与 `qu-aiwei-zh` 同源） |
 
 ```bash
-# 路径解析：CLI --base/--workspace → env TOPMIND_WECHAT_BASE / TOPMIND_WORKSPACE / TOPSTREAM_ROOT → 惯例
+# 路径解析：CLI --base → env TOPMIND_WECHAT_BASE / TOPMIND_WORKSPACE / TOPSTREAM_ROOT → 惯例
 export TOPMIND_WORKSPACE=/path/to/workspace   # 推荐
 python3 scripts/new-article.py --slug demo --title "标题" --direction reverse
 python3 scripts/lint-wechat.py --input <包>/公众号稿.md --fix

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

@@ -143,7 +143,7 @@ LANG_RULES = {
     ],
     "yaml": [
         ("comment", r"#[^\n]*"),
-        ("key", r"(?m)^\s*[\w.\-/]+(?=\s*:)"),
+        ("key", r"^\s*[\w.\-/]+(?=\s*:)"),
         ("string", r'"(?:\\.|[^"\\])*"|\'(?:\\.|[^\'\\])*\''),
         ("keyword", r"\b(?:true|false|null|yes|no|on|off)\b"),
         ("number", r"\b\d+\.?\d*\b"),
@@ -157,9 +157,9 @@ LANG_RULES = {
         ("op", r"[=<>!*/+\-]+"),
     ],
     "diff": [
-        ("meta", r"(?m)^@@[^\n]*|^---[^\n]*|^\+\+\+[^\n]*"),
-        ("add", r"(?m)^\+[^\n]*"),
-        ("del", r"(?m)^-[^\n]*"),
+        ("meta", r"^@@[^\n]*|^---[^\n]*|^\+\+\+[^\n]*"),
+        ("add", r"^\+[^\n]*"),
+        ("del", r"^-[^\n]*"),
     ],
     "html": [
         ("comment", r"<!--[\s\S]*?-->"),
@@ -219,7 +219,10 @@ def highlight(code, lang, scheme=None):
     palette = scheme or CTX.get("hl_scheme") or HIGHLIGHT
     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)
+        # (?m) 不能写进单个分支：拼成 alternation 后它就不在表达式开头了，
+        # Python 会报 "global flags not at the start"（历史 crash：```yaml / ```diff
+        # 代码块直接 Traceback）。MULTILINE 在编译期统一加，分支里只留 ^。
+        pattern = re.compile("|".join("(?P<%s>%s)" % (name, pat) for name, pat in rules), re.S | re.M)
         _HL_PATTERN_CACHE[key] = pattern
     out = []
     pos = 0
@@ -294,8 +297,12 @@ def load_theme(spec):
     path = resolve_theme(spec)
     if not path:
         return base
-    with open(path, encoding="utf-8") as fh:
-        data = json.load(fh)
+    try:
+        with open(path, encoding="utf-8") as fh:
+            data = json.load(fh)
+    except (OSError, ValueError) as e:
+        # ValueError 覆盖 json.JSONDecodeError：坏掉的主题文件给干净报错，不抛 Traceback
+        sys.exit("错误：主题文件无法解析 %s（%s）" % (path, e))
     accent = data.get("accent", base["accent"])
     # 主色派生字段必须按「本主题」的主色重算，不能继承默认主题的值：
     # 默认主题的 accent_light / mark_bg 是砖红系，继承过来会让蓝色或灰色主题里
@@ -341,8 +348,67 @@ 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]+)\)")
+
+
+def _parse_paren(s, j):
+    """s[j] == '(' 时找与之匹配的 ')'（括号可嵌套：URL 里允许出现平衡括号，如维基链接）。
+
+    返回 (括号内文本, 右括号之后的位置)；括号不平衡返回 None。
+    """
+    depth = 0
+    k, n = j, len(s)
+    while k < n:
+        c = s[k]
+        if c == "(":
+            depth += 1
+        elif c == ")":
+            depth -= 1
+            if depth == 0:
+                return s[j + 1:k], k + 1
+        k += 1
+    return None
+
+
+# `(url)` / `(url "title")` / `(url 'title')` / `(url (title))` → url（title 丢弃）。
+_URL_TITLE_RE = re.compile(r'^(\S+?)(?:\s+(?:"[^"]*"|\'[^\']*\'|\([^()]*\)))?\s*$')
+
+
+def _split_url_title(inner):
+    """把链接/图片括号内的 `url "title"` 拆出 url（title 丢弃）。
+
+    裸 url 不得含空白：含裸空白时返回 ""（调用方保留原文，
+    与旧正则 `[^)\\s]+` 的行为一致，不静默吞掉）。
+    """
+    m = _URL_TITLE_RE.match(inner.strip())
+    return m.group(1) if m else ""
+
+
+def _scan_md_links(text, img, repl):
+    """扫描替换行内图片/链接，url 括号支持嵌套、可带 "title"。
+
+    img=True 扫 ![alt](src)，False 扫 [label](url)；repl(文本, url) -> 替换串。
+    括号不平衡、url 为空、url 含裸空白时保留原文（旧正则同样认不出这些写法，
+    保留原文比截断 URL 更安全——历史 bug：`![a](img(1).png)` 被截成 `img(1`，
+    文件明明存在却被记成缺失；`[维基](…/猫_(动物))` 的 URL 被截断、正文多个 `)`）。
+    """
+    open_tok = "![" if img else "["
+    skip = len(open_tok)
+    res = []
+    i, n = 0, len(text)
+    while i < n:
+        if text.startswith(open_tok, i):
+            k = text.find("]", i + skip)
+            if k != -1 and k + 1 < n and text[k + 1] == "(":
+                parsed = _parse_paren(text, k + 1)
+                if parsed:
+                    url = _split_url_title(parsed[0])
+                    if url:
+                        res.append(repl(text[i + skip:k], url))
+                        i = parsed[1]
+                        continue
+        res.append(text[i])
+        i += 1
+    return "".join(res)
 INLINE_BADGE_RE = re.compile(r"\[!([^\]]+)\]")
 INLINE_HL_RE = re.compile(r"==([^=]+)==")
 INLINE_UNDER_RE = re.compile(r"\+\+([^+]+)\+\+")
@@ -390,9 +456,8 @@ def render_inline(raw):
     strong = 'font-weight:600;color:%s;' % theme["text_strong"]
     em = 'font-style:normal;color:%s;' % theme["text_muted"]
 
-    # images（行内图与独立成行图共用同一正则语义）
-    def img_repl(m):
-        alt, src = m.group(1), m.group(2)
+    # images（行内图与独立成行图共用同一括号语义）
+    def img_repl(alt, src):
         # 行内图片同样走图片管线：本地文件解析 → 复制到 images/ → 登记清单，
         # 否则 --embed-images 找不到文件、清单漏项、计数为 0（历史 bug：
         # 段落里的 ![alt](x.png) 被原样保留相对路径，粘贴到公众号后整图消失）。
@@ -403,11 +468,13 @@ def render_inline(raw):
         return ('<img src="%s"%s style="max-width:100%%;height:auto;'
                 'border-radius:3px;vertical-align:middle;">') % (src, caption)
 
-    text = INLINE_IMG_RE.sub(img_repl, text)
+    text = _scan_md_links(text, True, img_repl)
 
     # links
-    def link_repl(m):
-        label, url = m.group(1), m.group(2)
+    def link_repl(label, url):
+        # 入口处已 esc()：先还原，插入点与脚注登记处再按需转义。
+        # 否则脚注列表里 URL 的 & 会被 esc 两次、显示成 &amp;（历史 bug）。
+        label, url = html.unescape(label), html.unescape(url)
         if link_mode == "footnote" and footnotes is not None:
             # url→序号字典：原写法每次链接都扫全表两次（O(n²)），长文链接多时明显变慢
             fidx = CTX.get("footnote_idx")
@@ -423,14 +490,14 @@ def render_inline(raw):
                 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))
+                    % (esc(label), theme["accent"], idx))
         if link_mode == "inline":
             return ('%s<span style="font-size:13px;color:%s;">（%s）</span>'
-                    % (label, theme["text_light"], url))
+                    % (esc(label), theme["text_light"], esc(url)))
         return ('<span style="font-size:13px;color:%s;word-break:break-all;">'
-                '%s（%s）</span>' % (theme["text_light"], label, url))
+                '%s（%s）</span>' % (theme["text_light"], esc(label), esc(url)))
 
-    text = INLINE_LINK_RE.sub(link_repl, text)
+    text = _scan_md_links(text, False, link_repl)
 
     # badges: [!文本]
     # 不用 display:inline-block：公众号对非常规 display 值支持不稳定，
@@ -483,9 +550,33 @@ def render_inline(raw):
 # ---------------------------------------------------------------- blocks
 
 HEADING_RE = re.compile(r"^(#{1,6})\s+(.*)$")
-FENCE_RE = re.compile(r"^```(\w*)\s*$")
+# 围栏反引号数 >= 3：```` 开栏只能由 >= 4 反引号闭合（CommonMark），
+# 否则 markdown 示例代码里的内层 ``` 会把外层栏提前"闭合"，造成静默错排。
+FENCE_RE = re.compile(r"^(`{3,})(\w*)\s*$")
 HR_RE = re.compile(r"^(-{3,}|\*{3,}|_{3,})\s*$")
-IMG_ONLY_RE = re.compile(r"^!\[([^\]]*)\]\(([^)\s]+)(?:\s+\"[^\"]*\")?\)\s*$")
+
+
+def match_img_only(line):
+    """独立成行图片：![alt](src) 独占一行（src 括号可嵌套、可带 title）。
+
+    返回 (alt, src)，不是独立成行图片返回 None。
+    与行内图片共用同一括号语义（_parse_paren + _split_url_title）。
+    """
+    if not line.startswith("!["):
+        return None
+    k = line.find("]", 2)
+    if k == -1:
+        return None
+    j = k + 1
+    if j >= len(line) or line[j] != "(":
+        return None
+    parsed = _parse_paren(line, j)
+    if not parsed:
+        return None
+    src = _split_url_title(parsed[0])
+    if not src or line[parsed[1]:].strip():
+        return None
+    return line[2:k], src
 CAPTION_RE = re.compile(r"^\*(.+)\*\s*$")
 TABLE_SEP_RE = re.compile(r"^\|?[\s:|-]+\|[\s:|-]*$")
 CONTAINER_RE = re.compile(r"^:::+\s*(\w+)?\s*(.*)$")
@@ -920,7 +1011,10 @@ def resolve_image(src, md_path, out_dir, assets, asset_root):
                        "missing": True})
         return src
     img_dir = os.path.join(out_dir, "images")
-    os.makedirs(img_dir, exist_ok=True)
+    try:
+        os.makedirs(img_dir, exist_ok=True)
+    except OSError as e:
+        sys.exit("错误：无法创建图片目录 %s（%s）" % (img_dir, e))
     base = os.path.basename(abs_path)
     target = os.path.join(img_dir, base)
     n = 1
@@ -929,7 +1023,10 @@ def resolve_image(src, md_path, out_dir, assets, asset_root):
         target = os.path.join(img_dir, "%s-%d%s" % (stem, n, ext))
         n += 1
     if not os.path.exists(target):
-        shutil.copy2(abs_path, target)
+        try:
+            shutil.copy2(abs_path, target)
+        except OSError as e:
+            sys.exit("错误：复制图片失败 %s → %s（%s）" % (abs_path, target, e))
     rel = os.path.relpath(target, out_dir)
     assets.append({"src": src, "local": rel, "remote": False,
                    "basename": os.path.basename(target),
@@ -1002,10 +1099,20 @@ def convert_blocks(lines, md_path, out_dir, theme, ctx):
 
         m = FENCE_RE.match(stripped)
         if m:
-            lang = m.group(1)
+            open_len = len(m.group(1))
+            lang = m.group(2)
             i += 1
             buf = []
-            while i < n and not lines[i].strip().startswith("```"):
+            while i < n:
+                s2 = lines[i].strip()
+                k = 0
+                while k < len(s2) and s2[k] == "`":
+                    k += 1
+                # 闭合栏：反引号数 >= 开栏数且后面无其它字符（闭合栏可比开栏长）。
+                # 带信息串的 ```python 不是闭合栏，是栏内代码——旧写法按
+                # startswith("```") 判闭合，会把栏提前关掉。
+                if k >= open_len and not s2[k:].strip():
+                    break
                 buf.append(lines[i])
                 i += 1
             i += 1
@@ -1080,7 +1187,7 @@ def convert_blocks(lines, md_path, out_dir, theme, ctx):
             out.append(block_html)
             continue
 
-        m = IMG_ONLY_RE.match(stripped)
+        m = match_img_only(stripped)
         if m:
             caption = None
             if i + 1 < n:
@@ -1088,9 +1195,9 @@ def convert_blocks(lines, md_path, out_dir, theme, ctx):
                 if cm:
                     caption = cm.group(1)
                     i += 1
-            src = resolve_image(m.group(2), md_path, out_dir,
+            src = resolve_image(m[1], md_path, out_dir,
                                 ctx["assets"], ctx["asset_root"])
-            out.append(render_figure(src, caption, theme, alt=m.group(1)))
+            out.append(render_figure(src, caption, theme, alt=m[0]))
             i += 1
             continue
 
@@ -1101,7 +1208,7 @@ def convert_blocks(lines, md_path, out_dir, theme, ctx):
             if (not cur or HEADING_RE.match(cur) or HR_RE.match(cur)
                     or CONTAINER_RE.match(cur) or cur.startswith(">")
                     or cur.startswith("|") or is_list_item(lines[i])
-                    or IMG_ONLY_RE.match(cur) or FENCE_RE.match(cur)):
+                    or match_img_only(cur) or FENCE_RE.match(cur)):
                 break
             buf.append(cur)
             i += 1
@@ -1597,6 +1704,8 @@ def main():
     if missing:
         sys.exit("缺少必填参数：%s" % "、".join(missing))
 
+    if os.path.isdir(args.input):
+        sys.exit("错误：输入是目录不是文件 %s" % args.input)
     if not os.path.isfile(args.input):
         sys.exit("错误：找不到输入文件 %s" % args.input)
 
@@ -1609,7 +1718,10 @@ def main():
     except OSError as e:
         sys.exit("错误：无法读取输入文件 %s（%s）" % (args.input, e))
 
-    os.makedirs(args.out_dir, exist_ok=True)
+    try:
+        os.makedirs(args.out_dir, exist_ok=True)
+    except OSError as e:
+        sys.exit("错误：无法创建输出目录 %s（%s）" % (args.out_dir, e))
     body, assets, diagrams, footnotes = convert(
         md_text, os.path.abspath(args.input), args.out_dir, theme,
         args.link_mode, args.render_mermaid, args.asset_root or None,

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

@@ -87,6 +87,80 @@ def main() -> None:
         check("md2wechat 分隔线无 inline-block 告警",
               "inline-block" not in r.stdout, r.stdout[:200])
 
+        # 9. 括号 URL 不被截断（链接与图片；历史 bug：`![a](img(1).png)` 被截成
+        #    `img(1` 导致真实文件记成缺失；`[维基](…/猫_(动物))` 的 URL 被截断、
+        #    正文多个悬挂 `)`；`[t](url "title")` 被原样保留）
+        (td / "img(1).png").write_bytes(_b64.b64decode(png))
+        (td / "paren.md").write_text(
+            "# t\n\n![括号图](img(1).png)\n\n"
+            "[维基](https://zh.wikipedia.org/wiki/猫_(动物)) 与 "
+            "[带title](https://example.com/a \"标题文字\")。\n",
+            encoding="utf-8")
+        r = run("md2wechat.py", ["--input", str(td / "paren.md"),
+                                 "--out-dir", str(td / "o9"), "--slug", "t9",
+                                 "--no-toc", "--signature", "off"])
+        html = (td / "o9" / "t9-公众号版.html").read_text(encoding="utf-8")
+        check("md2wechat 括号图片不截断",
+              'src="images/img(1).png"' in html and (td / "o9" / "images" / "img(1).png").exists(),
+              r.stdout[:200])
+        check("md2wechat 括号链接不截断",
+              "猫_(动物)" in html and ")</sup>" not in html,
+              r.stdout[:200])
+        check("md2wechat title 链接被转换",
+              "https://example.com/a" in html and '[带title](' not in html,
+              r.stdout[:200])
+
+        # 10. 脚注 URL 的 & 不双重转义（历史 bug：显示成 &amp;）
+        (td / "amp.md").write_text(
+            "# t\n\n[和号](https://x.com/?a=1&b=2)\n", encoding="utf-8")
+        r = run("md2wechat.py", ["--input", str(td / "amp.md"),
+                                 "--out-dir", str(td / "o10"), "--slug", "t10",
+                                 "--no-toc", "--signature", "off"])
+        html = (td / "o10" / "t10-公众号版.html").read_text(encoding="utf-8")
+        check("md2wechat 脚注 URL 不双重转义",
+              "a=1&amp;b=2" in html and "&amp;amp;" not in html)
+
+        # 11. 坏主题 JSON 干净报错（历史 crash：json Traceback）
+        (td / "bad-theme.json").write_text("{bad json", encoding="utf-8")
+        (td / "t11.md").write_text("# t\n\n正文。\n", encoding="utf-8")
+        r = run("md2wechat.py", ["--input", str(td / "t11.md"),
+                                 "--out-dir", str(td / "o11"), "--slug", "t11",
+                                 "--theme", str(td / "bad-theme.json")])
+        check("md2wechat 坏主题 JSON 干净报错",
+              r.returncode != 0 and "Traceback" not in r.stderr, r.stderr[:100])
+
+        # 12. 目录当输入：文案明确（与 md2x 一致），非零干净退出
+        r = run("md2wechat.py", ["--input", str(td),
+                                 "--out-dir", str(td / "o12"), "--slug", "t12"])
+        check("md2wechat 目录输入文案正确",
+              r.returncode != 0 and "输入是目录不是文件" in r.stderr
+              and "Traceback" not in r.stderr, r.stderr[:100])
+
+        # 13. yaml/diff 代码块不高亮 crash（历史 crash：(?m) 拼进 alternation
+        #     报 "global flags not at the start"，任何 ```yaml 块都 Traceback）
+        (td / "hl.md").write_text(
+            "# t\n\n```yaml\nkey: value\n```\n\n```diff\n+add\n-del\n```\n",
+            encoding="utf-8")
+        r = run("md2wechat.py", ["--input", str(td / "hl.md"),
+                                 "--out-dir", str(td / "o13"), "--slug", "t13"])
+        html = (td / "o13" / "t13-公众号版.html").read_text(encoding="utf-8")
+        check("md2wechat yaml/diff 代码块不崩溃",
+              r.returncode == 0 and "Traceback" not in r.stderr
+              and "key" in html, r.stderr[:100])
+
+        # 14. 嵌套围栏：```` 开栏不被内层 ``` 提前闭合
+        (td / "nest.md").write_text(
+            "# t\n\n````markdown\n外层\n```python\nprint(1)\n```\n结束\n````\n",
+            encoding="utf-8")
+        r = run("md2wechat.py", ["--input", str(td / "nest.md"),
+                                 "--out-dir", str(td / "o14"), "--slug", "t14",
+                                 "--no-toc", "--signature", "off"])
+        html = (td / "o14" / "t14-公众号版.html").read_text(encoding="utf-8")
+        body = html.split('<article id="wx-body"')[1]
+        check("md2wechat 嵌套围栏不提前闭合",
+              r.returncode == 0 and "````markdown" not in body
+              and body.count("MARKDOWN</section>") == 1, r.stderr[:100])
+
     if fails:
         print(f"\n[negative_tests] {len(fails)} 项失败")
         sys.exit(1)

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

@@ -4,7 +4,7 @@
 
 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.6`)
+- Version: **v0.1.0** (same tag as `@topmindspace/tms-skills@0.4.1`)
 
 ## Install
 

package/topmind-x-article/README.md

@@ -4,7 +4,7 @@
 
 把 Markdown 原稿变成"复制 → 粘贴 → 发"的 X 长文（Article）发布包。
 
-- 版本：**v0.1.0**（与 `@topmindspace/tms-skills@0.3.6` 同 tag）
+- 版本：**v0.1.0**（与 `@topmindspace/tms-skills@0.4.1` 同 tag）
 
 ## 安装
 

package/topmind-x-article/scripts/md2x.py

@@ -193,6 +193,7 @@ def convert(md: str):
     defs = {}
     out_lines = []
     in_code = False
+    fence_len = 0
 
     md, esc_store = _protect_escapes(md)
     md = _strip_frontmatter(md)
@@ -209,9 +210,23 @@ def convert(md: str):
     for raw in body:
         line = raw.rstrip()
 
-        # 代码块：先处理围栏，块内行原样缩进（分割线规则不进代码块）
-        if line.strip().startswith("```"):
-            in_code = not in_code
+        # 代码块：先处理围栏，块内行原样缩进（分割线规则不进代码块）。
+        # 围栏反引号数 >= 3：```` 开栏只能由 >= 4 反引号闭合（CommonMark），
+        # 否则 markdown 示例里的内层 ``` 会把外层栏提前"闭合"，造成静默错排。
+        stripped = line.strip()
+        if stripped.startswith("```"):
+            k = 0
+            while k < len(stripped) and stripped[k] == "`":
+                k += 1
+            if not in_code:
+                in_code = True
+                fence_len = k
+            elif k >= fence_len and not stripped[k:].strip():
+                in_code = False
+                fence_len = 0
+            else:
+                # 栏内误写的短栏 / 带信息串的栏是代码内容，不是闭合栏
+                out_lines.append("    " + line)
             continue
         if in_code:
             out_lines.append("    " + line)
@@ -281,6 +296,8 @@ def main() -> None:
 
     inp = Path(args.input)
     if not inp.is_file():
+        if inp.is_dir():
+            sys.exit(f"错误：输入是目录不是文件 {inp}")
         sys.exit(f"错误：找不到输入文件 {inp}")
     try:
         md = inp.read_text(encoding="utf-8-sig")
@@ -291,8 +308,11 @@ def main() -> None:
     text, images = convert(md)
 
     out = Path(args.out)
-    out.parent.mkdir(parents=True, exist_ok=True)
-    out.write_text(text, encoding="utf-8")
+    try:
+        out.parent.mkdir(parents=True, exist_ok=True)
+        out.write_text(text, encoding="utf-8")
+    except OSError as e:
+        sys.exit(f"错误：无法写入输出文件 {out}（{e}）")
 
     chars = len(text.replace("\n", ""))
     print(f"OK {out}")

package/topmind-x-article/scripts/negative_tests.py

@@ -64,6 +64,23 @@ def main() -> None:
         out = (td / "o6.txt").read_text(encoding="utf-8") if (td / "o6.txt").exists() else ""
         check("正常输入含配图清单", r.returncode == 0 and "[图1]" in out)
 
+        # 7. 嵌套围栏：```` 开栏不被内层 ``` 提前闭合（内层栏是代码内容）
+        (td / "nest.md").write_text(
+            "# t\n\n````markdown\n外层\n```python\nprint(1)\n```\n结束\n````\n",
+            encoding="utf-8")
+        r = run([str(td / "nest.md"), "--out", str(td / "o7.txt")])
+        out = (td / "o7.txt").read_text(encoding="utf-8") if (td / "o7.txt").exists() else ""
+        check("嵌套围栏不提前闭合",
+              r.returncode == 0 and "    ```python" in out and "print(1)" in out)
+
+        # 8. 括号 URL 链接不断裂（与 md2wechat 对齐的守卫）
+        (td / "paren.md").write_text(
+            "# t\n\n[维基](https://zh.wikipedia.org/wiki/猫_(动物))\n", encoding="utf-8")
+        r = run([str(td / "paren.md"), "--out", str(td / "o8.txt")])
+        out = (td / "o8.txt").read_text(encoding="utf-8") if (td / "o8.txt").exists() else ""
+        check("括号 URL 不截断",
+              r.returncode == 0 and "猫_(动物)" in out)
+
     if fails:
         print(f"\n[negative_tests] {len(fails)} 项失败")
         sys.exit(1)