@petercjl/taobao-ai-ops 0.2.1 → 0.3.0

package/README.md

@@ -65,3 +65,11 @@ Node >=20。Python 研究依赖通过稳定解释器准备；TAOBAO_AI_OPS_PYTHO
 The `seedaudio-tools` node registers the independent `@petercjl/seedaudiocli` package and its canonical `seedaudiocli` Skill. Install with `taobao-ai-ops skill install --agent codex --name seedaudiocli` (or the actual SealSeek target). Discover its source with `taobao-ai-ops skill source --name seedaudiocli --json`, read the complete current Skill and relative resources, then invoke `taobao-ai-ops component run seedaudiocli ...` or `tool run seedaudiocli ...`. Return task IDs and output files to the caller's audio acceptance flow. A missing component requires `components install --agent AGENT --yes`; missing credentials require importing the administrator-provided file through the component CLI.
 
 Before every audio component invocation, the suite checks stable latest, installs a newer component into a separate generation and synchronizes registered managed Skill targets. Configuration and task history remain in user directories. Registry/install failures retain the previous version. Local development checkouts remain Git-managed. `TAOBAO_AI_OPS_AUTO_UPDATE=0` pins the installed set for a specific run. Other components keep their declared update policy. The suite owns installation and invocation; the audio package owns provider integration, validation, authentication, generation and recovery. Prompts and output acceptance belong to the caller.
+
+## 1688 components
+
+- `1688cli`: atomic read-only product/supplier query and explicit filtering.
+- `1688-product-sourcing`: keyword/reference-image sourcing application.
+- `1688-opportunity-sourcing-research`: six-category portfolio application from compatible opportunity handoffs.
+
+Each component is an independent `@petercjl` npm package with its own canonical Skill. Use `skill source --name NAME`, `component run NAME ...`, or `tool run 1688cli ...`. The research profile includes all three and their Skill dependency closure. `components install --agent workbuddy --yes` supports the WorkBuddy managed target, alongside Codex and SealSeek; runtime QA remains host-specific.

package/package.json

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

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

@@ -49,3 +49,13 @@ Confirm the selected node, actual source path, method version, source hashes and
 The `seedaudio-tools` node registers the independent `@petercjl/seedaudiocli` package and its canonical `seedaudiocli` Skill. Install with `taobao-ai-ops skill install --agent codex --name seedaudiocli` (or the actual SealSeek target). Discover its source with `taobao-ai-ops skill source --name seedaudiocli --json`, read the complete current Skill and relative resources, then invoke `taobao-ai-ops component run seedaudiocli ...` or `tool run seedaudiocli ...`. Return task IDs and output files to the caller's audio acceptance flow. A missing component requires `components install --agent AGENT --yes`; missing credentials require importing the administrator-provided file through the component CLI.
 
 Before every audio component invocation, the suite checks stable latest, installs a newer component into a separate generation and synchronizes registered managed Skill targets. Configuration and task history remain in user directories. Registry/install failures retain the previous version. Local development checkouts remain Git-managed. `TAOBAO_AI_OPS_AUTO_UPDATE=0` pins the installed set for a specific run. Other components keep their declared update policy. The suite owns installation and invocation; the audio package owns provider integration, validation, authentication, generation and recovery. Prompts and output acceptance belong to the caller.
+
+## 1688 货源与选品应用
+
+按用户目标选择独立组件。单次关键词/图片/链接查询和明确筛选用 `1688cli`；从关键词或参考图形成商品库、视觉分类和报告用 `1688-product-sourcing`；从兼容 `product-opportunities.json` 形成六类策略组合用 `1688-opportunity-sourcing-research`。两项应用均通过原子能力获取平台事实，功能包只负责注册、依赖与安装更新。
+
+执行前运行 `taobao-ai-ops skill source --name <精确Skill名称> --json`，完整读取返回路径的当前 SKILL.md，按其要求解析依赖和相对资源，执行它的主线后回到本路由的交付节点。缺少组件用 `components install --agent <agent> --yes`；契约不兼容保留错误并停止该分支。
+
+输入输出：关键词/图找货应用接收用户需求和约束，交付 HTML、完整商品 JSON 和查询视觉证据；六类应用接收兼容机会交接文件，交付类别组合报告及 sourcing-candidates.json。只有输入契约实际兼容时才串联上游研究结果，不把其他 JSON 当作机会交接文件。
+
+调用应用用 `taobao-ai-ops component run <component> <arguments...>`，原子查询可用 `taobao-ai-ops tool run 1688cli products search "关键词"`。应用方法和模板由各自 npm 包拥有，独立升级。

package/skills/taobao-ai-operations/adapters/workbuddy.json

