gwz-core

gwz-core 是 Git Workspace Zone (GWZ) 系统的基础 Rust 引擎，旨在将多个普通 Git 仓库协调为一个可重复的、可检查的单一工作区。与命令行工具不同，这是一个可嵌入的库，它在类型化服务消息边界后面处理跨仓库策略和工作区管理的复杂逻辑。 核心架构是传输中立的，这意味着它本身不会启动服务器或守护进程。相反，它支持灵活的集成模式：本地适配器可以进程内直接调用引擎，而远程适配器可以使用确定性的 CBOR 或基于模式的 JSON 传输相同的类型化操作。这种设计确保了无论核心是嵌入在 CLI、UI、代理还是后端服务中，工作区行为都是一致的。 关键特性包括一个类型化消息边界，用于传输结构化错误、操作元数据和流式事件。系统通过统一的策略边界管理工作区工件，例如清单、锁、快照和标记，同时将标签保留为真实的 Git 引用。Git 交互被隔离在 `GitBackend` 抽象后面，默认实现支持本地、SSH 和 HTTPS 仓库。这种分离使客户端能够共享相同的操作模型，而不管核心是本地链接还是远程托管。 开发者可以使用 gwz-core 构建需要工作区操作的工具，而无需重新实现复杂的跨仓库逻辑。该库被设计为 CLI-ready 和 UI-ready，允许更高层的客户端直接使用相同的处理程序。文档涵盖了产品模型、嵌入指南、协议细节和生成的消息目录。