@topmindspace/topmind-writing-skills 0.7.1

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

@@ -0,0 +1,171 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""topmind-wechat-post 异常输入测试：各脚本错误路径干净（任一失败 → 退出码 1）。"""
+from __future__ import annotations
+
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+SCRIPTS = ROOT / "scripts"
+PY = sys.executable
+fails: list[str] = []
+
+
+def run(script: str, args: list[str]) -> subprocess.CompletedProcess:
+    return subprocess.run([PY, str(SCRIPTS / script), *args], capture_output=True, text=True, timeout=60)
+
+
+def check(name: str, cond: bool, detail: str = "") -> None:
+    print(("  ✓ " if cond else "  ✗ ") + name + (f" — {detail}" if detail and not cond else ""))
+    if not cond:
+        fails.append(name)
+
+
+def main() -> None:
+    print("[negative_tests] topmind-wechat-post")
+    with tempfile.TemporaryDirectory() as td:
+        td = Path(td)
+
+        # 1. lint 空文件不崩溃
+        (td / "empty.md").write_text("", encoding="utf-8")
+        r = run("lint-wechat.py", ["--input", str(td / "empty.md")])
+        check("lint 空文件不崩溃", r.returncode == 0 and "Traceback" not in r.stderr, r.stderr[:100])
+
+        # 2. md2wechat 缺失输入 → 非零干净报错
+        r = run("md2wechat.py", ["--input", str(td / "nope.md"), "--out-dir", str(td), "--slug", "t"])
+        check("md2wechat 缺失输入干净报错", r.returncode != 0 and "Traceback" not in r.stderr, r.stderr[:100])
+
+        # 3. scan 空文件不崩溃
+        r = run("scan_ai_flavor.py", [str(td / "empty.md")])
+        check("scan 空文件不崩溃", r.returncode == 0 and "Traceback" not in r.stderr, r.stderr[:100])
+
+        # 4. new-article --help 正常
+        r = run("new-article.py", ["--help"])
+        check("new-article --help 正常", r.returncode == 0, r.stderr[:100])
+
+        # 5. sync-status 缺失包 → 非零干净报错
+        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])
+
+        # 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)
+    print("\n[negative_tests] 全部通过")
+
+
+if __name__ == "__main__":
+    main()

package/topmind-wechat-post/scripts/new-article.py

@@ -0,0 +1,183 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""new-article.py — 一键创建公众号文章交付包。
+
+创建 <base>/YYYY-MM-DD-<slug>/ 目录，内含：
+  - 公众号稿.md   带 frontmatter 的文章骨架（含写作提示与容器语法示例）
+  - images/       图片目录（可选，从 --images 拷贝）
+  - diagrams/     mermaid 图表目录
+
+Usage:
+    python3 new-article.py --slug gpt-6-review --title "GPT-6 深度评测" \
+        [--base <专题目录>] [--date 2026-09-04] [--images src1 src2 ...]
+
+默认 base = <topmind-workspace>/40-创作/2026-公众号
+"""
+
+import argparse
+import datetime
+import os
+import re
+import shutil
+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()
+
+SKELETON = """---
+title: "{title}"
+category: 40-创作
+topic: 2026-公众号
+source_type: {source_type}
+captured_at: {now}
+status: 草稿
+direction: {direction}
+source_file: {source_file}
+target_file: {target_file}
+word_count: 0
+tags: [公众号, 排版]
+note_role: bundle
+---
+
+# {title}
+
+<!-- 骨架说明（写作时逐条删除）：
+  1. 开头：3 句内给出「反差钩子」——一个具体事实/数字/场景，别写背景铺垫。
+  2. 小标题用 ##（h2），正文段落 ≤ 110 字（约 4 行手机屏）。
+  3. 重点句才加粗，加粗占比 < 20%；关键数据可用 ::: stat 容器。
+  4. 外链会被公众号拦截，直接写 [文字](url)，脚本自动转文末脚注。
+  5. 中英文间距不用管，lint --fix 会自动补。
+  6. 可用容器（::: 类型 然后空行，内容，空行，::: 收尾）：
+       ::: note   补充说明（灰）
+       ::: tip    小技巧（绿）
+       ::: warn   注意事项（橙）
+       ::: danger 常见坑（红）
+       ::: pull   金句 / 核心观点（大字号居中）
+       ::: dialogue  对话（A: B: 交替缩进）
+       ::: stat   数据亮点（大数字）
+       [!新特性] 这样的行内徽章  /  ==高亮重点==
+-->
+
+> 一句话导语：这篇文章解决什么问题、读者能带走什么。
+
+## 为什么值得聊
+
+## 核心内容
+
+### 分论点一
+
+### 分论点二
+
+## 我的看法
+
+::: pull
+把最想让读者记住的一句话放在这里。
+:::
+
+## 小结
+
+---
+
+*本文首发于我的公众号，转载请注明出处。*
+"""
+
+# 目录名按专题规范：中文短名（可含英文/数字/连字符），如 个人免费基建全景、GrokBot多Agent调度
+SLUG_RE = re.compile(r"^[\u4e00-\u9fffA-Za-z0-9][\u4e00-\u9fffA-Za-z0-9-]*$")
+
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument("--slug", required=True,
+                    help="包名关键词（中文短名，可含英文/数字/连字符），如 个人免费基建全景、GrokBot多Agent调度")
+    ap.add_argument("--title", required=True, help="文章标题")
+    ap.add_argument("--base", default=DEFAULT_BASE)
+    ap.add_argument("--date", default=datetime.date.today().isoformat())
+    ap.add_argument("--direction", default="reverse", choices=("forward", "reverse"),
+                    help="forward=源自 topstream 底稿；reverse=本工作区选题，定稿后回推 topstream")
+    ap.add_argument("--source-file", default="",
+                    help='forward 时填 topstream 的 notes/xxx.md')
+    ap.add_argument("--images", nargs="*", default=[],
+                    help="要拷入 images/ 的源图片路径")
+    args = ap.parse_args()
+
+    if not SLUG_RE.match(args.slug):
+        print("✗ 目录名只允许中文、英文字母、数字、连字符：%s" % args.slug)
+        return 1
+
+    pkg = os.path.join(args.base, "%s-%s" % (args.date, args.slug))
+    if os.path.exists(pkg):
+        print("✗ 目录已存在：%s" % pkg)
+        return 1
+
+    os.makedirs(os.path.join(pkg, "images"), exist_ok=True)
+    os.makedirs(os.path.join(pkg, "diagrams"), exist_ok=True)
+
+    draft = os.path.join(pkg, "公众号稿.md")
+    if args.direction == "forward" and not args.source_file:
+        print("⚠ forward 未给 --source-file，将留空 source_file（回补 notes/xxx.md）")
+    src_file = args.source_file or '""'
+    tgt_file = '""' if args.direction == "forward" else "pending"
+    with open(draft, "w", encoding="utf-8") as fh:
+        fh.write(SKELETON.format(
+            title=args.title,
+            source_type="user-original" if args.direction == "reverse" else "ai-derived",
+            direction=args.direction,
+            source_file=src_file,
+            target_file=tgt_file,
+            now=datetime.datetime.now().astimezone().isoformat(timespec="seconds")))
+
+    copied = 0
+    for src in args.images:
+        if os.path.exists(src):
+            shutil.copy2(src, os.path.join(pkg, "images", os.path.basename(src)))
+            copied += 1
+        else:
+            print("! 跳过不存在的图片：%s" % src)
+
+    print("✓ 交付包已创建：%s" % pkg)
+    print("  稿件骨架 : 公众号稿.md（含容器语法示例，写作时删掉注释）")
+    if copied:
+        print("  图片     : %d 张 → images/" % copied)
+    print("")
+    print("下一步：")
+    print("  1. 写完稿后体检（可加 --fix 自动补中英文间距）：")
+    print("     python3 %s/lint-wechat.py --input '%s' --fix" % (
+        os.path.dirname(os.path.abspath(__file__)), draft))
+    print("  2. 定稿时同步状态与目录名（加 --apply 生效）：")
+    print("     python3 %s/sync-status.py --set 定稿 '%s' --apply" % (
+        os.path.dirname(os.path.abspath(__file__)), os.path.basename(pkg)))
+    print("  3. 生成公众号 HTML：")
+    print("     python3 %s/md2wechat.py --input '%s' --out-dir '%s' --slug %s" % (
+        os.path.dirname(os.path.abspath(__file__)), draft, pkg, args.slug))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

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

