快速开始
这页只做一件事：帮你创建第一个 MDAN 应用，并在几分钟内把它跑起来。
MDAN 现在官方支持 Node 和 Bun。
- 如果你想走更成熟、更常见的 host 基线，选 Node
- 如果你想直接用 Bun starter 和 Bun 工具链入口，选 Bun
- 两边变化的是 runtime 外壳，不是应用模型
当前 npm 版本：
[email protected]@mdanai/[email protected]
1. 创建并启动项目
Node starter：
npm create mdan@latest agent-app
cd agent-app
npm install
npm start
Bun starter：
bunx create-mdan agent-app
cd agent-app
bun install
bun start
如果你想显式指定运行时，也可以：
npm create mdan@latest agent-app -- --runtime bun
bunx create-mdan agent-app --runtime node
启动后默认打开 http://127.0.0.1:3000/。
如果你自己设置了 PORT 环境变量，再按你设置的端口打开。
如果你更习惯这个命令，也可以用：
npx create-mdan agent-app
2. 关键文件
app/index.md页面内容和交互定义都在这里app/server.ts页面组合、状态和 action handler 在这里app/client.ts浏览器侧运行时和默认 UI 挂载在这里index.mjs本地运行时 host 入口在这里
3. 常见修改入口
通常先改这两处就够了：
app/index.mdapp/server.ts
app/client.ts 一般可以先不动，等你想接自己的 UI 再改。
4. 查看更多示例
如果你正在查看 MDAN 仓库，也可以直接运行仓库里的 examples/starter/。
不过仓库里的这个示例目前仍然保留 Node host 外壳；发布出去的 starter 才会按 Node/Bun 两条线生成。
先在仓库根目录执行一次：
npm install
或者：
bun install
然后进入示例目录启动：
cd examples/starter
npm start
如果你只是想用 Bun 做依赖安装和构建，也可以：
bun install
bun run build