@petercjl/competitor-visual-canvas 0.1.1 → 0.1.7

package/INSTALL.md

@@ -0,0 +1,7 @@
+# Install for the current Agent
+
+User prompt: “请安装 @petercjl/competitor-visual-canvas，并配置当前 Agent 使用。”
+
+The executing Agent installs the npm package, resolves its own exact Skill directory and registration mechanism, reads `skill source --json`, then runs `skill install --agent CURRENT --path ABSOLUTE_SKILL_DIRECTORY --json`. Node 22+ is required. Installation copies canonical resources and an independent runtime, preserves host metadata, and refuses user-owned targets. Verify CLI version, managed/current status and SHA256 verification, then load the Skill through native host discovery. npm success with Skill or registration pending is incomplete. Scripts-disabled installation uses this same handoff.
+
+Service capabilities are separate installations: tbcli for collection, boardmixcli videoContract v1 (0.1.6+) for Boardmix, or sealseek-media for Infinite Canvas. Boardmix videos require ffprobe. Login occurs in the selected service; package installation grants no service access.

package/README.md

@@ -1,8 +1,8 @@
 # Competitor visual canvas
 
-Application package for collecting Taobao/Tmall visual references into SealSeek Infinite Canvas. The application owns the collection workflow and layout. `@petercjl/tbcli` owns product collection; `@petercjl/sealseek-media-cli` owns service authentication and generic canvas operations.
+Application package for collecting Taobao/Tmall visual references into Infinite Canvas or explicitly selected Boardmix. The application owns the collection workflow and layout. `@petercjl/tbcli` owns product collection; `@petercjl/sealseek-media-cli` owns service authentication and generic canvas operations.
 
-Requires Node.js 22+, `tbcli item media`, and SealSeek `canvas batch` (including text-batch) / `media inspect` capabilities. Service credentials stay with the dependency packages. The public npm package supports Codex, SealSeek and WorkBuddy adapters. macOS Codex business runs are verified; other host runtime evidence is separate from portable package tests.
+Requires Node.js 22+, `tbcli item media`, and SealSeek `canvas batch` (including text-batch) / `media inspect` capabilities. Service credentials stay with the dependency packages. Any Agent with the required execution capabilities can use the generic adapter. macOS Codex business runs are verified; other host runtime evidence is separate from portable package tests.
 
 ```sh
 competitor-visual-canvas doctor --json
@@ -48,8 +48,22 @@ Agent prompt: “用竞品视觉素材画板工具，找到画板‘我的竞品
 
 ## Installation and updates
 
-Install `@petercjl/competitor-visual-canvas` globally, then use `competitor-visual-canvas skill install --agent codex|sealseek|workbuddy --json` for the current Agent. Its npm dependencies provide compatible tbcli and sealseek-media CLIs; service authorization remains separate. SealSeek resolves the active default workspace or a configured SEALSEEK_SKILLS_DIR; ambiguous roots require an explicit --path.
+向当前使用的 Agent 发送：“请安装 @petercjl/competitor-visual-canvas，并配置当前 Agent 使用。”
 
-Global installations check stable latest on business invocation once per day, download/install a newer version, refresh already managed Skills with backups and run the original command once. Local edits stop automatic synchronization. Offline checks keep the current version; interrupted updates retain package backups in private state. `update auto status|on|off` controls the policy, and `update install --yes` forces a check. Suite-local installations stay managed by taobao-ai-ops; Git development stays Git-owned. Custom Skill paths need explicit skill synchronization.
+更新提示词：“请更新 @petercjl/competitor-visual-canvas，并同步当前 Agent 的 Skill。”
+
+The executing Agent follows [INSTALL.md](INSTALL.md) or [UPDATE.md](UPDATE.md), resolves its exact Skill directory, preserves edits, synchronizes only that target and verifies the CLI, independent runtime, receipt hashes and native discovery. Ordinary invocations notify about stable updates daily; automatic installation requires explicit opt-in and a selected target. Service dependencies and login remain separate. Git checkouts stay Git-owned.
 
 Application run directories and credential profiles stay outside npm. Continue a canvas from its newest completed run; backup and unknown-write recovery use that existing canvas rather than creating another.
+
+## Boardmix 素材归档
+
+默认使用无限画板。用户明确指定 Boardmix 时，应用改用 boardmixcli 归档主图、主图视频、SKU 图和详情图；视频使用原生 MP4 对象，支持为已有图片画板补充视频。
+
+> 使用 competitor-visual-canvas 收集这些竞品的图片素材到 Boardmix：提供商品链接或 ID。
+
+Boardmix 分支要求当前 boardmixcli 具有 frame.create、text.create 和 image.download 能力，通过 boardmixcli 准备 Chrome 登录与每个编辑器的授权连接。目标、来源、布局和 GUID 回执保存于应用运行目录；同一运行可恢复。macOS 已验证浏览器接入；追加使用最新已完成运行目录，通过 append --base-run 复用原文件并保持已有图元坐标。按 Boardmix 名称查找仍未支持。
+
+Boardmix writes discover batch contract v1 automatically: up to 20 images per import, batch placement/readback, and receipt-based resume. Layout decisions remain in this application; older capability packages retain the serial path.
+
+For an authorized Chrome CDP session, Boardmix create/canvas accept `--cdp-endpoint URL` to open and connect the exact file through boardmixcli without visible DevTools. Existing run identity and receipts are retained on connection failure.

package/UPDATE.md

@@ -0,0 +1,7 @@
+# Update the current Agent
+
+User prompt: “请更新 @petercjl/competitor-visual-canvas，并同步当前 Agent 的 Skill。”
+
+Resolve the current Agent and exact Skill directory before package replacement. Use `update install --agent CURRENT --path ABSOLUTE_SKILL_DIRECTORY --yes --json`, or install an exact approved npm version and run its `skill update` with the same selected target. Preserve edits and inspect backup/recovery output. Same-version maintenance reconciles stale resources. Verify CLI, Skill runtime and receipt versions, managed/current SHA256 status, and native discovery. Other Agent targets are unchanged. A source checkout updates through Git.
+
+Ordinary invocations detect stable updates daily with bounded network time and offline backoff. Automatic installation is opt-in via COMPETITOR_CANVAS_AUTO_INSTALL=1 with explicit COMPETITOR_CANVAS_AGENT and COMPETITOR_CANVAS_SKILL_PATH. `update auto off` disables checks. Unknown or partial outcomes require inspecting the existing package and selected Skill before retrying.

package/bin/competitor-visual-canvas.mjs

@@ -5,20 +5,26 @@ import {performUpdate,latestVersion,updateStatus,setAutomatic} from '../src/upda
 import {collect,planRun,publishCanvas,invoke,read,fail,configureTool,appendRun} from '../src/workflow.mjs';
 import {reflowRun} from '../src/reflow.mjs';
 import {findCanvases,appendToCanvas} from '../src/canvas-target.mjs';
+import {createBoardmix,writeBoardmix,recoverBoardmix,requireBoardmix,addBoardmixVideos} from '../src/boardmix.mjs';
 import {ROOT,META,skill} from '../src/lifecycle.mjs';
 const argv=process.argv.slice(2),command=argv.shift(),options={},args=[];
-function parse(){for(let i=0;i<argv.length;i++){const k=argv[i];if(k==='--json')continue;if(['--submit','--yes'].includes(k)){options[k.slice(2)]=true;continue;}if(k.startsWith('--')){const key=k.slice(2),value=argv[++i];if(!value||value.startsWith('--'))fail('INVALID_INPUT','Missing '+k);if(!['input','raw','run','title','agent','canvas','tool','entry','base-run','path'].includes(key))fail('INVALID_INPUT','Unknown '+k);(options[key]??=[]).push(value);}else args.push(k);}}
+function parse(){for(let i=0;i<argv.length;i++){const k=argv[i];if(k==='--json')continue;if(['--submit','--yes','--verified'].includes(k)){options[k.slice(2)]=true;continue;}if(k.startsWith('--')){const key=k.slice(2),value=argv[++i];if(!value||value.startsWith('--'))fail('INVALID_INPUT','Missing '+k);if(!['input','raw','run','title','agent','canvas','tool','entry','base-run','path','target','session','file-key','cdp-endpoint','session-id','local-id'].includes(key))fail('INVALID_INPUT','Unknown '+k);(options[key]??=[]).push(value);}else args.push(k);}}
 const one=k=>options[k]?.at(-1);
 const help=`competitor-visual-canvas ${META.version}
   collect --input ID_OR_URL [--input MORE] --run NEW_DIR [--raw SAVED_COLLECTION.json ...] --json
