@wenyan-md/cli 1.0.8 → 1.0.10

package/README.docker.md

@@ -0,0 +1,147 @@
+<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`
+
+## 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

@@ -7,165 +7,259 @@
 [![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)
 
-「文颜」是一款多平台排版美化工具，让你将 Markdown 一键发布至微信公众号、知乎、今日头条等主流写作平台。
+## 简介
 
-**文颜**现已推出多个版本：
+**[文颜（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) - CI/CD 或脚本自动化发布公众号文章
-* [MCP 版本](https://github.com/caol64/wenyan-mcp) - 让 AI 自动发布公众号文章
-* [嵌入版本](https://github.com/caol64/wenyan-core) - 将文颜的核心功能嵌入 Node 或者 Web 项目
+-   微信公众号
+-   知乎
+-   今日头条
+-   以及其它内容平台（持续扩展中）
 
-本项目是 **文颜的 CLI 版本**。
+文颜的目标是：**让写作者专注内容，而不是排版和平台适配**。
 
-## 功能
+## 文颜的不同版本
 
-* 使用内置主题对 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 自动发文
+-   [核心库](https://github.com/caol64/wenyan-core) - 嵌入 Node / Web 项目
 
-👉 [内置主题预览](https://yuzhi.tech/docs/wenyan/theme)
+## 安装方式
 
-文颜采用了多个开源的 Typora 主题，在此向各位作者表示感谢：
+### 方式一：npm（推荐）
 
-- [Orange Heart](https://github.com/evgo2017/typora-theme-orange-heart)
-- [Rainbow](https://github.com/thezbm/typora-theme-rainbow)
-- [Lapis](https://github.com/YiNNx/typora-theme-lapis)
-- [Pie](https://github.com/kevinzhao2233/typora-theme-pie)
-- [Maize](https://github.com/BEATREE/typora-maize-theme)
-- [Purple](https://github.com/hliu202/typora-purple-theme)
-- [物理猫-薄荷](https://github.com/sumruler/typora-theme-phycat)
+```bash
+npm install -g @wenyan-md/cli
+```
 
-## 安装
+安装完成后即可使用：
 
+```bash
+wenyan --help
 ```
-npm install -g @wenyan-md/cli
+
+### 方式二：Docker（无需 Node 环境）
+
+如果你不想在本地安装 Node.js，也可以直接使用 Docker。
+
+**拉取镜像**
+
+```bash
+docker pull caol64/wenyan-cli
+```
+
+**查看帮助**
+
+```bash
+docker run --rm caol64/wenyan-cli
+```
+
+**发布文章示例**
+
+```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` 主题管理
 
-某些功能（如发布到微信公众号）需要配置以下环境变量：
+## 子命令
 
-* `WECHAT_APP_ID`
-* `WECHAT_APP_SECRET`
+### `publish`
 
-### macOS / Linux
+将 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
-WECHAT_APP_ID=xxx WECHAT_APP_SECRET=yyy wenyan publish "your markdown"
+wenyan publish "# Hello, Wenyan" -t lapis -h solarized-light
 ```
 
-或在 `~/.bashrc` / `~/.zshrc` 中永久添加：
+从管道读取：
 
 ```bash
-export WECHAT_APP_ID=xxx
-export WECHAT_APP_SECRET=yyy
+cat example.md | wenyan publish -t lapis -h solarized-light --no-mac-style
 ```
 
-### Windows (PowerShell)
+从文件读取：
 
-临时设置：
+```bash
+wenyan publish -f "./example.md" -t lapis -h solarized-light --no-mac-style
+```
 
