# dyad

**Repository Path**: itwangji/dyad

## Basic Information

- **Project Name**: dyad
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Dyad

Dyad is a local, open-source AI app builder. It's fast, private, and fully under your control — like Lovable, v0, or Bolt, but running right on your machine.

[![Image](https://github.com/user-attachments/assets/f6c83dfc-6ffd-4d32-93dd-4b9c46d17790)](https://dyad.sh/)

More info at: [https://dyad.sh/](https://dyad.sh/)

## 🚀 Features

- ⚡️ **Local**: Fast, private and no lock-in.
- 🛠 **Bring your own keys**: Use your own AI API keys — no vendor lock-in.
- 🖥️ **Cross-platform**: Easy to run on **Windows + macOS**.

> **平台支持（Platform Support）：** Dyad 官方发行版仅支持 **Windows + macOS**。v2.0 起 Dyad 不再产出 Linux 二进制（Deb / Rpm / AppImage 均不再发布）；Linux 用户可从源码运行（前提：系统 keyring / libsecret 已配置，否则 SAP ADT 连接密码写入会拒绝 —— 详见 Phase 7 决策 D-01）。跨里程碑影响：v1.0 SAP UI5/CAP 的 Linux 用户同受此变更影响。

## 🌐 SAP UI5/Fiori 分支（社区扩展）

Dyad 提供一个 **社区分支** 支持通过自然语言对话生成可一键部署到 SAP BTP Cloud Foundry 的 SAP UI5/Fiori + CAP 端到端业务应用。首个验收场景是**采购申请审批 App**。

> **社区分支声明：** 本分支功能与 SAP SE 无附属关系；"SAP"、"Fiori"、"UI5"、"HANA" 等为 SAP SE 商标。

**范围与限制：**
- ✅ SAP UI5 TypeScript + SAP CAP TypeScript + Fiori Elements + BTP Cloud Foundry
- ❌ 不支持 SAP BTP Kyma / SAP GUI —— ABAP AS 7.5+ 由下方新分支实验性支持
- ❌ 仅 TypeScript（不提供 JS 版模板）

**如何使用：**
1. 在 Dyad 模板选择器里选 **SAP UI5/Fiori (CAP) Template**。
2. Dyad 会 clone [`dyad-sh/dyad-sap-ui5-template`](https://github.com/dyad-sh/dyad-sap-ui5-template) 到本地工作目录。
3. 与 AI 对话生成/修改 UI5 页面、CDS 实体、CAP handler；参考 [`src/prompts/guides/sap-ui5.md`](./src/prompts/guides/sap-ui5.md) 了解 Dyad 使用的元规范。
4. 部署到 BTP CF：`mbt build && cf deploy mta_archives/*.mtar`（详见模板 repo `docs/DEPLOY.md`）。

**Demo 视频（≤ 5 分钟）：** 待录制并 upload —— 占位 [GitHub Release v1.0.0](https://github.com/dyad-sh/dyad-sap-ui5-template/releases/tag/v1.0.0)。

**贡献路由：**
- 模板本身 / UI5 & CAP 代码 相关 issue → 提到 [模板 repo](https://github.com/dyad-sh/dyad-sap-ui5-template)
- Dyad 框架侧（框架检测、prompt 系统、e2e 等）issue → 提到本主仓
- 详见 [CONTRIBUTING.md](./CONTRIBUTING.md) 的 SAP 段落

## 🧩 SAP S/4HANA on-premise 分支（ABAP，实验性）

> **⚠ Experimental（v2.0 首发）：** 本分支通过 MCP server + ADT REST 协议支持 SAP S/4HANA on-premise（ABAP AS 7.5+）的 Explain / Develop / Deploy 三闭环。社区反馈周期后 v2.x 移除 experimental flag。

Dyad v2.0 起提供一个 **社区分支** 支持通过自然语言对话理解与生成部署到 SAP S/4HANA on-premise 系统的 ABAP 对象（Class / Function / Program / CDS View / DDIC / RAP BDEF）。

> **社区分支声明：** 本分支功能与 SAP SE 无附属关系；"SAP"、"ABAP"、"HANA"、"S/4HANA" 等为 SAP SE 商标。

**范围与限制：**
- ✅ 支持 ABAP AS 7.5+ / CDS View / DDIC（Table / Structure / Domain / Data Element） / RAP BDEF / Class / Function / Program
- ✅ 通过 ADT REST 协议访问 SAP 开发系统（不依赖 SAP GUI）
- ❌ 不支持 SAP GUI 集成 / BTP Steampunk（ABAP Cloud） / NetWeaver < 7.5 / abapGit 部署路径（走 ADT REST 提交 TR）
- ❌ 不支持 ATC / 单元测试自动运行（v2.x 规划）

**如何使用：**
1. 在 Dyad 模板选择器里选 **ABAP (SAP S/4HANA on-premise) Template**。
2. Dyad 会 clone [`dyad-sh/dyad-abap-adt-template`](https://github.com/dyad-sh/dyad-abap-adt-template) 到本地工作目录。
3. 打开 **Settings → SAP ADT Connections**，配置 ADT 连接（host / user / client / language）。密码通过 Electron `safeStorage` 加密存入 OS keyring —— 详见 [`docs/abap/setup.md`](./docs/abap/setup.md)（Plan 13-04 交付）。
4. 与 AI 对话 Explain 现有 ABAP 对象、Develop 新对象，或 Deploy 到 SAP 开发系统（走 Transport Request）。

**技术底座：**
- 精确钉版 [`sap-adt-mcp@0.8.50`](https://www.npmjs.com/package/sap-adt-mcp)（MIT License）+ [`abap-adt-api@8.4.1`](https://www.npmjs.com/package/abap-adt-api)
- 密码通过 Electron `safeStorage` API 加密（macOS Keychain / Windows DPAPI / Linux libsecret）
- MCP server 通过 stdio 子进程隔离拉起（`envOverride` 分支），不共享 Dyad 主进程内存空间
- SAP 系统侧要求：ICF 服务 `/sap/bc/adt/*` 已激活（详见 [`docs/abap/sicf-activation.md`](./docs/abap/sicf-activation.md)）

**贡献路由：**
- Dyad 框架侧（框架检测、IPC、MCP 集成、prompt guide、E2E）issue → 本主仓，label `area:abap`
- 模板骨架 / `AI_RULES.md` / `abap.config.json` 相关 issue → 提到 [模板 repo](https://github.com/dyad-sh/dyad-abap-adt-template)
- 详见 [CONTRIBUTING.md](./CONTRIBUTING.md) 的 ABAP 段落

**文档：**
- [`docs/abap/setup.md`](./docs/abap/setup.md) — ADT 连接配置指南（Plan 13-04 交付）
- [`docs/abap/known-limits.md`](./docs/abap/known-limits.md) — 已知限制与 workaround（Plan 13-04 交付）
- [`docs/abap/sicf-activation.md`](./docs/abap/sicf-activation.md) — SICF 服务激活指南（Phase 7 07-08 已交付）

## 🤖 Local Agent 与 Team 模式

Dyad 的对话支持多种聊天模式（Build / Ask / Plan / Team）。**Team 模式**可编排一支 AI 子 agent 团队（orchestrator 调度 planner / writer / test / explorer）协作完成较大任务。

- [`docs/local-agent.md`](./docs/local-agent.md) — 四模式对比 + team 工作流 + 各角色职责 + 可复现手动 walkthrough
- [`docs/team-configuration.md`](./docs/team-configuration.md) — Agent 团队配置页操作说明（编辑角色提示词 / 模型 / 工具 / 确认策略 / 恢复默认）

## 📦 Download

No sign-up required. Just download and go.

### [👉 Download for your platform](https://www.dyad.sh/#download)

## 🤝 Community

Join our growing community of AI app builders on **Reddit**: [r/dyadbuilders](https://www.reddit.com/r/dyadbuilders/) - share your projects and get help from the community!

## 🛠️ Contributing

**Dyad** is open-source (see License info below).

If you're interested in contributing to dyad, please read our [contributing](./CONTRIBUTING.md) doc.

## License

- All the code in this repo outside of `src/pro` is open-source and licensed under Apache 2.0 - see [LICENSE](./LICENSE).
- All the code in this repo within `src/pro` is fair-source and licensed under [Functional Source License 1.1 Apache 2.0](https://fsl.software/) - see [LICENSE](./src/pro/LICENSE).