multi-publisher 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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,370 @@
+# multi-publisher
+
+**一行命令，Markdown 发布到全网。**
+
+将排版好的 Markdown 文章一键发布到微信公众号、知乎、掘金、CSDN 等 20+ 平台，无需手动复制粘贴。支持浏览器自动登录获取 Cookie，12 套渲染主题，是内容创作者的效率神器。
+
+---
+
+## 功能特性
+
+| 特性 | 说明 |
+|------|------|
+| **多平台支持** | 微信公众号、知乎、掘金、CSDN、微博、小红书、B站等 20+ 平台 |
+| **浏览器自动登录** | Playwright 驱动扫码/账号登录，Cookie 自动获取保存 |
+| **14 套渲染主题** | default、wechat、modern、minimal、cyberpunk、nord、paper、darkelite、sunset、zen、retro、midnight、brutalism、neumorphism |
+| **Markdown 直发** | front-matter 元数据、代码高亮、LaTeX 公式 |
+| **CI/CD 友好** | 纯命令行无需浏览器，配置文件统一管理 |
+| **草稿箱发布** | 微信公众号 → 草稿箱，其他平台 → 各自草稿箱 |
+
+---
+
+## 安装
+
+```bash
+# 源码安装
+git clone <repo-url>
+cd multi-publisher
+npm install
+npm run build
+
+# 链接为全局命令
+npm link
+mpub --help
+```
+
+**Node.js ≥ 18** required.
+
+---
+
+## 快速开始
+
+### 1. 配置平台登录
+
+**方式一：浏览器自动登录（推荐）**
+
+```bash
+# 登录知乎
+mpub login -p zhihu
+
+# 登录掘金
+mpub login -p juejin
+
+# 登录小红书
+mpub login -p xiaohongshu
+
+# 查看所有支持平台
+mpub login --help
+```
+
+**方式二：手动 Cookie 配置**
+
+```bash
+# 交互式输入 Cookie
+mpub cookie --platform zhihu --set
+
+# 检查 Cookie 状态
+mpub cookie --platform zhihu --check
+```
+
+### 2. 发布文章
+
+```bash
+# 发布到微信公众号（默认）
+mpub publish -f article.md
+
+# 发布到知乎草稿
+mpub publish -f article.md -p zhihu
+
+# 一键发布到所有已登录平台
+mpub publish-all -f article.md
+
+# 渲染预览（不发布）
+mpub render -f article.md
+
+# 指定主题渲染
+mpub render -f article.md -t cyberpunk
+```
+
+---
+
+## 支持的平台
+
+### 浏览器自动登录状态
+
+| 平台 | 登录命令 | Cookie 获取 | 草稿发布 | 备注 |
+|------|----------|-------------|----------|------|
+| 微信公众号 | `mpub credential --set` | ✅ | ✅ | AppID + AppSecret |
+| 知乎 | `mpub login -p zhihu` | ✅ | ✅ | 直接发布草稿 |
+| 掘金 | `mpub login -p juejin` | ✅ | ✅ | 直接发布草稿 |
+| CSDN | `mpub login -p csdn` | ✅ | ✅ | 直接发布草稿 |
+| 小红书 | `mpub login -p xiaohongshu` | ✅ | 🔄 测试中 | 需要更多测试 |
+| 简书 | `mpub login -p jianshu` | ✅ | ❌ 待实现 | |
+| 微博 | `mpub login -p weibo` | ✅ | ❌ 待实现 | |
+| 头条号 | `mpub login -p toutiao` | ✅ | 🔄 测试中 | 有反爬机制 |
+| 百家号 | `mpub login -p baijiahao` | ✅ | ❌ 待实现 | |
+| B站 | `mpub login -p bilibili` | ✅ | 🔄 测试中 | 需要更多测试 |
+| 思否 | `mpub login -p segmentfault` | ✅ | ❌ 待实现 | |
+| 博客园 | `mpub login -p cnblogs` | ✅ | ❌ 待实现 | |
+| 开源中国 | `mpub login -p oschina` | ✅ | ❌ 待实现 | |
+| 慕课网 | `mpub login -p imooc` | ✅ | ❌ 待实现 | |
+| 雪球 | `mpub login -p xueqiu` | ✅ | ❌ 待实现 | |
+| 人人都是产品经理 | `mpub login -p woshipm` | ✅ | ❌ 待实现 | |
+| 豆瓣 | `mpub login -p douban` | ✅ | ❌ 待实现 | |
+| 搜狐号 | `mpub login -p sohu` | ✅ | ❌ 待实现 | |
+| 东方财富 | `mpub login -p eastmoney` | ✅ | ❌ 待实现 | |
+| 51CTO | `mpub login -p cto51` | ✅ | ❌ 待实现 | |
+
+- ✅ 已验证可用
+- 🔄 测试中，可能存在问题
+- ❌ 待实现，适配器框架已搭建但未测试发布功能
+
+### 已验证平台
+
+**登录 + 草稿发布**：知乎、掘金、CSDN、微信公众号
+
+**仅登录验证**：小红书、微博、B站、头条号等（Cookie 获取成功，草稿发布待测试）
+
+```bash
+# 查看所有支持平台
+mpub platforms
+```
+
+---
+
+## 主题系统
+
+### 🎨 14 套内置主题
+
+完整预览：[themes/all-themes-preview.html](themes/all-themes-preview.html)
+
+**主题截图示例：**
+
+| 风格 | 代表主题 | 预览 |
+|------|----------|------|
+| 技术博客 | Cyberpunk | ![Cyberpunk](themes/previews/cyberpunk.png) |
+| 程序员 | Nord | ![Nord](themes/previews/nord.png) |
+| 微信风格 | Wechat | ![Wechat](themes/previews/wechat.png) |
+| 简约 | Minimal | ![Minimal](themes/previews/minimal.png) |
+
+**命令行预览：**
+```bash
+mpub render -f article.md -t cyberpunk
+mpub render -f article.md -t nord
+mpub render -f article.md -t paper
+```
+
+**全部 14 主题：** default、wechat、modern、minimal、cyberpunk、nord、paper、darkelite、sunset、zen、retro、midnight、brutalism、neumorphism
+
+### 使用主题
+
+```bash
+# 渲染时指定主题
+mpub render -f article.md -t cyberpunk
+mpub render -f article.md -t nord
+mpub render -f article.md -t paper
+
+# 发布时指定主题
+mpub publish -f article.md -t modern -p zhihu
+```
+
+### 自定义主题
+
+```bash
+# 使用自定义 CSS 文件
+mpub render -f article.md --custom-theme ./my-theme.css
+```
+
+```css
+/* my-theme.css 示例 */
+body { font-family: 'PingFang SC', sans-serif; }
+h1 { color: #1a1a1a; font-size: 1.5em; }
+pre { background: #f6f8fa; border-radius: 6px; }
+```
+
+---
+
+## 文章格式
+
+### front-matter 元数据
+
+```markdown
+---
+title: 文章标题
+author: 作者名
+cover: https://example.com/cover.jpg    # 封面图片 URL
+summary: 文章摘要（可选）                 # 微信作者留言摘要
+source_url: https://original.url        # 原文链接（可选）
+tags: [技术, 前端, JavaScript]           # 标签（可选）
+---
+
+正文内容...
+```
+
+---
+
+## 配置文件
+
+所有配置存储在统一文件中，**无分散文件**：
+
+```json
+// ~/.config/multi-publisher/config.json (Linux/macOS)
+// %APPDATA%/multi-publisher/config.json (Windows)
+{
+  "version": 1,
+  "weixin": {
+    "appId": "wx...",
+    "appSecret": "..."
+  },
+  "zhihu": {
+    "cookies": { "z_c0": "..." }
+  },
+  "juejin": {
+    "cookies": { "uid_tt": "..." }
+  }
+}
+```
+
+```bash
+# 查看配置文件路径
+mpub credential --location
+```
+
+---
+
+## 项目结构
+
+```
+src/
+├── index.ts                    # CLI 入口，命令注册
+├── config.ts                   # 统一配置管理（ConfigStore）
+│
+├── cli/                        # 命令行接口
+│   ├── index.ts                # Commander.js 入口
+│   ├── publish.ts              # publish 命令
+│   ├── render.ts               # render 命令（预览）
+│   ├── platforms.ts            # platforms 命令
+│   ├── credential.ts           # credential 命令（微信凭据）
+│   ├── cookie.ts               # cookie 命令（Cookie 管理）
+│   ├── login.ts                # login 命令（浏览器自动登录）
+│   └── publish-all.ts          # publish-all 命令
+│
+├── core/                       # 核心渲染引擎
+│   ├── parser.ts               # Markdown + front-matter 解析
+│   ├── renderer.ts             # 渲染管道（Markdown → HTML）
+│   ├── styler.ts               # CSS 内联（juice）
+│   ├── mathjax.ts              # LaTeX → SVG/PNG 公式
+│   └── theme.ts                # 主题加载与切换
+│
+├── adapters/                   # 平台适配器
+│   ├── interface.ts            # IPlatformAdapter 接口定义
+│   ├── index.ts                # 适配器注册表
+│   ├── base-adapter.ts         # 基础适配器
+│   ├── registry.ts             # 平台注册与管理
+│   ├── wechat-publisher.ts     # 微信公众号发布核心
+│   ├── weixin.ts               # 微信公众号适配器
+│   ├── zhihu.ts                # 知乎适配器
+│   ├── juejin.ts               # 掘金适配器
+│   └── ...                     # 其他平台适配器
+│
+└── runtime/                    # 运行时抽象
+    ├── index.ts                # RuntimeInterface 接口
+    ├── node-runtime.ts         # Node.js 运行时实现
+    └── browser-runtime.ts       # Playwright 浏览器运行时
+```
+
+### 核心流程
+
+```
+Markdown 文件
+    │
+    ▼
+┌─────────────┐    ┌──────────────┐    ┌────────────────┐
+│  parser.ts  │───▶│ renderer.ts  │───▶│   styler.ts    │
+│  front-matter│    │ AST → HTML   │    │ CSS 内联        │
+│  Markdown 解析│    │ 代码高亮/LaTeX│    │ 主题应用        │
+└─────────────┘    └──────────────┘    └────────────────┘
+                                              │
+                   ┌──────────────────────────┘
+                   ▼
+           ┌───────────────┐    ┌──────────────────────┐
+           │ wechat-publish│    │   platform adapter   │
+           │ 图片上传 → media_id│    │   调用平台 API 发布   │
+           └───────────────┘    └──────────────────────┘
+```
+
+### 适配器接口
+
+```typescript
+interface IPlatformAdapter {
+  readonly meta: PlatformMeta      // 平台元信息
+  init(runtime: RuntimeInterface): Promise<void>
+  checkAuth(): Promise<AuthResult> // 认证检查
+  publish(article: Article): Promise<SyncResult>  // 发布文章
+}
+```
+
+---
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 开发模式
+npm run dev
+
+# 构建
+npm run build
+
+# 类型检查
+npm run typecheck
+```
+
+### 添加新平台
+
+1. 在 `src/adapters/` 创建 `<platform>.ts`，实现 `IPlatformAdapter` 接口
+2. 在 `src/adapters/index.ts` 注册
+
+```typescript
+// src/adapters/my-platform.ts
+export class MyPlatformAdapter implements IPlatformAdapter {
+  readonly meta: PlatformMeta = {
+    id: 'myplatform',
+    name: '我的平台',
+    icon: 'https://...',
+    homepage: 'https://...',
+    capabilities: ['article', 'draft'],
+  }
+  // 实现 init / checkAuth / publish
+}
+```
+
+```typescript
+// src/adapters/index.ts
+export { MyPlatformAdapter } from './my-platform.js'
+// 添加到导出列表
+```
+
+---
+
+## FAQ
+
+**Q: 微信公众号发布需要什么权限？**
+> 需要已认证的公众号（订阅号或服务号），在微信公众平台 → 开发 → 基本配置获取 AppID 和 AppSecret。
+
+**Q: 浏览器自动登录支持哪些平台？**
+> 目前支持知乎、掘金、CSDN、小红书、微博、B站等 20+ 平台，更多平台持续添加中。
+
+**Q: 多平台发布失败会怎样？**
+> 已发布成功的平台不受影响，失败平台返回具体错误信息，支持重试。
+
+**Q: 可以只发布到草稿箱吗？**
+> 是的，所有平台默认发布到草稿箱，需手动在各平台确认发布。
+
+---
+
+## 许可证
+
+Apache-2.0 License

package/dist/adapters/baijiahao.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 百家号适配器
+ * 认证方式: Cookie
+ */
+import { BaseAdapter } from './base-adapter.js';
+import type { Article, AuthResult, PlatformMeta } from './interface.js';
+export declare class BaijiahaoAdapter extends BaseAdapter {
+    readonly meta: PlatformMeta;
+    private cookieData;
+    init(): Promise<void>;
+    protected getCookieConfigKey(): string;
+    checkAuth(): Promise<AuthResult>;
+    publish(article: Article): Promise<import('./interface.js').SyncResult>;
+}

package/dist/adapters/baijiahao.js

@@ -0,0 +1,77 @@
+/**
+ * 百家号适配器
+ * 认证方式: Cookie
+ */
+import { BaseAdapter } from './base-adapter.js';
+export class BaijiahaoAdapter extends BaseAdapter {
+    meta = {
+        id: 'baijiahao',
+        name: '百家号',
+        icon: 'https://baijiahao.baidu.com/favicon.ico',
+        homepage: 'https://baijiahao.baidu.com/',
+        capabilities: ['article', 'draft', 'image_upload'],
+    };
+    cookieData = null;
+    async init() {
+        this.cookieData = await this.loadCookies();
+    }
+    getCookieConfigKey() {
+        return 'baijiahao';
+    }
+    async checkAuth() {
+        if (!this.cookieData) {
+            return { isAuthenticated: false, error: '未配置百家号 Cookie' };
+        }
+        try {
+            const cookieStr = this.buildCookieString(this.cookieData);
+            const res = await fetch('https://baijiahao.baidu.com/creator-center/stats', {
+                headers: {
+                    'Cookie': cookieStr,
+                    ...this.getCommonHeaders(),
+                },
+            });
+            //百家号登录后会重定向到登录页
+            if (res.url.includes('passport.baidu.com')) {
+                return { isAuthenticated: false, error: '未登录或登录已过期' };
+            }
+            return { isAuthenticated: true };
+        }
+        catch (err) {
+            return { isAuthenticated: false, error: err.message };
+        }
+    }
+    async publish(article) {
+        const start = Date.now();
+        if (!this.cookieData) {
+            return this.createErrorResult('未配置百家号 Cookie', start);
+        }
+        try {
+            const cookieStr = this.buildCookieString(this.cookieData);
+            // 百家号内容发布 API
+            const res = await fetch('https://baijiahao.baidu.com/creator-center/content/save', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Cookie': cookieStr,
+                    ...this.getCommonHeaders(),
+                },
+                body: JSON.stringify({
+                    title: article.title,
+                    content: article.html || article.markdown || '',
+                    draft: 1,
+                    cover_image: article.cover || '',
+                }),
+            });
+            const data = await res.json();
+            if (data.code !== 0) {
+                throw new Error(data.msg || '发布失败');
+            }
+            const postId = String(data.data?.content_id || '');
+            const draftUrl = `https://baijiahao.baidu.com/creator-center/content/edit?content_id=${postId}`;
+            return this.createSuccessResult(postId, draftUrl, true, start);
+        }
+        catch (err) {
+            return this.createErrorResult(err.message, start);
+        }
+    }
+}

