@miravia_test/miravia-publish-skill 0.1.4 → 0.1.5

package/dist/SKILL.md

@@ -119,6 +119,7 @@ description: Miravia 商品发布 AI Skill。仅负责商品创建（手动一
 | `need_images` | 部分图片迁移失败 | 替换图片后重跑 |
 | `unsupported_format` | 上传了不支持的文件格式（zip/txt/psd 等） | 提示仅支持 PDF/Word/Excel/Image/URL，允许重新上传 |
 | `file_empty_or_corrupted` | 文件内容为空或损坏（0KB PDF / 乱码 Word） | 提示文件内容为空或损坏，允许重新上传 |
+| `llm_not_configured` | 未配置 LLM API key（OPENAI_API_KEY / DASHSCOPE_API_KEY），AI 抽取不可用 | 提示配置 key 后带 --source 重跑；不要绕过确认流程改走手动模式 |
 | `invalid_url` | 输入的 URL 无法抓取 | 提示检查 URL 后重试 |
 | `title_invalid` | 商品标题不符合规范（过短/过长/词数不足） | 提示具体错误 + 标题格式建议（Brand+Category+Model+Features+Scenario），阻断后续流程，禁止转 Draft |
 | `need_category_permission` | 卖家无该类目发布权限 | 询问是否以 Draft 模式发布（待审批通过后自动激活），提供类目权限申请链接 https://sellercenter.miravia.es/apps/setting/category；或更换类目后重跑 |

package/dist/VERSION

@@ -1 +1 @@
-0.1.4
+0.1.5

package/dist/scripts/extraction_engine.py

@@ -102,6 +102,20 @@ class MiraviaListingSchema:
 # ---------------------------------------------------------------------------
 
 
+class LLMNotConfiguredError(RuntimeError):
+    """Raised when AI extraction is requested but no LLM API key is configured.
+
+    Callers must surface this as a structured "llm_not_configured" status so
+    agents prompt for the key instead of silently bypassing the confirm-first
+    extraction flow.
+    """
+
+
+LLM_NOT_CONFIGURED_HINT = (
+    "No LLM API key configured. Set OPENAI_API_KEY or DASHSCOPE_API_KEY."
+)
+
+
 class LLMClient:
     """Minimal OpenAI-compatible LLM client."""
 
@@ -181,8 +195,12 @@ class ExtractionEngine:
 
     def extract(self, source_text: str) -> MiraviaListingSchema:
         if not self.client.is_configured():
-            logger.warning("LLM not configured; running heuristic extraction")
-            return self._heuristic_extract(source_text)
+            # Never silently degrade to heuristic extraction: without LLM the
+            # confirm-first flow (ctb → field summary → publish) breaks because
+            # agents judge the regex output unreliable and bypass the skill.
+            # Fail loudly so the caller returns a structured status instead.
+            logger.error("LLM not configured; refusing heuristic fallback")
+            raise LLMNotConfiguredError(LLM_NOT_CONFIGURED_HINT)
 
         schema_fields = "\n".join(f"- {f.name}" for f in fields(MiraviaListingSchema))
         messages = [

package/dist/scripts/i18n.py

@@ -172,6 +172,8 @@ TRANSLATIONS: Dict[str, Dict[str, str]] = {
         "pub_unsupported_format": "Unsupported file format: {source}. Only PDF, Word, Excel, Image, and URL are supported.",
         "pub_invalid_url": "Failed to fetch URL: {source}. Please check the URL and try again.",
         "pub_url_fetch_failed": "Failed to fetch content from {source}: {error}. Please check the URL and try again.",
+        "pub_llm_not_configured": "AI extraction is unavailable: no LLM API key is configured (OPENAI_API_KEY or DASHSCOPE_API_KEY).",
+        "pub_llm_not_configured_next": "Configure the LLM API key in the environment, then rerun with --source. Do not bypass the confirm-first flow with manual mode.",
         "pub_create_requires_category": "create_product requires --category-id (leaf category)",
         "pub_create_requires_name": "create_product requires --product-name",
         "pub_create_preview_message": "Please review the product creation details below and confirm before I create the product.",
@@ -807,6 +809,8 @@ TRANSLATIONS: Dict[str, Dict[str, str]] = {
         "pub_unsupported_format": "不支持的文件格式：{source}。仅支持 PDF、Word、Excel、图片和 URL。",
         "pub_invalid_url": "无法获取 URL：{source}。请检查 URL 后重试。",
         "pub_url_fetch_failed": "无法从 {source} 获取内容：{error}。请检查 URL 后重试。",
+        "pub_llm_not_configured": "AI 抽取不可用：未配置 LLM API key（OPENAI_API_KEY 或 DASHSCOPE_API_KEY）。",
+        "pub_llm_not_configured_next": "请在环境中配置 LLM API key 后，带 --source 重新运行；不要绕过确认流程改走手动模式。",
         "pub_create_requires_category": "创建商品必须提供 --category-id（叶子类目 ID）",
         "pub_create_requires_name": "创建商品必须提供 --product-name（商品标题）",
         "pub_create_preview_message": "请检查以下商品信息，确认无误后我将创建商品。",

package/dist/scripts/product_skill.py

@@ -327,6 +327,15 @@ def _print_conversational_result(result: Dict[str, Any]) -> None:
             print(f"• {action}")
         return
 
+    # LLM not configured — fail loudly so agents configure the key instead of
+    # bypassing the confirm-first flow with manual mode
+    if status == "llm_not_configured":
+        print(result.get("message", ""))
+        print()
+        for action in result.get("next_actions", []):
+            print(f"• {action}")
+        return
+
     # Invalid URL
     if status == "invalid_url":
         print(result.get("message", ""))

package/dist/scripts/publish_module.py

@@ -33,6 +33,7 @@ from extraction_engine import (
     CRITICAL_FIELDS,
     ExtractionEngine,
     LLMClient,
+    LLMNotConfiguredError,
     MiraviaListingSchema,
     check_missing,
     validate_title,
@@ -1134,7 +1135,18 @@ class PublishModule:
 
         source_text = extract_text(content_items)
         engine = ExtractionEngine(LLMClient())
-        schema = engine.extract(source_text)
+        try:
+            schema = engine.extract(source_text)
+        except LLMNotConfiguredError:
+            # Fail loudly instead of degrading to regex: without LLM the
+            # confirm-first order (title/brand/category before missing-field
+            # summary) cannot be guaranteed, so agents must configure the key
+            # rather than bypass the skill.
+            return {
+                "status": "llm_not_configured",
+                "message": i18n._("pub_llm_not_configured"),
+                "next_actions": [i18n._("pub_llm_not_configured_next")],
+            }
 
         if getattr(self.args, "output_schema", False):
             return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miravia_test/miravia-publish-skill",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "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"