@topmindspace/tms-skills 0.1.18 → 0.2.0

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.md

@@ -0,0 +1,40 @@
+# topmind-x-article · X 长文一键发布
+
+把 Markdown 原稿变成"复制 → 粘贴 → 发"的 X 长文（Article）发布包。
+
+## 安装
+
+```bash
+npx @topmindspace/tms-skills install topmind-x-article
+```
+
+## 用法
+
+```bash
+# 1. 原稿转可粘贴纯文本（一键复制的核心）
+python3 scripts/md2x.py <原稿>.md --out <包>/X发布稿.txt
+
+# 2. 封面图：用 topmind-cover 生成 1200×675
+
+# 3. 按 references/publish-checklist.md 逐项发布
+```
+
+## 转换规则
+
+X Article 编辑器对 markdown 支持弱且不稳定，`md2x.py` 按 `references/x-format.md`
+转纯文本：标题→纯文本行、加粗/斜体去标记、链接→`文字（url）`、
+图片→`[图N]`（文末附配图清单）、表格→"项：值"列表。
+
+转完必须人工通读一遍。
+
+## 发布
+
+X 长文目前走人工粘贴发布（X Article 编辑器），API 不发长文。
+发布后按清单做：首条评论置顶补信息、全文抓回核对。
+
+## 开发
+
+```bash
+python3 scripts/package_skill.py --check   # 发布前校验
+python3 scripts/negative_tests.py          # 异常输入测试
+```

package/topmind-x-article/SKILL.md

@@ -0,0 +1,62 @@
+---
+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 短推文（走推文流程）、公众号。"
+action_category: write
+triggers:
+  - X 长文
+  - 发 X 文章
+  - X article
+  - 长文发 X
+triggers_cn:
+  - 写 X 长文
+  - X 长文发布
+author: Muse
+license: MIT
+updated: 2026-09-29
+---
+
+# topmind-x-article · X 长文一键发布
+
+把一篇 Markdown 原稿变成"复制 → 粘贴 → 发"的 X 长文发布包。
+
+```
+原稿.md → md2x.py → X发布稿.txt → 封面图(topmind-cover) → 发布清单 → 人工粘贴发布
+```
+
+## 工作流
+
+1. **转文本**（一键复制的核心）：
+   ```bash
+   python3 scripts/md2x.py <原稿>.md --out <包>/X发布稿.txt
+   ```
+   转换规则见 `references/x-format.md`。转完**通读一遍**：X 不渲染 markdown，
+   标记剥离后断句、 emphasis 全靠文字本身，读不顺就回原稿改。
+2. **封面图**：调 `topmind-cover`，平台选 `x`，得 1200×675 主图。
+3. **发布清单**：按 `references/publish-checklist.md` 逐项过。
+4. **发布**：用户在 X Article 编辑器粘贴 `X发布稿.txt` 全文、上传封面与配图，
+   人工点发布。**API 不发长文**（topmind-x 的 xurl 只覆盖短推文）。
+5. **收尾**：记录发布时间与链接；全文抓回核对一遍（标题、数字、图序）。
+
+## 目录约定
+
+```
+<包>/
+├── 原稿.md            # 输入（或复用既有原稿）
+├── X发布稿.txt        # 唯一复制入口：一键全选复制
+├── cover-1200x675.png # 封面（topmind-cover 产出）
+└── 发布清单.md        # 本次发布 checklist（含时间、链接）
+```
+
+## Manus 2.0 实战沉淀
+
+- 补充信息（邀请码、链接、勘误）**不挤正文**，发在发布后首条评论并置顶
+- 长文标题 ≤140 字符，首段 3 行内出钩子
+- 配图逐张按 `[图N]` 顺序上传，传完对照清单点一遍
+- 事实修正只改发布包，不回头改已发原文（除非勘误）
+
+## When NOT to use
+
+- 280 字短推文 → `topmind-x`
+- 公众号 → `topmind-wechat`
+- 只想存档不发布 → `topmind-capture`

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.1.0",
+  "private": true,
+  "description": "X 长文（Article）一键发布：Markdown 原稿转可直接粘贴的纯文本 + 封面图 + 发布清单。",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/topmindspace/tms-skills.git",
+    "directory": "topmind-x-article"
+  },
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  }
+}

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

