@peteryuan/wxformat 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pengfei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,156 @@
+# wxformat — 公众号文章排版 CLI
+
+把 Markdown 草稿一键转为「可直接发布」的版本：**纯净 Markdown + 公众号 HTML（全内联样式，粘贴公众号后台即可发布）**。
+
+设计目标：**CLI 优先**——可被脚本、CI 与大模型（LLM）直接调用；同时保留人用的爽点（浏览器预览、排版面板一键复制、边写边实时预览）。
+
+```
+wxformat drafts/文章.md              # 产出 .clean.md + .html，macOS 自动复制发布 HTML
+wxformat drafts/文章.md --preview    # 浏览器预览
+wxformat drafts/文章.md --editor     # 排版面板：页面内微调 + 一键复制
+wxformat drafts/文章.md --watch --preview   # 边写边实时预览
+cat 文章.md | wxformat - -f md -o -  # 管道：纯净 Markdown → stdout
+wxformat 文章.md --json --no-clipboard     # LLM/脚本友好输出
+```
+
+## 快速开始
+
+无需安装任何依赖（Node ≥ 18，ESM）：
+
+```bash
+# 方式一：直接跑
+node wxformat/bin/wxformat.mjs drafts/文章.md
+
+# 方式二：工作区便捷入口
+bin/wxformat drafts/文章.md
+
+# 方式三：全局安装（可选）
+cd wxformat && npm link
+wxformat drafts/文章.md
+```
+
+## 完整选项
+
+| 选项 | 说明 |
+|---|---|
+| `<file\|->` | 输入文件；`-` 表示从 stdin 读取（管道友好） |
+| `-o, --output <路径\|->` | `.md`/`.html` 文件只写该格式；目录写入默认文件名；`-` 输出到 stdout；省略写到输入文件旁（`<名>.clean.md` / `<名>.html`） |
+| `-f, --format <md\|html\|both>` | 输出格式（默认 `both`；stdin 且无 `-o` 时默认 html） |
+| `-t, --theme <id>` | `bw` 黑白极简 ｜ `paper` 纸墨书香 ｜ `celadon` 晨雾青瓷（默认 `bw`） |
+| `-p, --preview` | 生成预览页并自动打开浏览器 |
+| `-e, --editor` | 打开浏览器排版面板：正文可微调，一键复制发布 HTML / 纯净 Markdown |
+| `-c, --clipboard` | 复制到剪贴板（macOS 文件模式下默认自动复制发布 HTML——写入富文本 `text/html`，公众号后台**粘贴即渲染**；Windows/Linux 回退纯文本，请用浏览器打开 `.html` 全选复制） |
+| `--clipboard=md\|html` | 指定复制哪种内容 |
+| `--no-clipboard` | 禁止复制（脚本/CI 友好） |
+| `-j, --json` | 机器可读 JSON 输出（含 md / section / 产物路径；自动跳过剪贴板） |
+| `-w, --watch` | 监听输入文件，变更自动重排版（配 `--preview` 浏览器实时刷新） |
+| `-q, --quiet` | 只输出产物路径（或 stdout 内容） |
+| `--config <文件>` | 配置文件（默认探测 `.wxformatrc.json` / `wxformat.config.json` / `package.json#wxformat`） |
+| `--no-meta-strip` | 不剥离元信息与发布包，整篇原文排版 |
+| `--no-open` | 生成预览/面板文件但不自动打开浏览器（CI 友好） |
+| `-V, --version` / `-h, --help` | 版本 / 帮助 |
+
+退出码：`0` 成功 ｜ `1` 参数/输入错误 ｜ `2` 转换失败。
+
+## 配置文件
+
+`.wxformatrc.json`（放在 cwd 即可，CLI 参数优先）：
+
+```json
+{
+  "theme": "paper",
+  "format": "both",
+  "clipboard": "html",
+  "stripMeta": true
+}
+```
+
+`clipboard` 支持 `true`（默认目标）或 `"md"` / `"html"`。
+
+## LLM / 脚本调用
+
+```bash
+# 一步拿到结构化结果（含正文 md、发布 html、产物路径、字数）
+wxformat drafts/文章.md --json --no-clipboard
+
+# 管道：把任意 Markdown 转成公众号 HTML 并输出到 stdout
+cat note.md | wxformat - -f html -o -
+```
+
+JSON 输出结构：
+
+```json
+{
+  "ok": true,
+  "title": "…",
+  "chars": 1234,
+  "theme": "bw",
+  "themeLabel": "黑白极简",
+  "tags": ["示例", "测试"],
+  "format": "html",
+  "md": "# 标题\n\n正文…",
+  "section": "<section style=\"…\">…</section>",
+  "files": { "md": "/abs/path.clean.md", "html": "/abs/path.html" },
+  "stdout": null,
+  "clipboard": "skip",
+  "preview": null,
+  "editor": null
+}
+```
+
+失败时 JSON 模式仍输出可解析结果：`{ "ok": false, "error": "…", "code": 1|2 }`，同时 stderr 给人类可读信息。
+
+## 架构
+
+```
+wxformat/
+  bin/wxformat.mjs     CLI 入口（参数解析 / 输出调度 / 剪贴板 / 预览 / watch）
+  lib/core.mjs         排版核心（剥离 + 渲染编排）
+  lib/args.mjs         零依赖参数解析
+  lib/clipboard.mjs    跨平台剪贴板（pbcopy / clip / wl-copy…）
+  lib/editor.mjs       浏览器排版面板页（自包含单页）
+  lib/live-server.mjs  --watch --preview 实时刷新用的极简本地服务
+  lib/help.mjs         帮助与版本
+  test/                node:test 测试
+```
+
+**单一实现**：渲染器优先复用工作区 `../dsh-wechat-preview/lib/render.js`——CLI 与 DSH 里的「排版预览」GUI 输出同源，改主题、改剥离规则只动一处，两边同时生效。npm 独立安装时该路径不存在，自动回退到本包自带的 `lib/render.js` 副本（发布前由 `scripts/sync-render.mjs` 同步，`prepublishOnly` 钩子保证打包时副本永远最新）。
+
+## 发布到 npm
+
+包名 `@peteryuan/wxformat`（scoped；裸名 `wxformat` 因与已有包 `toformat` 过于相似被 npm 拒绝注册）。安装后命令仍为 `wxformat`。发布流程：
+
+```bash
+cd ~/Desktop/DSH/wxformat
+npm publish --dry-run --registry=https://registry.npmjs.org/ --access=public   # 预演
+npm publish --registry=https://registry.npmjs.org/ --access=public            # 正式发布
+```
+
+（`--registry` 显式指定官方源，绕开本机 CNPM 镜像；scoped 包首次发布需 `--access=public`。）
+
+发布后验证：
+
+```bash
+mkdir /tmp/wx-demo && cd /tmp/wx-demo && npm init -y
+npm i -g @peteryuan/wxformat        # 或 npx @peteryuan/wxformat
+wxformat --help
+```
+
+注意：npm 版携带的是发布时刻的渲染快照；工作区改过主题后，重新 `npm publish` 前 `prepublishOnly` 会自动同步最新 `render.js`。
+
+## 主题（TODO）
+
+当前三套：`bw`（黑白极简）、`paper`（纸墨书香）、`celadon`（晨雾青瓷），定义在 `dsh-wechat-preview/lib/render.js` 的 `THEMES` 里。后续优化主题（新增/调色）直接改那个文件即可，CLI 无需改动。
+
+计划中的方向（待定稿）：
+- 增加 2-3 套新主题（如「科技蓝」「暖黄奶油」「暗夜」）；
+- 主题支持可配置项（字号、段距、配色）覆盖默认值；
+- 允许用户自定义主题文件（`wxformat.theme.json`）。
+
+## 后续路线
+
+- [x] 独立发布：`render.js` 已打入包内（工作区优先 + 副本回退），可 `npm publish`
+- [ ] 主题优化（见上）
+- [ ] `--preview` 增加手机尺寸切换（375px 模拟）
+- [ ] 批量排版：`wxformat "drafts/*.md"`（或显式多文件参数）
+- [ ] 自动识别墨滴/135 等编辑器差异做兼容输出

