# Memind (TKMind H5)

Memind 主应用与 Plaza 发现广场。**当前以本机 Mac 为主服务**，105 服务器已停用。

> **开发基线：** `v0.1.0-baseline`（2026-06-16）— 后续开发请从此 tag 创建分支，详见 [docs/BASELINE.md](docs/BASELINE.md)。

## 快速开始

```bash
pnpm install
cp .env.example .env   # 按需填写
sudo pnpm setup:local-test   # 一次性：test.* 本地 DNS + TLS
pnpm dev               # MindSpace + Plaza + Ops
sudo pnpm dev:local-proxy    # 另开终端：HTTPS :443 统一入口
```

**本地访问请用 test 域名**（不用 127.0.0.1 / localhost），详见 **[docs/local-dev.md](docs/local-dev.md)**：

| 服务 | 地址 |
|------|------|
| MindSpace H5 | https://test.tkmind.cn/?preview=mindspace |
| Plaza | https://testpla.tkmind.cn/plaza |
| Ops 审核后台 | https://testops.tkmind.cn/ops/ |
| memind_adm | https://testadm.tkmind.cn |

仅 Plaza：

```bash
pnpm start:plaza       # 本机正式模式（Tunnel 回源）
pnpm dev:plaza         # 开发热更新
pnpm open:plaza        # 浏览器打开 https://plaza.tkmind.cn/plaza
```

## Plaza 本机为主

完整说明见 **[docs/plaza-local.md](docs/plaza-local.md)**，摘要如下：

| 步骤 | 命令 |
|------|------|
| 首次 DNS | `sudo pnpm setup:plaza-dns` |
| 首次 TLS（可选） | `sudo pnpm setup:plaza-local` |
| 公网 Tunnel | `pnpm setup:plaza-tunnel` |
| 日常正式 | `pnpm start:plaza` |
| 开发调试 | `pnpm dev:plaza` |
| 诊断 | `pnpm check:plaza` |

公网 `https://plaza.tkmind.cn` 经 Cloudflare Tunnel 回源本机 `:3001`，需保持 `pnpm start:plaza` 运行。

## 常用脚本

| 命令 | 说明 |
|------|------|
| `pnpm dev` | 全栈开发 |
| `sudo pnpm setup:local-test` | 首次配置 test.* 本地域名 |
| `sudo pnpm dev:local-proxy` | HTTPS :443 统一入口 |
| `pnpm check:local-test` | 本地 test 域名诊断 |
| `pnpm open:local-test` | 浏览器打开 H5 |
| `pnpm start:plaza` | Plaza 正式模式 + Portal |
| `pnpm dev:plaza` | Plaza 开发模式 + Portal |
| `pnpm open:plaza` | 浏览器强制本地解析 |
| `pnpm check:plaza` | 本地 Plaza 诊断 |
| `pnpm test` | 单元测试 |

## 文档

- [本地开发（test.*.tkmind.cn）](docs/local-dev.md)
- [Plaza 本机部署与 Tunnel](docs/plaza-local.md)