@optima-chat/commerce-cli 1.1.0 → 1.3.0

package/.claude/CLAUDE.md

@@ -1,101 +0,0 @@
-
-
-## Optima CLI
-
-电商店铺管理命令行工具 - 用自然语言管理商品、订单、库存和物流。
-
-**版本**: v0.18.2 | **安装**: `npm install -g @optima-chat/commerce-cli@latest`
-
-### Available Modules (15)
-**auth** - OAuth 认证管理（login, logout, whoami）
-**merchant** - 商户资料管理（信息、URL、初始化设置）
-**product** - 商品目录管理（CRUD、图片、URL、标签）
-**variant** - 商品变体/SKU 管理（规格、库存、图片）
-**order** - 订单履行（发货、取消、完成、标记送达）
-**refund** - 退款管理
-**inventory** - 库存管理（低库存预警、更新、历史、预留）
-**homepage** - 首页配置管理（模块、设置、分析、翻译）
-**collection** - 集合管理（CRUD、产品关联、翻译）
-**shipping** - 物流管理（运费计算、物流追踪）
-**shipping-zone** - 运费区域配置（按地区设置运费费率）
-**upload** - 媒体文件上传（图片、视频、文件）
-**conversation** - 客服对话管理
-**transfer** - 财务转账和汇总
-**i18n** - 多语言翻译管理（商品/变体/集合/商户/首页的国际化）
-
-### Best Practices
-
-**环境支持（v0.17.0）** - 支持生产和开发环境切换
-- 生产环境（默认）：auth.optima.shop + api.optima.shop
-- 开发环境：auth.optima.chat + api.optima.chat
-- 使用 `--env development` 连接开发后端
-
-**非交互模式** - AI 环境自动检测，缺少参数立即报错。删除操作需 `--yes`。
-
-**i18n 参数区分** - 翻译命令根据实体使用不同参数：
-- 变体翻译：`--variant-id`（不是 `--product-id`）
-- 集合翻译：`--collection-id`
-- 首页区块翻译：`--section-id`（用于前端展示的多语言标题和描述）
-
-**图片上传** - 先 `optima upload image`，再用 `media_id` 关联到商品，避免重复上传。
-
-**主动执行** - 不要询问可选字段，先完成任务再报告。
-
-### Common Command Examples
-
-```bash
-# 认证
-commerce auth login                              # 登录到生产环境（默认）
-commerce auth login --env development            # 登录到开发环境
-commerce merchant info
-
-# 商品管理（支持标签）
-commerce product create --title "T恤" --price 99 --tags "featured,new,sale"
-commerce product list --tags "featured,new"
-commerce product update --id prod_123 --price 99
-
-# 图片上传
-commerce upload image --path ./photo.jpg
-commerce product add-images --id prod_123 --media-id media_456
-
-# 变体管理
-commerce variant create --product-id prod_123 --sku "CUP-S-WHITE" --price 89 --stock 10 --attributes '{"size":"S","color":"White"}'
-
-# 首页配置
-commerce homepage module create --slug hero-banner --type banner --position 1 --config '{"images":[{"url":"https://example.com/banner.jpg"}]}'
-commerce homepage settings update --show-search true --featured-limit 8
-
-# 集合管理
-commerce collection create --name "Summer Sale" --slug summer-sale
-commerce collection add-products --slug summer-sale --product-ids prod_123,prod_456
-
-# 订单履行
-commerce order list --status pending
-commerce order ship --id order_123 --tracking DHL123456 --carrier DHL
-
-# 库存管理
-commerce inventory low-stock --threshold 5
-commerce inventory update --id prod_123 --quantity 100
-
-# 运费计算
-commerce shipping calculate --country US --postal-code 10001 --weight 0.5
-
-# 运费区域配置
-commerce shipping-zone create --name "北美区域" --countries US,CA,MX --price 15 --currency USD
-
-# 多语言翻译（注意参数区分）
-commerce i18n product create --product-id prod_123 --lang zh-CN --name "陶瓷杯"
-commerce i18n variant create --variant-id var_456 --lang ja-JP --name "セラミックマグ" --variant-attributes-translations '{"size":{"key_translation":"サイズ","value_translation":{"S":"小"}},"color":{"key_translation":"色","value_translation":{"白":"白"}}}'
-commerce i18n collection create --collection-id coll_789 --lang es-ES --name "Promoción de Verano"
-
-# 首页区块翻译（为前端展示添加多语言标题和描述）
-commerce i18n homepage set --section-id section_123 --lang zh-CN --title "精选商品" --description "查看我们最受欢迎的产品"
-commerce i18n homepage set --section-id section_123 --lang en-US --title "Featured Products" --description "Discover our most popular items"
-commerce i18n homepage list --section-id section_123  # 查看区块的所有翻译
-```
-
-### Tips
-- 使用 `commerce <命令> --help` 查看详细用法
-- 删除操作需要 `-y` 或 `--yes` 跳过确认
-- 支持的语言：en-US, es-ES, ja-JP, vi-VN, zh-CN
-<!-- END_OPTIMA_CLI -->

