命令行工具（CLI）

Welight CLI（wl）安装、首次配置与快速上手：渲染、一键排版、发布与 AI 助手。

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

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

安装

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

# 全局安装
npm install -g welight

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

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

开源仓库：github.com/08820048/welight-cli

首次配置

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

wl setup

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

wl model

也可以完全用命令式配置，详见配置与密钥。

常用命令一览

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                         # 查看配置与密钥状态

完整命令列表见命令参考。

与桌面端的区别