john本仓库说明：这是
test-memind本地开发仓库，默认用于本机联调与验收。生产 / 测试 / 预览隔离规则单独看 docs/service-isolation-runbook.md，不要把生产同步流程混进本地开发。重要：
pnpm dev只启动本仓库自己的服务，不再联动 Plaza。需要全栈联动时请显式使用pnpm dev:all。流程硬约束： 本机开发每次都要形成 Git commit；本机不允许直接
rsync到103或105，只能从本地 commit 打包发布。
105 禁止直改： 不得 SSH 到105直接改源码；细则见 105 服务器变更规范。
Memind (TKMind H5)
Memind 主应用与 Plaza 发现广场。当前以本机 Mac 为主服务，105 服务器已停用。
开发基线：
v0.1.0-baseline（2026-06-16）— 后续开发请从此 tag 创建分支，详见 docs/BASELINE.md。AI 协作（Codex / Cloud / Cursor 等）： 请先读 AGENTS.md 与 docs/regression-guards/，内含不可轻易回退的已验证行为与
verify:mindspace-publish-guards门禁。
快速开始
pnpm install
cp .env.example .env # 按需填写
pnpm dev # MindSpace + API / Portal + Ops
| 服务 | 地址 |
|---|---|
| MindSpace H5 | http://127.0.0.1:5173/?preview=mindspace |
| Plaza | http://127.0.0.1:3001/plaza |
| Ops 审核后台 | http://127.0.0.1:3002/ops/ |
| API / Portal | http://127.0.0.1:8081 |
| memind_adm | http://127.0.0.1:8082 |
pnpm dev 现在只启动本仓库自己的服务，Plaza 已单独剥离为 pnpm dev:plaza / pnpm start:plaza。如果你确实要一次性拉起旧式全家桶，请用 pnpm dev:all。
详见 docs/local-dev.md。如果你在本机联调 Plaza，请优先看本地开发文档里 PLAZA_APP_DIR 的默认路径；生产 / 测试 / 预览隔离另看 生产 / 测试 / 预览隔离规程。
仅 Plaza：
pnpm start:plaza # 本机正式模式（Tunnel 回源）
pnpm dev:plaza # 开发热更新
pnpm open:plaza # 浏览器打开 https://plaza.tkmind.cn/plaza
Plaza 本机为主
完整说明见 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 |
本仓库开发（不含 Plaza） |
pnpm dev:all |
兼容入口：全栈开发（含 Plaza），仅在需要联动 Plaza 时使用 |
npm run verify:mindspace-publish-guards |
MindSpace 发布 + 聊天 Finish 回归守卫（改相关代码后必跑） |
npm run verify:mindspace-publish-guards:full |
上者 + Portal runtime bundle 检查（发 runtime 后） |
pnpm open:local-test |
浏览器打开 H5 |
pnpm start:plaza |
Plaza 正式模式 + Portal |
pnpm dev:plaza |
Plaza 开发模式 + Portal |
pnpm open:plaza |
浏览器强制本地解析 |
pnpm check:plaza |
本地 Plaza 诊断 |
pnpm test |
单元测试 |
bash scripts/release-portal-runtime-prod.sh --dry-run |
预演 103 Portal runtime 发布包，不做实际切换 |
bash scripts/release-portal-runtime-prod.sh |
本机构建 runtime artifact 并按正式流程发布 Portal 到 103 |
发布规则入口
cd /Users/john/Project/Memind
bash scripts/release-portal-runtime-prod.sh --dry-run
bash scripts/release-portal-runtime-prod.sh
说明：
- 103 Portal 生产必须是无源码 runtime 模式
- 103 生产禁止
rsync - 105 禁止 SSH 直改源码（含服务号菜单）；见 105 服务器变更规范
bash scripts/release-prod.sh已停用，不得再用于 Portal- 规则文档见仓库根目录的开发 / 测试 / 生产发布规则，以及 Portal 无源码迁移说明