byted-vefaas-skills

vefaas

本 skill 指导您使用 @volcengine/vefaas-cli 操作火山引擎 veFaaS，包括应用部署、函数管理、沙箱管理、环境变量、配置、诊断等在火山引擎函数服务控制台能执行的操作以及 OpenAPI 调用。

前置要求

CRITICAL — 执行任何 veFaaS 操作前，MUST 先确认本机 vefaas CLI 版本 >= 0.2.7。

vefaas --version
vefaas update --check

如果命令不存在，或版本低于 0.2.7，必须先升级；如果 vefaas update --check 发现可更新版本，应提示用户升级后再继续：

npm i -g @volcengine/vefaas-cli@latest
vefaas --version

文档检索能力（免登录）—— vefaas doc 可在终端检索 veFaaS 官方文档，无需登录、只读、不计费。这是本 skill 回答 veFaaS 概念/能力/选型/计费/SDK 用法等问题、以及写 SDK/OpenAPI 代码时的权威知识来源，详见下文「文档优先（doc-first）协议」。运行 vefaas doc --help 确认可用；若不可用，先 vefaas update 升级 CLI。

适用场景

使用本 skill：

• 用户要把本地项目、网站、API 服务、Node.js 服务、Python 服务或静态站点部署到火山引擎 veFaaS。
• 用户要基于模板创建 serverless 应用，或把已有项目接入 veFaaS。
• 用户要查看控制台概览、线上访问地址、发布记录、日志或资源用量。
• 用户要配置环境变量、调整构建命令、启动命令、端口或资源配置，或删除已有应用。
• 用户要管理线上函数：创建、查看、发布、回滚、调用、日志、实例、任务、扩缩容策略、触发器、依赖、WebShell。
• 用户要拉取云端函数代码、本地修改后推送或重新部署。
• 用户要管理沙箱应用、沙箱实例、沙箱镜像、沙箱日志、沙箱 WebShell。
• 用户要排查部署失败、鉴权失败、框架检测错误、网关缺失、配置不一致或 OpenAPI 调用失败。
• 用户明确要调用 veFaaS OpenAPI action，或高阶命令无法覆盖目标操作。
• 用户第一次接触 veFaaS、不清楚它是什么或如何上手，需要 landing 引导（无需先登录即可开始）。
• 用户询问 veFaaS 的概念、能力边界、资源选型、计费、限额、触发器等问题，需要基于官方文档准确回答。
• 用户要在自己的代码里接入 veFaaS SDK（Go/Python/Node）或调用 OpenAPI，需要参照官方示例辅助开发。

资源心智模型

• 函数是 veFaaS（函数服务）的核心资源，承载代码/镜像、版本、实例、日志、资源规格和扩缩容策略；函数实例通常由平台按流量和策略动态扩缩容。
• 应用是在函数基础上编排应用级逻辑后的产品形态，包含整体版本管理、APIG 触发器关联、Git 仓库自动触发部署等，用于让用户更方便地发布并访问应用。
• 沙箱是一种特殊/定制的函数，Function、Revision、Instance 模型与函数类似，但必须基于已预热镜像创建，适合代码沙箱、模型评测等秒级拉起隔离环境的场景；沙箱实例需要主动创建，并支持暂停、恢复、关闭和调整过期时间。
• 需要更细的资源关系、ID 使用规则或 CLI target 映射时，读取 CLI 与版本。

CRITICAL 工作流分流

CRITICAL — 先判断用户意图是「知识类」还是「执行类」，再分流：

• 知识类（问概念/能力/选型/计费/限额；第一次用、要 landing 上手引导；要写 SDK/OpenAPI 集成代码）→ 走「文档优先（doc-first）工作流」：先用 vefaas doc 检索官方文档，基于文档回答或写代码，通常无需登录。继续前 MUST 读取 文档检索与 doc-first。
• 执行类（部署、发布、回滚、调用、管理函数/应用/沙箱/网关等真实资源操作）→ 走下面对应的执行工作流。
• 混合类（如“帮我部署这个项目，顺便讲下计费”）→ 先用 doc-first 答疑，再走执行工作流。

下面是执行类工作流的分流规则：

CRITICAL — 用户说“部署项目 / 网站上线 / API 上线 / serverless 应用 / 查看访问地址”时，默认走应用工作流，不要直接创建函数。