-```powershell
-$env:WECHAT_APP_ID="xxx"; $env:WECHAT_APP_SECRET="yyy"; wenyan publish "your markdown"
+### `theme`
+
+主题管理，浏览内置主题、添加/删除自定义主题。
+
+#### 参数
+
+无。
+
+#### 常用选项
+
+-   `-l`：列出所有可用主题
+-   `--add`：添加自定义主题（永久）
+    -   `--name <name>`：主题名称
+    -   `--path <path>`：主题路径（本地或网络）
+-   `--rm <name>`：删除自定义主题
+
+#### 使用示例
+
+列出可用主题：
+
+```bash
+wenyan theme -l
 ```
 
-永久设置（在环境变量里添加）：
+安装自定义主题
 
-控制面板 → 系统和安全 → 系统 → 高级系统设置 → 环境变量 → 添加 `WECHAT_APP_ID` 和 `WECHAT_APP_SECRET`。
+```bash
+wenyan theme --add --name new-theme --path https://wenyan.yuzhi.tech/manhua.css
+```
 
-## 子命令
+删除自定义主题
 
-`publish`
+```bash
+wenyan theme --rm new-theme
+```
 
-将 Markdown 转换为适配微信公众号的富文本 HTML 并上传到公众号。
+## 使用自定义主题
 
-### 参数
+你可以通过两种途径使用自定义主题：
 
-- `<input-content>`，要转换的 Markdown 内容。可直接作为参数传入，或通过管道/重定向从 `stdin` 读取
+- 不安装直接使用
 
-### 选项
+```bash
+wenyan publish -f "./example.md" -c "/path/to/theme" -h solarized-light --no-mac-style
+```
 
-- `-t`，主题id，默认`default`
-  - default
-  - orangeheart
-  - rainbow
-  - lapis
-  - pie
-  - maize
-  - purple
-  - phycat
-- `-h`，代码高亮主题，默认`solarized-light`
-  - atom-one-dark
-  - atom-one-light
-  - dracula
-  - github-dark
-  - github
-  - monokai
-  - solarized-dark
-  - solarized-light
-  - xcode
-- 代码块默认使用 Mac 风格，如要关闭：`--no-mac-style`
-- 链接默认转脚注，如要关闭：`--no-footnote`
+- 先安装再使用：
 
-## 示例
+```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
+```
 
-直接传入内容：
+区别在于，安装后的主题永久有效。
+
+## 关于图片自动上传
+
+支持以下图片来源：
+
+-   本地路径（如：`/Users/xxx/image.jpg`）
+-   网络路径（如：`https://example.com/image.jpg`）
+
+## 环境变量配置
+
+部分功能（如发布微信公众号）需要配置以下环境变量：
+
+-   `WECHAT_APP_ID`
+-   `WECHAT_APP_SECRET`
+
+### macOS / Linux
+
+临时使用：
 
 ```bash
-wenyan publish "# Hello, Wenyan" -t lapis -h solarized-light
+WECHAT_APP_ID=xxx WECHAT_APP_SECRET=yyy wenyan publish "your markdown"
 ```
 
-从文件读取：
+永久配置（推荐）：
 
 ```bash
-cat example.md | wenyan publish -t lapis -h solarized-light --no-mac-style
+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 加入公众号平台的 IP 白名单，以确保上传接口调用成功。
-详细配置说明请参考：[https://yuzhi.tech/docs/wenyan/upload](https://yuzhi.tech/docs/wenyan/upload)
+> [!IMPORTANT]
+>
+> 请确保运行文颜的机器 IP 已加入微信公众号后台的 IP 白名单，否则上传接口将调用失败。
+
+配置说明文档：[https://yuzhi.tech/docs/wenyan/upload](https://yuzhi.tech/docs/wenyan/upload)
 
-## 配置说明（Frontmatter）
+## Markdown Frontmatter 说明（必读）
 
-为了可以正确上传文章，需要在每一篇 Markdown 文章的开头添加一段`frontmatter`，提供`title`、`cover`两个字段：
+为了正确上传文章，每篇 Markdown 顶部需要包含 frontmatter：
 
 ```md
 ---
 title: 在本地跑一个大语言模型(2) - 给模型提供外部知识库
