@petercjl/taobao-ai-ops 0.4.4 → 0.4.6

package/UPDATE.md

@@ -11,3 +11,5 @@
 宿主安装完整候选后，在任务和审批空闲时切换并刷新 Skill。下载失败、离线、候选验证失败、用户修改过受管 Skill 或宿主刷新失败时，保留上一套。更新只涉及选定宿主的订阅目录，配置和凭据留在包外。插件详情显示实际成员版本及上次检查结果。
 
 开发者：每次检查都以当前壳的注册表为准，与 previous 回执比较成员身份、版本和所需 Skill；`collection prepare` 返回独立候选，宿主验证后才激活。回执中的运行环境必须跟随 CLI 调用，当前任务内保持同一版本。新集合入口不接管历史全局 npm 安装；历史安装继续通过其已声明的维护入口操作。
+
+开发者：迁移已批准的跨兼容版本组件时，在collection check/prepare中显式传入 `--accept-component-upgrades ID,ID` 并保留previous回执。该参数仅批准列出的组件升级，不批准降级；其余不兼容组件继续保留原版本。DMP快照v2迁移选择 `tbcli,dmp-product-report`，候选doctor通过后再激活。

package/package.json

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

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

@@ -95,12 +95,16 @@ For explicit Boardmix file, media or object operations, select `boardmix-tools`.
 
 ## DMP 商品经营报告
 
-用户提供淘宝/天猫商品ID，希望查看竞品经营趋势、推广方式/力度/效果、新老客成交结构或完整商品经营HTML报告时，选择 `dmp-product-report` 节点。独立拥有包为 `@petercjl/dmp-product-report`，逻辑Skill为 `dmp-product-report`；所需能力是 `@petercjl/tbcli` 的 DMP snapshot v1 与 itemSummary v1。兼容起点分别为报告包0.1.2、tbcli 0.11.3。
+用户提供淘宝/天猫商品ID，希望查看竞品经营趋势、推广方式/力度/效果、新老客成交结构或完整商品经营HTML报告时，选择 `dmp-product-report` 节点。独立拥有包为 `@petercjl/dmp-product-report`，逻辑Skill为 `dmp-product-report`；所需能力是 `@petercjl/tbcli` 的 DMP snapshot v2 与 itemSummary v1。兼容起点分别为报告包0.2.0、tbcli 0.12.0。
 
 先运行 `taobao-ai-ops skill source --name dmp-product-report --json`，完整读取返回的当前Skill，按该Skill按需加载知识、适配与tbcli依赖，再运行 `taobao-ai-ops doctor --node dmp-product-report --json`。Doctor检查套件所选报告组件、Python与tbcli合同，不查询经营数据或证明账号权限。缺失/不兼容时保留结构化错误，恢复后回到预检；不借用另一全局tbcli来掩盖依赖问题。
 
 通过 `taobao-ai-ops component run dmp-product-report ...` 执行子CLI主线。套件将其已注册tbcli入口传入应用；宿主能力集合的子Skill回执也包含同一依赖入口，任务内保留该版本集合。商品名称、链接、5张主图、店铺、已售、入口价和评价数由橙色淘宝买家浏览器读取；DMP统计由蓝色商家电商浏览器读取，两个角色的会话参数分别保留。登录和验证码由用户在对应窗口处理。
 
-输入为目标商品ID，可补充已选本店锚点、报告日与新输出目录；已有证据可按子合同离线build/finalize。锚点未选时由子Skill列出本店商品供用户选择。输出包括自包含HTML、商品资料、近7天/前7天、近30天/前30天及8个完整自然周证据、CSV、ViewModel、分析和校验。run产生draft后继续按子Skill完成分析和finalize；一句结论与编号证据、经营策略解读及最终概览均由子应用的当前知识方法承接。返回套件主线第4步保留成果或第6步交付。
+输入为目标商品ID，可补充报告日与新输出目录；已有证据可按子合同离线build/finalize。接口需要的本店商品参数由tbcli自动从当前账户发现，报告仅采用目标商品侧数据。输出包括自包含HTML、商品资料、近7天/前7天、近30天/前30天及8个完整自然周证据、CSV、ViewModel、分析和校验。run产生draft后继续按子Skill完成分析和finalize；一句结论与编号证据、经营策略解读及最终概览均由子应用的当前知识方法承接。返回套件主线第4步保留成果或第6步交付。
 
 报告模板和分析知识继续由独立报告包维护，运行不依赖commerce-ui。套件负责注册、安装更新、精确Skill来源解析、依赖传递和预检。商品资料的页面展示口径与DMP分期统计分别解释；本次可用范围以平台实际返回为准。
