@wenyan-md/cli 2.0.0 → 2.0.1

package/README.md

@@ -29,8 +29,6 @@
 -   [跨平台桌面版](https://github.com/caol64/wenyan-pc) - Windows/Linux
 -   👉[CLI 版本](https://github.com/caol64/wenyan-cli) - 本项目
 -   [MCP 版本](https://github.com/caol64/wenyan-mcp) - AI 自动发文
--   [UI 库](https://github.com/caol64/wenyan-ui) - 桌面应用和 Web App 共用的 UI 层封装
--   [核心库](https://github.com/caol64/wenyan-core) - 嵌入 Node / Web 项目
 
 ## 特性
 
@@ -39,81 +37,18 @@
 - 支持远程 Server 发布（绕过 IP 白名单限制）
 - 内置多套精美排版主题
 - 支持自定义主题
-- 支持 Docker 和 npm
 - 可作为 CI/CD 自动发文工具
 - 可集成 AI Agent 自动发布
 
-## 本地模式和远程客户端模式
-
-文颜 CLI 支持两种运行模式：**本地模式（Local Mode）** 和 **远程客户端模式（Client–Server Mode）**。两种模式运行效果完全一致，你可以根据运行环境和网络条件选择最合适的方式。
-
-### 本地模式（Local Mode）
-
-在本地模式下，CLI 直接调用微信公众号 API 完成图片上传和草稿发布。
-
-```mermaid
-flowchart LR
-    CLI[Wenyan CLI] --> Wechat[公众号 API]
-```
-
-**优点：**
-
-* 无需额外服务器
-* 架构简单，部署成本低
-* 适合个人开发者和本地使用
-
-**限制：**
-
-> ⚠️ 微信公众号 API 要求调用方 IP 必须在白名单内。如果没有固定 IP，需要频繁添加白名单。
-
-### 远程客户端模式（Client–Server Mode）
-
-在此模式下，CLI 作为客户端，将发布请求发送到部署在云服务器上的 Wenyan Server，由 Server 完成微信公众号 API 调用。
-
-```mermaid
-flowchart LR
-
-    Client[Wenyan CLI Client]
-    Server[Wenyan Server]
-    Wechat[公众号 API]
-
-    Client -->|Markdown + Images| Server
-    Server -->|Upload Media| Wechat
-    Server -->|Create Draft| Wechat
-    Server -->|Result| Client
-```
-
-**优点：**
-
-* 无需本地固定 IP
-* 完美绕过微信 IP 白名单限制
-* 支持动态 IP 环境
-* 支持团队协作
-* 支持 CI/CD 自动发布
-* 支持 AI Agent 自动发布
-
-### Server 模式部署
-
-[文档](docs/server.md)。
-
-## 安装说明
-
-### npm 安装（推荐）
+## 快速开始
 
 ```bash
+# 安装
 npm install -g @wenyan-md/cli
+# 发布文章到公众号
+wenyan publish -f article.md
 ```
 
-运行：
-
-```bash
-wenyan --help
-```
-
-### docker 安装
-
-[文档](docs/docker.md)。
-
 ## 命令概览
 
 ```bash
@@ -127,22 +62,29 @@ wenyan <command> [options]
 | [theme](docs/theme.md)   | 管理主题      |
 | [serve](docs/server.md)   | 启动 Server |
 
-## 关于图片与封面自动上传
+## 概念
+
+### 内容输入
 
-无论是本地模式还是远程客户端模式，文颜 CLI 都提供**极度智能**的图片处理机制：
+内容输入是指如何把 Markdown 文章分发给 `wenyan-cli`，支持以下四种方式：
 
-- 识别并支持本地硬盘绝对路径（如：`/Users/xxx/image.jpg`）
-- 识别并支持当前目录的相对路径（如：`./assets/image.png`）
-- 识别并支持网络路径（如：`https://example.com/image.jpg`）
+| 方式      | 示例        | 说明        |
+| ------- | --------- |--------- |
+| 本地路径（推荐） | `wenyan publish -f article.md`      |`cli`直接读取磁盘上的文章      |
+| URL | `wenyan publish -f http://test.md`      |`cli`直接读取网络上的文章      |
+| 参数 | `wenyan publish "# 文章"`      |适用于快速发布短内容     |
+| 管道 | `cat article.md \| wenyan publish`      |适用于 CI/CD，脚本批量发布      |
 
-## 环境变量配置
+### 环境变量配置
 
-在实际向微信公众号发文的环境（你的本地或部署 `serve` 的服务器）中，必须配置以下环境变量：
+> [!IMPORTANT]
+>
+> 请确保运行文颜的机器已配置如下环境变量，否则上传接口将调用失败。
 
 -   `WECHAT_APP_ID`
 -   `WECHAT_APP_SECRET`
 
-## 微信公众号 IP 白名单
+### 微信公众号 IP 白名单
 
 > [!IMPORTANT]
 >
@@ -150,9 +92,9 @@ wenyan <command> [options]
 
 配置说明文档：[https://yuzhi.tech/docs/wenyan/upload](https://yuzhi.tech/docs/wenyan/upload)
 
-## Markdown Frontmatter 说明（必读）
+### 文章格式
 
-为了正确上传文章，每篇 Markdown 顶部需要包含 frontmatter：
+为了正确上传文章，每篇 Markdown 顶部需要包含一段 `frontmatter`：
 
 ```md
 ---
@@ -172,23 +114,46 @@ source_url: http://
 -   `author` 文章作者
 -   `source_url` 原文地址
 
-## 示例文章格式
+**[示例文章](tests/publish.md)**
 
-```md
----
-title: 在本地跑一个大语言模型(2) - 给模型提供外部知识库
-cover: /Users/lei/Downloads/result_image.jpg
----
+### 文内图片和文章封面
+
+把文章发布到公众号之前，文颜会按照微信要求自动处理文章内的所有图片，将其上传到公众号素材库。目前文颜对于以下两种图片都能很好的支持：
+
+- 本地硬盘绝对路径（如：`/Users/xxx/image.jpg`）
+- 网络路径（如：`https://example.com/image.jpg`）
+
+仅当“内容输入”方式为“本地路径”时，以下路径也能完美支持：
 
-在[上一篇文章](https://babyno.top/posts/2024/02/running-a-large-language-model-locally/)中，我们展示了如何在本地运行大型语言模型。本篇将介绍如何让模型从外部知识库中检索定制数据，提升答题准确率，让它看起来更“智能”。
+- 当前文章的相对路径（如：`./assets/image.png`）
 
-## 准备模型
+## Server 模式
 
-访问 `Ollama` 的模型页面，搜索 `qwen`，我们使用支持中文语义的“[通义千问](https://ollama.com/library/qwen:7b)”模型进行实验。
+相较于纯本地运行的**本地模式（Local Mode）**，`wenyan-cli`还提供了 **远程客户端模式（Client–Server Mode）**。两种模式运行效果完全一致，你可以根据运行环境和网络条件选择最合适的方式。
 
-![](https://mmbiz.qpic.cn/mmbiz_jpg/Jsq9IicjScDVUjkPc6O22ZMvmaZUzof5bLDjMyLg2HeAXd0icTvlqtL7oiarSlOicTtiaiacIxpVOV1EeMKl96PhRPPw/640?wx_fmt=jpeg)
+在本地模式下，CLI 直接调用微信公众号 API 完成图片上传和草稿发布。
+
+```mermaid
+flowchart LR
+    CLI[Wenyan CLI] --> Wechat[公众号 API]
 ```
 
+在远程客户端模式下，CLI 作为客户端，将发布请求发送到部署在云服务器上的 Wenyan Server，由 Server 完成微信公众号 API 调用。
+
+```mermaid
+flowchart LR
+    CLI[Wenyan CLI] --> Server[Wenyan Server] --> Wechat[公众号 API]
+```
+
+**适用于：**
+
+* 无本地固定 IP，需频繁添加IP 白名单的用户
+* 需团队协作的用户
+* 支持 CI/CD 自动发布
+* 支持 AI Agent 自动发布
+
+**[Server 模式部署](docs/server.md)**
+
 ## 赞助
 
 如果你觉得文颜对你有帮助，可以给我家猫咪买点罐头 ❤️

package/dist/cli.js

@@ -1,10 +1,9 @@
 #!/usr/bin/env node
 import { Command } from "commander";
-import { publishCommand } from "./commands/publish.js";
-import { prepareRenderContext } from "./commands/render.js";
 import pkg from "../package.json" with { type: "json" };
-import { addTheme, listThemes, removeTheme } from "./commands/theme.js";
-function createProgram(version = pkg.version) {
+import { addTheme, listThemes, prepareRenderContext, removeTheme, renderAndPublish, renderAndPublishToServer, } from "@wenyan-md/core/wrapper";
+import { getInputContent } from "./utils.js";
+export function createProgram(version = pkg.version) {
     const program = new Command();
     program
         .name("wenyan")
@@ -16,7 +15,7 @@ function createProgram(version = pkg.version) {
     const addCommonOptions = (cmd) => {
         return cmd
             .argument("[input-content]", "markdown content (string input)")
-            .option("-f, --file <path>", "read markdown content from local file")
+            .option("-f, --file <path>", "read markdown content from local file or web URL")
             .option("-t, --theme <theme-id>", "ID of the theme to use", "default")
             .option("-h, --highlight <highlight-theme-id>", "ID of the code highlight theme to use", "solarized-light")
             .option("-c, --custom-theme <path>", "path to custom theme CSS file")
@@ -37,13 +36,12 @@ function createProgram(version = pkg.version) {
             // 如果传入了 --server，则走客户端（远程）模式
             if (options.server) {
                 options.clientVersion = version; // 将 CLI 版本传递给服务器，便于调试和兼容性处理
-                const { publishClient } = await import("./commands/client.js");
-                const mediaId = await publishClient(inputContent, options);
+                const mediaId = await renderAndPublishToServer(inputContent, options, getInputContent);
                 console.log(`发布成功，Media ID: ${mediaId}`);
             }
             else {
                 // 走原有的本地直接发布模式
-                const mediaId = await publishCommand(inputContent, options);
+                const mediaId = await renderAndPublish(inputContent, options, getInputContent);
                 console.log(`发布成功，Media ID: ${mediaId}`);
             }
         });
@@ -51,7 +49,7 @@ function createProgram(version = pkg.version) {
     const renderCmd = program.command("render").description("Render a markdown file to styled HTML");
     addCommonOptions(renderCmd).action(async (inputContent, options) => {
         await runCommandWrapper(async () => {
-            const { gzhContent } = await prepareRenderContext(inputContent, options);
+            const { gzhContent } = await prepareRenderContext(inputContent, options, getInputContent);
             console.log(gzhContent.content);
         });
     });
@@ -67,7 +65,7 @@ function createProgram(version = pkg.version) {
         await runCommandWrapper(async () => {
             const { list, add, name, path, rm } = options;
             if (list) {
-                const themes = listThemes();
+                const themes = await listThemes();
                 console.log("内置主题：");
                 themes
                     .filter((theme) => theme.isBuiltin)
@@ -81,17 +79,16 @@ function createProgram(version = pkg.version) {
                         console.log(`- ${theme.id}: ${theme.description ?? ""}`);
                     });
                 }
-                console.log("");
                 return;
             }
             if (add) {
                 await addTheme(name, path);
-                console.log(`主题 "${name}" 已添加\n`);
+                console.log(`主题 "${name}" 已添加`);
                 return;
             }
             if (rm) {
                 await removeTheme(rm);
-                console.log(`主题 "${rm}" 已删除\n`);
+                console.log(`主题 "${rm}" 已删除`);
             }
         });
     });

package/dist/commands/serve.js

@@ -1,20 +1,23 @@
 import express from "express";
-import { AppError } from "../types.js";
-import fs from "node:fs";
-import fsPromises from "node:fs/promises";
+import fs from "node:fs/promises";
 import path from "node:path";
 import crypto from "node:crypto";
 import { configDir } from "@wenyan-md/core/wrapper";
 import multer from "multer";
-import { getNormalizeFilePath } from "../utils.js";
 import { publishToWechatDraft } from "@wenyan-md/core/publish";
+class AppError extends Error {
+    message;
+    constructor(message) {
+        super(message);
+        this.message = message;
+        this.name = "AppError";
+    }
+}
 const UPLOAD_TTL_MS = 10 * 60 * 1000; // 10 minutes
 const UPLOAD_DIR = path.join(configDir, "uploads");
 export async function serveCommand(options) {
     // 确保临时目录存在
-    if (!fs.existsSync(UPLOAD_DIR)) {
-        fs.mkdirSync(UPLOAD_DIR, { recursive: true });
-    }
+    await fs.mkdir(UPLOAD_DIR, { recursive: true });
     // 服务启动时立即执行一次后台清理
     cleanupOldUploads();
     // 定期清理过期的上传文件
@@ -70,7 +73,7 @@ export async function serveCommand(options) {
         const body = req.body;
         validateRequest(body);
         // 根据 fileId 去找刚上传的 json 文件并读取内容
-        const files = await fsPromises.readdir(UPLOAD_DIR);
+        const files = await fs.readdir(UPLOAD_DIR);
         const matchedFile = files.find((f) => f === body.fileId);
         if (!matchedFile) {
             throw new AppError(`文件不存在或已过期，请重新上传 (ID: ${body.fileId})`);
@@ -82,13 +85,15 @@ export async function serveCommand(options) {
         }
         // 找到上传文件并提取文本内容
         const filePath = path.join(UPLOAD_DIR, matchedFile);
-        const fileContent = await fsPromises.readFile(filePath, "utf-8");
+        const fileContent = await fs.readFile(filePath, "utf-8");
         const gzhContent = JSON.parse(fileContent);
+        if (!gzhContent.title)
+            throw new AppError("未能找到文章标题");
         // 公共的 asset:// 替换逻辑
         const resolveAssetPath = (assetUrl) => {
             const assetFileId = assetUrl.replace("asset://", "");
             const matchedAsset = files.find((f) => f === assetFileId || path.parse(f).name === assetFileId);
-            return matchedAsset ? getNormalizeFilePath(path.join(UPLOAD_DIR, matchedAsset)) : assetUrl;
+            return matchedAsset ? path.join(UPLOAD_DIR, matchedAsset) : assetUrl;
         };
         // 替换 HTML 内容里的 asset://
         gzhContent.content = gzhContent.content.replace(/(<img\b[^>]*?\bsrc\s*=\s*["'])(asset:\/\/[^"']+)(["'])/gi, (_match, prefix, assetUrl, suffix) => prefix + resolveAssetPath(assetUrl) + suffix);
@@ -109,7 +114,7 @@ export async function serveCommand(options) {
             });
         }
         else {
-            throw new AppError(`上传失败，\n${data}`);
+            throw new AppError(`发布到微信公众号失败，\n${data}`);
         }
     });
     // 上传接口
@@ -199,14 +204,14 @@ function validateRequest(req) {
 }
 async function cleanupOldUploads() {
     try {
-        const files = await fsPromises.readdir(UPLOAD_DIR);
+        const files = await fs.readdir(UPLOAD_DIR);
         const now = Date.now();
         for (const file of files) {
             const filePath = path.join(UPLOAD_DIR, file);
             try {
-                const stats = await fsPromises.stat(filePath);
+                const stats = await fs.stat(filePath);
                 if (now - stats.mtimeMs > UPLOAD_TTL_MS) {
-                    await fsPromises.unlink(filePath);
+                    await fs.unlink(filePath);
                 }
             }
             catch (e) {

package/dist/index.js

@@ -1,6 +1 @@
-export * from "./utils.js";
-export * from "./types.js";
-export * from "./commands/client.js";
-export * from "./commands/publish.js";
-export * from "./commands/render.js";
-export * from "./commands/theme.js";
+export {};

package/dist/types/cli.d.ts

@@ -1,2 +1,3 @@
 #!/usr/bin/env node
-export {};
+import { Command } from "commander";
+export declare function createProgram(version?: string): Command;

package/dist/types/index.d.ts

@@ -1,6 +1 @@
-export * from "./utils.js";
-export * from "./types.js";
-export * from "./commands/client.js";
-export * from "./commands/publish.js";
-export * from "./commands/render.js";
-export * from "./commands/theme.js";
+export {};

package/dist/types/utils.d.ts

@@ -1,7 +1,5 @@
-import { RenderOptions } from "./types.js";
 export declare function readStdin(): Promise<string>;
-export declare function getNormalizeFilePath(inputPath: string): string;
-export declare function getInputContent(inputContent: string | undefined, options: RenderOptions): Promise<{
+export declare function getInputContent(inputContent?: string, file?: string): Promise<{
     content: string;
     absoluteDirPath: string | undefined;
 }>;

package/dist/utils.js

@@ -1,6 +1,6 @@
 import path from "node:path";
-import { AppError } from "./types.js";
 import fs from "node:fs/promises";
+import { getNormalizeFilePath } from "@wenyan-md/core/wrapper";
 export async function readStdin() {
     return new Promise((resolve, reject) => {
         let data = "";
@@ -10,34 +10,7 @@ export async function readStdin() {
         process.stdin.on("error", reject);
     });
 }
-/**
- * 路径标准化工具函数
- * 将 Windows 的反斜杠 \ 转换为正斜杠 /，并去除末尾斜杠
- * 目的：在 Linux 容器内也能正确处理 Windows 路径字符串
- */
-function normalizePath(p) {
-    return p.replace(/\\/g, "/").replace(/\/+$/, "");
-}
-export function getNormalizeFilePath(inputPath) {
-    const isContainer = !!process.env.CONTAINERIZED;
-    const hostFilePath = normalizePath(process.env.HOST_FILE_PATH || "");
-    if (isContainer && hostFilePath) {
-        const containerFilePath = normalizePath(process.env.CONTAINER_FILE_PATH || "/mnt/host-downloads");
-        let relativePart = normalizePath(inputPath);
-        if (relativePart.startsWith(hostFilePath)) {
-            relativePart = relativePart.slice(hostFilePath.length);
-        }
-        if (!relativePart.startsWith("/")) {
-            relativePart = "/" + relativePart;
-        }
-        return containerFilePath + relativePart;
-    }
-    else {
-        return path.resolve(inputPath);
-    }
-}
-export async function getInputContent(inputContent, options) {
-    const { file } = options;
+export async function getInputContent(inputContent, file) {
     let absoluteDirPath = undefined;
     // 1. 尝试从 Stdin 读取
     if (!inputContent && !process.stdin.isTTY) {
@@ -51,7 +24,7 @@ export async function getInputContent(inputContent, options) {
     }
     // 3. 校验输入
     if (!inputContent) {
-        throw new AppError("missing input-content (no argument, no stdin, and no file).");
+        throw new Error("missing input-content (no argument, no stdin, and no file).");
     }
     return { content: inputContent, absoluteDirPath };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wenyan-md/cli",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "A CLI tool for Wenyan markdown rendering & publishing",
   "author": "Lei <caol64@gmail.com> (https://github.com/caol64)",
   "license": "Apache-2.0",
@@ -22,12 +22,6 @@
   "files": [
     "dist"
   ],
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/types/index.d.ts"
-    }
-  },
   "homepage": "https://github.com/caol64/wenyan-cli#readme",
   "repository": {
     "type": "git",
@@ -37,7 +31,7 @@
     "url": "https://github.com/caol64/wenyan-cli/issues"
   },
   "dependencies": {
-    "@wenyan-md/core": "^2.0.7",
+    "@wenyan-md/core": "^2.0.8",
     "commander": "^14.0.0",
     "express": "^5.2.1",
     "form-data-encoder": "^4.1.0",
@@ -46,7 +40,6 @@
     "multer": "^2.1.0"
   },
   "devDependencies": {
-    "@types/jsdom": "^27.0.0",
     "@types/express": "^5.0.6",
     "@types/multer": "^2.0.0",
     "@types/node": "^24.3.0",

package/dist/commands/client.js

@@ -1,208 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { Readable } from "node:stream";
-import { FormData, File } from "formdata-node";
-import { FormDataEncoder } from "form-data-encoder";
-import { AppError } from "../types.js";
-import { prepareRenderContext } from "./render.js";
-import { JSDOM } from "jsdom";
-export async function publishClient(inputContent, options) {
-    const { theme, customTheme, highlight, macStyle, footnote, apiKey, clientVersion, server } = options;
-    const serverUrl = server.replace(/\/$/, ""); // 移除末尾的斜杠
-    const headers = {};
-    if (clientVersion) {
-        headers["x-client-version"] = clientVersion;
-    }
-    if (apiKey) {
-        headers["x-api-key"] = apiKey;
-    }
-    // ==========================================
-    // 0. 连通性与鉴权测试 (Health & Auth Check)
-    // ==========================================
-    console.log(`[Client] Checking server connection at ${serverUrl} ...`);
-    try {
-        // 1. 物理连通性与服务指纹验证
-        const healthRes = await fetch(`${serverUrl}/health`, { method: "GET" });
-        if (!healthRes.ok) {
-            throw new Error(`HTTP Error: ${healthRes.status} ${healthRes.statusText}`);
-        }
-        const healthData = await healthRes.json();
-        if (healthData.status !== "ok" || healthData.service !== "wenyan-cli") {
-            throw new Error(`Invalid server response. Make sure the server URL is correct.`);
-        }
-        console.log(`[Client] Server connected successfully (version: ${healthData.version})`);
-        // 2. 鉴权探针测试
-        console.log(`[Client] Verifying authorization...`);
-        const verifyRes = await fetch(`${serverUrl}/verify`, {
-            method: "GET",
-            headers, // 携带 x-api-key 和 x-client-version
-        });
-        if (verifyRes.status === 401) {
-            throw new Error("鉴权失败 (401)：Server 拒绝访问，请检查传入的 --api-key 是否正确。");
-        }
-        if (!verifyRes.ok) {
-            throw new Error(`Verify Error: ${verifyRes.status} ${verifyRes.statusText}`);
-        }
-        console.log(`[Client] Authorization passed.`);
-    }
-    catch (error) {
-        if (error.message.includes("鉴权失败")) {
-            throw error;
-        }
-        throw new Error(`Failed to connect to server (${serverUrl}). \nPlease check if the server is running and the network is accessible. \nDetails: ${error.message}`);
-    }
-    // ==========================================
-    // 1. 读取 markdown 文件，获取其所在目录（用于解析相对图片路径），并渲染成 HTML 格式
-    // ==========================================
-    const { gzhContent, absoluteDirPath } = await prepareRenderContext(inputContent, options);
-    if (!gzhContent.title)
-        throw new AppError("未能找到文章标题");
-    if (!gzhContent.cover)
-        throw new AppError("未能找到文章封面");
-    // ==========================================
-    // [内部辅助函数] 提取公共的本地图片上传逻辑
-    // ==========================================
-    const uploadLocalImage = async (originalUrl) => {
-        let imagePath = originalUrl;
-        if (!path.isAbsolute(imagePath)) {
-            // 如果是相对路径，以 markdown 文件所在目录为基准进行拼接
-            imagePath = path.resolve(absoluteDirPath || process.cwd(), imagePath);
-        }
-        if (!fs.existsSync(imagePath)) {
-            console.warn(`[Client] Warning: Local image not found: ${imagePath}`);
-            return null;
-        }
-        try {
-            const fileBuffer = fs.readFileSync(imagePath);
-            const filename = path.basename(imagePath);
-            // 推断 Content-Type
-            const ext = path.extname(filename).toLowerCase();
-            const mimeTypes = {
-                ".jpg": "image/jpeg",
-                ".jpeg": "image/jpeg",
-                ".png": "image/png",
-                ".gif": "image/gif",
-                ".webp": "image/webp",
-                ".svg": "image/svg+xml",
-            };
-            const type = mimeTypes[ext] || "application/octet-stream";
-            // 构建图片上传表单
-            const form = new FormData();
-            form.append("file", new File([fileBuffer], filename, { type }));
-            const encoder = new FormDataEncoder(form);
-            console.log(`[Client] Uploading local image: ${filename} ...`);
-            const uploadRes = await fetch(`${serverUrl}/upload`, {
-                method: "POST",
-                headers: { ...headers, ...encoder.headers },
-                body: Readable.from(encoder),
-                duplex: "half",
-            });
-            if (uploadRes.status === 401) {
-                throw new Error("鉴权失败 (401)：Server 拒绝访问，请检查传入的 --api-key 是否正确。");
-            }
-            const uploadData = await uploadRes.json();
-            if (uploadRes.ok && uploadData.success) {
-                // 返回可供 Server 直接使用的协议路径
-                return `asset://${uploadData.data.fileId}`;
-            }
-            else {
-                console.warn(`[Client] Warning: Failed to upload ${filename}: ${uploadData.error || uploadData.desc}`);
-                return null;
-            }
-        }
-        catch (error) {
-            if (error.message.includes("鉴权失败") || error.message.includes("401")) {
-                throw error;
-            }
-            console.warn(`[Client] Warning: Error uploading ${imagePath} - ${error.message}`);
-            return null;
-        }
-    };
-    // ==========================================
-    // 2. 解析 HTML 中的所有本地图片上传并替换为服务器可访问的 URL
-    // ==========================================
-    let modifiedContent = gzhContent.content;
-    if (modifiedContent.includes("<img")) {
-        const dom = new JSDOM(modifiedContent);
-        const document = dom.window.document;
-        const images = Array.from(document.querySelectorAll("img"));
-        // 并发上传所有插图
-        const uploadPromises = images.map(async (element) => {
-            const dataSrc = element.getAttribute("src");
-            if (dataSrc && needUpload(dataSrc)) {
-                const newUrl = await uploadLocalImage(dataSrc);
-                if (newUrl) {
-                    element.setAttribute("src", newUrl); // 替换 DOM 中的属性
-                }
-            }
-        });
-        await Promise.all(uploadPromises);
-        modifiedContent = document.body.innerHTML;
-        gzhContent.content = modifiedContent;
-    }
-    // ==========================================
-    // 3. 处理封面图片
-    // ==========================================
-    const cover = gzhContent.cover;
-    if (cover && needUpload(cover)) {
-        console.log(`[Client] Processing cover image...`);
-        const newCoverUrl = await uploadLocalImage(cover);
-        if (newCoverUrl) {
-            gzhContent.cover = newCoverUrl; // 将封面路径替换为 asset://fileId
-        }
-    }
-    // ==========================================
-    // 4. 将替换后的 content 保存成临时文件/流，并上传
-    // ==========================================
-    const mdFilename = "publish_target.json"; // 这个文件名对服务器来说没有实际意义，只是一个标识
-    const mdForm = new FormData();
-    mdForm.append("file", new File([Buffer.from(JSON.stringify(gzhContent), "utf-8")], mdFilename, { type: "application/json" }));
-    const mdEncoder = new FormDataEncoder(mdForm);
-    console.log(`[Client] Uploading compiled document ...`);
-    const mdUploadRes = await fetch(`${serverUrl}/upload`, {
-        method: "POST",
-        headers: { ...headers, ...mdEncoder.headers },
-        body: Readable.from(mdEncoder),
-        duplex: "half",
-    });
-    if (mdUploadRes.status === 401) {
-        throw new Error("鉴权失败 (401)：Server 拒绝访问，请检查传入的 --api-key 是否正确。");
-    }
-    const mdUploadData = await mdUploadRes.json();
-    if (!mdUploadRes.ok || !mdUploadData.success) {
-        throw new Error(`Upload Document Failed: ${mdUploadData.error || mdUploadData.desc || mdUploadRes.statusText}`);
-    }
-    const mdFileId = mdUploadData.data.fileId;
-    console.log(`[Client] Document uploaded, ID: ${mdFileId}`);
-    // ==========================================
-    // 5. 调用 /publish 接口，触发 Server 端发布
-    // ==========================================
-    console.log(`[Client] Requesting remote Server to publish ...`);
-    const publishRes = await fetch(`${serverUrl}/publish`, {
-        method: "POST",
-        headers: {
-            ...headers,
-            "Content-Type": "application/json",
-        },
-        body: JSON.stringify({
-            fileId: mdFileId,
-            theme,
-            highlight,
-            customTheme,
-            macStyle,
-            footnote,
-        }),
-    });
-    if (publishRes.status === 401) {
-        throw new Error("鉴权失败 (401)：Server 拒绝访问，请检查传入的 --api-key 是否正确。");
-    }
-    const publishData = await publishRes.json();
-    if (!publishRes.ok || publishData.code === -1) {
-        throw new Error(`Remote Publish Failed: ${publishData.desc || publishRes.statusText}`);
-    }
-    return publishData.media_id;
-}
-function needUpload(url) {
-    // 需要上传的图片链接通常是相对路径，且不以 http/https、data:、asset:// 等协议开头
-    return !/^(https?:\/\/|data:|asset:\/\/)/i.test(url);
-}

package/dist/commands/publish.js

@@ -1,25 +0,0 @@
-import { publishToWechatDraft } from "@wenyan-md/core/publish";
-import { AppError } from "../types.js";
-import { prepareRenderContext } from "./render.js";
-export async function publishCommand(inputContent, options) {
-    const { gzhContent, absoluteDirPath } = await prepareRenderContext(inputContent, options);
-    if (!gzhContent.title)
-        throw new AppError("未能找到文章标题");
-    if (!gzhContent.cover)
-        throw new AppError("未能找到文章封面");
-    const data = await publishToWechatDraft({
-        title: gzhContent.title,
-        content: gzhContent.content,
-        cover: gzhContent.cover,
-        author: gzhContent.author,
-        source_url: gzhContent.source_url,
-    }, {
-        relativePath: absoluteDirPath,
-    });
-    if (data.media_id) {
-        return data.media_id;
-    }
-    else {
-        throw new AppError(`上传失败，\n${data}`);
-    }
-}

package/dist/commands/render.js

@@ -1,31 +0,0 @@
-import { configStore, renderStyledContent } from "@wenyan-md/core/wrapper";
-import { getInputContent, getNormalizeFilePath } from "../utils.js";
-import fs from "node:fs/promises";
-import { AppError } from "../types.js";
-// --- 处理输入源、文件路径和主题 ---
-export async function prepareRenderContext(inputContent, options) {
-    const { content, absoluteDirPath } = await getInputContent(inputContent, options);
-    const { theme, customTheme, highlight, macStyle, footnote } = options;
-    let handledCustomTheme = customTheme;
-    // 4. 当用户传入自定义主题路径时，优先级最高
-    if (customTheme) {
-        const normalizePath = getNormalizeFilePath(customTheme);
-        handledCustomTheme = await fs.readFile(normalizePath, "utf-8");
-    }
-    else if (theme) {
-        // 否则尝试读取配置中的自定义主题
-        handledCustomTheme = configStore.getThemeById(theme);
-    }
-    if (!handledCustomTheme && !theme) {
-        throw new AppError(`theme "${theme}" not found.`);
-    }
-    // 5. 执行核心渲染
-    const gzhContent = await renderStyledContent(content, {
-        themeId: theme,
-        hlThemeId: highlight,
-        isMacStyle: macStyle,
-        isAddFootnote: footnote,
-        themeCss: handledCustomTheme,
-    });
-    return { gzhContent, absoluteDirPath };
-}

package/dist/commands/theme.js

@@ -1,67 +0,0 @@
-import { getAllGzhThemes } from "@wenyan-md/core";
-import { getNormalizeFilePath } from "../utils.js";
-import fs from "node:fs/promises";
-import { configStore } from "@wenyan-md/core/wrapper";
-import { AppError } from "../types.js";
-export function listThemes() {
-    const themes = getAllGzhThemes();
-    const themeList = themes.map((theme) => {
-        return {
-            id: theme.meta.id,
-            name: theme.meta.name,
-            description: theme.meta.description,
-            isBuiltin: true,
-        };
-    });
-    const customThemes = configStore.getThemes();
-    if (customThemes.length > 0) {
-        customThemes.forEach((theme) => {
-            themeList.push({
-                id: theme.id,
-                name: theme.id,
-                description: theme.description,
-                isBuiltin: false,
-            });
-        });
-    }
-    return themeList;
-}
-export async function addTheme(name, path) {
-    if (!name || !path) {
-        throw new AppError("添加主题时必须提供名称(name)和路径(path)");
-    }
-    if (checkThemeExists(name) || checkCustomThemeExists(name)) {
-        throw new AppError(`主题 "${name}" 已存在`);
-    }
-    if (path.startsWith("http")) {
-        console.log(`正在从远程获取主题: ${path} ...`);
-        const response = await fetch(path);
-        if (!response.ok) {
-            throw new AppError(`无法从远程获取主题: ${response.statusText}`);
-        }
-        const content = await response.text();
-        configStore.addThemeToConfig(name, content);
-    }
-    else {
-        const normalizePath = getNormalizeFilePath(path);
-        const content = await fs.readFile(normalizePath, "utf-8");
-        configStore.addThemeToConfig(name, content);
-    }
-}
-export async function removeTheme(name) {
-    if (checkThemeExists(name)) {
-        throw new AppError(`默认主题 "${name}" 不能删除`);
-    }
-    if (!checkCustomThemeExists(name)) {
-        throw new AppError(`自定义主题 "${name}" 不存在`);
-    }
-    configStore.deleteThemeFromConfig(name);
-}
-function checkThemeExists(themeId) {
-    const themes = getAllGzhThemes();
-    return themes.some((theme) => theme.meta.id === themeId);
-}
-function checkCustomThemeExists(themeId) {
-    const customThemes = configStore.getThemes();
-    return customThemes.some((theme) => theme.id === themeId);
-}

package/dist/types/commands/client.d.ts

@@ -1,2 +0,0 @@
-import { PublishOptions } from "../types.js";
-export declare function publishClient(inputContent: string | undefined, options: PublishOptions): Promise<string>;

package/dist/types/commands/publish.d.ts

@@ -1,2 +0,0 @@
-import { RenderOptions } from "../types.js";
-export declare function publishCommand(inputContent: string | undefined, options: RenderOptions): Promise<string>;

package/dist/types/commands/render.d.ts

@@ -1,8 +0,0 @@
-import { StyledContent } from "@wenyan-md/core/wrapper";
-import { RenderOptions } from "../types.js";
-interface RenderContext {
-    gzhContent: StyledContent;
-    absoluteDirPath: string | undefined;
-}
-export declare function prepareRenderContext(inputContent: string | undefined, options: RenderOptions): Promise<RenderContext>;
-export {};

package/dist/types/commands/theme.d.ts

@@ -1,16 +0,0 @@
-export interface ThemeOptions {
-    list?: boolean;
-    add?: boolean;
-    name?: string;
-    path?: string;
-    rm?: string;
-}
-export interface ThemeInfo {
-    id: string;
-    name: string;
-    description?: string;
-    isBuiltin: boolean;
-}
-export declare function listThemes(): ThemeInfo[];
-export declare function addTheme(name?: string, path?: string): Promise<void>;
-export declare function removeTheme(name: string): Promise<void>;

package/dist/types/types.d.ts

@@ -1,17 +0,0 @@
-export interface RenderOptions {
-    file?: string;
-    theme?: string;
-    customTheme?: string;
-    highlight: string;
-    macStyle: boolean;
-    footnote: boolean;
-}
-export interface PublishOptions extends RenderOptions {
-    server?: string;
-    apiKey?: string;
-    clientVersion?: string;
-}
-export declare class AppError extends Error {
-    message: string;
-    constructor(message: string);
-}

package/dist/types.js

@@ -1,8 +0,0 @@
-export class AppError extends Error {
-    message;
-    constructor(message) {
-        super(message);
-        this.message = message;
-        this.name = "AppError";
-    }
-}