package/bin/wxformat.mjs

@@ -0,0 +1,335 @@
+#!/usr/bin/env node
+/**
+ * wxformat — 公众号文章排版 CLI
+ *
+ * 把 Markdown 草稿（或 stdin 管道内容）一键转为"可直接发布"的版本：
+ *   纯净 Markdown + 公众号 HTML（全内联样式，粘贴公众号后台即可发布）。
+ *
+ * 用法:
+ *   wxformat <file|-> [选项]
+ *
+ * 示例:
+ *   wxformat drafts/文章.md                       # 产出 .clean.md + .html，自动复制发布 HTML
+ *   wxformat drafts/文章.md --theme paper         # 换主题
+ *   wxformat drafts/文章.md --preview             # 浏览器预览
+ *   wxformat drafts/文章.md --editor              # 打开排版面板，页面内一键复制
+ *   wxformat drafts/文章.md --watch --preview     # 边写边实时预览
+ *   cat 文章.md | wxformat - -f md -o -           # 管道：纯净 Markdown 到 stdout
+ *   wxformat 文章.md --json --no-clipboard        # 机器可读输出（LLM/脚本友好）
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { existsSync, statSync, watchFile, unwatchFile } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { spawn } from "node:child_process";
+import { formatArticle, THEMES } from "../lib/core.mjs";
+import { copyText, copyHtml } from "../lib/clipboard.mjs";
+import { editorPage } from "../lib/editor.mjs";
+import { startLiveServer } from "../lib/live-server.mjs";
+import { parseArgs } from "../lib/args.mjs";
+import { HELP, VERSION } from "../lib/help.mjs";
+
+const EXIT_OK = 0;
+const EXIT_USAGE = 1;
+const EXIT_CONVERT = 2;
+
+function fail(code, msg, { json } = {}) {
+  if (json) console.log(JSON.stringify({ ok: false, error: msg, code }, null, 2));
+  console.error(`[wxformat] ${msg}`);
+  process.exit(code);
+}
+
+async function readStdin() {
+  const chunks = [];
+  for await (const c of process.stdin) chunks.push(c);
+  return Buffer.concat(chunks).toString("utf8");
+}
+
+async function loadConfig(explicit) {
+  const list = explicit
+    ? [path.resolve(explicit)]
+    : [".wxformatrc.json", "wxformat.config.json", "package.json"].map((p) => path.resolve(p));
+  for (const p of list) {
+    if (!existsSync(p)) continue;
+    const obj = JSON.parse(await readFile(p, "utf8"));
+    const src = path.basename(p) === "package.json" ? obj.wxformat : obj;
+    if (!src || typeof src !== "object") continue;
+    return {
+      theme: src.theme,
+      format: src.format,
+      clipboard: src.clipboard,
+      stripMeta: src.stripMeta,
+    };
+  }
+  return {};
+}
+
+/** 打开浏览器/文件（异步、不阻塞、不挂起父进程）。 */
+function openPath(target) {
+  const cmd =
+    process.platform === "darwin"
+      ? ["open", target]
+      : process.platform === "win32"
+        ? ["cmd", "/c", "start", "", target]
+        : ["xdg-open", target];
+  try {
+    spawn(cmd[0], cmd.slice(1), { detached: true, stdio: "ignore" }).unref();
+  } catch {
+    // 打不开就算了，不影响主流程
+  }
+}
+
+/**
+ * 解析输出目标，决定写哪些文件 / 是否走 stdout。
+ * @returns {{files: Record<string,string>, stdout: string|null, fmt: string}}
+ */
+function resolveOutput(out, format, fromStdin, inputLabel, result) {
+  const stem = fromStdin ? null : inputLabel.replace(/\.[^.]+$/, "");
+  const mdName = (b) => `${b}.clean.md`;
+  const htmlName = (b) => `${b}.html`;
+
+  if (out === undefined) {
+    if (fromStdin) {
+      // stdin 且未指定 -o：单一 stdout 流，默认给 html（发布物）
+      if (format === "both") return { stdout: result.section, files: {}, fmt: "html" };
+      return { stdout: format === "md" ? result.md : result.section, files: {}, fmt: format };
+    }
+    const files = {};
+    if (format !== "html") files.md = mdName(stem);
+    if (format !== "md") files.html = htmlName(stem);
+    return { files, stdout: null, fmt: format };
+  }
+
+  if (out === "-") {
+    if (format === "both") {
+      throw new Error("「-o -」与「-f both」冲突：请指定 -f md 或 -f html（或加 --json 走 JSON 输出）");
+    }
+    return { stdout: format === "md" ? result.md : result.section, files: {}, fmt: format };
+  }
+
+  const isDir = out.endsWith("/") || out.endsWith(path.sep) || (existsSync(out) && statSync(out).isDirectory());
+  if (isDir) {
+    const dir = path.resolve(out.replace(/[\\/]$/, ""));
+    const base = stem ? path.basename(stem) : "article";
+    const files = {};
+    if (format !== "html") files.md = path.join(dir, mdName(base));
+    if (format !== "md") files.html = path.join(dir, htmlName(base));
+    return { files, stdout: null, fmt: format };
+  }
+
+  const ext = path.extname(out).toLowerCase();
+  const fromExt = ext === ".md" ? "md" : ext === ".html" ? "html" : null;
+  if (!fromExt) throw new Error(`-o 需以 .md / .html 结尾、为目录，或为 -（当前: ${out}）`);
+  if (format === "both") throw new Error(`「-f both」需配合目录输出或省略 -o（当前 -o ${out}）`);
+  if (format !== fromExt) throw new Error(`-o 扩展名（.${fromExt}）与 -f ${format} 冲突`);
+  return { files: fromExt === "md" ? { md: path.resolve(out) } : { html: path.resolve(out) }, stdout: null, fmt: fromExt };
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  let opts;
+  try {
+    opts = parseArgs(argv);
+  } catch (e) {
+    fail(EXIT_USAGE, e.message);
+  }
+
+  if (opts.help) {
+    console.log(HELP);
+    process.exit(EXIT_OK);
+  }
+  if (opts.version) {
+    console.log(VERSION);
+    process.exit(EXIT_OK);
+  }
+  if (opts._.length !== 1) {
+    fail(EXIT_USAGE, "需要一个输入文件（或 - 表示从 stdin 读取）\n  示例: wxformat drafts/文章.md    |    cat a.md | wxformat -");
+  }
+
+  const json = !!opts.json;
+  const quiet = !!opts.quiet;
+  let watch = !!opts.watch;
+
+  let cfg = {};
+  try {
+    cfg = await loadConfig(opts.config);
+  } catch (e) {
+    fail(EXIT_USAGE, `配置文件解析失败: ${e.message}`, { json });
+  }
+
+  const theme = opts.theme ?? cfg.theme ?? "bw";
+  if (!THEMES[theme]) fail(EXIT_USAGE, `未知主题「${theme}」，可用主题: ${Object.keys(THEMES).join(" / ")}`, { json });
+  const format = opts.format ?? cfg.format ?? "both";
+  if (!["md", "html", "both"].includes(format)) fail(EXIT_USAGE, `未知格式「${format}」，可用: md / html / both`, { json });
+  const strip = opts.noStrip ? false : cfg.stripMeta !== false;
+
+  const input = opts._[0];
+  const fromStdin = input === "-";
+
+  let raw;
+  let inputLabel;
+  if (fromStdin) {
+    raw = await readStdin();
+    inputLabel = "<stdin>";
+    if (!raw.trim()) fail(EXIT_USAGE, "stdin 为空", { json });
+    if (watch) {
+      console.warn("[wxformat] stdin 不支持 --watch，按单次处理");
+      watch = false;
+    }
+  } else {
+    const src = path.resolve(input);
+    if (!existsSync(src) || statSync(src).isDirectory()) fail(EXIT_USAGE, `文件不存在: ${input}`, { json });
+    raw = await readFile(src, "utf8");
+    inputLabel = src;
+  }
+
+  let result;
+  try {
+    result = formatArticle(raw, { theme, stripMeta: strip });
+  } catch (e) {
+    fail(EXIT_CONVERT, e.message, { json });
+  }
+
+  let out;
+  try {
+    out = resolveOutput(opts.output, format, fromStdin, inputLabel, result);
+  } catch (e) {
+    fail(EXIT_USAGE, e.message, { json });
+  }
+
+  /* ── 写产物 ─────────────────────────────────────────────────── */
+  // .html 文件写"完整页面"（浏览器打开/全选复制）；剪贴板与 JSON 里给的是 section 发布片段
+  const files = {};
+  for (const [k, p] of Object.entries(out.files)) {
+    try {
+      await mkdir(path.dirname(p), { recursive: true });
+      await writeFile(p, k === "md" ? result.md : result.document, "utf8");
+      files[k] = p;
+    } catch (e) {
+      fail(EXIT_CONVERT, `写入失败 ${p}: ${e.message}`, { json });
+    }
+  }
+
+  /* ── 剪贴板 ─────────────────────────────────────────────────── */
+  // --json / --no-clipboard 一律不复制；stdin 与 stdout 模式不自动复制；
+  // macOS 文件输出模式下默认自动复制"发布 HTML"（直接去公众号后台粘贴发布）。
+  const defaultCopyTarget = () => (out.fmt === "md" ? "md" : "html");
+  let clipboard = "skip";
+  if (!json && !opts.noClipboard) {
+    let target = null;
+    if (opts.clipboard === true) target = defaultCopyTarget();
+    else if (typeof opts.clipboard === "string") target = opts.clipboard;
+    else if (cfg.clipboard) target = cfg.clipboard === true ? defaultCopyTarget() : cfg.clipboard;
+    else if (!fromStdin && Object.keys(out.files).length > 0 && process.platform === "darwin") {
+      target = defaultCopyTarget();
+    }
+    if (typeof target === "string" && !["html", "md"].includes(target)) {
+      fail(EXIT_USAGE, `--clipboard 取值需为 md 或 html（当前: ${target}）`, { json });
+    }
+    if (target) {
+      const text = target === "html" ? result.section : result.md;
+      // 发布 HTML 走富文本剪贴板（text/html），公众号后台粘贴即渲染；Markdown 走纯文本
+      const ok = target === "html" ? copyHtml(text) : copyText(text);
+      clipboard = ok ? `已复制${target === "html" ? "发布 HTML" : "纯净 Markdown"}` : "复制失败（请手动复制产物文件）";
+    }
+  }
+
+  /* ── 预览 / 排版面板 / 实时服务 ─────────────────────────────── */
+  let preview = null;
+  let editor = null;
+  let live = null;
+  const tmp = path.join(os.tmpdir(), `wxformat-${process.pid}-${Date.now().toString(36)}`);
+  await mkdir(tmp, { recursive: true });
+  const tmpFile = (name, content) => writeFile(path.join(tmp, name), content, "utf8").then(() => path.join(tmp, name));
+
+  if (opts.preview) {
+    if (watch) {
+      live = await startLiveServer();
+      live.setDocument(result.document);
+      preview = live.url;
+    } else {
+      preview = await tmpFile("preview.html", result.document);
+    }
+    if (!opts.noOpen) openPath(live ? live.url : preview);
+  }
+  if (opts.editor) {
+    editor = await tmpFile(
+      "editor.html",
+      editorPage({ title: result.title, section: result.section, md: result.md, themeLabel: result.themeLabel }),
+    );
+    if (!opts.noOpen) openPath(editor);
+  }
+
+  /* ── 输出 ───────────────────────────────────────────────────── */
+  if (json) {
+    console.log(
+      JSON.stringify(
+        {
+          ok: true,
+          title: result.title,
+          chars: result.chars,
+          theme: result.theme,
+          themeLabel: result.themeLabel,
+          tags: result.tags,
+          format: out.fmt,
+          md: result.md,
+          section: result.section,
+          files,
+          stdout: out.stdout,
+          clipboard,
+          preview,
+          editor,
+        },
+        null,
+        2,
+      ),
+    );
+  } else if (out.stdout !== null) {
+    // stdout 模式：只输出内容本身，杜绝报告杂音污染管道
+    process.stdout.write(out.stdout.endsWith("\n") ? out.stdout : `${out.stdout}\n`);
+  } else if (quiet) {
+    for (const p of Object.values(files)) console.log(p);
+  } else {
+    console.log(`✅ 排版完成：《${result.title}》`);
+    console.log(`   正文 ${result.chars} 字 ｜ 主题：${result.themeLabel}（${result.theme}）`);
+    for (const [k, p] of Object.entries(files)) console.log(`   ${k === "md" ? "纯净 Markdown" : "公众号 HTML"}：${p}`);
+    console.log(`   剪贴板：${clipboard === "skip" ? "跳过" : clipboard}`);
+    if (preview) console.log(`   预览：${preview}`);
+    if (editor) console.log(`   排版面板：${editor}`);
+    if (watch) console.log("   监听中…（Ctrl+C 退出）");
+  }
+
+  /* ── watch：监听输入文件，变更自动重排版 ─────────────────────── */
+  if (watch) {
+    let busy = false;
+    const rerun = async () => {
+      if (busy) return;
+      busy = true;
+      try {
+        const raw2 = await readFile(inputLabel, "utf8");
+        const r2 = formatArticle(raw2, { theme, stripMeta: strip });
+        for (const [k, p] of Object.entries(out.files)) {
+          await writeFile(p, k === "md" ? r2.md : r2.document, "utf8");
+        }
+        if (live) live.setDocument(r2.document);
+        // 状态日志走 stderr：不污染 --json / 管道模式的 stdout
+        if (!quiet) console.error(`   [${new Date().toLocaleTimeString()}] 已重新排版（正文 ${r2.chars} 字）`);
+      } catch (e) {
+        console.error(`   [${new Date().toLocaleTimeString()}] 排版失败: ${e.message}`);
+      } finally {
+        busy = false;
+      }
+    };
+    watchFile(inputLabel, { interval: 300 }, rerun);
+    process.on("SIGINT", () => {
+      unwatchFile(inputLabel, rerun);
+      if (live) live.close();
+      process.exit(EXIT_OK);
+    });
+  }
+}
+
+main().catch((e) => {
+  console.error(`[wxformat] 未预期错误: ${e.stack || e.message}`);
+  process.exit(EXIT_CONVERT);
+});

