@wenyan-md/cli 1.0.11 → 2.0.1

package/README.docker.md

@@ -125,6 +125,37 @@ WECHAT_APP_SECRET=yyy
 -   Runtime: Node.js (bundled)
 -   Architecture: `linux/amd64`, `linux/arm64`
 
+## Server Mode
+
+Deploy on a cloud server with fixed IP to solve WeChat API whitelist requirements:
+
+```bash
+docker run -d --name wenyan-server \
+  -p 3000:3000 \
+  --env-file .env \
+  caol64/wenyan-cli \
+  serve --port 3000
+```
+
+Then call the REST API from your local machine:
+
+```bash
+# Health check
+curl http://your-server-ip:3000/health
+
+# Render
+curl -X POST http://your-server-ip:3000/render \
+  -H "Content-Type: application/json" \
+  -d '{"content": "# Hello World", "theme": "default"}'
+
+# Publish
+curl -X POST http://your-server-ip:3000/publish \
+  -H "Content-Type: application/json" \
+  -d '{"file": "/mnt/host-downloads/article.md"}'
+```
+
+> **Note:** Add your server's public IP to WeChat Official Account whitelist once, and it works permanently.
+
 ## License
 
 Apache License Version 2.0

package/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-    <img alt = "logo" src="https://raw.githubusercontent.com/caol64/wenyan/main/Data/256-mac.png" />
+    <img alt="logo" src="https://raw.githubusercontent.com/caol64/wenyan/main/Data/256-mac.png" width="128" />
 </div>
 
 # 文颜 CLI
