md2any 1.0.0

package/README.md

@@ -0,0 +1,136 @@
+# md2any CLI
+
+> **一篇 Markdown，发到微信 / 知乎 / 小红书 / Twitter。**
+> [Markdown2Anything](https://github.com/marsggbo/markdown2anything) 的命令行版 —— 也可以作为 **Agent Skill** 使用。
+
+VS Code 插件把这套能力做成了"编辑器里的一个按钮"。CLI 把它变成**任何脚本、任何 Agent 都能调用的一种能力**。
+
+核心逻辑（Markdown 渲染、长图切片、LLM 文案、Playwright 发布）**完全复用主仓库的 `lib/` 和 `scripts/`**，没有重写。
+
+---
+
+## 安装
+
+```bash
+git clone https://github.com/marsggbo/markdown2anything.git
+cd markdown2anything && npm install       # 主仓库依赖（CLI 直接复用）
+npm link ./cli                            # 让 md2any 进 PATH
+```
+
+首次使用发布/截图功能前，下载一次浏览器：
+
+```bash
+md2any install-browser                    # Chromium，约 150MB，只需一次
+```
+
+---
+
+## 快速开始
+
+```bash
+# 1) 登录（弹出真实浏览器，扫码/输密码，Cookie 存本地）
+md2any login xhs
+md2any login twitter
+md2any login zhihu
+md2any status                             # 看登录态 + Cookie 剩余有效期
+
+# 2) 把文章渲染成长图（小红书和 Twitter 的配图都来自这里）
+md2any images ./post.md
+
+# 3) 生成平台文案
+md2any gen ./post.md --to xhs             # 用 LLM
+md2any gen ./post.md --to twitter --local # 用本地关键词提取，不需要 API Key
+
+# 4) 发布（可一次发多个平台）
+md2any publish ./post.md --to xhs,twitter
+```
+
+> 默认**停在「发布」按钮前**，浏览器保持打开，由你核对后自己点。
+> 加 `--auto` 才连最后一下也自动点（不推荐：小红书有二次确认弹窗，容易发失败）。
+
+---
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `md2any login <平台>` | 浏览器登录并保存 Cookie（`xhs` / `twitter` / `zhihu`） |
+| `md2any status` | 各平台登录态与 Cookie 剩余有效期 |
+| `md2any logout <平台>` | 清除某平台 Cookie |
+| `md2any images <file.md>` | 渲染成小红书长图（智能分片，尽量在空白行处切） |
+| `md2any gen <file.md> --to <平台>` | 生成文案（`--local` 用本地算法，不调 LLM） |
+| `md2any publish <file.md> --to <平台..>` | 发布，可逗号分隔多个平台 |
+| `md2any copy <file.md> --to <目标>` | 输出可粘贴的 HTML 到 stdout（`wechat` / `zhihu` / `xhs`） |
+| `md2any config llm --base-url … --model …` | 配置 LLM |
+| `md2any install-browser` | 下载 Chromium |
+
+常用参数：`--to` `--local` `--auto` `--headless` `--json`
+
+```bash
+md2any copy ./post.md --to wechat | pbcopy      # 直接进剪贴板，粘到公众号
+```
+
+---
+
+## LLM 配置
+
+```bash
+md2any config llm --base-url https://api.deepseek.com/v1 --model deepseek-chat --api-key sk-xxx
+md2any config show
+```
+
+也可用环境变量：`MD2ANY_LLM_BASE_URL` / `MD2ANY_LLM_MODEL` / `MD2ANY_LLM_API_KEY`
+
+**不配也能用** —— `md2any gen --local` 走内置的本地关键词提取（中英混合 n-gram + 停用词过滤 + 长词吸收短词），零配置零成本。
+
+---
+
+## 给 Agent 用
+
+CLI 的输出约定是**为脚本和 Agent 设计的**：
+
+- **stdout 只输出结果，stderr 输出进度日志** → 可以安全地 pipe 和解析
+- **`--json` 给结构化输出**
+- 退出码：`0` 成功，`1` 失败
+
+```bash
+md2any gen ./post.md --to twitter --json 2>/dev/null | jq '.twitter.tweets'
+```
+
+仓库里的 [`SKILL.md`](./SKILL.md) 就是给 Agent 读的 skill 定义（Claude Code / OpenClaw 等可直接挂载）：把 `cli/` 目录作为 skill 装进去，Agent 就能听懂"把这篇文章发到小红书和推特"。
+
+---
+
+## ⚠️ 已知限制
+
+**知乎的图片必须人工粘贴。**
+
+知乎编辑器**不会**自动抓取粘贴进来的图片（base64 和远程 URL 都不行），只有剪贴板里是**真正的图片位图**时它才会上传到自己的图床。
+
+所以 `md2any publish --to zhihu` 只会自动填好**标题、正文、代码块（带语言高亮）、公式**，图片位置留空。
+补图的办法：用 VS Code 插件预览区图片上的「📋 复制图片」按钮逐张粘贴。
+
+---
+
+## 🔐 安全
+
+- Cookie 和 API Key 只存本地：`~/.config/md2any/`，权限 **0600**
+- **唯一的网络去向是平台自己 + 你自己配的 LLM 端点**，不经过任何第三方服务
+- 发布走 **Playwright 真实浏览器 + Cookie 注入**（模拟真人正常操作），而不是伪造签名的裸 HTTP 请求
+- 默认不替你点最后那下「发布」
+
+---
+
+## 文件产物
+
+```
+your-post/
+  post.md
+  post_xhs/            ← 长图
+    xhs_01.png …
+  post_social.json     ← 文案 + 版本历史（每次生成存一版，旧版保留）
+```
+
+`_social.json` **和 VS Code 插件完全互通** —— 插件里生成的文案，CLI 能读；CLI 生成的，插件里也能用 `◀ ▶` 切换查看。
+
+MIT © [marsggbo](https://github.com/marsggbo)

package/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: md2any
+description: 把一篇 Markdown 文章发布到微信公众号 / 知乎 / 小红书 / Twitter(X)。能自动把文章渲染成长图、用 LLM 生成各平台的文案与串推、注入 Cookie 用真实浏览器自动填内容并传图。当用户说"把这篇文章发到小红书/推特/知乎"、"帮我导出长图"、"生成小红书文案"时使用。
+---
+
+# md2any — 一篇 Markdown 发到所有平台
+
+## 这个 Skill 能做什么
+
+| 平台 | 自动化程度 |
+|------|-----------|
+| 小红书 | **全自动**：截长图 → 写文案 → 传图 → 填标题/正文/标签（停在发布前） |
+| Twitter(X) | **全自动**：生成中文串推、按图切块配图、自动填好（停在发帖前） |
+| 知乎 | **半自动**：自动填标题/正文/代码块/公式；**图片需人工粘贴**（见「已知限制」） |
+| 微信公众号 | 输出可直接粘贴的内联样式 HTML |
+
+## 前置条件
+
+**首次使用必须先做两件事**，缺一不可：
+
+```bash
+md2any install-browser          # 下载 Chromium（约 150MB，只需一次）
+md2any login xhs                # 浏览器扫码登录，Cookie 存本地
+md2any login twitter
+md2any login zhihu
+```
+
+登录会**弹出真实浏览器窗口让用户自己登录**——这一步无法自动化，必须让用户操作。
+用 `md2any status` 检查登录态和 Cookie 剩余有效期。
+
+## 典型流程
+
+```bash
+# 1) 把文章渲染成长图（小红书/Twitter 的配图都来自这里）
+md2any images ./post.md
+
+# 2) 生成平台文案（LLM）；加 --local 则用本地关键词提取，不需要 API Key
+md2any gen ./post.md --to xhs
+md2any gen ./post.md --to twitter
+
+# 3) 发布（可一次发多个平台）
+md2any publish ./post.md --to xhs,twitter
+```
+
+**默认停在「发布」按钮前**，浏览器保持打开，由用户核对后自己点发布。
+加 `--auto` 才会连最后一下也自动点（**不推荐**：小红书有二次确认弹窗，容易发失败）。
+
+## 给 Agent 的重要约定
+
+- **stdout 只输出结果，stderr 输出进度日志** → 可以安全地 pipe 和解析
+- **加 `--json` 得到结构化输出**，优先用这个
+- 退出码：`0` 成功，`1` 失败
+- 生成的文案会存到文章同目录的 `<文章名>_social.json`，**每次生成存一个新版本，旧版保留**，重复调用不会丢历史
+
+## LLM 配置
+
+```bash
+md2any config llm --base-url https://api.deepseek.com/v1 --model deepseek-chat --api-key sk-xxx
+md2any config show
+```
+
+也可用环境变量：`MD2ANY_LLM_BASE_URL` / `MD2ANY_LLM_MODEL` / `MD2ANY_LLM_API_KEY`。
+
+**不配也能用**：`md2any gen --local` 走内置的本地关键词提取（中英混合 n-gram + 停用词 + 长词吸收），零成本零配置。
+
+## ⚠️ 已知限制（务必如实告诉用户，别假装能做到）
+
+**知乎的图片必须人工粘贴。** 知乎编辑器**不会**自动抓取粘贴进来的图片（base64 和远程 URL 都不行），只有剪贴板里是**真正的图片位图**时它才会上传到自己的图床。
+
+所以 `md2any publish --to zhihu` 只会自动填好**标题、正文、代码块（带语言高亮）、公式**，图片位置会留空。
+请告诉用户：用 VS Code 插件预览区图片上的「📋 复制图片」按钮逐张粘贴，或在知乎编辑器里手动上传。
+
+**不要向用户承诺知乎图片能自动上传。**
+
+## 安全
+
+- Cookie 和 API Key 只存本地（`~/.config/md2any/`，权限 0600）
+- 唯一的网络去向是**平台自己**和**用户自己配的 LLM 端点**，不经过任何第三方
+- 发布走真实浏览器 + Cookie 注入（模拟真人操作），而非伪造签名的 HTTP 请求
+- **发布是对外可见的操作**：除非用户明确要求，否则不要加 `--auto`，把最后一步留给用户

package/bin/md2any.js

@@ -0,0 +1,227 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * md2any — 把一篇 Markdown 发到微信 / 知乎 / 小红书 / Twitter 的命令行工具。
+ *
+ * 设计上对 Agent 友好：
+ *   - 所有「结果」走 stdout，所有「进度/日志」走 stderr  → 可以安全地 pipe / 解析
+ *   - 加 --json 输出结构化结果
+ *   - 退出码：0 成功，1 失败
+ */
+
+const fs   = require('fs');
+const path = require('path');
+const A     = require('../lib/actions');
+const store = require('../lib/store');
+
+const log  = (...a) => console.error(...a);        // 进度 → stderr
+const emit = (s) => process.stdout.write(s + '\n'); // 结果 → stdout
+
+// ─── 极简参数解析 ────────────────────────────────────────────
+function parse(argv) {
+  const pos = [];
+  const flags = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith('--')) {
+      const k = a.slice(2);
+      if (k.includes('=')) { const [kk, vv] = k.split(/=(.*)/); flags[kk] = vv; }
+      else if (argv[i + 1] && !argv[i + 1].startsWith('-')) flags[k] = argv[++i];
+      else flags[k] = true;
+    } else pos.push(a);
+  }
+  return { pos, flags };
+}
+
+const HELP = `
+md2any — 一篇 Markdown，发到微信 / 知乎 / 小红书 / Twitter
+
+用法：
+  md2any <命令> [参数]
+
+命令：
+  login <平台>                    浏览器登录并保存 Cookie（平台：xhs | twitter | zhihu）
+  status                          查看各平台登录态与有效期
+  logout <平台>                   清除某平台的 Cookie
+
+  images <file.md>                把文章渲染成小红书长图（自动智能分片）
+  gen <file.md> --to <平台>       生成文案（默认 LLM；--local 用本地算法，不需要 API Key）
+  publish <file.md> --to <平台..> 发布（可逗号分隔多个平台）
+  copy <file.md> --to <目标>      输出可粘贴的 HTML 到 stdout（目标：wechat | zhihu | xhs）
+
+  config llm --base-url <url> --model <名> [--api-key <key>]
+  config show
+  install-browser                 下载 Chromium（首次使用发布/截图前需要）
+
+常用参数：
+  --to <平台>      xhs | twitter | zhihu（可逗号分隔）
+  --local          文案用本地关键词提取，不调用 LLM
+  --auto           连最后的「发布」按钮也自动点（默认停在发布前，由你确认）
+  --headless       隐藏浏览器窗口
+  --json           以 JSON 输出结果（给 Agent 用）
+
+示例：
+  md2any login xhs
+  md2any images ./post.md
+  md2any gen ./post.md --to twitter
+  md2any publish ./post.md --to xhs,twitter
+  md2any copy ./post.md --to wechat | pbcopy
+
+环境变量（也可用 config 命令写入 ~/.config/md2any/）：
+  MD2ANY_LLM_BASE_URL   OpenAI 兼容接口地址，如 https://api.deepseek.com/v1
+  MD2ANY_LLM_MODEL      模型名，如 deepseek-chat
+  MD2ANY_LLM_API_KEY    API Key（本地端点如 Ollama 可不填）
+`.trim();
+
+// ─── 命令 ────────────────────────────────────────────────────
+async function main() {
+  const { pos, flags } = parse(process.argv.slice(2));
+  const cmd = pos[0];
+  const json = !!flags.json;
+
+  if (!cmd || cmd === 'help' || flags.help) { emit(HELP); return; }
+
+  const needMd = (i = 1) => {
+    const f = pos[i];
+    if (!f) throw new Error('缺少 markdown 文件路径');
+    const abs = path.resolve(f);
+    if (!fs.existsSync(abs)) throw new Error(`文件不存在：${abs}`);
+    return abs;
+  };
+  const targets = () => String(flags.to || '').split(',').map(s => A.normPlatform(s.trim())).filter(Boolean);
+
+  switch (cmd) {
+
+    case 'login': {
+      const p = A.normPlatform(pos[1]);
+      if (!A.PLATFORMS.includes(p)) throw new Error(`未知平台：${pos[1]}（可选 ${A.PLATFORMS.join(' / ')}）`);
+      log(`正在打开浏览器登录 ${p} …`);
+      await A.login(p, { log });
+      const st = A.status().find(s => s.platform === p);
+      log('✅ 登录成功');
+      emit(json ? JSON.stringify(st) : `已登录 ${st.name}` + (st.daysLeft != null ? `（剩 ${st.daysLeft} 天）` : ''));
+      return;
+    }
+
+    case 'status': {
+      const st = A.status();
+      if (json) { emit(JSON.stringify(st, null, 2)); return; }
+      for (const s of st) {
+        const tag = s.loggedIn
+          ? (s.daysLeft != null ? `已登录 · 剩 ${s.daysLeft} 天` : '已登录')
+          : (s.state === 'expired' ? '已过期' : '未登录');
+        emit(`${s.loggedIn ? '✅' : '❌'} ${s.name.padEnd(8)} ${tag}`);
+      }
+      return;
+    }
+
+    case 'logout': {
+      const p = A.normPlatform(pos[1]);
+      const social = require(path.join(A.ROOT, 'lib', 'social'));
+      social.clearCookies(p, store.cookieStorage());
+      emit(`已清除 ${p} 的 Cookie`);
+      return;
+    }
+
+    case 'images': {
+      const md = needMd();
+      log('正在渲染长图…');
+      const imgs = await A.exportImages(md, { theme: flags.theme || 'zhihu', log });
+      log(`✅ 已导出 ${imgs.length} 张`);
+      emit(json ? JSON.stringify({ count: imgs.length, images: imgs }, null, 2) : imgs.join('\n'));
+      return;
+    }
+
+    case 'gen': {
+      const md = needMd();
+      const ps = targets();
+      if (!ps.length) throw new Error('请用 --to 指定平台，如 --to twitter');
+      const out = {};
+      for (const p of ps) {
+        if (p === 'zhihu') { log('知乎无需生成文案（直接用文章正文），跳过'); continue; }
+        let copy;
+        if (flags.local) {
+          copy = A.localCopy(md, p);
+          log(`✅ [${p}] 本地算法提取完成（未调用模型）`);
+        } else {
+          if (!A.listImages(md).length && p === 'twitter') {
+            log('  Twitter 的串推条数要按长图张数算，正在自动导出长图…');
+            await A.exportImages(md, { log });
+          }
+          log(`正在用 LLM 生成 ${p} 文案…`);
+          copy = await A.llmCopy(md, p, { instruction: flags.prompt });
+          log(`✅ [${p}] 生成完成`);
+        }
+        A.addVersion(md, p, copy, flags.local ? 'local' : 'llm', A.readMeta(md).link);
+        out[p] = copy;
+      }
+      emit(json ? JSON.stringify(out, null, 2) : JSON.stringify(out, null, 2));
+      log(`已保存到 ${path.basename(A.socialFile(md))}（旧版本保留，可回切）`);
+      return;
+    }
+
+    case 'publish': {
+      const md = needMd();
+      const ps = targets();
+      if (!ps.length) throw new Error('请用 --to 指定平台，如 --to xhs,twitter');
+      const results = {};
+      for (const p of ps) {
+        log(`\n▶ 发布到 ${p} …`);
+        const r = await A.publish(md, p, {
+          mode: flags.auto ? 'auto' : 'prepare',
+          headless: !!flags.headless,
+          log,
+        });
+        results[p] = r.status;
+        log(r.status === 'ready'
+          ? `✅ [${p}] 内容已填好，浏览器保持打开 —— 请核对后自己点「发布」`
+          : `✅ [${p}] 已提交发布`);
+      }
+      emit(json ? JSON.stringify(results, null, 2) : Object.entries(results).map(([k, v]) => `${k}: ${v}`).join('\n'));
+      return;
+    }
+
+    case 'copy': {
+      const md = needMd();
+      const t = String(flags.to || 'wechat');
+      emit(A.toHtml(md, A.normPlatform(t) === 'xiaohongshu' ? 'xhs' : t, flags.theme || 'wechat'));
+      return;
+    }
+
+    case 'config': {
+      const sub = pos[1];
+      if (sub === 'show') {
+        const c = store.getLlmConfig();
+        emit(JSON.stringify({ baseUrl: c.baseUrl, model: c.model, apiKey: c.apiKey ? '***已配置***' : '' }, null, 2));
+        emit(`配置文件：${store.CONFIG_FILE}`);
+        return;
+      }
+      if (sub === 'llm') {
+        const patch = {};
+        if (flags['base-url']) patch.baseUrl = flags['base-url'];
+        if (flags.model)       patch.model   = flags.model;
+        if (flags['api-key'])  patch.apiKey  = flags['api-key'];
+        if (!Object.keys(patch).length) throw new Error('请提供 --base-url / --model / --api-key');
+        store.setLlmConfig(patch);
+        emit(`✅ 已保存到 ${store.CONFIG_FILE}（权限 0600）`);
+        return;
+      }
+      throw new Error('用法：md2any config show | md2any config llm --base-url ... --model ...');
+    }
+
+    case 'install-browser': {
+      await A.installBrowser({ log });
+      emit('✅ Chromium 已就绪');
+      return;
+    }
+
+    default:
+      throw new Error(`未知命令：${cmd}\n\n${HELP}`);
+  }
+}
+
+main().catch(err => {
+  console.error('❌ ' + (err && err.message ? err.message : err));
+  process.exit(1);
+});