@miravia_test/miravia-publish-skill 0.1.3 → 0.1.4

package/dist/VERSION

@@ -1 +1 @@
-0.1.3
+0.1.4

package/dist/reference_publish.md

@@ -249,7 +249,7 @@ PRD 中标记为新增 API，但当前 Miravia Open Platform 文档站点未上
 
 | Schema 字段（snake_case） | API 字段 / 位置 | 必填 | 说明 |
 |---|---|---|---|
-| `product_title` | `Attributes.name` | M | 商品标题，20~255 字符，≥5 个单词 |
+| `product_title` | `Attributes.name` | M | 商品标题，20~205 字符，≥5 个单词 |
 | `product_images` | `Images.Image[]` | M | 主图列表，第 1 张为主图 |
 | `product_long_description` | `Attributes.description` | O | 长描述，可含简单 HTML |
 | `category_id` | `PrimaryCategory` | M | 叶子类目 ID |

package/dist/scripts/field_definitions.py

@@ -16,7 +16,7 @@ FIELD_DEFINITIONS: Dict[str, Dict[str, str]] = {
         "mo": "Mandatory",
         "definition": "The title / name of the product.",
         "requirement": (
-            "Length must be greater than 20 characters and less than 255 characters. "
+            "Length must be greater than 20 characters and less than 205 characters. "
             "Suggested format: Brand + category + collection/model + key features + using scenarios."
         ),
     },
