平台适配
Platform Adaptation
多 IDE/多操作系统适配、输入输出标准化、跨平台兼容。IDE hook 格式标准化与跨 OS 进程生命周期管理的工程实践
子问题
1.多 IDE 适配器(Claude Code/Cursor/Raw)
2.Windows/macOS/Linux 差异处理
3.超时倍率调整
4.守护进程生成方式适配
5.IDE 多版本字段兼容(Cursor conversation_id/generation_id/id 等)
6.Windows Bun 运行时路径解析(8 候选路径优先级搜索)
7.Windows 僵尸端口防护(socket 继承 + 延迟释放)
8.孤儿进程分级清理(立即杀死 vs 年龄门控)
各项目的解法1 solutions
Signals
横向对比
| 维度 | claude-mem |
|---|---|
| 适配架构 | Adapter 模式:PlatformAdapter 接口 + 3 实现(claude-code/cursor/raw) |
| 平台检测 | process.platform 集中在 ProcessManager,IDE 平台由 CLI 参数传入 |
| 超时策略 | 双层倍率:hook 侧 1.5x + worker 侧 2.0x,区分快慢路径 |
| 进程管理 | Windows PowerShell Start-Process / WQL 枚举 / taskkill;Unix setsid / ps / SIGKILL |
| IDE 集成深度 | Cursor 深度集成(hooks.json + MCP + 上下文文件 + 项目注册表),Claude Code 原生 hook |
| 僵尸进程防护 | 三级清理:启动时 aggressive cleanup + 运行时 5min reaper + 关闭时子进程枚举终止 |
最佳实践
1.用 Adapter 模式隔离平台差异,核心逻辑保持平台无关
2.双层超时倍率区分 hook 快路径(1.5x)和 worker 慢路径(2.0x)
3.Windows 守护进程用 PowerShell Start-Process 而非 WMIC(继承环境变量)
4.PID 验证防命令注入:所有 taskkill/kill 前校验正整数