# 架构说明

一页。规则以 [AGENTS.md](../AGENTS.md) 为准。

## 两套壳

| 壳 | 入口 | 做什么 | 不做什么 |
| --- | --- | --- | --- |
| 浏览器 | `./run.sh web` → `http://127.0.0.1:8787/` | 官网、文档、定价（`homepage/`） | 请求、集合、Mock 管理、自动化测试 |
| 桌面 | `./run.sh gui` | 全部操作 | 不把这套 UI 当成浏览器产品 |

## 目录权威

```text
apps/desktop     桌面 Tauri（唯一操作入口的代码）
packages/*       共享 UI / 传输 / 领域
apps/server      Gin：官网静态托管、代理、本机 API
homepage/        官网与文档源
```

根目录 `src/`、`src-tauri/`、根 `server/` 是误迁，不算权威，不要在上面继续长功能。

## 数据流

```text
apps/desktop
  → packages/*（传输与领域）
  → apps/server  127.0.0.1   管理 / 代理 / Mock 发布
  → Mock 响应    默认 127.0.0.1（不对公网）
homepage
  → 浏览器只读官网与文档，不碰集合与密钥
```

## 安全三行

1. 浏览器只看站 / 文档。操作只走 `./run.sh gui`。
2. Mock 默认 `127.0.0.1`，不上公网。
3. `/admin` 不落明文。