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 <branch>

   复制

7. 7查看冲突原因

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

   weave explain <file>

   复制

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 合并行为。