john
7f8d692d16
Fix DEV logout cookie clearing, materialize selected MindSpace OA assets before agent runs, and recover zombie runs from synced workspace pages. Add client run wait timeout, harness retry limits, page-edit asset forwarding, and logout/john2 scenario tests. Co-authored-by: Cursor <cursoragent@cursor.com>
本仓库说明：这是
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 无源码迁移说明