package/dist/adapters/base-adapter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 平台适配器基类
+ * 使用模板方法模式定义发布流程骨架
+ */
+import type { IPlatformAdapter, Article, SyncResult, AuthResult, PlatformMeta } from './interface.js';
+import type { RuntimeInterface } from '../runtime/index.js';
+export declare abstract class BaseAdapter implements IPlatformAdapter {
+    abstract readonly meta: PlatformMeta;
+    protected runtime: RuntimeInterface;
+    abstract init(runtime: RuntimeInterface): Promise<void>;
+    abstract checkAuth(): Promise<AuthResult>;
+    abstract publish(article: Article): Promise<SyncResult>;
+    /**
+     * 获取 Cookie 配置键名（子类覆盖）
+     */
+    protected abstract getCookieConfigKey(): string;
+    /**
+     * 构建 Cookie 字符串
+     */
+    protected buildCookieString(cookies: Record<string, string>): string;
+    /**
+     * 加载平台 Cookie
+     */
+    protected loadCookies(): Promise<Record<string, string> | null>;
+    /**
+     * 默认的内容转换（子类可覆盖）
+     */
+    protected transformContent(content: string): string;
+    /**
+     * 默认的通用 HTTP headers
+     */
+    protected getCommonHeaders(): Record<string, string>;
+    /**
+     * 通用错误处理
+     */
+    protected createErrorResult(error: string, start?: number): SyncResult;
+    /**
+     * 通用成功结果
+     */
+    protected createSuccessResult(postId: string, postUrl: string, draftOnly?: boolean, start?: number): SyncResult;
+}