-cover: /Users/lei/Downloads/result_image.jpg
+cover: /Users/xxx/image.jpg
 ---
 ```
 
-* `title` 是文章标题，必填。
-* `cover` 是文章封面，支持本地路径和网络图片：
+字段说明：
 
-  * 如果正文有至少一张图片，可省略，此时将使用其中一张作为封面；
-  * 如果正文无图片，则必须提供 cover。
-
-## 关于图片自动上传
-
-* 支持图片路径：
-
-  * 本地路径（如：`/Users/lei/Downloads/result_image.jpg`）
-  * 网络路径（如：`https://example.com/image.jpg`）
+-   `title` 文章标题（必填）
+-   `cover` 文章封面
+    -   本地路径或网络图片
+    -   如果正文中已有图片，可省略
 
 ## 示例文章格式
 
@@ -186,7 +280,9 @@ cover: /Users/lei/Downloads/result_image.jpg
 
 ## 赞助
 
-如果您觉得不错，可以给我家猫咪买点罐头吃。[喂猫❤️](https://yuzhi.tech/sponsor)
+如果你觉得文颜对你有帮助，可以给我家猫咪买点罐头 ❤️
+
+[https://yuzhi.tech/sponsor](https://yuzhi.tech/sponsor)
 
 ## License
 

package/dist/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { createProgram } from "./index.js";
+const program = createProgram();
+program.parse(process.argv);

package/dist/commands/publish.js

@@ -1,40 +1,21 @@
-import { getGzhContent } from "@wenyan-md/core/wrapper";
 import { publishToDraft } from "@wenyan-md/core/publish";
-import { readStdin } from "../utils.js";
+import { prepareRenderContext, runCommandWrapper } from "./render.js";
 export async function publishCommand(inputContent, options) {
-    try {
-        if (!inputContent) {
-            if (process.stdin.isTTY) {
-                console.error("Error: missing input-content (no argument and no stdin).");
-                process.exit(1);
-            }
-            inputContent = await readStdin();
-        }
-        const gzhContent = await getGzhContent(inputContent, options["theme"], options["highlight"], options["macStyle"], options["footnote"]);
-        if (!gzhContent.title) {
-            console.error("未能找到文章标题");
-            process.exit(1);
-        }
-        if (!gzhContent.cover) {
-            console.error("未能找到文章封面");
-            process.exit(1);
-        }
-        const data = await publishToDraft(gzhContent.title, gzhContent.content, gzhContent.cover);
+    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 publishToDraft(gzhContent.title, gzhContent.content, gzhContent.cover, {
+            relativePath: absoluteDirPath,
+        });
         if (data.media_id) {
             console.log(`上传成功，media_id: ${data.media_id}`);
         }
         else {
             console.error(`上传失败，\n${data}`);
+            process.exit(1);
         }
-    }
-    catch (error) {
-        if (error instanceof Error) {
-            console.error("An unexpected error occurred during publishing:");
-            console.error(error.message);
-        }
-        else {
-            console.error("An unexpected error occurred:", error);
-        }
-        process.exit(1);
-    }
+    });
 }

package/dist/commands/render.js

