目录Windows 原生安装 Hermes Agent 踩坑记录Git 冲突 子模块失败 通俗解读一、通俗大白话讲明白两个问题1. Git Merge 冲突 是什么2. 子模块更新失败 是什么二、问题因果关系一句话记住三、Windows 原生极简修复方案可直接复制四、后续避坑要点纯 Windows 原生环境全程无 WSL、无虚拟机使用官方 PowerShell 一键脚本安装 Hermes Agent 时连续触发两个连锁报错直接终止安装流程报错原文✗ Installation failed: Submodule tinker-atropos registered for pathGit merge 冲突hermes_cli/setup.py 存在本地修改导致 git pull 强制中止连锁问题因为主线代码拉取失败后续子模块自动更新流程直接断掉一、通俗大白话讲明白两个问题1. Git Merge 冲突 是什么打个形象比方项目源码就像一份公共共用的文档官方一直在线上更新改版。你本地这台电脑里之前残留了旧文件、或是不小心改动了setup.py配置文件。当安装脚本自动执行git pull拉取最新代码时Git 发现本地文件 和 官方新版文件不一样它不知道该保留你的本地修改还是直接覆盖成官方版本不敢擅自操作直接罢工卡住拉代码流程直接终止。简单总结本地文件被改动 / 残留旧数据 → 和线上新版本对不上 → Git 两难直接停止更新。2. 子模块更新失败 是什么Hermes Agent 不是单一文件是「主程序 多个依赖小模块」拼装起来的。tinker-atropos就是它依赖的一个外置子模块相当于必备配件、核心零件。正常安装逻辑先更新主项目代码 → 再自动下载、拼装所有子模块配件。现在问题是第一步「主代码拉取」因为冲突已经卡死中断后面下载配件、补全依赖的流程自然跑不了属于前面崩了后面全部连锁报废。二、问题因果关系一句话记住本地文件修改 → 引发 Git 合并冲突 → 代码拉取中断 → 子模块无法下载 → 安装整体失败三、Windows 原生极简修复方案可直接复制清空本地改动强制同步官方原版代码git reset --hard origin/main git pull手动单独下载缺失的子模块绕过自动脚本失败问题git clone https://github.com/nousresearch/tinker-atropos tinker-atropos重建虚拟环境、安装依赖继续正常部署python -m venv .venv .venv\Scripts\Activate.ps1 pip install -r requirements.txt python main.py四、后续避坑要点Windows 装 AI 本地项目不要随便手动改项目内部配置文件重复安装、覆盖安装前最好删掉旧文件夹防止残留文件冲突官方一键脚本容易受网络、子模块拉取限制失败后手动分步部署最稳全程纯 Windows 原生操作坚决不用 WSL避免环境混乱。