xhscover 2.0.0

package/README.md

@@ -0,0 +1,106 @@
+# xhscover-cli
+
+小红书封面生成命令行工具。支持 npm 安装或零依赖 bash 脚本。
+
+## 安装
+
+### npm（推荐，跨平台）
+
+```bash
+# 直接使用，无需安装
+npx xhscover setup
+
+# 或全局安装
+npm install -g xhscover
+xhscover setup
+```
+
+需要 Node.js >= 18。
+
+### bash 脚本（macOS/Linux）
+
+```bash
+curl -sL https://raw.githubusercontent.com/xwchris/xhscover-cli/main/xhscover -o /usr/local/bin/xhscover
+chmod +x /usr/local/bin/xhscover
+xhscover setup
+```
+
+## 快速开始
+
+```bash
+# 首次使用：交互式注册/登录（注册即获 10 个免费积分）
+xhscover setup
+
+# 生成封面
+xhscover generate "5个习惯让你越来越自律"
+```
+
+`setup` 会引导你注册或登录，API Key 自动保存到 `~/.xhscover`，后续无需再配置。
+
+## 命令
+
+```bash
+xhscover setup                      # 首次配置（注册或登录）
+xhscover register                   # 注册新账号
+xhscover login                      # 登录已有账号
+xhscover generate <文案> [宽高比]   # 生成封面
+xhscover balance                    # 查询积分余额
+xhscover history [数量]             # 获取生成历史
+xhscover help                       # 显示帮助
+```
+
+## 配置
+
+API Key 保存在 `~/.xhscover`，`setup`/`register`/`login` 命令会自动写入。
+
+也可以通过环境变量配置（优先级高于配置文件）：
+
+```bash
+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` | 横版 |
+
+## 示例
+
+```bash
+xhscover generate "5个习惯让你越来越自律"
+xhscover generate "今日份好心情" 1:1
+xhscover "这是封面文案"          # 快捷方式
+xhscover balance
+xhscover history 20
+```
+
+## 在 AI Agent 中使用
+
+本工具可作为 Claude Code Skill 的后端，用户在 Skill 中首次使用时会自动引导配置：
+
+```bash
+# 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

package/bin/xhscover.js

@@ -0,0 +1,367 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync, existsSync, chmodSync } from 'node:fs';
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+import { homedir } from 'node:os';
+
+// ==================== 配置 ====================
+
+const API_URL = process.env.XHS_COVER_API_URL || 'https://api.xhscover.cn';
+const CONFIG_FILE = join(homedir(), '.xhscover');
+
+const SUPABASE_URL = 'https://oeacweghghyvmygiknlo.supabase.co';
+const SUPABASE_ANON_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Im9lYWN3ZWdoZ2h5dm15Z2lrbmxvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI0ODkzNDMsImV4cCI6MjA4ODA2NTM0M30.vM-YVckmdBKNLYlrceKAajLpoMdZWKX3onkWHJzGAyg';
+
+// ==================== 工具函数 ====================
+
+const colors = {
+  red: (s) => `\x1b[0;31m${s}\x1b[0m`,
+  green: (s) => `\x1b[0;32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[1;33m${s}\x1b[0m`,
+  cyan: (s) => `\x1b[0;36m${s}\x1b[0m`,
+  bold: (s) => `\x1b[1m${s}\x1b[0m`,
+};
+
+function error(msg) {
+  console.error(colors.red(`错误: ${msg}`));
+  process.exit(1);
+}
+
+function success(msg) {
+  console.log(colors.green(msg));
+}
+
+function info(msg) {
+  console.log(msg);
+}
+
+function prompt(msg) {
+  process.stderr.write(colors.cyan(msg));
+}
+
+// 交互式输入
+function ask(question, { hidden = false } = {}) {
+  return new Promise((resolve) => {
+    const rl = createInterface({
+      input: process.stdin,
+      output: hidden ? undefined : process.stdout,
+      terminal: hidden,
+    });
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer);
+    });
+  });
+}
+
+// ==================== 配置文件 ====================
+
+function loadConfig() {
+  if (process.env.XHS_COVER_API_KEY) return process.env.XHS_COVER_API_KEY;
+  if (!existsSync(CONFIG_FILE)) return null;
+  try {
+    const content = readFileSync(CONFIG_FILE, 'utf-8');
+    const match = content.match(/^XHS_COVER_API_KEY=(.+)$/m);
+    return match ? match[1].trim() : null;
+  } catch {
+    return null;
+  }
+}
+
+function saveConfig(apiKey) {
+  writeFileSync(CONFIG_FILE, `XHS_COVER_API_KEY=${apiKey}\n`, 'utf-8');
+  try { chmodSync(CONFIG_FILE, 0o600); } catch { /* Windows */ }
+}
+
+function getApiKey() {
+  const key = loadConfig();
+  if (!key) {
+    error(`未配置 API Key\n\n  运行 ${colors.bold('xhscover setup')} 注册账号并自动配置\n  或设置环境变量: export XHS_COVER_API_KEY="xhs_xxxxx"`);
+  }
+  return key;
+}
+
+// ==================== API 请求 ====================
+
+async function apiCall(method, path, body) {
+  const apiKey = getApiKey();
+  const opts = {
+    method,
+    headers: {
+      'Content-Type': 'application/json',
+      'X-API-Key': apiKey,
+    },
+  };
+  if (body) opts.body = JSON.stringify(body);
+
+  const resp = await fetch(`${API_URL}${path}`, opts).catch(() => {
+    error('请求失败，请检查网络连接');
+  });
+
+  const data = await resp.json();
+  if (data.error) error(data.error);
+  return data;
+}
+
+// ==================== 认证 ====================
+
+async function supabaseRequest(endpoint, body) {
+  const resp = await fetch(`${SUPABASE_URL}${endpoint}`, {
+    method: 'POST',
+    headers: {
+      'apikey': SUPABASE_ANON_KEY,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(body),
+  });
+  return resp.json();
+}
+
+async function fetchApiKey(jwt) {
+  const resp = await fetch(`${SUPABASE_URL}/rest/v1/profiles?select=api_key`, {
+    headers: {
+      'apikey': SUPABASE_ANON_KEY,
+      'Authorization': `Bearer ${jwt}`,
+    },
+  });
+  const data = await resp.json();
+  return data?.[0]?.api_key || null;
+}
+
+async function doRegister(email, password) {
+  info('📧 注册中...');
+  const resp = await supabaseRequest('/auth/v1/signup', { email, password });
+
+  if (resp.msg) error(`注册失败: ${resp.msg}`);
+
+  if (!resp.access_token) {
+    // 需要邮箱确认
+    success('✅ 注册成功！请查收邮箱确认邮件');
+    info('');
+    info(`   确认邮箱后运行: ${colors.bold('xhscover login')}`);
+    process.exit(0);
+  }
+
+  const apiKey = await fetchApiKey(resp.access_token);
+  if (!apiKey) error(`注册成功但未获取到 API Key，请稍后使用 ${colors.bold('xhscover login')} 登录`);
+
+  saveConfig(apiKey);
+  success('✅ 注册成功！已获得 10 个免费积分');
+  success(`✅ API Key 已保存到 ${CONFIG_FILE}`);
+
+  return apiKey;
+}
+
+async function doLogin(email, password) {
+  info('🔑 登录中...');
+  const resp = await supabaseRequest('/auth/v1/token?grant_type=password', { email, password });
+
+  if (resp.msg) error(`登录失败: ${resp.msg}`);
+  if (!resp.access_token) error('登录失败，未获取到访问令牌');
+
+  const apiKey = await fetchApiKey(resp.access_token);
+  if (!apiKey) error('登录成功但未获取到 API Key');
+
+  saveConfig(apiKey);
+  success('✅ 登录成功！');
+  success(`✅ API Key 已保存到 ${CONFIG_FILE}`);
+
+  return apiKey;
+}
+
+// ==================== 命令 ====================
+
+async function cmdSetup() {
+  info(colors.bold('小红书封面生成器 - 账号配置'));
+  console.log('');
+  console.log('  1) 注册新账号（获得 10 个免费积分）');
+  console.log('  2) 已有账号，直接登录');
+  console.log('');
+  const choice = await ask(colors.cyan('请选择 [1/2]: '));
+
+  if (choice === '1') return cmdRegister();
+  if (choice === '2') return cmdLogin();
+  error('无效选择');
+}
+
+async function cmdRegister() {
+  const email = await ask('📧 请输入邮箱: ');
+  if (!email) error('邮箱不能为空');
+
+  const password = await ask('🔒 请输入密码 (至少6位): ', { hidden: true });
+  console.log('');
+  if (!password || password.length < 6) error('密码不能少于6位');
+
+  const password2 = await ask('🔒 请确认密码: ', { hidden: true });
+  console.log('');
+  if (password !== password2) error('两次密码不一致');
+
+  const apiKey = await doRegister(email, password);
+  if (apiKey) {
+    console.log('');
+    await cmdBalance();
+  }
+}
+
+async function cmdLogin() {
+  const email = await ask('📧 请输入邮箱: ');
+  if (!email) error('邮箱不能为空');
+
+  const password = await ask('🔒 请输入密码: ', { hidden: true });
+  console.log('');
+  if (!password) error('密码不能为空');
+
+  const apiKey = await doLogin(email, password);
+  if (apiKey) {
+    console.log('');
+    await cmdBalance();
+  }
+}
+
+async function cmdGenerate(text, ratio = '3:4') {
+  if (!text) error('请提供封面文案\n  用法: xhscover generate <文案> [宽高比]');
+  getApiKey(); // 确保 API Key 存在
+
+  info(`🎨 生成封面: ${colors.yellow(text)}`);
+  info(`   宽高比: ${ratio}`);
+  info('   提交中...');
+
+  const resp = await apiCall('POST', '/api/v1/generate', { text, aspectRatio: ratio });
+  const taskId = resp.taskId;
+  if (!taskId) error('创建任务失败，未返回 taskId');
+
+  // 轮询等待结果
+  const timeout = 60;
+  const interval = 2000;
+  const start = Date.now();
+
+  while (Date.now() - start < timeout * 1000) {
+    await new Promise((r) => setTimeout(r, interval));
+    const elapsed = Math.round((Date.now() - start) / 1000);
+
+    const poll = await apiCall('GET', `/api/v1/generate/${taskId}`);
+
+    if (poll.status === 'completed') {
+      console.log('');
+      success('✅ 封面生成完成！');
+      info(`   图片地址: ${colors.cyan(poll.resultUrl)}`);
+      if (poll.creditCost) info(`   消耗积分: ${poll.creditCost}`);
+      return;
+    }
+    if (poll.status === 'failed') {
+      error(`生成失败: ${poll.errorMessage || '未知错误'}`);
+    }
+    info(`   等待中... (${elapsed}s)`);
+  }
+
+  error(`生成超时（${timeout}s），任务 ID: ${taskId}`);
+}
+
+async function cmdBalance() {
+  const resp = await apiCall('GET', '/api/v1/credits');
+  success('💰 积分余额');
+  console.log(`   当前余额: ${resp.balance}`);
+  console.log(`   已购买:   ${resp.totalPurchased}`);
+  console.log(`   已使用:   ${resp.totalUsed}`);
+}
+
+async function cmdHistory(limit = 10) {
+  info(`📋 获取最近 ${limit} 条记录...`);
+  const resp = await apiCall('GET', `/api/v1/history?page=1&limit=${limit}`);
+  const tasks = resp.tasks || [];
+  console.log('');
+  info(`共 ${resp.total || tasks.length} 条记录，显示最近 ${limit} 条：`);
+  console.log('');
+
+  if (tasks.length === 0) {
+    info('   暂无记录');
+    return;
+  }
+
+  for (const task of tasks) {
+    const status = task.status === 'completed' ? colors.green('✓') : task.status === 'failed' ? colors.red('✗') : '…';
+    const date = task.created_at ? new Date(task.created_at).toLocaleString('zh-CN') : '';
+    const prompt = (task.prompt || '').substring(0, 30);
+    console.log(`  ${status} ${prompt.padEnd(32)} ${date}`);
+  }
+}
+
+function showHelp() {
+  console.log(`小红书封面生成器 v2.0.0
+
+用法:
+  xhscover setup                      首次配置（注册或登录）
+  xhscover register                   注册新账号
+  xhscover login                      登录已有账号
+  xhscover generate <文案> [宽高比]   生成封面（含轮询等待）
+  xhscover balance                    查询积分余额
+  xhscover history [数量]             获取生成历史
+  xhscover help                       显示帮助
+
+首次使用:
+  xhscover setup    交互式引导，注册即获 10 个免费积分
+
+配置:
+  API Key 保存在 ~/.xhscover，也可通过环境变量设置:
+  export XHS_COVER_API_KEY="xhs_xxxxx"
+
+环境变量:
+  XHS_COVER_API_URL   API 地址 (默认: https://api.xhscover.cn)
+  XHS_COVER_API_KEY   API 密钥（优先级高于配置文件）
+
+宽高比:
+  3:4   小红书标准竖版（默认）
+  9:16  超长竖版
+  1:1   正方形
+  16:9  横版
+
+示例:
+  xhscover setup
+  xhscover generate "5个习惯让你越来越自律"
+  xhscover generate "今日份好心情" 1:1
+  xhscover balance
+  xhscover history 20
+
+主页: https://xhscover.cn
+使用: npx xhscover setup`);
+}
+
+// ==================== 主入口 ====================
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+switch (command) {
+  case 'setup':
+    await cmdSetup();
+    break;
+  case 'register':
+    await cmdRegister();
+    break;
+  case 'login':
+    await cmdLogin();
+    break;
+  case 'generate':
+    await cmdGenerate(args[1], args[2]);
+    break;
+  case 'balance':
+  case 'credits':
+    await cmdBalance();
+    break;
+  case 'history':
+    await cmdHistory(parseInt(args[1], 10) || 10);
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+    showHelp();
+    break;
+  default:
+    if (command) {
+      await cmdGenerate(command, args[1]);
+    } else {
+      showHelp();
+    }
+    break;
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "xhscover",
+  "version": "2.0.0",
+  "description": "小红书封面生成 CLI - 注册/登录/生成一条龙",
+  "type": "module",
+  "bin": {
+    "xhscover": "./bin/xhscover.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "xiaohongshu",
+    "xhs",
+    "cover",
+    "image-generator",
+    "cli"
+  ],
+  "author": "xwchris",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xwchris/xhscover-cli.git"
+  },
+  "homepage": "https://xhscover.cn"
+}