---
title: 命令行工具（CLI）
description: Welight CLI（wl）安装、首次配置与快速上手：渲染、一键排版、发布与 AI 助手。
---

`Welight CLI` 是 `Welight` 的命令行版本，命令为 `wl`（与 `welight` 完全等效）。它复用了桌面端同一套 Markdown 渲染与主题内核，去掉了图形编辑器与官方托管服务，面向习惯命令行、需要脚本化与自动化的创作者。

CLI 完全免费、开源（MIT），并且**全部 BYOK**：模型、判断层与各类云服务都使用您自己的密钥。桌面端从 6.0.7 起另有一池共享 tokens，只供还不熟悉自备密钥的人过渡，命令行工具不使用该额度。

:::tip
CLI 与桌面端共用渲染与主题，因此同一主题下的排版效果一致。桌面端提供编辑器、完整主题库与官方服务，CLI 则专注命令行与自动化场景，二者互补。
:::

## 安装

CLI 通过 npm 分发，要求 **Node.js `>= 20.19.5`**。

```bash
# 全局安装
npm install -g welight

# 免安装运行
npx welight --help
pnpm dlx welight --help
```

安装后 `wl` 与 `welight` 均可使用。直接运行 `wl` 会显示启动页（左侧命令导航，右侧产品 Logo）。若系统中已有别的 `wl` 命令，安装后可能需要调整 `PATH` 优先级。

![image-20260921102813427](https://img.xuyi.dev/2026/09/f62d801add4342b8fb91acad2f91d93e.png)

> 开源仓库：[github.com/08820048/welight-cli](https://github.com/08820048/welight-cli)

## 首次配置

CLI 不内置任何官方服务，首次使用请先完成配置。最省事的是**配置向导**：

```bash
wl setup
```

向导会逐步引导您配置模型、TypeSafe 判断层、朱雀检测与公众号等，密钥在本地输入（不回显、不上传）。如果您只想先配模型：

```bash
wl model
```

也可以完全用命令式配置，详见[配置与密钥](/cli/configuration)。

## 常用命令一览

```bash
wl render post.md                 # 选主题渲染 HTML，自动写文件并在浏览器打开
wl layout post.md --in-place      # 一键排版（AI 重排文章结构）
wl copy post.md                   # 生成公众号内联 HTML 并复制到剪贴板
wl publish post.md --cover a.png  # 发布到公众号草稿箱
wl lint post.md --fail-on high    # 公众号规则检查（可作 CI 门禁）
wl chat                           # 打开 Welight AI 对话
wl doctor                         # 查看配置与密钥状态
```

![image-20260921103045433](https://img.xuyi.dev/2026/09/3b1837d71f2c1ce4432b40b60d68cf68.png)

完整命令列表见[命令参考](/cli/commands)。

## 与桌面端的区别

| | 桌面端 | CLI |
| --- | --- | --- |
| 编辑器 / 实时预览 | ✅ | ❌ |
| 一键排版 | ✅ | ✅（`wl layout`） |
| 主题库 | 全部主题 | 前 45%（当前 13 套） |
| CSS 主题编辑 | ✅ | ❌ |
| 复制 / 发布公众号草稿 | ✅ | ✅ |
| 公众号图床 | ✅ | ✅ |
| 规则检查 / 朱雀检测 / 标题推荐 / Welight AI | ✅ | ✅（BYOK） |
| 微信 API 代理 | 官方固定出口 | 需自行解决出口 IP |
| 其他图床 | ✅ | ❌ |

:::note
CLI 直连 `api.weixin.qq.com`，不提供官方代理。发布前需要把当前网络出口 IP 加入公众号后台的白名单，详见[自动化与集成](/cli/automation)。
:::