+
+### DMP配套版本迁移
+
+用户授权更新DMP报告和取数链路时，检查当前集合的blocked成员。若报告包0.2与tbcli 0.12因跨兼容版本而保留旧版，使用旧回执和 `collection prepare --accept-component-upgrades tbcli,dmp-product-report` 明确迁移这两个组件；其他不兼容组件维持原选择。核对候选DMP doctor及真实版本后再切换宿主入口。该操作按用户已授权的组件范围执行，不扩大到其他Agent或未选组件。

package/src/cli.mjs

@@ -9,10 +9,10 @@ import {checkUpdate,installUpdate} from './update.mjs';
 import {collectionCheck,collectionPrepare} from './subscription.mjs';
 import fs from 'node:fs/promises';
 const print=v=>console.log(JSON.stringify(v,null,2));
-function options(args){const out={};for(let i=0;i<args.length;i++){const k=args[i];if(['--json','--adopt','--yes'].includes(k))out[k.slice(2)]=true;else if(['--directory','--previous','--path','--agent','--target-dir','--name','--node','--profile','--mode','--run-dir','--input','--out','--candidate','--query','--tag','--context','--run-id'].includes(k)){if(!args[i+1]||args[i+1].startsWith('--'))throw fail('USAGE',`${k} needs a value`);out[k.slice(2).replace(/-([a-z])/g,(_,c)=>c.toUpperCase())]=args[++i];}else throw fail('USAGE',`Unknown option ${k}`);}return out;}
+function options(args){const out={};for(let i=0;i<args.length;i++){const k=args[i];if(['--json','--adopt','--yes'].includes(k))out[k.slice(2)]=true;else if(['--accept-component-upgrades','--directory','--previous','--path','--agent','--target-dir','--name','--node','--profile','--mode','--run-dir','--input','--out','--candidate','--query','--tag','--context','--run-id'].includes(k)){if(!args[i+1]||args[i+1].startsWith('--'))throw fail('USAGE',`${k} needs a value`);out[k.slice(2).replace(/-([a-z])/g,(_,c)=>c.toUpperCase())]=args[++i];}else throw fail('USAGE',`Unknown option ${k}`);}return out;}
 export async function main(argv){
  const [command,action,...rest]=argv;
- if(!command||['help','--help','-h'].includes(command))return console.log(`taobao-ai-ops ${PACKAGE.version}\nversion | nodes list | node show ID | capabilities\ncollection check [--previous RECEIPT] --json | collection prepare --directory NEW --yes --json [--previous RECEIPT]\ndoctor --node ID [--mode excel|nas]\nskill source [--name NAME] | skill status|install|update --agent AGENT [--profile research] [--adopt]\ncomponents status|check|install [--agent AGENT --yes]\ncomponents register --name ID --path CHECKOUT --yes [--mode npm]\ncomponent run ID [arguments...] | script NODE SCRIPT [arguments...] | tool run TOOL [arguments...]\nworkflow plan|status --run-dir DIR [--node ID] [--input FILE]\nhandoff create --node ID --input FILE --out FILE [--candidate PATH --query QUERY]\nupdate check|install [--tag latest] [--agent AGENT --yes]`);
+ if(!command||['help','--help','-h'].includes(command))return console.log(`taobao-ai-ops ${PACKAGE.version}\nversion | nodes list | node show ID | capabilities\ncollection check [--previous RECEIPT] --json | collection prepare --directory NEW --yes --json [--previous RECEIPT] [--accept-component-upgrades ID,ID]\ndoctor --node ID [--mode excel|nas]\nskill source [--name NAME] | skill status|install|update --agent AGENT [--profile research] [--adopt]\ncomponents status|check|install [--agent AGENT --yes]\ncomponents register --name ID --path CHECKOUT --yes [--mode npm]\ncomponent run ID [arguments...] | script NODE SCRIPT [arguments...] | tool run TOOL [arguments...]\nworkflow plan|status --run-dir DIR [--node ID] [--input FILE]\nhandoff create --node ID --input FILE --out FILE [--candidate PATH --query QUERY]\nupdate check|install [--tag latest] [--agent AGENT --yes]`);
  if(['version','--version'].includes(command))return action==='--json'?print({ok:true,package:PACKAGE.name,version:PACKAGE.version}):console.log(PACKAGE.version);
  if(command==='script')return runScript(action,rest[0],rest.slice(1));
  if(command==='component'&&action==='run'){
@@ -25,11 +25,11 @@ export async function main(argv){
  }
  if(command==='nodes'&&action==='list')return print(MANIFEST.nodes);
  if(command==='node'&&action==='show')return print(nodeFor(rest[0]));
- if(command==='capabilities')return print({package:PACKAGE.name,version:PACKAGE.version,...MANIFEST,collectionContract:{schemaVersion:1,manifest:'sealwork.collection.json',check:['collection','check','--json'],prepare:['collection','prepare','--directory','{newDirectory}','--yes','--json'],previousOption:'--previous',installationMode:'host-owned-generation',hostDiscoveryAuthority:'host'}});
+ if(command==='capabilities')return print({package:PACKAGE.name,version:PACKAGE.version,...MANIFEST,collectionContract:{schemaVersion:1,manifest:'sealwork.collection.json',check:['collection','check','--json'],prepare:['collection','prepare','--directory','{newDirectory}','--yes','--json'],previousOption:'--previous',migrationOption:'--accept-component-upgrades',migrationPolicy:'Explicitly approved component IDs may cross compatibility boundaries; unselected incompatible versions stay pinned; downgrades stay blocked',installationMode:'host-owned-generation',hostDiscoveryAuthority:'host'}});
  if(command==='doctor'){const opts=options(argv.slice(1));const r=await doctor(opts.node,opts.mode);print(r);if(!r.ok)process.exitCode=1;return;}
  const opts=options(rest);
  if(command==='collection'){
-  if(action==='check')return print(await collectionCheck(opts.previous?JSON.parse(await fs.readFile(opts.previous,'utf8')):undefined));
+  if(action==='check')return print(await collectionCheck(opts.previous?JSON.parse(await fs.readFile(opts.previous,'utf8')):undefined,undefined,opts.acceptComponentUpgrades));
   if(action==='prepare')return print(await collectionPrepare(opts));
  }
 

package/src/runtime.mjs

@@ -98,14 +98,14 @@ export async function doctor(id,mode='excel'){
  if(n.component==='dmp-product-report'){
   const record=componentRecord(n.component),records=componentRecords();
   const atLeast=(value,min)=>{if(!/^\d+\.\d+\.\d+$/.test(value??''))return false;const a=value.split('.').map(Number),b=min.split('.').map(Number);for(let i=0;i<3;i++)if(a[i]!==b[i])return a[i]>b[i];return true;};
-  checks.push({id:'dmp-report-version',ok:atLeast(record.version,'0.1.2'),value:record.version,minimum:'0.1.2'});
-  checks.push({id:'dmp-report-tbcli',ok:atLeast(records.tbcli?.version,'0.11.3'),value:records.tbcli?.version??null,minimum:'0.11.3'});
+  checks.push({id:'dmp-report-version',ok:atLeast(record.version,'0.2.0'),value:record.version,minimum:'0.2.0'});
+  checks.push({id:'dmp-report-tbcli',ok:atLeast(records.tbcli?.version,'0.12.0'),value:records.tbcli?.version??null,minimum:'0.12.0'});
   try{
    const environment=componentEnvironment(n.component);
    const versionRun=spawnSync(process.execPath,[record.entry,'version','--json'],{encoding:'utf8',timeout:15000,env:environment});let version;try{version=JSON.parse(versionRun.stdout);}catch{}
    checks.push({id:'dmp-report-runtime',ok:versionRun.status===0&&version?.package===MANIFEST.components[n.component].package&&version?.version===record.version,value:version?.version??null});
    const result=spawnSync(process.execPath,[record.entry,'doctor','--json'],{encoding:'utf8',timeout:90000,env:environment});let detail;try{detail=JSON.parse(result.stdout||result.stderr);}catch{detail={ok:false,code:'COMPONENT_DOCTOR_FAILED'};}
-   checks.push({id:'dmp-report-capabilities',ok:result.status===0&&detail.ok===true&&detail.tbcliSnapshot===1&&detail.tbcliItemSummary===1,value:detail});
+   checks.push({id:'dmp-report-capabilities',ok:result.status===0&&detail.ok===true&&detail.tbcliSnapshot===2&&detail.subjectMode==='target-only'&&detail.tbcliItemSummary===1,value:detail});
   }catch(e){checks.push({id:'dmp-report-dependencies',ok:false,code:e.code??'CAPABILITY_UNAVAILABLE',message:e.message});}
  }
  if(n.component==='competitor-visual-canvas'){

package/src/subscription.mjs

@@ -10,7 +10,9 @@ export function compatible(current,next){
  const a=current.split('.').map(Number),b=next.split('.').map(Number);
  return a[0]===b[0]&&(a[0]!==0||a[1]===b[1])&&next.localeCompare(current,undefined,{numeric:true})>=0;
 }
-export async function collectionCheck(previous,registry=fetch){
+export async function collectionCheck(previous,registry=fetch,approved=[]){
+ const selected=new Set(typeof approved==='string'?approved.split(',').map(x=>x.trim()).filter(Boolean):approved);
+ for(const id of selected)if(!Object.hasOwn(MANIFEST.components,id))throw fail('UNKNOWN_COMPONENT',id);
  if(previous&&(previous.package!==PACKAGE.name||!Array.isArray(previous.members)||!stable(previous.version)))throw fail('INVALID_PREVIOUS_COLLECTION','Previous receipt must belong to this collection');
  const members=[];
  for(const [id,c] of Object.entries(MANIFEST.components)){
@@ -19,9 +21,10 @@ export async function collectionCheck(previous,registry=fetch){
   const metadata=await response.json();
   if(metadata.name!==c.package||!stable(metadata.version))throw fail('INVALID_REGISTRY_IDENTITY',c.package);
   const old=previous?.members?.find(m=>m.package===c.package);
-  const accepted=!old||compatible(old.version,metadata.version);
+  const explicitMigration=Boolean(old&&selected.has(id)&&metadata.version.localeCompare(old.version,undefined,{numeric:true})>=0);
+  const accepted=!old||compatible(old.version,metadata.version)||explicitMigration;
   members.push({id,package:c.package,version:accepted?metadata.version:old.version,available:metadata.version,
-   bin:c.bin,skills:c.skills,blocked:!accepted});
+   bin:c.bin,skills:c.skills,blocked:!accepted,explicitMigration});
  }
  const changed=previous?.version!==PACKAGE.version||JSON.stringify(members.map(m=>[m.id,m.package,m.version,m.skills]))!==JSON.stringify(previous?.members?.map(m=>[m.id,m.package,m.version,m.skills]));
  return {ok:true,schemaVersion:1,package:PACKAGE.name,version:PACKAGE.version,changed,members};
@@ -69,7 +72,7 @@ export async function collectionPrepare(opts,services={}){
  const directory=path.resolve(opts.directory);
  if(await stat(directory))throw fail('TARGET_EXISTS','Candidate directory must be new');
  const previous=opts.previous?JSON.parse(await fs.readFile(opts.previous,'utf8')):undefined;
- const plan=await collectionCheck(previous,services.registry);
+ const plan=await collectionCheck(previous,services.registry,opts.acceptComponentUpgrades);
  await fs.mkdir(directory,{recursive:true,mode:0o700});
  try{
   const shell=path.join(directory,'shell'),runtime=path.join(directory,'runtime'),skills=path.join(directory,'skills');

package/suite-manifest.json

@@ -277,7 +277,7 @@
       "skill": "dmp-product-report",
       "component": "dmp-product-report",
       "stage": "competitor-performance-research",
-      "method_version": "dmp-product-report@1",
+      "method_version": "dmp-product-report@2",
       "requires_skills": [
         "tbcli"
       ],
@@ -292,7 +292,6 @@
           "authorized merchant and buyer browser sessions"
         ],
         "optional": [
-          "explicit owned anchor ID",
           "report date",
           "new output directory",
           "previous collected run for offline build/finalize"
@@ -304,8 +303,8 @@
         "state": "child owns collection checkpoints, browser-role guards and report artifacts"
       },
       "required_component_contracts": {
-        "dmp-product-report": "0.1.2+; bundled renderer and finalization contract",
-        "tbcli": "0.11.3+; dmp snapshot version 1 and itemSummary version 1"
+        "dmp-product-report": "0.2.0+; bundled renderer and finalization contract",
+        "tbcli": "0.12.0+; dmp snapshot version 2 target-only subject, automatic owned-item execution context and itemSummary version 1"
       },
       "contract_resolution": "Resolve current exact child Skill and CLI capabilities; preserve the selected merchant/buyer endpoints and returned data availability."
     }