plumb

Plumb 是一款 MCP 服务器，以单个 Go 二进制文件分发，采用 MIT 许可证，为编码代理在护栏内提供 IDE 风格的智能层。其 README 按优先级列出四大支柱：写入可靠性、多代理协调、语义智能和上下文效率。 写入安全。每次写入都在临时文件中暂存并原子重命名到位，支持符号链接感知和 CRLF 容错。守护进程中的每路径锁串行化跨会话和聊天窗口的并发写入。多文件事务可在失败时进行原子回滚，mtime/sha 守卫会在覆盖更新更改前拒绝过时编辑。serve 命令是重连 stdio 代理：守护进程崩溃或挂起时会重新生成并重放握手，README 称在途写入绝不会静默重跑。 协调机制。由于一个守护进程服务所有代理，会话可以互相观察和通信。对等感知默认开启：workspace_sessions 会列出活跃会话和守护进程记录的写入，区分失败或被拒绝的写入。代理间邮箱（leave_note, check_messages）在同一工作区内默认启用，通过普通工具结果投递消息而非轮询。建议意图（share_intent, opt-in under [collab] intents）标记当同伴的写入触及已声明路径的情况，这些明确标记为未验证声明且不会阻塞任何操作。持久发现（share_findings, opt-in）将会话学习成果转化为可搜索、脱敏的项目记忆。README 强调写入安全性不依赖于代理的合作。 语义智能。基于 LSP 的重构工具包括 rename_symbol、replace_symbol_body 和 safe_delete_symbol。来自真实语言服务器（如 gopls 和 pyright）的诊断信息会附加到每次写入中。符号搜索范围限定在项目内，排除标准库和依赖噪音。上下文控制允许代理读取符号或行范围而非整个文件，session_start 通过一次往返即可初始化工作区、分支、最近提交、诊断和项目记忆。访问受每连接路径白名单管理，包含只读和读写根目录以及分层 git 限制；破坏性和网络 git 操作默认关闭。README 在 docs/use-cases.md 中公布测量数据（由脚本定期重新生成），并记录了性能损耗：read_multiple_files 的开销比原生读取文件高出约 1.31 倍。 语言支持采用分级描述。Go (gopls) 和 Python (pyright) 作为一等公民支持，CI 针对真实二进制文件进行全面测试，覆盖完整的 LSP 和写入工具。Java、Rust、Swift、TypeScript/JavaScript、Zig、Kotlin 和 HTML 被列为已验证支持，前提是相应服务器在 PATH 中；HTML 注明无文件系统访问权限。内置 tree-sitter 索引支持 31 种以上语言的排序搜索、大纲展示和拓扑图探索，无需语言服务器。真实二进制验证支持 macOS 和 Linux；Windows 正在跟进但尚未支持，因为守护进程使用 Unix 套接字。 架构。plumb serve 通过 plumb.sock 代理到单一共享后台守护进程，使语言服务器在多个对话间保持预热状态。SQLite 存储全局 stats.db 用于工具统计和情节摘要，以及每个工作区 .plumb/ 目录下的 per-project topology.db 和 memory.db。README 指出共暴露 58 个工具；常用工具包括 session_start、workspace_symbols、get_definition、find_references、rename_symbol、edit_file、transaction_apply 和 diagnostics，其余覆盖文件系统访问、LSP 层级、分层 git、可选本地 Topology 索引和记忆功能。不带参数运行 plumb 会打开 TUI 仪表板，显示工具调用、守护进程健康状态、各工具统计数据和流式日志。 安装与配置。可通过 Homebrew、go install 或预编译发布版安装；预编译的 macOS 二进制文件尚未公证。plumb setup 会为 claude-code、claude-desktop、codex、gemini 和 cursor 等客户端编写 MCP 配置。配置使用全局或项目级的 config.toml 或环境变量，plumb config show 可报告已解析值和来源；示例选项包括严格编辑模式（要求先读取）和防 runaway loops 的每分钟速率限制。 状态。Plumb 处于 pre-1.0 阶段，写入安全、抗崩溃守护进程、拓扑索引和项目记忆已描述为日常使用中。路线图列出 0.10 至 0.19 主题版本，0.19.x 为 1.0 前的最后一个 0.x 版本，原生 Windows 支持推迟至 1.1。贡献指南、AGENTS.md、行为准则和 MIT 许可均已说明，文本遵循澳大利亚英语拼写规范。