常见问题
FlowZap 适合哪些人
如果我在构建 AI 代理（Agent），FlowZap 适合我吗？
当然。FlowZap 虽然可供任何业务分析师或开发者使用，但它专为需要可视化代理工作流的独立开发者与 AI 构建者而设——比如「趋势抓取 → 内容生成 → 调度机器人」。无需在 Miro 里拖框，也不用背 Mermaid 语法。 如果你在 Cursor、Windsurf、Bolt、Lovable、GPT、Claude 里"凭感觉写代码"，总会遇到分支逻辑打结或难以解释多代理交接的时刻。FlowZap 是你的闪电速 AI 草稿本：一段提示，立得**三视图图表**（工作流 + 时序 + 架构）；改改代码，继续迭代。FlowZap 在我的工作流程中处于什么位置？
Vibe coding 是用 AI 工具（Lovable、Bolt、GPT、Claude、Windsurf、Cursor 等）以自然语言描述应用并迅速得到原型——速度优先。 FlowZap 以可视化方式增强这一过程：把「用 AI 做爆款 TikTok 调度器」的 GPT 大纲转换为带有「AI 分析器」「调度机器人」泳道的流程图；切到时序视图，还能发现诸如 API 延迟之类的时序问题。 它是创意加速器，在你的原型“熄火”前发现低效环节。我用 Cursor/Claude/Windsurf——FlowZap 如何集成？
安装 `flowzap-mcp` npm 包并添加到你的 AI 助手的 MCP 配置中。然后提示「设计电商推荐引擎」，你的 AI 就会调用 FlowZap 工具来验证代码并创建可分享的 playground URL。在 Cursor 或 Windsurf 中，可把 FlowZap Code 作为注释嵌入，将函数与节点关联；也可粘贴 AI 浏览器（Comet、Gemini、Dia）输出，自动填充 FlowZap 弹窗，5 秒生成图表。面向 AI 构建者的创作工作流
如何用 GPT 或 Perplexity 从头脑风暴到成图？
从 Perplexity 开始：「用 AI 做一个爆款 TikTok 调度器。」它会列出「抓趋势 → 生成文案 → 定时发布」。把结果粘贴到 FlowZap 的 AI 生成器——立即得到含「AI 分析器」「内容生成」「调度机器人」泳道的流程图。 想稳妥些？在 FlowZap Code 里加一条「人工审批循环」，再把图表喂回 GPT：「按此 FlowZap 工作流用 Node.js 实现」，即可获得结构化函数，贴合你的可视逻辑。FlowZap 能帮我调试多代理系统吗？
能。用 FlowZap 的循环与条件来图解如「航班搜索（GPT）+ 酒店匹配（Claude）+ 行程生成（自定义逻辑）」的系统——工作流视图显示预算/高端的并行路径；时序视图刻画 API 交接的时间线。 发现 Claude 响应慢？改改文本，秒级再生成，在 Cursor 内继续打磨。它是多代理编排的可视化调试器，让复杂构建变优雅系统。什么是与 Bolt 或 Lovable 的“vibe remix” 会话？
在 Lovable 里做个健身追踪器原型（「游戏化挑战 + 勋章」），再通过 MCP 把流程送入 FlowZap：「用户输入 → AI 评分 → 解锁勋章」。 时序视图会暴露延迟导致的体验问题。把交互图链接给协作者——他们在浏览器里提修改意见；你只改一次代码，处处同步。Lovable 负责 UI；FlowZap 绘后端流程；Cursor 打磨逻辑。Comet 或 Dia 这类 AI 浏览器如何与 FlowZap 配合？
在 Comet 助手里粘贴「我在做一个 AI 代理——用 FlowZap 生成步骤」，它会自动填充弹窗，点击「立即生成 FlowZap 代码！」并返回格式化代码，瞬间出图。 Chrome 的 Gemini 或 Dia 会从上下文解析意图并注入步骤；Genspark Super Agent 可免手动触发；Fellou 适合个人独奏。 整套流程即是「Prompt → 弹窗 → 生成 → 代码 → 图表」，无需手动排版，你只需可视化审阅。真实工作流示例
给我一个电商 + AI 的具体例子。
在 Cursor 里做 Shopify 商店：「用户注册，AI 推荐产品，如果有“感觉”则自动加购。」给 FlowZap 一个提示：「入职流程——用户输入兴趣，AI 推荐 3 件商品，若确认则自动加购并发邮件，否则再推荐（最多重试 2 次）。」 你会得到含用户、AI 推荐器、购物车泳道的 FlowZap Code——工作流视图有「确认 vibe？」的决策菱形；时序视图显示 AI 调用与购物车同步。五分钟搞定边界情况（“库存不足”分支），然后去 Cursor 写代码。社媒自动化代理的示例？
在 Perplexity 头脑风暴：「TikTok 调度：抓趋势、生成文案、黄金时段发布。」灌入 FlowZap AI 生成器，得到「趋势抓取 → 文案生成 → 调度 → 分析」的流程图。 切换到时序视图看看 API 延迟——如果生成器超时就加重试循环。把代码交给 GPT 写 Python 实现，或作为 Bolt 的伪代码。能否映射多 LLM 工作流（GPT + Claude + 自定义逻辑）？
能——比如行程规划：「航班搜索（GPT）并行于酒店匹配（Claude），随后由行程生成器合并输出。」 工作流视图展示并行分支；时序视图揭示 Claude 是否拖慢。加上重试（「若航班不可用则重新搜索」）与条件（「预算档跳过高端酒店」），两种视图实时联动。技术深入
什么是 FlowZap Code，有何价值？
FlowZap Code 是轻量 DSL（LANE、NODE、LOOP 片段），AI 能生成，你也能像文本一样编辑——比 PlantUML 直观，比黑盒工具更可控。 对 vibe coder 来说，它是能渲染为图表的伪代码：把它嵌入 Cursor 注释里以链接函数与节点，纳入版本控制，或分享给不懂代码的客户。什么是 .fz 文件格式？
`.fz` 扩展名是 FlowZap 的原生「代码即图表」格式——包含 FlowZap Code 的纯 UTF-8 文本文件。将图表保存为 `.fz` 文件，可在 Git 中版本控制、与团队共享，或加载到任何 FlowZap 会话中。它对人类可读、对 AI 友好，与你现有的开发工作流无缝集成。在 FlowZap Code 弹窗中点击「保存为 .fz 文件」即可下载当前图表。如何在 Claude、Cursor 或 Windsurf 中使用 FlowZap（MCP）？
安装 `flowzap-mcp` npm 包并在你的 AI 助手的 MCP 配置中添加。这将为你的 AI 提供 8 个核心工具：`flowzap_validate`（校验语法）、`flowzap_create_playground`（创建可分享的 playground URL）、`flowzap_get_syntax`（获取 DSL 文档）、`flowzap_export_graph`（解析为结构化 JSON 图）、`flowzap_artifact_to_diagram`（将 HTTP 日志 / OpenAPI / 代码转换为图表）、`flowzap_diff`（比较两个版本）、`flowzap_apply_change`（应用结构化补丁操作），以及 `flowzap_compliance_check`（SOC2 / GDPR / PIPL 审计）。无需认证——使用 FlowZap 的公共 API，内置速率限制（30 请求/分钟）。FlowZap 提供哪些公共 API？
FlowZap 提供两个公共 API 端点：`POST /api/validate` 验证 FlowZap Code 语法（每 IP 30 请求/分钟），`POST /api/playground/create` 生成临时 playground URL，有效期 60 分钟（每 IP 5 请求/分钟，50 请求/天）。两者均免费、无需认证，专为 AI 助手和自动化工具设计。滥用可能导致 IP 封禁。什么是三视图，为什么对 AI 构建者很关键？
一份 FlowZap Code 可在**三种视图**间切换：工作流（横向泳道）、时序（纵向交互时间线）和架构（带形状和连接的系统图）——在其中任意一处编辑，另两处立刻同步。 多代理系统中，工作流呈现 GPT/Claude 并行路径；时序揭示 API 交接延迟等问题；架构以组件和连接可视化你的系统设计。发现问题后加入异步处理，迭代无需重搭结构。AI 代理相关
AI 代理如何发现 FlowZap？
FlowZap 发布了一整套 well-known 发现接口，让代理能自主发现并理解它，无需任何人工配置。入口包括：A2A 代理卡片 https://flowzap.xyz/.well-known/agent-card.json、能力清单 https://flowzap.xyz/.well-known/capabilities.json、LLM 上下文文件 https://flowzap.xyz/llms.txt 与 https://flowzap.xyz/llms-full.txt，以及 https://flowzap.xyz/robots.txt 中的抓取规则。代理只需获取代理卡片，一次请求即可了解 FlowZap 的技能、接口与端点，随即开始校验与生成图表。A2A 代理卡片是什么？
flowzap.xyz 在 https://flowzap.xyz/.well-known/agent-card.json 暴露了一张代理卡片，遵循 A2A（Agent-to-Agent）协议 v1.0 的发现规范。卡片声明了 FlowZap 的身份与描述、两个接口（/mcp 上的 Streamable HTTP MCP，以及 /api 上的 HTTP REST），以及 8 项技能（即 8 个 MCP 工具），采用标准化的 AgentSkill 格式。任何兼容 A2A 的代理读取一次即可准确知道如何与 FlowZap 通信。不用配置 MCP，代理如何使用 FlowZap？
完全跳过 MCP，直接调用公共 REST 端点——无需认证，且启用 CORS，浏览器端代理同样可用。将 FlowZap Code 以 POST 发送至 https://flowzap.xyz/api/validate 进行校验，或 POST 到 https://flowzap.xyz/api/playground/create 获取可分享的交互式 playground URL（60 分钟有效期）。示例：curl -X POST https://flowzap.xyz/api/playground/create \
-H "Content-Type: application/json" \
-d '{"code":"LANE A\nNODE Start\nNODE End\nStart->End"}'
响应返回包含 playground URL 的 JSON 载荷，可直接回传给你的用户。
SOC2/GDPR/PIPL 合规检查是什么？
`flowzap_compliance_check` 工具会对 FlowZap Code 数据流图进行自动化架构合规审查，对照 SOC2、GDPR 与 PIPL 框架。LLM 分析图表——追踪数据如何在泳道与节点之间流动——并返回 Markdown 审计报告，标出风险、缺失的防护措施以及各框架特定的发现。该工具限制为每个客户端每天 3 次，非常适合在深入人工审查前快速确认“架构是否合规”。FlowZap 提供哪些 LLM 上下文文件？
FlowZap 提供机器可读的上下文文件，让代理能摄取准确且最新的文档，而非凭猜测：https://flowzap.xyz/llms.txt（精简的站点索引）、https://flowzap.xyz/llms-full.txt（完整深入的 Markdown 文档）、https://flowzap.xyz/.well-known/capabilities.json（结构化能力清单）、https://flowzap.xyz/docs/mcp.json（MCP 服务器身份、工具与传输配置），以及 https://flowzap.xyz/openapi.json（REST 端点的 OpenAPI 规范）。当你需要 FlowZap API 接口的权威信息时，请获取这些文件。FlowZap MCP 是否兼容 Streamable HTTP 传输？
兼容。除了 STDIO 的 npm 包（`flowzap-mcp`），FlowZap 还在 https://flowzap.xyz/mcp 暴露了一个 Streamable HTTP MCP 端点，使用 JSON-RPC 2.0 上的 MCP 协议版本 2025-06-18。任何支持 Streamable HTTP 传输的 MCP 客户端——Claude Desktop 的远程模式、自定义代理或基于 HTTP 的编排器——都可直接连接该 URL，无需在本地安装任何内容。模板与导出
哪里可以找到现成的工作流模板？
访问 [flowzap.xyz/templates](https://flowzap.xyz/templates) 浏览 **250+ 个生产就绪模板**，包括 **50 个架构图模板**（微服务、事件驱动、CQRS、Serverless、Saga、断路器等）以及 200 多个工作流模板。按领域（电商、医疗、金融）或用例（入职、自动化、审批流程）筛选。每个模板都是可下载的 `.fz` 文件，可直接加载到 FlowZap 中自定义使用。非常适合快速启动项目或学习 FlowZap Code 模式。能否将图表导出到 n8n 或 Make.com？
可以！FlowZap 可将工作流图表导出为 n8n JSON 和 Make.com blueprint 格式。打开 FlowZap Code 弹窗，点击目标平台的导出选项，即可获得可导入的 JSON 文件。注意：FlowZap 是设计工具——你仍需在 n8n/Make.com 中配置凭据并测试，但结构和流程逻辑会自动转移。面向 AI 构建者的对比
FlowZap 与 Mermaid.js（面向开发者）的对比？
Mermaid 需要手写 Markdown（`graph TD; A-->B`）；FlowZap 让 AI 从「设计入职流程」出发自动生成，再由你微调。 Mermaid 适合 Git 嵌入；FlowZap 以速度与**三视图**见长——非常适合在 Bolt 中原型化而不必记语法。FlowZap 与 Miro（面向代理工作流）的对比？
Miro 协作强但容易混乱——适合头脑风暴，不适合结构化代理流程。FlowZap 以「先生成」为核心（23 秒到**三图**），同时保留文本/可视双编辑。为何不只用 Claude 来描述流程？
Claude 输出是文本——FlowZap 渲染为包含循环与决策的交互式图表，非技术人员也能看懂。 两者搭配：Claude 设计流程，FlowZap 出图，你来编码。图表即文档、培训材料与调试参考，而不是被埋在聊天记录里。快速上手
今天如何开始使用 FlowZap？
访问 [flowzap.xyz](https://flowzap.xyz)，打开 AI 弹窗，粘贴「映射一个 TikTok 调度代理：趋势分析 → 文案生成 → 调度」，点击生成，查看**三图**。也可试试 AI 浏览器：在 Comet 助手里说「用 FlowZap 映射流程步骤」，弹窗会自动填充。MCP 集成请通过 npx 安装 `flowzap-mcp`——参见 [MCP 快速入门指南](https://flowzap.xyz/blog/introducing-the-flowzap-mcp-server)。哪里能看到示例？
访问 [flowzap.xyz/templates](https://flowzap.xyz/templates) 查看 **250+ 个现成模板**，包括 **50 个架构图模板**（微服务、事件驱动、CQRS、Serverless、Saga、断路器等）以及 200 多个工作流模板，涵盖电商、医疗、自动化等领域。YouTube @JulesFlowZap 有 23 秒从提示到图表的演示。博客文章如《Supercharge Your Vibe Coding Flow》提供可复制提示词。学习成本如何？
如果你会"vibe coding"，基本是零门槛——会写提示就会用 FlowZap。粘贴描述，得到图表；想要更强控制就改代码（通常 90% 由 AI 代劳）。进阶用户可调 LOOP/LANE 或使用 MCP 工具；新手直接点「查看图表」即可可视化迭代。Vibe check： FlowZap 是 AI 构建者把零散提示转化为结构化系统的秘密武器——马上在 flowzap.xyz 试试，并在 X 上 @JulesKovac 分享你的作品。