create-yss-spec 2.1.5 → 2.1.6

package/template/.codex/skills/beautiful-article/scripts/pdf-print-overrides.css

@@ -1,192 +0,0 @@
-/*
- * PDF print overrides for Beautiful Article.
- *
- * Injected by scripts/html-to-pdf.sh into article.html's <head> right before
- * Chromium headless prints it. reacticle's own print.css already handles
- * hiding export bars and break-inside on cards.
- *
- * This file adds four groups on top of that:
- *   0) Theme surface — keep the article theme background / text colors in PDF.
- *   A) TOC layout — force the sidebar TOC to stack above the article and
- *      page-break after it, so the article body starts on a fresh page.
- *   B) Page break behavior — undo reacticle's `.ra-section { break-inside:
- *      avoid-page }` (which causes huge empty pages for multi-page sections),
- *      glue headings to the following content, keep Hero / Lead / figures
- *      atomic, and apply widow/orphan control to paragraphs.
- *   C) Cover — if the article uses the 3:4 Cover component (default), keep
- *      its authored geometry intact and only force a page break after it.
- *      See references/cover.md.
- *
- * Why a separate file:
- *   - macOS BSD awk rejects multi-line strings via -v; reading from a file
- *     with getline sidesteps that.
- *   - CSS is independently editable / lintable / diff-friendly here.
- *   - Easy to swap or extend without touching the shell script.
- */
-
-@media print {
-  @page {
-    margin: 0;
-  }
-
-  /* ============================================================
-   * 0 · Theme surface (preserve paper color in PDF)
-   * ============================================================ */
-
-  .ra-root {
-    background: var(--ra-color-bg, #ffffff) !important;
-    color: var(--ra-color-text, #111111) !important;
-    print-color-adjust: exact;
-    -webkit-print-color-adjust: exact;
-    position: relative;
-    z-index: 0;
-    box-sizing: border-box;
-    min-height: 100vh;
-    padding: 0.45in !important;
-    box-decoration-break: clone;
-    -webkit-box-decoration-break: clone;
-  }
-
-  .ra-root::before {
-    content: "";
-    position: fixed;
-    inset: 0;
-    background: var(--ra-color-bg, #ffffff);
-    z-index: -1;
-    pointer-events: none;
-  }
-
-  /* ============================================================
-   * A · TOC layout (TOC above article, not beside it)
-   * ============================================================ */
-
-  /* A1) reacticle's TOC layout is a 2-col grid on desktop and `display: block`
-   *     on mobile (<= 999px). Force the mobile branch for print so the TOC
-   *     sits ABOVE the article column instead of beside it. */
-  .ra-article-layout--with-toc {
-    display: block !important;
-    max-width: none !important;
-    padding: 0 !important;
-  }
-
-  /* A2) TOC: kill sticky (only paints once on print), add breathing room, and
-   *     push the article to its own pages by breaking after the TOC. */
-  .ra-toc {
-    position: static !important;
-    margin-bottom: 1.5rem !important;
-    page-break-after: always;
-    break-after: page;
-  }
-
-  /* A3) Long TOCs save paper as a 2-column layout; short ones collapse
-   *     naturally back to one column. */
-  .ra-toc__list {
-    column-count: 2;
-    column-gap: 1.5rem;
-    column-fill: balance;
-  }
-
-  /* A4) Never split a TOC item across columns / pages. */
-  .ra-toc__item {
-    break-inside: avoid;
-    page-break-inside: avoid;
-  }
-
-  /* A5) Let the article column flow naturally on the page after the TOC. */
-  .ra-article-layout--with-toc > .ra-article {
-    break-before: auto;
-  }
-
-  /* A6) Strip underlines from TOC + body links in print (chrome already shows
-   *     them as link-blue; the colophon footer keeps its underline because it
-   *     sets its own text-decoration inline). */
-  .ra-toc a,
-  .ra-article a {
-    color: inherit;
-    text-decoration: none;
-  }
-
-  /* ============================================================
-   * B · Page break behavior (fixes huge empty pages in long sections)
-   * ============================================================ */
-
-  /* B1) reacticle's print.css aggressively sets `.ra-section { break-inside:
-   *     avoid-page }`. For multi-page sections that rule backfires badly:
-   *     the browser pushes the whole oversized section to the next page,
-   *     leaving the previous page nearly empty, then the section overflows
-   *     anyway. UNDO IT — let long sections break naturally across pages. */
-  .ra-section,
-  .ra-subsection,
-  .ra-section__body,
-  .ra-subsection__body {
-    break-inside: auto !important;
-    page-break-inside: auto !important;
-  }
-
-  /* B2) But never strand a heading at the bottom of a page. Glue Section /
-   *     Subsection headings to whatever follows, and keep the heading row
-   *     (index + title) intact. */
-  .ra-section__head,
-  .ra-subsection__head,
-  .ra-hero__title,
-  .ra-hero__subtitle,
-  h1,
-  h2,
-  h3,
-  h4 {
-    break-after: avoid;
-    page-break-after: avoid;
-    break-inside: avoid;
-    page-break-inside: avoid;
-  }
-
-  /* B3) Hero / Lead / Conclusion are short, atomic blocks — never split them
-   *     across pages. (Hero often holds title + subtitle + meta; ugly when
-   *     subtitle ends up alone on next page.) */
-  .ra-hero,
-  .ra-lead,
-  .ra-conclusion {
-    break-inside: avoid;
-    page-break-inside: avoid;
-  }
-
-  /* B4) Widows / orphans — never leave 1–2 stranded lines of a paragraph at
-   *     the top / bottom of a page. */
-  p,
-  li,
-  blockquote,
-  .ra-aside,
-  .ra-quote {
-    orphans: 3;
-    widows: 3;
-  }
-
-  /* B5) Atomic visual blocks: figures, tables, code blocks. Keep them whole
-   *     when reasonable; very long ones still split (the browser falls back). */
-  figure,
-  .ra-table,
-  .ra-codeblock,
-  .ra-formula,
-  .ra-image,
-  .ra-raw {
-    break-inside: avoid;
-    page-break-inside: avoid;
-  }
-
-  /* ============================================================
-   * C · Cover (the 3:4 cover above TOC, see references/cover.md)
-   * ============================================================ */
-
-  /* C1) Keep the cover's screen-authored 3:4 geometry in print. Earlier
-   *     versions stretched .ra-cover to height:100vh, but Chromium print can
-   *     clip absolutely positioned / grid-based cover internals after that
-   *     resize. The stable default is: preserve the cover and start the TOC on
-   *     the next page. Article-specific covers may opt into full-page print
-   *     sizing only after visual PDF verification. */
-  .ra-cover {
-    break-inside: avoid;
-    page-break-inside: avoid;
-    break-after: page;
-    page-break-after: always;
-  }
-}

package/template/.codex/skills/beautiful-article/scripts/scaffold.sh

@@ -1,172 +0,0 @@
-#!/usr/bin/env bash
-# ─────────────────────────────────────────────────────────────
-# scaffold.sh —— 一键创建一个 Beautiful Article 工作区。
-#
-# 用法：
-#   bash scripts/scaffold.sh <target-dir> [--theme=<id>] [--no-cover]
-#   bash scripts/scaffold.sh --list-themes
-#
-# 例子：
-#   bash <path-to-beautiful-article>/scripts/scaffold.sh ./my-article --theme=tufte
-#   bash <path-to-beautiful-article>/scripts/scaffold.sh ./brief --theme=press --no-cover
-#   bash <path-to-beautiful-article>/scripts/scaffold.sh --list-themes
-#
-# --no-cover：禁用文章封面（默认开 · 屏幕 3:4 / PDF 独占首页）。详见 references/cover.md。
-#
-# 工作区从 npm 安装**最新发布版的 reacticle**（package.json 里 reacticle: "latest"，
-# 每次 fresh scaffold 都会取当下最新）。无需本地 reacticle 仓库。
-#
-# 跑完后看 SKILL.md「Phase 4 First Spread」+ references/component-policy.md /
-# raw-policy.md / 选定主题 theme-profiles/<id>.md。
-# ─────────────────────────────────────────────────────────────
-set -euo pipefail
-
-SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-TEMPLATE="$SKILL_DIR/assets/scaffold-template"
-PROFILES="$SKILL_DIR/theme-profiles/index.json"
-DEFAULT_THEME="tufte"
-
-list_themes() {
-  echo "可用主题（来自 ${PROFILES}）:"
-  echo
-  # 没有 jq，用 grep + sed 提字段
-  grep -E '"id"|"label"|"mood"' "$PROFILES" | sed -E \
-    -e 's/.*"id":[[:space:]]*"([^"]+)".*/  • \1/' \
-    -e 's/.*"label":[[:space:]]*"([^"]+)".*/      \1/' \
-    -e 's/.*"mood":[[:space:]]*"([^"]+)".*/      \1/'
-  echo
-  echo "用 --theme=<id> 选定一个。默认：${DEFAULT_THEME}。"
-}
-
-# 校验主题 id 是否在 theme-profiles/index.json 里
-theme_exists() {
-  grep -Eq "\"id\"[[:space:]]*:[[:space:]]*\"$1\"" "$PROFILES"
-}
-
-# ── 解析参数 ──
-TARGET=""
-THEME="$DEFAULT_THEME"
-COVER=1
-for arg in "$@"; do
-  case "$arg" in
-    --list-themes) list_themes; exit 0 ;;
-    --theme=*) THEME="${arg#--theme=}" ;;
-    --no-cover) COVER=0 ;;
-    --cover) COVER=1 ;;
-    --*) echo "✗ 未知参数: $arg" >&2; exit 1 ;;
-    *) [[ -z "$TARGET" ]] && TARGET="$arg" ;;
-  esac
-done
-
-TARGET="${TARGET:-my-article}"
-
-# ── 校验主题 ──
-if ! theme_exists "$THEME"; then
-  echo "✗ 未知主题 '$THEME'。可用主题：" >&2
-  echo >&2
-  list_themes >&2
-  exit 1
-fi
-
-# ── 目标目录检查 ──
-if [[ -d "$TARGET" && -n "$(ls -A "$TARGET" 2>/dev/null || true)" ]]; then
-  echo "✗ 目标目录 '$TARGET' 已存在且非空，已中止。" >&2
-  exit 1
-fi
-if ! command -v npm >/dev/null; then
-  echo "✗ 需要 npm，但在 PATH 里没找到。" >&2
-  exit 1
-fi
-
-echo "▸ 在 $TARGET 创建 Beautiful Article 工作区"
-echo "▸ 主题：$THEME"
-echo "▸ 封面：$([[ "$COVER" == "1" ]] && echo "开（屏幕 3:4 / PDF 独占首页，详见 references/cover.md）" || echo "关")"
-echo "▸ reacticle：从 npm 安装最新发布版"
-
-mkdir -p "$TARGET"
-# 复制工程模板
-cp "$TEMPLATE/package.json"        "$TARGET/package.json"
-cp "$TEMPLATE/vite.config.ts"      "$TARGET/vite.config.ts"
-cp "$TEMPLATE/tsconfig.json"       "$TARGET/tsconfig.json"
-cp "$TEMPLATE/tsconfig.node.json"  "$TARGET/tsconfig.node.json"
-cp "$TEMPLATE/index.html"          "$TARGET/index.html"
-
-# 工作记忆目录 + 文章源目录
-mkdir -p "$TARGET/source" "$TARGET/plan" "$TARGET/review" \
-         "$TARGET/article/sections" "$TARGET/article/raw-blocks" "$TARGET/article/assets"
-cp "$TEMPLATE/article/main.tsx"             "$TARGET/article/main.tsx"
-cp "$TEMPLATE/article/Article.tsx"          "$TARGET/article/Article.tsx"
-# 一节一文件：assembler + 第一个 section 组件（多 Agent 并行的代码锚点）
-cp "$TEMPLATE/article/sections/01-opening.tsx" "$TARGET/article/sections/01-opening.tsx"
-
-# 封面：默认开。--no-cover 时跳过 Cover.tsx 并从 main.tsx 剥掉 __COVER_*__ 段。
-if [[ "$COVER" == "1" ]]; then
-  cp "$TEMPLATE/article/Cover.tsx" "$TARGET/article/Cover.tsx"
-fi
-
-# 留住空目录（git 友好）
-touch "$TARGET/article/raw-blocks/.gitkeep" "$TARGET/article/assets/.gitkeep"
-
-# ── 注入主题 id（用 perl 避免转义问题）──
-# main.tsx: <ThemeProvider theme="__THEME__">
-# Article.tsx: colophon "· __THEME__ theme"
-export RA_THEME="$THEME"
-perl -pi -e 's/__THEME__/$ENV{RA_THEME}/g' "$TARGET/article/main.tsx"
-perl -pi -e 's/__THEME__/$ENV{RA_THEME}/g' "$TARGET/article/Article.tsx"
-
-# ── 封面开关：处理 main.tsx 里 __COVER_*__ 标记包裹的区段 ──
-# COVER=1 → 去掉两行 __COVER_*_BEGIN__ / __COVER_*_END__ 标记（保留中间的 import 和 <Cover/>）
-# COVER=0 → 连标记带中间内容一起剥掉（封面不参与构建）
-if [[ "$COVER" == "1" ]]; then
-  # 删除标记行本身，保留 Cover 引入与渲染
-  perl -i -ne 'print unless /__COVER_(IMPORT|RENDER)_(BEGIN|END)__/' "$TARGET/article/main.tsx"
-else
-  # 把 BEGIN..END 之间（含两端标记行）整段删掉
-  perl -i -0pe 's{[^\n]*__COVER_IMPORT_BEGIN__.*?__COVER_IMPORT_END__[^\n]*\n}{}gs' "$TARGET/article/main.tsx"
-  perl -i -0pe 's{[^\n]*__COVER_RENDER_BEGIN__.*?__COVER_RENDER_END__[^\n]*\n}{}gs' "$TARGET/article/main.tsx"
-fi
-
-# 标记起步主题
-echo "$THEME" > "$TARGET/.theme"
-
-cd "$TARGET"
-echo "▸ 安装依赖（含 reacticle 最新版，可能要等一会）..."
-npm install >/dev/null 2>&1
-# 确保拿到当下最新（即使将来模板带了 lockfile 也强制刷新到最新）
-npm install reacticle@latest >/dev/null 2>&1
-
-INSTALLED_REACTICLE="$(node -e "console.log(JSON.parse(require('fs').readFileSync('node_modules/reacticle/package.json','utf8')).version)" 2>/dev/null || echo '?')"
-echo "▸ reacticle 版本：$INSTALLED_REACTICLE"
-
-echo "▸ 跑一次 typecheck 确认接线 OK ..."
-if npx tsc --noEmit; then
-  echo "✓ typecheck 通过"
-else
-  echo "⚠ typecheck 有问题（见上），dev / build 仍可能正常 —— 请人工确认。" >&2
-fi
-
-cat <<EOF
-
-✓ 完成。工作区：$TARGET（主题 $THEME，见 .theme；reacticle $INSTALLED_REACTICLE）
-
-下一步：
-  1. cd $TARGET
-  2. npm run dev      # 预览（Phase 4 先写首屏 + 第一个 Section）
-  3. 首屏（Hero/Lead）写进 article/Article.tsx（assembler）；
-     第一个 Section 写进 article/sections/01-opening.tsx
-     —— 铁律：一个 Section 一个文件，坚决不要写进 Article.tsx（多 Agent 并行前提）。
-  4. $([[ "$COVER" == "1" ]] && echo "封面：替换 article/Cover.tsx 里的 <CoverPlaceholder />，按文章 + 主题做定制（读 references/cover.md）。" || echo "封面：已关闭。如需打开，重新跑 scaffold 时去掉 --no-cover，或手动复制 Cover.tsx 模板。")
-  5. 把决策落盘到 source/ plan/ review/（Skill 的长期记忆）
-
-构建交付（Phase 8）：
-  • npm run build     # 类型检查 + 单页 HTML → dist/index.html（CSS+JS 内联）
-  • npm run html      # 复用 build，再复制为交付物 article/article.html
-
-切主题：改 article/main.tsx 的 <ThemeProvider theme="..."> 一个字（tufte / press）。
-升级组件库：npm install reacticle@latest
-
-写作必读（路径在 Skill 仓库内）：
-  • $SKILL_DIR/references/component-policy.md
-  • $SKILL_DIR/references/raw-policy.md
-  • $SKILL_DIR/theme-profiles/$THEME.md
-EOF

