diff --git a/docs/README.md b/docs/README.md index cf8ed2bc..d6208022 100644 --- a/docs/README.md +++ b/docs/README.md @@ -20,7 +20,7 @@ CyberStrikeAI documentation is organized by user journey. Start with deployment, - [Agent 与角色](zh-CN/agent-and-role-guide.md) - [Skills 指南](zh-CN/skills-guide.md) - [Eino 多代理](zh-CN/MULTI_AGENT_EINO.md) -- [图编排](zh-CN/workflow-graph.md) +- [工作流](zh-CN/workflow-graph.md) - [人机协同最佳实践](zh-CN/hitl-best-practices.md) ### 功能指南 @@ -57,7 +57,7 @@ CyberStrikeAI documentation is organized by user journey. Start with deployment, - [Agents and Roles](en-US/agent-and-role-guide.md) - [Skills](en-US/skills-guide.md) - [Eino Multi-Agent](en-US/MULTI_AGENT_EINO.md) -- [Graph Orchestration](en-US/workflow-graph.md) +- [Workflows](en-US/workflow-graph.md) - [HITL Best Practices](en-US/hitl-best-practices.md) ### Feature guides diff --git a/docs/en-US/README.md b/docs/en-US/README.md index 1aa201ab..8ffdb73c 100644 --- a/docs/en-US/README.md +++ b/docs/en-US/README.md @@ -13,7 +13,7 @@ - [Architecture](architecture.md) · [Security Model](security-model.md) · [RBAC](rbac.md) - [Agents and Roles](agent-and-role-guide.md) · [Skills](skills-guide.md) · [Eino Multi-Agent](MULTI_AGENT_EINO.md) -- [Graph Orchestration](workflow-graph.md) · [HITL Best Practices](hitl-best-practices.md) +- [Workflows](workflow-graph.md) · [HITL Best Practices](hitl-best-practices.md) ## Feature guides diff --git a/docs/en-US/workflow-graph.md b/docs/en-US/workflow-graph.md index e0f43719..15e9981a 100644 --- a/docs/en-US/workflow-graph.md +++ b/docs/en-US/workflow-graph.md @@ -1,15 +1,15 @@ -# CyberStrikeAI Graph Orchestration Guide +# CyberStrikeAI Workflows Guide [中文](../zh-CN/workflow-graph.md) -This document explains how to use **Graph Orchestration**: building workflows on the canvas, configuring node types, passing data between nodes, and binding a graph to a role for automatic execution. +This document explains how to use **Workflows**: building workflows on the canvas, configuring node types, passing data between nodes, and binding a workflow to a role for automatic execution. --- -## 1. Where to find Graph Orchestration +## 1. Where to find Workflows 1. Log in to the CyberStrikeAI web UI. -2. Open **Graph Orchestration** in the left sidebar. +2. Open **Workflows** in the left sidebar. 3. Select an existing workflow from the list, or create a new one. 4. Drag nodes, draw edges, and configure properties on the canvas. 5. Fill in **ID**, **Name**, and **Description**, then click **Save**. diff --git a/docs/superpowers/specs/2026-07-13-local-workflow-package-api-data-contract.md b/docs/superpowers/specs/2026-07-13-local-workflow-package-api-data-contract.md index 19027c65..0dd5f057 100644 --- a/docs/superpowers/specs/2026-07-13-local-workflow-package-api-data-contract.md +++ b/docs/superpowers/specs/2026-07-13-local-workflow-package-api-data-contract.md @@ -1,6 +1,6 @@ -# 本地图编排策略包 MVP：API 与数据模型契约 v1 +# 本地工作流策略包 MVP：API 与数据模型契约 v1 -> 本文是 [本地图编排策略包 MVP 设计](2026-07-13-local-workflow-package-mvp-design.md) 的实现前契约。前端与后端以本文的路径、字段、枚举、状态码和错误码为准；未经版本升级不得改变既有字段语义。 +> 本文是 [本地工作流策略包 MVP 设计](2026-07-13-local-workflow-package-mvp-design.md) 的实现前契约。前端与后端以本文的路径、字段、枚举、状态码和错误码为准；未经版本升级不得改变既有字段语义。 ## 1. 范围与不变式 diff --git a/docs/superpowers/specs/2026-07-13-local-workflow-package-mvp-design.md b/docs/superpowers/specs/2026-07-13-local-workflow-package-mvp-design.md index 2e751357..3aaa68a8 100644 --- a/docs/superpowers/specs/2026-07-13-local-workflow-package-mvp-design.md +++ b/docs/superpowers/specs/2026-07-13-local-workflow-package-mvp-design.md @@ -1,8 +1,8 @@ -# 本地图编排策略包 MVP 设计 +# 本地工作流策略包 MVP 设计 ## 决策摘要 -本期只交付本地图编排策略管理，不接入公共市场、远程仓库、发布上传、账号、评分或订阅能力。目标是先建立稳定的工作流包格式和安全导入闭环；未来市场仅复用该包格式和本地安装器。 +本期只交付本地工作流策略管理，不接入公共市场、远程仓库、发布上传、账号、评分或订阅能力。目标是先建立稳定的工作流包格式和安全导入闭环；未来市场仅复用该包格式和本地安装器。 ## 目标与非目标 @@ -27,13 +27,13 @@ ### 导出 -1. 用户在图编排详情页选择“导出”。 +1. 用户在工作流详情页选择“导出”。 2. 系统读取单个工作流定义，生成 `.csapkg.zip`。 3. 用户下载包并可解压审查 JSON 与 Manifest。 ### 导入 -1. 用户在图编排列表页选择“导入本地包”。 +1. 用户在工作流列表页选择“导入本地包”。 2. 系统上传并解析 Zip，但不写入数据库。 3. 系统检查包结构、文件哈希、工作流 JSON，并调用 `ValidateGraphJSON`。 4. 用户查看工作流名称、ID、节点/边数量、`graph_json` hash 和冲突结果。 @@ -115,8 +115,8 @@ web-src-hunting-1.0.0.csapkg.zip ## 前端范围 -- 图编排列表页：增加“导入本地包”。 -- 图编排详情页：增加“导出”。 +- 工作流列表页：增加“导入本地包”。 +- 工作流详情页：增加“导出”。 - 导入 Modal：上传、预检结果、冲突策略和确认应用。 - `workflows.js` 负责调用新 API；不增加策略市场、远程仓库或发布 UI。 diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.md index c8f651dc..0a1901cb 100644 --- a/docs/zh-CN/README.md +++ b/docs/zh-CN/README.md @@ -13,7 +13,7 @@ - [架构说明](architecture.md) · [安全模型](security-model.md) · [RBAC](rbac.md) - [Agent 与角色](agent-and-role-guide.md) · [Skills](skills-guide.md) · [Eino 多代理](MULTI_AGENT_EINO.md) -- [图编排](workflow-graph.md) · [人机协同最佳实践](hitl-best-practices.md) +- [工作流](workflow-graph.md) · [人机协同最佳实践](hitl-best-practices.md) ## 功能指南 diff --git a/docs/zh-CN/architecture.md b/docs/zh-CN/architecture.md index 52f575ee..1520980a 100644 --- a/docs/zh-CN/architecture.md +++ b/docs/zh-CN/architecture.md @@ -14,7 +14,7 @@ flowchart LR M --> T["内置工具 / YAML 工具 / Skills FS"] M --> EM["外部 MCP"] A --> K["知识库检索"] - H --> W["Workflow 图编排"] + H --> W["Workflow 工作流"] H --> C2["内置 C2"] H --> WS["WebShell"] H --> AU["Audit / Monitor"] @@ -73,9 +73,9 @@ MCP 相关： ## Workflow -图编排在 `internal/workflow/`，HTTP 入口在 `internal/handler/workflow*.go`。它支持 start、agent、tool、condition、hitl、output、end 等节点。 +工作流引擎在 `internal/workflow/`，HTTP 入口在 `internal/handler/workflow*.go`。它支持 start、agent、tool、condition、hitl、output、end 等节点。 -详细使用见 [图编排使用说明](workflow-graph.md)。 +详细使用见 [工作流使用说明](workflow-graph.md)。 ## 知识库 diff --git a/docs/zh-CN/developer-guide.md b/docs/zh-CN/developer-guide.md index c7b70b17..2ce43245 100644 --- a/docs/zh-CN/developer-guide.md +++ b/docs/zh-CN/developer-guide.md @@ -12,7 +12,7 @@ internal/database/ SQLite 数据访问 internal/security/ 认证、限流、Shell 执行 internal/mcp/ MCP Server、外部 MCP 管理 internal/multiagent/ Eino 单代理、多代理、中间件 -internal/workflow/ 图编排运行时 +internal/workflow/ 工作流运行时 internal/knowledge/ 知识库索引与检索 internal/c2/ 内置 C2 internal/project/ 项目事实黑板 diff --git a/docs/zh-CN/workflow-graph.md b/docs/zh-CN/workflow-graph.md index 697ceac1..e383c967 100644 --- a/docs/zh-CN/workflow-graph.md +++ b/docs/zh-CN/workflow-graph.md @@ -1,15 +1,15 @@ -# CyberStrikeAI 图编排使用说明 +# CyberStrikeAI 工作流使用说明 [English](../en-US/workflow-graph.md) -本文档说明 **图编排（Graph Orchestration）** 的完整使用方式：如何在画布上搭建流程、配置各类型节点、在节点之间传递数据，以及如何将流程绑定到角色并自动运行。 +本文档说明 **工作流（Workflow）** 的完整使用方式：如何在画布上搭建流程、配置各类型节点、在节点之间传递数据，以及如何将流程绑定到角色并自动运行。 --- -## 一、在哪里使用图编排 +## 一、在哪里使用工作流 1. 登录 CyberStrikeAI Web 端 -2. 左侧导航进入 **图编排** +2. 左侧导航进入 **工作流** 3. 在左侧列表选择已有流程，或新建流程 4. 在中央画布拖拽、连线、配置节点 5. 填写流程 **ID**、**名称**、**描述** 后点击 **保存** @@ -36,7 +36,7 @@ ## 三、执行模型（先理解再配置） -图编排按 **有向图** 执行，引擎从 **开始** 节点出发，沿连线依次运行下游节点。 +工作流按 **有向图** 执行，引擎从 **开始** 节点出发，沿连线依次运行下游节点。 每次运行会维护一份内部状态，模板变量 `{{...}}` 从这里取值： @@ -389,7 +389,7 @@ HITL 等待信息会记录： ### 8.1 在角色管理中绑定 1. 进入 **角色管理**，编辑或新建角色 -2. 选择 **工作流 / 图编排** 绑定的流程 ID +2. 选择绑定的 **工作流** ID 3. 策略设为 `auto`（默认：有 `workflow_id` 时自动执行） 4. 保存角色