package/dist/adapters/base-adapter.js

@@ -0,0 +1,84 @@
+import { ConfigStore } from '../config.js';
+export class BaseAdapter {
+    runtime;
+    /**
+     * 构建 Cookie 字符串
+     */
+    buildCookieString(cookies) {
+        return Object.entries(cookies)
+            .map(([k, v]) => `${k}=${v}`)
+            .join('; ');
+    }
+    /**
+     * 加载平台 Cookie
+     */
+    async loadCookies() {
+        const configKey = this.getCookieConfigKey();
+        const getterMap = {
+            weibo: () => ConfigStore.getWeiboCookies(),
+            bilibili: () => ConfigStore.getBilibiliCookies(),
+            baijiahao: () => ConfigStore.getBaijiahaoCookies(),
+            cnblogs: () => ConfigStore.getCnblogsCookies(),
+            douban: () => ConfigStore.getDoubanCookies(),
+            eastmoney: () => ConfigStore.getEastmoneyCookies(),
+            imooc: () => ConfigStore.getImoocCookies(),
+            cto51: () => ConfigStore.getCto51Cookies(),
+            oschina: () => ConfigStore.getOschinaCookies(),
+            segmentfault: () => ConfigStore.getSegmentfaultCookies(),
+            sohu: () => ConfigStore.getSohuCookies(),
+            woshipm: () => ConfigStore.getWoshipmCookies(),
+            xueqiu: () => ConfigStore.getYueqiuCookies(), // xueqiu (雪球) uses yueqiu config key
+            jianshu: () => ConfigStore.getJianshuCookies(),
+            xiaohongshu: () => ConfigStore.getXiaohongshuCookies(),
+            toutiao: () => ConfigStore.getToutiaoCookies(),
+        };
+        const getter = getterMap[configKey];
+        if (!getter) {
+            console.warn(`[${this.meta.id}] 未知的 Cookie 配置键: ${configKey}`);
+            return null;
+        }
+        return getter();
+    }
+    /**
+     * 默认的内容转换（子类可覆盖）
+     */
+    transformContent(content) {
+        return content
+            .replace(/<img([^>]+)src="([^"]+)"([^>]*)>/gi, '<figure><img$1src="$2"$3></figure>')
+            .replace(/\s*data-(?!draft)[a-z-]+="[^"]*"/gi, '')
+            .replace(/\s*style="[^"]*"/gi, '');
+    }
+    /**
+     * 默认的通用 HTTP headers
+     */
+    getCommonHeaders() {
+        return {
+            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+            'Accept': 'application/json, text/plain, */*',
+        };
+    }
+    /**
+     * 通用错误处理
+     */
+    createErrorResult(error, start) {
+        return {
+            platform: this.meta.id,
+            success: false,
+            error,
+            timestamp: start ? Date.now() - start : 0,
+        };
+    }
+    /**
+     * 通用成功结果
+     */
+    createSuccessResult(postId, postUrl, draftOnly = true, start) {
+        return {
+            platform: this.meta.id,
+            success: true,
+            postId,
+            postUrl,
+            draftOnly,
+            timestamp: start ? Date.now() - start : 0,
+        };
+    }
+}

package/dist/adapters/bilibili.d.ts

@@ -0,0 +1,14 @@
+/**
+ * B站 (Bilibili) 适配器
+ * 认证方式: Cookie
+ */
+import { BaseAdapter } from './base-adapter.js';
+import type { Article, AuthResult, PlatformMeta } from './interface.js';
+export declare class BilibiliAdapter extends BaseAdapter {
+    readonly meta: PlatformMeta;
+    private cookieData;
+    init(): Promise<void>;
+    protected getCookieConfigKey(): string;
+    checkAuth(): Promise<AuthResult>;
+    publish(article: Article): Promise<import('./interface.js').SyncResult>;
+}