Files
memind/README.md
T
john 54de1dd8e3 Add local test domain setup (test.*.tkmind.cn).
DNS/TLS/proxy scripts and docs/local-dev.md replace localhost URLs for H5, memind_adm, Plaza, and Ops during local dev.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-17 09:55:04 +08:00

68 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)