@optima-chat/commerce-cli 1.0.0

package/.claude/CLAUDE.md

@@ -0,0 +1,101 @@
+
+
+## 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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Optima Commerce Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.