memind/docs/143-dev-memind-dev.md

143 开发目录 Memind-dev

在 Mac Studio（103，john@180.159.29.143）上与本地 Mac 并行开发 Memind 的约定。
生产运行目录仍是 /Users/john/Project/Memind；日常改码只用 /Users/john/Project-dev/Memind-dev。

目录对照

机器	开发目录	生产 / 103 运行目录
本地 Mac	/Users/john/Project/Memind	—
143	/Users/john/Project-dev/Memind-dev	/Users/john/Project/Memind

代码同步靠 Git 远端 git@git.tkmind.cn:tkmind/memind.git，不要用 rsync 拷源码。

143 开发端口（与生产隔离）

服务	生产	Memind-dev
Portal / API	8081	8086
MindSpace H5 (Vite)	—	5173
memind_adm	8082	8087
Ops	—	3003
Plaza	3001	3004

.env 在 Memind-dev 内单独维护（从生产 .env 复制后覆盖上表端口与 MEMIND_RUNTIME_PROFILE=local），不要 commit。

日常命令

ssh john@180.159.29.143
cd /Users/john/Project-dev/Memind-dev
source ~/.zshrc          # 加载 /opt/homebrew 的 node@22 / pnpm
git fetch origin --prune
git pull --ff-only
pnpm install             # 仅 lockfile 变化时
pnpm dev

本机浏览器经 SSH 隧道访问 143 上的 Vite：

ssh -L 5173:127.0.0.1:5173 -L 8086:127.0.0.1:8086 john@180.159.29.143
# 然后打开 http://127.0.0.1:5173/?preview=mindspace

Cursor Remote SSH：打开文件夹 /Users/john/Project-dev/Memind-dev。

双机同步流程

收工（任一台）：

git status
git add -A && git commit -m "..."
git push origin feature/learn-assistant   # 或 main，需明确批准 push

开工（另一台）：

git fetch origin --prune
git switch feature/learn-assistant
git pull --ff-only

Git SSH（143 必配）

143 公钥需加入 git.tkmind.cn（端口 2222，见 ~/.ssh/config）：

ssh john@180.159.29.143 'cat ~/.ssh/id_ed25519.pub'
ssh -T git@git.tkmind.cn   # 在 143 上验证

未配公钥前，可临时用本机 git bundle 同步，但不建议长期使用。

103 发布

• 功能合并进 main 且 CI / verify 通过后，在 生产目录 拉最新 main 再跑发布脚本。
• 禁止从 Memind-dev 脏工作区或功能分支直接 release-portal-*-prod.sh。
• 发布前：bash scripts/check-release-ready.sh

注意

1. 两台机器不要长期各改同一分支却不 push/pull。
2. Memind-dev 与生产共用 DATABASE_URL 时，开发操作可能影响线上数据，谨慎执行 destructive 脚本。
3. pnpm dev 与 103 生产 Portal（8081）可同时存在；不要误改生产目录下的文件或重启生产 LaunchAgent。