docs: 记忆补记并行执行体事件与处置结论

This commit is contained in:
admin committed 2026-11-10 17:02:31 +08:00
1 parent ee8c6c5e64
commit d40c501651
1 file changed
+43
+43
View File
@@ -402,3 +402,46 @@ AMD 真机 192.168.1.7 上 hostd 已停(3010/3020 Connection refused,ping 0%
★ 写完必须**逐条核对事实**(不能凭印象):算子数实测 19(7 分类)、
表数实测 18(sswflow 12 / sswdevice 1 / sswchain 1)、
关键入口 13 个路径全部存在、端口透传在 flowTransform.ts 文件头有明确注释。
## 第五轮:发现并行执行体(同一项目、同时在跑)
### 现象
- 16:04 我用 `kill -9 49475` 停旧后端;16:11 重启后新实例**恰好复用了 PID 49475**。
- 16:56~16:57 出现**不是我发起**的操作:
`node dist/main.js > /tmp/sswflow-backend.log`(我的日志路径是 `/tmp/backend.log`)、
`kill -9 49475`、`lsof -ti:30000`。
⇒ 有另一个执行体在**同一工作区**上跑同一项目。
- 表现为后端反复被 SIGKILL(exit 137),一度误判成 OOM(实际内存 70% 空闲,
load average 5.5/8.5/13.6 偏高但非内存问题)。
### 它做了什么(未提交的工作,我已代为验证并入库)
| 文件 | 内容 |
|---|---|
| `scripts/install-mpc.sh`(新增 311 行) | 装 ssw-mpc **版本二进制包**(上游 Gitea Release) |
| `src/backend/src/sswflow/engine/mpc-client.ts` | 二进制解析顺序改为 MPC_BIN → 版本包 → 仓库构建 → PATH;新增 `binSource` |
| `engine-registry.ts` / `mpc-engine.ts` / `mpc-operator-map.ts` | `probeCliSubcommands()` 逐个探测子命令,缺则 native → partial(`applyRuntimeCapability`) |
| `src/frontend/src/views/Flow.tsx` | 前端展示 |
| `.gitignore` / `run.sh` / `CLAUDE.md` / `README.md` | 配套(`.mpc/` 忽略、`./run.sh mpc` 子命令、文档) |
### 我的判断与处置
**质量评估后决定入库**(不是盲提交):
- 后端 tsc 0 错、前端 tsc 0 错;
- 门禁全绿:check-module 219/0 + 21/0 + 21/0、perm-smoke 32/0、sswflow-smoke 46/0;
- 无敏感文件、最大文件 23KB;
- 实测 `.mpc/bin/v0.2.0/mpc selfcheck` 通过,sha256 `394fc5fd…` 与 manifest 一致;
- 版本包**不含 secure feature** ⇒ `mpc sql/sql-plan/sql-join/pg` 不存在
(exit=2 + 「未知命令: sql」),相关算子按实降级为 partial。
提交 `ee8c6c5`,已推送。
### ★ 教训
1. **别把 exit 137 一律当"我 kill 的"**:要先看 `/tasks` 通知里的 PID 与
当前 `lsof` 对得上吗;PID 会被复用,旧 JSONL 里的 kill 可能命中新进程。
2. **并行执行体识别特征**:日志路径不同(`/tmp/sswflow-backend.log` vs `/tmp/backend.log`)、
命令在我没发起的时间点出现。
3. 遇到别人的**未提交改动**时:先评估质量(编译 + 门禁 + 敏感扫描 + 实测验证),
合格就代为提交入库并如实标注,**不要覆盖也不要无视**。