@topmindspace/tms-skills 0.2.0 → 0.3.1

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

@@ -2,7 +2,7 @@
 """封面图裁剪：从 16:9 主图中央裁出公众号 2.35:1 版，并统一落盘命名。
 
 用法：
-    python3 crop-cover.py <主图路径> --slug <slug> --out-dir <包>/images/
+    python3 crop-cover.py <主图路径> --out-dir <包>/images/
 
 产出：
     <out-dir>/00-封面.png          1200x675  (X / 公众号共用主文件)
@@ -26,7 +26,6 @@ TARGETS = {
 def main() -> None:
     ap = argparse.ArgumentParser()
     ap.add_argument("src", help="16:9 主图路径")
-    ap.add_argument("--slug", default="cover")
     ap.add_argument("--out-dir", required=True)
     args = ap.parse_args()
 

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

@@ -0,0 +1,63 @@
+# topmind-wechat-post · WeChat Article Authoring
+
+**[中文](./README.md)** | English
+
+Full lifecycle for WeChat articles: delivery package, review & rewrite, three quality gates, status sync, WeChat inline typography, and publish checklist.
+
+## Install
+
+```bash
+npx @topmindspace/tms-skills install topmind-wechat-post
+```
+
+## Usage
+
+```bash
+export TOPMIND_WORKSPACE=/path/to/workspace   # recommended; or point the delivery package root with --base
+
+# Create a new delivery package
+python3 scripts/new-article.py --slug demo --title "标题" --direction reverse
+
+# Typography lint + auto-fix
+python3 scripts/lint-wechat.py --input <package>/公众号稿.md --fix
+
+# De-AI-flavor scan (target ≥ 85)
+python3 scripts/scan_ai_flavor.py <package>/公众号稿.md
+
+# Markdown → fully inline HTML (--embed-images is mandatory, or pasted images go missing)
+python3 scripts/md2wechat.py --input <package>/公众号稿.md --out-dir <package> --slug demo --embed-images
+
+# Status sync
+python3 scripts/sync-status.py --set 定稿 <package> --apply
+```
+
+Scripts use Python stdlib only — zero dependencies.
+
+## Three paths
+
+- **forward**: draft → WeChat article (review & rewrite)
+- **reverse**: original topic → WeChat article → optional pushback
+- **curated web**: online curated sources → handled as reverse
+
+## Three quality gates
+
+Facts (first-hand sources) / logic (structural consistency) / copy (de-AI-flavor ≥ 85).
+
+## Related skills
+
+- Cover art → `topmind-cover` (shared X long-form / WeChat cover)
+- X long-form → `topmind-x-article` (Markdown draft → one-click X publish package)
+
+## External dependencies
+
+The following skills live **outside this repo** (usually provided by the user's local workbuddy environment). Missing ones degrade or disable the corresponding capability; all scripts in this repo still work fully:
+
+- `humanizer-zh`: fidelity boundaries for Chinese de-AI-flavor; without it the "de-AI-flavor only, no typesetting" path is unavailable.
+- `qu-aiwei-zh`: Chinese de-AI-flavor scan targeting; `scripts/scan_ai_flavor.py` shares its origin and can substitute when missing (scan targeting degrades).
+
+## Development
+
+```bash
+python3 scripts/package_skill.py --check
+python3 scripts/negative_tests.py
+```

package/topmind-wechat-post/README.md

@@ -1,5 +1,7 @@
 # topmind-wechat-post · 公众号创作技能
 
+[English](./README.en.md) | 中文
+
 公众号文章全生命周期：交付包、审校改写、质量三关、状态同步、微信内联排版与发布清单。
 
 ## 安装
@@ -41,6 +43,20 @@ python3 scripts/sync-status.py --set 定稿 <包> --apply
 
 事实（一手来源）/ 逻辑（结构一致）/ 文字（去 AI 味 ≥85）。
 
+## 相关技能
+
+- 封面配图 → `topmind-cover`（X 长文 / 公众号共用封面）
+- X 长文 → `topmind-x-article`（Markdown 原稿一键转 X 发布包）
+
+## 外部依赖
+
+本技能工作流会路由到以下**仓库外**技能（不含于本仓库，一般随用户侧 workbuddy
+环境提供）。缺失时对应能力降级/不可用，不影响本仓库脚本的全部功能：
+
+- `humanizer-zh`：中文去 AI 味的保真边界；缺失时「只去 AI 味不排版」路径不可用。
+- `qu-aiwei-zh`：中文去 AI 味扫描定位；`scripts/scan_ai_flavor.py` 与其同源，
+  缺失时可用仓库内脚本替代，扫描定位能力降级。
+
 ## 开发
 
 ```bash

package/topmind-wechat-post/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: topmind-wechat-post
-description: "公众号文章全生命周期技能：交付包、审校改写、质量三关（事实/逻辑/去AI味）、状态同步、微信内联排版与发布清单。Use when 写公众号、公众号排版、定稿、发公众号。Do NOT use for 只改错别字、小红书/知乎、纯网页发布。"
+version: 0.1.0
+description: "管一篇公众号文章从选题/底稿到发布的完整生命周期：交付包搭建、审校改写、质量三关（事实/逻辑/去AI味）、状态同步、微信内联排版与发布清单。Use when 写公众号、公众号排版、公众号定稿、发公众号。Do NOT use for 只改错别字、小红书/知乎、纯网页发布。"
+action_category: write
 triggers:
   - 公众号
   - 微信排版
@@ -12,10 +14,13 @@ triggers:
   - 公众号交付
   - wechat
   - mp format
-tags: [wechat, typography, formatting, publishing, markdown, write]
-author: TopMindSpace
+triggers_cn:
+  - 写公众号文章
+  - 公众号排版定稿
+  - 公众号发布清单
+author: TopMindspace
 license: MIT
-homepage: https://github.com/topmindspace/tms-skills
+homepage: https://github.com/topmindspace/tms-skills#readme
 updated: 2026-09-29
 ---
 
@@ -90,15 +95,9 @@ python3 scripts/sync-status.py --set 定稿 <包> --apply
 python3 scripts/new-article.py --slug <中文短名> --title "<标题>" --direction reverse
 ```
 
-取源坑（Next.js 站点）：正文在 RSC 载荷里，优先 `GET /api/notes/<id>`；图片在 `/api/uploads/<hash>`，记 hash→本地名映射；同图双 hash 用 `md5` 去重。差异与口径写进包内 `README.md`。
+取源坑（RSC 载荷、图片 hash 映射、`md5` 去重、截图裁切）见 `references/workflow.md`「站外拉取取源注意」；差异与口径写进包内 `README.md`。
 
-**回推纪律**：notes 保持纯 Markdown。`::: 容器` / 徽章 / `==高亮==` 只进公众号稿。回推**务必带 `--assets`**（否则 GitHub 上 `images/` 死链）：
-
-```bash
-python3 scripts/push-to-topstream.py <包> --target notes/xxx.md --assets          # dry-run
-python3 scripts/push-to-topstream.py <包> --target notes/xxx.md --assets --apply \
-  --asset-names "00-封面.jpg=01-cover.jpg,…"
-```
+**回推纪律**：notes 保持纯 Markdown（`:::` 容器 / 徽章 / `==高亮==` 只进公众号稿）；回推**务必带 `--assets`**（否则 GitHub 上 `images/` 死链）。命令串见 `references/workflow.md`「收尾」。
 
 ## 交付包与状态
 
@@ -159,7 +158,7 @@ python3 scripts/scan_ai_flavor.py <包>/公众号稿.md   # ≥85（人话）
 ## 排版要点（写稿时）
 
 - 开头 150 字内钩子；单段 ≤110 字；列表项 ≤70 字  
-- 二级标题序号化；容器：`::: stat|pull|note|tip|warn|danger|dialogue`  
+- 二级标题不手写序号（排版层自动生成）；容器：`::: stat|pull|note|tip|warn|danger|dialogue`  
 - **`::: stat` 内必须是 `数值 | 说明` 管道行**，否则静默丢弃  
 - 评测稿：**图承担数据，正文只解读**；健康密度 **300–450 字/图**  
 - 个股用词红线：禁用 买入/推荐/目标价…；文末投资声明  
@@ -200,9 +199,19 @@ python3 scripts/md2wechat.py \
 
 可视化工作流伴面（若有）：包列表 → 改稿 → 三关 → 预览 → 导出。脚本语义以本技能为准。
 
+## 外部依赖
+
+以下技能**不在本仓库**（一般随用户侧 workbuddy 环境提供）；缺失时对应路由能力不可用，
+本仓库脚本（交付包、排版、发布清单等）功能不受影响：
+
+- `humanizer-zh`：中文去 AI 味的保真边界（「只去 AI 味不排版」路径用）。
+- `qu-aiwei-zh`：中文去 AI 味扫描定位；本仓库 `scan_ai_flavor.py` 与其同源，
+  缺失时可用仓库内脚本替代，扫描定位能力降级。
+
 ## When NOT to use
 
 - 只想改几个句子 → 直接编辑  
 - 小红书 / 知乎 / 掘金 → 平台约束不同  
 - 通用长文交付 → 不在本技能范围
+- 封面配图 → `topmind-cover`；X 长文 → `topmind-x-article`
 - 只去 AI 味不排版 → 中文走 `humanizer-zh`（先立保真边界）+ `qu-aiwei-zh`（再扫描定位）；英文走 `humanizer`

package/topmind-wechat-post/references/typography-rules.md

@@ -6,7 +6,7 @@
 
 1. **开头 150 字内给钩子**：结论、反差或悬念，不要背景铺垫。原文首段若是长背景，压缩或后移。
 2. **段落切分**：单段 ≤ 110 字（约 4 行手机屏）。长段按语义断点拆开，不要机械等分。
-3. **小标题序号化**：二级标题统一「一、二、三」或「01 / 02」，读者能感知进度。
+3. **小标题不手写序号**：写稿时保持二级标题为纯文本，序号由排版层按 `h2_style` 自动生成（规则见 `element-spec.md`「章节编号」）。主题换编号样式时无需手改，读者仍能感知进度。
 4. **列表项 ≤ 70 字**：超长列表项改成「加粗小标题 + 短说明」的段落组。
 5. **重点加粗**：只加粗结论句和关键数据，全篇加粗密度控制在每 20 字不超过 1 处。
 6. **长句拆短**：单句 > 45 字且有逗号堆叠时，拆成两句。

package/topmind-wechat-post/references/writing-quality.md

@@ -44,7 +44,7 @@
 |---|---|---|
 | 中文长文 / 公众号改稿 | `humanizer-zh` + `qu-aiwei-zh` | 先立边界，再扫描定位（默认组合） |
 | 只要分数和命中清单 | `qu-aiwei-zh` | 跑脚本，不改稿 |
-| 随笔要「加声音」 | `qu-aiwei-zh` + `references/pan-style.md` | 用表达方式加，不编故事 |
+| 随笔要「加声音」 | `qu-aiwei-zh` | 用表达方式加，不编故事 |
 | 英文文本 | `humanizer` | `humanizer-zh` 只针对中文 |
 | 清单 / 词表 / 说明书 | 都不用 E 类姿态分 | 这类文体靠列举反例，检测器会把反例当真命中 |
 
@@ -114,7 +114,7 @@ python3 scripts/scan_ai_flavor.py <稿>.md   # 技能自带，与 qu-aiwei-zh
 
 有「我」、有具体场景、有具体数字与人名、有不确定性表达（「其实」「不过」「还在想」）、句子长短交替、有真实细节而不是「很多人」「大多数」。
 
-⚠️ 这一段说的是**表达方式**。原文没有第一人称、没有数字时，不许靠这一条去补——那正好踩中 `humanizer-zh` 的优先级第 1 条。加声音的手段是句长节奏、设问、括号自注（见 `pan-style.md`），配合删掉元叙述和教学腔。`humanizer-zh` 里写着同一句话：「用户要求增强个人风格时，用表达方式实现，不编故事。」
+⚠️ 这一段说的是**表达方式**。原文没有第一人称、没有数字时，不许靠这一条去补——那正好踩中 `humanizer-zh` 的优先级第 1 条。加声音的手段是句长节奏、设问、括号自注，配合删掉元叙述和教学腔。`humanizer-zh` 里写着同一句话：「用户要求增强个人风格时，用表达方式实现，不编故事。」
 
 英文文本才走 `humanizer`：它的取向是 **Add soul**（主动注入个性），与中文改稿的**保真优先**方向相反，别把它的思路套到中文稿上。
 

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

@@ -48,6 +48,28 @@ def main() -> None:
                     check(False, f"{rel} 悬空链接: {link}")
     check(True, "内部 md 链接可达")
 
+    # 反引号代码引用中的路径可达（审计 轻微-15 门禁盲区：之前只查 [text](path) 形式，
+    # `references/pan-style.md` 这类反引号引用曾漏网）。抓取反引号内的 references/*.md
+    # 与 scripts/* 路径并校验存在；glob/占位符写法（* ? < > |）跳过。
+    backtick_path_re = re.compile(r"(references|scripts)/([\w.\-/]+)")
+    line_suffix_re = re.compile(r":\d+(?:-\d+)?$")
+    backtick_bad = 0
+    for md in md_files:
+        text = md.read_text(encoding="utf-8")
+        rel = md.relative_to(ROOT).as_posix()
+        for span in set(re.findall(r"`([^`]+)`", text)):
+            for kind, p in backtick_path_re.findall(span):
+                p = line_suffix_re.sub("", p)
+                if not p or any(c in p for c in "*?<>|"):
+                    continue
+                target = md.parent / kind / p
+                if not target.exists():
+                    target = ROOT / kind / p
+                if not target.exists():
+                    backtick_bad += 1
+                    check(False, f"{rel} 反引号引用不可达: `{kind}/{p}`")
+    check(backtick_bad == 0, f"反引号内 references/scripts 引用可达（扫描 {len(md_files)} 个 md 文件）")
+
     if errors:
         print(f"\n[audit_docs] {NAME}: {len(errors)} 项失败")
         sys.exit(1)

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

@@ -880,6 +880,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)
@@ -1435,9 +1439,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("")

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

@@ -0,0 +1,46 @@
+# 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.
+
+## Install
+
+```bash
+npx @topmindspace/tms-skills install topmind-x-article
+```
+
+## Usage
+
+```bash
+# 1. Draft → paste-ready plain text (the heart of one-click copying)
+python3 scripts/md2x.py <draft>.md --out <package>/X发布稿.txt
+
+# 2. Cover: generate a 1200×675 cover with topmind-cover
+
+# 3. Follow references/publish-checklist.md item by item
+```
+
+## 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.
+
+Read the result through once by hand after converting.
+
+## 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

@@ -1,5 +1,7 @@
 # topmind-x-article · X 长文一键发布
 
+[English](./README.en.md) | 中文
+
 把 Markdown 原稿变成"复制 → 粘贴 → 发"的 X 长文（Article）发布包。
 
 ## 安装
@@ -22,8 +24,9 @@ python3 scripts/md2x.py <原稿>.md --out <包>/X发布稿.txt
 ## 转换规则
 
 X Article 编辑器对 markdown 支持弱且不稳定，`md2x.py` 按 `references/x-format.md`
-转纯文本：标题→纯文本行、加粗/斜体去标记、链接→`文字（url）`、
-图片→`[图N]`（文末附配图清单）、表格→"项：值"列表。
+转纯文本：标题→纯文本行、分隔线（`---` / `***` / `___`）→空行、加粗/斜体去标记
+（含 `***粗斜体***`）、链接→`文字（url）`、图片→`[图N]`（文末附配图清单）、
+表格→"项：值"列表。
 
 转完必须人工通读一遍。
 
@@ -32,6 +35,14 @@ X Article 编辑器对 markdown 支持弱且不稳定，`md2x.py` 按 `reference
 X 长文目前走人工粘贴发布（X Article 编辑器），API 不发长文。
 发布后按清单做：首条评论置顶补信息、全文抓回核对。
 
+## 外部依赖
+
+以下技能**不在本仓库**（一般随用户侧 workbuddy 环境提供）。缺失时对应路由能力
+不可用，不影响本技能核心流程（原稿转文本、封面、发布清单）：
+
+- `topmind-x`：280 字短推文发布（其 xurl 只覆盖短推文，不发长文）。
+- `topmind-capture`：「只想存档不发布」时的收录路由。
+
 ## 开发
 
 ```bash

package/topmind-x-article/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: topmind-x-article
-version: 1.0.0
-description: "X 长文（Article）一键发布：Markdown 原稿 → 可直接粘贴的 X发布稿.txt + 封面图 + 发布清单。沉淀自实战。Use when X 长文、发 X 文章、X article、长文发 X。Do NOT use for 短推文（走推文流程）、公众号。"
+version: 0.1.0
+description: "X 长文（Article）一键发布：Markdown 原稿 → 可直接粘贴的 X发布稿.txt + 封面图 + 发布清单。沉淀自实战。Use when X 长文、发 X 文章、X article、长文发 X。Do NOT use for 短推文（→ topmind-x）、公众号。"
 action_category: write
 triggers:
   - X 长文
@@ -11,8 +11,9 @@ triggers:
 triggers_cn:
   - 写 X 长文
   - X 长文发布
-author: Muse
+author: TopMindspace
 license: MIT
+homepage: https://github.com/topmindspace/tms-skills#readme
 updated: 2026-09-29
 ---
 
@@ -58,5 +59,13 @@ updated: 2026-09-29
 ## When NOT to use
 
 - 280 字短推文 → `topmind-x`
-- 公众号 → `topmind-wechat`
+- 公众号 → `topmind-wechat-post`
 - 只想存档不发布 → `topmind-capture`
+
+## 外部依赖
+
+以下技能**不在本仓库**（一般随用户侧 workbuddy 环境提供）；缺失时对应路由能力不可用，
+本技能核心流程（原稿转文本、封面、发布清单）不受影响：
+
+- `topmind-x`：280 字短推文发布（其 xurl 只覆盖短推文，不发长文）。
+- `topmind-capture`：「只想存档不发布」时的收录路由。

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

@@ -48,6 +48,28 @@ def main() -> None:
                     check(False, f"{rel} 悬空链接: {link}")
     check(True, "内部 md 链接可达")
 
+    # 反引号代码引用中的路径可达（审计 轻微-15 门禁盲区：之前只查 [text](path) 形式，
+    # `references/pan-style.md` 这类反引号引用曾漏网）。抓取反引号内的 references/*.md
+    # 与 scripts/* 路径并校验存在；glob/占位符写法（* ? < > |）跳过。
+    backtick_path_re = re.compile(r"(references|scripts)/([\w.\-/]+)")
+    line_suffix_re = re.compile(r":\d+(?:-\d+)?$")
+    backtick_bad = 0
+    for md in md_files:
+        text = md.read_text(encoding="utf-8")
+        rel = md.relative_to(ROOT).as_posix()
+        for span in set(re.findall(r"`([^`]+)`", text)):
+            for kind, p in backtick_path_re.findall(span):
+                p = line_suffix_re.sub("", p)
+                if not p or any(c in p for c in "*?<>|"):
+                    continue
+                target = md.parent / kind / p
+                if not target.exists():
+                    target = ROOT / kind / p
+                if not target.exists():
+                    backtick_bad += 1
+                    check(False, f"{rel} 反引号引用不可达: `{kind}/{p}`")
+    check(backtick_bad == 0, f"反引号内 references/scripts 引用可达（扫描 {len(md_files)} 个 md 文件）")
+
     if errors:
         print(f"\n[audit_docs] {NAME}: {len(errors)} 项失败")
         sys.exit(1)

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

@@ -28,8 +28,9 @@ def convert(md: str):
     for raw in md.splitlines():
         line = raw.rstrip()
 
-        # frontmatter 直接跳过
-        if line.strip() == "---":
+        # 分割线 → 空行（frontmatter 已在 main() 去除，这里只剩正文分隔线）
+        if re.match(r"^(\*{3,}|-{3,}|_{3,})\s*$", line):
+            out_lines.append("")
             continue
 
         # 代码块：去围栏，内容缩进保留
@@ -69,7 +70,8 @@ def convert(md: str):
             out_lines.append(f"{label}：{rest}" if rest else label)
             continue
 
-        # 行内标记剥离
+        # 行内标记剥离（先 *** 再 ** 再 *，防残留）
+        line = re.sub(r"\*\*\*(.+?)\*\*\*", r"\1", line)  # 粗斜体
         line = re.sub(r"\*\*(.+?)\*\*", r"\1", line)      # 加粗
         line = re.sub(r"__(.+?)__", r"\1", line)
         line = re.sub(r"\*(.+?)\*", r"\1", line)          # 斜体