# WeaveFox 产品文档
> WeaveFox 是免费的 AI 应用创作平台。无需代码,通过自然语言对话,自由创造个人专属的工具与独立应用。让创意即刻成形,一键即可分享给所有人使用。
This file contains all documentation content in a single document following the llmstxt.org standard.
## 删除账户
> WIP
---
## WeaveFox 账户设置
> WIP
---
## 工作台概览
学习如何使用 WeaveFox 的工作台,创建新应用、编辑个人资料、创建技能以及授权服务。

## 创建新应用
在**应用页面**的对话框中输入你想构建的内容描述,然后点击发送以创建新应用。
了解更多信息,请查看[快速开始](../getting-started/quick-start)。
### 输入提示
在对话框输入你的想法,或点击麦克风按钮,使用语音输入并口述你的想法。
WeaveFox 将根据你的描述生成一个应用。你可以根据需要进行简明扼要或详尽的描述,例如,**一个待办事项应用,支持主题切换**,或者一个包含多段文字的详细说明。
:::info[最佳实践]
了解更多信息,请查看[最佳实践](/best-practices/overview)。
:::
### 上传附件
点击对话框左下角的**附件按钮**,你可以上传受支持的文件类型,例如图片、PDF 文档等等。
WeaveFox 会理解你上传的附件内容,并结合你输入的描述生成一个应用。
### 添加扩展技能
点击对话框左下角的**扩展按钮**,你可以选择添加一个服务或者技能来增强你的应用功能。
WeaveFox 会激活指定的技能文档和工具,生成比静态页面具备更加丰富能力的全栈应用。
:::tip[使用扩展]
通常,推荐使用扩展来增强生成应用的能力。
:::
## 侧边栏与导航
### 应用
在应用页面你可以查看和管理**你创建的应用以及你参与协作的应用**,通过应用卡片进入应用创作页面、设置页面、公开分享页面。
### 个人主页
个人主页主页展示你的**个人资料**,包括用户名、用户 ID、个性签名,包括你的一些社交数据(粉丝数量、关注用户数量、应用获赞数量),其中点击粉丝、关注可以查看具体的用户列表数据。用户名旁边的编辑按钮可以进入个人资料编辑页面,你可以在其中修改你的用户名、用户 ID、个性签名、头像等信息。
同时,该页面也会展示你的个人**创作足迹日历**,统计数据来源于你在 WeaveFox 的一些创作行为和社交行为,例如创建应用、公开应用、创建技能、关注其他用户等等。
你设置为**公开的所有应用**作品会展示在该页面的下方。
:::tip[个人主页]
个人主页是公开的,任何人都可以访问查看你的个人主页和你公开的应用作品,其它用户可以关注你,也能为你公开的应用作品点赞收藏。
:::
### 点赞收藏
该页面会展示你**点赞收藏**过的所有公开应用作品的列表。
### 发现
在发现页面你可以查看 **WeaveFox 实时推荐的热门创作者与应用作品**,探索其它用户的创作,获取灵感。
### 技能
在技能页面你可以查看和管理**你创建的技能**,通过技能卡片进入技能详情页面,进行编辑或者设置公开状态。
:::info[技能]
了解更多信息,请查看[技能](/features/build/skills)。
:::
### 服务
在服务页面你可以查看 WeaveFox 集成的所有服务,并管理**你授权的三方服务**,通过服务卡片进入服务详情页面,查看服务的详细信息,或者管理授权信息。
:::info[集成服务]
了解更多信息,请查看[集成服务](/integrations/overview)。
:::
## 消息通知
点击你头像旁边的**消息通知按钮**,你可以查看 WeaveFox 的系统消息和通知,例如其它用户关注了你、点赞收藏了你公开的应用,你的应用公开、技能公开审核通知等等。
---
## 创建账户
创建你的 WeaveFox 账户,即可开始**使用自然语言构建和迭代全栈 Web 应用程序**。
WeaveFox 账户是你在平台上的个人身份,用于登录、管理个人资料与偏好、以及访问工作台中的创作应用。无论你参与多少应用创作,只需要一个账户。
任何人都可以**免费注册**。注册后,WeaveFox 会自动为你创建个人工作台,你可以立即开始创作。
## 在 weavefox.cn 注册
访问 [www.weavefox.cn](https://www.weavefox.cn),点击**开始创作**,选择以下任一方式注册:
- **手机号** — 输入手机号并通过短信验证码完成注册
- **支付宝** — 使用支付宝账号授权登录,并完成首次手机号绑定即可注册成功
:::tip
注册完成后,点击**开始创作**或者你的**个人头像**即可进入工作台。
:::
## 工作台
**工作台**是你的创作空间,保存你的应用和资源,你使用一个账户登录,在该账户下管理你的所有创作内容。你可以:
- **应用** — 查看你创建的应用以及你参与协作的应用
- **个人主页** — 管理你的个人资料,查看你的粉丝列表、关注列表,以及创作足迹日历与公开的应用列表
- **点赞收藏** — 查看你点赞过的他人公开应用的列表
- **技能** — 创建你的技能,为创作的应用提供更丰富的能力
- **服务** — 查看 WeaveFox 支持的集成服务,并授权管理三方服务
## 常见问题
### 收不到验证码怎么办?
- 检查手机短信是否被拦截或归入垃圾短信
- 确认输入的手机号格式正确
- 等待 60 秒后重新获取验证码
- 如持续无法收到,请加入用户群进行反馈
## 接下来
账户创建完成后,你可以:
- 创建你的第一个应用,体验应用生成能力
- 完善个人资料,在**工作台-个人主页**页面设置头像、昵称、社交媒体 ID 和个人简介
- 了解更多创作方式,浏览[最佳实践](/best-practices/overview)
---
## 套餐与额度
WeaveFox 目前**没有付费计划**,应用创作完全免费。你可以自由使用平台的所有创作能力,无需担心额度限制。
## 集成服务额度
WeaveFox 提供的部分集成服务设有**月度免费额度**,帮助创作者实现更多创意创作,而无需额外付费。
月度额度在每月初自动重置,未使用的额度不会累积到下月。
:::info
关于集成服务的具体额度与用量,请参阅[集成服务](/integrations/overview)。
:::
## 常见问题
- **创作应用有数量限制吗?**
当前用户创作的应用数量没有任何限制,但我们禁止对产品功能的滥用行为。
---
## 快速开始
创建你的第一个应用,通过对话的方式添加后端功能,并发布你的应用。
:::info[创作指南]
这份文档将指导你使用 WeaveFox 从零开始创建一个全栈应用,包含登录功能与云端数据库存储。
:::

## WeaveFox 产品概述
创建你的第一个应用
- 第一步
请前往 [**www.weavefox.cn**](https://www.weavefox.cn) 创建账户。
- 第二步
只需输入一个初始提示来启动,WeaveFox 会帮你完成剩下的任务!这是《WeaveFox》中任何创作任务的起点,你可以**瞬间将创意与想法变为现实**。
WeaveFox 工作台
在 WeaveFox 中,简单是关键:
- 在[**这里**](https://www.weavefox.cn/vault),你只需一个提示即可启动你的项目。
- 从[**发现页**](https://www.weavefox.cn/discover)探索所有项目,包括最新和热门应用。
- 通过查看和编辑你的**个人主页**资料,个性化你的体验。
应用概述
在 WeaveFox 中,每个应用的创作任务都遵循结构化工作流程:
- 使用基于聊天的界面**轻松编辑**。
- **附上图片**以便精准编辑和灵感理解。
- 通过**版本历史**跟踪变更,并恢复到任何之前的版本。
- 启用 **WeaveFox 云服务**实现后端功能。
- **发布、部署并通过链接分享**你的项目(记得更改后重新发布)。
- 在**网页视图和移动视图之间切换**,实现响应式设计。
- **预览模式**可以立即查看更新。
应用设置
每个应用的设置都赋予你以下能力:
- **查看应用的关键细节**,如对话编辑次数和创建日期。
- 根据需要**调整项目访问权限**。
- 随时**更改应用名称、描述与标签**。
- **删除你的应用**(⚠️ 危险操作)。
## 开始创作你的应用
根据你的需求,有以下几种方式可以开始使用 WeaveFox 进行创作:
提示词
直接通过自然语言对话的方式开始。
- 只需要在聊天框中描述你想构建什么。
- 越具体,效果越好。
- 从描述清晰且详细的提示开始。
- 你可以边做边细化和调整应用。
使用草图
有时候,视觉表达比文字更有效。你可以通过上传草图来指导 WeaveFox 理解你的设计意图。
- 第一步
使用其它绘图工具绘制你的 UI。
- 第二步
将你绘制的 UI 进行截图,通过粘贴或者上传图片附件的方式添加到对话框,然后编写提示并发送。WeaveFox 会根据你的草图 UI 布局实现为真实的 Web 应用。
复刻网站或者其它应用
- 第一步
使用截图工具获取你想要复刻的网站或者其它应用的界面截图。
- 第二步
通过粘贴或者上传图片附件的方式添加到对话框,然后编写提示并发送。
## 编辑你的应用
提示词
直接通过自然语言对话的方式对应用进行编辑调整。
在对话中添加图片
直接在聊天中附上图片,为提示词增添上下文。这使得更容易说明那些 UI 相关而非功能描述的观点或概念。
## 为你的应用添加全栈能力
连接后端
如果你需要为应用添加后端功能,你可以:
- 连接 **WeaveFox 内置的 Appwrite BaaS**,在提示词中提及需要实现云端存储能力,WeaveFox 会自动识别并集成 Appwrite 云服务。
- 自己申请 Supabase 账户,并**在 WeaveFox 服务页面进行授权**。
集成 AI 服务
如果你需要为应用添加 AI 服务能力,**WeaveFox 已经开箱即用的集成了常见的多种服务能力**。
- 提示词中直接描述你需要的 AI 服务,例如 OCR、LLM 等等,WeaveFox 会自动识别并集成对应的服务。
## 部署并发布你的应用
设置自定义域名
你可以为你的应用设置个性化、语义化的域名,提升用户体验和品牌形象。你可以通过以下几种方式配置:
- 在应用设置中,找到**个性化域名**选项进行编辑配置。
- 在应用聊天页面,点击右上角**发布按钮**后出现的弹层中进行编辑。
更多信息请查看[自定义域名](/features/deploy-host/custom-domain)。
发布应用
应用准备好后,发布后会生成可分享的 URL 链接。这使你可以轻松展示应用或与合作者和利益相关者分享。
更多信息请查看[发布应用](/features/deploy-host/publish-app)。
:::tip[视频教程]
想快速上手?观看 [**最佳实践 — 如何实现应用的创作和发布**](/best-practices/overview),2 分钟掌握从构思到发布的完整流程。
:::
---
## 欢迎使用 WeaveFox
[WeaveFox](https://www.weavefox.cn/) 是**免费**的 AI 应用创作平台。无需代码,通过自然语言对话,自由创造个人专属的工具与独立应用。让创意即刻成形,一键即可分享给所有人使用。

## 适合谁使用
WeaveFox 面向不同规模的个人与团队,帮助他们将创意快速落地。
**独立创作者**
- 创业者与产品经理,快速验证 MVP 或早期产品想法
- 学生与教育工作者,完成课程项目、学习实验或创意探索
- 独立开发者与 Maker,构建个人项目、原型或小产品
**产品、设计与运营团队**
- 产品经理,创建可交互原型以验证流程与需求
- 设计师,从静态稿迈向可直接使用的界面
- 运营与市场人员,搭建落地页、活动页面和轻量工具
**技术团队与机构**
- 开发者,快速搭建项目、内部工具和早期原型
- 工程团队,审查、扩展和维护生成的代码
- 交付团队,为客户交付项目,代码自主可控
## 你可以构建什么
WeaveFox 支持广泛的 Web 应用创作,从早期探索到正式产品。
**SaaS 与商业应用**
订阅制产品、客户仪表盘、管理后台和多用户应用
**面向消费者的 Web 应用**
社区平台、内容平台和面向终端用户的应用
**市场与在线交易**
预约工具、在线商店和交易平台应用
**内部工具**
工作流工具、运营仪表盘和团队内部使用的应用
**网站与营销页面**
公司官网、落地页和活动页面
**教育与互动内容**
学习工具、课程平台、学生门户,以及简单的网页小游戏、问答和模拟演示
## WeaveFox 如何融入你的工作流
WeaveFox 旨在融入你现有的工具与流程,而非改变你的工作方式:
1. **描述你想构建的内容** — 用自然语言告诉 WeaveFox 你的想法
2. **审查与迭代** — 查看生成的应用,持续调整直到满意
3. **一键分享** — 将创作成果即时发布,让创意触达更多人
:::tip[AI 友好文档]
本站提供面向 LLM 优化的文档,供 AI 工具(如 Claude Code、Codex、Cursor 等)直接读取:
- [llms.txt](https://docs.weavefox.ai/llms.txt) — 精简版文档摘要,适合快速了解平台能力
- [llms-full.txt](https://docs.weavefox.ai/llms-full.txt) — 详细版文档,包含所有细节与示例
:::
---
## 数据分析
WeaveFox 为每个应用提供内置的数据分析能力,帮助你了解用户如何使用你的应用。
## 访问数据分析
进入应用创作页面后,点击左侧导航栏的**分析**标签页,即可查看应用的数据概览。
## 默认采集的数据
应用发布后,系统会自动采集以下用户行为数据,无需任何配置:
| 指标 | 说明 |
| ---------------- | --------------------------- |
| PV(页面浏览量) | 页面被访问的总次数 |
| UV(独立访客数) | 访问页面的独立用户数 |
| 操作系统 | 用户使用的操作系统分布 |
| 设备类型 | 桌面端、移动端、平板等分布 |
| 浏览器 | Chrome、Safari、Edge 等分布 |
| 语言 | 用户浏览器语言分布 |
| 来源域名 | 用户从哪个网站跳转而来 |
这些数据以图表形式展示,包括 30 天访问趋势、各维度占比分布等。
## 了解更多
添加自定义事件采集,请查看[用户行为埋点](/integrations/apps/tracking)服务文档。
---
## 规划模式
规划模式是 WeaveFox 提供的任务拆解与逐步执行功能。当你有较为复杂的需求时,可以启用规划模式,让 AI 帮你将任务拆分为多个可执行的子任务,然后逐步完成。
## 启用方式
在聊天输入框中,点击 **「规划」** 按钮即可启用规划模式。
## 功能特点
### 任务拆解
启用规划模式后,AI 会先分析你的需求,将复杂的任务拆分为多个子任务,并为每个子任务生成具体的执行计划。
### 待办清单
在输入框上方显示待办清单 (Todo List),包含:
- **任务标题**:每个子任务的名称
- **任务描述**:该任务的具体执行步骤
- **执行状态**:进行中 / 已完成 / 已取消
## 使用场景
- **复杂功能开发**:需要多个步骤才能完成的功能
- **系统重构**:涉及多个文件的修改
- **批量任务**:需要按顺序执行的多项操作
- **新功能规划**:不确定如何开始,需要 AI 给出实施建议
## 注意事项
- 规划模式适用于较复杂的任务,简单任务无需启用
- 规划模式相较于常规模式耗时可能较长,但会获得更好的任务完成质量
- 在不主动启用规划模式的情况下,WeaveFox 会视任务复杂度自动判断是否进入规划模式,如果不想使用该模式,请在提示词中描述不使用规划模式
---
## 技能
创建技能,为 WeaveFox 定义可重用的按需工作流。打包重点明确的说明文档、操作手册和清单,在遇到匹配的任务时告诉 WeaveFox 使用技能来构建应用功能。
技能让你教 WeaveFox 如何处理重复性任务。告诉 WeaveFox 一次你想怎么做,每次遇到类似任务时它都会应用同样的工作流程。
技能是简短的、命名的操作手册,每个技能都有一个名称、一个告诉 WeaveFox 何时使用该技能的描述,以及一个包含 WeaveFox 在使用该技能时应遵循的指令文档说明。
## 技能的用途
技能最适合用于特定任务的工作流程,你希望 WeaveFox 每次都以相同的方式重复执行这些流程。常见用途包括:
- 设计风格定义
- 周期性内容任务(版本说明、变更日志、客服支持回复、营销文案)
- 通用业务流程的需求文档(登录功能设计、计费逻辑、管理权限设计)
- 专业知识文档(特定领域知识、三方服务集成说明)
:::tip[创建技能]
推荐积极探索应用创作过程中的一些重复性任务场景,总结并创建技能,借助技能提高构建应用的准确性与效率。
:::
## 创建技能
要创建技能,请按照以下操作步骤:
- 进入工作台页面,导航到**技能页面**
- 点击右上角**创建技能**按钮,进入编辑页面
- 更新 SKILL.md 文件的名称与描述信息,完善文档内容
- 设置**技能权限**,选择是否公开给其他人使用
- 点击右上角**创建按钮**,进入审核状态
- **审核通过**后,技能将可以被正常使用
:::note[上传压缩包]
如果你是专业用户,或者你准备创建的技能拥有大量引用的文档,你可以在本地编辑好后通过编辑器左上角上传按钮,一次性将所有文件上传到编辑器中,支持 ZIP 压缩包上传。
:::
## 使用技能
目前,使用技能是用户的主动行为,由创作者判断任务场景,并主动激活特定技能。
在应用创作过程中,如果遇到特定任务场景,你可以通过点击对话框左下角的**扩展按钮**,在弹窗中选择技能标签页下的任何一个技能,告诉 WeaveFox 按照技能文档的流程完成该任务。
你可以通过搜索关键字来找到匹配任务场景的技能,默认只展示公开的技能列表,点击搜索框右侧『我的』按钮切换为你个人创建的所有技能列表(包含公开与私有)。
:::warning[自动激活技能]
未来,WeaveFox 将会根据任务场景,主动搜索可用的技能并激活使用。但在创作过程中,你主动选择激活特定技能仍然是推荐且最优的选择。
:::
## 剖析技能
每个技能包含三个**必备**部分:
- **名称**:一个简短的标识符。
- **描述**:用一句话告诉 WeaveFox 解决了什么问题,何时应该使用此技能。
- **指令**:技能正文部分,以 Markdown 格式编写,具体描述该技能解决问题、完成任务的工作流程。
一个好的实践经验是,把 WeaveFox 当作第一次执行该任务的新队友,写下你会给的一些指示:做什么、避免什么、需要注意的极端情况以及你期望的反馈格式。
`SKILL.md` 文件是必须的,另外技能还可以包含引用文件,你可以将一个复杂任务场景的工作流程拆分的更细,或者应对不同情况时编写不同的工作流程文档。
一份清晰的技能描述是技能最重要的部分。如果描述含糊不清,WeaveFox 可能不会按预期使用该技能,或者将其加载到不相关的任务中。好的描述会明确定义技能的适用场景和不适用场景。清晰的界限有助于 WeaveFox 始终如一地加载正确的技能,避免将其误用到无关的任务中。
### 好与坏技能描述对比
WeaveFox 会根据技能描述来决定何时加载技能。描述模糊和描述精确之间的差别会对技能运行的可靠性产生重大影响。
**太模糊**
```
description: 对 SEO 优化有帮助。
```
这段描述并没有清楚地告诉 WeaveFox 何时使用该技能、它适用于哪种 SEO 任务,或者它实际应该做什么。
**具体且有范围**
```
description: 用于审核现有页面的 SEO 健康状况:检查元数据、标题结构和内部链接。不适用于从头开始编写新的 SEO 文案。
```
这份描述提到了:
- 触发器(审计现有页面)
- 范围(元数据、标题、内部链接)
- 以及边界(不用于撰写新文案)
描述得当,可以使技能加载更加一致,并减少相似技能之间的冲突。
## 示例技能
要参考好的案例,请直接查看[扩展页面](https://www.weavefox.cn/extensions)中官方推荐精选的技能。
## 常见问题
- **技能必须要审核后才能使用吗?**
必须。考虑到内容安全风险,技能的创建与编辑都需要审核流程,且审核通过后才可用。不过,你不必担心,只要内容合规,审核通常很快(几分钟)。
---
## 版本管理
WeaveFox 会为应用创作过程中的每一次对话后涉及到应用文件变更的生成一个版本快照。你可以查看历史版本、预览任意版本的效果,以及回滚到之前的版本。
## 版本是如何产生的
在应用创作过程中,每次 WeaveFox 助手回复并生成应用内容时,系统会自动创建一个新版本。版本按创建顺序依次编号(v1、v2、v3……),每个版本对应一次完整的对话产出。如果你只是简单的询问问题,没有涉及到应用的代码文件变更,则不会产生新的版本。
## 查看历史版本
点击应用聊天创作页面右上角的 **「历史版本」** 按钮,即可打开版本面板,查看当前应用的所有版本记录。
版本面板中每个版本条目包含:
- **版本缩略图**:该版本应用的预览截图
- **版本名称**:如 v1、v2 等
- **创建时间**:该版本的生成时间
- **已发布标记**:如果该版本是当前已发布的版本,会显示「已发布版本」标记
此外,在对话消息中,每条助手消息下方也会显示 **「版本 N」** 标记,作为快捷方式点击即可快速跳转并查看对应版本。
## 回滚版本
当你对当前版本不满意,想回到之前的某个版本时,可以使用回滚功能。
在历史版本面板或对话助理消息下方的版本标记旁,点击 **回滚按钮** ,确认后即可回滚到该版本。
:::warning[回滚不可逆]
回滚操作会删除目标版本之后的所有版本及其对应的对话记录,此操作不可撤销,请谨慎使用。
:::
## 发布与版本
发布应用时,系统会基于当前选中的版本生成快照并部署。已发布的版本不受后续修改影响——在你发布新版本之前,线上应用始终展示的是已发布版本的内容。
**另外,已发布的版本回滚后也不会影响线上应用,只是你再也无法找到已发布的版本记录。**
更多发布相关内容,请查看[发布应用](/features/deploy-host/publish-app)。
---
## 应用创作
通过**自然语言对话**的方式,将你的想法与灵感,快速构建为真实的产品应用。
你需要关注的是如何准确描述出你的想法,例如:
- 更具体的提示词
- 多段文本描述
- 参考图
- 参考文档
- ...
WeaveFox 会理解你提供的所有提示信息,总结并生成计划,最终构建一个 Web 应用。
接下来:
- 了解[技能](./skills),使用外部知识库为 WeaveFox 提供实现特定功能的最佳实践
- 了解[规划模式](./plan-mode),在复杂场景下让 WeaveFox 拆解任务,逐步完成
- 了解[版本管理](./version-management),查看历史版本、预览与回滚应用版本
:::tip[最佳实践]
了解更多创作方式,请查看[最佳实践](/best-practices/overview)。
:::
---
## 应用协作
邀请其他用户参与应用创作,分配权限,实时观察你们共同构建的变动。
WeaveFox 让你们一起构建应用,邀请你的产品经理、设计师、运营、开发者或其他任何人,每个人都能实时看到变化发生。
协作者有两种权限:
- **只读**:可以查看应用的聊天记录、源代码、版本记录、应用配置等数据数据。
- **读写**:除过只读的所有权限,还可以参与到对话创作中,编辑应用配置信息等等。
:::note[协作者]
拥有**读写**权限的协作者可以发布应用,协作者不能删除应用。
:::
## 如何添加协作者
要添加应用协作者,你需要按照以下步骤操作:
1. 打开应用的聊天页面,点击右上角的**添加协作者按钮**。
2. 调整**协作权限**,默认为只读
3. 点击**复制邀请链接按钮**,发送给被邀请的用户
4. 受邀请的用户点击链接地址打开页面,并点击**同意**加入协作
:::warning[注意]
邀请链接有过期时间,过期后链接将会失效,可以重新点击复制邀请链接按钮生成新的链接。
:::
## 管理协作者
你可以在应用的聊天页面,点击右上角添加协作者按钮,查看参与协作的用户列表,并**调整指定用户的协作权限,包括移除协作权限**。
---
## 自定义域名
为了让你的应用更具个性化和专业性,WeaveFox 支持为每个应用配置**自定义域名**。
默认生成的应用标识不具备较强的可读性,推荐为你的应用配置能体现其特点的自定义域名,这可以提升你的应用的:
- **品牌形象**:看起来更值得信赖和专业
- **搜索引擎友好**:更好的 SEO 和可发现性
- **易记性**:用户更易分享和记忆
## 如何配置自定义域名
要为你的应用配置自定义域名,可以通过以下几种方式:
- 在应用设置页面,找到**个性化域名**选项进行编辑配置。
- 在应用聊天页面,点击右上角**发布按钮**后出现的弹层中进行编辑。
:::warning[注意]
自定义域名通常不会有特殊的限制,但需要**具备唯一性**,因为这是访问应用的 URL 链接中的唯一标识。
:::
---
## 发布你的应用
将应用部署到一个可实时访问的 URL 网址,控制谁可以访问已发布的应用,并随时更新版本。
发布通过将你的 WeaveFox 应用的**特定版本快照**部署到你可以分享的一个 URL 网址,将其变为一个可实时访问的 Web 应用。一次只部署一个版本,你可以根据需要控制应用的访问权限。
:::tip[预览与发布]
WeaveFox 使用两种模式控制应用的访问:
- **预览模式**:这是你在应用对话创作过程中进行应用预览的模式,包括源代码、聊天记录、版本历史以及任何其它有关应用的数据信息,你可以通过邀请协作者参与到应用创作。
- **应用发布**:这是你构建好的应用通过发布上线来分享给你的用户的方式,通过权限限制可以访问你的应用的用户。
这两种模式的访问权限是相互独立的。
:::
## 谁可以发布应用?
默认情况下,只有应用的**创建者**具备删除应用的权限。拥有**读写**权限的协作者也可以发布应用。
:::note[协作者]
拥有**读写**权限的协作者可以发布应用,协作者不能删除应用。
:::
## 应用的访问权限
你可以根据需要调整发布的应用的访问权限,目前支持以下几种模式:
- **私有**:仅应用的创建者可以访问
- **公开**:所有的用户都可以访问
:::warning[指定用户访问]
指定用户访问的权限控制正在开发中...
:::
## 如何发布你的应用
发布应用,请按照以下操作步骤:
1. 进入应用的聊天页面,点击右上角的**发布按钮**,将会展示应用的 URL 地址,权限情况,以及正在发布的版本。
2. 为你的应用设置**个性化域名**。
3. 配置网站**访问权限**。
4. 审查**安全问题**,确认以上配置正确,并且应用已经准备好,数据库权限符合预期,没有泄露服务密钥等敏感信息。
5. **发布**你的应用。
发布后,你可以随时更新并重新发布你的应用,更改域名地址(发布 URL),打造优秀的产品用户体验。
## WeaveFox 中的发布流程
每次发布时,WeaveFox 都会将你的应用快照部署到一个实时网址,且只部署当前指定版本,未来的更改不会自动发布。
- 聊天页面编辑后的应用版本不会自动发布。
- 要部署更改,请重新点击**发布按钮**。
如果你在网站上没有看到最近的更改,你应该需要重新发布。
## 如何撤销发布的应用
目前,已发布的应用不支持撤销发布,但你可以将其立即**设置为私有权限**,其他用户将不能再访问你的应用,即便他们知道你的应用 URL 地址。
## 常见问题
- **发布会泄露我的应用的源代码吗?**
不会。发布只会让应用在已发布的 URL 上可访问,它不会让任何人访问你的应用聊天页面或项目代码。
- **未发布的应用可以被访问吗?**
不会。从未发布过的应用,任何人通过 URL 访问都会返回 404 页面,提示应用不存在。
- **已发布的应用被删除了还能被访问吗?**
不会。通过 URL 只能访问已经发布且未被删除的应用,其它情况都会返回 404 页面,提示应用不存在。
---
## 应用安全
通过内置安全扫描、API 密钥保护、数据库访问检查等来保护你的应用程序。
WeaveFox 能够帮助用户在开发和发布过程中降低常见的应用程序安全风险。它主要通过两种方式实现这一目标:一是预先预防常见的安全错误,二是利用自动化 AI 分析识别潜在漏洞。
WeaveFox 内置了**应用安全扫描**检测能力,这用于支持安全的应用程序开发,但不能替代全面的安全审查。
:::warning
这些工具可以帮助识别常见的安全问题,但无法保证绝对安全。你有责任确保你的应用符合其使用场景的安全要求,尤其是在处理敏感数据或执行关键功能的情况下。
:::
## 安全扫描何时运行
WeaveFox 会在你工作流程的不同阶段运行安全扫描,以帮助你及早发现问题。
每次扫描仅在与你的项目相关且自上次运行以来发生更改时才会运行。例如,数据库检查仅针对已连接数据库的应用运行。
### 发布前的自动扫描
[发布应用](publish-app.mdx)时,WeaveFox 会自动运行**安全扫描**,包括行级安全(RLS)策略检查和数据库模式审查。如果扫描发现严重问题,发布弹窗会显示完整的扫描结果,然后再继续操作。
在正式发布应用之前,请务必解决所有关键问题。虽然可以带着未解决的关键问题发布,但强烈建议不要这样做,尤其对于生产环境应用或处理敏感用户数据的应用而言。
### 主动发起安全扫描
在不发布应用的情况下,你也可以主动发起安全检测,进入应用的**云服务页面**,切换到**安全**标签页,点击**立即扫描**即可。
在代码发生重大更改后,或者当你希望所有扫描结果反映应用的当前最新状态时,主动扫描非常有用。
## WeaveFox 如何保障你的应用安全
以下内容将更详细地解释主要风险领域以及 WeaveFox 如何帮助你应对这些风险。
### 保护 API 密钥
WeaveFox 生成的前端代码在浏览器中运行,这意味着 API 密钥和其它敏感信息无法安全地存储在客户端代码中。泄露凭据可能导致数据泄露或未经授权的访问。
为了防止敏感凭证泄露,WeaveFox 会自动检测粘贴到聊天中的 API 密钥,并引导你将其安全地存储在云服务页面的**密钥**标签页中,而不是将其硬编码到你的代码中。
不要直接粘贴凭据,而是描述你想要构建的内容,WeaveFox 将帮助你使用服务器端功能和密钥存储来实现安全的设置。
例如:
```text
我想集成 OpenRouter 的 API 来生成文本内容。
```
WeaveFox 会引导你:
1. 在云服务页面的**密钥**标签页中安全地存储 OpenRouter 的 API 密钥
2. 创建云函数以在服务器端发起 API 调用
3. 在前端代码中调用云函数,而不是直接使用 API 密钥
这种方法可以确保凭证安全,并符合网络安全最佳实践。
### 使用行级安全(RLS)保护数据访问
行级安全(RLS)策略控制哪些用户可以访问或修改数据库中的数据。WeaveFox 默认开启所有数据表的 RLS 策略,确保用户只能查看和更改其有权访问的数据。
### 识别数据库安全风险
数据库模式和访问规则共同决定了数据的公开方式。即使单个规则看起来正确,不安全的模式设计和访问策略组合也可能引入安全风险。
安全扫描的数据库模式审查会同时检查你的数据表的访问权限和行级安全(RLS)配置,以识别可能导致未经授权访问或数据泄露的模式设计。
## 根据安全扫描结果采取行动
扫描发现安全问题后,你可以从应用的云服务页面的安全标签页中查看并解决这些问题。
### 了解风险并视情况修复
当检测状态为**有风险**且尚未确认时,发布流程会暂停在「安全校验」步骤。界面会列出每一项风险,包含:
- 风险标题
- 风险详细描述(受影响范围与可能后果)
- 修复建议
此时你有以下选择:
- **确认风险并继续发布**:点击「确认」表示已知晓风险,发布流程继续
- **取消发布**:中止当前发布,回退到第一步确认界面
:::warning
「确认」表示你已经了解这些安全风险,并自行承担数据被访问、篡改或泄露的可能后果。建议在确认前先依据修复建议解决安全风险漏洞,再重新发布。
:::
### 让 WeaveFox 审查你的应用的安全风险
除了自动安全扫描之外,你还可以随时通过对话请求 WeaveFox 进行应用的安全审查,就像普通聊天信息一样。
例如:
```text
检查我的应用程序的安全性
```
---
## 智能体接入
# 通过其它智能体工具使用 WeaveFox
WeaveFox 提供开放能力,支持 AI 智能体工具(如 Claude Code、Codex、Cursor 等)以标准化方式接入并管理你的应用——查询应用列表、更新应用信息、向应用智能体发送消息等。
- **前置准备**:创建一个 API Key 作为鉴权凭证
- **两种连接方式**:MCP Server 与 Agent Skill,任选其一即可接入
:::tip[两种连接方式]
无论使用 MCP Server 还是 Agent Skill,底层都调用同一组 WeaveFox 开放能力,区别仅在于接入形式与适用场景:
- **MCP Server**:AI 工具原生支持 MCP 协议时,在配置文件中声明即可接入
- **Agent Skill**:通过向 AI 工具安装技能插件来实现接入
:::
## 前置准备:创建 API Key
API Key 用于授权 AI 智能体工具访问 WeaveFox 开放能力,是两种连接方式共同的前置凭证:
1. 进入工作台,点击左侧导航的**智能体接入**入口
2. 在弹窗中切换到 **API Keys** 标签页
3. 点击右上角**创建 Key**,填写名称并选择有效期(7 天 / 30 天 / 90 天 / 365 天)
4. 创建成功后会**一次性**展示完整密钥(raw key),请立即复制保存——关闭后无法再次获取
5. 将该 Key 在 MCP 配置或 Skill 登录授权环节中使用
API Key 的调用频率上限为每分钟 20 次请求。后续可在 API Keys 页面对 Key 进行禁用、启用或删除操作。
## 方式一:MCP Server
MCP(Model Context Protocol)是一种开放协议,允许 AI 智能体工具以标准化方式连接到 WeaveFox 并直接管理你的应用。
:::note
配置前请先在 API Keys 页面创建一个 API Key。
:::
### 配置方式
将以下内容复制到你的 AI 工具的 MCP 配置文件中,并把 `` 替换为上一步获取的 API Key:
```json
{
"mcpServers": {
"WeaveFox MCP": {
"url": "https://www.weavefox.cn/mcp",
"transport": "sse",
"headers": {
"Authorization": "Bearer "
}
}
}
}
```
配置完成后,AI 工具会自动发现并调用 WeaveFox 提供的开放能力,无需额外安装步骤。更多 MCP 介绍可参考 [MCP 官方文档](https://modelcontextprotocol.io/)。
## 方式二:Agent Skill
Agent Skill 是一种可复用的能力封装,允许 AI 智能体工具基于 WeaveFox 提供的开放能力来管理你的应用。Skill 通过在 AI 工具中安装技能插件来接入,与 MCP Server 提供的能力完全一致。
### 安装技能
在支持的 AI 工具中运行以下命令安装 WeaveFox Skill:
```bash
npx skills add https://github.com/weavefox/weavefox-cli --skill weavefox
```
如果你的 AI 工具支持通过提示词安装技能,也可直接复制以下提示词让其自动完成安装:
```text
运行 `npx skills use "https://github.com/weavefox/weavefox-cli" --skill "weavefox"` 并立即按照生成的 Skill 说明执行。读取完整输出,必要时先将输出重定向到临时文件。从其提供的 supporting-files 目录解析相对路径。
```
### 登录授权
安装技能后,按以下步骤完成授权:
1. 在 **API Keys** 页面创建一个 API Key(参考前置准备)
2. 按技能提示执行登录命令:
```bash
wf login --key
```
3. 授权成功后即可在 AI 工具中调用 WeaveFox 开放能力
## 开放能力
无论选择 MCP Server 还是 Agent Skill,接入后可使用的开放能力一致:
| 能力 | 说明 |
| ---------------- | ---------------------------------------------------------- |
| 获取文档 | 获取 WeaveFox 面向 AI 智能体友好的文档 |
| 获取当前用户信息 | 查询当前 API Key 对应的用户资料 |
| 查看应用列表 | 分页查询你的应用,支持关键词搜索 |
| 更新应用信息 | 更新应用名称、描述、标签、封面图片、公开状态、个性化域名等 |
| 查询消息列表 | 分页查询应用消息列表,按时间倒序排列 |
| 发送消息 | 向应用的智能体发送消息,用于迭代应用功能 |
| 查询消息状态 | 获取应用智能体的消息状态和内容 |
| 停止消息生成 | 停止应用智能体正在运行的消息流 |
---
## 支付宝一键登录
WeaveFox 生成的 H5 应用可以快速接入支付宝生态,实现**支付宝一键登录**。根据你的需求,有两种方案可选:
| | 支付宝 H5 应用 | 支付宝小程序 |
| --- | --- | --- |
| **适用账号** | 个人 / 企业均可 | 仅企业账号 |
| **接入方式** | 独立 H5 页面 | WebView 嵌入小程序 |
| **登录能力** | ✅ 支付宝快捷登录 | ✅ 支付宝快捷登录 |
| **适用场景** | 独立传播、分享裂变 | 支付宝生态内分发 |
> 💡 如果你的应用**仅在支付宝内打开、不需要支付宝登录**,则无需配置以下任何内容。

_拾光地图 — 支付宝快捷登录效果示意_
---
## 方案一:支付宝 H5 应用
> 适合独立传播的 H5 页面,个人账号和企业账号均可使用。
### 第一步:注册支付宝 H5 应用
1. 登录 [支付宝开放平台](https://open.alipay.com/develop/manage)
2. 点击「创建网页/移动应用」

_点击「创建网页/移动应用」按钮_
3. 填写应用信息(网址 URL 可暂不填),点击立即创建

_填写应用名称、图标、简介等基本信息_
### 第二步:配置密钥
1. 进入应用设置页,点击「开发设置」→「接口加签方式」→「设置」

_进入应用详情 → 开发设置_
2. 加签方式选择「密钥」,点击下一步

_选择「密钥(普遍适用)」_
3. 下载密钥工具,生成 RSA2 密钥对,复制「应用公钥」

_使用密钥工具生成 RSA2 密钥对_
4. 将「应用公钥」粘贴到开放平台,点击确认上传

_粘贴应用公钥字符串_
5. 保存好密钥文件中的「应用私钥」(支付宝不会保存,丢失需重新生成)

_妥善保存应用私钥,丢失无法找回_
### 第三步:WeaveFox 生成应用
在 WeaveFox 中创建并发布你的 H5 应用,获得应用域名。
### 第四步:设置授权回调地址
1. 回到开放平台 → 开发设置 →「授权回调地址」→「设置」

_点击「授权回调地址」旁的「设置」_
2. 填写你的 WeaveFox 应用域名(回调地址类型选 HTTPS)

_填入 WeaveFox 发布后的应用域名_
### 第五步:WeaveFox 平台配置 Token
打开 [WeaveFox 支付宝登录配置页](https://www.weavefox.cn/vault/services/alipay-open-id),填写以下三项:
| 配置项 | 说明 | 获取位置 |
| --- | --- | --- |
| **App ID** | 应用唯一标识 | 开放平台 → 应用详情页 |
| **支付宝公钥** | 用于验签 | 开放平台 → 接口加签方式 → 查看 |
| **应用私钥** | 用于签名 | 密钥工具生成的私钥文件 |

_在 WeaveFox 平台填入三项配置即可完成接入_
---
## 方案二:支付宝小程序
> 通过 WebView 嵌入 WeaveFox H5 应用,实现小程序内调用支付宝能力。**仅企业账号可用。**
### 第一步:注册小程序应用
1. 登录 [支付宝开放平台](https://open.alipay.com/develop/manage)
2. 点击「创建小程序」

_选择「小程序」类型创建_
### 第二步:配置密钥
小程序配置密钥的步骤和 H5 应用**完全一致**,参考方案一中「第二步:配置密钥」。

_小程序同样需要在开发设置中配置接口加签方式_
### 第三步:配置域名白名单
:::warning[重要]
域名白名单仅企业支付宝账号才能配置,因此个人开发者无法使用小程序嵌入 H5。
:::
1. 进入小程序 → 开发设置 →「服务器域名白名单」→「添加」
2. 填入你的 WeaveFox 应用域名(如 `footprint.app.weavefox.cn`)

_将 WeaveFox 域名添加至服务器域名白名单_
其他配置(授权回调地址、Token)与方案一中的步骤一致,参考方案一第四步和第五步。
### 第四步:WeaveFox 平台配置 Token
与方案一第五步完全一致,在 [WeaveFox 支付宝登录配置页](https://www.weavefox.cn/vault/services/alipay-open-id) 填入 App ID、支付宝公钥和应用私钥即可。
---
## 配置完成 ✅
以上两种方案任选其一即可。配置完成后,你的 WeaveFox 应用就能在支付宝内实现一键登录,用户无需额外注册即可使用。
> 💡 **小结**:个人开发者选「方案一:支付宝 H5 应用」;企业开发者如有小程序分发需求,可用「方案二」将 H5 嵌入小程序。
---
## 支付宝电脑网站支付
支持支付宝电脑网站支付,适用于 PC 端网页支付场景。
## 使用场景
- **知识付费**:付费内容解锁、课程购买
- **电商交易**:商品在线支付
- **服务订购**:会员充值、服务购买
## 如何使用
在对话中说:应用集成支付宝支付功能
## 开通流程
支付宝电脑网站支付可通过「AI 付」官网一站式快捷开通,全程在线完成。
### 第1步:访问 AI 付开通页面
进入 [**https://aipay.alipay.com/open-flow/tech**](https://aipay.alipay.com/open-flow/tech),选择「AI 网页应用收款」产品,使用支付宝 App 扫码验证身份,即可进入一站式接入流程。整个流程包含五个步骤,按顺序完成即可。

### 第2步:技术集成
WeaveFox 已经集成了收款能力,这一步直接跳过。
> 提示:技术集成可以与产品开通并行进行,无需等待产品开通审核完成。如需自行开发,建议先使用沙箱环境完成集成和测试。
### 第3步:产品开通
在开通页面填写基础资料信息,确认开通「电脑网站支付」产品。资料信息可去账号中心维护管理。

开通后产品状态显示为「已开通」,生效后长期有效,支持快捷即时到账。
### 第4步:密钥配置
在密钥配置步骤中,下载密钥生成工具(支付宝开放平台开发助手),生成 RSA2(2048 位)应用公钥和应用私钥。

- **应用公钥**:粘贴到支付宝开放平台「填写公钥字符」处,用于支付宝校验你发起请求的真伪
- **应用私钥**:自己妥善保管,后续在 WeaveFox 支付配置中使用
- **支付宝公钥**:提交应用公钥后自动生成,用于验证支付宝返回结果的真实性

> **安全提醒**:应用私钥(你的专属印章)绝不能上传或分享给任何人,只需存在自己的服务器上。
### 第5步:线上验证
将代码中的沙箱配置替换为线上真实配置后,发起一笔真实交易验证支付全链路。WeaveFox 用户可以直接在支付宝服务页配置 AppID、支付宝公钥、应用私钥完成接入。
[https://www.weavefox.cn/vault/services/alipay-aipay](https://www.weavefox.cn/vault/services/alipay-aipay)
---
## 获取关键配置信息
审核通过后,在应用详情页获取以下信息,用于 WeaveFox 配置:
| 配置项 | 获取位置 | 用途 |
|--------|----------|------|
| **APPID** | 应用详情页顶部 | 应用唯一标识 |
| **支付宝公钥** | 接口加签方式设置页 | 验证支付宝回调签名 |
| **应用私钥** | 本地密钥工具生成 | 对支付请求进行签名 |
---
## WeaveFox 接入配置
### 配置支付密钥
1. 登录 WeaveFox 平台,进入「服务市场」→「支付服务」
2. 点击「配置支付宝支付」
3. 填写以下信息:
- **AppID**:从支付宝开放平台应用详情页获取
- **应用私钥**:使用密钥工具生成的私钥内容
- **支付宝公钥**:从支付宝开放平台「接口加签方式」页面获取
4. 点击「保存并验证」

### 创建带支付功能的应用
1. 在 WeaveFox 点击「创建应用」
2. 与 AI 对话描述需求,例如:
> 创建一个知识付费应用,用户可以浏览免费内容,付费内容需要支付宝支付后解锁。
3. WeaveFox 会自动生成:
- 支付页面 UI
- 订单创建逻辑
- 支付状态处理
### 支付流程说明
```
用户浏览应用 → 点击付费内容 → WeaveFox 创建订单
↓
调用支付宝接口
↓
用户扫码/登录支付 ← 展示支付二维码/页面 ← 返回支付链接
↓
支付完成 → 支付宝通知 WeaveFox → 自动解锁内容
```
### 关键配置参数
WeaveFox 已封装好支付接口,你只需关注业务参数:
| 参数 | 必填 | 说明 |
|------|------|------|
| `out_trade_no` | 是 | 商户订单号,WeaveFox 自动生成 |
| `total_amount` | 是 | 订单金额,根据你的定价设置 |
| `subject` | 是 | 订单标题,建议描述付费内容 |
| `product_code` | 是 | 固定值 `FAST_INSTANT_TRADE_PAY` |
### 订单管理
WeaveFox 提供内置的订单管理功能:
- **订单查询**:查看所有支付订单状态
- **退款处理**:支持对订单发起退款
- **对账功能**:导出交易记录进行财务核对
- **支付统计**:查看收入趋势和支付转化率
---
## 常见问题
### Q1:个人账号可以申请电脑网站支付吗?
**可以。** 个人支付宝账号通过商家平台即可签约电脑网站支付,无需营业执照。
### Q2:审核需要多久?
通常 1-3 个工作日。若资料齐全、应用合规,审核速度会更快。
### Q3:手续费是多少?
支付宝电脑网站支付标准费率为 0.6%,具体以支付宝官方公示为准。
### Q4:资金多久到账?
实时到账至绑定的支付宝账号余额。
### Q5:支付安全如何保障?
- 所有支付请求通过 HTTPS 加密传输
- 密钥配置在 WeaveFox 服务端,不在前端暴露
- 支付回调经过签名验证,确保来自支付宝
- 敏感信息(私钥)由 WeaveFox 安全存储
### Q7:电脑网站支付收款额度说明
**基础限额规则**
| 认证等级 | 单笔收款 | 单日收款 |
|---------|---------|---------|
| 未认证 | ≤ 50元 | ≤ 1000元 |
| 基础认证 | ≤ 2000元 | ≤ 20000元 |
**限额原因及解决方案**
若开通时提交的资质未通过审核,会触发上述基础限额。
### Q8:如何提升收款额度?
如需提升收款额度:
1. 登录支付宝商家平台
2. 进入产品中心找到已开通的电脑网站支付
3. 点击「提升额度」或「补全信息」
4. 按提示提交更多资质材料,如:
- 更详细的经营信息
- 网站备案信息(近期将支持使用WeaveFox 子域名实现 ICP 备案,用户无需申请独立域名备案)
- 业务场景说明
- 其他补充材料
提交后等待支付宝审核,审核通过后即可提升额度。
也可以直接访问 [收单产品额度限制](https://b.alipay.com/page/self-relieving-web/productQuota/list) 页面申请提额。
---
## 相关资源
- [支付宝商家平台](https://b.alipay.com/)
- [支付宝开放平台](https://open.alipay.com/)
- [电脑网站支付产品介绍](https://opendocs.alipay.com/support/01rau6)
- [密钥工具下载](https://opendocs.alipay.com/common/02np94)
- [电脑网站支付快速接入指南](https://opendocs.alipay.com/b/03ah5w?pathHash=4542d144)
---
如有疑问,可联系支付宝客服或在开放平台提交工单咨询。
---
## 地图服务
:::note[WeaveFox 云]
WeaveFox 平台云服务
:::
集成高德地图 LBS 开放平台提供丰富的位置服务能力。
## 功能特性
- **地理编码**:地址转换为经纬度坐标
- **逆地理编码**:经纬度坐标转换为地址
- **POI 搜索**:关键字搜索和周边搜索地点
- **路径规划**:驾车、步行、骑行、公交路线规划
- **行政区域**:省市区行政区划查询
- **天气查询**:城市实时天气和天气预报
- **输入提示**:地址输入自动补全
## 使用场景
- 附近商家/餐厅查找应用
- 导航路线规划应用
- 位置签到/打卡应用
- 天气查询应用
- 地址智能补全功能
## 如何使用
在对话中说:「帮我创建一个附近餐厅查找应用」或「创建一个天气查询应用」,系统会自动集成高德地图能力。
---
## AppBase
:::note[WeaveFox 云]
WeaveFox 平台云服务
:::
OceanBase 提供的后端服务,支持数据库存储、用户认证等能力。
## 功能特性
- **数据库**:提供关系型数据库存储服务
- **用户认证**:支持基于角色的权限管理认证服务
## 使用场景
- 数据持久化
- 登录鉴权
## 更多信息
前往 [OceanBase AppBase 官网](https://appbuild.oceanbase.com/) 了解更多信息。
---
## 音频识别
# 音频识别服务
:::note[WeaveFox 云]
WeaveFox 平台云服务
:::
基于多模态模型的音频理解能力,支持多种音频处理场景。
## 功能特性
- **语音转文字**:将音频内容转录为文字稿
- **音频理解推理**:分析音频内容并回答问题
- **情感识别**:识别语气、情感等副语言信息
- **语音对话理解**:理解对话内容和主题
## 使用场景
- 会议记录自动生成
- 采访内容整理
- 语音笔记数字化
- 播客内容摘要
- 情感分析与客服质检
## 如何使用
在对话中说:「帮我使用音频识别服务创建一个语言转文字应用」,系统会自动集成音频识别能力。
---
## 内容搜索
:::note[WeaveFox 云]
WeaveFox 平台云服务
:::
智能内容搜索服务,支持全文检索和语义搜索。
## 功能特性
- **全文检索**:高效的关键词搜索
- **语义搜索**:基于语义理解的相关性搜索
- **向量检索**:支持向量相似度搜索
- **混合检索**:关键词 + 语义混合搜索
## 使用场景
- 文档搜索
- 知识库检索
- 商品搜索
- 内容推荐
:::info
该服务即将支持,敬请期待。
:::
---
## 钉钉消息推送
:::note[WeaveFox 云]
WeaveFox 平台云服务
:::
通过钉钉机器人 webhook 发送消息到钉钉群,支持文本、Markdown、卡片等多种消息类型。
## 使用场景
- **运维告警**:系统异常时自动推送告警
- **任务通知**:任务完成、失败时发送状态通知
- **数据报表**:定时推送数据统计报表
## 如何使用
在对话中说:「帮我使用钉钉消息推送服务创建一个运维告警通知应用」,系统会自动集成钉钉推送能力。
---
## 邮件推送
:::note[WeaveFox 云]
WeaveFox 平台云服务
:::
为应用提供邮件发送能力,支持富文本格式邮件,适用于通知、验证码、报告等场景。
## 功能特性
- **富文本邮件**:支持包含样式和图片的邮件内容
- **状态追踪**:提供邮件发送状态反馈
## 使用场景
- 通知邮件
- 用户注册验证
- 密码重置
:::info
该服务即将支持,敬请期待。
:::
---
## 图像生成
# 图像生成与编辑服务
:::note[WeaveFox 云]
WeaveFox 平台云服务
:::
基于多模态模型的图像生成与编辑能力,支持文生图和图像编辑两种模式。
## 功能特性
- **文生图**:根据文本描述生成图片
- **图像编辑**:基于参考图片进行编辑
- **换背景**:更换图片背景,保持主体不变
- **换材质**:更换物体材质,保持形状和光影
- **角色一致性**:保持角色特征,改变场景或动作
## 支持的场景
- **快速图片生成**:快速产出大量图片,适合电商营销海报、商品主图、快速创意验证
- **高品质图片生成**:高保真人像与风景,精准捕捉微观纹理,适合复杂中文意境
- **换背景/换材质**:商品图场景替换,保持光影和特征不变
## 使用场景
- 电商海报与商品主图生成
- 艺术质感图像创作
- 图像编辑与修图
- 角色/IP 一致性创作
## 如何使用
在对话中说:「帮我使用图像生成服务创建一个电商海报生成应用」,系统会自动集成图像生成能力。
---
## LLM 服务
:::note[WeaveFox 云]
WeaveFox 平台云服务
:::
大语言模型(LLM)服务为您提供强大的 AI 文本生成和对话能力。
## 功能特性
- 一句话接入 LLM 服务,无需复杂配置
## 使用场景
- 智能对话机器人
- 文本生成与摘要
- 代码辅助生成
- 内容创作辅助
## 如何使用
在对话中说:「帮我使用 LLM 服务创建一个智能问答助手」,系统会自动集成 LLM 对话能力。
---
## OCR 识别
# OCR 识别服务
:::note[WeaveFox 云]
WeaveFox 平台云服务
:::
基于多模态模型的光学字符识别能力,支持多种文字识别场景。
## 功能特性
- **通用文字识别**:识别图片中的所有文字内容
- **表格识别**:提取表格内容并转换为 Markdown 格式
- **发票/票据识别**:结构化提取发票信息
- **证件识别**:识别身份证、银行卡等证件信息
- **文档解析**:长文档内容提取
- **手写文字识别**:识别手写体文字
- **数学公式识别**:将数学公式转换为 LaTeX 格式
- **GUI 元素识别**:识别界面元素和布局
## 使用场景
- 文档数字化与归档
- 发票报销自动化
- 表格数据提取
- 证件信息自动填写
- 手写笔记数字化
- 数学公式编辑辅助
## 如何使用
在对话中说:「帮我使用 OCR 识别服务创建动物识别应用」,系统会自动集成 OCR 识别能力。
---
## OSS 存储
:::note[WeaveFox 云]
WeaveFox 平台云服务
:::
支持图片、音视频及各类文件上传。
## 使用场景
- 应用图片存储与展示
- 静态资源托管
- 数据备份归档
- 多媒体内容分发
## 如何使用
在对话中说:「帮我使用 OSS 存储服务创建一个图片上传应用」,系统会自动集成 OSS 存储能力。
---
## Supabase
## 使用场景
- 全栈应用后端
- 实时协作应用
- 用户认证系统
- 文件管理服务
## 如何使用
### 前置条件
1. 拥有 Supabase 账号,如果没有请前往 [Supabase 官网](https://supabase.com/) 注册
2. 创建一个 Supabase 项目
### 连接 Supabase 项目
点击卡片上的「连接」按钮,通过 OAuth 授权连接您的 Supabase 项目:
1. 点击「连接」按钮
2. 在弹出窗口中登录 Supabase 账号
3. 选择要连接的项目
4. 授权完成后自动返回
### 使用案例
#### 1. Todo List 应用
在对话中说:「帮我创建一个 Todo List 应用,使用 Supabase 数据库存储任务数据」
- 自动创建 `todos` 表结构
- 实现任务的增删改查功能
- 支持任务状态标记和排序
#### 2. 用户认证系统
在对话中说:「创建一个带用户登录注册的页面,使用 Supabase 认证」
- 集成 Supabase Auth 服务
- 支持邮箱/密码登录
- 支持第三方 OAuth 登录(Google、GitHub 等)
#### 3. 实时聊天应用
在对话中说:「创建一个实时聊天室,使用 Supabase 实时订阅功能」
- 利用 Supabase Realtime 实现消息实时同步
- 支持多用户在线聊天
- 消息持久化存储
#### 4. 文件管理服务
在对话中说:「创建一个文件上传管理页面,使用 Supabase Storage」
- 集成 Supabase Storage 存储服务
- 支持图片、文档等文件上传
- 自动生成文件访问 URL
---
## 用户行为埋点
:::note[WeaveFox 云]
WeaveFox 平台云服务。
:::
为 Vibe Coding 生成的应用提供用户行为埋点能力,采集自定义事件,并在分析页面呈现和分析用户行为数据。
所有 WeaveFox 生成的应用自动具备埋点能力,无需手动开启或配置。默认采集以下用户行为信息:
| 指标 | 说明 |
| ---------------- | --------------------------- |
| PV(页面浏览量) | 页面被访问的总次数 |
| UV(独立访客数) | 访问页面的独立用户数 |
| 操作系统 | 用户使用的操作系统分布 |
| 设备类型 | 桌面端、移动端、平板等分布 |
| 浏览器 | Chrome、Safari、Edge 等分布 |
| 语言 | 用户浏览器语言分布 |
| 来源域名 | 用户从哪个网站跳转而来 |
## 自定义事件采集
除了默认数据,你还可以采集特定的业务事件,如按钮点击、表单提交、订单完成等。
### 如何使用
在应用创作页面,点击对话框左下角**扩展**按钮,在服务列表中选择**用户行为埋点**服务。然后,直接在对话中告诉 WeaveFox:
> 帮我的应用添加用户行为埋点,采集注册按钮点击和下单成功的事件
WeaveFox 会自动在代码中集成埋点逻辑。
## 查看自定义事件
启用自定义事件采集后,采集到的事件数据会展示在分析页面的**自定义事件**区域,你可以查看每个事件的触发次数和占比。
---
## WeaveFox 集成服务
将 WeaveFox 连接到外部工具和外部服务 APIs。
**WeaveFox 的集成服务**功能可让你将应用程序连接到外部工具、APIs ,使用真实数据作为上下文并安全地集成第三方服务以实现功能。
:::tip[应用服务]
使用 WeaveFox,可以为你的应用集成:
- 数据库
- 用户认证
- 文件存储
- AI 服务(多模态识别与生成)
- 消息推送
- ...
:::
## 应用服务
应用服务是扩展 WeaveFox 生成应用的功能的最简单方法。它们就像插件一样,你的应用可以在需要执行操作或获取数据时随时调用它们。
当你**发布的应用需要与外部服务交互**以获得运行能力时,应用服务是理想之选。
### 主要特点
应用服务在用户级别进行授权管理,可在应用之间提供可重用的程序功能。
- 在工作台的**服务页面**进行管理
- 只需配置一次
- 提供你的应用在使用过程中可以调用的功能
### 授权管理
WeaveFox 平台提供了一些内置云服务,这些默认启用且无需授权。
另外,WeaveFox 也接入了部分三方服务,这些需要进行授权配置后才可以启用。请按照以下操作步骤:
1. 进入工作台的**服务页面**
2. 找到你需要的**服务**卡片
3. 点击服务卡片进入详情页,查看信息,并根据说明进行**授权配置**
4. **授权配置成功**后服务将在你的应用中可用
### 使用服务
如果要为你的应用添加服务以实现特定功能,请在输入提示时,点击对话框左下角的**扩展按钮**,选择你要接入的服务,WeaveFox 会根据你的要求在实现应用功能时集成该服务能力。
### 查看服务状态
你可以在应用的**云服务页面**查看哪些服务已经启用,及其服务的具体状态信息。例如:
- 数据库实例的信息(有哪些表、表权限、表数据)
- 用户信息(当前应用的注册用户列表)
- AI 服务使用量
- ...
### 现有服务列表
#### 数据库
- [AppBase](/integrations/apps/appwrite) - BaaS 平台,提供数据库、认证、存储、实时订阅等
- [Supabase](/integrations/apps/supabase) - 开源 Firebase 替代方案,提供 PostgreSQL 数据库、认证、存储等
#### 存储
- [OSS 存储](/integrations/apps/oss) - 阿里云对象存储服务,用于文件存储和 CDN 分发
#### AI 服务
- [LLM 服务](/integrations/apps/llm) - 大语言模型服务,支持多种模型接入
- [图像生成与编辑服务](/integrations/apps/image) - AI 图像生成和编辑能力
- [音频识别服务](/integrations/apps/audio) - 语音转文字、音频处理能力
- [OCR 识别服务](/integrations/apps/ocr) - 文字识别、文档扫描能力
#### 搜索服务
- [内容搜索](/integrations/apps/content-search) - 语义搜索、内容检索能力
#### 消息推送
- [钉钉消息推送](/integrations/apps/dingtalk) - 钉钉群机器人消息推送
- [邮件推送](/integrations/apps/email) - 邮件发送服务
#### 地图
- [地图服务](/integrations/apps/amap) - 高德地图服务,支持定位、导航等功能
#### 数据分析
- [用户行为埋点](/integrations/apps/tracking) - 轻量级 Web 埋点 SDK,采集自定义事件数据(默认启用)
#### 登录认证
- [支付宝 OpenID 服务](/integrations/apps/alipay-open-id) - 支付宝快捷登录能力
#### 支付服务
- [支付宝电脑网站支付](/integrations/apps/alipay-payment) - 支付宝 PC 端网页支付能力
---
## 最佳实践概览
掌握正确的方法,能让创作事半功倍。本章节汇总了 WeaveFox 使用过程中的实用技巧与经验总结,帮助你避开常见陷阱,更高效地完成从构思到发布的完整流程。
## 最近实践
- **[VibeCoding 地图,可以如此简单](./vibecoding-maps)** — 五个真实 Demo 展示如何用自然语言构建地图应用,从行政区划下钻到台风监测大屏,附可复制提示词。
- **[VibeCoding AI 应用,一键拥有智能能力](./vibecoding-ai)** — 介绍平台 AI 服务体系,推荐 5 类典型 AI 应用场景(对话助手、图像创作、文档处理、语音助手、数据分析),附可复制提示词。
## 如何实现应用的创作和发布
只需 2 分钟,即可快速上手 WeaveFox 平台,让任何人都能通过 Vibe Coding 轻松创作应用。观看以下视频,了解从构思到发布的完整流程。
---
## VibeCoding AI 应用,一键拥有智能能力
在 WeaveFox 平台上,接入大模型就像打开一个开关一样简单。**4 项官方 AI 服务默认启用、零配置**,8 家第三方大模型平台也已完成接入——只需自行配置 API Key,即可用自然语言描述需求,AI 帮你把智能能力嵌入应用。
以下推荐几类典型的 AI 应用场景,每类都附上了可复制的提示词,照着说就能生成同款。
---
## 一、智能对话助手
> 💬 **这样跟 WeaveFox 说:**
>
> 帮我做一个智能客服机器人页面,接入 LLM 服务。用户可以输入问题,AI 实时回复。界面干净专业,左侧放常用问题快捷入口,支持对话历史记录。整体风格简洁现代。
---
## 二、AI 图像创作工具
✅ 接入图像生成服务,支持文生图、换背景、角色一致性创作
> 💬 **这样跟 WeaveFox 说:**
> 帮我做一个 AI 图像生成工具。用户可以输入文字描述,选择风格(写实/插画/二次元/水墨),AI 生成对应图片。支持图片编辑功能:换背景、换材质。界面用卡片式布局,生成历史以瀑布流展示。风格现代艺术感。
---
## 三、智能文档处理
✅ 接入 OCR 识别服务,支持图片文字识别、表格提取、发票识别
> 💬 **这样跟 WeaveFox 说:**
> 帮我做一个智能文档处理工具。支持上传图片或 PDF,自动识别其中的文字、表格和发票信息。识别结果可以编辑和导出。界面简洁专业,上传区域支持拖拽,识别结果分区域展示。
---
## 四、语音助手
✅ 接入音频识别服务,支持语音转文字、情感识别
> 💬 **这样跟 WeaveFox 说:**
> 帮我做一个语音笔记应用。支持录音并自动转为文字,可以识别说话人情绪。转写结果支持编辑、标签分类和搜索。界面温暖活泼,移动端优先设计。
---
## 五、AI 数据分析报告
✅ 接入 LLM 服务,智能分析数据并生成报告
> 💬 **这样跟 WeaveFox 说:**
> 帮我做一个数据分析报告生成工具。用户可以上传数据表格,AI 自动分析数据趋势,生成图文并茂的分析报告。支持导出 PDF 和 Markdown。界面专业简洁,适合商业分析场景。
---
## 六、背后的 AI 服务体系
上面这些应用背后,是 WeaveFox 从**官方 AI 能力到第三方大模型接入**的完整服务体系。
### 🤖 官方 AI 服务 · 开箱即用
WeaveFox 平台内置 4 项官方 AI 服务,**默认启用、零配置**:
| 服务 | 核心能力 | 典型场景 |
| --- | --- | --- |
| **LLM 服务** | 文本生成、对话、推理 | 智能客服、文案生成、代码辅助 |
| **图像生成** | 文生图、图像编辑、换背景换材质、角色一致性 | AI 绘图、商品图制作、头像生成 |
| **OCR 识别** | 文字识别、表格提取、发票识别、证件识别 | 文档数字化、票据录入、证件审核 |
| **音频识别** | 语音转文字、音频理解、情感识别 | 语音笔记、会议记录、情感分析 |
`文本生成` `图像生成` `文字识别` `语音转文字` `零配置`
### 🔌 第三方大模型接入 · 按需选择
除了官方 LLM 服务,WeaveFox 还接入了 **8 家主流大模型平台**,覆盖 20+ 模型,满足不同场景需求:
| 服务 | 模型系列 | 特色 |
| --- | --- | --- |
| **Kimi (Moonshot)** | Kimi K3 | 超长上下文、深度推理 |
| **智谱 GLM** | GLM 系列 | 国产自研、多模态理解 |
| **文心一言** | ERNIE 系列 | 百度生态、多模态 |
| **小米 MiMo** | MiMo V2.5 | 深度推理、代码辅助 |
| **DeepSeek** | DeepSeek | 高性能推理、开源 |
| **百度千帆** | 多模型聚合 | ERNIE/DeepSeek/GLM/Kimi/MiniMax/Qwen 一站式 |
| **MiniMax** | MiniMax | 文本生成、代码辅助 |
| **百炼 (阿里云)** | DashScope | Qwen/DeepSeek/Kimi/GLM/MiniMax/MiMo 等平台聚合 |
`8 家大模型平台` `20+ 模型` `灵活切换` `需自行配置 API Key`
---
从智能对话到 AI 绘图,从文档识别到数据分析——**一个平台、两层 AI 能力、零行代码**,让你的应用轻松拥有 AI 智能。
打开 **[weavefox.cn](https://www.weavefox.cn)**,描述你的需求,几分钟后,你就能拥有自己的 AI 应用。
_Build with AI. Ship with confidence._
---
## VibeCoding 地图,可以如此简单
在 WeaveFox 平台上,你不需要写一行代码,不需要申请任何 Key。从行政区划下钻到台风实时监测,从打卡轨迹到卫星影像对比——只需用自然语言描述需求,AI 帮你把地图搭出来。
以下五个真实 Demo,每个都附上了可复制的提示词,照着说就能生成同款。
---
## 一、行政区划可视化
✅ 内置中国省、市、县三级行政区划围栏数据
✅ 支持地图下钻,实现省 → 市 → 县联动钻取
> 💬 **这样跟 WeaveFox 说:**
> 使用地理可视化组件 Skill,帮我做一个中国各省经济数据分布地图。用不同的颜色深浅来表示经济指标高低,蓝色系配色。点击省份可以下钻到市级数据,再点击可以到区县级。左侧放一个排名面板,显示各省的 GDP、增速和排名。

_📊 各省份经济分布图 — 蓝紫色系 · 省→市→县三级下钻_
---
## 二、台风数据可视化
一站式台风监测大屏,覆盖台风路径、降水分布、卫星云图、雷达回波、全球风场五种气象数据图层。
> 💬 **这样跟 WeaveFox 说:**
> 使用地理可视化组件 Skill,帮我做一个太平洋台风实时监测大屏。使用台风数据服务获取数据,用高德地图底图,中心定位在西太平洋。页面用全屏地图布局,顶部放台风名称、风速、气压和等级信息卡片。地图上叠加5个图层用 Tab 切换:台风路径、降水热力图、卫星云图、雷达回波、全球风场流速。右侧加时间轴控制器回放过去几天的数据。

_🌀 台风路径 — 实时追踪白海豚台风_

_🌧️ 降水分布 — 全国降水等级热力图_

_☁️ 卫星云图 — 云顶温度可视化_

_📡 雷达回波 — 全国反射率数据_

_💨 全球风场 — 流速动态展示_
---
## 三、打卡地图
✅ 上传照片,**自动读取 GPS 位置**,一键生成地图标注
✅ 支付宝内 H5 **一键登录**,无需额外注册
> 💬 **这样跟 WeaveFox 说:**
> 使用地理可视化组件 Skill,帮我做一个旅行打卡地图应用,移动端H5。用户可以上传旅行照片,系统自动读取照片的GPS位置信息并在地图上标注打卡点,支持单张和批量上传。有一个个人足迹页,显示去过多少城市、多少省份、覆盖了多少公里,用统计卡片展示。接入支付宝一键登录。配色用温暖活泼的风格。

_📍 打卡地图主页 — 聚合标记 + 最近打卡展示_

_📊 足迹详情 — 城市/省份/里程统计 + 勋章系统_

_📸 上传打卡 — 支持单张 / 批量,自动提取 GPS 信息_

_🗺️ 自动定位 — 读取 GPS,精准标注打卡地点_
---
## 四、卫星 / 无人机影像展示
支持无人机影像展示,支持**卷帘和双屏**对比模式,轻松对比不同时相的地表变化。
> 💬 **这样跟 WeaveFox 说:**
> 使用地理可视化组件 Skill,帮我做一个卫星影像展示工具。支持无人机影像展示,用户可以上传两张不同时期的卫星图或无人机航拍图在地图上查看。支持卷帘和双屏两种对比查看模式。界面简洁专业,适合遥感分析场景。

_🛰️ 无人机影像展示 — 卷帘 / 双屏对比模式_
---
## 五、地图绘制工具
✅ 支持点、线、面的交互式绘制与编辑
✅ 提供地理数据管理能力,绘制成果可导出复用
> 💬 **这样跟 WeaveFox 说:**
> 使用地理可视化组件 Skill,帮我做一个地图绘制工具。支持在地图上交互式绘制点、线、面,并可以对已绘制的图形进行编辑。提供地理数据管理功能,支持导入和导出 GeoJSON 数据。界面简洁,适合地理数据编辑和标注场景。

_✏️ 地图绘制工具 — 点线面交互绘制 + 地理数据管理_
---
## 六、背后的三层能力架构
上面五个 Demo 背后,是 WeaveFox 地图能力的三层体系——**从底层服务到上层应用规范**一整套完整方案。
### 🗺️ 地图服务层 · LBS 能力底座
集成高德地图服务(免费使用),提供**地理编码、POI 搜索、多模式路径规划、天气查询等 11 项核心 LBS 能力**。所有服务由 AI Agent 按需自动调用,开发者无需手动对接 API。
`地理编码` `POI搜索` `驾车/步行/骑行/公交` `实时天气` `行政区查询` `坐标转换` `IP定位`
### 🧩 地图可视化组件层 · 零配置 AI 出图
基于 AntV L7 的 **@antv/aimapui** 组件库,Schema 驱动、零配置免费使用。支持 **19 种图层**(6 基础 + 13 复合),覆盖点线面、热力、行政区划、卫星图等全场景。另提供 DrawControl 绘制控件、ImageCalibrationControl 图像配准、AnnotationControl 富媒体标注等专业工具。**支持 8 种地图引擎自由切换**,零 Token 即开即用:高德地图、天地图、百度地图、腾讯地图、Maplibre、Mapbox、Google 地图、独立 Map。
`19种图层` `Schema驱动` `对话即地图` `地理配准` `富媒体标注` `交互绘制`
### 📐 地图应用规范层 · 从能用到好用
采用「**通用规范 + 业务场景**」双层架构,覆盖布局、图层、主题、交互四大维度。针对**PC 端分析大屏**(多屏联动+全屏展示)、**移动端轻应用**(抽屉交互+手势操作)、**旅游导览**(POI聚合+路线推荐)三大场景提供专属方案。
`布局规范` `图层规范` `浅色/深色主题` `PC大屏` `移动端` `旅游导览`
---
## 相关应用
| 应用 | 地址 |
| --- | --- |
| 🗺️ WeaveFox 高德地图服务 | [amap-service.app.weavefox.cn](https://amap-service.app.weavefox.cn) |
| 🛰️ 卫星影像地图 | [wm6zgavu.app.weavefox.cn](https://wm6zgavu.app.weavefox.cn) |
| 🌀 台风地图 | [draubmsd.app.weavefox.cn](https://draubmsd.app.weavefox.cn) |
| 📍 打卡地图 | [footprint.app.weavefox.cn](https://footprint.app.weavefox.cn) |
| ✏️ 地图绘制工具 | [uewk9jxu.app.weavefox.cn](https://uewk9jxu.app.weavefox.cn) |
| 🧩 地图可视化组件 AiMapUI | [aimapui-site.vercel.app](https://aimapui-site.vercel.app) |
---
从行政区划下钻到台风大屏,从打卡地图到影像对比——**一个平台、三层能力、零行代码**,地图应用从未如此简单。
打开 **[weavefox.cn](https://www.weavefox.cn)**,描述你的需求,一杯咖啡的时间,你也能做出上面的效果。
_Build without code. Bring ideas to life._