SuperAPI AI 工具集

b2c-cap

通用与其它

查看项目

更新于 10-16 05:46

技能介绍

用途:通过 b2c CLI 插件在 Salesforce B2C Commerce 实例上操作已有的 Commerce App Packages(CAP,也称 commerce apps)与 commerce features,涵盖 validate、package、install、uninstall、list、tasks、pull。若未全局安装 b2c,可用 npx @salesforce/b2c-cli 代替,例如 npx @salesforce/b2c-cli cap list。

配置与认证:CLI 会从 SFCC_* 环境变量(含项目 .env)、项目本地或共享 dw.json 及配置插件自动发现目标实例与凭据;package.json 只提供非敏感默认值。--server、--client-id、--client-secret 通常无需传入,仅在需要覆盖自动检测结果时使用。可用 b2c setup inspect 查看解析后的配置及各值来源(--json 便于脚本化,密钥默认掩码)。远程命令(cap install、cap uninstall、cap tasks、cap pull 及不带 --local 的 cap list)需要 OAuth 以执行 SCAPI 优先的系统作业,并需要 WebDAV 上传/下载归档;自动模式下若 SCAPI 明确拒绝启动请求,作业执行会临时回退到 OCAPI。WebDAV 可通过 SFCC_USERNAME/SFCC_PASSWORD(BM 用户名 + WebDAV 访问密钥)、--user-auth 交互式浏览器登录,或授予 /impex 路径 WebDAV 权限的 Account Manager OAuth 客户端认证;SCAPI 不能替代 WebDAV 上传。仅本地命令(cap validate、cap package、cap list --local)无需凭据。

主要能力与用法:cap list 可列出所有站点或指定站点(--site-id)的 features,支持 --json 与 --local;cap pull 将已安装应用源码拉取到 ./commerce-apps/{name}/,可指定应用名、--output 或 --site-id;cap tasks 显示配置任务及可点击的 BM 链接;cap validate 校验本地 CAP 目录或 zip;cap package 将目录打包为可分发 zip,cartridges/site_cartridges/ 与 cartridges/bm_cartridges/ 下每个 cartridge 必须有 .project 文件,缺失时 package 会自动创建空文件,validate 则报错;cap install 支持目录或预打包 zip,可选 --timeout、--skip-validate、--clean-archive、--create-pr;cap uninstall 自动查找 domain。更多命令见 b2c cap --help。

适用场景与限制:本技能面向对实例上已有 CAP 的运维操作;若要编写新 CAP(脚手架、生成 IMPEX、注册表级校验或提交注册表),需安装 cap-dev 技能(b2c setup skills cap-dev,或通过 commerce-apps marketplace:claude plugin marketplace add SalesforceCommerceCloud/commerce-apps 后 claude plugin install cap-dev)。相关技能包括 b2c-cli:b2c-job、b2c-cli:b2c-site-import-export、b2c-cli:b2c-code。资料未提供收费、价格或平台支持范围等信息。