xhscover-cli

小红书封面生成命令行工具。支持 npm 安装或零依赖 bash 脚本。

安装

npm（推荐，跨平台）

# 直接使用，无需安装
npx xhscover setup

# 或全局安装
npm install -g xhscover
xhscover setup

需要 Node.js >= 18。

bash 脚本（macOS/Linux）

curl -sL https://raw.githubusercontent.com/xwchris/xhscover-cli/main/xhscover -o /usr/local/bin/xhscover
chmod +x /usr/local/bin/xhscover
xhscover setup

快速开始

# 首次使用：交互式注册/登录（注册即获 10 个免费积分）
xhscover setup

# 生成封面
xhscover generate "5个习惯让你越来越自律"

setup 会引导你注册或登录，API Key 自动保存到 ~/.xhscover，后续无需再配置。

命令

xhscover setup                      # 首次配置（注册或登录）
xhscover register                   # 注册新账号
xhscover login                      # 登录已有账号
xhscover generate <文案> [宽高比]   # 生成封面
xhscover balance                    # 查询积分余额
xhscover history [数量]             # 获取生成历史
xhscover help                       # 显示帮助

配置

API Key 保存在 ~/.xhscover，setup/register/login 命令会自动写入。

也可以通过环境变量配置（优先级高于配置文件）：

export XHS_COVER_API_KEY="xhs_your_api_key"
export XHS_COVER_API_URL="https://api.xhscover.cn"  # 可选

宽高比

| 比例 | 说明 | |------|------| | 3:4 | 小红书标准竖版（默认） | | 9:16 | 超长竖版 | | 1:1 | 正方形 | | 16:9 | 横版 |

示例

xhscover generate "5个习惯让你越来越自律"
xhscover generate "今日份好心情" 1:1
xhscover "这是封面文案"          # 快捷方式
xhscover balance
xhscover history 20

在 AI Agent 中使用

本工具可作为 Claude Code Skill 的后端，用户在 Skill 中首次使用时会自动引导配置：

# Skill 检测到未配置时自动运行
xhscover setup

# Skill 生成封面
xhscover generate "$文案" "$宽高比"
xhscover balance

配置一次即可持续使用，支持 npx 零安装调用。

相关链接

• 官网：https://xhscover.cn
• API 文档：https://xhscover.cn/docs
• MCP Server：https://github.com/xwchris/xhs-cover-mcp
• Skill：https://github.com/xwchris/xhs-cover-skill

License

MIT