wormhole

Wormhole 为 AI 代码编写代理（如 Claude Code、GitHub Copilot 和 Cursor）提供了一种通用的共享内存桥梁。在现代开发工作流中，开发人员常在不同 AI 助手间切换或并行运行多个子代理，这往往导致上下文碎片化和信息丢失。Wormhole 通过提供 MCP (Model Context Protocol) 服务器解决了这一痛点，将每个重大决策、文件修改、命令执行和测试结果记录到集中式的持久化存储库中。这确保了当您切换工具或代理时，新的助手能立即访问完整的历史记录、既定的编码规范及最近的架构决策。

• 集中式记录：提供统一的 log 工具以记录 file_edit、cmd_run、decision、test_result、todos、plan_output 和 feedback。

• 会话管理：将工作组织为具名且可隔离的会话，支持会话摘要生成和活动追踪。

• 冲突检测：主动监控项目路径，在代理试图同时修改同一文件时发出警报。

• 知识捕获：具备 save_knowledge 和 search_project_knowledge 系统，用于存储和检索避坑指南、编码约定及项目特定约束。

• 可视化界面：通过 npx wormhole ui 提供 Web UI，用于时间轴分析、仪表板统计和见解筛选。

• Token 优化操作：专为 AI 消费设计，利用基于差异的查询和相关性筛选来最小化上下文窗口负担。

• 请务必为 project_path 参数使用绝对路径，以避免范围模糊，因为系统依赖精确的路径匹配来保证文件完整性。

• 遵循推荐的工作流：start_session、使用 search_project_knowledge 提取上下文、检查冲突、记录操作、保存学习成果，最后使用 end_session 结束会话。

• 系统执行自动化的陈旧事件剔除，过滤掉已不存在文件的修改，确保上下文保持高保真度。

• 非常适合 CI/CD 流水线、多代理重构任务以及需要历史记录以防止回归的长期项目维护。

• 可通过标准编辑器中的 MCP 配置轻松集成；使用 npx wormhole-mcp 可实现快速部署，无需复杂的底层基础设施配置。