# 搭台 · datai

> 给用户的网站一个域名(`xxx.webdatai.top`),并把访问反向代理到用户自己部署的地址。

**搭台不参与部署,也不碰用户的云凭据。** 站跑在用户自己的 Vercel / Cloudflare 上,
用用户自己的凭据部署 —— 由**你(AI)**执行。

---

## 快速开始

### 1. 接进你的 AI 客户端

**Claude Code**

```bash
claude mcp add datai -- npx -y datai-cli mcp
```

**Cursor / Claude Desktop / 其他 MCP 客户端** — 在配置里加:

```json
{
  "mcpServers": {
    "datai": {
      "command": "npx",
      "args": ["-y", "datai-cli", "mcp"]
    }
  }
}
```

> Windows 上如果报找不到命令,把 `command` 改成 `"cmd"`、
> `args` 改成 `["/c", "npx", "-y", "datai-cli", "mcp"]`。

接好之后你会看到**恰好三个**工具:`datai_reserve` / `datai_bind` / `datai_status`。

### 2. 登录

```bash
npx datai-cli login
```

会自动打开浏览器。让用户在页面上登录或注册(邮箱 + 密码)并确认即可。

**不要替用户设密码,也不要让他把密码告诉你。**

### 3. 上线一个站

```
datai_reserve  →  写验证文件  →  部署  →  自检  →  datai_bind
```

---

## 三份文档,按需读

| 文档 | 什么时候读 |
|---|---|
| **[llms-full.txt](/llms-full.txt)** | **主手册** —— 完整流程、全部错误码、API 参考、不要做的事 |
| **[llms-deploy.txt](/llms-deploy.txt)** | **要部署的时候** —— 怎么用用户自己的账号把站部署出去 |

**如果用户说「帮我上线一个网站」,两份都要读。**

---

## 五条最容易踩的

1. **先 `datai_reserve` 再部署** —— 拿到域名,才能把站点自己的绝对地址写对
2. **验证文件放 `public/.well-known/datai-verify`**,内容是 verify_token,纯文本一行
3. **`datai_bind` 的 target 只传主机名**,如 `my-shop.vercel.app`
4. **绑定成功后 30–60 秒**才能打开 —— 这不是失败,不要重试
5. **每条报错都带 `next_action`,照做就行** —— 不用自己推理

## 最常见的两个错误

| code | 意思 | 往哪查 |
|---|---|---|
| `TARGET_NOT_REACHABLE` | 地址在公网**打不开** | 部署没完成,或被部署保护挡着 |
| `TARGET_NOT_VERIFIED` | 打得开,**验证文件不对** | 文件没进构建产物,或内容不对 |

搞混这两个会让你在错误的方向上修很久。

---

## HTTP API(不想用 MCP 时)

Base `https://webdatai.top`,鉴权 `Authorization: Bearer <api_key>`。

| 方法 | 路径 | 说明 |
|---|---|---|
| POST | `/v1/sites/reserve` | 预留域名 |
| POST | `/v1/sites/bind` | 绑定并上线(**幂等**) |
| GET | `/v1/sites/{hostname}` | 查单个站点 |
| DELETE | `/v1/sites/{hostname}` | 解绑(需 `{"confirm": true}`) |
| GET | `/v1/me` | 我是谁 + 我的站点 + 配额 |

请求/响应示例见 [llms-full.txt](/llms-full.txt) §7。