package/lib/args.mjs

@@ -0,0 +1,94 @@
+/**
+ * args.mjs — 零依赖命令行参数解析
+ *
+ * 支持：
+ *   --long            布尔开关
+ *   --long=value      带值
+ *   --long value      带值（空格分隔）
+ *   -x                短开关
+ *   --clipboard[=md|html]   可选值参数（裸写为 true，等号给值）
+ *   --                其后所有内容视为位置参数
+ */
+
+const VALUE_KEYS = new Set(["output", "format", "theme", "config"]);
+
+const LONG = {
+  "--output": "output",
+  "--format": "format",
+  "--theme": "theme",
+  "--config": "config",
+  "--clipboard": "clipboard",
+  "--preview": "preview",
+  "--editor": "editor",
+  "--json": "json",
+  "--watch": "watch",
+  "--quiet": "quiet",
+  "--version": "version",
+  "--help": "help",
+  "--no-meta-strip": "noStrip",
+  "--no-clipboard": "noClipboard",
+  "--no-open": "noOpen",
+};
+
+const SHORT = {
+  "-o": "output",
+  "-f": "format",
+  "-t": "theme",
+  "-p": "preview",
+  "-e": "editor",
+  "-c": "clipboard",
+  "-j": "json",
+  "-w": "watch",
+  "-q": "quiet",
+  "-V": "version",
+  "-h": "help",
+};
+
+/**
+ * @param {string[]} argv 不含 node 与脚本路径的参数数组
+ * @returns {object} 解析结果，位置参数收集在 `_` 数组
+ * @throws {Error} 未知参数 / 缺少值
+ */
+export function parseArgs(argv) {
+  const opts = { _: [] };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--") {
+      opts._.push(...argv.slice(i + 1));
+      break;
+    }
+    let key;
+    let inline;
+    if (a.startsWith("--")) {
+      const eq = a.indexOf("=");
+      if (eq > 0) {
+        key = LONG[a.slice(0, eq)];
+        inline = a.slice(eq + 1);
+      } else {
+        key = LONG[a];
+      }
+      if (!key) throw new Error(`未知参数: ${a}`);
+    } else if (a.startsWith("-") && a.length > 1) {
+      key = SHORT[a];
+      if (!key) throw new Error(`未知参数: ${a}`);
+    } else {
+      opts._.push(a);
+      continue;
+    }
+
+    if (key === "clipboard") {
+      // 可选值参数：`-c` / `--clipboard` → true；`--clipboard=html` → "html"
+      opts.clipboard = inline === undefined || inline === "" ? true : inline;
+    } else if (VALUE_KEYS.has(key)) {
+      let v = inline;
+      if (v === undefined) {
+        v = argv[++i];
+        if (v === undefined) throw new Error(`缺少「${a}」的值`);
+      }
+      opts[key] = v;
+    } else {
+      opts[key] = true;
+    }
+  }
+  return opts;
+}