package/.claude/skills/commerce-cli/SKILL.md

@@ -1,177 +0,0 @@
----
-name: commerce-cli
-description: E-commerce store management CLI with 16 modules and 95+ commands. Manage products, orders, inventory, shipping, collections, i18n translations, and homepage configuration. Use when the user needs to create/update/delete products, process orders, manage inventory, configure shipping, or handle multilingual translations for their e-commerce store.
----
-
-# Commerce CLI - 电商店铺管理工具
-
-## Overview
-
-Commerce CLI 是专为 Claude Code 设计的对话式电商管理工具，支持用自然语言管理店铺。
-
-**版本**: v1.0.0
-**安装**: `npm install -g @optima-chat/commerce-cli@latest`
-
-## Instructions
-
-### 1. 认证流程
-
-首次使用需要登录：
-```bash
-commerce auth login                    # 生产环境
-commerce auth login --env stage        # Stage 环境
-commerce auth login --env development  # 开发环境
-```
-
-### 2. 自然语言映射
-
-当用户说：
-- "创建XX商品，价格YY" → `commerce product create --title XX --price YY`
-- "查看今天的订单" → `commerce order list`
-- "订单XX发货，快递单号YY" → `commerce order ship --id XX --tracking YY`
-- "库存低于5的商品" → `commerce inventory low-stock --threshold 5`
-- "给商品添加中文翻译" → `commerce i18n product create --product-id XX --lang zh-CN`
-
-### 3. 功能模块
-
-**16 个核心模块**：
-- `auth` - OAuth 认证管理
-- `merchant` - 商户资料管理
-- `product` - 商品目录管理（支持标签）
-- `variant` - 商品变体/SKU 管理
-- `order` - 订单履行
-- `refund` - 退款管理
-- `inventory` - 库存管理
-- `homepage` - 首页配置
-- `collection` - 集合管理
-- `shipping` - 物流管理
-- `shipping-zone` - 运费区域配置
-- `upload` - 媒体文件上传
-- `conversation` - 客服对话
-- `transfer` - 财务管理
-- `i18n` - 多语言翻译（24个子命令）
-- `test` - 健康检查和测试
-
-### 4. 最佳实践
-
-**环境管理**：
-- 支持 Production/Stage/Development 三环境
-- 配置文件位置：`~/.config/commerce-cli/`
-- 环境切换：`commerce auth switch --env stage`
-
-**非交互模式**：
-- AI/CI 环境自动检测，缺少参数立即报错
-- 删除操作需要 `--yes` 标志
-
-**i18n 参数区分**：
-- 变体翻译使用 `--variant-id`（不是 `--product-id`）
-- 集合翻译使用 `--collection-id`
-- 首页区块翻译使用 `--section-id`
-
-**图片上传**：
-- 先上传：`commerce upload image --path ./photo.jpg`
-- 获取 `media_id`
-- 再关联：`commerce product add-images --id prod_123 --media-id media_456`
-
-## Examples
-
-### 商品管理
-```bash
-# 用户说："创建T恤商品，99美元，库存20，标签是featured和new"
-commerce product create \
-  --title "T恤" \
-  --price 99 \
-  --stock 20 \
-  --tags "featured,new"
-
-# 用户说："查看所有featured标签的商品"
-commerce product list --tags "featured"
-
-# 用户说："商品prod_123改价到129"
-commerce product update --id prod_123 --price 129
-```
-
-### 订单履行
-```bash
-# 用户说："查看待发货订单"
-commerce order list --status paid
-
-# 用户说："订单order_123发货，快递单号DHL123456，承运商DHL"
-commerce order ship \
-  --id order_123 \
-  --tracking DHL123456 \
-  --carrier DHL
-
-# 用户说："取消订单order_456，原因是客户要求"
-commerce order cancel \
-  --id order_456 \
-  --reason "客户要求取消" \
-  --yes
-```
-
-### 库存管理
-```bash
-# 用户说："查看库存低于10的商品"
-commerce inventory low-stock --threshold 10
-
-# 用户说："商品prod_123补货50个"
-commerce inventory update \
-  --id prod_123 \
-  --quantity 50 \
-  --reason "补货"
-```
-
-### 多语言翻译
-```bash
-# 用户说："给商品prod_123添加中文翻译，名称是手工陶瓷杯"
-commerce i18n product create \
-  --product-id prod_123 \
-  --lang zh-CN \
-  --name "手工陶瓷杯" \
-  --description "精美的手工制作陶瓷杯"
-
-# 用户说："给变体var_456添加日语翻译"
-commerce i18n variant create \
-  --variant-id var_456 \
-  --lang ja-JP \
-  --name "セラミックマグ"
-```
-
-### 首页配置
-```bash
-# 用户说："创建首页轮播图模块"
-commerce homepage module create \
-  --slug hero-banner \
-  --type banner \
-  --position 1 \
-  --enabled true \
-  --config '{"images":[{"url":"https://example.com/banner.jpg"}]}'
-
-# 用户说："更新首页设置，启用搜索功能"
-commerce homepage settings update \
-  --show-search true \
-  --featured-limit 8
-```
-
-### 集合管理
-```bash
-# 用户说："创建夏季促销集合"
-commerce collection create \
-  --name "Summer Sale" \
-  --slug summer-sale \
-  --description "Hot deals for summer"
-
-# 用户说："把商品prod_123和prod_456添加到集合summer-sale"
-commerce collection add-products \
-  --slug summer-sale \
-  --product-ids prod_123,prod_456
-```
-
-## Notes
-
-- 所有命令默认输出 JSON 格式（AI 友好）
-- 使用 `--pretty` 参数可切换到人类可读的表格格式
-- 环境变量 `OPTIMA_TOKEN` 可用于非交互认证（CI/CD）
-- 支持的语言：en-US, es-ES, ja-JP, vi-VN, zh-CN
-- 使用 `commerce <command> --help` 查看详细用法
-- 项目仓库：https://github.com/Optima-Chat/commerce-cli

