dyad-sh/dyad · 上手攻略

  • 仓库：dyad-sh/dyad
  • 链接：https://github.com/dyad-sh/dyad
  • 分类：AI · 应用构建工具
  • 作者：Tom
  • 更新：2026-07-13

这是什么

Dyad 是一个本地运行、开源免费的 AI 应用构建工具（v0 / Lovable / Replit / Bolt 的开源替代）。用户通过自然语言描述需求，Dyad 自动生成完整的全栈应用代码，全程在本地机器运行，不依赖云端平台，不锁死生态，代码完全属于你自己。

支持 macOS 和 Windows，下载即可使用，无需注册。

解决什么问题

  • 痛点 1：v0、Lovable、Bolt.new 等工具都是闭源云平台——你租他们的服务，代码/数据不一定完全属于你。
  • 痛点 2：很多 AI 编程工具需要把代码上传到云端，隐私敏感场景不敢用。
  • 痛点 3：想快速从零做出一个完整的 Web 应用，但不想学全部开发细节，也不想被平台绑定。

快速安装

下载安装

  1. 前往官网下载页面：https://dyad.sh/
  2. 选择对应平台（macOS / Windows）下载安装包
  3. 安装后打开 App，无需注册，直接使用

💡 Linux 用户可参考社区自托管指南（如 RamNode VPS 部署），使用 AppImage 运行。

配置 API Key

Dyad 本身免费，但调用 AI 需要你自己的 API Key。

  1. 打开 Dyad → Settings
  2. 选择 AI Provider（支持）： - OpenAI（GPT-4o 等） - Anthropic（Claude 系列） - Google Gemini - Ollama（本地模型，零 API 费用） - OpenRouter（聚合多模型）
  3. 填入对应 API Key，保存即可

🆓 如果用 Ollama（本地部署），完全免费——Ollama 支持 Llama 3.3、Qwen2.5、Mistral 等开源模型。

确认版本

当前稳定版为 v1.6.2，Beta 版为 v1.7.0-beta.1（含 MCP 插件管理、Agent 模式等新特性）。

核心用法

方式一：从零描述构建应用

# 在 Dyad 对话框中直接描述
帮我做一个番茄钟应用，带统计和历史记录

Dyad 会自动生成前端页面、后端逻辑，可直接预览，满意后一键导出代码。

方式二：导入现有项目

/import /path/to/your/project

Dyad 可以接管已有代码库，帮你添加功能、修复 bug、解释代码。

方式三：Agent 模式（Pro 功能）

Dyad Pro（$20/月）提供增强 Agent 模式，支持： - 克隆整站页面为代码 - 大型代码库的多文件编辑 - 高级代码语义搜索 - 更快的文件修改速度

导出与部署

  • 一键推送到 GitHub
  • 一键部署到 Vercel
  • 代码完全导出为本地文件，不依赖平台

MCP 插件（v1.6+）

Dyad 支持 MCP（Model Context Protocol）插件扩展，可在 Settings → Plugins 页面管理。

典型适用场景

  1. 快速原型：有了灵感立刻用自然语言做出可交互的 Web 应用原型，无需配置开发环境。
  2. 个人隐私项目：代码和数据都在本地，不想上传到任何云平台。
  3. Ollama 爱好者：本地跑开源模型，用 Dyad 作为前端 UI，体验零成本 AI 开发。
  4. 学习参考：Dyad 生成的全栈代码质量较高，可作为学习 React/Vue/Node 的参考范本。
  5. 小型工具交付：做内部工具、管理页面等，用 Dyad 做完直接导出给非技术同事使用。

坑与注意

  1. 本地模型效果有限：如果用 Ollama 本地模型，效果取决于模型本身的能力；复杂任务建议用 GPT-4o / Claude 等云端模型。
  2. Pro 付费功能：Agent 模式、网站克隆等高级功能是 Pro 版专属，$20/月，需要自己的 API Key 才能用免费版的核心功能。
  3. Electron 桌面应用：Dyad 是基于 Electron 的桌面应用，对系统资源有一定占用，大型项目生成时内存消耗明显（v1.7 已优化 OOM 问题）。
  4. 上下文窗口限制：免费版对 AI 上下文长度有限制，大型应用一次性生成可能受限于 token 上限。
  5. 国内网络：下载 AppImage 或访问 GitHub Release 可能需要网络环境支持。
  6. 代码质量参差：AI 生成代码质量依赖所选模型；Pro 版使用更强大的推理模型，代码质量更高。

与同类对比

Dyad v0 (Vercel) Bolt.new (StackBlitz) Lovable
运行平台 本地桌面 云端 云端 云端
开源 ✅ Apache 2.0（部分） ❌ 闭源 ❌ 闭源 ❌ 闭源
隐私 ✅ 完全本地 ⚠️ 代码上传云端 ⚠️ 云端运行 ⚠️ 云端运行
API 费用 自带 Key，费用自控 平台代付 平台代付 平台代付
代码所有权 ✅ 完全属于你 ⚠️ 平台条款约束 ⚠️ 平台条款约束 ⚠️ 平台条款约束
价格 免费（基础功能） ~$5/月起 免费+付费 付费订阅

结论：Dyad 是目前唯一将「开源 + 本地 + AI 编程」三者结合得最好的工具，特别适合隐私敏感或不愿被平台绑定的开发者。

一句话推荐结论

如果你讨厌被云平台绑定，想要一个完全本地、代码归自己、可以绑自己 API Key 的 AI 编程工具，Dyad 是目前最成熟的免费开源选择——它相当于 v0/Lovable 的本地版，配上 Ollama 真正零成本。