SuperAPI AI 工具集

vs-project

部署与运维

查看项目

更新于 10-16 06:44

技能介绍

用途:该技能用于从已有应用资源创建 Viking Web 项目并验证本地预览,或在用户明确要求时把生成的项目部署到火山引擎 IGA Pages。

主要能力:通过 vs 系列命令完成认证、列出应用与数据集、列出搜索/推荐场景,生成项目,安装依赖并启动本地开发服务,最后验证预览地址;部署时调用 IGA CLI 完成构建与发布。

使用方式:先运行 vs project --help 做可用性检查;若命令不可用或报未知命令,立即停止并说明创建与部署不可用。创建前需选择至少一个功能(search、recommend、chat),所选应用需绑定至少一个数据集,推荐还需绑定用户事件数据集,搜索需搜索场景与数据集。认证可用 auth status / auth import-env / auth login,避免在对话中暴露密钥。资源选择须先运行对应 list 命令,展示具体资源(编号、名称、完整 ID、类型或状态),由用户按编号、名称或完整 ID 选择,不得静默选择。创建命令为 vs project create,需传 --features;搜索需同时传 --search-scene-id 与 --search-dataset-id,推荐传 --rec-scene-id,对话无需额外资源参数。生成后在该目录运行 npm install 与 npm run dev,从 Next.js 实际 Local 输出提取预览地址,并用 curl 探测根路径与 /api/config 验证。部署用 vs project deploy --project-dir <dir>,仅在用户明确要求发布时执行;--dry-run 仅在用户明确要求验证构建而不发布时使用。

适用场景:需要基于已有 Viking 应用资源快速生成可预览的 Web 项目,或将其发布到火山引擎 IGA Pages。

限制:本地预览需 Node.js 20.9 或更高版本及 npm;部署需网络访问 npx 与已认证的 IGA CLI 会话。不得向 project create 传 --api-key、--ak、--sk 或 --region;不得在命令预览或摘要中泄露凭据;不得假设端口或编造预览 URL;不得因创建成功就自动部署;不得推断或报告 CLI 未返回的 IGA 内部标识或 URL。生成目录中的 .env.local 含明文凭据,不应提交,可用运行时 VIKING_* 环境变量覆盖。其他未在资料中说明的细节暂未提供。