@@ -0,0 +1,24 @@
+# X 长文发布清单
+
+发布前逐项打勾，发布后填时间与链接归档。
+
+## 发布前
+
+- [ ] `X发布稿.txt` 通读一遍：断句顺、无 markdown 残留标记
+- [ ] 标题 ≤140 字符；首段 3 行内出钩子
+- [ ] 承重数字与原稿一致（转格式不改数字）
+- [ ] 封面图 1200×675 已备好，标题字无错别字
+- [ ] 配图按 `[图N]` 顺序排好，清单与文件一一对应
+- [ ] 话题标签想好（放文末，不超过 3 个）
+
+## 发布时
+
+- [ ] 全文粘贴 → 封面上传 → 配图逐张按序插入
+- [ ] 预览一遍：图序、段落、标题
+
+## 发布后
+
+- [ ] 首条评论补信息（邀请码 / 链接 / 补充说明），置顶
+- [ ] 记录：发布时间、文章链接
+- [ ] 全文抓回核对一遍（标题、数字、图序），有误用评论勘误
+- [ ] `发布清单.md` 归档进包

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

@@ -0,0 +1,24 @@
+# X Article 粘贴格式规则
+
+X Article 编辑器对 markdown 支持弱且不稳定。`md2x.py` 按以下规则转纯文本，
+转完人工通读一遍是硬性步骤。
+
+| Markdown | 转后 |
+|----------|------|
+| `#` / `##` 标题 | 纯文本行，前后各一空行 |
+| `**加粗**` / `*斜体*` | 去标记留文字（语气靠文字本身） |
+| `[文字](url)` | `文字（url）` |
+| `![](alt)` | `[图N]`，文末附"配图清单" |
+| `-` / `1.` 列表 | 保留原符号 |
+| `>` 引用 | 去 `>` 留文字 |
+| 表格 | 转"项：值"列表；复杂表拆成段落 |
+| `---` 分割线 | 空行 |
+| 代码块 | 去围栏，内容缩进 4 格 |
+| frontmatter | 整块丢弃 |
+
+## 写作时就按 X 想
+
+- 段落短：手机阅读每段 ≤4 行
+- 小标题就是一句话，不依赖加粗撑结构
+- 数字、专有名词第一次出现就写全（剥离标记后无高亮可依靠）
+- 需要强调的词：换说法前置，不要靠 `**`

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

