wenyan-md-cli-evlon 1.0.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.docker.md

@@ -0,0 +1,178 @@
+<div align="center">
+  <img alt="logo" src="https://raw.githubusercontent.com/caol64/wenyan/main/Data/256-mac.png" width="120" />
+</div>
+
+# wenyan-cli (Docker)
+
+**Render Markdown to beautifully styled articles and publish to content platforms — powered by Docker.**
+
+> This image bundles **wenyan CLI** and all required runtime dependencies.
+> No local Node.js or npm environment required.
+
+## Quick Start
+
+### Pull image
+
+```bash
+docker pull caol64/wenyan-cli
+```
+
+### Show help
+
+```bash
+docker run --rm caol64/wenyan-cli --help
+```
+
+## Basic Usage
+
+Render and publish a Markdown file to WeChat Official Account draft box:
+
+```bash
+docker run --rm \
+  --env-file .env \
+  -e HOST_FILE_PATH=$(pwd) \
+  -v $(pwd):/mnt/host-downloads \
+  caol64/wenyan-cli \
+  publish -f ./article.md
+```
+
+Render Markdown content directly:
+
+```bash
+docker run --rm caol64/wenyan-cli \
+  render "# Hello Wenyan"
+```
+
+## Working with Local Files (Recommended)
+
+When using local Markdown or image files, mount the current directory:
+
+```bash
+docker run --rm \
+  -e HOST_FILE_PATH=$(pwd) \
+  -v $(pwd):/mnt/host-downloads \
+  caol64/wenyan-cli \
+  publish -f ./example.md
+```
+
+**How it works:**
+
+| Path                  | Description                   |
+| --------------------- | ----------------------------- |
+| `HOST_FILE_PATH`      | Absolute path on host machine |
+| `/mnt/host-downloads` | Mounted path inside container |
+
+All file paths in Markdown (cover / images) should reference host paths.
+
+## Input Methods
+
+`publish` supports **exactly one** input source:
+
+-   `-f <file>` — read Markdown from local file
+-   `<input-content>` — inline Markdown string
+-   `stdin` — pipe from another command
+
+Examples:
+
+```bash
+cat article.md | docker run --rm -i caol64/wenyan-cli render
+```
+
+```bash
+docker run --rm caol64/wenyan-cli render "# Title"
+```
+
+## Options
+
+Commonly used options:
+
+-   `-t, --theme` — theme ID (default: `default`)
+-   `-h, --highlight` — code highlight theme
+-   `--no-mac-style` — disable macOS-style code blocks
+-   `--no-footnote` — disable link-to-footnote conversion
+
+## Markdown Frontmatter (Required)
+
+Each Markdown file must include frontmatter:
+
+```md
+---
+title: My Article Title
+cover: /absolute/path/to/cover.jpg
+---
+```
+
+-   `title` — article title (required)
+-   `cover` — optional cover image (local or remote)
+
+## Environment Variables
+
+Publishing to WeChat requires:
+
+-   `WECHAT_APP_ID`
+-   `WECHAT_APP_SECRET`
+
+Recommended usage with `.env` file:
+
+```env
+WECHAT_APP_ID=xxx
+WECHAT_APP_SECRET=yyy
+```
+
+## Image Details
+
+-   Entrypoint: `wenyan`
+-   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
+
+### Tip
+
+For frequent usage, create an alias:
+
+```bash
+alias wenyan='docker run --rm \
+  -e HOST_FILE_PATH=$(pwd) \
+  -v $(pwd):/mnt/host-downloads \
+  caol64/wenyan-cli'
+```
+
+Then use it like a native CLI:
+
+```bash
+wenyan publish -f article.md
+```

package/README.md