package/template/.codex/skills/beautiful-article/scripts/source-to-markdown-markitdown.py

@@ -1,100 +0,0 @@
-#!/usr/bin/env python3
-"""MarkItDown-backed Source -> Markdown helper for Beautiful Article.
-
-This script intentionally depends on MarkItDown and fails clearly when it is not
-available. Use source-to-markdown.py as the lightweight fallback.
-
-Usage:
-    python3 source-to-markdown-markitdown.py <file-or-url> -o source/source.md
-
-Optional dependency:
-    python3.10 -m pip install "markitdown[pdf,docx]"
-"""
-from __future__ import annotations
-
-import argparse
-import sys
-from pathlib import Path
-from urllib.parse import urlparse
-
-
-INSTALL_HINT = 'python3.10 -m pip install "markitdown[pdf,docx]"'
-
-
-def load_markitdown():
-    if sys.version_info < (3, 10):
-        print(
-            "✗ MarkItDown requires Python 3.10+; current Python is "
-            f"{sys.version_info.major}.{sys.version_info.minor}.",
-            file=sys.stderr,
-        )
-        print(f"  Install with: {INSTALL_HINT}", file=sys.stderr)
-        raise SystemExit(2)
-
-    try:
-        from markitdown import MarkItDown  # type: ignore
-    except Exception as exc:
-        print("✗ MarkItDown is not installed in this Python environment.", file=sys.stderr)
-        print(f"  Install with: {INSTALL_HINT}", file=sys.stderr)
-        print("  Or use scripts/source-to-markdown.py as the fallback.", file=sys.stderr)
-        print(f"  Import error: {exc}", file=sys.stderr)
-        raise SystemExit(2)
-
-    return MarkItDown
-
-
-def result_text(result) -> str:
-    for attr in ("text_content", "markdown"):
-        value = getattr(result, attr, None)
-        if isinstance(value, str) and value.strip():
-            return value
-    if isinstance(result, str):
-        return result
-    raise RuntimeError("MarkItDown returned no text_content/markdown output.")
-
-
-def is_url(src: str) -> bool:
-    return urlparse(src).scheme in ("http", "https")
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(description="Convert a source file or URL to Markdown via MarkItDown")
-    parser.add_argument("input", help="PDF / DOCX / PPTX / HTML / TXT / MD file or URL")
-    parser.add_argument("-o", "--output", help="write Markdown here (default: stdout)")
-    parser.add_argument(
-        "--use-plugins",
-        action="store_true",
-        help="enable installed MarkItDown plugins; disabled by default",
-    )
-    args = parser.parse_args()
-
-    src = args.input
-    if not is_url(src) and not Path(src).exists():
-        print(f"✗ 文件不存在：{src}", file=sys.stderr)
-        raise SystemExit(1)
-
-    MarkItDown = load_markitdown()
-    converter = MarkItDown(enable_plugins=args.use_plugins)
-
-    try:
-        markdown = result_text(converter.convert(src)).strip() + "\n"
-    except Exception as exc:
-        print(f"✗ MarkItDown 转换失败：{exc}", file=sys.stderr)
-        print("  可改用 scripts/source-to-markdown.py 做轻量 fallback。", file=sys.stderr)
-        raise SystemExit(2)
-
-    if args.output:
-        out = Path(args.output)
-        out.parent.mkdir(parents=True, exist_ok=True)
-        out.write_text(markdown, "utf-8")
-        print(
-            f"✓ MarkItDown 写入 {out}（{len(markdown)} 字符）。"
-            "请继续清理噪音并补 extraction-notes.md。",
-            file=sys.stderr,
-        )
-    else:
-        sys.stdout.write(markdown)
-
-
-if __name__ == "__main__":
-    main()