+  collect --target boardmix --input ID_OR_URL --run NEW_DIR --json
+  boardmix videos --base-run COMPLETED_DIR --run NEW_DIR [--raw COLLECTION ...] --json
+  boardmix create --run DIR --session FILE --file-key SOURCE_KEY [--cdp-endpoint URL] --submit --json
+  boardmix recover --run DIR --session FILE --file-key KEY --session-id N --local-id N [--verified] --submit --json
+  canvas --run DIR --session FILE --file-key KEY [--cdp-endpoint URL] [--submit] --json (dispatches saved target)
   plan --run DIR [--title TEXT] [--base-run COMPLETED_DIR] --json
   find --title EXACT_TITLE --json (read-only exact-name lookup)
   append (--base-run COMPLETED_DIR | --title EXACT_TITLE | --canvas ID) --run NEW_DIR --input ID_OR_URL [--input MORE] [--raw FILE ...] --json
   reflow --run DIR [--submit] --json (migrate a legacy canvas to horizontal regions)
   canvas --run DIR [--submit] --json
   recover --run DIR --canvas ID --submit --json (bind verified existing canvas after uncertain creation)
-  tool run tbcli|sealseek-media ARGS...
-  configure --tool tbcli|sealseek-media --entry CLI_PATH --submit --json
+  tool run tbcli|sealseek-media|boardmixcli ARGS...
+  configure --tool tbcli|sealseek-media|boardmixcli --entry CLI_PATH --submit --json
   version | capabilities --json | doctor --json
   skill source|status|install|update [--agent codex|sealseek|workbuddy] [--path DIR] --json
   update check|install --yes --json
