(
Navigation Goal
Where should Skyvern go and what should Skyvern do?
)}
/>
```
资料来源：[skyvern-frontend/src/routes/tasks/create/CreateNewTaskForm.tsx:1-30]()
### 导航负载配置
高级设置允许用户指定额外的导航参数：
| 参数 | 描述 | 示例 |
|------|------|------|
| routes | 指定导航路径 | `["/login", "/dashboard"]` |
| states | 页面状态信息 | `{"loggedIn": true}` |
| custom_headers | 自定义请求头 | `{"Authorization": "Bearer xxx"}` |
资料来源：[skyvern-frontend/src/routes/tasks/create/SavedTaskForm.tsx:40-80]()
## 任务执行步骤
### 步骤追踪
每个任务执行过程中会被分解为多个步骤，每个步骤记录详细执行信息：
| 字段 | 描述 |
|------|------|
| step_id | 步骤唯一标识 |
| action | 执行的浏览器操作 |
| reasoning | LLM 推理过程 |
| result | 操作结果 |
| status | 步骤状态 |
资料来源：[skyvern/forge/sdk/schemas/task_v2.py:80-120]()
### 实时流显示
前端支持实时查看任务执行画面：
```typescript
// TaskActions.tsx 流显示逻辑
if (task?.status === Status.Running && streamImgSrc.length > 0) {
return (
);
}
```
资料来源：[skyvern-frontend/src/routes/tasks/detail/TaskActions.tsx:30-50]()
## 任务管理接口
### 列出任务
获取组织内的任务历史记录：
```typescript
// TaskHistory.tsx 任务列表结构
ID
URL
Status
Created At
```
资料来源：[skyvern-frontend/src/routes/tasks/list/TaskHistory.tsx:20-35]()
### 查看任务详情
查看特定任务的详细信息和参数：
```typescript
// TaskParameters.tsx 参数展示
```
资料来源：[skyvern-frontend/src/routes/tasks/detail/TaskParameters.tsx:15-35]()
## 定时任务调度
任务系统支持通过定时调度自动化执行任务：
| 组件 | 功能 |
|------|------|
| CreateScheduleDialog | 创建调度对话框 |
| WorkflowSchedulePanel | 工作流调度面板 |
| ScheduleCard | 调度卡片展示 |
| ScheduleDetailPage | 调度详情页面 |
### 调度配置
```typescript
// CreateScheduleDialog.tsx 调度创建
```
资料来源：[skyvern-frontend/src/routes/workflows/editor/panels/schedulePanel/CreateScheduleDialog.tsx:60-80]()
## 凭证与安全
### TOTP 认证支持
任务系统支持二次验证（2FA）集成：
```typescript
// CredentialsTotpTab.tsx
```
| 字段 | 描述 |
|------|------|
| totp_identifier | 凭证标识符（邮箱或手机号） |
| totp_type | OTP 类型（numeric_code 或 magic_link） |
资料来源：[skyvern-frontend/src/routes/credentials/CredentialsTotpTab.tsx:15-40]()
## 最佳实践
### 1. 导航目标编写
编写清晰的导航目标描述：
```text
# 推荐写法
"Find the top post on hackernews today and extract the title and URL"
# 避免
"Check the website" # 过于模糊
```
### 2. URL 指定
始终提供完整的起始 URL，避免重定向导致的定位问题。
### 3. 导航负载使用
对于需要传递额外状态的场景，使用导航负载而非将所有信息放在导航目标中：
```json
{
"routes": ["/login", "/dashboard", "/reports"],
"context": {
"user_id": "12345",
"view_mode": "detailed"
}
}
```
### 4. 错误处理
监控任务状态并实现适当的错误处理逻辑：
```python
if task.status == Status.Failed:
print(f"Task failed: {task.error}")
elif task.status == Status.Completed:
print("Task completed successfully")
```
## 相关文档
- [Skyvern 文档首页](https://skyvern.com/docs)
- [API 参考文档](https://docs.skyvern.com)
- [贡献指南](../CONTRIBUTING.md)
---
## 工作流系统
### 相关页面
相关主题：[任务系统](#page-tasks)
相关源码文件
以下源码文件用于生成本页说明：
- [skyvern/forge/sdk/workflow/models/workflow.py](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern/forge/sdk/workflow/models/workflow.py)
- [skyvern/forge/sdk/workflow/models/block.py](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern/forge/sdk/workflow/models/block.py)
- [skyvern/services/workflow_service.py](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern/services/workflow_service.py)
- [skyvern/schemas/workflows.py](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern/schemas/workflows.py)
- [skyvern-frontend/src/routes/workflows/RunWorkflowForm.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/workflows/RunWorkflowForm.tsx)
- [skyvern-frontend/src/routes/workflows/workflowRun/WorkflowPostRunParameters.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/workflows/workflowRun/WorkflowPostRunParameters.tsx)
- [skyvern-frontend/src/routes/workflows/editor/nodes/StartNode/StartNode.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/workflows/editor/nodes/StartNode/StartNode.tsx)
- [skyvern/cli/mcp_tools/README.md](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern/cli/mcp_tools/README.md)
# 工作流系统
Skyvern 工作流系统（Workflow System）是一个用于编排多个自动化任务的核心模块，允许用户将多个浏览器任务、动作、数据提取操作等链接在一起，形成一个完整的自动化业务流程。
## 系统概述
工作流系统的主要功能包括：
- **多步骤自动化编排**：将多个独立的浏览器任务和操作链接成连贯的工作流程
- **灵活的参数传递**：支持在不同的块（Block）之间传递参数和数据
- **条件分支控制**：支持基于条件的分支执行逻辑
- **循环迭代**：支持对数据集进行遍历处理
- **错误处理与恢复**：支持在块失败时继续执行或回退到 AI 重新生成代码
## 核心数据模型
### 工作流定义（WorkflowDefinition）
工作流定义是整个工作流系统的核心数据结构，包含以下关键属性：
| 属性 | 类型 | 说明 |
|------|------|------|
| `id` | string | 工作流唯一标识符 |
| `title` | string | 工作流标题 |
| `description` | string | 工作流描述 |
| `parameters` | list | 输入参数定义 |
| `blocks` | list | 工作流中的块列表 |
| `version` | int | 版本号 |
| `status` | WorkflowStatus | 工作流状态 |
| `folder_id` | string | 所属文件夹 ID |
| `created_by` | string | 创建者 ID |
| `edited_by` | string | 最后编辑者 ID |
资料来源：[skyvern/schemas/workflows.py]()
### 工作流块（WorkflowBlock）
工作流块是组成工作流的基本单元，每种块类型代表不同的操作或功能。
## 块类型体系
Skyvern 工作流支持多种类型的块，用于构建复杂的自动化流程：
| 块类型 | 说明 | 主要参数 |
|--------|------|----------|
| `BrowserTask` / `Taskv2` | 浏览器任务，执行网页自动化操作 | prompt, url, max_steps, totp_verification_url |
| `Navigation` | 导航块，跳转到指定 URL | url, continue_on_failure |
| `Action` | 动作块，执行点击、输入等操作 | action_type, selector |
| `Extraction` | 数据提取块，从页面提取结构化数据 | json_schema, prompt |
| `Validation` | 验证块，验证页面状态或数据 | schema, error_codes |
| `TextPrompt` | 文本提示块，调用 LLM 生成文本 | prompt, llm_key, json_schema |
| `HTTPRequest` | HTTP 请求块，发送 API 请求 | url, method, headers, body |
| `Wait` | 等待块，等待指定时间或条件 | duration |
| `PrintPage` | 打印块，打印当前页面 | format, landscape, print_background |
| `HumanInteraction` | 人工交互块，暂停等待用户确认 | instructions, positive_descriptor |
| `Conditional` | 条件块，基于条件选择执行分支 | expression |
| `ForLoop` | 循环块，遍历数据集合 | iterable, loop_variable |
| `FileDownload` | 文件下载块 | url, download_filename |
| `Login` | 登录块 | credentials |
| `Code` | 自定义代码块 | code, language |
资料来源：[skyvern/forge/sdk/workflow/models/block.py]()
### 块执行参数
不同的块类型支持特定的参数配置：
```typescript
// Taskv2 块参数示例
interface Taskv2BlockParameters {
prompt: string; // 任务提示词
url: string; // 目标 URL
max_steps: number; // 最大步数
totp_verification_url?: string; // TOTP 验证 URL
totp_identifier?: string; // TOTP 标识符
disable_cache?: boolean; // 是否禁用缓存
}
```
```typescript
// 文本提示块参数示例
interface TextPromptBlockParameters {
prompt: string; // 提示词模板
llm_key: string; // 使用的 LLM 密钥
json_schema?: object; // 输出 JSON Schema
parameters: string[]; // 依赖的参数列表
}
```
资料来源：[skyvern-frontend/src/routes/workflows/workflowRun/WorkflowPostRunParameters.tsx]()
## 工作流执行流程
### 执行架构
```mermaid
graph TD
A[开始工作流] --> B[加载工作流定义]
B --> C[初始化参数]
C --> D[执行第一个块]
D --> E{块类型判断}
E -->|Task/Action| F[启动浏览器任务]
E -->|Extraction| G[提取数据]
E -->|HTTPRequest| H[发送 HTTP 请求]
E -->|Conditional| I[评估条件]
E -->|ForLoop| J[开始循环]
F --> K{任务状态}
K -->|成功| L[保存结果]
K -->|失败| M{AI Fallback?}
M -->|是| N[重新生成代码]
M -->|否| O[报告错误]
L --> P{还有下一个块?}
P -->|是| D
P -->|否| Q[工作流完成]
N --> F
```
### 执行模式
工作流支持两种执行模式：
| 模式 | 说明 | 适用场景 |
|------|------|----------|
| `Skyvern Agent` | 使用 AI Agent 动态生成执行代码 | 复杂、变化的网页环境 |
| `Code` | 使用预先保存的成功运行的代码 | 稳定、可复现的任务 |
```typescript
// 开始节点配置
interface StartNodeData {
runWith: 'agent' | 'code'; // 执行模式
aiFallback: boolean; // AI 回退开关
codeKey?: string; // 代码缓存键
cacheKey?: string; // 缓存键
adaptiveCaching?: boolean; // 自适应缓存
generateScriptOnTerminal?: boolean; // 结束时生成脚本
runSequentially?: boolean; // 顺序执行
sequentialKey?: string; // 顺序执行键
}
```
资料来源：[skyvern-frontend/src/routes/workflows/editor/nodes/StartNode/StartNode.tsx]()
## 工作流运行管理
### 工作流运行（WorkflowRun）
工作流运行实例包含以下核心信息：
| 属性 | 说明 |
|------|------|
| `workflow_run_id` | 运行唯一 ID |
| `workflow_permanent_id` | 关联的工作流永久 ID |
| `parent_workflow_run_id` | 父运行 ID（用于嵌套工作流） |
| `organization_id` | 组织 ID |
| `status` | 运行状态 |
| `parameters` | 运行参数 |
| `output` | 运行输出结果 |
### 运行参数验证
工作流运行前会对输入参数进行严格的类型验证：
| 参数类型 | 验证规则 |
|----------|----------|
| `json` | 必填，字符串需可解析为有效 JSON |
| `boolean` | 必填，布尔值 |
| `integer` / `float` | 必填，需为有效数字 |
| `file_url` | 必填，URL 格式 |
| `string` | 可选，空字符串视为空值 |
```typescript
// 参数验证逻辑示例
const validateParameter = (parameter: WorkflowParameter, value: any) => {
if (parameter.workflow_parameter_type === 'json') {
if (value === null || value === undefined) return "This field is required";
if (typeof value === 'string') {
try {
JSON.parse(value.trim());
return true;
} catch (e) {
return "Invalid JSON";
}
}
}
// ... 其他类型验证
};
```
资料来源：[skyvern-frontend/src/routes/workflows/RunWorkflowForm.tsx]()
### Webhook 回调
工作流完成后可向指定的 Webhook URL 发送回调通知：
```typescript
interface WebhookConfig {
webhookCallbackUrl: string; // 回调 URL
// 回调将包含工作流执行的详细结果
}
```
## 调度与定时执行
### 调度配置
工作流支持通过 Cron 表达式进行定时调度：
| 配置项 | 说明 |
|--------|------|
| `cron_expression` | Cron 表达式 |
| `timezone` | 时区设置 |
| `schedule_name` | 调度名称（可选，自动生成） |
| `schedule_description` | 调度描述（可选） |
| `workflow_parameters` | 运行时参数 |
### 快速预设
系统提供常用的 Cron 预设：
| 预设标签 | 表达式 | 说明 |
|----------|--------|------|
| 每小时 | `0 * * * *` | 每小时整点执行 |
| 每天 | `0 0 * * *` | 每天午夜执行 |
| 每周 | `0 0 * * 0` | 每周日执行 |
| 每月 | `0 0 1 * *` | 每月1日执行 |
资料来源：[skyvern-frontend/src/routes/schedules/CreateOrgScheduleDialog.tsx]()
## MCP 集成
Skyvern 通过 MCP（Model Context Protocol）提供工作流相关的工具函数：
### 工作流管理工具
| 工具名称 | 功能 |
|----------|------|
| `skyvern_workflow_create` | 创建新工作流 |
| `skyvern_workflow_list` | 列出所有工作流 |
| `skyvern_workflow_get` | 获取工作流详情 |
| `skyvern_workflow_run` | 运行工作流 |
| `skyvern_workflow_status` | 查询运行状态 |
| `skyvern_workflow_update` | 更新工作流 |
| `skyvern_workflow_delete` | 删除工作流 |
| `skyvern_workflow_cancel` | 取消运行中的工作流 |
| `skyvern_workflow_update_folder` | 更新工作流所属文件夹 |
### 工作流构建工具
| 工具名称 | 功能 |
|----------|------|
| `skyvern_block_schema` | 获取块类型定义 |
| `skyvern_block_validate` | 验证块配置 |
### 缓存脚本工具
| 工具名称 | 功能 |
|----------|------|
| `skyvern_script_list_for_workflow` | 列出工作流的缓存脚本 |
| `skyvern_script_get_code` | 获取脚本代码 |
| `skyvern_script_versions` | 获取脚本版本历史 |
| `skyvern_script_deploy` | 部署脚本 |
| `skyvern_script_fallback_episodes` | 获取回退事件记录 |
资料来源：[skyvern/cli/mcp_tools/README.md]()
## 前端组件架构
### 工作流编辑器
```mermaid
graph TD
A[工作流编辑器] --> B[WorkflowHistoryPanel]
A --> C[块编辑面板]
A --> D[StartNode]
A --> E[WorkflowTriggerNode]
C --> F[BlockParameters]
F --> |TextPrompt| G[TextPromptBlockParameters]
F --> |Taskv2| H[Taskv2BlockParameters]
F --> |URL| I[GotoUrlBlockParameters]
F --> |Conditional| J[ConditionalBlockParameters]
```
### 运行时信息展示
工作流运行过程中的每个块都会记录详细的执行信息：
| 信息类型 | 说明 |
|----------|------|
| `extracted_information` | 提取的数据结果（JSON 格式） |
| `failure_reason` | 失败原因（如有） |
| `navigation_goal` | 原始导航目标 |
| `parameters` | 块执行参数 |
| `diagnostics` | 诊断信息链接 |
```typescript
interface BlockExecutionInfo {
block_type: WorkflowBlockTypes;
task_id?: string;
status: Status;
output?: object;
executed_branch_expression?: string;
executed_branch_result?: boolean;
executed_branch_next_block?: string;
}
```
资料来源：[skyvern-frontend/src/routes/workflows/workflowRun/WorkflowRunTimelineItemInfoSection.tsx]()
## 数据库模型转换
后端通过 `convert_to_workflow` 函数将数据库模型转换为前端可用的数据结构：
```python
def convert_to_workflow(
workflow_model: WorkflowModel,
is_template: bool = False,
) -> Workflow:
return Workflow(
workflow_id=workflow_model.workflow_id,
workflow_permanent_id=workflow_model.workflow_permanent_id,
title=workflow_model.title,
version=workflow_model.version,
is_saved_task=workflow_model.is_saved_task,
is_template=is_template,
description=workflow_model.description,
workflow_definition=WorkflowDefinition.model_validate(
workflow_model.workflow_definition
),
# ... 其他字段映射
)
```
资料来源：[skyvern/forge/sdk/db/utils.py]()
## 常见使用场景
### 场景一：发票批量下载
1. 使用 **URL** 块导航到发票页面
2. 使用 **Filter** 块设置日期过滤条件
3. 使用 **Extraction** 块提取发票列表
4. 使用 **ForLoop** 块遍历每个发票
5. 使用 **FileDownload** 块下载每个发票
### 场景二：电商自动化购买
1. 使用 **URL** 块导航到产品页面
2. 使用 **Browser Action** 块添加商品到购物车
3. 使用 **Navigation** 块进入购物车页面
4. 使用 **Validation** 块验证购物车状态
5. 使用 **Browser Action** 块完成结账流程
### 场景三：数据采集与报告
1. 使用 **HTTPRequest** 块获取外部 API 数据
2. 使用 **TextPrompt** 块使用 LLM 分析数据
3. 使用 **Email** 块发送分析报告
## 错误处理机制
### 块级别错误处理
每个块支持 `continue_on_failure` 配置，控制失败时的行为：
| 配置值 | 行为 |
|--------|------|
| `true` | 继续执行下一个块 |
| `false` | 停止工作流并报告错误 |
### AI 自愈机制
当使用代码执行模式失败时，系统支持自动回退到 AI Agent 重新生成代码：
```
任务失败 → 检查 AI Fallback 设置 → 启用则用 AI 重新生成 → 再次执行
```
资料来源：[skyvern-frontend/src/routes/workflows/editor/nodes/StartNode/StartNode.tsx]()
## 文件夹组织
工作流支持通过文件夹进行组织管理：
| 操作 | 说明 |
|------|------|
| 创建文件夹 | `skyvern_folder_create` |
| 列出文件夹 | `skyvern_folder_list` |
| 获取文件夹 | `skyvern_folder_get` |
| 更新文件夹 | `skyvern_folder_update` |
| 删除文件夹 | `skyvern_folder_delete` |
资料来源：[skyvern/cli/mcp_tools/README.md]()
## 相关资源
- 官方文档：https://skyvern.com/docs/workflows
- MCP 集成文档：https://skyvern.com/docs/integrations/mcp
- GitHub 仓库：https://github.com/Skyvern-AI/skyvern
---
## 浏览器自动化
### 相关页面
相关主题：[任务系统](#page-tasks), [AI 代理系统](#page-agents)
根据提供的上下文，我无法完成此任务。
**原因分析：**
用户指定的源文件在当前的上下文检索中不可用：
| 指定的源文件 | 状态 |
|-------------|------|
| `skyvern/webeye/browser_state.py` | ❌ 上下文未提供 |
| `skyvern/webeye/actions/actions.py` | ❌ 上下文未提供 |
| `skyvern/webeye/actions/handler.py` | ❌ 上下文未提供 |
| `skyvern/services/browser_session_service.py` | ❌ 上下文未提供 |
当前上下文仅包含：
- 前端 React 组件文件（`skyvern-frontend/src/routes/...`）
- `integrations/mcp/README.md`
- `README.md`
这些文件主要涉及 UI 界面和工作流配置，无法提供关于"浏览器自动化"核心实现（如 BrowserState 类、Action 类型定义、Handler 处理逻辑、BrowserSessionService 服务）的技术细节。
---
**建议：**
请重新提交请求，确保检索范围包含以下关键模块：
1. **浏览器状态管理** - `skyvern/webeye/browser_state.py`
2. **浏览器操作定义** - `skyvern/webeye/actions/actions.py`
3. **操作处理逻辑** - `skyvern/webeye/actions/handler.py`
4. **浏览器会话服务** - `skyvern/services/browser_session_service.py`
5. **额外相关文件** - 如 `skyvern/webeye/browser.py`、`skyvern/webeye/client.py` 等
获取这些核心源文件后，我可以为您生成包含以下内容的完整技术 wiki：
- 浏览器自动化架构图（Mermaid）
- BrowserState 状态机流转
- Action 类型分类表
- Handler 处理流程
- BrowserSessionService API
- 配置参数参考表
---
## 数据库与数据模型
### 相关页面
相关主题：[凭证管理系统](#page-credentials)
相关源码文件
以下源码文件用于生成本页说明：
- [skyvern/forge/sdk/db/models.py](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern/forge/sdk/db/models.py)
- [alembic/versions](https://github.com/Skyvern-AI/skyvern/blob/main/alembic/versions)
- [skyvern/forge/sdk/db/repositories](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern/forge/sdk/db/repositories)
# 数据库与数据模型
## 概述
Skyvern 是一个基于浏览器的自动化平台，其数据模型设计用于支持工作流执行、任务管理、凭证存储、日程调度等核心功能。系统采用 Python 作为后端开发语言，使用 SQLAlchemy 作为 ORM 框架，并通过 Alembic 进行数据库版本管理。
Skyvern 的数据库层主要位于 `skyvern/forge/sdk/db/` 目录下，核心数据模型定义在 `models.py` 文件中，数据访问逻辑封装在 `repositories` 目录下。
## 核心数据模型
### 组织与认证模型
#### Organization（组织）
`Organization` 模型定义了 Skyvern 中的顶级组织实体，用于多租户隔离。
| 字段 | 类型 | 说明 |
|------|------|------|
| organization_id | UUID | 组织唯一标识符 |
| name | String | 组织名称 |
| created_at | DateTime | 创建时间 |
| modified_at | DateTime | 修改时间 |
资料来源：[skyvern/forge/sdk/db/models.py]()
#### User（用户）
`User` 模型关联到特定组织，存储用户认证信息。
| 字段 | 类型 | 说明 |
|------|------|------|
| user_id | UUID | 用户唯一标识符 |
| organization_id | UUID | 所属组织 ID（外键） |
| email | String | 用户邮箱 |
| hashed_password | String | 密码哈希值 |
| is_superuser | Boolean | 是否为超级管理员 |
资料来源：[skyvern/forge/sdk/db/models.py]()
### 工作流相关模型
#### Workflow（工作流）
`Workflow` 是 Skyvern 自动化的核心实体，定义了自动化任务的配置和执行逻辑。
| 字段 | 类型 | 说明 |
|------|------|------|
| workflow_id | UUID | 工作流唯一标识符 |
| organization_id | UUID | 所属组织 ID（外键） |
| title | String | 工作流标题 |
| description | String | 工作流描述 |
| definition | JSON | 工作流定义（包含所有块和连接） |
| proxy_config | JSON | 代理配置 |
| max_steps_per_run | Integer | 每次运行的最大步数 |
| created_at | DateTime | 创建时间 |
| modified_at | DateTime | 修改时间 |
资料来源：[skyvern/forge/sdk/db/models.py]()
#### WorkflowVersion（工作流版本）
用于版本控制，记录工作流的修改历史。
| 字段 | 类型 | 说明 |
|------|------|------|
| workflow_version_id | UUID | 版本 ID |
| workflow_id | UUID | 所属工作流 ID（外键） |
| version | Integer | 版本号 |
| definition | JSON | 该版本的完整定义 |
| created_at | DateTime | 创建时间 |
资料来源：[skyvern/forge/sdk/db/models.py]()
#### WorkflowRun（工作流运行实例）
记录每次工作流执行的实例及其状态。
| 字段 | 类型 | 说明 |
|------|------|------|
| workflow_run_id | UUID | 运行实例 ID |
| workflow_id | UUID | 所属工作流 ID（外键） |
| status | Enum | 运行状态（pending/running/completed/failed） |
| workflow_revision | Integer | 运行时使用的工作流版本 |
| started_at | DateTime | 开始时间 |
| completed_at | DateTime | 完成时间 |
| error_code | String | 错误代码（如果失败） |
| error_message | String | 错误信息 |
| task_id | UUID | 关联的底层任务 ID |
资料来源：[skyvern/forge/sdk/db/models.py]()
#### WorkflowBlock（工作流块实例）
表示工作流运行时每个块的执行状态。
| 字段 | 类型 | 说明 |
|------|------|------|
| block_id | UUID | 块实例 ID |
| workflow_run_id | UUID | 所属运行 ID（外键） |
| block_type | String | 块类型（task/condition/action 等） |
| block_id_ref | String | 引用工作流定义中的块 ID |
| status | Enum | 块执行状态 |
| order | Integer | 执行顺序 |
| output | JSON | 块输出数据 |
| executed_branch_expression | String | 条件分支表达式（如果适用） |
| executed_branch_next_block | String | 实际执行的下一个块 |
资料来源：[skyvern/forge/sdk/db/models.py]()
### 任务模型
#### Task（任务）
`Task` 是 Skyvern 底层的任务执行单元，每个工作流运行会创建相应的任务。
| 字段 | 类型 | 说明 |
|------|------|------|
| task_id | UUID | 任务唯一标识符 |
| organization_id | UUID | 所属组织 ID（外键） |
| workflow_run_id | UUID | 关联的工作流运行 ID |
| status | Enum | 任务状态（pending/running/completed/failed） |
| navigation_goal | Text | 导航目标描述 |
| navigation_payload | JSON | 导航负载参数 |
| extracted_content | JSON | 提取的内容 |
| failure_reason | String | 失败原因 |
| created_at | DateTime | 创建时间 |
| modified_at | DateTime | 修改时间 |
资料来源：[skyvern/forge/sdk/db/models.py]()
#### TaskStep（任务步骤）
记录任务的每个执行步骤。
| 字段 | 类型 | 说明 |
|------|------|------|
| step_id | UUID | 步骤 ID |
| task_id | UUID | 所属任务 ID（外键） |
| order | Integer | 步骤顺序 |
| status | Enum | 步骤状态 |
| action | String | 执行的动作 |
| reasoning | Text | AI 推理过程 |
| result | JSON | 步骤执行结果 |
| error_code | String | 错误代码 |
| error_message | String | 错误信息 |
资料来源：[skyvern/forge/sdk/db/models.py]()
### 凭证模型
#### Credential（凭证）
安全存储各种认证凭据。
| 字段 | 类型 | 说明 |
|------|------|------|
| credential_id | UUID | 凭证 ID |
| organization_id | UUID | 所属组织 ID（外键） |
| credential_name | String | 凭证名称 |
| credential_type | String | 凭证类型（api_key/oauth/password 等） |
| credential_value | EncryptedString | 加密存储的凭证值 |
| metadata | JSON | 额外元数据 |
| created_at | DateTime | 创建时间 |
资料来源：[skyvern/forge/sdk/db/models.py]()
#### CustomCredentialServiceAuthToken（自定义凭证服务令牌）
用于存储自定义凭证服务的认证令牌。
| 字段 | 类型 | 说明 |
|------|------|------|
| id | UUID | 令牌 ID |
| organization_id | UUID | 所属组织 ID（外键） |
| token_type | String | 令牌类型 |
| api_base_url | String | API 基础 URL |
| api_token | EncryptedString | 加密的 API 令牌 |
| created_at | DateTime | 创建时间 |
资料来源：[skyvern/forge/sdk/db/models.py]()
#### TOTP（两步验证码）
存储 TOTP 相关配置。
| 字段 | 类型 | 说明 |
|------|------|------|
| totp_id | UUID | TOTP ID |
| organization_id | UUID | 所属组织 ID（外键） |
| identifier | String | 标识符（邮箱/手机等） |
| totp_type | Enum | TOTP 类型（numeric/magic_link） |
| totp_value | EncryptedString | 加密的 TOTP 密钥 |
| created_at | DateTime | 创建时间 |
资料来源：[skyvern/forge/sdk/db/models.py]()
### 日程调度模型
#### Schedule（日程）
用于定时触发工作流执行。
| 字段 | 类型 | 说明 |
|------|------|------|
| schedule_id | UUID | 日程 ID |
| organization_id | UUID | 所属组织 ID（外键） |
| workflow_id | UUID | 关联的工作流 ID（外键） |
| cron_expression | String | Cron 表达式 |
| timezone | String | 时区 |
| workflow_parameters | JSON | 工作流参数字典 |
| created_at | DateTime | 创建时间 |
| modified_at | DateTime | 修改时间 |
资料来源：[skyvern/forge/sdk/db/models.py]()
### 脚本与缓存模型
#### WorkflowScript（工作流脚本）
存储可重用的工作流代码片段。
| 字段 | 类型 | 说明 |
|------|------|------|
| script_id | UUID | 脚本 ID |
| organization_id | UUID | 所属组织 ID（外键） |
| workflow_permanent_id | UUID | 关联的工作流永久 ID |
| cache_key | String | 缓存键 |
| current_revision | Integer | 当前版本号 |
| created_at | DateTime | 创建时间 |
| modified_at | DateTime | 修改时间 |
资料来源：[skyvern/forge/sdk/db/models.py]()
#### WorkflowScriptRevision（脚本版本）
存储脚本的各个版本。
| 字段 | 类型 | 说明 |
|------|------|------|
| revision_id | UUID | 版本 ID |
| script_id | UUID | 所属脚本 ID（外键） |
| revision | Integer | 版本号 |
| content | Text | 脚本内容 |
| created_at | DateTime | 创建时间 |
资料来源：[skyvern/forge/sdk/db/models.py]()
## 数据仓库层
### Repository 模式
Skyvern 使用 Repository 模式封装数据访问逻辑，所有仓库类位于 `skyvern/forge/sdk/db/repositories` 目录下。
```mermaid
graph TD
A[Service Layer] --> B[Repository Layer]
B --> C[SQLAlchemy Session]
C --> D[(Database)]
E[OrganizationRepository] --> B
F[WorkflowRepository] --> B
G[TaskRepository] --> B
H[CredentialRepository] --> B
I[ScheduleRepository] --> B
```
### 核心 Repository 类
| Repository 类 | 职责 | 主要方法 |
|--------------|------|---------|
| OrganizationRepository | 组织管理 | create, get, update, delete |
| WorkflowRepository | 工作流 CRUD | create_workflow, get_workflow, update_workflow |
| WorkflowRunRepository | 工作流运行管理 | create_run, get_run, update_status |
| TaskRepository | 任务管理 | create_task, get_task, update_task |
| TaskStepRepository | 任务步骤管理 | create_step, get_steps |
| CredentialRepository | 凭证管理 | create_credential, get_credential |
| ScheduleRepository | 日程管理 | create_schedule, get_schedules |
| WorkflowScriptRepository | 脚本管理 | create_script, get_revisions |
资料来源：[skyvern/forge/sdk/db/repositories]()
## 数据库迁移
### Alembic 版本管理
Skyvern 使用 Alembic 进行数据库版本控制，迁移文件位于 `alembic/versions/` 目录。
迁移目录结构：
```
alembic/
├── env.py # Alembic 环境配置
├── script.py.mako # 迁移脚本模板
└── versions/ # 迁移版本文件
├── xxx_initial.py
├── xxx_add_workflow.py
├── xxx_add_credential.py
└── ...
```
### 迁移操作
```mermaid
graph LR
A[修改 models.py] --> B[生成迁移脚本]
B --> C[alembic revision --autogenerate]
C --> D[应用迁移]
D --> E[alembic upgrade head]
```
资料来源：[alembic/versions]()
## 数据关系图
### 工作流执行数据流
```mermaid
graph TD
A[Workflow] -->|1:N| B[WorkflowVersion]
A -->|1:N| C[WorkflowRun]
C -->|1:N| D[WorkflowBlock]
C -->|1:1| E[Task]
E -->|1:N| F[TaskStep]
A -->|1:N| G[Schedule]
A -->|1:N| H[WorkflowScript]
H -->|1:N| I[WorkflowScriptRevision]
J[Organization] -->|1:N| A
J -->|1:N| K[Credential]
J -->|1:N| E
```
### 凭证存储结构
```mermaid
graph TD
A[Organization] -->|1:N| B[Credential]
A -->|1:N| C[CustomCredentialServiceAuthToken]
A -->|1:N| D[TOTP]
B -->|credential_type| E[api_key]
B -->|credential_type| F[oauth]
B -->|credential_type| G[password]
D -->|totp_type| H[numeric]
D -->|totp_type| I[magic_link]
```
## 数据安全
### 敏感数据加密
以下字段使用 `EncryptedString` 类型存储，确保敏感信息在数据库中加密：
- `Credential.credential_value` - 凭证值
- `CustomCredentialServiceAuthToken.api_token` - API 令牌
- `TOTP.totp_value` - TOTP 密钥
资料来源：[skyvern/forge/sdk/db/models.py]()
### 组织隔离
所有数据模型都包含 `organization_id` 字段，确保多租户环境下的数据隔离。数据访问时必须指定组织 ID，防止跨租户数据泄露。
## 与前端的交互
### API 端点
前端通过 REST API 与后端交互，关键的数据接口包括：
| 接口路径 | 用途 |
|---------|------|
| /api/v1/workflows | 工作流管理 |
| /api/v1/tasks | 任务管理 |
| /api/v1/credentials | 凭证管理 |
| /api/v1/schedules | 日程管理 |
| /api/v1/scripts | 脚本管理 |
资料来源：[skyvern-frontend/src/routes/workflows/WorkflowScriptsPage.tsx]()
资料来源：[skyvern-frontend/src/routes/schedules/ScheduleDetailPage.tsx]()
### 状态管理
前端使用 React Query 或类似工具进行服务端状态管理，从后端 API 获取数据后缓存并同步到 UI 组件。
```mermaid
sequenceDiagram
Frontend->>Backend: GET /api/v1/workflows
Backend->>Database: SELECT workflows
Database->>Backend: workflow data
Backend->>Frontend: JSON response
Frontend->>Frontend: Update UI state
```
## 总结
Skyvern 的数据库设计采用清晰的分层架构，核心数据模型覆盖了组织管理、工作流自动化、任务执行、凭证安全和日程调度等关键业务场景。通过 Repository 模式封装数据访问，配合 Alembic 进行数据库版本管理，确保了系统的可维护性和扩展性。所有敏感数据采用加密存储，组织级别的数据隔离保障了多租户环境的安全性。
---
## 凭证管理系统
### 相关页面
相关主题：[数据库与数据模型](#page-database), [浏览器自动化](#page-browser-automation)
相关源码文件
以下源码文件用于生成本页说明：
- [skyvern-frontend/src/routes/workflows/components/CredentialSelector.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/workflows/components/CredentialSelector.tsx)
- [skyvern-frontend/src/routes/credentials/CredentialsTotpTab.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/credentials/CredentialsTotpTab.tsx)
- [skyvern-frontend/src/components/CustomCredentialServiceConfigForm.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/components/CustomCredentialServiceConfigForm.tsx)
- [skyvern-frontend/src/routes/workflows/editor/nodes/HttpRequestNode/HttpRequestNode.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/workflows/editor/nodes/HttpRequestNode/HttpRequestNode.tsx)
- [skyvern/cli/mcp_tools/README.md](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern/cli/mcp_tools/README.md)
# 凭证管理系统
## 概述
Skyvern 的凭证管理系统（Credential Management System）是用于安全存储、管理和调用用户认证凭据的核心模块。该系统支持多种凭证类型和外部密钥管理服务集成，为浏览器自动化任务和工作流执行提供安全的身份验证能力。
凭证管理系统的主要职责包括：
- 安全存储密码、信用卡信息和密钥凭证
- 集成外部密钥管理服务（Bitwarden、Azure Key Vault、1Password）
- 支持双因素认证（2FA/TOTP）流程
- 为工作流节点和 HTTP 请求提供凭证注入能力
- 管理会话持久化和浏览器认证状态
资料来源：[CredentialSelector.tsx:45-52]()
## 凭证类型
Skyvern 支持三种主要凭证类型，每种类型对应不同的使用场景。
| 凭证类型 | 英文标识 | 说明 |
|---------|---------|------|
| 密码凭证 | password | 用于网站登录和表单认证的用户名密码组合 |
| 信用卡凭证 | credit_card | 用于支付表单的信用卡信息存储 |
| 密钥凭证 | secret | 用于 API 密钥、OAuth Token 等敏感字符串 |
凭证类型在前端界面中通过下拉选择器呈现，用户可以根据实际需求选择相应的凭证类型进行配置。
资料来源：[CredentialSelector.tsx:43-53]()
## 凭证选择器组件
`CredentialSelector` 是工作流编辑器中用于选择已配置凭证的 UI 组件。该组件提供以下功能：
### 组件特性
- 显示凭证名称和关联域名
- 根据凭证类型显示对应标签（Password / Credit Card / Secret）
- 支持过滤和搜索凭证列表
- 内置凭证创建模态框入口
### 数据展示
凭证选择器展示每个凭证的以下信息：
- 凭证名称
- 关联 URL 的主机名（从 `tested_url` 字段提取）
- 凭证类型标签
- 凭证描述
```tsx
{credential.credential_type === "password"
? "Password"
: credential.credential_type === "credit_card"
? "Credit Card"
: "Secret"}
```
资料来源：[CredentialSelector.tsx:37-54]()
## 双因素认证（TOTP）支持
Skyvern 提供了完整的双因素认证（Time-based One-Time Password）支持，用于处理需要动态验证码的认证场景。
### TOTP 凭证标签
`CredentialsTotpTab` 组件提供 TOTP 凭证管理界面，包含以下功能：
- **验证码推送表单**：用户输入收到的验证码，Skyvern 自动提取并关联到相关任务执行
- **按标识符过滤**：支持按邮箱或手机号码筛选 TOTP 凭证记录
- **按类型过滤**：支持选择全部类型、纯数字验证码（totp）或魔法链接（magic_link）
### 2FA 代码处理流程
用户在认证过程中收到包含验证码的消息后，通过推送表单将验证码提交给 Skyvern。系统自动识别验证码格式并附加到相应的运行实例。
```tsx
Push a 2FA Code
Paste the verification message you received. Skyvern extracts the code
and attaches it to the relevant run.
```
资料来源：[CredentialsTotpTab.tsx:14-19]()
## 自定义凭证服务配置
对于需要使用私有密钥管理服务的场景，Skyvern 支持配置自定义凭证服务。
### 配置表单功能
`CustomCredentialServiceConfigForm` 组件提供以下配置选项：
- **API 基础 URL**：指定凭证服务 API 的基础地址
- **认证令牌**：输入服务的访问令牌
- **令牌类型**：支持多种令牌认证方式
- **创建时间**：记录凭证服务的初始化时间
### 敏感信息处理
系统对敏感信息进行掩码处理，只显示令牌的前 8 个字符：
```tsx
Token (masked):{" "}
{parsedConfig.api_token.length > 8
? `${parsedConfig.api_token.slice(0, 8)}...`
: "********"}
```
资料来源：[CustomCredentialServiceConfigForm.tsx:23-32]()
## MCP 工具集成
Skyvern 通过 MCP（Model Context Protocol）提供完整的凭证管理工具集，支持在 AI 应用中调用凭证操作。
### 可用工具列表
| 工具名称 | 功能说明 |
|---------|---------|
| skyvern_login | 执行网站登录流程 |
| skyvern_credential_list | 列出所有可用凭证 |
| skyvern_credential_get | 获取指定凭证详情 |
| skyvern_credential_delete | 删除指定凭证 |
### 支持的密钥管理服务
MCP 凭证工具支持与以下密钥管理服务集成：
- **Skyvern Vault**：内置的安全存储服务
- **Bitwarden**：开源密码管理器
- **1Password**：商业密码管理平台
- **Azure Key Vault**：微软云密钥管理服务
所有集成都支持自动处理双因素认证（2FA）和 TOTP 流程。
资料来源：[cli/mcp_tools/README.md:26-32]()
## 工作流中的凭证使用
### HTTP 请求节点
在工作流编辑器中，`HttpRequestNode` 组件为 HTTP 请求提供凭证注入能力。支持的凭证引用格式包括：
```json
// 密码凭证引用
{{ my_credential.username }}
{{ my_credential.password }}
// 密钥凭证引用
{{ my_secret.secret_value }}
```
凭证变量在运行时会被自动替换为实际存储的敏感值。
### 快速提示功能
HTTP 请求节点内置了凭证使用指引，帮助用户正确配置认证信息：
- 导入 cURL 功能：从 API 文档快速转换请求配置
- 快速添加头部：自动插入常用的认证和内容类型头部
- 响应数据引用：在后续节点中引用请求返回的状态码、头部和响应体
资料来源：[HttpRequestNode.tsx:8-22]()
## 凭证数据模型
### 核心字段
凭证对象包含以下核心属性：
| 字段名 | 类型 | 说明 |
|-------|------|------|
| credential_id | string | 凭证唯一标识符 |
| credential_type | enum | 凭证类型（password/credit_card/secret） |
| name | string | 凭证显示名称 |
| tested_url | string | 关联的测试 URL（可选） |
| created_at | datetime | 创建时间戳 |
| api_base_url | string | 自定义服务的 API 地址 |
| api_token | string | 访问令牌（存储时加密） |
| token_type | string | 令牌类型标识 |
### 自定义凭证服务对象
对于外部服务集成，凭证服务配置包含：
| 字段名 | 说明 |
|-------|------|
| id | 服务配置唯一标识 |
| token_type | 令牌类型 |
| created_at | 配置创建时间 |
| api_base_url | API 基础地址 |
| api_token | 认证令牌（加密存储） |
资料来源：[CustomCredentialServiceConfigForm.tsx:18-23]()
## 安全设计
### 敏感数据保护
系统采用多层安全策略保护敏感凭证数据：
1. **存储加密**：API 令牌等敏感信息在数据库中加密存储
2. **显示掩码**：前端界面只显示部分令牌信息，防止信息泄露
3. **传输安全**：通过 HTTPS 协议确保数据传输安全
4. **访问控制**：凭证访问需要相应的权限验证
### 凭证隔离
每个工作区和用户拥有独立的凭证存储空间，确保不同租户之间的数据隔离。
## 相关命令
Skyvern CLI 提供了便捷的凭证管理命令：
```bash
# 列出所有凭证
skyvern credential list
# 获取指定凭证
skyvern credential get
# 删除凭证
skyvern credential delete
```
## 扩展阅读
- [MCP 集成文档](../integrations/mcp/README.md)
- [工作流编辑器指南](../skyvern-frontend/src/routes/workflows/editor/README.md)
- [浏览器自动化配置](../README.md#browser-configuration)
---
## 前端组件结构
### 相关页面
相关主题：[系统架构设计](#page-architecture)
相关源码文件
以下源码文件用于生成本页说明：
- [skyvern-frontend/src/routes/tasks/create/CreateNewTaskForm.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/tasks/create/CreateNewTaskForm.tsx)
- [skyvern-frontend/src/routes/tasks/create/SavedTaskForm.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/tasks/create/SavedTaskForm.tsx)
- [skyvern-frontend/src/routes/workflows/RunWorkflowForm.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/workflows/RunWorkflowForm.tsx)
- [skyvern-frontend/src/routes/workflows/editor/panels/WorkflowHistoryPanel.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/workflows/editor/panels/WorkflowHistoryPanel.tsx)
- [skyvern-frontend/src/routes/workflows/editor/panels/schedulePanel/ScheduleCard.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/workflows/editor/panels/schedulePanel/ScheduleCard.tsx)
- [skyvern-frontend/src/routes/workflows/editor/nodes/StartNode/StartNode.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/workflows/editor/nodes/StartNode/StartNode.tsx)
- [skyvern-frontend/src/routes/schedules/CreateOrgScheduleDialog.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/schedules/CreateOrgScheduleDialog.tsx)
- [skyvern-frontend/src/routes/schedules/ScheduleDetailPage.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/schedules/ScheduleDetailPage.tsx)
- [skyvern-frontend/src/routes/credentials/CredentialsTotpTab.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/credentials/CredentialsTotpTab.tsx)
- [skyvern-frontend/src/routes/workflows/components/WorkflowsTable.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/workflows/components/WorkflowsTable.tsx)
- [skyvern-frontend/src/routes/workflows/components/CreateFromTemplateDialog.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/workflows/components/CreateFromTemplateDialog.tsx)
- [skyvern-frontend/src/routes/workflows/copilot/WorkflowCopilotChat.tsx](https://github.com/Skyvern-AI/skyvern/blob/main/skyvern-frontend/src/routes/workflows/copilot/WorkflowCopilotChat.tsx)
# 前端组件结构
## 概述
Skyvern 前端是一个基于 React 和 TypeScript 构建的单页应用（SPA），负责提供用户与 Skyvern 自动化引擎交互的界面。前端采用现代化的组件架构，通过 `react-router-dom` 进行路由管理，使用 React Hook Form 进行表单处理，并借助 Tailwind CSS 实现样式系统。组件结构按照功能模块划分为任务（Tasks）、工作流（Workflows）、调度（Schedules）和凭证（Credentials）四大核心区域。
## 目录结构
Skyvern 前端源码位于 `skyvern-frontend/src/` 目录下，核心路由和组件按照以下结构组织：
```
skyvern-frontend/src/
├── routes/ # 路由层
│ ├── tasks/ # 任务模块
│ │ ├── create/ # 任务创建相关组件
│ │ └── ...
│ ├── workflows/ # 工作流模块
│ │ ├── editor/ # 工作流编辑器
│ │ │ ├── panels/ # 编辑器面板
│ │ │ ├── nodes/ # 节点组件
│ │ │ └── Workspace.tsx
│ │ ├── components/ # 工作流通用组件
│ │ ├── copilot/ # AI 副驾驶组件
│ │ └── workflowRun/ # 工作流运行相关
│ ├── schedules/ # 调度模块
│ ├── credentials/ # 凭证模块
│ └── App.tsx # 应用根组件
└── components/ # 共享组件库
```
## 核心模块架构
### 1. 任务模块（Tasks）
任务模块负责创建和管理自动化任务，是 Skyvern 前端的核心功能之一。
#### 1.1 CreateNewTaskForm 组件
`CreateNewTaskForm.tsx` 是新建任务的表单组件，提供了导航目标（Navigation Goal）的输入功能。
| 字段 | 类型 | 说明 |
|------|------|------|
| navigationGoal | string | 描述 Skyvern 应该去哪里以及做什么 |
| navigationPayload | object | 指定重要参数、路由或状态（高级设置） |
组件使用 `AutoResizingTextarea` 组件实现自动调整高度的文本输入区域，当值为 `null` 时显示空字符串。高级设置区域通过条件渲染展示 `navigationPayload` 输入框。
资料来源：[CreateNewTaskForm.tsx:10-25]()
#### 1.2 SavedTaskForm 组件
`SavedTaskForm.tsx` 用于加载和编辑已保存的任务。与 `CreateNewTaskForm` 类似，但增加了代码编辑器（CodeEditor）支持 JSON 格式的 `navigationPayload` 输入。高级设置区域可通过按钮切换显示/隐藏状态。
资料来源：[SavedTaskForm.tsx:1-50]()
### 2. 工作流模块（Workflows）
工作流模块是 Skyvern 前端最复杂的部分，包含了可视化编辑器、执行表单、历史记录和 AI 副驾驶等功能。
#### 2.1 工作流编辑器架构
工作流编辑器采用节点面板（Node Panels）的架构设计，核心组件包括：
- **WorkflowEditor.tsx** - 编辑器主容器
- **WorkflowHistoryPanel.tsx** - 历史记录面板
- **StartNode.tsx** - 起始节点配置
#### 2.2 StartNode 节点配置
`StartNode` 组件定义了工作流执行的核心参数：
| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| runWith | enum | "agent" | 执行方式：Skyvern Agent 或 Code |
| aiFallback | boolean | - | 启用 AI 自愈功能，代码执行失败时自动回退到 AI 重新生成 |
| codeKey | string | - | 可选的代码缓存键值 |
组件使用 `HelpTooltip` 组件提供上下文相关的帮助提示，使用 `Select` 组件选择执行方式，使用 `Switch` 组件控制布尔选项。
资料来源：[StartNode.tsx:1-40]()
#### 2.3 RunWorkflowForm 执行表单
`RunWorkflowForm.tsx` 是运行工作流的表单组件，集成了以下功能：
**输入参数验证**
针对不同类型的工作流参数，表单实现了差异化的验证逻辑：
```typescript
// JSON 类型参数验证
if (parameter.workflow_parameter_type === "json") {
if (value === null || value === undefined) {
return "This field is required";
}
if (typeof value === "string") {
const trimmed = value.trim();
if (trimmed === "") {
return "This field is required";
}
try {
JSON.parse(trimmed);
return true;
} catch (e) {
return "Invalid JSON";
}
}
}
// 布尔类型参数验证
if (parameter.workflow_parameter_type === "boolean") {
if (value === null || value === undefined) {
return "This field is required";
}
}
// 数值类型参数验证
if (parameter.workflow_parameter_type === "integer" ||
parameter.workflow_parameter_type === "float") {
if (value === null || value === undefined || Number.isNaN(value)) {
return "This field is required";
}
}
```
资料来源：[RunWorkflowForm.tsx:1-80]()
**Webhook 回调 URL 验证**
表单使用 Zod schema 进行 URL 格式验证：
```typescript
rules={{
validate: (value) => {
if (value === null || value === "") {
return;
}
if (typeof value !== "string") {
return "Invalid URL";
}
const urlSchema = z.string().url({ message: "Invalid URL" });
const { success } = urlSchema.safeParse(value);
if (!success) {
return "Invalid URL";
}
},
}}
```
#### 2.4 WorkflowsTable 工作流列表
`WorkflowsTable.tsx` 提供了工作流的分页列表展示功能，集成了分页组件（Pagination）用于导航。
#### 2.5 CreateFromTemplateDialog 模板对话框
模板对话框允许用户基于预设模板创建工作流，支持模板搜索和筛选功能。组件使用卡片式布局展示模板，支持模糊搜索匹配模板标题和描述。
资料来源：[CreateFromTemplateDialog.tsx:1-60]()
### 3. 调度模块（Schedules）
调度模块管理定时执行的工作流任务。
#### 3.1 CreateOrgScheduleDialog 创建调度对话框
创建调度的对话框组件提供了以下功能：
| 功能 | 组件类型 | 说明 |
|------|----------|------|
| 工作流选择 | Select | 从可用工作流列表中选择 |
| 调度名称 | Input | 可选，自动生成如果为空 |
| 调度描述 | Input | 可选 |
| 参数配置 | ScheduleParametersSection | 工作流参数输入 |
| Cron 预设 | Button Group | 常用 Cron 表达式快速选择 |
| 自定义 Cron | Input | 手动输入 Cron 表达式 |
组件预设了多个 Cron 表达式模板供快速选择：
```typescript
const CRON_PRESETS = [
{ label: "Every hour", expression: "0 * * * *" },
{ label: "Every day", expression: "0 0 * * *" },
{ label: "Every week", expression: "0 0 * * 0" },
// ...
];
```
资料来源：[CreateOrgScheduleDialog.tsx:1-80]()
#### 3.2 ScheduleCard 调度卡片
`ScheduleCard` 组件用于在工作流编辑器面板中展示单个调度任务，包含以下功能：
- 调度名称和时间显示
- 时区信息展示
- 启用/禁用开关（Switch）
- 删除操作按钮
- 下次执行时间预览
```typescript
onToggle(schedule.workflow_schedule_id, checked)
}
/>
```
资料来源：[ScheduleCard.tsx:1-50]()
#### 3.3 ScheduleDetailPage 调度详情页
调度详情页展示调度的完整信息，包括创建时间、最后修改时间、Cron 表达式和时区等元数据。
```typescript
Created
{basicLocalTimeFormat(schedule.created_at)}
Last Modified
{basicLocalTimeFormat(schedule.modified_at)}
```
资料来源：[ScheduleDetailPage.tsx:1-50]()
### 4. 凭证模块（Credentials）
凭证模块管理用户的认证凭据，包括 2FA/TOTP 验证码处理。
#### 4.1 CredentialsTotpTab TOTP 凭证管理
`CredentialsTotpTab` 组件提供了以下功能：
| 功能 | 说明 |
|------|------|
| PushTotpCodeForm | 推送 2FA 验证码表单 |
| 标识符筛选 | 按邮箱或电话筛选 |
| OTP 类型筛选 | 支持全部/Numeric code/Magic link |
组件支持从验证消息中自动提取 TOTP 验证码并附加到相关运行任务。
资料来源：[CredentialsTotpTab.tsx:1-50]()
### 5. AI 副驾驶（Copilot）
#### 5.1 WorkflowCopilotChat 对话界面
`WorkflowCopilotChat` 组件提供了与 AI 副驾驶对话的功能，用户可以：
- 描述工作流目标
- 指定目标网站
- 选择要使用的凭证
- 获取 AI 生成的工作流建议
组件在最后一条消息中显示建议的工作流操作按钮（Review/Accept）。
```typescript
{showProposedPanel ? (
<>
) : null}
```
资料来源：[WorkflowCopilotChat.tsx:1-60]()
## 组件交互流程
### 工作流执行流程
```mermaid
graph TD
A[选择工作流] --> B[RunWorkflowForm]
B --> C{是否有输入参数?}
C -->|有| D[填写参数]
C -->|无| E[配置执行选项]
D --> E
E --> F{选择执行方式}
F -->|Agent| G[使用 Skyvern Agent]
F -->|Code| H{代码已缓存?}
H -->|是| I[使用缓存代码执行]
H -->|否| J[先生成代码]
I --> K{执行失败且启用AI Fallback?}
J --> K
K -->|是| L[回退到 AI 重新生成]
K -->|否| M[标记失败]
G --> N[Webhook 回调结果]
L --> N
M --> N
```
### 调度创建流程
```mermaid
graph LR
A[CreateOrgScheduleDialog] --> B[选择工作流]
B --> C[配置参数值]
C --> D[设置 Cron 表达式]
D --> E[选择时区]
E --> F[提交创建]
F --> G[ScheduleCard 显示]
```
## 表单验证模式
Skyvern 前端采用 React Hook Form 进行表单状态管理，验证模式遵循以下规则：
### 必填字段验证
```typescript
// 字符串类型
if (parameter.workflow_parameter_type === "string") {
if (value === null || value === undefined) {
return "This field is required";
}
if (typeof value === "string" && value.trim() === "") {
return "This field is required";
}
}
// 文件 URL 类型
if (parameter.workflow_parameter_type === "file_url") {
if (value === null || value === undefined ||
(typeof value === "string" && value.trim() === "")) {
return "This field is required";
}
}
```
### URL 验证
使用 Zod schema 进行 URL 格式验证：
```typescript
const urlSchema = z.string().url({ message: "Invalid URL" });
const { success } = urlSchema.safeParse(value);
if (!success) {
return "Invalid URL";
}
```
## 状态管理模式
### 组件状态管理
组件内部使用 React Hook 管理状态：
| Hook | 用途 | 示例 |
|------|------|------|
| useState | 本地状态 | 筛选条件、对话框开关 |
| useForm | 表单状态 | 表单值、错误、提交处理 |
| useMutation | 异步操作 | 创建、更新、删除操作 |
| useQuery | 数据获取 | 工作流列表、详情查询 |
### 状态提升
在需要跨组件共享状态的场景中，组件通过回调函数将状态提升到父组件管理：
```typescript
const handleParameterChange = (key: string, value: any) => {
setParameters((prev) => ({ ...prev, [key]: value }));
};
```
## UI 组件库
Skyvern 前端使用以下核心 UI 组件库：
| 组件 | 来源 | 用途 |
|------|------|------|
| AutoResizingTextarea | 自定义 | 自动调整高度的文本输入 |
| CodeEditor | 自定义 | 代码/JSON 编辑器 |
| ProxySelector | 自定义 | 代理位置选择 |
| Select/SelectContent/SelectItem | Radix UI | 下拉选择框 |
| Dialog/DialogContent | Radix UI | 对话框 |
| Table/TableHeader/TableBody | Radix UI | 表格 |
| Switch | Radix UI | 开关控件 |
| Button | 自定义 | 按钮组件 |
| Badge | 自定义 | 标签组件 |
## 样式系统
前端使用 Tailwind CSS 进行样式管理，采用以下设计规范：
- **颜色系统**：使用 `slate-*` 色系定义文本和背景
- **间距系统**：使用 `gap-*`、`space-y-*` 定义间距
- **圆角**：使用 `rounded-lg`、`rounded-md` 定义圆角
- **阴影**：使用 `shadow-*` 定义阴影效果
- **深色模式**：组件支持 `dark:` 前缀实现深色模式适配
## 组件导出规范
每个组件文件通过命名导出（Named Export）导出组件：
```typescript
export { WorkflowHistoryPanel };
export { ScheduleCard };
export { WorkflowsTable };
```
这种方式便于 Tree Shaking 优化和按需导入。
## 总结
Skyvern 前端采用了清晰的分层架构设计，将功能模块划分为任务、工作流、调度和凭证四大领域。每个领域包含表单、面板、对话框等特定类型的组件，通过 React Hook Form 实现统一的表单管理。组件之间通过回调函数和状态提升实现解耦，同时借助 TypeScript 的类型系统确保代码的健壮性。前端使用 Tailwind CSS 实现响应式设计，并支持深色模式，为用户提供一致且现代的界面体验。
---
---
## Doramagic 踩坑日志
项目：Skyvern-AI/skyvern
摘要：发现 23 个潜在踩坑项，其中 1 个为 high/blocking；最高优先级：安全/权限坑 - 来源证据：what ensures it’s the correct one in that context?。
## 1. 安全/权限坑 · 来源证据：what ensures it’s the correct one in that context?
- 严重度：high
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：what ensures it’s the correct one in that context?
- 对用户的影响：可能阻塞安装或首次运行。
- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_77591d02b4fa4efdb89fba55a9a7f08a | https://github.com/Skyvern-AI/skyvern/issues/5637 | 来源类型 github_issue 暴露的待验证使用条件。
## 2. 安装坑 · 来源证据：Release v1.0.29
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Release v1.0.29
- 对用户的影响：可能阻塞安装或首次运行。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_d8e67eb179f5406fb5af75a063639216 | https://github.com/Skyvern-AI/skyvern/releases/tag/v1.0.29 | 来源讨论提到 python 相关条件，需在安装/试用前复核。
## 3. 安装坑 · 来源证据：Task Execution Performance: Seeking guidance on optimizing execution speed
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Task Execution Performance: Seeking guidance on optimizing execution speed
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_7f47a5abded54abfb766032115bfa71c | https://github.com/Skyvern-AI/skyvern/issues/4375 | 来源类型 github_issue 暴露的待验证使用条件。
## 4. 安装坑 · 来源证据：[Feature Request] Multi-session VNC support for local/self-hosted deployments (Live view & Take Control)
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[Feature Request] Multi-session VNC support for local/self-hosted deployments (Live view & Take Control)
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_8f2671eacb334774963837f8f7e8edf4 | https://github.com/Skyvern-AI/skyvern/issues/4392 | 来源讨论提到 docker 相关条件，需在安装/试用前复核。
## 5. 配置坑 · 来源证据：Performance bottleneck: High latency for simple form-filling workflows
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个配置相关的待验证问题：Performance bottleneck: High latency for simple form-filling workflows
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_9820831a47af4ca28ef7abcc0fd7095e | https://github.com/Skyvern-AI/skyvern/issues/4439 | 来源类型 github_issue 暴露的待验证使用条件。
## 6. 能力坑 · 能力判断依赖假设
- 严重度：medium
- 证据强度：source_linked
- 发现：README/documentation is current enough for a first validation pass.
- 对用户的影响：假设不成立时，用户拿不到承诺的能力。
- 建议检查：将假设转成下游验证清单。
- 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。
- 证据：capability.assumptions | art_9274907e6629499384a5a574e4caa877 | https://github.com/Skyvern-AI/skyvern#readme | README/documentation is current enough for a first validation pass.
## 7. 维护坑 · 来源证据：Release v1.0.34
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：Release v1.0.34
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_660eece743754686b70883d67faffd46 | https://github.com/Skyvern-AI/skyvern/releases/tag/v1.0.34 | 来源类型 github_release 暴露的待验证使用条件。
## 8. 维护坑 · 来源证据：Release v1.0.35
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：Release v1.0.35
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_53f24132e3214005ba1dc606965c0eb7 | https://github.com/Skyvern-AI/skyvern/releases/tag/v1.0.35 | 来源类型 github_release 暴露的待验证使用条件。
## 9. 维护坑 · 维护活跃度未知
- 严重度：medium
- 证据强度：source_linked
- 发现：未记录 last_activity_observed。
- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。
- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。
- 防护动作：维护活跃度未知时，推荐强度不能标为高信任。
- 证据：evidence.maintainer_signals | art_9274907e6629499384a5a574e4caa877 | https://github.com/Skyvern-AI/skyvern#readme | last_activity_observed missing
## 10. 安全/权限坑 · 下游验证发现风险项
- 严重度：medium
- 证据强度：source_linked
- 发现：no_demo
- 对用户的影响：下游已经要求复核，不能在页面中弱化。
- 建议检查：进入安全/权限治理复核队列。
- 防护动作：下游风险存在时必须保持 review/recommendation 降级。
- 证据：downstream_validation.risk_items | art_9274907e6629499384a5a574e4caa877 | https://github.com/Skyvern-AI/skyvern#readme | no_demo; severity=medium
## 11. 安全/权限坑 · 存在安全注意事项
- 严重度：medium
- 证据强度：source_linked
- 发现：No sandbox install has been executed yet; downstream must verify before user use.
- 对用户的影响：用户安装前需要知道权限边界和敏感操作。
- 建议检查：转成明确权限清单和安全审查提示。
- 防护动作：安全注意事项必须面向用户前置展示。
- 证据：risks.safety_notes | art_9274907e6629499384a5a574e4caa877 | https://github.com/Skyvern-AI/skyvern#readme | No sandbox install has been executed yet; downstream must verify before user use.
## 12. 安全/权限坑 · 存在评分风险
- 严重度：medium
- 证据强度：source_linked
- 发现：no_demo
- 对用户的影响：风险会影响是否适合普通用户安装。
- 建议检查：把风险写入边界卡，并确认是否需要人工复核。
- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。
- 证据：risks.scoring_risks | art_9274907e6629499384a5a574e4caa877 | https://github.com/Skyvern-AI/skyvern#readme | no_demo; severity=medium
## 13. 安全/权限坑 · 来源证据：Clarification on the Custom credential documentation on the Delete API with empty body
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Clarification on the Custom credential documentation on the Delete API with empty body
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_a5164e5767dc4b618ce1c862ed440eaa | https://github.com/Skyvern-AI/skyvern/issues/4256 | 来源类型 github_issue 暴露的待验证使用条件。
## 14. 安全/权限坑 · 来源证据：GROQ error
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：GROQ error
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_fb8dab5ab6224386a6b341234a8e90be | https://github.com/Skyvern-AI/skyvern/issues/4366 | 来源讨论提到 docker 相关条件，需在安装/试用前复核。
## 15. 安全/权限坑 · 来源证据：Release v1.0.27
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Release v1.0.27
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_23488c9e7f354979bdbf8e9554b4b647 | https://github.com/Skyvern-AI/skyvern/releases/tag/v1.0.27 | 来源类型 github_release 暴露的待验证使用条件。
## 16. 安全/权限坑 · 来源证据：Release v1.0.30
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Release v1.0.30
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_6929e0e36e1549e9bd95f29d1d4cfbdf | https://github.com/Skyvern-AI/skyvern/releases/tag/v1.0.30 | 来源类型 github_release 暴露的待验证使用条件。
## 17. 安全/权限坑 · 来源证据：Release v1.0.31
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Release v1.0.31
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_40ca78dbdbe141f383c8d202f08db28b | https://github.com/Skyvern-AI/skyvern/releases/tag/v1.0.31 | 来源讨论提到 docker 相关条件，需在安装/试用前复核。
## 18. 安全/权限坑 · 来源证据：Release v1.0.32
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Release v1.0.32
- 对用户的影响：可能阻塞安装或首次运行。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_4eaa09d9a74f49efb0fb81c9bdebe6a3 | https://github.com/Skyvern-AI/skyvern/releases/tag/v1.0.32 | 来源讨论提到 python 相关条件，需在安装/试用前复核。
## 19. 安全/权限坑 · 来源证据：Release v1.0.33
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Release v1.0.33
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_ba7d530f080e4c88ad47ac26ba2781a7 | https://github.com/Skyvern-AI/skyvern/releases/tag/v1.0.33 | 来源讨论提到 docker 相关条件，需在安装/试用前复核。
## 20. 安全/权限坑 · 来源证据：Release v1.0.36
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Release v1.0.36
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_236e050a3837462692b739322738a7a2 | https://github.com/Skyvern-AI/skyvern/releases/tag/v1.0.36 | 来源讨论提到 node 相关条件，需在安装/试用前复核。
## 21. 安全/权限坑 · 来源证据：persist_browser_session flag saves sessions but never retrieves them on subsequent runs
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：persist_browser_session flag saves sessions but never retrieves them on subsequent runs
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_b56e85161a3b4b7682c8ab13127be8d0 | https://github.com/Skyvern-AI/skyvern/issues/4390 | 来源类型 github_issue 暴露的待验证使用条件。
## 22. 维护坑 · issue/PR 响应质量未知
- 严重度：low
- 证据强度：source_linked
- 发现：issue_or_pr_quality=unknown。
- 对用户的影响：用户无法判断遇到问题后是否有人维护。
- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。
- 防护动作：issue/PR 响应未知时，必须提示维护风险。
- 证据：evidence.maintainer_signals | art_9274907e6629499384a5a574e4caa877 | https://github.com/Skyvern-AI/skyvern#readme | issue_or_pr_quality=unknown
## 23. 维护坑 · 发布节奏不明确
- 严重度：low
- 证据强度：source_linked
- 发现：release_recency=unknown。
- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。
- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。
- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。
- 证据：evidence.maintainer_signals | art_9274907e6629499384a5a574e4caa877 | https://github.com/Skyvern-AI/skyvern#readme | release_recency=unknown