@@ -0,0 +1,171 @@
+<div align="center">
+    <img alt="logo" src="https://raw.githubusercontent.com/caol64/wenyan/main/Data/256-mac.png" width="128" />
+</div>
+
+# 文颜 CLI
+
+[![npm](https://img.shields.io/npm/v/@wenyan-md/cli)](https://www.npmjs.com/package/@wenyan-md/cli)
+[![License](https://img.shields.io/github/license/caol64/wenyan-cli)](LICENSE)
+![NPM Downloads](https://img.shields.io/npm/dm/%40wenyan-md%2Fcli)
+[![Docker Pulls](https://img.shields.io/docker/pulls/caol64/wenyan-cli)](https://hub.docker.com/r/caol64/wenyan-cli)
+[![Stars](https://img.shields.io/github/stars/caol64/wenyan-cli?style=social)](https://github.com/caol64/wenyan-cli)
+
+## 简介
+
+**[文颜（Wenyan）](https://wenyan.yuzhi.tech)** 是一款多平台 Markdown 排版与发布工具，支持将 Markdown 一键转换并发布至：
+
+-   微信公众号
+-   知乎
+-   今日头条
+-   以及其它内容平台（持续扩展中）
+
+文颜的目标是：**让写作者专注内容，而不是排版和平台适配**。
+
+## 文颜的不同版本
+
+文颜目前提供多种形态，覆盖不同使用场景：
+
+-   [macOS App Store 版](https://github.com/caol64/wenyan) - MAC 桌面应用
+-   [跨平台桌面版](https://github.com/caol64/wenyan-pc) - Windows/Linux
+-   👉[CLI 版本](https://github.com/caol64/wenyan-cli) - 本项目
+-   [MCP 版本](https://github.com/caol64/wenyan-mcp) - AI 自动发文
+
+## 特性
+
+- 一键发布 Markdown 到微信公众号草稿箱
+- 自动上传本地图片与封面
+- 支持远程 Server 发布（绕过 IP 白名单限制）
+- 内置多套精美排版主题
+- 支持自定义主题
+- 可作为 CI/CD 自动发文工具
+- 可集成 AI Agent 自动发布
+
+## 快速开始
+
+```bash
+# 安装
+npm install -g @wenyan-md/cli
+# 发布文章到公众号
+wenyan publish -f article.md
+```
+
+## 命令概览
+
+```bash
+wenyan <command> [options]
+```
+
+| 命令      | 说明        |
+| ------- | --------- |
+| [publish](docs/publish.md) | 发布文章      |
+| render  | 渲染 HTML   |
+| [theme](docs/theme.md)   | 管理主题      |
+| [serve](docs/server.md)   | 启动 Server |
+
+## 概念
+
+### 内容输入
+
+内容输入是指如何把 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，脚本批量发布      |
+
+### 环境变量配置
+
+> [!IMPORTANT]
+>
+> 请确保运行文颜的机器已配置如下环境变量，否则上传接口将调用失败。
+
+-   `WECHAT_APP_ID`
+-   `WECHAT_APP_SECRET`
+
+### 微信公众号 IP 白名单
+
+> [!IMPORTANT]
+>
+> 请确保运行文颜的机器 IP 已加入微信公众号后台的 IP 白名单，否则上传接口将调用失败。
+
+配置说明文档：[https://yuzhi.tech/docs/wenyan/upload](https://yuzhi.tech/docs/wenyan/upload)
+
+### 文章格式
+
+为了正确上传文章，每篇 Markdown 顶部需要包含一段 `frontmatter`：
+
+```md
+---
+title: 在本地跑一个大语言模型(2) - 给模型提供外部知识库
+cover: /Users/xxx/image.jpg
+author: xxx
+source_url: http://
+---
+```
+
+字段说明：
+
+-   `title` 文章标题（必填）
+-   `cover` 文章封面
+    -   本地路径或网络图片
+    -   如果正文中已有图片，可省略
+-   `author` 文章作者
+-   `source_url` 原文地址
+
+**[示例文章](tests/publish.md)**
+
+### 文内图片和文章封面
+
+把文章发布到公众号之前，文颜会按照微信要求自动处理文章内的所有图片，将其上传到公众号素材库。目前文颜对于以下两种图片都能很好的支持：
+
+- 本地硬盘绝对路径（如：`/Users/xxx/image.jpg`）
+- 网络路径（如：`https://example.com/image.jpg`）
+
+仅当“内容输入”方式为“本地路径”时，以下路径也能完美支持：
+
+- 当前文章的相对路径（如：`./assets/image.png`）
+
+## Server 模式
+
+相较于纯本地运行的**本地模式（Local Mode）**，`wenyan-cli`还提供了 **远程客户端模式（Client–Server Mode）**。两种模式运行效果完全一致，你可以根据运行环境和网络条件选择最合适的方式。
+
+在本地模式下，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)**
+
+客户端调用 Server 发布：
+
+```bash
+wenyan publish -f article.md --server https://api.example.com --api-key your-api-key
+```
+
+## 赞助
+
+如果你觉得文颜对你有帮助，可以给我家猫咪买点罐头 ❤️
+
+[https://yuzhi.tech/sponsor](https://yuzhi.tech/sponsor)
+
+## License
+
+Apache License Version 2.0

package/dist/cli.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+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")
+        .option("--app-id [id]", "WeChat ID to publish to</id>, if not specified, will use the env variable WECHAT_APP_ID")
+        .option("--app-secret [secret]", "WeChat Secret to publish to</secret>, if not specified, will use the env variable WECHAT_APP_SECRET")
+        .action(async (inputContent, options) => {
+        await runCommandWrapper(async () => {
+            // 如果传入了 --server，则走客户端（远程）模式
+            if (options.server) {
+                if (!options.appId) {
+                    options.appId = process.env.WECHAT_APP_ID;
+                }
+                if (!options.appSecret) {
+                    options.appSecret = process.env.WECHAT_APP_SECRET;
+                }
+                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);
+    }
+}
+export const program = createProgram();
+if (import.meta.main) {
+    program.parse(process.argv);
+}

package/dist/commands/serve.js

@@ -0,0 +1,228 @@
+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/wrapper";
+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,
+        }, {
+            appId: body.appId,
+            appSecret: body.appSecret
+        });
+        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

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

package/dist/types/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+export declare function createProgram(version?: string): Command;
+export declare const program: 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

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

package/dist/types/utils.d.ts

@@ -0,0 +1,6 @@
+export declare function readStdin(): Promise<string>;
+export declare function readStream(stream: NodeJS.ReadableStream): Promise<string>;
+export declare function getInputContent(inputContent?: string, file?: string): Promise<{
+    content: string;
+    absoluteDirPath: string | undefined;
+}>;

package/dist/utils.js

@@ -0,0 +1,48 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { getNormalizeFilePath } from "@wenyan-md/core/wrapper";
+export function readStdin() {
+    return readStream(process.stdin);
+}
+export async function readStream(stream) {
+    return new Promise((resolve, reject) => {
+        let data = "";
+        stream.setEncoding?.("utf8");
+        const onData = (chunk) => (data += chunk);
+        const onEnd = () => {
+            cleanup();
+            resolve(data);
+        };
+        const onError = (err) => {
+            cleanup();
+            reject(err);
+        };
+        const cleanup = () => {
+            stream.removeListener("data", onData);
+            stream.removeListener("end", onEnd);
+            stream.removeListener("error", onError);
+        };
+        stream.on("data", onData);
+        stream.on("end", onEnd);
+        stream.on("error", onError);
+        stream.resume?.();
+    });
+}
+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);
+    }
+    // 3. 校验输入
+    if (!inputContent) {
+        throw new Error("missing input-content (no argument, no stdin, and no file).");
+    }
+    return { content: inputContent, absoluteDirPath };
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "wenyan-md-cli-evlon",
+  "version": "1.0.0",
+  "description": "A CLI tool for Wenyan markdown rendering & publishing",
+  "author": "Lei <caol64@gmail.com> (https://github.com/caol64)",
+  "license": "Apache-2.0",
+  "keywords": [
+    "公众号",
+    "markdown",
+    "文颜",
+    "wenyan",
+    "wechat",
+    "publishing",
+    "renderer"
+  ],
+  "type": "module",
+  "bin": {
+    "wenyan": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "homepage": "https://github.com/caol64/wenyan-cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caol64/wenyan-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/caol64/wenyan-cli/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "upgrade:core": "pnpm update @wenyan-md/core",
+    "prepublishOnly": "pnpm upgrade:core && pnpm build",
+    "test": "node --import tsx --test",
+    "test:watch": "node --import tsx --test --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --fix",
+    "test:bin": "pnpm build && node ./dist/cli.js render -f tests/publish.md -c tests/manhua.css --no-mac-style",
+    "test:realPublish": "pnpm build && node --env-file=.env.test ./dist/cli.js publish -f tests/publish.md -t phycat",
+    "test:serverPublish": "pnpm build && node --env-file=.env.test ./dist/cli.js publish -f tests/publish.md -c tests/manhua.css --no-mac-style --server http://localhost:3000",
+    "test:serve": "pnpm build && node --env-file=.env.test ./dist/cli.js serve"
+  },
+  "packageManager": "pnpm@10.7.1",
+  "dependencies": {
+    "@wenyan-md/core": "npm:evlon-wenyan-md-core@^3.0.3",
+    "commander": "^14.0.0",
+    "express": "^5.2.1",
+    "form-data-encoder": "^4.1.0",
+    "formdata-node": "^6.0.3",
+    "jsdom": "^27.4.0",
+    "multer": "^2.1.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/express": "^5.0.6",
+    "@types/multer": "^2.0.0",
+    "@types/node": "^24.3.0",
+    "eslint": "^10.1.0",
+    "globals": "^17.4.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.58.0"
+  }
+}