@@ -28,30 +34,37 @@ Global npm installations check stable updates daily during use and synchronize m
 Source development and suite-managed installations use their owner update path.`;
 async function main(){
   if(!command||['--help','help'].includes(command))return {help};
-  if(command==='tool'&&argv[0]==='run'){const tool=argv[1];if(!['tbcli','sealseek-media'].includes(tool))fail('INVALID_INPUT','Unknown dependency.');return invoke(tool,argv.slice(2));}
-  parse();
+  if(command==='skill'&&argv.includes('--help')){const caps=await read(path.join(ROOT,'capabilities.json'));const contract=caps.commandContracts['skill '+argv[0]];if(!contract)fail('INVALID_INPUT','Unknown Skill operation.');return contract;}
+  if(command==='tool'&&argv[0]==='run'){const tool=argv[1];if(!['tbcli','sealseek-media','boardmixcli'].includes(tool))fail('INVALID_INPUT','Unknown dependency.');return invoke(tool,argv.slice(2));}
+  parse();if(one('target')&&!['infinite-canvas','boardmix'].includes(one('target')))fail('INVALID_TARGET','Choose infinite-canvas or boardmix.');
   if(command==='configure'){if(!options.submit)fail('SUBMIT_REQUIRED','Configuring dependency entry requires --submit.');return configureTool(one('tool'),one('entry'));}
   if(command==='version')return {version:META.version};
   if(command==='skill')return skill(args[0],one('agent'),one('path'));
-  if(command==='capabilities')return {...await read(path.join(ROOT,'skills','competitor-visual-canvas','capabilities.json')),execution:{frame_grouping:'four-per-product',inputs:'Taobao IDs or Taobao/Tmall detail URLs',archive:'canvas',supported_platform:process.platform==='darwin'?'macos':'unverified'}};
+  if(command==='capabilities')return {...await read(path.join(ROOT,'skills','competitor-visual-canvas','capabilities.json')),execution:{frame_grouping:'four-per-product',inputs:'Taobao IDs or Taobao/Tmall detail URLs',archive:'canvas',targets:['infinite-canvas','boardmix'],default_target:'infinite-canvas',supported_platform:process.platform==='darwin'?'macos':'unverified'}};
+  if(command==='doctor'&&one('target')==='boardmix'){await requireBoardmix();const source=await invoke('tbcli',['skill','source','--json']);return {ok:!!source,target:'boardmix',service_access:'not-checked'};}
   if(command==='doctor'){const checks=[];for(const tool of ['tbcli','sealseek-media'])try{const source=await invoke(tool,['skill','source','--json']),capabilities=await invoke(tool,['capabilities','--json']);const s=source.source??source.data?.source;const valid=tool==='tbcli'?JSON.stringify(capabilities).includes('item media'):['frame-batch','text-batch','media-inspect','source-metadata'].every(f=>capabilities.manifest?.canvas_contract?.features?.includes(f));checks.push({tool,source:s,ok:!!s&&valid});}catch(e){checks.push({tool,ok:false,code:e.code??'CLI_UNAVAILABLE'});}return {ok:checks.every(c=>c.ok),checks,node:process.version,service_access:'not-checked'};}
   if(command==='update'){
     if(args[0]==='check'){const latest=await latestVersion();return {current:META.version,latest,updateAvailable:latest!==META.version};}
     if(args[0]==='auto'){if(args[1]==='status')return updateStatus();if(['on','off'].includes(args[1]))return setAutomatic(args[1]==='on');}
-    if(args[0]==='install'){if(!options.yes)fail('AUTHORIZATION_REQUIRED','Use --yes for package update.');return performUpdate({automatic:false});}
+    if(args[0]==='install'){if(!options.yes)fail('AUTHORIZATION_REQUIRED','Use --yes for package update.');if(!one('agent')||!one('path'))fail('TARGET_UNRESOLVED','Provide the current Agent and explicit --path.');const {status}=await import('../src/skills.mjs');return performUpdate({automatic:false,targets:async()=>{const s=await status(one('agent'),one('path'));if(s.edited)fail('LOCAL_EDITS','Selected Skill has local edits.');if(s.installed&&!s.managed)fail('UNMANAGED_TARGET','Selected Skill is user-owned.');return [{agent:one('agent'),path:s.destination}];}});}
     fail('INVALID_INPUT','Use update check/install or auto status/on/off.');
   }
-  if(command==='find')return findCanvases(one('title'));
+  if(command==='find'){if(one('target')==='boardmix')fail('FEATURE_UNSUPPORTED','Use an explicit Boardmix file key or its saved run.');return findCanvases(one('title'));}
   const run=one('run');if(!run)fail('INVALID_INPUT','Provide --run DIR.');
-  if(command==='collect'){const result=await collect(path.resolve(run),options.input||[],options.raw||[]);return {run_id:result.run_id,run:path.resolve(run),products:result.products.map(p=>({id:p.id,title:p.title,counts:Object.fromEntries(Object.entries(p.assets).map(([k,v])=>[k,v.length]))}))};}
-  if(command==='plan')return planRun(path.resolve(run),{title:one('title'),baseRun:one('base-run')?path.resolve(one('base-run')):undefined});
+  if(command==='collect'){const result=await collect(path.resolve(run),options.input||[],options.raw||[],one('target')||'infinite-canvas');return {run_id:result.run_id,target:result.target,run:path.resolve(run),products:result.products.map(p=>({id:p.id,title:p.title,counts:Object.fromEntries(Object.entries(p.assets).map(([k,v])=>[k,v.length]))}))};}
+  if(command==='plan')return planRun(path.resolve(run),{target:one('target'),title:one('title'),baseRun:one('base-run')?path.resolve(one('base-run')):undefined});
+  const boardmixOptions={cdpEndpoint:one('cdp-endpoint'),session:one('session'),fileKey:one('file-key'),submit:!!options.submit,verified:!!options.verified,sessionID:one('session-id')===undefined?undefined:Number(one('session-id')),localID:one('local-id')===undefined?undefined:Number(one('local-id'))};
+  if(command==='boardmix'){if(one('target')&&one('target')!=='boardmix')fail('TARGET_CONFLICT','Boardmix command conflicts with the explicit target.');if(args[0]==='videos')return addBoardmixVideos(path.resolve(run),one('base-run')?path.resolve(one('base-run')):undefined,options.raw||[]);if(args[0]==='create'){if(!options.submit)fail('SUBMIT_REQUIRED','Use --submit to create the target file.');return createBoardmix(path.resolve(run),boardmixOptions);}if(args[0]==='recover'){if(!options.submit)fail('SUBMIT_REQUIRED','Use --submit for recovery.');return recoverBoardmix(path.resolve(run),boardmixOptions);}fail('INVALID_INPUT','Use boardmix create/recover.');}
   if(command==='append'){
+    if(one('target')==='boardmix'&&!one('base-run'))fail('FEATURE_UNSUPPORTED','Boardmix append requires --base-run from the latest completed run.');
+    if(one('base-run')&&one('target')&&one('target')!==((await read(path.join(one('base-run'),'layout.plan.json'))).target||'infinite-canvas'))fail('TARGET_CONFLICT','Requested target differs from base run.');
     if(one('base-run')){if(one('title')||one('canvas'))fail('INVALID_INPUT','Use a base run or a canvas selector.');return appendRun(path.resolve(run),path.resolve(one('base-run')),options.input||[],options.raw||[]);}
     return appendToCanvas(path.resolve(run),{title:one('title'),canvas:one('canvas')},options.input||[],options.raw||[]);
   }
+  if(command==='reflow'&&(await read(path.join(run,'layout.plan.json'))).target==='boardmix')fail('FEATURE_UNSUPPORTED','Boardmix layout migration is not yet supported.');
   if(command==='reflow')return reflowRun(path.resolve(run),!!options.submit);
-  if(command==='canvas')return publishCanvas(path.resolve(run),!!options.submit);
-  if(command==='recover'){if(!one('canvas')||!options.submit)fail('SUBMIT_REQUIRED','Recovery requires --canvas ID --submit.');const {checkpoint}=await import('../src/workflow.mjs');const plan=await read(path.join(run,'layout.plan.json')),board=await invoke('sealseek-media',['canvas','get',one('canvas'),'--json']);if(board.title!==plan.title)fail('STATE_CONFLICT','Recovered canvas title differs.');await checkpoint(path.join(run,'canvas.state.json'),{run_id:plan.run_id,canvas_id:board.canvas_id,canvas_url:board.canvas_url,status:'recovered'});return {recovered:true,...board};}
+  if(command==='canvas'){const p=await read(path.join(run,'layout.plan.json'));const target=p.target||'infinite-canvas';if(one('target')&&one('target')!==target)fail('TARGET_CONFLICT','Requested target differs from saved run.');return target==='boardmix'?writeBoardmix(path.resolve(run),boardmixOptions):publishCanvas(path.resolve(run),!!options.submit);}
+  if(command==='recover'){if((await read(path.join(run,'layout.plan.json'))).target==='boardmix')fail('TARGET_CONFLICT','Use boardmix recover for this target.');if(!one('canvas')||!options.submit)fail('SUBMIT_REQUIRED','Recovery requires --canvas ID --submit.');const {checkpoint}=await import('../src/workflow.mjs');const plan=await read(path.join(run,'layout.plan.json')),board=await invoke('sealseek-media',['canvas','get',one('canvas'),'--json']);if(board.title!==plan.title)fail('STATE_CONFLICT','Recovered canvas title differs.');await checkpoint(path.join(run,'canvas.state.json'),{run_id:plan.run_id,canvas_id:board.canvas_id,canvas_url:board.canvas_url,status:'recovered'});return {recovered:true,...board};}
   fail('INVALID_INPUT','Unknown command.');
 }
 async function execute(){

package/capabilities.json

@@ -0,0 +1,158 @@
+{
+  "installationLifecycle": {
+    "agentNeutral": true,
+    "targetRequired": true,
+    "hostRegistrationRequired": true,
+    "installationMode": "copy",
+    "sharedLinksAllowed": false,
+    "isolatedRuntimeRequired": true,
+    "skillRequired": true,
+    "updateRequiresSkillSync": true,
+    "required_components": [
+      "cli",
+      "skill"
+    ],
+    "installGuide": "INSTALL.md",
+    "updateGuide": "UPDATE.md",
+    "install": "skill install with explicit current Agent and --path",
+    "update": "update install with explicit current Agent and --path",
+    "verification": "CLI and target-owned runtime versions, managed SHA256 receipt, host discovery",
+    "installerIntegration": "postinstall notice and scripts-disabled INSTALL.md"
+  },
+  "automaticUpdates": {
+    "enabledByDefault": true,
+    "intervalHours": 24,
+    "timeoutMs": 3000,
+    "trigger": "ordinary CLI execution",
+    "defaultMode": "notify",
+    "disable": "COMPETITOR_CANVAS_AUTO_UPDATE=0"
+  },
+  "maintenanceContract": {
+    "schemaVersion": 1,
+    "agentEligibility": "valid-name-with-generic-fallback",
+    "hostDiscoveryAuthority": "host",
+    "targetOptions": {
+      "--path": {
+        "kind": "skill-directory"
+      }
+    },
+    "source": {
+      "name": {
+        "field": "name",
+        "type": "string"
+      },
+      "package": {
+        "field": "package",
+        "type": "string"
+      },
+      "version": {
+        "field": "version",
+        "type": "string"
+      },
+      "path": {
+        "field": "source",
+        "type": "string"
+      }
+    },
+    "status": {
+      "name": {
+        "field": "name",
+        "type": "string"
+      },
+      "package": {
+        "field": "package",
+        "type": "string"
+      },
+      "version": {
+        "field": "version",
+        "type": "string"
+      },
+      "target": {
+        "field": "target",
+        "type": "string"
+      },
+      "installed": {
+        "field": "installed",
+        "type": "boolean"
+      },
+      "managed": {
+        "field": "managed",
+        "type": "boolean"
+      },
+      "current": {
+        "field": "current",
+        "type": "boolean"
+      },
+      "edited": {
+        "field": "edited",
+        "type": "boolean"
+      },
+      "verification": {
+        "field": "verification",
+        "type": "object"
+      },
+      "recovery": {
+        "field": "recovery",
+        "type": "object"
+      }
+    }
+  },
+  "commandContracts": {
+    "skill source": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string"
+        },
+        "--path": {
+          "type": "string"
+        }
+      },
+      "sideEffects": "none"
+    },
+    "skill status": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string"
+        },
+        "--path": {
+          "type": "string"
+        }
+      },
+      "sideEffects": "none"
+    },
+    "skill install": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string"
+        },
+        "--path": {
+          "type": "string"
+        }
+      },
+      "sideEffects": "local-write"
+    },
+    "skill update": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string"
+        },
+        "--path": {
+          "type": "string"
+        }
+      },
+      "sideEffects": "local-write"
+    }
+  }
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@petercjl/competitor-visual-canvas",
-  "version": "0.1.1",
+  "version": "0.1.7",
   "type": "module",
-  "description": "Collect product visual assets and organize them into SealSeek canvas regions",
+  "description": "Collect competitor visual assets and archive into Infinite Canvas or explicitly selected Boardmix",
   "bin": {
     "competitor-visual-canvas": "bin/competitor-visual-canvas.mjs"
   },
@@ -10,7 +10,10 @@
     "bin",
     "src",
     "skills",
-    "README.md"
+    "README.md",
+    "INSTALL.md",
+    "UPDATE.md",
+    "capabilities.json"
   ],
   "engines": {
     "node": ">=22"
@@ -20,8 +23,10 @@
     "access": "public"
   },
   "scripts": {
-    "test": "node --test",
-    "check": "node --check bin/competitor-visual-canvas.mjs && node --test"
+    "test": "node --test test/*.test.mjs",
+    "check": "node --check bin/competitor-visual-canvas.mjs && node --test test/*.test.mjs",
+    "prepack": "node src/validate-package.mjs",
+    "postinstall": "node -e \"console.log('Complete current-Agent Skill installation: see INSTALL.md and UPDATE.md')\""
   },
   "repository": {
     "type": "git",
@@ -29,7 +34,15 @@
   },
   "homepage": "https://github.com/petercjl/competitor-visual-canvas#readme",
   "dependencies": {
-    "@petercjl/tbcli": "^0.10.5",
+    "@petercjl/tbcli": "^0.11.1",
     "@petercjl/sealseek-media-cli": "^0.5.1"
+  },
+  "peerDependencies": {
+    "@petercjl/boardmixcli": ">=0.1.6"
+  },
+  "peerDependenciesMeta": {
+    "@petercjl/boardmixcli": {
+      "optional": true
+    }
   }
 }

package/skills/competitor-visual-canvas/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: competitor-visual-canvas
-description: Collect Taobao or Tmall product main images, main videos, detail images and SKU images from IDs or links, then organize them into four regional Frames per product in SealSeek Infinite Canvas. Use for collecting competitor visual references into a canvas.
+description: Collect Taobao or Tmall product main images, main videos, detail images and SKU images from IDs or links, then organize them into regional Frames per product in default Infinite Canvas or explicitly selected Boardmix. Use for collecting competitor visual references into a canvas.
 ---
 
 # 竞品视觉素材画板
@@ -9,9 +9,9 @@ description: Collect Taobao or Tmall product main images, main videos, detail im
 
 输入：一个或多个商品 ID 或淘宝/天猫详情链接，可选画板名称。纯数字 ID 默认为淘宝，按输入顺序去重。输出：原始采集结果、可复用素材清单、排版计划、运行状态、核验报告和画板链接。
 
-应用负责素材组织、命名、Frame 分组、排版和业务验收；tbcli 负责商品媒体采集；sealseek-media-cli 负责认证、媒体元信息和画板写入。采用 direct 方法：业务规则来自用户确认，服务限制来自运行时能力契约。无需私有知识库。此流程导入已有素材，无需生图或生视频。
+应用负责素材组织、命名、Frame 分组、排版和业务验收；tbcli 负责商品媒体采集；画板认证、媒体接入和写入由所选目标的 sealseek-media-cli 或 boardmixcli 负责。采用 direct 方法：固定业务规则与新增目标路由来自用户确认，服务限制来自运行时能力契约。无需私有知识库。此流程导入已有素材，无需生图或生视频。
 
-每个商品建立四个 Frame，分别位于主图、主图视频、SKU、详情页四个大区；Frame 名称为商品所在店铺名称。四个大区从左到右依次为主图、主图视频、SKU、详情页，横向起点固定。前三个区域预留宽度，新增商品向下追加；最右侧详情页区向右追加。Frame 位置由实际尺寸和已保存区域边界确定，追加保持已有 Frame 和素材的坐标不变。单商品画板使用商品名称；多商品默认“首个商品名称 等N款”，用户指定名称优先。
+两个画板分支均为每个商品建立四个 Frame，分别位于主图、主图视频、SKU、详情页四个大区；Frame 名称为商品所在店铺名称。四个大区从左到右依次为主图、主图视频、SKU、详情页，横向起点固定。前三个区域预留宽度，新增商品向下追加；最右侧详情页区向右追加。Frame 位置由实际尺寸和已保存区域边界确定，追加保持已有 Frame 和素材的坐标不变。单商品画板使用商品名称；多商品默认“首个商品名称 等N款”，用户指定名称优先。
 
 | 区域 | Frame 内部 | 同类 Frame 之间 |
 | --- | --- | --- |
@@ -20,11 +20,21 @@ description: Collect Taobao or Tmall product main images, main videos, detail im
 | SKU | 原顺序网格，每行最多5张 | 商品输入顺序上下排 |
 | 详情页 | 原顺序无间隙竖排，统一宽度、等比缩放 | 商品输入顺序左右排 |
 
-每个大区顶部写入独立文字标题：主图区、主图视频区、SKU区、详情页区。标题属于画板文字元素，追加商品时复用。详情页图片首尾相接，图片间距为0，保留 Frame 外边距。图片按真实宽高等比展示；长详情图保持完整。SKU 同一区域相同链接归并，属性和 SKU 对应关系保留。空视频列表仍保留对应 Frame，并在报告中注明；未读到视频列表标 unavailable，不视为没有视频。
+四区域顶部写入独立文字标题：主图区、主图视频区、SKU区、详情页区。标题属于画板文字元素，追加商品时复用。详情页图片首尾相接，图片间距为0，保留 Frame 外边距。图片按真实宽高等比展示；长详情图保持完整。SKU 同一区域相同链接归并，属性和 SKU 对应关系保留。空视频列表仍保留对应 Frame，并在报告中注明；未读到视频列表标 unavailable，不视为没有视频。
+
+## 运行入口
+
+从当前宿主实际加载的 Skill 目录解析 `.runtime/bin/competitor-visual-canvas.mjs`，以 Node.js 执行；下文命令前缀代表这个目标自有入口。npm 源码目录使用包 CLI。应用自己的运行时随托管 Skill 物理复制；tbcli、boardmixcli 与 sealseek-media 属于独立能力包，通过配置、可用的 npm 依赖或 PATH 解析，按所选分支加载其当前规范 Skill。应用安装更新使用拥有源码的 npm 包 CLI，仅同步当前选定宿主的明确目标目录；更新后核验版本、文件哈希与宿主发现状态。
+
+## 目标画板路由
+
+用户明确指定 Boardmix 时选择 `target=boardmix`，按 [Boardmix 素材分支](references/boardmix.md) 执行依赖解析、采集、规划、写入与恢复，再回到本 Skill 的交付验收。该分支写入主图、主图视频、SKU 图、详情图四个区域；视频以原生可播放对象导入。既有 run 以保存目标为准，恢复沿用同一文件；请求目标与运行状态冲突时停止。
+
+用户未指定目标时默认 `target=infinite-canvas`，执行下面原有四区域主线。目标路由发生在依赖加载前，只检查和调用当前分支所需的服务。输入商品、素材分类、顺序、布局与业务验收均由本应用决定；Boardmix 的底层操作由其能力包承担。
 
 ## 运行主线
 
-1. 解析当前平台，加载对应 `adapters/codex.json` 、`adapters/sealseek.json` 或 `adapters/workbuddy.json`。发现 `competitor-visual-canvas version` 和 `doctor --json`。doctor 成功只是本地依赖检查。依赖不满足时停止受影响节点。
+1. 解析当前宿主，加载对应适配器；未命名宿主使用 `adapters/generic.json`，依据实际执行、文件和桌面能力判断可用性。发现 `competitor-visual-canvas version` 和 `doctor --json`。doctor 成功只是本地依赖检查。依赖不满足时停止受影响节点。
 2. 解析精确依赖 Skill：分别执行 `competitor-visual-canvas tool run tbcli skill source --json` 和 `competitor-visual-canvas tool run sealseek-media skill source --json`，读取返回路径下完整当前 SKILL.md、当前主机适配与任务相关参考。通过同一 tool run 入口发现当前版本及 capabilities；要求 tbcli 支持 item media、SealSeek 支持 frame-batch、text-batch 和 media-inspect。认证和采集/写入安全规则遵循各自插件。依赖缺失返回 CAPABILITY_UNAVAILABLE，不能自行编写 API 替代。
 3. 选择新的运行目录，执行 `competitor-visual-canvas collect --input ID_OR_URL [--input MORE] --run NEW_DIR --json`。应用逐商品调用 tbcli，先保存 raw 与 assets.manifest.json。已有 item media 原始结果可用重复 `--raw FILE` 导入；身份必须匹配。每个成功商品立即落盘。
 4. 检查覆盖状态；登录、验证和访问异常按 tbcli 分支处理。采集错误不能据此继续请求下一个商品。返回主线第3步时使用新采集输出，保留既有结果。媒体缺失、unknown 和 absent 明确区分，部分交付须说明范围。
@@ -36,6 +46,8 @@ description: Collect Taobao or Tmall product main images, main videos, detail im
 
 ## 向已有画板追加商品
 
+Boardmix 追加使用最新完成运行目录，按 [Boardmix 分支追加合同](references/boardmix.md) 执行；以下名称查找和云端恢复适用于无限画板。
+
 用户给出已有画板名称时，按完整名称精确查找：`competitor-visual-canvas find --title EXACT_TITLE --json`。唯一匹配时执行 `competitor-visual-canvas append --title EXACT_TITLE --run NEW_DIR --input ID_OR_URL [--input MORE] --json`，再按主线第6、7步预览、提交与核验。名称可包含空格与中文，作为完整参数传入。用户提供画板 ID 或链接时可使用 `append --canvas ID`。同名候选由用户选择，随后传 `--canvas ID`；也可同时传 `--title` 校验名称。CANVAS_NOT_FOUND 时报告未找到，不自动新建。
 
 名称或 ID 追加从服务端读取当前内容，恢复本应用四区域 Frame、商品来源、已有素材及布局边界；无需旧对话或本地运行目录。恢复快照保存在本应用私有状态目录，输出 recovered_base_run。恢复依据元素的来源元数据及稳定 Frame 标识，支持空视频 Frame；保留已有元素的坐标、链接、归属和区域标题尺寸。原始采集证据、商品完整标题、SKU 属性等未保存在云端的信息标为 unavailable，不凭空补全。该方式适用于本应用当前四区域结构；缺少元数据、Frame 不完整或混入无法识别元素时返回 CANVAS_STATE_UNSUPPORTED，保留画板，使用可用的完整运行目录或交由用户决定如何整理。恢复和选择均只读，canvas --submit 才写入画板。
@@ -61,8 +73,8 @@ description: Collect Taobao or Tmall product main images, main videos, detail im
 
 ## 安装、维护与 QA
 
-通过本包 CLI `skill source/status/install/update --agent codex|sealseek|workbuddy --json` 管理当前 Skill，source 是唯一来源。安装不授予淘宝或 SealSeek 服务访问权限。全局 npm 安装在业务命令启动时每日检查 latest 并自动下载安装、同步已管理 Skill 后重新执行原命令；离线沿用当前版本，更新失败保留备份，已有运行状态与服务凭证保持在包外。套件内部安装由 taobao-ai-ops 统一更新，源码由 Git 管理。手动更新使用 update install --yes；检查或开关自动更新使用 update check 和 update auto status/on/off。依赖 CLI 优先使用显式配置，其次解析本 npm 包安装的依赖，最后从 PATH 发现；开发或托管环境可用 `configure --tool TOOL --entry ABSOLUTE_CLI_PATH --submit --json` 配置外部私有工具入口，所有依赖发现和执行使用同一路径。WorkBuddy 目标支持显式安装；维护本机其他 Agent 的安装需遵循用户授权。
+通过拥有源码的本包 CLI `skill source/status/install/update --agent CURRENT_AGENT --path EXACT_SKILL_DIRECTORY --json` 管理当前 Skill，source 是规范来源；CURRENT_AGENT 为当前宿主的有效名称，目录由宿主解析。安装不授予淘宝或画板服务访问权限。更新先解析当前选定目标、保留恢复点，再按当前 Agent 的 npm 安装流程升级应用包、同步该目标并验证版本和哈希。业务使用目标自有运行时；源码由 Git 管理，套件内安装由其拥有者统一更新。维护入口 `update check`、`update auto status/on/off` 可检查和控制旧式全局运行入口的检测设置。依赖 CLI 优先使用显式配置，其次解析可用的 npm 依赖，最后从 PATH 发现；可用 `configure --tool TOOL --entry ABSOLUTE_CLI_PATH --submit --json` 配置外部工具入口，所有依赖发现和执行使用同一路径。仅同步当前选定宿主；其他 Agent 的实际安装分别获得用户授权。
 
-需要 Node.js22+、已安装的两个依赖 CLI、淘宝已登录浏览器和 SealSeek 已授权账户；视频元信息检查需要 ffprobe。平台支持以适配器证据为准。静态兼容不能代替真实 Agent 测试。
+需要 Node.js22+、tbcli、当前目标画板的能力 CLI 和淘宝已登录浏览器。无限画板分支需要 SealSeek 已授权账户，视频元信息检查需要 ffprobe；Boardmix 分支通过 boardmixcli 自动准备 Chrome、提示并检测用户登录，再建立授权编辑器连接。平台支持以适配器证据为准。静态兼容不能代替真实 Agent 测试。
 
-验收：每商品四个 Frame，店铺命名正确，四类覆盖明确，主图/详情顺序正确，SKU每行最多5张，元素无重叠、均在所属 Frame 内；恢复不重复创建或导入，追加前后旧元素坐标逐项保持一致。收藏清单与画板来源可追溯。生成任务质量、创意策略及竞品商业判断不在本应用范围内。
+验收按分支执行：无限画板每商品四个 Frame，四类覆盖明确；Boardmix 每商品四个素材 Frame，视频核验原生对象、源文件哈希与加载完成状态。店铺命名正确，主图/详情顺序正确，SKU每行最多5张，元素无重叠、均在所属 Frame 内；恢复不重复创建或导入，追加前后旧元素坐标逐项保持一致。收藏清单与画板来源可追溯。生成任务质量、创意策略及竞品商业判断不在本应用范围内。

package/skills/competitor-visual-canvas/adapters/codex.json

@@ -53,10 +53,30 @@
       "status": "implemented",
       "evidence": [],
       "normalization": "CLI JSON; files and IDs are verified by application; errors stop the owning node."
+    },
+    {
+      "capability_id": "boardmix.images.write",
+      "status": "implemented",
+      "features": [
+        "three-image-regions",
+        "frame-create",
+        "text-create",
+        "image-download-inspect-import",
+        "explicit-placement",
+        "guid-readback",
+        "same-run-recovery",
+        "base-run-append"
+      ],
+      "implementation": {
+        "type": "cli",
+        "command": "competitor-visual-canvas",
+        "discovery": "Read references/boardmix.md; resolve boardmixcli via tool run and its canonical Skill; use saved target and explicit session/file key."
+      }
     }
   ],
   "operating_systems": {
     "macos": "implemented",
     "windows": "unresolved"
-  }
+  },
+  "legacySkillRoot": ".codex/skills"
 }

package/skills/competitor-visual-canvas/adapters/generic.json

@@ -0,0 +1,82 @@
+{
+  "schema": "portable-skill-adapter",
+  "schema_version": "1.0.0",
+  "platform": "generic",
+  "mappings": [
+    {
+      "capability_id": "canvas.product.append",
+      "implementation": {
+        "type": "cli",
+        "command": "competitor-visual-canvas",
+        "discovery": "Current package CLI; find --title and append --title/--canvas/--base-run"
+      },
+      "features": [
+        "canvas-list",
+        "canvas-get",
+        "source-metadata"
+      ],
+      "status": "implemented",
+      "evidence": [],
+      "normalization": "Exact-title candidates, structured ambiguity errors, validated cloud recovery and cumulative append plan; host runtime evidence is separate."
+    },
+    {
+      "capability_id": "product.media.collect",
+      "implementation": {
+        "type": "cli",
+        "command": "tbcli",
+        "discovery": "PATH or configured TBCLI_ENTRY/SEALSEEK_MEDIA_ENTRY; skill source; capabilities"
+      },
+      "features": [
+        "four-media-categories",
+        "product-shop-identity",
+        "ordered-urls",
+        "coverage"
+      ],
+      "status": "implemented",
+      "evidence": [],
+      "normalization": "CLI JSON; files and IDs are verified by application; errors stop the owning node."
+    },
+    {
+      "capability_id": "canvas.assets.write",
+      "implementation": {
+        "type": "cli",
+        "command": "sealseek-media",
+        "discovery": "PATH or configured TBCLI_ENTRY/SEALSEEK_MEDIA_ENTRY; skill source; capabilities"
+      },
+      "features": [
+        "frame-batch",
+        "text-batch",
+        "explicit-placement",
+        "media-inspect",
+        "source-metadata"
+      ],
+      "status": "implemented",
+      "evidence": [],
+      "normalization": "CLI JSON; files and IDs are verified by application; errors stop the owning node."
+    },
+    {
+      "capability_id": "boardmix.images.write",
+      "status": "implemented",
+      "features": [
+        "three-image-regions",
+        "frame-create",
+        "text-create",
+        "image-download-inspect-import",
+        "explicit-placement",
+        "guid-readback",
+        "same-run-recovery",
+        "base-run-append"
+      ],
+      "implementation": {
+        "type": "cli",
+        "command": "competitor-visual-canvas",
+        "discovery": "Read references/boardmix.md; resolve boardmixcli via tool run and its canonical Skill; use saved target and explicit session/file key."
+      }
+    }
+  ],
+  "operating_systems": {
+    "macos": "implemented",
+    "windows": "unresolved",
+    "linux": "unresolved"
+  }
+}

package/skills/competitor-visual-canvas/adapters/sealseek.json

@@ -53,10 +53,30 @@
       "status": "implemented",
       "evidence": [],
       "normalization": "CLI JSON; files and IDs are verified by application; errors stop the owning node."
+    },
+    {
+      "capability_id": "boardmix.images.write",
+      "status": "implemented",
+      "features": [
+        "three-image-regions",
+        "frame-create",
+        "text-create",
+        "image-download-inspect-import",
+        "explicit-placement",
+        "guid-readback",
+        "same-run-recovery",
+        "base-run-append"
+      ],
+      "implementation": {
+        "type": "cli",
+        "command": "competitor-visual-canvas",
+        "discovery": "Read references/boardmix.md; resolve boardmixcli via tool run and its canonical Skill; use saved target and explicit session/file key."
+      }
     }
   ],
   "operating_systems": {
     "macos": "implemented",
     "windows": "unresolved"
-  }
+  },
+  "legacySkillRoot": ".sealseek/workspaces/default/skills"
 }

package/skills/competitor-visual-canvas/adapters/workbuddy.json

@@ -53,10 +53,30 @@
       "status": "implemented",
       "evidence": [],
       "normalization": "CLI JSON; files and IDs are verified by application; errors stop the owning node."
+    },
+    {
+      "capability_id": "boardmix.images.write",
+      "status": "implemented",
+      "features": [
+        "three-image-regions",
+        "frame-create",
+        "text-create",
+        "image-download-inspect-import",
+        "explicit-placement",
+        "guid-readback",
+        "same-run-recovery",
+        "base-run-append"
+      ],
+      "implementation": {
+        "type": "cli",
+        "command": "competitor-visual-canvas",
+        "discovery": "Read references/boardmix.md; resolve boardmixcli via tool run and its canonical Skill; use saved target and explicit session/file key."
+      }
     }
   ],
   "operating_systems": {
     "macos": "implemented",
     "windows": "unresolved"
-  }
+  },
+  "legacySkillRoot": ".workbuddy/skills"
 }

package/skills/competitor-visual-canvas/agents/openai.yaml

@@ -1,3 +1,3 @@
 interface:
   display_name: "竞品视觉素材画板"
-  short_description: "收集淘宝天猫商品主图、详情、SKU图和视频，按区域整理到无限画板"
+  short_description: "采集竞品视觉素材，默认归档无限画板，可明确指定 Boardmix"