@@ -0,0 +1,54 @@
+{
+  "schema": "portable-skill-adapter",
+  "schema_version": "1.0.0",
+  "platform": "workbuddy",
+  "skill": "taobao-ai-operations",
+  "mappings": [
+    {
+      "capability_id": "suite.node.route",
+      "implementation": {
+        "kind": "cli-and-host-file-reader",
+        "execution": "Use the current host's command execution and file-reading surfaces to invoke taobao-ai-ops and load the returned source.",
+        "normalization": "Return artifacts, metadata and warnings; preserve structured CLI errors."
+      },
+      "status": "implemented",
+      "configuration": [],
+      "permissions": [
+        "local file read",
+        "new local output"
+      ],
+      "normalization": "Return artifacts, metadata and warnings; preserve structured CLI errors.",
+      "output_contract_differences": [],
+      "evidence": [],
+      "features": [
+        "node_registry",
+        "exact_skill_source",
+        "full_child_instructions",
+        "runtime_preflight"
+      ]
+    },
+    {
+      "capability_id": "suite.evidence.handoff",
+      "implementation": {
+        "kind": "cli-and-host-file-reader",
+        "execution": "Use the current host's command execution and file-reading surfaces to invoke taobao-ai-ops and load the returned source.",
+        "normalization": "Return artifacts, metadata and warnings; preserve structured CLI errors."
+      },
+      "status": "implemented",
+      "configuration": [],
+      "permissions": [
+        "local file read",
+        "new local output"
+      ],
+      "normalization": "Return artifacts, metadata and warnings; preserve structured CLI errors.",
+      "output_contract_differences": [],
+      "evidence": [],
+      "features": [
+        "source_sha256",
+        "exact_candidate",
+        "explicit_query",
+        "new_output_only"
+      ]
+    }
+  ]
+}

package/skills/taobao-ai-operations/capabilities.json

