问题域/PD-113

平台适配

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 前校验正整数