@petercjl/taobao-ai-ops 0.1.1 → 0.1.2

package/README.md

@@ -24,6 +24,7 @@ SealSeek 用户改用 --agent sealseek。目标有歧义时通过 SEALSEEK_SKILL
 - @petercjl/taobao-search-product-form：搜索结果数据和商品形态研究、机会判断卡及 HTML。
 - @petercjl/tbcli：淘宝数据与 NAS 数据库工具，含其独立 Skill。
 - @petercjl/sycmcli：店铺经营数据工具，含其独立 Skill。
+- @petercjl/commerce-ui：通用 HTML 报告 Skill、模板、渲染与校验。调用 `taobao-ai-ops component run html-report ...`；Python 依赖不足时通过该入口执行 `runtime install --yes`。
 - taobao-ai-operations：套件自带的管理与业务路由 Skill。
 
 yccli 为取数时按需准备的外部工具，可用 TAOBAO_AI_OPS_YCCLI 指定；Excel 分析不需要 NAS、VPN 或平台登录。账号与授权留在包外，安装不会获得服务权限。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@petercjl/taobao-ai-ops",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Independent Taobao AI operations SOP skills with a managed suite lifecycle",
   "repository": {
     "type": "git",

package/requirements.txt

@@ -3,3 +3,4 @@ numpy>=1.26,<3
 openpyxl>=3.1,<4
 Pillow>=10,<13
 jieba>=0.42,<1
+jsonschema>=4.23,<5

package/skills/taobao-ai-operations/SKILL.md

@@ -10,6 +10,7 @@ Input: an operator's goal, supplied workbooks or authorized data sources, option
 ## Main line
 
 1. Resolve the requested business result with `taobao-ai-ops nodes list --json`. A category/monthly market question uses `category-research`; a search-result workbook and concrete research object use `product-research`. Existing product scope can enter product research directly. If no supported node covers the request, report the missing node.
+   A supplied analysis or compatible ViewModel requiring a reusable HTML report uses `html-report`, whose exact Skill is `compact-commerce-ui`. It supplies reporting methods, not business conclusions; existing category/product outputs keep their own declared contracts.
 2. Run `taobao-ai-ops doctor --node NODE --mode excel --json` for local workbooks, or `--mode nas` for live category data. Doctor checks deterministic resources; verify any listed native capabilities in the active Agent before their stage. A missing dependency ends the affected node with its exact error.
 3. Resolve the exact child Skill with `taobao-ai-ops skill source --name SKILL --json`. Read its complete current SKILL.md, load its platform adapter, then follow only the child node's current reference routes. The logical dependencies are `yuce-category-opportunity-report` (method contract `yuce-category-opportunity@2.0`) and `taobao-search-product-form` (imported method `0.1.1`). Their returned artifacts and source hashes are the handoff; resolution or contract failure stops with CAPABILITY_UNAVAILABLE or OUTPUT_CONTRACT_FAILED. Return here at step 4 after the child completes. Naming a Skill alone is not execution.
 4. Preserve the child's analysis, full HTML and evidence files. Use `taobao-ai-ops workflow plan --run-dir NEW_DIR --node NODE --input WORKBOOK --json` when a durable suite plan is requested; this records a plan and fixed suite/method versions, not business completion. The product node's own stage ledger remains authoritative for its detailed execution.
@@ -22,6 +23,8 @@ Component scripts run via `taobao-ai-ops script NODE SCRIPT ...`; supplied Excel
 
 When a child was installed by the shell, forward its CLI examples through `taobao-ai-ops component run COMPONENT ...`, retaining all remaining arguments. This resolves the actual independent package even when its CLI is not on PATH or another global version exists. Use the shell's unified update entry for shell-managed components; a child's standalone global updater belongs only to independent global installations.
 
+The shared HTML component is `@petercjl/commerce-ui`. Load `compact-commerce-ui` through named Skill source resolution, then invoke `taobao-ai-ops component run html-report ...` for template discovery, schema, rendering, validation and custom pack lifecycle. Inputs are source evidence and report intent or a live-contract ViewModel; outputs are a new JSON, HTML and validation results. Missing runtime/contract/browser capabilities retain the child's explicit failure boundary. Return to step 4 after reporting. Compatible shared improvements belong in that independent package; adding a component belongs in the shell registry.
+
 The shell registers independent npm packages; each owns its method, resources and release. Ordinary tasks use installed versions. On an explicit install/update request, use `taobao-ai-ops skill install --agent AGENT` or `taobao-ai-ops update install --agent AGENT --yes`; the latter checks both shell and every registered component's stable latest version even when the shell is unchanged. Inspect returned versions and managed Skill state. Registry failure preserves current components; local edits stop synchronization. Missing components return COMPONENT_NOT_INSTALLED and require authorized installation before returning to step 2. Development registrations update through their Git owners and are reported separately. Skill source resolves to each component's own canonical package, not a shell copy.
 
 Current node selection and source resolution are deterministic contracts, with method judgment owned by each child Skill. The package manifest is the node registry and shared contracts are maintained in the package's contracts directory. Do not load unrelated node methods at startup.

package/src/runtime.mjs

@@ -39,7 +39,13 @@ export async function doctor(id,mode='excel'){
   const children=await Promise.all(n.requires_skills.map(skill=>doctor(skill,mode)));
   return {ok:checks.every(c=>c.ok)&&children.every(c=>c.ok),package:PACKAGE.name,version:PACKAGE.version,node:n.id,checks,children,native_requirements:children.flatMap(c=>c.native_requirements)};
  }
- if(n.python_imports.length){const python=resolvePython(n.python_imports);checks.push({id:'python',ok:Boolean(python),value:python,required_imports:n.python_imports});}
+ if(n.python_imports.length&&n.id!=='html-report'){const python=resolvePython(n.python_imports);checks.push({id:'python',ok:Boolean(python),value:python,required_imports:n.python_imports});}
+ if(n.id==='html-report'){
+  const record=componentRecord(n.component);
+  const result=spawnSync(process.execPath,[record.entry,'doctor','--json'],{encoding:'utf8',timeout:30000,env:pythonEnvironment()});
+  let detail;try{detail=JSON.parse(result.stdout||result.stderr);}catch{detail={message:result.stderr||'Unparseable component doctor'};}
+  checks.push({id:'html-component-runtime',ok:result.status===0,value:detail});
+ }
  if(n.id==='category-research')checks.push({id:'report-runtime',ok:['assets/report-template.html','assets/chart-views.js'].every(p=>fs.existsSync(path.join(source(n),p)))});
  if(n.id==='product-research'){
   const componentRequire=createRequire(path.join(componentRecord(n.component).root,'package.json'));

package/suite-manifest.json

@@ -7,10 +7,22 @@
       "category-research",
       "product-research",
       "tbcli-tools",
-      "sycmcli-tools"
+      "sycmcli-tools",
+      "html-report"
     ]
   },
   "nodes": [
+    {
+      "id": "html-report",
+      "skill": "compact-commerce-ui",
+      "component": "html-report",
+      "stage": "shared-reporting",
+      "method_version": "commerce-ui-template-pack@1",
+      "requires_skills": [],
+      "python_imports": ["jsonschema"],
+      "scripts": [],
+      "native_requirements": ["browser.report.inspect"]
+    },
     {
       "id": "operations",
       "skill": "taobao-ai-operations",
@@ -18,7 +30,8 @@
       "method_version": "1.0",
       "requires_skills": [
         "yuce-category-opportunity-report",
-        "taobao-search-product-form"
+        "taobao-search-product-form",
+        "compact-commerce-ui"
       ],
       "python_imports": [],
       "scripts": [],
@@ -105,6 +118,11 @@
     }
   ],
   "tools": {
+    "commerce-ui": {
+      "package": "@petercjl/commerce-ui",
+      "component": "html-report",
+      "role": "versioned HTML templates, rendering and validation"
+    },
     "tbcli": {
       "package": "@petercjl/tbcli",
       "entry": "scripts/tbcli.mjs",
@@ -138,6 +156,11 @@
     "source_checkout": "git-managed"
   },
   "components": {
+    "html-report": {
+      "package": "@petercjl/commerce-ui",
+      "bin": "commerce-ui",
+      "skills": ["compact-commerce-ui"]
+    },
     "category-research": {
       "package": "@petercjl/yuce-category-opportunity-report",
       "bin": "yuce-category-research",