@@ -1,22 +1,61 @@
-import { getGzhContent } from "@wenyan-md/core/wrapper";
-import { readStdin } from "../utils.js";
-export async function renderCommand(inputContent, options) {
+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 {
-        if (!inputContent) {
-            if (process.stdin.isTTY) {
-                console.error("Error: missing input-content (no argument and no stdin).");
-                process.exit(1);
-            }
-            inputContent = await readStdin();
-        }
-        const gzhContent = await getGzhContent(inputContent, options["theme"], options["highlight"], options["macStyle"], options["footnote"]);
-        console.log(gzhContent.content);
-        // process.exit(0);
+        await action();
     }
     catch (error) {
         if (error instanceof Error) {
-            console.error("An unexpected error occurred during publishing:");
-            console.error(error.message);
+            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);
@@ -24,3 +63,9 @@ export async function renderCommand(inputContent, options) {
         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

@@ -0,0 +1,78 @@
+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/index.js

@@ -2,35 +2,42 @@ import { Command } from "commander";
 import { publishCommand } from "./commands/publish.js";
 import { renderCommand } from "./commands/render.js";
 import pkg from "../package.json" with { type: "json" };
-const program = new Command();
-program
-    .name("wenyan")
-    .description("A CLI for WenYan Markdown Render.")
-    .version(pkg.version, "-v, --version", "output the current version")
-    .action(() => {
-    program.outputHelp();
-    return;
-});
-program
-    .command("publish")
-    .description("Render a markdown file to styled HTML and publish to wechat GZH")
-    .argument("[input-content]", "content of the input markdown 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("--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")
-    .action(publishCommand);
-program
-    .command("render")
-    .description("Render a markdown file to styled HTML")
-    .argument("[input-content]", "content of the input markdown 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("--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")
-    .action(renderCommand);
-program.parse();
+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;
+}

package/dist/types/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

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

@@ -1,8 +1,2 @@
-interface RenderOptions {
-    output?: string;
-    theme: string;
-    highlight: string;
-    macStyle: boolean;
-}
-export declare function publishCommand(inputContent: string, options: RenderOptions): Promise<void>;
-export {};
+import { RenderOptions } from "../types.js";
+export declare function publishCommand(inputContent: string | undefined, options: RenderOptions): Promise<void>;

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

@@ -1,8 +1,7 @@
-interface RenderOptions {
-    output?: string;
-    theme: string;
-    highlight: string;
-    macStyle: boolean;
-}
+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>;
-export {};

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

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

package/dist/types/index.d.ts

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

package/dist/types/types.d.ts

@@ -0,0 +1,15 @@
+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/utils.d.ts

@@ -1 +1,2 @@
 export declare function readStdin(): Promise<string>;
+export declare function getNormalizeFilePath(inputPath: string): string;

package/dist/types.js

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

package/dist/utils.js

@@ -1,3 +1,4 @@
+import path from "node:path";
 export async function readStdin() {
     return new Promise((resolve, reject) => {
         let data = "";
@@ -7,3 +8,29 @@ 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;
+    }
+    else {
+        return path.resolve(inputPath);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wenyan-md/cli",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "A CLI tool for Wenyan markdown rendering & publishing",
   "author": "Lei <caol64@gmail.com> (https://github.com/caol64)",
   "license": "Apache-2.0",
@@ -15,13 +15,12 @@
   ],
   "type": "module",
   "bin": {
-    "wenyan": "./bin/cli.js"
+    "wenyan": "./dist/cli.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/types/index.d.ts",
   "files": [
-    "dist",
-    "bin"
+    "dist"
   ],
   "homepage": "https://github.com/caol64/wenyan-cli#readme",
   "repository": {
@@ -32,20 +31,27 @@
     "url": "https://github.com/caol64/wenyan-cli/issues"
   },
   "dependencies": {
-    "@wenyan-md/core": "^1.0.14",
-    "commander": "^14.0.0"
+    "@wenyan-md/core": "^2.0.2",
+    "commander": "^14.0.0",
+    "form-data-encoder": "^4.1.0",
+    "formdata-node": "^6.0.3",
+    "jsdom": "^27.4.0"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
     "dotenv-cli": "^10.0.0",
-    "tsx": "^4.20.5",
-    "typescript": "^5.9.2"
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.2",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.18"
   },
   "scripts": {
     "build": "tsc",
-    "dev": "tsx src/index.ts",
     "upgrade:core": "pnpm update @wenyan-md/core",
-    "test:render": "pnpm build && cat test/publish.md | node ./bin/cli.js render",
-    "test:publish": "pnpm build && cat test/publish.md | pnpm dotenv -e .env.test -- node ./bin/cli.js publish -t lapis"
+    "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"
   }
 }

package/bin/cli.js

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-
-import { fileURLToPath, pathToFileURL } from 'url';
-import { dirname, join } from 'path';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const mainModulePath = join(__dirname, "..", "dist", 'index.js');
-
-import(pathToFileURL(mainModulePath).href);