package/dist/commands/cleanup.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare const cleanupCommand: Command;
-//# sourceMappingURL=cleanup.d.ts.map

package/dist/commands/cleanup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/commands/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmHpC,eAAO,MAAM,cAAc,SAAM,CAAC"}

package/dist/commands/cleanup.js

@@ -1,100 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
-import inquirer from 'inquirer';
-import { isInteractiveEnvironment } from '../utils/interactive.js';
-import { ValidationError, handleError } from '../utils/error.js';
-const CLAUDE_MD_PATH = path.join(os.homedir(), '.claude', 'CLAUDE.md');
-const OPTIMA_START_MARKER = '## Optima CLI';
-const OPTIMA_END_MARKER = '<!-- END_OPTIMA_CLI -->';
-import { addEnhancedHelp } from '../utils/helpText.js';
-const cmd = new Command('cleanup')
-    .description('Remove Optima CLI config from Claude Code global settings')
-    .option('--yes', 'Skip confirmation prompt (non-interactive)')
-    .action(async (options) => {
-    try {
-        await cleanupConfig(options);
-    }
-    catch (error) {
-        handleError(error);
-    }
-});
-async function cleanupConfig(options) {
-    // 检查文件是否存在
-    if (!fs.existsSync(CLAUDE_MD_PATH)) {
-        console.log(chalk.yellow('\n⚠️  未找到 Claude Code 配置文件\n'));
-        return;
-    }
-    // 读取内容
-    const content = fs.readFileSync(CLAUDE_MD_PATH, 'utf-8');
-    // 检查是否包含 Optima CLI 配置
-    if (!content.includes(OPTIMA_START_MARKER)) {
-        console.log(chalk.yellow('\n⚠️  配置文件中未找到 Optima CLI 区块\n'));
-        return;
-    }
-    // 确认
-    if (!options.yes) {
-        if (isInteractiveEnvironment()) {
-            // 交互模式：显示确认提示
-            const answer = await inquirer.prompt([
-                {
-                    type: 'confirm',
-                    name: 'confirm',
-                    message: '确定要从 Claude Code 配置中移除 Optima CLI 区块吗？',
-                    default: false,
-                },
-            ]);
-            if (!answer.confirm) {
-                console.log(chalk.gray('\n已取消\n'));
-                return;
-            }
-        }
-        else {
-            // 非交互模式：要求使用 --yes 标志
-            throw new ValidationError('非交互环境需要使用 --yes 标志确认清理操作', 'yes');
-        }
-    }
-    // 移除 Optima CLI 区块
-    let newContent = content;
-    if (content.includes(OPTIMA_END_MARKER)) {
-        const regex = new RegExp(`${OPTIMA_START_MARKER}[\\s\\S]*?${OPTIMA_END_MARKER}\\n?`, 'g');
-        newContent = newContent.replace(regex, '');
-    }
-    else {
-        const regex = /## Optima CLI[\s\S]*?(?=\n## [^\n]|\n*$)/g;
-        newContent = newContent.replace(regex, '');
-    }
-    // 清理多余空行
-    newContent = newContent.replace(/\n{3,}/g, '\n\n').trim() + '\n';
-    // 写回文件
-    fs.writeFileSync(CLAUDE_MD_PATH, newContent, 'utf-8');
-    console.log(chalk.green('\n✓ 已从 Claude Code 配置中移除 Optima CLI'));
-    console.log(chalk.gray(`  配置文件: ${CLAUDE_MD_PATH}\n`));
-}
-addEnhancedHelp(cmd, {
-    examples: [
-        '# Remove Optima config with confirmation',
-        '$ commerce cleanup',
-        '',
-        '# Remove without confirmation (non-interactive)',
-        '$ commerce cleanup --yes',
-    ],
-    output: {
-        description: 'Removes Optima CLI section from ~/.claude/CLAUDE.md',
-        example: 'Configuration file: /Users/username/.claude/CLAUDE.md'
-    },
-    relatedCommands: [
-        { command: 'init', description: 'Re-enable Optima in project' },
-        { command: 'auth logout', description: 'Logout before cleanup' },
-    ],
-    notes: [
-        'Removes global configuration from ~/.claude/CLAUDE.md',
-        'Requires confirmation unless --yes flag is used',
-        'Does not affect tokens or login status',
-        'Project-level configs (.claude/CLAUDE.md) are not affected',
-    ]
-});
-export const cleanupCommand = cmd;
-//# sourceMappingURL=cleanup.js.map

package/dist/commands/cleanup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/commands/cleanup.ts"],"names":[],"mappings":"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"}