@@ -0,0 +1,188 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""技能分发包打包器（发布前完整性校验 + 发布清单）。
+
+用法:
+    python scripts/package_skill.py            # 校验 → 打包 → 写发布清单
+    python scripts/package_skill.py --check    # 只校验不打包（CI / 提交前自检）
+
+产物:
+    dist/<skill>.zip            分发包（解压目录名 = 技能名）
+    dist/<skill>.manifest.json  发布清单（版本 / 条目 / 大小 / SHA-256）
+
+校验（任一不过 → 退出码 1）:
+    · SKILL.md frontmatter 含 name / description；name 与目录名一致；
+      description ≤ 1024 字符（平台截断阈值）
+    · README.md / package.json 存在；package.json name 与技能名一致
+    · scripts/*.py 全部可编译；references/*.md 非空
+    · SKILL.md 引用的 references/<file> 全部存在
+    · 无 scripts/_* / __pycache__ / .env 等不应进包的文件
+"""
+from __future__ import annotations
+
+import hashlib
+import json
+import re
+import sys
+import zipfile
+from datetime import datetime, timezone
+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
+OUT = ROOT / "dist" / f"{NAME}.zip"
+MANIFEST = ROOT / "dist" / f"{NAME}.manifest.json"
+DESC_LIMIT = 1024
+
+INCLUDE = ["SKILL.md", "README.md", "package.json", "assets/", "references/", "scripts/", "evals/", "agents/"]
+EXCLUDE_RES = [
+    re.compile(r"(^|/)scripts/_"),
+    re.compile(r"(^|/)\.env($|\.)"),
+    re.compile(r"(^|/)__pycache__(/|$)"),
+    re.compile(r"(^|/)node_modules(/|$)"),
+    re.compile(r"(^|/)dist(/|$)"),
+]
+
+errors: list[str] = []
+
+
+def fail(msg: str) -> None:
+    errors.append(msg)
+    print(f"  ✗ {msg}")
+
+
+def ok(msg: str) -> None:
+    print(f"  ✓ {msg}")
+
+
+def read_frontmatter() -> dict:
+    text = (ROOT / "SKILL.md").read_text(encoding="utf-8")
+    m = re.match(r"^---\r?\n([\s\S]*?)\r?\n---", text)
+    if not m:
+        fail("SKILL.md 缺 frontmatter")
+        return {}
+    fm = m.group(1)
+    name = re.search(r"^name:\s*(\S+)\s*$", fm, re.M)
+    desc = ""
+    dm = re.search(r'^description:\s*"([^"]*)"\s*$', fm, re.M)
+    if dm:
+        desc = dm.group(1).strip()
+    else:
+        dm = re.search(r"^description:\s*>\-\s*\n((?:[ \t]+.*\n?)+)", fm, re.M)
+        if dm:
+            desc = " ".join(line.strip() for line in dm.group(1).splitlines() if line.strip())
+    return {"name": name.group(1) if name else "", "description": desc}
+
+
+def check() -> bool:
+    print(f"[check] {NAME}")
+    fm = read_frontmatter()
+    if fm.get("name") != NAME:
+        fail(f"frontmatter name={fm.get('name')!r} 与目录名 {NAME!r} 不一致")
+    else:
+        ok("name 与目录名一致")
+    desc = fm.get("description", "")
+    if not desc:
+        fail("description 为空")
+    elif len(desc) > DESC_LIMIT:
+        fail(f"description {len(desc)} 字符，超过 {DESC_LIMIT}")
+    else:
+        ok(f"description {len(desc)} 字符")
+
+    for f in ("README.md", "package.json"):
+        if not (ROOT / f).is_file():
+            fail(f"缺 {f}")
+        else:
+            ok(f"有 {f}")
+    try:
+        pkg = json.loads((ROOT / "package.json").read_text(encoding="utf-8"))
+        if pkg.get("name") != NAME:
+            fail(f"package.json name={pkg.get('name')!r} 与技能名不一致")
+        if not re.match(r"^\d+\.\d+\.\d+", str(pkg.get("version", ""))):
+            fail("package.json version 非 semver")
+    except (OSError, json.JSONDecodeError) as e:
+        fail(f"package.json 解析失败: {e}")
+
+    for p in ROOT.rglob("*"):
+        if not p.is_file() or ".git" in p.parts:
+            continue
+        rel = p.relative_to(ROOT).as_posix()
+        for rx in EXCLUDE_RES:
+            if rx.search(rel):
+                fail(f"不应进包的文件: {rel}")
+                break
+    ok("无禁用文件")
+
+    for py in sorted((ROOT / "scripts").glob("*.py")):
+        try:
+            compile(py.read_text(encoding="utf-8"), str(py), "exec")
+        except SyntaxError as e:
+            fail(f"{py.name} 编译失败: {e}")
+    ok("scripts/*.py 编译通过")
+
+    refdir = ROOT / "references"
+    if refdir.is_dir():
+        for md in sorted(refdir.glob("*.md")):
+            if md.stat().st_size == 0:
+                fail(f"references/{md.name} 为空")
+        skill_text = (ROOT / "SKILL.md").read_text(encoding="utf-8")
+        for ref in sorted(set(re.findall(r"references/([\w\-.]+\.md)", skill_text))):
+            if not (refdir / ref).is_file():
+                fail(f"SKILL.md 引用的 references/{ref} 不存在")
+        ok("references 完整性通过")
+
+    if errors:
+        print(f"\n[check] {NAME}: {len(errors)} 项失败")
+        return False
+    print(f"\n[check] {NAME}: 全部通过")
+    return True
+
+
+def package() -> None:
+    if not check():
+        sys.exit(1)
+    (ROOT / "dist").mkdir(exist_ok=True)
+    entries: list[str] = []
+    with zipfile.ZipFile(OUT, "w", zipfile.ZIP_DEFLATED) as z:
+        for p in sorted(ROOT.rglob("*")):
+            if not p.is_file() or ".git" in p.parts:
+                continue
+            rel = p.relative_to(ROOT)
+            rel_posix = rel.as_posix()
+            if any(rx.search(rel_posix) for rx in EXCLUDE_RES):
+                continue
+            if not any(
+                rel_posix == inc.rstrip("/") or rel_posix.startswith(inc)
+                for inc in INCLUDE
+                if inc.endswith("/")
+            ) and rel_posix not in INCLUDE:
+                continue
+            z.write(p, arcname=f"{NAME}/{rel_posix}")
+            entries.append(rel_posix)
+    sha = hashlib.sha256(OUT.read_bytes()).hexdigest()
+    pkg = json.loads((ROOT / "package.json").read_text(encoding="utf-8"))
+    manifest = {
+        "name": NAME,
+        "version": pkg.get("version"),
+        "built_at": datetime.now(timezone.utc).isoformat(),
+        "files": len(entries),
+        "sha256": sha,
+        "entries": entries,
+    }
+    MANIFEST.write_text(json.dumps(manifest, ensure_ascii=False, indent=2), encoding="utf-8")
+    print(f"\n[package] {OUT} ({len(entries)} 文件, sha256={sha[:12]}…)")
+
+
+def main() -> None:
+    if "--check" in sys.argv[1:]:
+        sys.exit(0 if check() else 1)
+    package()
+
+
+if __name__ == "__main__":
+    main()