---
name: memory-sync-deaddrop
description: GZ死信箱任务交接协议 + 国内下载大文件规范 + Electron假故障排查。触发词：暗号、死信箱、memory-sync、交接任务、下载Electron/Node/GitHub release、require electron返回字符串
---

# 死信箱协议（GZ `/opt/aicraft/memory-sync/`）

服务器：`ubuntu@101.33.204.165`（SSH key 认证；root 登录不通，别试）

- **取任务**：收到"暗号：XX" → 读 `/opt/aicraft/memory-sync/xx.md`（文件名 = 暗号小写）
- **交任务**：写 `xx.md` 便签，含三段：任务 / 完成后操作 / 背景（简短版）
- **回执**：完成后写 `xx-reply.md` 到同目录（状态 / 产物路径 / SHA256 / 踩过的坑）
- 大文件产物直接放同目录，便签里注明校验和

# 国内下载大文件规范

1. **镜像优先，直连 GitHub 只做兜底**（实测：直连 ~20KB/s，npmmirror ~28MB/s）：
   - Electron：`https://registry.npmmirror.com/-/binary/electron/<版本>/<文件名>`
   - Node/Python/ffmpeg 等：`https://registry.npmmirror.com/-/binary/` 下找对应目录
2. **必须校验**：校验和只认 GitHub 官方 release 的 `SHASUMS256.txt`，下载后 `sha256sum` 比对。镜像提速、官方保真，缺一不可。
3. **断点续传（`-C -`）前**，先确认没有旧下载进程还占着同一文件（Windows `tasklist`，Linux `lsof`）——孤儿进程同写一个文件会持续损坏它、哈希一直在变。校验失败一律**删掉整个重下**，不要修补。
4. 传到服务器后，在远端再跑一次 `sha256sum` 确认落盘完整。

# Electron 假故障排查

症状"`require('electron')` 返回路径字符串而非 API"：

1. **先查 `ELECTRON_RUN_AS_NODE=1`**——VS Code / Claude Code 等 Electron 系 IDE 的集成终端会注入它，注入后必然出现此症状，与版本无关
2. 清掉再测：cmd `set ELECTRON_RUN_AS_NODE=`，PowerShell `$env:ELECTRON_RUN_AS_NODE=$null`
3. 复现消失 → 是环境变量；仍复现 → 才怀疑 Electron 版本 / V8 快照（Workbench 当前钉 33.4.11，zip 在死信箱有存档）
4. 手工替换过 `node_modules/electron/dist` 的机器上，`npm install` 会把它冲回旧版——修复验证稳定后要在 package.json 钉版本
