@wenyan-md/cli 1.0.9 → 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,11 +7,12 @@
 [![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）** 是一款多平台 Markdown 排版与发布工具，支持将 Markdown 一键转换并发布至：
+**[文颜（Wenyan）](https://wenyan.yuzhi.tech)** 是一款多平台 Markdown 排版与发布工具，支持将 Markdown 一键转换并发布至：
 
 -   微信公众号
 -   知乎
@@ -20,13 +21,6 @@
 
 文颜的目标是：**让写作者专注内容，而不是排版和平台适配**。
 
-本仓库是 **文颜的 CLI 版本**，适合以下场景：
-
--   命令行使用
--   CI / CD 自动化发布
--   脚本或工具链集成
--   与 AI / MCP 系统联动自动发文
-
 ## 文颜的不同版本
 
 文颜目前提供多种形态，覆盖不同使用场景：
@@ -37,28 +31,6 @@
 -   [MCP 版本](https://github.com/caol64/wenyan-mcp) - AI 自动发文
 -   [核心库](https://github.com/caol64/wenyan-core) - 嵌入 Node / Web 项目
 
-## 功能特性
-
--   使用内置主题对 Markdown 内容排版
--   自动处理并上传图片（本地 / 网络）
--   支持数学公式（MathJax）
--   一键发布文章到微信公众号草稿箱
--   支持 CI / 自动化流程调用
-
-## 主题效果预览
-
-👉 [内置主题预览](https://yuzhi.tech/docs/wenyan/theme)
-
-文颜内置并适配了多个优秀的 Typora 主题，在此感谢原作者：
-
--   [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)
-
 ## 安装方式
 
 ### 方式一：npm（推荐）
@@ -114,51 +86,18 @@ CLI 主命令：
 wenyan <command> [options]
 ```
 
-目前最常用的子命令是 `publish`。
-
-## 环境变量配置
-
-部分功能（如发布微信公众号）需要配置以下环境变量：
-
--   `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`。
+目前支持的子命令有
+- `publish` 排版并发布到公众号草稿箱
+- `render` 仅排版，用做测试
+- `theme` 主题管理
 
 ## 子命令
 
-`publish`
+### `publish`
 
 将 Markdown 转换为适配微信公众号的富文本 HTML，并上传到草稿箱。
 
-### 参数
+#### 参数
 
 -   `<input-content>`
 
@@ -167,17 +106,18 @@ wenyan publish example.md
     -   直接作为参数传入
     -   通过 stdin 管道输入
 
-### 常用选项
+#### 常用选项
 
--   `-t`：主题（默认 `default`）
-    -   default / orangeheart / rainbow / lapis / pie / maize / purple / phycat
--   `-h`：代码高亮主题（默认 `solarized-light`）
+-   `-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`：指定本地 Markdown 文件路径
+-   `-f <path>`：指定本地 Markdown 文件路径
+-   `-c <path>`：指定临时自定义主题路径，优先级大于`-t`
 
-## 使用示例
+#### 使用示例
 
 直接传入内容：
 
@@ -197,23 +137,60 @@ cat example.md | wenyan publish -t lapis -h solarized-light --no-mac-style
 wenyan publish -f "./example.md" -t lapis -h solarized-light --no-mac-style
 ```
 
-## Markdown Frontmatter 说明（必读）
+### `theme`
 
-为了正确上传文章，每篇 Markdown 顶部需要包含 frontmatter：
+主题管理，浏览内置主题、添加/删除自定义主题。
 
-```md
----
-title: 在本地跑一个大语言模型(2) - 给模型提供外部知识库
-cover: /Users/xxx/image.jpg
----
+#### 参数
+
+无。
+
+#### 常用选项
+
+-   `-l`：列出所有可用主题
+-   `--add`：添加自定义主题（永久）
+    -   `--name <name>`：主题名称
+    -   `--path <path>`：主题路径（本地或网络）
+-   `--rm <name>`：删除自定义主题
+
+#### 使用示例
+
+列出可用主题：
+
+```bash
+wenyan theme -l
 ```
 
-字段说明：
+安装自定义主题
 
--   `title` 文章标题（必填）
--   `cover` 文章封面
-    -   本地路径或网络图片
-    -   如果正文中已有图片，可省略
+```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
+```
+
+- 先安装再使用：
+
+```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
+```
+
+区别在于，安装后的主题永久有效。
 
 ## 关于图片自动上传
 
@@ -222,14 +199,68 @@ cover: /Users/xxx/image.jpg
 -   本地路径（如：`/Users/xxx/image.jpg`）
 -   网络路径（如：`https://example.com/image.jpg`）
 
+## 环境变量配置
+
+部分功能（如发布微信公众号）需要配置以下环境变量：
+
+-   `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 白名单
 
-> ⚠️ 重要
+> [!IMPORTANT]
 >
 > 请确保运行文颜的机器 IP 已加入微信公众号后台的 IP 白名单，否则上传接口将调用失败。
 
 配置说明文档：[https://yuzhi.tech/docs/wenyan/upload](https://yuzhi.tech/docs/wenyan/upload)
 
+## Markdown Frontmatter 说明（必读）
+
+为了正确上传文章，每篇 Markdown 顶部需要包含 frontmatter：
+
+```md
+---
+title: 在本地跑一个大语言模型(2) - 给模型提供外部知识库
+cover: /Users/xxx/image.jpg
+---
+```
+
+字段说明：
+
+-   `title` 文章标题（必填）
+-   `cover` 文章封面
+    -   本地路径或网络图片
+    -   如果正文中已有图片，可省略
+
 ## 示例文章格式
 
 ```md

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,35 +1,12 @@
-import { getGzhContent } from "@wenyan-md/core/wrapper";
 import { publishToDraft } from "@wenyan-md/core/publish";
-import { getNormalizeFilePath, readStdin } from "../utils.js";
-import fs from "node:fs/promises";
-import path from "node:path";
+import { prepareRenderContext, runCommandWrapper } from "./render.js";
 export async function publishCommand(inputContent, options) {
-    try {
-        const { file } = options;
-        let absoluteDirPath = undefined;
-        if (!inputContent) {
-            if (!process.stdin.isTTY) {
-                inputContent = await readStdin();
-            }
-        }
-        if (!inputContent && file) {
-            const normalizePath = getNormalizeFilePath(file);
-            inputContent = await fs.readFile(normalizePath, "utf-8");
-            absoluteDirPath = path.dirname(normalizePath);
-        }
-        if (!inputContent) {
-            console.error("Error: missing input-content (no argument, no stdin, and no file).");
-            process.exit(1);
-        }
-        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);
-        }
+    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,
         });
@@ -38,16 +15,7 @@ export async function publishCommand(inputContent, options) {
         }
         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,30 +1,61 @@
-import { getGzhContent } from "@wenyan-md/core/wrapper";
+import { configStore, renderStyledContent } from "@wenyan-md/core/wrapper";
 import { getNormalizeFilePath, readStdin } from "../utils.js";
 import fs from "node:fs/promises";
-export async function renderCommand(inputContent, options) {
+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 {
-        const { file } = options;
-        if (!inputContent) {
-            if (!process.stdin.isTTY) {
-                inputContent = await readStdin();
-            }
-        }
-        if (!inputContent && file) {
-            const normalizePath = getNormalizeFilePath(file);
-            inputContent = await fs.readFile(normalizePath, "utf-8");
-        }
-        if (!inputContent) {
-            console.error("Error: missing input-content (no argument, no stdin, and no file).");
-            process.exit(1);
-        }
-        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);
@@ -32,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,37 +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]", "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("--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]", "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("--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,9 +1,2 @@
-interface RenderOptions {
-    file?: string;
-    theme: string;
-    highlight: string;
-    macStyle: boolean;
-    footnote: boolean;
-}
+import { RenderOptions } from "../types.js";
 export declare function publishCommand(inputContent: string | undefined, options: RenderOptions): Promise<void>;
-export {};

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

@@ -1,9 +1,7 @@
-interface RenderOptions {
-    file?: string;
-    theme: string;
-    highlight: string;
-    macStyle: boolean;
-    footnote: 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.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wenyan-md/cli",
-  "version": "1.0.9",
+  "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.17",
-    "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 && node ./bin/cli.js render -f test/publish.md",
-    "test:publish": "pnpm build && pnpm dotenv -e .env.test -- node ./bin/cli.js publish -f test/publish.md -t phycat"
+    "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);