youzan YZY 有赞云工程初始化
目标
使用官方 YZY CLI 完成工程获取和本地开发初始化。不要手工拼装应用上下文、复制 Runtime 源码或绕过插件检测。
新工程
在计划存放工程的父目录执行：
npx --yes --registry=http://registry.npm.qima-inc.com @youzan-cloud/cli@beta
按终端交互完成登录、团队和应用选择、代码分支选择、保存目录、AI Skills 安装、开发目标初始化与 dev 启动。
不要在初始化完成后重复运行仓库内底层 yzc 命令。开发和构建应使用生成仓库根目录 package.json 暴露的命令。
CLI 的实际兼容检查是浏览器扩展最低版本的判定源。涉及 H5 或商家端调试时，优先运行上述官方 CLI 流程或 CLI 给出的版本检查；如果 CLI 提示扩展版本过低，以 CLI 报出的最低版本为准，不要只依据 Toolkit 静态清单判断登录、工程或 Runtime 是否兼容。
已有工程
- 先阅读仓库根目录的
AGENTS.md、README.md和package.json。 - 如果仓库已有前端开放 2.0 目录和脚本，直接使用其
dev:*或build:*命令。 - 如果缺少前端开放 2.0 结构，重新运行 YZY CLI，让 CLI 完成兼容初始化；不要手工复制模板目录。
- 如果仅需继续开发，不要重新 clone 或覆盖已有业务代码。
制品边界
读取相对本 Skill 的 ../../assets/yzy-release.json 获取当前发布渠道和安装地址：
@youzan-cloud/cli：工程初始化入口，独立 npm 包。@youzan-cloud/browser-runtime：仓库根目录开发依赖，由模板或 CLI 安装并锁定具体版本。- YZY Browser Developer Tool：独立 Chrome 扩展，不把扩展源码复制到业务仓库。
cloud-ui-v2：前端开放 2.0 模板，不作为 Skill 内容分发。
不要把 Runtime 加入 cloud/client、cloud/admin 等业务子项目依赖。
启动与排错
- 插件未安装或版本过低：先执行 CLI 版本检查；确认需要升级后，再使用版本清单中的下载地址安装或更新，并重新运行 CLI。清单里的
minimumVersion只记录发布时已校验门槛，若与 CLI 提示冲突，以 CLI 为准。 - dev 等待应用：优先确认 YZY CLI 是否已经生成应用上下文，不要再次手工选择另一个应用。
- H5、消费者端小程序和商家后台需要并行开发时，使用 CLI 或仓库提供的并行启动流程，不要让多个 Runtime 争用同一固定端口。
- 页面未渲染本地代码：使用
yzy-browser-debug检查 Runtime、页面连接和真实浏览器证据。 - 需要开放能力或 Slot 规则：使用
yzy-frontend-dev并先查询yzy-knowledge-search。
安全边界
不得输出或提交登录 Cookie、Authorization、应用密钥、Runtime session token。涉及发布、支付、下单、授权、删除等不可逆操作时，停止自动执行并请求用户明确确认。