@@ -4,7 +4,8 @@
   "skill": "taobao-ai-operations",
   "target_platforms": [
     "codex",
-    "sealseek"
+    "sealseek",
+    "workbuddy"
   ],
   "capabilities": [
     {

package/src/runtime.mjs

@@ -53,6 +53,12 @@ export async function doctor(id,mode='excel'){
   checks.push({id:'procli-runtime',ok:result.status===0&&version===record.version,value:version});
   checks.push({id:'procli-contract',ok:fs.existsSync(path.join(source(n),'capabilities.json'))});
  }
+ if(['1688cli','1688-product-sourcing','1688-opportunity-sourcing-research'].includes(n.component)){
+  const record=componentRecord(n.component);
+  const result=spawnSync(process.execPath,[record.entry,'doctor','--json'],{encoding:'utf8',timeout:90000,env:pythonEnvironment()});
+  let detail;try{detail=JSON.parse(result.stdout);}catch{detail={code:'COMPONENT_DOCTOR_FAILED'};}
+  checks.push({id:'1688-component-runtime',ok:result.status===0,value:detail});
+ }
  if(n.component==='seedaudiocli'){
   const record=componentRecord(n.component);
   const result=spawnSync(process.execPath,[record.entry,'doctor','--json'],{encoding:'utf8',timeout:30000,env:{...pythonEnvironment(),SEEDAUDIO_AUTO_UPDATE:'0'}});
@@ -67,5 +73,5 @@ export async function doctor(id,mode='excel'){
  }
  if(!['excel','nas'].includes(mode))throw fail('USAGE','Doctor mode must be excel or nas');
  if(mode==='nas'&&n.id==='category-research')for(const id of ['tbcli','yccli']){try{const tool=toolEntry(id);const r=spawnSync(tool.command,[...tool.args,'--version'],{encoding:'utf8',timeout:15000,env:{...process.env,TBCLI_UPDATE_CHECK:'0'}});checks.push({id,ok:r.status===0,value:r.stdout?.trim()});}catch(e){checks.push({id,ok:false,message:e.message});}}
- return {ok:checks.every(c=>c.ok),package:PACKAGE.name,version:PACKAGE.version,node:n.id,mode,checks,native_requirements:n.native_requirements.map(id=>({id,status:'requires-active-agent-verification'})),service_access:mode==='nas'||n.component==='procli'?'not-probed':'not-required'};
+ return {ok:checks.every(c=>c.ok),package:PACKAGE.name,version:PACKAGE.version,node:n.id,mode,checks,native_requirements:n.native_requirements.map(id=>({id,status:'requires-active-agent-verification'})),service_access:mode==='nas'||n.component==='procli'||['1688cli','1688-product-sourcing','1688-opportunity-sourcing-research'].includes(n.component)?'not-probed':'not-required'};
 }

package/src/skill-manager.mjs

@@ -9,6 +9,7 @@ export function targetRoot(opts){
  if(opts.targetDir&&opts.agent)throw fail('USAGE','Choose --agent or --target-dir');
  if(opts.targetDir)return path.resolve(opts.targetDir);
  if(opts.agent==='codex')return path.join(process.env.CODEX_HOME||path.join(os.homedir(),'.codex'),'skills');
+ if(opts.agent==='workbuddy')return process.env.WORKBUDDY_SKILLS_DIR||path.join(process.env.WORKBUDDY_HOME||path.join(os.homedir(),'.workbuddy'),'skills');
  if(opts.agent==='agents')return process.env.AGENT_SKILLS_DIR||path.join(os.homedir(),'.agents','skills');
  if(opts.agent==='sealseek'){
   if(process.env.SEALSEEK_SKILLS_DIR)return path.resolve(process.env.SEALSEEK_SKILLS_DIR);
@@ -17,7 +18,7 @@ export function targetRoot(opts){
   if(choices.length!==1)throw fail('TARGET_UNRESOLVED','Set SEALSEEK_SKILLS_DIR or --target-dir to the active SealSeek Skill root');
   return choices[0];
  }
- throw fail('UNKNOWN_AGENT','Choose codex, agents, sealseek or --target-dir');
+ throw fail('UNKNOWN_AGENT','Choose codex, agents, sealseek, workbuddy or --target-dir');
 }
 import {existsSync as osExists} from 'node:fs';
 async function owners(root){const p=path.join(root,OWNER);if(!await stat(p))return {package:PACKAGE.name,skills:{}};const value=await json(p);if(value.package!==PACKAGE.name)throw fail('OWNERSHIP_CONFLICT','Suite ownership file belongs to another package');return value;}

package/suite-manifest.json

@@ -10,7 +10,10 @@
       "sycmcli-tools",
       "html-report",
       "project-management",
-      "seedaudio-tools"
+      "seedaudio-tools",
+      "sourcing-tools",
+      "product-sourcing",
+      "opportunity-sourcing"
     ]
   },
   "nodes": [
@@ -37,7 +40,10 @@
       "requires_skills": [
         "yuce-category-opportunity-report",
         "taobao-search-product-form",
-        "compact-commerce-ui"
+        "compact-commerce-ui",
+        "1688cli",
+        "1688-product-sourcing",
+        "1688-opportunity-sourcing-research"
       ],
       "python_imports": [],
       "scripts": [],
@@ -145,6 +151,50 @@
       "python_imports": [],
       "scripts": [],
       "native_requirements": []
+    },
+    {
+      "id": "sourcing-tools",
+      "skill": "1688cli",
+      "component": "1688cli",
+      "stage": "sourcing-capability",
+      "method_version": "1688-contract@1",
+      "requires_skills": [],
+      "python_imports": [],
+      "scripts": [],
+      "native_requirements": []
+    },
+    {
+      "id": "product-sourcing",
+      "skill": "1688-product-sourcing",
+      "component": "1688-product-sourcing",
+      "stage": "product-sourcing",
+      "method_version": "1688-product-sourcing@1",
+      "requires_skills": [
+        "1688cli",
+        "compact-commerce-ui"
+      ],
+      "python_imports": [],
+      "scripts": [],
+      "native_requirements": [
+        "image.observe",
+        "browser.report.inspect"
+      ]
+    },
+    {
+      "id": "opportunity-sourcing",
+      "skill": "1688-opportunity-sourcing-research",
+      "component": "1688-opportunity-sourcing-research",
+      "stage": "opportunity-portfolio",
+      "method_version": "1688-opportunity-sourcing-research@1",
+      "requires_skills": [
+        "1688cli"
+      ],
+      "python_imports": [],
+      "scripts": [],
+      "native_requirements": [
+        "image.observe",
+        "browser.report.inspect"
+      ]
     }
   ],
   "tools": {
@@ -180,12 +230,30 @@
       "package": "@petercjl/seedaudiocli",
       "component": "seedaudiocli",
       "role": "audio generation, reference voices, image-conditioned audio and task recovery"
+    },
+    "1688cli": {
+      "package": "@petercjl/1688cli",
+      "component": "1688cli",
+      "role": "sourcing-capability"
+    },
+    "1688-product-sourcing": {
+      "package": "@petercjl/1688-product-sourcing",
+      "component": "1688-product-sourcing",
+      "role": "product-sourcing"
+    },
+    "1688-opportunity-sourcing-research": {
+      "package": "@petercjl/1688-opportunity-sourcing-research",
+      "component": "1688-opportunity-sourcing-research",
+      "role": "opportunity-portfolio"
     }
   },
   "targets": {
     "codex:macos": "implemented",
     "sealseek:macos": "implemented",
-    "sealseek:windows": "implemented"
+    "sealseek:windows": "implemented",
+    "codex:windows": "implemented",
+    "workbuddy:macos": "implemented",
+    "workbuddy:windows": "implemented"
   },
   "update_policy": {
     "owner": "shell",
@@ -248,6 +316,27 @@
         "seedaudiocli"
       ],
       "automatic_update": true
+    },
+    "1688cli": {
+      "package": "@petercjl/1688cli",
+      "bin": "1688cli",
+      "skills": [
+        "1688cli"
+      ]
+    },
+    "1688-product-sourcing": {
+      "package": "@petercjl/1688-product-sourcing",
+      "bin": "1688-product-sourcing",
+      "skills": [
+        "1688-product-sourcing"
+      ]
+    },
+    "1688-opportunity-sourcing-research": {
+      "package": "@petercjl/1688-opportunity-sourcing-research",
+      "bin": "1688-opportunity-sourcing-research",
+      "skills": [
+        "1688-opportunity-sourcing-research"
+      ]
     }
   }
 }