weave

环境要求

• macOS 或 Linux 环境，并已安装 Git
• 使用 Homebrew 安装时需要 brew
• 使用源码编译安装时需要 Rust 工具链（cargo）
• 需要在一个 Git 仓库中使用 weave

安装与启动步骤

1. 1用 Homebrew 安装

   macOS/Linux 上最省事的方式，一条命令装好 weave 命令行工具。

   brew install weave

   复制

2. 2或从源码编译

   没有 Homebrew 时用 Rust 源码编译，必须同时安装 weave 和 weave-driver 两个二进制。

   git clone https://github.com/Ataraxy-Labs/weave
   cd weave
   cargo install --path crates/weave-cli
   cargo install --path crates/weave-driver

   复制

3. 3升级已有源码安装

   cargo install 不会覆盖不是它自己安装的二进制，升级时给命令加 --force 重新安装。

   cargo install --path crates/weave-cli --force
   cargo install --path crates/weave-driver --force

   复制

4. 4在仓库中启用

   在任意 Git 仓库里执行，把该仓库配置成支持的文件类型都通过 weave 合并，之后照常用 git。

   weave setup

   复制

5. 5可按需只对自己生效

   不想改动仓库的 .gitattributes 时，把同样的文件类型规则写进 .git/info/attributes。

   weave setup --local

   复制

6. 6正常执行合并

   merge、rebase、cherry-pick 的用法完全不变；真正无法自动解决的冲突会以带 refused_by: 行的标记形式留在文件里。

   git merge 

   复制

7. 7查看冲突原因

   针对某个冲突文件，读取实际 git stage 信息，逐个 hunk 给出细节说明，帮助你判断怎么处理。

   weave explain 

   复制

8. 8恢复原生合并

   想退回普通 git 行级合并时执行这条命令，撤销 weave setup 写入的配置。

   weave unsetup

   复制

如何确认成功

weave setup 成功执行且无报错，说明 weave 已接管该仓库的合并；若 weave-driver 不在 PATH 上，setup 会直接失败。

常见问题

注意事项

• weave 会解析代码为函数、类等实体后再合并，而不是按行合并，用来减少 AI 智能体并行编辑时的误报冲突。
• 安装时必须两个二进制齐全：weave（你执行的 setup/explain 等命令）和 weave-driver（git 调用的合并驱动）。
• 源码升级时别忘了加 --force，否则 cargo install 可能拒绝覆盖已有二进制。
• 执行 weave unsetup 即可完全恢复为原生 git 合并行为。