@@ -0,0 +1,39 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""CSS 审计：本组技能无 CSS 资产；若未来加入 .css 文件，则做括号配平基础检查。"""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+NAME = ROOT.name
+errors: list[str] = []
+
+
+def main() -> None:
+    print(f"[audit_css] {NAME}")
+    css_files = [p for p in ROOT.rglob("*.css") if ".git" not in p.parts and "dist" not in p.parts]
+    if not css_files:
+        print("  ✓ 无 CSS 资产，跳过")
+        print(f"\n[audit_css] {NAME}: 通过")
+        return
+    for css in css_files:
+        text = css.read_text(encoding="utf-8")
+        balanced = text.count("{") == text.count("}")
+        print(("  ✓ " if balanced else "  ✗ ") + f"{css.name} 括号配平")
+        if not balanced:
+            errors.append(css.name)
+    if errors:
+        print(f"\n[audit_css] {NAME}: {len(errors)} 项失败")
+        sys.exit(1)
+    print(f"\n[audit_css] {NAME}: 全部通过")
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,58 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""文档审计：references 完整性与内部链接可达性（任一不过 → 退出码 1）。"""
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+NAME = ROOT.name
+errors: list[str] = []
+
+
+def check(cond: bool, msg: str) -> None:
+    print(("  ✓ " if cond else "  ✗ ") + msg)
+    if not cond:
+        errors.append(msg)
+
+
+def main() -> None:
+    print(f"[audit_docs] {NAME}")
+    md_files = [p for p in ROOT.rglob("*.md") if ".git" not in p.parts and "dist" not in p.parts]
+    check(len(md_files) >= 2, f"md 文档 ≥2（实 {len(md_files)}，含 SKILL.md/README.md）")
+
+    refdir = ROOT / "references"
+    if refdir.is_dir():
+        refs = sorted(refdir.glob("*.md"))
+        check(len(refs) >= 1, f"references/*.md ≥1（实 {len(refs)}）")
+        for md in refs:
+            check(md.stat().st_size > 0, f"references/{md.name} 非空")
+
+    for md in md_files:
+        text = md.read_text(encoding="utf-8")
+        rel = md.relative_to(ROOT).as_posix()
+        for link in set(re.findall(r"\]\(([^)]+)\)", text)):
+            if link.startswith(("http://", "https://", "#", "mailto:")):
+                continue
+            target = (md.parent / link.split("#")[0]).resolve()
+            if link and not target.exists():
+                # 允许指向脚本/资源等非 md 文件的相对链接缺失检查放宽到 md
+                if target.suffix == ".md":
+                    check(False, f"{rel} 悬空链接: {link}")
+    check(True, "内部 md 链接可达")
+
+    if errors:
+        print(f"\n[audit_docs] {NAME}: {len(errors)} 项失败")
+        sys.exit(1)
+    print(f"\n[audit_docs] {NAME}: 全部通过")
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""技能入口审计：SKILL.md 结构完整性（任一不过 → 退出码 1）。"""
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+NAME = ROOT.name
+errors: list[str] = []
+
+
+def check(cond: bool, msg: str) -> None:
+    print(("  ✓ " if cond else "  ✗ ") + msg)
+    if not cond:
+        errors.append(msg)
+
+
+def main() -> None:
+    print(f"[audit_skill] {NAME}")
+    text = (ROOT / "SKILL.md").read_text(encoding="utf-8")
+
+    m = re.search(r"^triggers:\s*\n((?:  - .+\n?)+)", text, re.M)
+    triggers = re.findall(r"^  - (.+)$", m.group(1), re.M) if m else []
+    check(len(triggers) >= 1, f"triggers ≥1（实 {len(triggers)}）")
+
+    check("When NOT to use" in text or "何时不用" in text, "含 When NOT to use / 何时不用")
+
+    has_workflow = bool(re.search(r"工作流|Workflow|用法|Usage", text))
+    check(has_workflow, "含工作流/用法说明")
+
+    fm = re.match(r"^---\r?\n([\s\S]*?)\r?\n---", text)
+    desc = ""
+    if fm:
+        dm = re.search(r'^description:\s*"([^"]*)"\s*$', fm.group(1), re.M)
+        if dm:
+            desc = dm.group(1).strip()
+        else:
+            dm = re.search(r"^description:\s*>\-\s*\n((?:[ \t]+.*\n?)+)", fm.group(1), re.M)
+            if dm:
+                desc = " ".join(l.strip() for l in dm.group(1).splitlines())
+    check("Use when" in desc or "用" in desc, "description 含使用场景")
+    check("Do NOT use" in desc or "不用" in desc, "description 含不适用场景")
+    check(len(desc) <= 1024, f"description ≤1024（实 {len(desc)}）")
+
+    if errors:
+        print(f"\n[audit_skill] {NAME}: {len(errors)} 项失败")
+        sys.exit(1)
+    print(f"\n[audit_skill] {NAME}: 全部通过")
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""样式资产审计：主题/风格资源有效性（任一不过 → 退出码 1）。
+
+本组技能无 CSS 样式表：若存在 assets/themes/*.json 则校验 JSON 可解析；
+references 风格文档非空（已由 audit_docs 覆盖，此处做存在性断言）。
+"""
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+NAME = ROOT.name
+errors: list[str] = []
+
+
+def check(cond: bool, msg: str) -> None:
+    print(("  ✓ " if cond else "  ✗ ") + msg)
+    if not cond:
+        errors.append(msg)
+
+
+def main() -> None:
+    print(f"[audit_styles] {NAME}")
+    themes = sorted((ROOT / "assets" / "themes").glob("*.json")) if (ROOT / "assets" / "themes").is_dir() else []
+    if themes:
+        for t in themes:
+            try:
+                json.loads(t.read_text(encoding="utf-8"))
+                check(True, f"assets/themes/{t.name} JSON 可解析")
+            except (OSError, json.JSONDecodeError) as e:
+                check(False, f"assets/themes/{t.name} 解析失败: {e}")
+    else:
+        check(True, "无主题 JSON 资产（本技能不依赖主题文件）")
+
+    refdir = ROOT / "references"
+    has_style_doc = refdir.is_dir() and any(refdir.glob("*.md"))
+    check(has_style_doc, "references 风格/格式文档存在")
+
+    if errors:
+        print(f"\n[audit_styles] {NAME}: {len(errors)} 项失败")
+        sys.exit(1)
+    print(f"\n[audit_styles] {NAME}: 全部通过")
+
+
+if __name__ == "__main__":
+    main()