藕片 APICM-002：Worker 假死导致客户端卡住
问题现象
Claude Code 一直等待，claude-mem 的本地端口可以连接，但健康检查迟迟不返回。
根因分析
Worker 处理阻塞、进程状态异常或端口被其他进程占用，可能使 Hooks 反复等待。端口在监听并不能证明服务健康。
修复步骤
以端口 37777 为例，先给健康检查设置超时；实际地址以本机插件配置为准：
curl --max-time 5 http://127.0.0.1:37777/api/healthWindows PowerShell 可将命令写为 curl.exe。
- 检查监听端口的实际 PID、进程路径与日志，确认属于当前插件。
- 在当前安装版本的插件主目录运行
npm run，查看可用的维护脚本，再按该版本说明定向重启 Worker。 - 重新检查健康接口，再验证一次 Claude Code 工具调用。
- 不批量结束所有 Node/Python 进程，也不通过删除数据库修复后台服务。
预防措施
升级后先测试健康接口和一次记忆写入。维护脚本与安装目录按当前版本核对，避免照搬旧版缓存路径。