package/template/.codex/skills/beautiful-article/scripts/source-to-markdown.py

@@ -1,174 +0,0 @@
-#!/usr/bin/env python3
-"""Source → Markdown extraction helper for the Beautiful Article skill.
-
-Mechanically extracts text from a PDF / DOCX / HTML file (or URL) into rough
-Markdown. It does NOT clean editorial noise, mark image placeholders, or record
-extraction risk — that judgement stays with the agent (see Phase 1 +
-references/source-to-markdown.md). The agent should review and refine the output
-into source/source.md and write source/extraction-notes.md.
-
-Usage:
-    python3 source-to-markdown.py <input.pdf|.docx|.html|.htm|.txt|.md|URL> [-o out.md]
-
-Dependencies are probed at runtime and optional. If a parser is missing the
-script prints an install hint and degrades gracefully.
-"""
-from __future__ import annotations
-
-import argparse
-import sys
-from pathlib import Path
-from urllib.parse import urlparse
-
-
-def _hint(pkg: str) -> str:
-    return f"  (缺少 {pkg}，可安装：pip install {pkg})"
-
-
-def from_pdf(path: str) -> str:
-    try:
-        import pdfplumber  # type: ignore
-    except Exception:
-        try:
-            from pdfminer.high_level import extract_text  # type: ignore
-
-            return extract_text(path)
-        except Exception:
-            print(_hint("pdfplumber 或 pdfminer.six"), file=sys.stderr)
-            raise SystemExit(2)
-    out = []
-    with pdfplumber.open(path) as pdf:
-        for i, page in enumerate(pdf.pages, 1):
-            out.append(f"\n<!-- page {i} -->\n")
-            out.append(page.extract_text() or "")
-            for t in page.extract_tables() or []:
-                out.append("\n" + _table_to_md(t) + "\n")
-    return "\n".join(out)
-
-
-def from_docx(path: str) -> str:
-    try:
-        import docx  # type: ignore
-    except Exception:
-        print(_hint("python-docx"), file=sys.stderr)
-        raise SystemExit(2)
-    doc = docx.Document(path)
-    out = []
-    for p in doc.paragraphs:
-        text = p.text.strip()
-        if not text:
-            out.append("")
-            continue
-        style = (p.style.name or "").lower()
-        if style.startswith("heading"):
-            level = "".join(c for c in style if c.isdigit()) or "1"
-            out.append("#" * min(int(level), 6) + " " + text)
-        else:
-            out.append(text)
-    for table in doc.tables:
-        rows = [[c.text.strip() for c in r.cells] for r in table.rows]
-        if rows:
-            out.append("\n" + _table_to_md(rows) + "\n")
-    return "\n".join(out)
-
-
-def from_html(html: str) -> str:
-    try:
-        from bs4 import BeautifulSoup  # type: ignore
-    except Exception:
-        print(_hint("beautifulsoup4"), file=sys.stderr)
-        # crude fallback: strip tags
-        import re
-
-        return re.sub(r"<[^>]+>", "", html)
-    soup = BeautifulSoup(html, "html.parser")
-    for tag in soup(["script", "style", "nav", "footer", "aside", "header"]):
-        tag.decompose()
-    main = soup.find("article") or soup.find("main") or soup.body or soup
-    lines = []
-    for el in main.find_all(
-        ["h1", "h2", "h3", "h4", "p", "li", "pre", "blockquote"]
-    ):
-        text = el.get_text(" ", strip=True)
-        if not text:
-            continue
-        name = el.name
-        if name.startswith("h") and name[1:].isdigit():
-            lines.append("#" * int(name[1:]) + " " + text)
-        elif name == "li":
-            lines.append("- " + text)
-        elif name == "pre":
-            lines.append("```\n" + text + "\n```")
-        elif name == "blockquote":
-            lines.append("> " + text)
-        else:
-            lines.append(text)
-    return "\n\n".join(lines)
-
-
-def from_url(url: str) -> str:
-    try:
-        import urllib.request
-
-        req = urllib.request.Request(url, headers={"User-Agent": "Mozilla/5.0"})
-        with urllib.request.urlopen(req, timeout=30) as resp:  # noqa: S310
-            html = resp.read().decode("utf-8", "replace")
-    except Exception as e:  # pragma: no cover
-        print(f"✗ 抓取失败：{e}", file=sys.stderr)
-        print("  也可以用 agent 的网页抓取能力获取正文后再清理。", file=sys.stderr)
-        raise SystemExit(2)
-    return from_html(html)
-
-
-def _table_to_md(rows) -> str:
-    rows = [[("" if c is None else str(c)).replace("\n", " ").strip() for c in r] for r in rows]
-    if not rows:
-        return ""
-    width = max(len(r) for r in rows)
-    rows = [r + [""] * (width - len(r)) for r in rows]
-    head = "| " + " | ".join(rows[0]) + " |"
-    sep = "| " + " | ".join(["---"] * width) + " |"
-    body = ["| " + " | ".join(r) + " |" for r in rows[1:]]
-    return "\n".join([head, sep, *body])
-
-
-def main() -> None:
-    ap = argparse.ArgumentParser(description="Source → Markdown extraction helper")
-    ap.add_argument("input", help="PDF / DOCX / HTML / TXT / MD file or URL")
-    ap.add_argument("-o", "--output", help="write Markdown here (default: stdout)")
-    args = ap.parse_args()
-
-    src = args.input
-    parsed = urlparse(src)
-    if parsed.scheme in ("http", "https"):
-        md = from_url(src)
-    else:
-        p = Path(src)
-        if not p.exists():
-            print(f"✗ 文件不存在：{src}", file=sys.stderr)
-            raise SystemExit(1)
-        ext = p.suffix.lower()
-        if ext == ".pdf":
-            md = from_pdf(str(p))
-        elif ext == ".docx":
-            md = from_docx(str(p))
-        elif ext in (".html", ".htm"):
-            md = from_html(p.read_text("utf-8", "replace"))
-        elif ext in (".md", ".markdown", ".txt"):
-            md = p.read_text("utf-8", "replace")
-        else:
-            print(f"✗ 不支持的输入类型：{ext}", file=sys.stderr)
-            raise SystemExit(1)
-
-    md = (md or "").strip() + "\n"
-    if args.output:
-        out = Path(args.output)
-        out.parent.mkdir(parents=True, exist_ok=True)
-        out.write_text(md, "utf-8")
-        print(f"✓ 写入 {out}（{len(md)} 字符）。请人工清理噪音并补 extraction-notes.md。", file=sys.stderr)
-    else:
-        sys.stdout.write(md)
-
-
-if __name__ == "__main__":
-    main()