@@ -375,7 +375,7 @@ FIELD_DEFINITIONS: Dict[str, Dict[str, str]] = {
 
 FIELD_GUIDES: Dict[str, Dict[str, str]] = {
     "en": {
-        "product_title": "Product title (Mandatory): The title / name of the product. Must be 20-255 characters. Suggested format: Brand + category + collection/model + key features + using scenarios.",
+        "product_title": "Product title (Mandatory): The title / name of the product. Must be 20-205 characters. Suggested format: Brand + category + collection/model + key features + using scenarios.",
         "product_images": "Product images (Mandatory): Image URLs. The first image is the main image shown in search/home. First image must have white background, 1:1 aspect ratio, 330-5000px, <5MB, jpg/png/jpeg/webp. Max 8 images.",
         "product_long_description": "Product long description (Optional): May include simple HTML. 20-3000 characters; embedded HTML is not supported.",
         "category_id": "Category ID (Mandatory): The internal Miravia leaf category ID where the product will be listed.",
@@ -414,7 +414,7 @@ FIELD_GUIDES: Dict[str, Dict[str, str]] = {
         "selling_marketplace_aliexpress": "Selling marketplace - AliExpress (Optional): Selling status per country on the AliExpress platform.",
     },
     "zh": {
-        "product_title": "商品标题（必填）：商品的标题/名称。长度需大于 20 且小于 255 个字符。建议格式：品牌 + 类目 + 系列/型号 + 核心卖点 + 使用场景。",
+        "product_title": "商品标题（必填）：商品的标题/名称。长度需大于 20 且小于 205 个字符。建议格式：品牌 + 类目 + 系列/型号 + 核心卖点 + 使用场景。",
         "product_images": "商品图片（必填）：商品图片 URL。第一张图是在搜索/首页展示的主图，必须使用纯白背景、1:1 比例、330-5000px、<5MB，仅支持 jpg/png/jpeg/webp。最多 8 张。",
         "product_long_description": "商品长描述（选填）：可包含简单 HTML 的长描述。长度 20-3000 字符；不支持嵌套复杂 HTML，建议使用列表、加粗、字体等简单标签。",
         "category_id": "类目 ID（必填）：Miravia 叶子类目内部 ID，商品将挂靠在该类目下。",

package/dist/scripts/product_client.py

@@ -240,12 +240,12 @@ class ProductClient:
         Returns:
             List of category candidates, each with category_id, name, confidence, etc.
         """
-        body: Dict[str, Any] = {}
+        params: Dict[str, Any] = {}
         if title:
-            body["title"] = title
+            params["title"] = title
         if image_urls:
-            body["imageUrls"] = image_urls
-        result = self.client.request("POST", "/product/category/recommend/get", body)
+            params["imageUrls"] = image_urls
+        result = self.client.request("GET", "/product/category/recommend/get", params)
         data = result.get("data", []) or []
         if isinstance(data, list):
             return data

package/dist/scripts/publish_module.py

@@ -156,10 +156,25 @@ class PublishModule:
         category_id = self.args.category_id
         product_name = self.args.product_name
         if not category_id:
-            raise ValueError(i18n._("pub_create_requires_category"))
+            return {
+                "status": "need_category",
+                "message": i18n._("pub_create_requires_category"),
+                "next_actions": [i18n._("pub_ai_post_provide_category")],
+            }
         if not product_name:
-            raise ValueError(i18n._("pub_create_requires_name"))
-        _validate_title(product_name)
+            return {
+                "status": "title_invalid",
+                "message": i18n._("pub_create_requires_name"),
+                "next_actions": [i18n._("pub_ai_post_requires_source")],
+            }
+        title_err = validate_title(product_name)
+        if title_err:
+            return {
+                "status": "title_invalid",
+                "message": title_err,
+                "format_suggestion": i18n._("pub_title_format_suggestion"),
+                "next_actions": [i18n._("pub_ai_post_requires_source")],
+            }
 
         brand_resolution = self._resolve_brand_interactive()
         if brand_resolution.get("status") == "need_brand":
@@ -1095,7 +1110,11 @@ class PublishModule:
                 "next_actions": [i18n._("pub_ai_post_requires_source")],
             }
         if not content_items:
-            raise ValueError(i18n._("pub_ai_post_no_content"))
+            return {
+                "status": "file_empty_or_corrupted",
+                "message": i18n._("pub_file_empty_or_corrupted", source=sources[0] if sources else ""),
+                "next_actions": [i18n._("pub_ai_post_requires_source")],
+            }
 
         # Check for multiple products in Excel
         row_count = get_excel_row_count(content_items)
@@ -1738,7 +1757,7 @@ class PublishModule:
 
         package_dims = ("package_weight", "package_length", "package_width", "package_height")
         for idx, sku in enumerate(skus, start=1):
-            if not sku.get("SellerSku"):
+            if not (sku.get("SellerSku") or sku.get("seller_sku")):
                 missing.append(f"Seller SKU (SKU #{idx})")
             for dim in package_dims:
                 val = sku.get(dim)
@@ -1809,7 +1828,7 @@ class PublishModule:
         if self._is_category_attribute_mandatory(category_attributes, "compliance_documents") and not schema.compliance_documents:
             missing.append("compliance_documents")
 
-        if not any(sku.get("SellerSku") for sku in skus):
+        if not any(sku.get("SellerSku") or sku.get("seller_sku") for sku in skus):
             missing.append("seller_sku")
 
         return missing
@@ -2727,6 +2746,11 @@ class PublishModule:
         skus: List[Dict[str, Any]] = []
         for idx, sku in enumerate(data):
             processed = dict(sku)
+            # Normalize seller_sku → SellerSku (accept both snake_case and PascalCase)
+            if "seller_sku" in processed and "SellerSku" not in processed:
+                processed["SellerSku"] = processed.pop("seller_sku")
+            elif "seller_sku" in processed:
+                processed.pop("seller_sku")  # SellerSku already set
             if not processed.get("SellerSku"):
                 raise ValueError(
                     i18n._("pub_seller_sku_required", idx=idx + 1)
@@ -2904,7 +2928,7 @@ def _validate_create_payload(payload: Dict[str, Any]) -> None:
         raise ValueError(i18n._("pub_ean_duplicate_in_product"))
 
     # Check Seller SKU duplicate within same product
-    seller_skus = [sku.get("SellerSku") for sku in skus if sku.get("SellerSku")]
+    seller_skus = [sku.get("SellerSku") or sku.get("seller_sku") for sku in skus if sku.get("SellerSku") or sku.get("seller_sku")]
     if len(seller_skus) != len(set(seller_skus)):
         raise ValueError(i18n._("pub_seller_sku_duplicate_in_product"))
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miravia_test/miravia-publish-skill",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Miravia Product Publish Skill installer — one command to install the Miravia AI product listing skill into any AI Agent (Qoder / Cursor / Claude Code). Upload materials and let the AI extract data and publish products automatically.",
   "bin": {
     "miravia-publish-skill": "bin/cli.js"