@@ -27,215 +27,64 @@
 
 -   [macOS App Store 版](https://github.com/caol64/wenyan) - MAC 桌面应用
 -   [跨平台桌面版](https://github.com/caol64/wenyan-pc) - Windows/Linux
--   👉 [CLI 版本](https://github.com/caol64/wenyan-cli) - 本项目
+-   👉[CLI 版本](https://github.com/caol64/wenyan-cli) - 本项目
 -   [MCP 版本](https://github.com/caol64/wenyan-mcp) - AI 自动发文
--   [核心库](https://github.com/caol64/wenyan-core) - 嵌入 Node / Web 项目
 
-## 安装方式
+## 特性
 
-### 方式一：npm（推荐）
+- 一键发布 Markdown 到微信公众号草稿箱
+- 自动上传本地图片与封面
+- 支持远程 Server 发布（绕过 IP 白名单限制）
+- 内置多套精美排版主题
+- 支持自定义主题
+- 可作为 CI/CD 自动发文工具
+- 可集成 AI Agent 自动发布
 
-```bash
-npm install -g @wenyan-md/cli
-```
-
-安装完成后即可使用：
-
-```bash
-wenyan --help
-```
-
-### 方式二：Docker（无需 Node 环境）
-
-如果你不想在本地安装 Node.js，也可以直接使用 Docker。
-
-**拉取镜像**
-
-```bash
-docker pull caol64/wenyan-cli
-```
-
-**查看帮助**
+## 快速开始
 
 ```bash
-docker run --rm caol64/wenyan-cli
+# 安装
+npm install -g @wenyan-md/cli
+# 发布文章到公众号
+wenyan publish -f article.md
 ```
 
-**发布文章示例**
-
-```bash
-docker run --rm \
-  --env-file .env.test \
-  -e HOST_FILE_PATH=$(pwd) \
-  -v $(pwd):/mnt/host-downloads \
-  caol64/wenyan-cli \
-  publish -f ./test/publish.md -t phycat
-```
-
-> 说明：
->
-> -   使用 `-e` 传入环境变量
-> -   使用 `-v` 挂载本地 Markdown 文件
-> -   容器启动即执行 `wenyan` 命令
-
-## 基本用法
-
-CLI 主命令：
+## 命令概览
 
 ```bash
 wenyan <command> [options]
 ```
 
-目前支持的子命令有
-- `publish` 排版并发布到公众号草稿箱
-- `render` 仅排版，用做测试
-- `theme` 主题管理
-
-## 子命令
-
-### `publish`
-
-将 Markdown 转换为适配微信公众号的富文本 HTML，并上传到草稿箱。
-
-#### 参数
-
--   `<input-content>`
-
-    Markdown 内容，可以：
-
-    -   直接作为参数传入
-    -   通过 stdin 管道输入
-
-#### 常用选项
-
--   `-t <theme-id>`：主题id（默认 `default`），可以是内置主题，也可以是通过`theme --add`添加的自定义主题
-    -   [内置主题](https://github.com/caol64/wenyan-core/tree/main/src/assets/themes)
--   `-h <highlight-theme-id>`：代码高亮主题（默认 `solarized-light`）
-    -   atom-one-dark / atom-one-light / dracula / github-dark / github / monokai / solarized-dark / solarized-light / xcode
--   `--no-mac-style`：关闭代码块 Mac 风格
--   `--no-footnote`：关闭链接转脚注
--   `-f <path>`：指定本地 Markdown 文件路径
--   `-c <path>`：指定临时自定义主题路径，优先级大于`-t`
-
-#### 使用示例
-
-直接传入内容：
-
-```bash
-wenyan publish "# Hello, Wenyan" -t lapis -h solarized-light
-```
-
-从管道读取：
-
-```bash
-cat example.md | wenyan publish -t lapis -h solarized-light --no-mac-style
-```
-
-从文件读取：
-
-```bash
-wenyan publish -f "./example.md" -t lapis -h solarized-light --no-mac-style
-```
-
-### `theme`
-
-主题管理，浏览内置主题、添加/删除自定义主题。
-
-#### 参数
-
-无。
-
-#### 常用选项
-
--   `-l`：列出所有可用主题
--   `--add`：添加自定义主题（永久）
-    -   `--name <name>`：主题名称
-    -   `--path <path>`：主题路径（本地或网络）
--   `--rm <name>`：删除自定义主题
-
-#### 使用示例
-
-列出可用主题：
-
-```bash
-wenyan theme -l
-```
-
-安装自定义主题
-
-```bash
-wenyan theme --add --name new-theme --path https://wenyan.yuzhi.tech/manhua.css
-```
-
-删除自定义主题
-
-```bash
-wenyan theme --rm new-theme
-```
-
-## 使用自定义主题
-
-你可以通过两种途径使用自定义主题：
-
-- 不安装直接使用
-
-```bash
-wenyan publish -f "./example.md" -c "/path/to/theme" -h solarized-light --no-mac-style
-```
-
-- 先安装再使用：
+| 命令      | 说明        |
+| ------- | --------- |
+| [publish](docs/publish.md) | 发布文章      |
+| render  | 渲染 HTML   |
+| [theme](docs/theme.md)   | 管理主题      |
+| [serve](docs/server.md)   | 启动 Server |
 
-```bash
-wenyan theme --add --name new-theme --path https://wenyan.yuzhi.tech/manhua.css
-wenyan publish -f "./example.md" -t new-theme -h solarized-light --no-mac-style
-```
+## 概念
 
-区别在于，安装后的主题永久有效。
+### 内容输入
 
-## 关于图片自动上传
+内容输入是指如何把 Markdown 文章分发给 `wenyan-cli`，支持以下四种方式：
 
-支持以下图片来源：
+| 方式      | 示例        | 说明        |
+| ------- | --------- |--------- |
+| 本地路径（推荐） | `wenyan publish -f article.md`      |`cli`直接读取磁盘上的文章      |
+| URL | `wenyan publish -f http://test.md`      |`cli`直接读取网络上的文章      |
+| 参数 | `wenyan publish "# 文章"`      |适用于快速发布短内容     |
+| 管道 | `cat article.md \| wenyan publish`      |适用于 CI/CD，脚本批量发布      |
 
--   本地路径（如：`/Users/xxx/image.jpg`）
--   网络路径（如：`https://example.com/image.jpg`）
+### 环境变量配置
 
-## 环境变量配置
-
-部分功能（如发布微信公众号）需要配置以下环境变量：
+> [!IMPORTANT]
+>
+> 请确保运行文颜的机器已配置如下环境变量，否则上传接口将调用失败。
 
 -   `WECHAT_APP_ID`
 -   `WECHAT_APP_SECRET`
 
-### macOS / Linux
-
-临时使用：
-
-```bash
-WECHAT_APP_ID=xxx WECHAT_APP_SECRET=yyy wenyan publish "your markdown"
-```
-
-永久配置（推荐）：
-
-```bash
-export WECHAT_APP_ID=xxx
-export WECHAT_APP_SECRET=yyy
-```
-
-### Windows (PowerShell)
-
-临时使用：
-
-```powershell
-$env:WECHAT_APP_ID="xxx"
-$env:WECHAT_APP_SECRET="yyy"
-wenyan publish example.md
-```
-
-永久设置（在环境变量里添加）：
-
-控制面板 → 系统和安全 → 系统 → 高级系统设置 → 环境变量 → 添加 `WECHAT_APP_ID` 和 `WECHAT_APP_SECRET`。
-
-## 微信公众号 IP 白名单
+### 微信公众号 IP 白名单
 
 > [!IMPORTANT]
 >
@@ -243,9 +92,9 @@ wenyan publish example.md
 
 配置说明文档：[https://yuzhi.tech/docs/wenyan/upload](https://yuzhi.tech/docs/wenyan/upload)
 
-## Markdown Frontmatter 说明（必读）
+### 文章格式
 
-为了正确上传文章，每篇 Markdown 顶部需要包含 frontmatter：
+为了正确上传文章，每篇 Markdown 顶部需要包含一段 `frontmatter`：
 
 ```md
 ---
@@ -265,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`）
+
+仅当“内容输入”方式为“本地路径”时，以下路径也能完美支持：
+
+- 当前文章的相对路径（如：`./assets/image.png`）
 
-在[上一篇文章](https://babyno.top/posts/2024/02/running-a-large-language-model-locally/)中，我们展示了如何在本地运行大型语言模型。本篇将介绍如何让模型从外部知识库中检索定制数据，提升答题准确率，让它看起来更“智能”。
+## Server 模式
 
-## 准备模型
+相较于纯本地运行的**本地模式（Local Mode）**，`wenyan-cli`还提供了 **远程客户端模式（Client–Server Mode）**。两种模式运行效果完全一致，你可以根据运行环境和网络条件选择最合适的方式。
 
-访问 `Ollama` 的模型页面，搜索 `qwen`，我们使用支持中文语义的“[通义千问](https://ollama.com/library/qwen:7b)”模型进行实验。
+在本地模式下，CLI 直接调用微信公众号 API 完成图片上传和草稿发布。
 
-![](https://mmbiz.qpic.cn/mmbiz_jpg/Jsq9IicjScDVUjkPc6O22ZMvmaZUzof5bLDjMyLg2HeAXd0icTvlqtL7oiarSlOicTtiaiacIxpVOV1EeMKl96PhRPPw/640?wx_fmt=jpeg)
+```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,4 +1,129 @@
 #!/usr/bin/env node
-import { createProgram } from "./index.js";
+import { Command } from "commander";
+import pkg from "../package.json" with { type: "json" };
+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")
+        .description("A CLI for WenYan Markdown Render.")
+        .version(version, "-v, --version", "output the current version")
+        .action(() => {
+        program.outputHelp();
+    });
+    const addCommonOptions = (cmd) => {
+        return cmd
+            .argument("[input-content]", "markdown content (string input)")
+            .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")
+            .option("--mac-style", "display codeblock with mac style", true)
+            .option("--no-mac-style", "disable mac style")
+            .option("--footnote", "convert link to footnote", true)
+            .option("--no-footnote", "disable footnote");
+    };
+    const pubCmd = program
+        .command("publish")
+        .description("Render a markdown file to styled HTML and publish to wechat GZH");
+    // 先添加公共选项，再追加 publish 专属选项
+    addCommonOptions(pubCmd)
+        .option("--server <url>", "Server URL to publish through (e.g. https://api.yourdomain.com)")
+        .option("--api-key <apiKey>", "API key for the remote server")
+        .action(async (inputContent, options) => {
+        await runCommandWrapper(async () => {
+            // 如果传入了 --server，则走客户端（远程）模式
+            if (options.server) {
+                options.clientVersion = version; // 将 CLI 版本传递给服务器，便于调试和兼容性处理
+                const mediaId = await renderAndPublishToServer(inputContent, options, getInputContent);
+                console.log(`发布成功，Media ID: ${mediaId}`);
+            }
+            else {
+                // 走原有的本地直接发布模式
+                const mediaId = await renderAndPublish(inputContent, options, getInputContent);
+                console.log(`发布成功，Media ID: ${mediaId}`);
+            }
+        });
+    });
+    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, getInputContent);
+            console.log(gzhContent.content);
+        });
+    });
+    program
+        .command("theme")
+        .description("Manage themes")
+        .option("-l, --list", "List all available themes")
+        .option("--add", "Add a new custom theme")
+        .option("--name <name>", "Name of the new custom theme")
+        .option("--path <path>", "Path to the new custom theme CSS file")
+        .option("--rm <name>", "Name of the custom theme to remove")
+        .action(async (options) => {
+        await runCommandWrapper(async () => {
+            const { list, add, name, path, rm } = options;
+            if (list) {
+                const themes = await listThemes();
+                console.log("内置主题：");
+                themes
+                    .filter((theme) => theme.isBuiltin)
+                    .forEach((theme) => {
+                    console.log(`- ${theme.id}: ${theme.description ?? ""}`);
+                });
+                const customThemes = themes.filter((theme) => !theme.isBuiltin);
+                if (customThemes.length > 0) {
+                    console.log("\n自定义主题：");
+                    customThemes.forEach((theme) => {
+                        console.log(`- ${theme.id}: ${theme.description ?? ""}`);
+                    });
+                }
+                return;
+            }
+            if (add) {
+                await addTheme(name, path);
+                console.log(`主题 "${name}" 已添加`);
+                return;
+            }
+            if (rm) {
+                await removeTheme(rm);
+                console.log(`主题 "${rm}" 已删除`);
+            }
+        });
+    });
+    program
+        .command("serve")
+        .description("Start a server to provide HTTP API for rendering and publishing")
+        .option("-p, --port <port>", "Port to listen on (default: 3000)", "3000")
+        .option("--api-key <apiKey>", "API key for authentication")
+        .action(async (options) => {
+        try {
+            const { serveCommand } = await import("./commands/serve.js");
+            const port = options.port ? parseInt(options.port, 10) : 3000;
+            await serveCommand({ port, version, apiKey: options.apiKey });
+        }
+        catch (error) {
+            console.error(error.message);
+            process.exit(1);
+        }
+    });
+    return program;
+}
+// --- 统一的错误处理包装器 ---
+async function runCommandWrapper(action) {
+    try {
+        await action();
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        else {
+            console.error("An unexpected error occurred:", error);
+        }
+        process.exit(1);
+    }
+}
 const program = createProgram();
 program.parse(process.argv);

package/dist/commands/serve.js

@@ -0,0 +1,225 @@
+import express from "express";
+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 { 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) {
+    // 确保临时目录存在
+    await fs.mkdir(UPLOAD_DIR, { recursive: true });
+    // 服务启动时立即执行一次后台清理
+    cleanupOldUploads();
+    // 定期清理过期的上传文件
+    setInterval(cleanupOldUploads, UPLOAD_TTL_MS).unref();
+    const app = express();
+    const port = options.port || 3000;
+    const auth = createAuthHandler(options);
+    app.use(express.json({ limit: "10mb" }));
+    const storage = multer.diskStorage({
+        destination: (req, file, cb) => {
+            cb(null, UPLOAD_DIR);
+        },
+        filename: (req, file, cb) => {
+            const fileId = crypto.randomUUID();
+            const ext = file.originalname.split(".").pop() || "";
+            cb(null, ext ? `${fileId}.${ext}` : fileId);
+        },
+    });
+    const upload = multer({
+        storage,
+        limits: {
+            fileSize: 10 * 1024 * 1024, // 10MB
+        },
+        fileFilter: (req, file, cb) => {
+            const ext = file.originalname.split(".").pop()?.toLowerCase();
+            // 1. 定义允许的图片类型
+            const allowedImageTypes = ["image/jpeg", "image/png", "image/gif", "image/webp", "image/svg+xml"];
+            const allowedImageExts = ["jpg", "jpeg", "png", "gif", "webp", "svg"];
+            // 2. 分别判断文件大类
+            const isImage = allowedImageTypes.includes(file.mimetype) || (ext && allowedImageExts.includes(ext));
+            const isMarkdown = ext === "md" || file.mimetype === "text/markdown" || file.mimetype === "text/plain";
+            const isCss = ext === "css" || file.mimetype === "text/css";
+            const isJson = ext === "json" || file.mimetype === "application/json";
+            // 3. 综合放行逻辑
+            if (isImage || isMarkdown || isCss || isJson) {
+                cb(null, true);
+            }
+            else {
+                cb(new AppError("不支持的文件类型，仅支持图片、Markdown、CSS 和 JSON 文件"));
+            }
+        },
+    });
+    // 健康检查
+    app.get("/health", (_req, res) => {
+        res.json({ status: "ok", service: "wenyan-cli", version: options.version || "unknown" });
+    });
+    // 鉴权探针
+    app.get("/verify", auth, (_req, res) => {
+        res.json({ success: true, message: "Authorized" });
+    });
+    // 发布接口 - 读取 json 文件内容并发布
+    app.post("/publish", auth, async (req, res) => {
+        const body = req.body;
+        validateRequest(body);
+        // 根据 fileId 去找刚上传的 json 文件并读取内容
+        const files = await fs.readdir(UPLOAD_DIR);
+        const matchedFile = files.find((f) => f === body.fileId);
+        if (!matchedFile) {
+            throw new AppError(`文件不存在或已过期，请重新上传 (ID: ${body.fileId})`);
+        }
+        // 简单的防呆校验，防止直接提交纯图片的 fileId 到发布接口
+        const ext = path.extname(matchedFile).toLowerCase();
+        if (ext !== ".json") {
+            throw new AppError("请提供 JSON 文件的 fileId，不能直接发布图片文件");
+        }
+        // 找到上传文件并提取文本内容
+        const filePath = path.join(UPLOAD_DIR, matchedFile);
+        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 ? 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);
+        // 替换封面里的 asset://
+        if (gzhContent.cover && gzhContent.cover.startsWith("asset://")) {
+            gzhContent.cover = resolveAssetPath(gzhContent.cover);
+        }
+        const data = await publishToWechatDraft({
+            title: gzhContent.title,
+            content: gzhContent.content,
+            cover: gzhContent.cover,
+            author: gzhContent.author,
+            source_url: gzhContent.source_url,
+        });
+        if (data.media_id) {
+            res.json({
+                media_id: data.media_id,
+            });
+        }
+        else {
+            throw new AppError(`发布到微信公众号失败，\n${data}`);
+        }
+    });
+    // 上传接口
+    app.post("/upload", auth, upload.single("file"), async (req, res) => {
+        if (!req.file) {
+            throw new AppError("未找到上传的文件");
+        }
+        const newFilename = req.file.filename;
+        res.json({
+            success: true,
+            data: {
+                fileId: newFilename,
+                originalFilename: req.file.originalname,
+                mimetype: req.file.mimetype,
+                size: req.file.size,
+            },
+        });
+    });
+    app.use(errorHandler);
+    return new Promise((resolve, reject) => {
+        const server = app.listen(port, () => {
+            console.log(`文颜 Server 已启动，监听端口 ${port}`);
+            console.log(`健康检查：http://localhost:${port}/health`);
+            console.log(`鉴权探针：http://localhost:${port}/verify`);
+            console.log(`发布接口：POST http://localhost:${port}/publish`);
+            console.log(`上传接口：POST http://localhost:${port}/upload`);
+        });
+        server.on("error", (err) => {
+            if (err.code === "EADDRINUSE") {
+                console.error(`端口 ${port} 已被占用`);
+                reject(new Error(`端口 ${port} 已被占用`));
+            }
+            else {
+                reject(err);
+            }
+        });
+        process.on("SIGINT", () => {
+            console.log("\n正在关闭服务器...");
+            server.close(() => {
+                console.log("服务器已关闭");
+                resolve();
+            });
+        });
+        process.on("SIGTERM", () => {
+            server.close(() => resolve());
+        });
+    });
+}
+function errorHandler(error, _req, res, next) {
+    if (res.headersSent) {
+        return next(error);
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    // 修复：multer 抛出的文件限制错误（如超出大小），应判断为客户端 400 错误
+    const isAppError = error instanceof AppError;
+    const isMulterError = error.name === "MulterError";
+    const statusCode = isAppError || isMulterError ? 400 : 500;
+    if (statusCode === 500) {
+        console.error("[Server Error]:", error);
+    }
+    res.status(statusCode).json({
+        code: -1,
+        desc: message,
+    });
+}
+function createAuthHandler(config) {
+    return (req, res, next) => {
+        if (!config.apiKey) {
+            return next();
+        }
+        const clientApiKey = req.headers["x-api-key"];
+        if (clientApiKey === config.apiKey) {
+            next();
+        }
+        else {
+            res.status(401).json({
+                code: -1,
+                desc: "Unauthorized: Invalid API Key",
+            });
+        }
+    };
+}
+function validateRequest(req) {
+    if (!req.fileId) {
+        throw new AppError("缺少必要参数：fileId");
+    }
+}
+async function cleanupOldUploads() {
+    try {
+        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 fs.stat(filePath);
+                if (now - stats.mtimeMs > UPLOAD_TTL_MS) {
+                    await fs.unlink(filePath);
+                }
+            }
+            catch (e) {
+                // 忽略单个文件处理错误
+            }
+        }
+    }
+    catch (e) {
+        console.error("Cleanup task error:", e);
+    }
+}

package/dist/index.js

@@ -1,43 +1 @@
-import { Command } from "commander";
-import { publishCommand } from "./commands/publish.js";
-import { renderCommand } from "./commands/render.js";
-import pkg from "../package.json" with { type: "json" };
-import { themeCommand } from "./commands/theme.js";
-export function createProgram(version = pkg.version) {
-    const program = new Command();
-    program
-        .name("wenyan")
-        .description("A CLI for WenYan Markdown Render.")
-        .version(version, "-v, --version", "output the current version")
-        .action(() => {
-        program.outputHelp();
-    });
-    const addCommonOptions = (cmd) => {
-        return cmd
-            .argument("[input-content]", "markdown content (string input)")
-            .option("-f, --file <path>", "read markdown content from local file")
-            .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")
-            .option("--mac-style", "display codeblock with mac style", true)
-            .option("--no-mac-style", "disable mac style")
-            .option("--footnote", "convert link to footnote", true)
-            .option("--no-footnote", "disable footnote");
-    };
-    const pubCmd = program
-        .command("publish")
-        .description("Render a markdown file to styled HTML and publish to wechat GZH");
-    addCommonOptions(pubCmd).action(publishCommand);
-    const renderCmd = program.command("render").description("Render a markdown file to styled HTML");
-    addCommonOptions(renderCmd).action(renderCommand);
-    program
-        .command("theme")
-        .description("Manage themes")
-        .option("-l, --list", "List all available themes")
-        .option("--add", "Add a new custom theme")
-        .option("--name <name>", "Name of the new custom theme")
-        .option("--path <path>", "Path to the new custom theme CSS file")
-        .option("--rm <name>", "Name of the custom theme to remove")
-        .action(themeCommand);
-    return program;
-}
+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/commands/serve.d.ts

@@ -0,0 +1,6 @@
+export interface ServeOptions {
+    port?: number;
+    version?: string;
+    apiKey?: string;
+}
+export declare function serveCommand(options: ServeOptions): Promise<void>;

package/dist/types/index.d.ts

@@ -1,2 +1 @@
-import { Command } from "commander";
-export declare function createProgram(version?: string): Command;
+export {};

package/dist/types/utils.d.ts

@@ -1,2 +1,5 @@
 export declare function readStdin(): Promise<string>;
-export declare function getNormalizeFilePath(inputPath: string): string;
+export declare function getInputContent(inputContent?: string, file?: string): Promise<{
+    content: string;
+    absoluteDirPath: string | undefined;
+}>;

package/dist/utils.js

@@ -1,4 +1,6 @@
 import path from "node:path";
+import fs from "node:fs/promises";
+import { getNormalizeFilePath } from "@wenyan-md/core/wrapper";
 export async function readStdin() {
     return new Promise((resolve, reject) => {
         let data = "";
@@ -8,29 +10,21 @@ 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;
-    if (isContainer) {
-        const hostFilePath = normalizePath(process.env.HOST_FILE_PATH || "");
-        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;
+export async function getInputContent(inputContent, file) {
+    let absoluteDirPath = undefined;
+    // 1. 尝试从 Stdin 读取
+    if (!inputContent && !process.stdin.isTTY) {
+        inputContent = await readStdin();
+    }
+    // 2. 尝试从文件读取
+    if (!inputContent && file) {
+        const normalizePath = getNormalizeFilePath(file);
+        inputContent = await fs.readFile(normalizePath, "utf-8");
+        absoluteDirPath = path.dirname(normalizePath);
     }
-    else {
-        return path.resolve(inputPath);
+    // 3. 校验输入
+    if (!inputContent) {
+        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": "1.0.11",
+  "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",
@@ -31,13 +31,17 @@
     "url": "https://github.com/caol64/wenyan-cli/issues"
   },
   "dependencies": {
-    "@wenyan-md/core": "^2.0.5",
+    "@wenyan-md/core": "^2.0.8",
     "commander": "^14.0.0",
+    "express": "^5.2.1",
     "form-data-encoder": "^4.1.0",
     "formdata-node": "^6.0.3",
-    "jsdom": "^27.4.0"
+    "jsdom": "^27.4.0",
+    "multer": "^2.1.0"
   },
   "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/multer": "^2.0.0",
     "@types/node": "^24.3.0",
     "dotenv-cli": "^10.0.0",
     "tsx": "^4.21.0",
@@ -48,10 +52,12 @@
   "scripts": {
     "build": "tsc",
     "upgrade:core": "pnpm update @wenyan-md/core",
+    "server": "pnpm build && pnpm dotenv -e .env.test -- node ./dist/cli.js serve",
     "test:bin": "pnpm build && node ./dist/cli.js render -f tests/publish.md -c tests/manhua.css --no-mac-style",
     "test:cli": "vitest run tests/cli.test.ts",
     "test:render": "vitest run tests/render.test.ts",
     "test:publish": "vitest run tests/publish.test.ts",
-    "test:realPublish": "pnpm build && pnpm dotenv -e .env.test -- node ./dist/cli.js publish -f tests/publish.md -c tests/manhua.css --no-mac-style"
+    "test:realPublish": "pnpm build && pnpm dotenv -e .env.test -- node ./dist/cli.js publish -f tests/publish.md -c tests/manhua.css --no-mac-style",
+    "test:serverPublish": "pnpm build && node ./dist/cli.js publish -f tests/publish.md -c tests/manhua.css --no-mac-style --server http://localhost:3000"
   }
 }

package/dist/commands/publish.js

@@ -1,27 +0,0 @@
-import { publishToWechatDraft } from "@wenyan-md/core/publish";
-import { prepareRenderContext, runCommandWrapper } from "./render.js";
-export async function publishCommand(inputContent, options) {
-    await runCommandWrapper(async () => {
-        const { gzhContent, absoluteDirPath } = await prepareRenderContext(inputContent, options);
-        if (!gzhContent.title)
-            throw new Error("Error: 未能找到文章标题");
-        if (!gzhContent.cover)
-            throw new Error("Error: 未能找到文章封面");
-        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) {
-            console.log(`上传成功，media_id: ${data.media_id}`);
-        }
-        else {
-            console.error(`上传失败，\n${data}`);
-            process.exit(1);
-        }
-    });
-}

package/dist/commands/render.js

@@ -1,71 +0,0 @@
-import { configStore, renderStyledContent } from "@wenyan-md/core/wrapper";
-import { getNormalizeFilePath, readStdin } from "../utils.js";
-import fs from "node:fs/promises";
-import path from "node:path";
-// --- 处理输入源、文件路径和主题 ---
-export async function prepareRenderContext(inputContent, options) {
-    const { file, theme, customTheme, highlight, macStyle, footnote } = options;
-    let absoluteDirPath = undefined;
-    // 1. 尝试从 Stdin 读取
-    if (!inputContent && !process.stdin.isTTY) {
-        inputContent = await readStdin();
-    }
-    // 2. 尝试从文件读取
-    if (!inputContent && file) {
-        const normalizePath = getNormalizeFilePath(file);
-        inputContent = await fs.readFile(normalizePath, "utf-8");
-        absoluteDirPath = path.dirname(normalizePath);
-    }
-    // 3. 校验输入
-    if (!inputContent) {
-        throw new Error("Error: missing input-content (no argument, no stdin, and no file).");
-    }
-    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 Error(`Error: theme "${theme}" not found.`);
-    }
-    // 5. 执行核心渲染
-    const gzhContent = await renderStyledContent(inputContent, {
-        themeId: theme,
-        hlThemeId: highlight,
-        isMacStyle: macStyle,
-        isAddFootnote: footnote,
-        themeCss: handledCustomTheme,
-    });
-    return { gzhContent, absoluteDirPath };
-}
-// --- 统一的错误处理包装器 ---
-export async function runCommandWrapper(action) {
-    try {
-        await action();
-    }
-    catch (error) {
-        if (error instanceof Error) {
-            if (error.message.startsWith("Error:")) {
-                console.error(error.message);
-            }
-            else {
-                console.error("An unexpected error occurred:", error.message);
-            }
-        }
-        else {
-            console.error("An unexpected error occurred:", error);
-        }
-        process.exit(1);
-    }
-}
-export async function renderCommand(inputContent, options) {
-    await runCommandWrapper(async () => {
-        const { gzhContent } = await prepareRenderContext(inputContent, options);
-        console.log(gzhContent.content);
-    });
-}

package/dist/commands/theme.js

@@ -1,78 +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";
-export async function themeCommand(options) {
-    const { list, add, name, path, rm } = options;
-    if (list) {
-        listThemes();
-        return;
-    }
-    if (add) {
-        await addTheme(name, path);
-        return;
-    }
-    if (rm) {
-        await removeTheme(rm);
-        return;
-    }
-}
-function listThemes() {
-    const themes = getAllGzhThemes();
-    console.log("\n内置主题：");
-    themes.forEach((theme) => console.log(`- ${theme.meta.id}: ${theme.meta.description}`));
-    const customThemes = configStore.getThemes();
-    if (customThemes.length > 0) {
-        console.log("\n自定义主题：");
-        customThemes.forEach((theme) => {
-            console.log(`- ${theme.id}: ${theme.description ?? ""}`);
-        });
-    }
-    console.log("");
-}
-async function addTheme(name, path) {
-    if (!name || !path) {
-        console.log("❌ 添加主题时必须提供名称(name)和路径(path)\n");
-        return;
-    }
-    if (checkThemeExists(name) || checkCustomThemeExists(name)) {
-        console.log(`❌ 主题 "${name}" 已存在\n`);
-        return;
-    }
-    if (path.startsWith("http")) {
-        console.log(`⏳ 正在从远程获取主题: ${path} ...`);
-        const response = await fetch(path);
-        if (!response.ok) {
-            console.log(`❌ 无法从远程获取主题: ${response.statusText}\n`);
-            return;
-        }
-        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);
-    }
-    console.log(`✅ 主题 "${name}" 已添加\n`);
-}
-async function removeTheme(name) {
-    if (checkThemeExists(name)) {
-        console.log(`❌ 默认主题 "${name}" 不能删除\n`);
-        return;
-    }
-    if (!checkCustomThemeExists(name)) {
-        console.log(`❌ 自定义主题 "${name}" 不存在\n`);
-        return;
-    }
-    configStore.deleteThemeFromConfig(name);
-    console.log(`✅ 主题 "${name}" 已删除\n`);
-}
-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/publish.d.ts

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

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

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

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

@@ -1,2 +0,0 @@
-import { ThemeOptions } from "../types.js";
-export declare function themeCommand(options: ThemeOptions): Promise<void>;

package/dist/types/types.d.ts

@@ -1,15 +0,0 @@
-export interface RenderOptions {
-    file?: string;
-    theme?: string;
-    customTheme?: string;
-    highlight: string;
-    macStyle: boolean;
-    footnote: boolean;
-}
-export interface ThemeOptions {
-    list?: boolean;
-    add?: boolean;
-    name?: string;
-    path?: string;
-    rm?: string;
-}

package/dist/types.js

@@ -1 +0,0 @@
-export {};