docs: Update documentation and release rules

- 架构和规划文档更新
- 开发、工程、生产发布规则更新
- 服务隔离和升级指南
- README 更新

docs/105-server-operations.md

@@ -0,0 +1,126 @@
+# 105 服务器变更规范
+
+> **硬性约束：** `105`（`root@120.26.184.105`）是运行/入口层，**不是**源码真相所在处。  
+> **禁止** SSH 登录后直接修改业务代码、脚本或配置源码；所有变更必须来自本地仓库 commit 后的正式发布流程。  
+> 本规则适用于人工与 Agent，无“临时改一下”例外。
+
+## 105 的角色
+
+| 项目 | 说明 |
+|------|------|
+| 定位 | 云侧入口 / 代理 / 历史链路，不承担可写业务数据主存储 |
+| H5 运行目录 | `/root/tkmind_go/ui/h5` |
+| Plaza 运行目录 | `/root/tkmind_go/ui/plaza` |
+| 数据真身 | 在 `103`（MindSpace、users、data 等），见 [103/105 升级记录](103-105-upgrade-runbook-2026-06-26.md) |
+
+本地开发仓库是 `/Users/john/PycharmProjects/test/test-memind`；生产 runtime 发布目标是 `103`。  
+**105 上的文件是部署产物，不是编辑源。**
+
+## 禁止事项
+
+以下操作一律禁止：
+
+1. **SSH 到 105 后直接改源码**  
+   包括但不限于：`sed -i`、`vi`/`nano`、`echo >> file`、手工上传单个 `.mjs`/`.ts`/`.tsx` 覆盖。
+2. **在 105 上改脚本后当作“已发布”**  
+   例如直接改 `/root/tkmind_go/ui/h5/scripts/wechat-mp-menu.mjs` 而不经过本地 commit 与发布。
+3. **把 105 当开发/调试环境**  
+   不在 105 上跑本地开发命令、试改业务逻辑、临时 patch。
+4. **绕过发布流程的“快捷修复”**  
+   “为了快”不是 SSH 直改的理由；违规改动会在下次发布时被覆盖，且与 Git 历史脱节。
+
+## 允许的操作（只读与受控运维）
+
+在**不修改业务源码**的前提下，允许：
+
+- 只读排查：`systemctl status`、`journalctl`、健康检查 `curl`、查看目录结构
+- 按 runbook 重启服务（需有文档依据，且变更本身不是改代码）
+- 在**发布已完成、脚本内容已与本地 commit 一致**后，执行受控同步命令（见下文「服务号菜单」）
+
+## 代码变更的正确流程
+
+```text
+本地 test-memind 修改
+  → 本地验证
+  → Git commit（可追溯）
+  → 按现行发布流程发布到目标环境（103 Portal runtime / 其他已文档化的入口）
+  → 发布后健康检查与业务路径验收
+```
+
+相关规则入口：
+
+- [标准化开发测试发布约束](../ENGINEERING_WORKFLOW_RULES.md)
+- [生产发布规则](../PRODUCTION_RELEASE_RULES.md)
+- [Portal 生产更新发布指南](release-deploy.md)
+- [103/105 升级与角色划分](103-105-upgrade-runbook-2026-06-26.md)
+
+**不要**使用已停用的 `rsync_to_server.sh` 或直接 rsync 到 `105` 作为常规发布手段（见 `PRODUCTION_RELEASE_RULES.md`）。
+
+## 服务号底部菜单（`wechat-mp-menu.mjs`）
+
+菜单名称与链接定义在本地：
+
+```text
+scripts/wechat-mp-menu.mjs
+```
+
+### 两层动作，不可混淆
+
+| 步骤 | 做什么 | 在哪里做 |
+|------|--------|----------|
+| 1. 改菜单定义 | 修改 `MENU` 常量（如 `M广场` → `M发现`） | **仅本地仓库** |
+| 2. 同步到微信 | 调用微信 `menu/create` API | 目标环境已发布后的机器上执行脚本 |
+
+### 正确流程
+
+```bash
+# 1. 本地改 scripts/wechat-mp-menu.mjs
+cd /Users/john/PycharmProjects/test/test-memind
+# 编辑 MENU → 本地验证 → git commit
+
+# 2. 随 Portal/H5 走正式发布到 103（或当前文档规定的目标机）
+#    确保线上脚本内容与 commit 一致
+
+# 3. 在已发布且含微信凭证的环境执行同步（不是改文件）
+node scripts/wechat-mp-menu.mjs
+
+# 仅查看将提交的菜单结构，不调 API：
+node scripts/wechat-mp-menu.mjs --dry-run
+```
+
+### 禁止做法（反例）
+
+```bash
+# ❌ 禁止：SSH 到 105 直接 sed 改菜单脚本
+ssh root@120.26.184.105 "sed -i \"s/M广场/M发现/\" /root/tkmind_go/ui/h5/scripts/wechat-mp-menu.mjs"
+
+# ❌ 禁止：只改 105 上的文件、不 commit、不发布
+# ❌ 禁止：Agent 在未走发布流程时自行 SSH 改 105 源码
+```
+
+说明：第 3 步「执行 `node scripts/wechat-mp-menu.mjs`」是**调用微信 API**，本身不修改业务源码；但必须先完成本地改码 + commit + 发布，保证线上脚本与仓库一致。
+
+## 发布时不会被覆盖的内容（历史 rsync 场景）
+
+若仍涉及旧目录同步，以下路径通常在 exclude 中，**但这不构成“可以在 105 上改源码”的理由**：
+
+- `.env`（环境密钥与运行配置）
+- `MindSpace/`（用户空间数据）
+
+业务脚本与前端代码**不在** exclude 内，发布时会覆盖 105 上的直改内容。
+
+## Agent 执行清单
+
+接到“改 105 / 改服务号菜单 / 改线上文案”类任务时：
+
+1. 先读本文与 [生产发布规则](../PRODUCTION_RELEASE_RULES.md)
+2. 在本地 `test-memind` 修改并 commit
+3. 走文档规定的发布流程
+4. 仅在发布后执行必要的 API 同步（如微信菜单）
+5. **不得** SSH 到 105 直接改 `.mjs` / `.ts` / 前端资源
+
+## 相关文档
+
+- [生产 / 测试 / 预览隔离规程](service-isolation-runbook.md)
+- [Portal 无源码迁移说明](no-source-portal-migration.md)
+- [103/105 一次性升级实施记录](103-105-upgrade-runbook-2026-06-26.md)