package/lib/clipboard.mjs

@@ -0,0 +1,90 @@
+/**
+ * clipboard.mjs — 跨平台剪贴板写入（零依赖）
+ *
+ * copyText — 纯文本（macOS pbcopy / Windows clip / Linux wl-copy、xclip、xsel）
+ * copyHtml — 富文本 HTML（仅 macOS）：用 osascript + AppleScript-ObjC（AppKit）
+ *            写入 NSPasteboard 的 text/html 类型。微信公众号后台等富文本编辑器
+ *            "粘贴即渲染"；若只写纯文本，后台会把源码当文字贴出来（全是代码）。
+ *            其他平台回退为纯文本复制（请用浏览器打开 .html 全选复制）。
+ *
+ * 注意：不要用 JXA（-l JavaScript）——部分 macOS 上 ObjC 桥接对 NSPasteboard
+ * 解析异常；AppleScript-ObjC（use framework "AppKit"）是稳定路径。
+ */
+import { spawnSync } from "node:child_process";
+import { mkdtempSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+
+export function copyText(text) {
+  const cmds =
+    process.platform === "darwin"
+      ? [["pbcopy"]]
+      : process.platform === "win32"
+        ? [["clip"]]
+        : [["wl-copy"], ["xclip", "-selection", "clipboard"], ["xsel", "--clipboard", "--input"]];
+  for (const [cmd, ...args] of cmds) {
+    try {
+      const r = spawnSync(cmd, args, {
+        input: text,
+        encoding: "utf8",
+        stdio: ["pipe", "ignore", "pipe"],
+      });
+      if (r.status === 0) return true;
+    } catch {
+      // 尝试下一个可用命令
+    }
+  }
+  return false;
+}
+
+/**
+ * 把 HTML 以富文本（text/html）写入剪贴板。
+ * @param {string} html 要粘贴到公众号后台的 HTML 片段
+ * @returns {boolean}
+ */
+export function copyHtml(html) {
+  if (process.platform !== "darwin") return copyText(html);
+  const dir = mkdtempSync(path.join(tmpdir(), "wxformat-html-"));
+  try {
+    const htmlFile = path.join(dir, "clip.html");
+    const plainFile = path.join(dir, "clip.txt");
+    writeFileSync(htmlFile, html, "utf8");
+    // 纯文本兜底：普通编辑器粘贴也有内容（去标签，避免贴出源码）
+    const plain = html.replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
+    writeFileSync(plainFile, plain, "utf8");
+
+    const scriptFile = path.join(dir, "clip.applescript");
+    writeFileSync(
+      scriptFile,
+      `use framework "AppKit"
+use framework "Foundation"
+use scripting additions
+
+set thePath to (system attribute "WXFORMAT_CLIP_FILE")
+set thePlainPath to (system attribute "WXFORMAT_CLIP_PLAIN_FILE")
+
+set thePasteboard to current application's NSPasteboard's generalPasteboard()
+set theHTML to current application's NSString's stringWithContentsOfFile_encoding_error_(thePath, current application's NSUTF8StringEncoding, missing value)
+set theData to theHTML's dataUsingEncoding_(current application's NSUTF8StringEncoding)
+set thePlain to current application's NSString's stringWithContentsOfFile_encoding_error_(thePlainPath, current application's NSUTF8StringEncoding, missing value)
+
+thePasteboard's clearContents()
+thePasteboard's setData_forType_(theData, current application's NSPasteboardTypeHTML)
+thePasteboard's setString_forType_(thePlain, current application's NSPasteboardTypeString)
+return "ok"`,
+      "utf8",
+    );
+
+    const r = spawnSync("osascript", [scriptFile], {
+      env: { ...process.env, WXFORMAT_CLIP_FILE: htmlFile, WXFORMAT_CLIP_PLAIN_FILE: plainFile },
+      encoding: "utf8",
+      timeout: 15000,
+    });
+    if (r.status === 0) return true;
+    return copyText(html);
+  } catch {
+    return copyText(html);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+}

package/lib/core.mjs

@@ -0,0 +1,70 @@
+/**
+ * core.mjs — wxformat 核心排版逻辑
+ *
+ * 渲染器优先复用工作区 dsh-wechat-preview 的 render.js（单一实现：CLI 与 GUI
+ * 预览输出同源，主题/剥离规则只维护一份）；npm 独立安装时该路径不存在，
+ * 自动回退到本包自带的 lib/render.js 副本（发布前由 scripts/sync-render.mjs
+ * 同步，prepublishOnly 钩子保证打包时副本永远最新）。
+ */
+let render;
+try {
+  render = await import("../../dsh-wechat-preview/lib/render.js");
+} catch {
+  render = await import("./render.js");
+}
+
+const { parseArticle, renderArticle, extractTags, THEMES, DEFAULT_THEME } = render;
+
+export { THEMES, DEFAULT_THEME };
+
+/** 校验主题 id：合法返回原 id，否则返回 null。 */
+export function resolveTheme(id) {
+  return id && THEMES[id] ? id : null;
+}
+
+/** 全量排版（不剥离元信息/发布包）：标题取首个 `# ` 行，正文为其余全部内容。 */
+function parseWhole(raw) {
+  const m = raw.match(/^#\s+(.+)$/m);
+  const title = m ? m[1].trim() : "";
+  const body = raw.replace(/^#\s+.+$/m, "").trim();
+  return { title, body };
+}
+
+/** 统计 CJK 正文字符数。 */
+export function countCjk(s) {
+  return (s.match(/[\u4e00-\u9fff]/g) || []).length;
+}
+
+/**
+ * 排版一篇草稿。
+ *
+ * @param {string} raw 原始 Markdown 文本
+ * @param {object} [opts]
+ * @param {string} [opts.theme] 主题 id（默认 bw；非法值回退默认）
+ * @param {boolean} [opts.stripMeta=true] 是否剥离元信息与发布包
+ * @param {boolean} [opts.tags=true] 是否解析文末话题标签（#标签# 效果）
+ * @returns {{title:string, body:string, md:string, section:string, document:string,
+ *            tags:string[], theme:string, themeLabel:string, chars:number}}
+ */
+export function formatArticle(raw, opts = {}) {
+  const theme = resolveTheme(opts.theme) ?? DEFAULT_THEME;
+  const strip = opts.stripMeta !== false;
+  const { title, body } = strip ? parseArticle(raw) : parseWhole(raw);
+  if (!title || !body) {
+    throw new Error("无法解析：未找到标题或正文（需要至少一个 `# 标题` 与正文内容）");
+  }
+  const tags = opts.tags === false ? [] : extractTags(raw);
+  const { section, document } = renderArticle(title, body, theme, { tags });
+  const md = `# ${title}\n\n${body}\n`;
+  return {
+    title,
+    body,
+    md,
+    section,
+    document,
+    tags,
+    theme,
+    themeLabel: THEMES[theme].label,
+    chars: countCjk(body),
+  };
+}

package/lib/editor.mjs

@@ -0,0 +1,125 @@
+/**
+ * editor.mjs — 浏览器排版面板页（--editor）
+ *
+ * 自包含单页：正文可直接在页面内微调，一键复制"发布 HTML"（粘贴公众号后台即可
+ * 发布）或"纯净 Markdown"（粘贴墨滴/135 等编辑器）。复制优先 navigator.clipboard，
+ * 失败回退 execCommand，file:// 下也可用。
+ */
+
+export function editorPage({ title, section, md, themeLabel }) {
+  const esc = (s) =>
+    String(s)
+      .replace(/&/g, "&")
+      .replace(/</g, "&lt;")
+      .replace(/>/g, "&gt;")
+      .replace(/"/g, "&quot;");
+  // 内嵌进 <script> 字符串：把 < 转成 \u003c，防止正文里的 </script> 截断脚本标签
+  const mdJson = JSON.stringify(md).replace(/</g, "\\u003c");
+
+  return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>排版面板 · ${esc(title)}</title>
+<style>
+  :root { --accent:#07c160; }
+  * { box-sizing: border-box; }
+  html, body { margin:0; padding:0; background:#f2f2f2; font-family:-apple-system,BlinkMacSystemFont,'PingFang SC','Microsoft YaHei',sans-serif; }
+  header { position:sticky; top:0; z-index:10; background:#fff; border-bottom:1px solid #e5e5e5; padding:12px 20px; display:flex; align-items:center; gap:10px; flex-wrap:wrap; }
+  header h1 { font-size:15px; font-weight:600; margin:0; margin-right:auto; color:#333; max-width:50%; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
+  header .badge { font-size:12px; color:#999; background:#f5f5f5; border-radius:10px; padding:2px 8px; }
+  button { border:none; border-radius:6px; padding:7px 14px; font-size:13px; cursor:pointer; background:#f0f0f0; color:#333; }
+  button:hover { background:#e3e3e3; }
+  button.primary { background:var(--accent); color:#fff; }
+  button.primary:hover { background:#06b056; }
+  button.primary.ok { background:#333; }
+  main { max-width:760px; margin:20px auto; background:#fff; border-radius:10px; box-shadow:0 1px 6px rgba(0,0,0,.08); padding:8px 0; }
+  #article { min-height:60vh; padding:18px 22px; outline:none; cursor:text; border-radius:6px; }
+  #article:focus { box-shadow:inset 0 0 0 1px rgba(7,193,96,.35); }
+  .hint { max-width:760px; margin:0 auto 40px; padding:0 12px; font-size:12.5px; color:#999; line-height:1.9; }
+  .hint b { color:#666; }
+  .toast { position:fixed; left:50%; bottom:40px; transform:translateX(-50%); background:rgba(0,0,0,.78); color:#fff; padding:9px 18px; border-radius:20px; font-size:13px; opacity:0; transition:opacity .25s; pointer-events:none; white-space:nowrap; }
+  .toast.show { opacity:1; }
+</style>
+</head>
+<body>
+<header>
+  <h1 title="${esc(title)}">${esc(title)}</h1>
+  <span class="badge">主题：${esc(themeLabel)}</span>
+  <button class="primary" id="copyHtml">复制发布 HTML</button>
+  <button id="copyMd">复制纯净 Markdown</button>
+  <button id="reset">恢复原始</button>
+</header>
+<main>
+  <section id="article" contenteditable="true">${section}</section>
+</main>
+<div class="hint">
+  ① 正文可直接在本面板内<b>微调</b>后再复制；② 点「复制发布 HTML」→ 到<b>公众号后台编辑器</b>直接粘贴（Cmd/Ctrl+V）即可发布（样式全部内联，后台能完整保留）；
+  ③ 标题在后台标题栏单独填写，不包含在正文里；④ 「复制纯净 Markdown」可粘贴到墨滴 / 135 等 Markdown 编辑器；⑤ 面板打开的是本地临时文件，可随时重新生成。
+</div>
+<div class="toast" id="toast"></div>
+<script>
+  const article = document.getElementById('article');
+  const original = article.innerHTML;
+  const mdText = ${mdJson};
+  function fallbackCopy(text) {
+    const ta = document.createElement('textarea');
+    ta.value = text; ta.style.position = 'fixed'; ta.style.opacity = '0';
+    document.body.appendChild(ta); ta.focus(); ta.select();
+    let ok = false;
+    try { ok = document.execCommand('copy'); } catch (e) {}
+    ta.remove(); return ok;
+  }
+  async function copyPlain(text) {
+    if (navigator.clipboard && navigator.clipboard.writeText) {
+      try { await navigator.clipboard.writeText(text); return true; } catch (e) {}
+    }
+    return fallbackCopy(text);
+  }
+  // 富文本复制：带 text/html 类型，公众号后台"粘贴即渲染"（纯 writeText 只会贴出源码）
+  async function copyRich(html, plain) {
+    if (navigator.clipboard && window.ClipboardItem) {
+      try {
+        await navigator.clipboard.write([new ClipboardItem({
+          'text/html': new Blob([html], { type: 'text/html' }),
+          'text/plain': new Blob([plain], { type: 'text/plain' }),
+        })]);
+        return true;
+      } catch (e) {}
+    }
+    // 回退：DOM 选区复制（浏览器会自动附带 text/html 与 text/plain）
+    const range = document.createRange();
+    range.selectNode(article);
+    const sel = window.getSelection();
+    sel.removeAllRanges();
+    sel.addRange(range);
+    let ok = false;
+    try { ok = document.execCommand('copy'); } catch (e) {}
+    sel.removeAllRanges();
+    return ok;
+  }
+  let toastTimer = null;
+  function toast(msg) {
+    const el = document.getElementById('toast');
+    el.textContent = msg; el.classList.add('show');
+    clearTimeout(toastTimer); toastTimer = setTimeout(() => el.classList.remove('show'), 1600);
+  }
+  document.getElementById('copyHtml').addEventListener('click', async () => {
+    const ok = await copyRich(article.outerHTML, article.innerText);
+    const btn = document.getElementById('copyHtml');
+    const old = btn.textContent;
+    btn.textContent = ok ? '✅ 已复制' : '复制失败';
+    btn.classList.add('ok');
+    setTimeout(() => { btn.textContent = old; btn.classList.remove('ok'); }, 1500);
+    toast(ok ? '发布 HTML 已复制，去公众号后台粘贴吧' : '复制失败，请手动 Cmd+A 全选后 Cmd+C');
+  });
+  document.getElementById('copyMd').addEventListener('click', async () => {
+    const ok = await copyPlain(mdText);
+    toast(ok ? '纯净 Markdown 已复制' : '复制失败，请手动复制');
+  });
+  document.getElementById('reset').addEventListener('click', () => { article.innerHTML = original; });
+</script>
+</body>
+</html>`;
+}

package/lib/help.mjs

@@ -0,0 +1,50 @@
+/** help.mjs — 版本号与帮助文本 */
+
+export const VERSION = "0.1.0";
+
+export const HELP = `wxformat ${VERSION} — 公众号文章排版 CLI
+
+把 Markdown 草稿一键转为"可直接发布"的版本：纯净 Markdown + 公众号 HTML
+（全内联样式，粘贴公众号后台即可发布）。可被脚本、CI 与大模型直接调用。
+
+用法:
+  wxformat <file|-> [选项]
+
+  文件模式:    wxformat drafts/文章.md
+  管道模式:    cat 文章.md | wxformat - -f md -o -
+  浏览器预览:  wxformat drafts/文章.md --preview
+  排版面板:    wxformat drafts/文章.md --editor
+  边写边预览:  wxformat drafts/文章.md --watch --preview
+  大模型/脚本: wxformat drafts/文章.md --json --no-clipboard
+
+位置参数:
+  <file|->            输入文件路径；或 - 表示从 stdin 读取
+
+选项:
+  -o, --output <路径|->   输出目标：
+                          .md / .html 文件 → 只写该格式
+                          目录（或结尾带 /）→ 写入默认文件名
+                          - → 输出到 stdout（与 -f md|html 配合，内容纯净无杂音）
+                          省略 → 写到输入文件旁（<名>.clean.md / <名>.html）
+  -f, --format <md|html|both>   输出格式（默认 both；stdin 且无 -o 时默认 html）
+  -t, --theme <id>      主题: bw 黑白极简 | paper 纸墨书香 | celadon 晨雾青瓷（默认 bw）
+  -p, --preview         生成预览页并自动打开浏览器
+  -e, --editor          打开浏览器排版面板：正文可微调，一键复制发布 HTML / 纯净 Markdown
+  -c, --clipboard       复制到剪贴板（macOS 文件模式下默认自动复制发布 HTML）
+      --clipboard=md|html  指定复制哪种内容
+      --no-clipboard       禁止复制（脚本/CI 友好）
+  -j, --json            机器可读 JSON 输出（含 md / section / 产物路径；自动跳过剪贴板）
+  -w, --watch           监听输入文件，变更自动重排版（配 --preview 浏览器实时刷新）
+  -q, --quiet           只输出产物路径（或 stdout 内容）
+      --config <文件>   配置文件（默认探测 .wxformatrc.json / wxformat.config.json / package.json#wxformat）
+      --no-meta-strip   不剥离元信息与发布包，整篇原文排版
+      --no-open         生成预览/面板文件但不自动打开浏览器（CI/脚本友好）
+  -V, --version         输出版本号
+  -h, --help            显示帮助
+
+退出码:
+  0 成功   1 参数/输入错误   2 转换失败
+
+配置示例（.wxformatrc.json）:
+  { "theme": "paper", "format": "both", "clipboard": "html" }
+`;

package/lib/live-server.mjs

@@ -0,0 +1,46 @@
+/**
+ * live-server.mjs — --watch --preview 用的极简本地服务（零依赖）
+ *
+ * 浏览器页面轮询 /version，版本号变化即自动刷新 → 边写草稿边实时预览。
+ * 只监听 127.0.0.1 随机端口，服务随进程退出自动关闭。
+ */
+import { createServer } from "node:http";
+
+export function startLiveServer() {
+  let doc = "<html><body></body></html>";
+  let version = 0;
+
+  const server = createServer((req, res) => {
+    const u = new URL(req.url, "http://127.0.0.1");
+    if (u.pathname === "/version") {
+      res.setHeader("content-type", "application/json");
+      res.end(JSON.stringify({ v: version }));
+      return;
+    }
+    res.setHeader("content-type", "text/html; charset=utf-8");
+    res.end(injectLive(doc, version));
+  });
+
+  return new Promise((resolve) => {
+    server.listen(0, "127.0.0.1", () => {
+      const { port } = server.address();
+      resolve({
+        url: `http://127.0.0.1:${port}/`,
+        setDocument(d) {
+          doc = d;
+          version += 1;
+        },
+        close() {
+          server.close();
+        },
+      });
+    });
+  });
+}
+
+function injectLive(doc, v) {
+  // 渲染器产出的文档不含 <script>，直接注入轮询脚本；已有脚本则跳过（防重复注入）
+  if (/<script[\s>]/i.test(doc)) return doc;
+  const script = `<script>(function(){let v=${v};setTimeout(function poll(){fetch('/version').then(r=>r.json()).then(j=>{if(typeof j.v==='number'&&j.v!==v){v=j.v;location.reload();return;}}).catch(()=>{}).finally(()=>setTimeout(poll,600));},600);})();</script>`;
+  return doc.replace(/<\/body>/i, `${script}</body>`);
+}

package/lib/render.js

@@ -0,0 +1,263 @@
+/**
+ * render.js — 公众号文章排版渲染器（多主题 · 全内联样式）
+ *
+ * 被 host 半（dsh-wechat-preview 的 /render RPC）、旧 bin/wechat_format.mjs 与 wxformat CLI 共用。
+ * 所有样式以内联 style 输出（公众号后台粘贴富文本时保留内联样式最稳）。
+ *
+ * 三套主题：
+ *   bw      黑白极简   — 理性 · 通用
+ *   paper   纸墨书香   — 情感 · 温情故事
+ *   celadon 晨雾青瓷   — 商业 · 深度拆解
+ */
+
+export const THEMES = {
+  bw: {
+    id: "bw",
+    label: "黑白极简",
+    hint: "理性 · 通用",
+    wrap: { background: "#ffffff", padding: "26px 22px", borderRadius: "0" },
+    h1: { fontSize: "23px", fontWeight: "800", color: "#111111", lineHeight: "1.5", letterSpacing: "1px", margin: "6px 0 26px", paddingBottom: "14px", borderBottom: "2px solid #111111" },
+    h2: { fontSize: "17.5px", fontWeight: "700", color: "#111111", lineHeight: "1.6", textAlign: "center", margin: "30px 0 16px", padding: "10px 14px", borderRadius: "6px", background: "linear-gradient(90deg,#e2e2e2,#ffffff)" },
+    h3: { fontSize: "17px", fontWeight: "700", color: "#222222", lineHeight: "1.5", margin: "24px 0 12px" },
+    p: { fontSize: "16px", lineHeight: "2", color: "#2b2b2b", letterSpacing: "0.3px", margin: "14px 0" },
+    strong: { color: "#000000", fontWeight: "700" },
+    em: {},
+    blockquote: { borderLeft: "3px solid #c9c9c9", padding: "2px 0 2px 14px", color: "#666666", margin: "16px 0", fontSize: "15.5px", lineHeight: "1.95" },
+    ul: { margin: "12px 0", paddingLeft: "22px" },
+    ol: { margin: "12px 0", paddingLeft: "22px" },
+    li: { margin: "6px 0", fontSize: "16px", lineHeight: "2", color: "#2b2b2b" },
+    code: { background: "#f2f2f2", color: "#c0392b", padding: "2px 5px", borderRadius: "3px", fontSize: "14px" },
+    hr: { border: "none", height: "4px", background: "radial-gradient(circle,#333333 1.2px,transparent 1.8px) repeat-x", backgroundSize: "8px 4px", margin: "28px 0" },
+    tag: { bg: "#f2f2f2", color: "#555555" },
+    a: { color: "#111111", textDecoration: "underline" },
+    img: { maxWidth: "100%", borderRadius: "6px", margin: "10px 0" }
+  },
+  paper: {
+    id: "paper",
+    label: "纸墨书香",
+    hint: "情感 · 温情故事",
+    wrap: { background: "#faf7f0", padding: "28px 24px", borderRadius: "10px" },
+    h1: { fontSize: "23px", fontWeight: "800", color: "#2f2a24", lineHeight: "1.5", letterSpacing: "2px", margin: "6px 0 26px", paddingBottom: "14px", borderBottom: "2px solid #d8cdb4", fontFamily: "'Songti SC','STSong','SimSun',serif" },
+    h2: { fontSize: "18px", fontWeight: "700", color: "#6b5736", lineHeight: "1.6", textAlign: "center", margin: "30px 0 16px", padding: "10px 14px", borderRadius: "6px", background: "linear-gradient(90deg,#e6d9bd,#faf7f0)" },
+    h3: { fontSize: "17px", fontWeight: "700", color: "#6b5736", lineHeight: "1.5", margin: "24px 0 12px" },
+    p: { fontSize: "16.5px", lineHeight: "2.05", color: "#4a4238", letterSpacing: "0.5px", margin: "15px 0" },
+    strong: { color: "#2f2a24", fontWeight: "700" },
+    em: {},
+    blockquote: { borderLeft: "3px solid #c9b896", padding: "2px 0 2px 14px", color: "#8a7a5c", margin: "16px 0", fontSize: "16px", lineHeight: "2", fontStyle: "italic" },
+    ul: { margin: "12px 0", paddingLeft: "22px" },
+    ol: { margin: "12px 0", paddingLeft: "22px" },
+    li: { margin: "6px 0", fontSize: "16.5px", lineHeight: "2.05", color: "#4a4238" },
+    code: { background: "#efe8d9", color: "#8a5a3b", padding: "2px 5px", borderRadius: "3px", fontSize: "14px" },
+    hr: { border: "none", height: "4px", background: "radial-gradient(circle,#333333 1.2px,transparent 1.8px) repeat-x", backgroundSize: "8px 4px", margin: "28px 0" },
+    tag: { bg: "#efe8d9", color: "#8a6d3b" },
+    a: { color: "#8a6d3b", textDecoration: "underline" },
+    img: { maxWidth: "100%", borderRadius: "6px", margin: "10px 0" }
+  },
+  celadon: {
+    id: "celadon",
+    label: "晨雾青瓷",
+    hint: "商业 · 深度拆解",
+    wrap: { background: "#f2f7f6", padding: "28px 24px", borderRadius: "10px" },
+    h1: { fontSize: "23px", fontWeight: "800", color: "#1f3d3a", lineHeight: "1.5", letterSpacing: "1px", margin: "6px 0 26px", paddingBottom: "14px", borderBottom: "2px solid #9cc4bd" },
+    h2: { fontSize: "18px", fontWeight: "700", color: "#1f3d3a", lineHeight: "1.6", textAlign: "center", margin: "30px 0 16px", padding: "10px 14px", borderRadius: "6px", background: "linear-gradient(90deg,#cfe5df,#f2f7f6)" },
+    h3: { fontSize: "17px", fontWeight: "700", color: "#2e6e63", lineHeight: "1.5", margin: "24px 0 12px" },
+    p: { fontSize: "16.5px", lineHeight: "2", color: "#33433f", letterSpacing: "0.3px", margin: "15px 0" },
+    strong: { color: "#1f3d3a", fontWeight: "700" },
+    em: {},
+    blockquote: { borderLeft: "3px solid #9cc4bd", padding: "2px 0 2px 14px", color: "#5d7a74", margin: "16px 0", fontSize: "16px", lineHeight: "1.95" },
+    ul: { margin: "12px 0", paddingLeft: "22px" },
+    ol: { margin: "12px 0", paddingLeft: "22px" },
+    li: { margin: "6px 0", fontSize: "16.5px", lineHeight: "2", color: "#33433f" },
+    code: { background: "#e3efec", color: "#1f5c52", padding: "2px 5px", borderRadius: "3px", fontSize: "14px" },
+    hr: { border: "none", height: "4px", background: "radial-gradient(circle,#333333 1.2px,transparent 1.8px) repeat-x", backgroundSize: "8px 4px", margin: "28px 0" },
+    tag: { bg: "#e3efec", color: "#2e6e63" },
+    a: { color: "#2e6e63", textDecoration: "underline" },
+    img: { maxWidth: "100%", borderRadius: "6px", margin: "10px 0" }
+  }
+};
+
+export const DEFAULT_THEME = "bw";
+
+/* ── Markdown 解析（轻量，覆盖本账号文章语法） ─────────────────────── */
+
+function esc(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+function inline(md, t) {
+  return md
+    .replace(/\*\*([^*]+)\*\*/g, `<strong style="${css(t.strong)}">$1</strong>`)
+    .replace(/\*([^*]+)\*/g, `<em style="${css(t.em)}">$1</em>`)
+    .replace(/`([^`]+)`/g, `<code style="${css(t.code)}">$1</code>`)
+    .replace(/!\[([^\]]*)\]\(([^)]+)\)/g, `<img src="${esc("$2")}" alt="${esc("$1")}" style="${css(t.img)}" />`)
+    .replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_, txt, href) => `<a href="${esc(href)}" style="${css(t.a)}">${esc(txt)}</a>`);
+}
+
+function css(rule) {
+  return Object.entries(rule ?? {})
+    .map(([k, v]) => `${k.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)}:${v}`)
+    .join(";");
+}
+
+function parseBlocks(bodyMd) {
+  const blocks = bodyMd.split(/\n{2,}/);
+  const out = [];
+  for (let block of blocks) {
+    const t = block.trim();
+    if (!t) continue;
+    if (/^#{1,6}\s+/.test(t)) {
+      const level = Math.min(t.match(/^(#+)/)[1].length, 3);
+      const text = t.replace(/^#+\s+/, "");
+      out.push({ type: `h${level}`, text });
+    } else if (/^-{3,}$/.test(t)) {
+      out.push({ type: "hr" });
+    } else if (t.startsWith("> ")) {
+      out.push({ type: "blockquote", text: t.replace(/^>\s?/gm, "") });
+    } else if (/^[-*]\s+/.test(t)) {
+      out.push({ type: "ul", items: t.split(/\n/).filter((l) => /^[-*]\s+/.test(l)).map((l) => l.replace(/^[-*]\s+/, "")) });
+    } else if (/^\d+\.\s+/.test(t)) {
+      out.push({ type: "ol", items: t.split(/\n/).filter((l) => /^\d+\.\s+/.test(l)).map((l) => l.replace(/^\d+\.\s+/, "")) });
+    } else if (/^【插图[：:】]/.test(t)) {
+      // 文内插图占位（草稿正文中的 `【插图：画面描述｜提示词】` 行）→ 渲染为可见占位块
+      out.push({ type: "imgph", text: t });
+    } else {
+      out.push({ type: "p", text: t.replace(/\n/g, "<br />") });
+    }
+  }
+  return out;
+}
+
+/* ── 渲染 ──────────────────────────────────────────────────────────── */
+
+/**
+ * 渲染完整文章。
+ * @param {string} title 文章标题
+ * @param {string} bodyMd 正文 Markdown（不含元信息/发布包）
+ * @param {string} themeId 主题 id
+ * @returns {{ section: string, document: string }}
+ *   section  — 内联样式正文（复制给公众号后台用）
+ *   document — 完整 HTML 文档（浏览器预览用）
+ */
+export function renderArticle(title, bodyMd, themeId = DEFAULT_THEME, opts = {}) {
+  const t = THEMES[themeId] ?? THEMES[DEFAULT_THEME];
+  const blocks = parseBlocks(bodyMd);
+
+  const h1 = `<h1 style="${css(t.h1)}">${inline(title, t)}</h1>`;
+  const parts = blocks.map((b) => {
+    switch (b.type) {
+      case "h2":
+      case "h3":
+        return `<${b.type} style="${css(t[b.type])}">${inline(b.text, t)}</${b.type}>`;
+      case "p":
+        return `<p style="${css(t.p)}">${inline(b.text, t)}</p>`;
+      case "imgph":
+        return renderImgPlaceholder(b.text);
+      case "blockquote":
+        return `<blockquote style="${css(t.blockquote)}">${inline(b.text, t)}</blockquote>`;
+      case "ul":
+        return `<ul style="${css(t.ul)}">${b.items.map((i) => `<li style="${css(t.li)}">${inline(i, t)}</li>`).join("")}</ul>`;
+      case "ol":
+        return `<ol style="${css(t.ol)}">${b.items.map((i) => `<li style="${css(t.li)}">${inline(i, t)}</li>`).join("")}</ol>`;
+      case "hr":
+        return `<hr style="${css(t.hr)}" />`;
+      default:
+        return "";
+    }
+  }).join("\n");
+
+  // 公众号后台有独立的标题栏：默认不渲染标题与标题分割线，只要正文。
+  const head = opts.withTitle ? `\n${h1}\n` : "\n";
+  // 文末 #标签# 打标签效果（胶囊样式，主题化配色）。
+  const tagsHtml = renderTags(opts.tags ?? [], t);
+
+  const section = `<section style="${css(t.wrap)}">${head}${parts}\n${tagsHtml}</section>`;
+
+  const document = `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>${esc(title)}</title>
+<style>
+  html, body { margin: 0; padding: 0; }
+  body { background: #e9e9e9; font-family: -apple-system, BlinkMacSystemFont, 'PingFang SC', 'Microsoft YaHei', sans-serif; padding: 24px 0 60px; }
+  body > section { max-width: 680px; margin: 0 auto; box-sizing: border-box; }
+  @media (max-width: 700px) { body { padding: 0; } body > section { max-width: 100%; } }
+</style>
+</head>
+<body>
+${section}
+</body>
+</html>`;
+
+  return { section, document };
+}
+
+/**
+ * 文末话题标签：纯 `#文字`（无闭合井号、无任何样式）。
+ * 微信公众后台会自行识别 `#话题` 并渲染成话题卡片，任何样式反而会残留为空壳，
+ * 所以这里只输出纯文本，每个标签独占一行（识别边界最清晰）。
+ */
+function renderTags(tags) {
+  if (!tags || tags.length === 0) return "";
+  const text = tags.map((tag) => `#${esc(tag)}`).join("<br />");
+  return `<p style="margin:26px 0 0;">${text}</p>`;
+}
+
+/**
+ * 文内插图占位块：把正文中的 `【插图：画面描述｜文生图提示词】` 渲染成醒目的虚线占位，
+ * 发布前作者直接选中整块删除、替换为真实图片（公众号后台编辑器可正常粘贴/删除该块）。
+ * 占位块内容同时给出画面描述与提示词，生成图片时无需再翻发布包。
+ */
+function renderImgPlaceholder(text) {
+  const rest = text.replace(/^【插图[：:】]\s*/, "").trim();
+  const [desc, ...promptParts] = rest.split(/｜|\|/).map((s) => s.trim()).filter(Boolean);
+  const descHtml = esc(desc || "此处插入图片");
+  const promptHtml = promptParts.length
+    ? `<span style="display:block;margin-top:6px;font-size:13px;color:#a3a3a3;">提示词：${esc(promptParts.join("｜"))}</span>`
+    : "";
+  return `<p style="margin:18px 0;padding:14px 16px;border:1px dashed #c9c9c9;background:#f8f8f8;color:#8c8c8c;font-size:14px;line-height:1.7;letter-spacing:0.3px;text-align:center;">📷 插图位：${descHtml}${promptHtml}</p>`;
+}
+
+/** 从草稿原始文本提取发布包中的标签（发布包标签行，兼容两种格式：`- **标签**：a ｜ b ｜ c` 与 `- 标签（3–5 个，用 ｜ 分隔）：a ｜ b ｜ c`）。 */
+export function extractTags(rawMd) {
+  const m = rawMd.match(/^\s*[-*]\s*\*{0,2}标签\*{0,2}(?:（[^）]*）)?[:：]\s*(.+)$/m);
+  if (!m) return [];
+  return m[1]
+    .split(/[｜|,，、\s]+/)
+    .map((s) => s.trim())
+    .filter((s) => s.length > 0 && s.length <= 12)
+    .slice(0, 6);
+}
+
+/** 从草稿原始文本提取标题与纯净正文（与 wxformat CLI 相同的剥离规则）。 */
+export function parseArticle(rawMd) {
+  const m = rawMd.match(/^#\s+(.+)$/m);
+  const title = m ? m[1].trim() : "";
+  const lines = rawMd.split(/\r?\n/);
+  let start = 0;
+  let seenTitle = false;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (!seenTitle && line.startsWith("# ")) {
+      seenTitle = true;
+      start = i + 1;
+      continue;
+    }
+    if (!line || line.startsWith(">") || /^-{3,}$/.test(line)) {
+      if (line) start = i + 1;
+      continue;
+    }
+    start = i;
+    break;
+  }
+  let end = lines.length;
+  for (let i = start; i < lines.length; i++) {
+    if (/^#+\s*发布包/.test(lines[i].trim())) {
+      end = i;
+      break;
+    }
+  }
+  const body = lines.slice(start, end).join("\n").trim();
+  return { title, body };
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@peteryuan/wxformat",
+  "version": "0.1.0",
+  "description": "公众号文章排版 CLI：草稿一键转纯净 Markdown + 公众号 HTML（全内联样式），支持浏览器预览、排版面板一键复制、剪贴板自动复制、JSON 输出，可被脚本、CI 与大模型直接调用。",
+  "type": "module",
+  "main": "lib/core.mjs",
+  "exports": {
+    ".": "./lib/core.mjs"
+  },
+  "bin": {
+    "wxformat": "bin/wxformat.mjs"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "scripts",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test",
+    "sync-render": "node scripts/sync-render.mjs",
+    "prepublishOnly": "node scripts/sync-render.mjs && npm test"
+  },
+  "keywords": [
+    "wechat",
+    "公众号",
+    "markdown",
+    "cli",
+    "publish",
+    "formatter"
+  ],
+  "license": "MIT",
+  "author": "pengfei"
+}

package/scripts/sync-render.mjs

@@ -0,0 +1,23 @@
+/**
+ * sync-render.mjs — 把工作区 dsh-wechat-preview/lib/render.js 同步为本包副本
+ *
+ * npm 发布版自带 lib/render.js，依赖本脚本保证与工作区单一实现一致。
+ * 已由 package.json 的 prepublishOnly 钩子在每次 publish/pack 前自动执行。
+ * 用法: node scripts/sync-render.mjs
+ */
+import { copyFileSync, mkdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const src = path.join(here, "..", "..", "dsh-wechat-preview", "lib", "render.js");
+const dst = path.join(here, "..", "lib", "render.js");
+
+try {
+  copyFileSync(src, dst);
+  console.log(`✅ 已同步渲染器 → ${dst}`);
+} catch (e) {
+  // 在非工作区（如已安装的 npm 包内）运行时报错是预期行为，可忽略
+  console.warn(`[wxformat] 同步渲染器失败（非工作区环境？）: ${e.message}`);
+  process.exit(1);
+}